这篇指南解决什么问题
编辑器总览用于建立完整的制卡工作模型。它不替代每个功能的详细说明，而是告诉你应该从哪里开始、几个管理模块之间如何互相影响，以及怎样完成一次可检查、可继续维护的制作流程。
记乎桌面版同时提供牌组编辑和正式学习。你可以编辑自己创建、自己发布或明确拥有编辑权限的牌组；购买、加入班级或从商城安装的牌组不会自动获得编辑权限。
新建牌组的入口不在桌面版
桌面版首页可能展示“新建牌组”入口，但当前产品流程仍以记乎 App 创建牌组为准。先在 App 创建并同步；桌面端出现该牌组后，再进入编辑工作台。
进入编辑器前先确认
- 确认账号。桌面版和 App 使用同一记乎账号，避免把牌组创建在另一个账号中。
- 确认牌组已经同步。在 App 创建牌组后完成一次同步，再在桌面版刷新或同步数据。
- 确认编辑权限。能学习和浏览不代表能编辑。只读牌组仍可查看模板和附件，但新增、保存、导入和删除操作会被禁用。
- 确认没有并行大改。不要同时在两台设备大批量调整同一牌组的目录、模板和卡牌。
- 确认本轮目标。先决定是少量精修、批量导入、模板改版还是资源清理；不同任务需要不同的检查顺序。
认识编辑工作台
打开可编辑牌组后，顶部三个主标签分别是“卡牌管理”“模板管理”和“附件管理”。编辑过程中还会用到同步、发布、学习设置和表格工具，但它们不是同一种数据。
| 区域 | 负责什么 | 不会自动完成什么 | 典型风险 |
|---|---|---|---|
| 卡牌管理 | 目录树、卡牌列表、单张编辑、搜索、排序、批量移动或删除、表格导入导出 | 不会替你修正模板结构，也不会自动清理未使用附件 | 选错目录或批量范围；删除后无法恢复 |
| 模板管理 | 模板类型、字段、正反面代码、CSS、测验和连连看配置 | 不会只影响当前打开的一张卡 | 改动会同时影响使用该模板的所有卡牌 |
| 附件管理 | 添加、搜索、筛选、预览、下载、复制文件名、删除、清理和导出附件 | 不会自动判断一个附件是否应该保留 | 删除仍被引用的文件会造成缺图或无法播放 |
| 表格工具 | XLSX、CSV、剪贴板导入和 Excel 导出 | 不会保证整批事务性回滚 | 重复策略或字段映射错误会批量改变内容 |
理解五类内容的关系
很多误操作来自把目录、模板和卡牌当成互不相关的文件。实际关系如下：
- 牌组是编辑、学习、同步和发布的基本范围。目录、模板、卡牌和附件都属于某个牌组。
- 目录组织卡牌。目录最多三级；删除一个目录会递归处理它的子目录和其中卡牌。
- 模板定义字段和卡面。修改模板版式会影响所有关联卡牌；有关联卡牌的模板不能删除。
- 卡牌保存字段内容并关联一个模板。已有卡牌不能在编辑页直接切换到另一个模板。
- 附件以文件形式保存在牌组资源库中，字段内容保存对文件的引用。同一附件可以被多处引用。
因此，结构性维护通常要先处理引用关系。例如要删除字段，应先确认模板代码和活动配置；要删除附件，应先替换卡牌中的引用；要删除模板，应先处理所有关联卡牌。
完成一次制卡的推荐流程
- 准备牌组。在 App 中创建牌组并同步；在桌面版打开后确认名称、作者和编辑权限。
- 规划目录。用一级目录表达大主题、二级目录表达章节，必要时再使用第三级。不要先导入大量数据再临时发明分类。
- 选择模板策略。检查现有模板能否满足目标。新建模板时先确定学习方向，再决定基础卡、完形填空或正反模板。
- 定义字段。确定标题字段、必填字段、朗读语言和允许使用的富文本能力。字段名应短、稳定且不重复。
- 制作代表性样例。至少准备普通文本、长文本、空可选字段、公式和媒体等不同卡牌，验证正面、背面、深色模式与活动。
- 选择录入方式。少量复杂内容逐张编辑；结构一致的批量内容使用表格；已有内容的大范围修改先导出备查。
- 检查附件。确认文件格式、大小、播放或预览状态以及本地/云端状态。批量导入时核对资源目录限制。
- 检查结果。随机抽查不同目录和模板的卡牌，不只检查第一张；实际进入一次学习或测验验证最终呈现。
- 等待同步。大批量操作结束后等待同步完成，再换设备、发布或继续做高风险维护。
选择逐张制卡还是表格导入
| 情况 | 推荐方式 | 原因 |
|---|---|---|
| 几十张以内，包含公式、图片或复杂排版 | 逐张新建 | 便于即时预览和修正富文本 |
| 数百张结构一致、字段明确 | 表格导入 | 可统一映射字段、目录和重复策略 |
| 更新已有卡牌的同一字段 | 先导出，再用少量样本验证“替换已存在卡牌” | 避免标题匹配到错误卡牌 |
| 模板结构正在变化 | 先完成模板和样例，不立即批量导入 | 减少批量内容随后再次迁移 |
| 内容来自多个来源且格式不一致 | 先清洗表格，再分批导入 | 导入工具不会替你统一语义和命名 |
完成后的检查清单
- 在“全部卡牌”和目标目录中核对卡牌数量。
- 分别打开每个使用中的模板，检查正面、背面以及正反模板的第二个方向。
- 抽查标题为空、内容最长、包含附件、包含公式和包含可选空字段的卡牌。
- 如果使用表格导入，记录成功、失败、跳过数量并保存失败报告。
- 在“附件管理”中检查“缺失”“未登记”或“异常”状态，不立即对所有项目执行清理。
- 进入正式学习、测验或连连看，验证内容不是只在编辑预览中看起来正常。
- 确认同步完成；换设备后先同步，再抽查相同内容。
结构性修改的安全顺序
删除和覆盖通常无法撤销
批量删除卡牌、递归删除目录、删除附件、覆盖重复卡、重置学习和完全删除牌组都可能传播到其他设备。操作前先确认范围，不把未同步的另一台设备当作备份。
- 先查看，再修改；先处理少量样本，再扩大范围。
- 先解除引用，再删除字段、模板或附件。
- 先完成当前同步，再开始下一轮结构性修改。
- 模板、目录和批量导入不要同时大改，避免无法判断异常来自哪个步骤。
- 遇到部分成功时只重试失败项，不重新执行整个批次。