Custom Cards Import ZH

导入自定义卡片

从你自己的文件加载卡片，当你把清单保存在别处，或用脚本生成清单时很方便。不需要 API 密钥。可在设置 → 导入 → 自定义卡片下找到它。

文件格式

每次导入一个文件。接受两种格式：

• JSON：可以是对象数组，也可以是单个对象表示一张卡片。
• CSV：一行表头命名各列，其后每行一张卡片。适用标准 CSV 引号规则，所以只要用引号包裹，一个值就可以包含逗号和换行。

每张卡片只有两个字段是必填的：title（标题）和 type（媒体类型，game、movie、tv、anime、manga、book 等）。其余全部可选。

可选卡片字段涵盖普通卡片有的那些内容：别名标题、描述、年份、题材、链接、封面图 URL、平台、漫画 / 动画格式，以及进度总数（集、章、页、部分）。

你也可以直接在文件里填入你的个人字段：状态、我的评分、备注、重玩计数器、开始和完成日期、花费时间、收藏标记、剧集 / 季进度，以及标签。尚不存在的标签会为你自动创建。

模板

导入页面有两个下载按钮，给你一个现成的文件来填写：

• 一个只有表头行的 CSV 模板
• 一个自我说明的 JSON 模板，其中的提示键以 _ 开头，导入器会忽略它们，所以模板可以原样干净地导入，方便你看看它的落地效果

如何导入

1. 前往设置 → 导入 → 自定义卡片
2. 如需起点可下载一个模板，填好后保存你的文件
3. 点按以选取你的 JSON 或 CSV 文件
4. 选择目标收藏，新建的或已有的
5. 检查预览（见下文），调整要带入哪些行，然后确认

预览

在写入任何内容之前，文件会被读取和检查，预览会显示一份摘要：已识别 · 错误 · 重复。

• 错误：无法读取的行（缺少标题或类型、值有误）。它们会浮到列表顶部并写明原因，便于修正。
• 重复：目标收藏里已有的标题，或你文件里出现两次的同一标题。这些默认不勾选。
• 其余一切都已勾选、就绪。

列表每行有一个复选框，外加全选 / 全不选，所以你能精确决定导入什么。在你确认之前，不会动到你的库。

封面

如果某一行有封面图 URL（http 或 https），只有在你确认导入之后，图片才会被下载，而且只针对你实际带入的那些行。如果某个封面下载失败，卡片仍会创建，并在其上留下一条简短备注。

平台

平台文本会与应用的平台列表匹配，忽略大小写，你可以写短名或全名。如果没有任何匹配，文本会原样保留为一个自由格式的平台名称。

从文件预填一张卡片

你不必手动输入每个字段。在创建或编辑单张自定义卡片时，可以加载一个 JSON 或 CSV 文件，也就是这个批量导入所接受的那些格式，让它替你填好表单。选好文件，各字段就会预先填入。保存之前你仍可以改动任何内容。

创建表单本身还带有 我的笔记 和 标签 两个字段（标签用逗号分隔），加载文件时会用 comment 和 tags 两列预填它们。点击创建后，笔记会保存为该项目的个人备注，标签会走全局标签系统，尚不存在的标签会自动创建。编辑表单不显示这两个字段，笔记和标签改在项目详情界面里。

另见

• 导入 / 导出：.xcollx 收藏格式与完整备份
• 项目详情：卡片上每个字段的含义