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

一、模板的作用

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

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

二、模板类型

三、字段管理

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

• 字段名应稳定、清晰，不要频繁改名。
• 删除字段前，确认已有卡牌不再需要该字段内容。
• 用于选择题选项的字段，不应随意改成普通字段。
• 字段默认语言会影响朗读和部分编辑体验。

四、模板编辑

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

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

五、配置导入导出

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

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

六、切换模板

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

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

七、选择题和判断题

选择题模板通常包含题干、答案和选项字段。答案应填写选项标识，而不是完整选项文字。删除选项前，应先把答案中对应选项移除。

判断题应保持答案明确，解释内容建议放在解析字段中，不要和答案混写。

八、预览和排查

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

• 必填字段是否为空。
• 模板字段是否和卡牌数据匹配。
• 图片、音频或视频资源是否存在。
• HTML 内容是否包含无法渲染的结构。

九、OCR 制卡

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

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