一、入口和数据来源
在记乎编辑器进入目标牌组，打开“卡牌管理”，点击更多菜单中的“导入表格”即可开始批量导入。导出时点击“导出 Excel”。
导入支持三类来源：选择本地表格文件、从剪贴板粘贴表格文本、下载示例 Excel 后按模板填写再导入。
二、文件格式
| 格式 | 支持情况 | 说明 |
|---|---|---|
.xlsx |
支持 | 适合保留表格结构和部分富文本样式；包含多个工作表时需要选择导入的工作表。 |
.csv |
支持 | 适合纯文本批量导入。注意编码、逗号和引号转义。 |
.xls |
不支持 | 请先用表格软件另存为 .xlsx 或 .csv。 |
| 剪贴板 | 支持 | 可从 Excel、Numbers、WPS 或网页表格复制后粘贴导入。 |
三、示例 Excel 和模板
导入前可以点击“下载示例 Excel”。示例文件会根据当前牌组的模板生成标题列和示例行。不同模板字段不同，因此建议先选择准确的卡牌模板，再批量填写。
如果当前牌组没有可用模板，示例 Excel 无法生成。应先在模板管理中创建或导入模板。
四、字段映射
导入配置页会把表格列映射到模板字段。系统会尝试根据列名自动匹配，但仍建议导入前检查每个字段：
- 必填字段必须对应到表格列，且对应单元格不能为空。
- 非必填字段可以不映射，导入后会留空。
- 选择题、判断题等特殊模板需要满足对应题型规则。
五、目录导入
示例 Excel 中的“一级目录”“二级目录”可用于智能创建或匹配目录。没有目录需求时可以留空。
如果选择自动目录，系统会按表格内容创建缺失目录，并把卡牌放入对应目录。导入大型表格前，建议先用少量数据测试目录结构是否符合预期。
六、重复卡处理
导入配置提供重复卡处理策略：
- 导入：即使疑似重复，也作为新卡导入。
- 跳过：遇到重复卡时不导入该行。
- 替换：用表格内容更新已有卡片。
如果表格来自同一个牌组的导出文件，通常选择“替换”更适合批量修订；如果是新资料，选择“导入”更安全。
七、资源和富文本
当字段中引用图片、音频、视频或其他文件时，应在导入配置中选择资源目录。表格中填写的资源文件名需要能在该目录中找到。
.xlsx 导入可保留部分富文本样式，例如加粗、斜体、下划线、删除线、颜色和字号。样式复杂时，建议先预览并导入少量数据测试效果。
八、预检和失败报告
导入前会生成预检结果。错误会阻止导入，警告不会阻止导入但可能导致字段为空、目录不符合预期或部分数据被跳过。
导入结束后，如果有失败行，可以导出失败报告。失败报告适合修正后再次导入，避免重新处理整张表。
九、导出 Excel
“导出 Excel”会按模板拆分工作表，每个工作表包含对应模板字段。它适合批量校对、外部编辑、迁移或备份卡牌内容。
导出后再导入同一牌组时，应重点检查模板字段、目录列和重复处理策略，避免把旧内容重复导入。
十、常见问题
为什么导入按钮不可用？
常见原因是没有选择模板、预检存在错误、模板还未加载完成，或当前账号/牌组权限不足。
为什么选择题导入失败？
通常是选项列为空、答案列填写了不存在的选项，或多选答案格式不符合要求。应按模板示例列填写。
为什么资源没有显示？
检查资源目录是否选择正确、文件名是否一致、大小写是否一致，以及表格中是否写入了扩展名。