一、功能用途
字段管理用于维护一个模板下的字段列表和字段属性。每张使用该模板的卡牌都会按这些字段保存内容，模板代码也通过字段名引用卡牌内容。
字段变更会影响已有卡牌、导入映射、预览、学习展示和练习生成。修改前应确认这个字段是否已经被模板代码或卡牌内容使用。
二、入口
在模板编辑页的“模板代码”区块标题右侧点击“字段管理”进入字段管理弹窗。只读模板会显示字段详情，不提供新增、删除、排序或保存入口。
三、字段列表
左侧字段列表展示当前模板的所有字段。点击字段可在右侧编辑该字段的配置。
- 点击“添加字段”会新增一个未命名字段，需要填写合法字段名后才能保存。
- 拖动字段可以调整字段顺序，字段顺序会影响制卡编辑和部分导入映射体验。
- 字段数量大于一个时，可以删除字段。删除前应确认已有卡牌不再依赖该字段内容。
- 取消弹窗不会把字段列表改动写回模板，只有点击“保存”才会返回修改结果。
四、字段名和备注
字段名是模板引用字段的标识，应保持稳定、清晰、可读。保存时会校验字段名：
- 字段名不能为空。
- 字段名不能重复。
- 字段名需要使用合法字符，避免空格、标点或特殊符号导致模板引用失败。
备注用于说明字段用途，适合写“显示在正面”“选择题答案”“用于连连看匹配”等维护信息。备注也能帮助预览生成更容易识别的示例内容。
题库题型模板有一些固定字段语义。选择题和判断题的题干建议使用 question 或 问题，答案建议使用 answer 或 答案，解析建议使用 explain 或 解析。选择题选项字段使用 A 到 H，默认常用 A、B、C、D。这些字段名会被导入、校验、预览和测验生成逻辑识别，不建议随意改名。
五、功能和样式权限
功能权限控制卡牌编辑器中这个字段可使用哪些内容能力，例如插入图片、音频、填空项、代码块、OCR 和数学公式。样式权限控制字段编辑时可使用的文字样式，例如字号、加粗、斜体、下划线、颜色、对齐、列表、上下标等。
如果某个字段只应该填写纯文本，可以关闭不需要的功能和样式，降低制卡时误插入复杂内容的概率。如果字段需要保存题干、解析或富文本内容，则应保留相应能力。
六、TTS 和语言
TTS 朗读用于控制字段在朗读相关场景中的行为：
| 选项 | 含义 | 适用场景 |
|---|---|---|
| 开启 | 允许该字段显示或参与朗读。 | 单词、句子、例文等需要播放的字段。 |
| 关闭 | 不把该字段作为朗读内容。 | 图片、解析、内部备注等不适合朗读的字段。 |
| 仅朗读 | 用于朗读相关能力，但不强调普通展示入口。 | 发音文本、隐藏朗读辅助字段。 |
语言会影响朗读发音和部分编辑体验。常用语言包括中文、英式英语、美式英语、德语、法语、西班牙语、意大利语、俄语、日语、韩语、葡萄牙语和阿拉伯语等。语言设置不确定时，可以先留空。
七、必填和标题字段
“必填字段”用于约束制卡，适合题干、答案、单词、释义等核心字段。非核心补充字段不建议设为必填，避免批量导入或快速制卡时增加不必要阻塞。
“设置为标题”用于指定卡牌在列表、搜索或预览中更容易识别的字段。一个模板通常只需要一个标题字段。字段改名时，标题字段会跟随有效字段名；标题字段被删除后应重新选择。
八、保存和取消
字段管理弹窗会先在本地副本上编辑字段。点击“取消”会放弃这些改动，不污染原模板。点击“保存”时会校验字段名，校验通过后才把字段列表和标题字段返回模板编辑页。
字段管理保存后，还需要在模板编辑页点击“保存”，模板变更才会真正写入。