编辑器卡牌模板和制卡规则说明

卡牌模板决定一张卡有哪些字段、字段如何编辑、学习时如何展示，以及是否支持选择题、判断题、听力、正反面等交互。卡牌内容本身存储在字段中，模板负责解释这些字段。

批量导入、卡牌预览、发布共享和学习展示都会依赖模板。修改模板前，应确认它会影响哪些已有卡牌。

类型	适合内容	注意事项
基础/正反模板	问答、概念、翻译、知识点。	字段结构简单，适合多数记忆卡。
选择题模板	单选、多选、题库练习。	属于题库题型模板，会直接生成选择题练习；答案必须指向有效选项。
判断题模板	是非判断、概念辨析。	属于题库题型模板，会直接生成判断题练习；答案字段应保持明确。
听力/单面等模板	音频、朗读、快速识别类内容。	需要检查音频资源和语言设置。

字段是模板的核心。字段名称会用于制卡、表格导入和学习展示。字段调整建议遵守以下原则：

字段的新增、排序、权限、TTS、语言、必填和标题字段等操作，请参考编辑器模板字段管理说明。

模板编辑可以调整模板名称、类型、字段、样式和选项。编辑模板会影响使用该模板的卡牌。保存前建议先预览几张代表性卡片，确认正面、背面和学习交互正常。

如果要做大幅改造，优先克隆或新建模板，再逐步迁移卡牌。

需要了解 CSS、正面模板、背面模板、正反卡反向样式、导入导出和保存校验时，请查看模板编辑页使用说明。需要配置练习能力时，请查看测验设置说明和连连看设置说明。

模板配置导入/导出适合在不同牌组之间复用模板。导入配置时，模板类型需要与当前模板匹配，否则可能无法导入。

导出模板配置只导出模板结构和样式，不等同于导出卡牌内容；卡牌内容应使用卡牌 Excel 导出或牌组导出能力。

给卡牌切换模板时，系统会重新按新模板字段解释当前卡牌数据。新模板缺少原字段时，相关内容可能无法显示；新模板多出的字段可能为空。

切换前建议先保存当前卡牌，并用预览确认新模板能正确显示。

选择题模板和判断题模板属于题库题型模板。它们的卡牌本身就是题目，系统会按模板类型直接生成对应的测验题，不需要再到“测验设置”里额外添加生成规则。

这和普通模板的测验设置不同：普通模板是先保存知识字段，再通过测验设置指定“问题字段”和“答案字段”来生成选择题、填空题或朗读题；题库题型模板则使用固定题型语义校验卡牌内容。

模板	核心字段语义	校验规则
选择题	题干字段、答案字段、A-H 选项字段、可选解析字段。	题干不能为空，至少需要两个选项，答案不能为空且应指向存在的选项。
判断题	题干字段、答案字段、可选解析字段。	题干不能为空，答案不能为空；表格导入时答案可填写正确/错误、对/错、true/false、1/0。

选择题模板通常包含题干、答案和选项字段。题干字段建议使用 question 或 问题；答案字段建议使用 answer 或 答案；选项字段使用 A 到 H。答案填写选项标识，例如 A、AC 或 A,C，不要填写完整选项文字。

判断题模板的题干字段同样建议使用 question 或 问题，答案字段建议使用 answer 或 答案。答案应保持明确，常用“正确”或“错误”，解释内容建议放在 explain 或 解析 字段中，不要和答案混写。

删除或改名题干、答案、选项字段前，应先检查已有卡牌、模板代码、表格导入映射和发布后的学习效果。题库题型字段的详细维护方式请参考字段管理说明。

预览用于检查模板、字段内容和资源是否能正确渲染。遇到预览失败时，先检查：

OCR 可用于从图片中识别文字、公式或题目并辅助填入字段。识别结果需要人工校对，尤其是公式、选择题选项、答案标识和标点。

OCR 是制卡辅助，不建议直接批量发布未校对的识别结果。