什么时候使用表格工具
表格工具适合批量创建结构一致的卡牌、用表格更新已有卡牌，或把牌组内容导出检查。少量包含复杂富文本、公式和媒体的内容通常更适合逐张编辑。
入口位于“卡牌管理”底部的更多操作，也可从目录操作菜单直接选择“导入卡片”。导入需要牌组编辑权限；只读牌组不能执行。
| 来源 | 适合场景 | 主要限制 |
|---|---|---|
| XLSX | 正式批量导入、保留部分文字样式、多工作表数据 | 一次只导入一个工作表 |
| CSV | 其他系统导出的简单文本数据 | 不保留 Excel 样式；需检查编码和换行 |
| 剪贴板 | 从表格软件粘贴少量行进行快速验证 | 剪贴板必须包含可解析的行列文本 |
准备一份可预检的表格
- 第一行是列标题，每一列标题都不能为空且应保持唯一。
- 从第二行起每行代表一张卡牌，不使用合并单元格表达层级。
- 至少为模板的标题字段准备一列，并保证每一行不为空。
- 目录使用独立的“一级目录”“二级目录”列，名称写法保持一致。
- 附件单元格只填写所选资源目录内的相对路径或支持的内联资源写法。
- 先保留 3–10 行样本，覆盖正常、重复、空可选字段和附件等情况。
- 不要在同一次导入中混用多个字段结构完全不同的模板。
在导入入口选择“下载示例 Excel”，再选择目标模板。示例包含该模板字段和目录列，比手工猜测列名更可靠。
打开文件或剪贴板
- 选择或拖入文件。文件扩展名必须是
.xlsx或.csv；也可以选择“粘贴表格导入”。 - 选择工作表。XLSX 包含多个工作表时，界面显示名称和行数；一次选择一个继续。
- 检查当前工作表。配置页面顶部会显示当前工作表，选错时返回重新选择，不继续映射。
- 选择模板。模板决定接下来可映射的字段。
文件无法打开时，先确认文件没有被损坏或加密，并使用标准 XLSX/CSV 重新保存。剪贴板读取失败时，不要反复授权；可以改为保存成 XLSX 导入。
映射模板字段
“字段对应”会列出目标模板的字段。对每个需要导入的字段，选择一列表格列；不需要的字段保持“<无>”。同一列不应映射给多个含义不同的字段。
- 先映射标题字段。它必须有数据，并参与同标题重复卡识别。
- 再映射必填字段。预检会标出缺失值。
- 映射可选字段。确认空值不会破坏模板展示。
- 检查自动匹配。列名相似时仍可能匹配错误，不要直接接受全部默认值。
- 查看预览表格。抽查行号、原始内容和映射结果。
“保留文字样式”可以把 Excel 中的加粗、斜体、下划线、删除线、颜色和字号等导入富文本字段。开启后应特别检查复杂单元格；CSV 和纯文本剪贴板没有这些样式。
选择固定目录或智能目录
| 模式 | 行为 | 适合情况 |
|---|---|---|
| 导入至现有目录 | 所有导入卡牌进入同一个现有目录，也可选择无目录 | 本次数据属于同一主题；从目录菜单进入导入 |
| 智能对应/生成目录 | 按指定表格列匹配或创建一级、二级目录 | 一张表包含多个章节 |
智能目录当前配置一级和二级目录列。目录名称不一致会被当作不同目录，例如“第一章”和“第1章”。目录层级最终仍受三级上限约束；需要复杂三级结构时，先在牌组中创建目录并分批导入到现有目录。
附带图片、音频和文件
选择“资源目录”后，表格中的相对路径会从该目录查找并导入牌组资源库。普通字段可使用 (example-audio.mp3) 或 [audio:example-audio.mp3]；专用图片、音频、视频和文件字段可直接填写路径。
| 检查项 | 规则 |
|---|---|
| 文件数 | 最多 5000 个文件 |
| 目录总大小 | 最多 200 MB |
| 路径 | 必须在所选目录内，不能使用越级或不安全路径 |
| 文件名 | 扩展名、大小写和相对路径与表格一致 |
| 单文件 | 继续受附件类型和会员限制 |
选择资源目录不代表每个文件都会被使用。导入后到“附件管理”检查引用和状态；不要立即清理，因为资源引用计数可能仍在更新。
选择重复卡处理策略
重复识别以目标模板中的标题字段和现有卡牌为基础。界面中的实际选项是：
| 选项 | 结果 | 风险 |
|---|---|---|
| 仍然导入 | 即使存在同标题卡牌，也创建新卡 | 产生难以区分的重复卡 |
| 跳过导入 | 保留现有卡，当前行不创建 | 表格中的更新内容不会写入 |
| 替换已存在卡牌 | 用当前行映射内容更新匹配卡牌 | 标题匹配错误会覆盖不该修改的卡 |
先用少量行查看预检中的“替换”数量和代表性内容。标题并不唯一或曾被修改时，不要直接对整表使用替换。
读懂导入预检
“导入预检”会显示总行数、可导入、替换、跳过和失败数量，并列出前几条错误、警告和行预览。
- 总行数：工作表中被识别为数据的行。
- 可导入：在当前映射和策略下可以处理的行。
- 替换：将更新现有卡牌的行。
- 跳过：因重复策略等原因不写入的行。
- 失败：缺少标题、字段校验、目录或资源等问题导致不可导入的行。
没有行号的全局错误会阻止开始导入，例如模板、映射或资源目录本身不合法。只有个别行失败时，任务可以继续处理其他行，因此开始前应决定是否接受部分成功。
开始、观察和终止导入
- 记录预检数量。尤其是替换和失败数量。
- 选择“开始导入”。资源较多时会先读取附件。
- 观察逐行结果。进度页面会显示已处理行和当前状态。
- 不要重复启动。按钮处于准备或运行状态时等待。
- 需要停止时选择“终止导入”。等待任务进入已取消状态，不强制关闭应用。
内部每批最多处理 100 行，批次内会记录每行成功或失败；整个任务由多个批次组成。这也是为什么取消或后续失败时，前面成功的内容可能已经保存。
处理完成、失败和部分成功
“导入已取消”只表示后续处理停止。“导入失败”也不一定表示此前一张都没有写入。必须根据成功、失败、跳过数量和逐行结果判断。
- 记录最终统计。对比开始前的预检。
- 导出失败报告。只要有可导出的失败明细就保存报告。
- 检查已成功卡牌。在目标目录中抽查字段、模板和附件。
- 修复原表失败行。保留行号，避免打乱后难以对应。
- 只重试未成功内容。删除或过滤已经成功的行，重新选择合适重复策略。
- 等待同步。大批量导入后不要立即在另一设备继续编辑。
导出 Excel
选择“导出 Excel”后，可以多选目录和模板，并决定是否包含未分类卡牌。附加列可包含一级/二级目录、创建时间和更新时间；还可选择把可读取的图片和音频内嵌到 Excel，文件体积会增大。
导出文件按模板拆分工作表，每个工作表只包含该模板的字段。导出过程中可以取消；以最终“已导出多少张卡牌”提示和实际保存文件为准。
它适合检查、整理和再次导入内容，但不包含完整同步状态、全部学习记录和所有牌组关系。不要用它替代正常同步和安全维护流程。
导入后的检查
- 成功、失败、跳过数量与最终报告一致。
- 替换策略命中的确是预期卡牌。
- 目录名称没有因空格、数字写法或同义名称重复创建。
- 标题字段没有空值或批量重复。
- 富文本样式没有造成异常字号、颜色或换行。
- 附件能够显示或播放，并且状态正常。
- 只重试了失败行，没有再次导入全部成功内容。
常见问题
为什么“开始导入”不可用？
可能尚未选择模板、没有字段映射、预检仍在运行，或存在没有行号的全局错误。按配置顺序逐项检查。
为什么取消后仍然出现新卡？
已完成批次会保留。查看最终统计和逐行结果，只处理尚未成功的行。
为什么生成了重复目录？
表格中的目录名称存在空格、数字格式或文字差异。统一原表目录列，再把已导入卡牌移动到正确目录。
为什么附件缺失？
检查是否选择了正确资源目录，路径、文件名、扩展名和大小写是否一致，以及文件数、总大小和单文件限制。
为什么“替换”没有更新预期卡牌？
重复匹配基于标题字段和模板。确认目标模板、标题字段映射和现有卡牌标题是否完全符合预期。