AnkiWeb 发布说明

适用插件版本：0.2.6

本文档用于发布到 AnkiWeb。下面内容按 AnkiWeb 常用字段拆开，可以直接复制。

插件名称

构建体系

一句话简介

把 Anki 卡片按记忆关、理解关、行动关拆成可追踪、可分组、可恢复的学习进度体系。

详细说明

构建体系是一个 Anki 学习进度插件，用“记忆关 / 理解关 / 行动关”追踪每张卡片从记住、想明白到真正行动的状态。

插件不会修改你的普通笔记类型，也不会往卡片模板里新增字段。复习次数直接读取 Anki 原生 revlog；手动状态和分组恢复信息保存到一个专用同步数据笔记中，可以随 Anki 同步。

一、当前支持的关卡

1. 记忆关
- 直接读取 Anki 原生复习记录 revlog。
- “手动更改”记录不计入复习次数。
- 默认有效复习达到 10 次自动过关。
- 刷到卡片背面时，面板会把本次复习先计入显示次数。
- 支持手动过关、保持未过、清除手动状态。

2. 理解关
- 读取卡片笔记中的思卡字段。
- 默认字段名：思：经验感悟。
- 兼容字段名：思:经验感悟、thinking_card、思卡、字段2、字段2部分、Field 2、field2。
- 字段内容去掉 HTML 和空白后不为空，即自动通过理解关。
- 支持手动过关、保持未过、清除手动状态。

3. 行动关
- 读取卡片笔记中的行动管理字段。
- 默认字段名：行：计划准备。
- 兼容字段名：行:计划准备、行动、行动管理、行动卡、字段3、字段3部分、Field 3、field3、action、Action。
- 字段中包含默认标记“#行动”时，这张卡进入行动关统计。
- 默认行动次数达到 1 次自动通过行动关。
- 推荐写法：#行动 数：0 / 做： / 记：。
- 完成一次真实行动后，把第一行改成：#行动 数：1。
- 支持手动过关、保持未过、清除手动状态。

二、刷卡背面的单卡面板

- 面板只在卡片背面显示，正面不显示。
- 可在设置中关闭。
- 可设置显示在卡片顶部或底部。
- 面板里有“记忆关 / 理解关 / 行动关”横向按钮。
- 默认显示逻辑按“记忆关 -> 理解关 -> 行动关”推进。
- 每个关卡都可以手动过关、保持未过、清除手动状态。

三、仪表盘

打开路径：
工具 -> 构建体系 -> 仪表盘

仪表盘支持：
- 选择单独卡组查看进度。
- 在记忆关、理解关、行动关之间切换统计视图。
- 查看总卡片数、已过关数量、未过关数量和完成率。
- 查看当前关卡的未过卡片列表。
- 在行动关页复制行动字段模板。

四、分出未达标卡片

仪表盘的“分出未达标”按钮可以把当前关卡未达标卡片移动到对应子卡组，方便集中处理。

默认子卡组：
- 原卡组::记忆关未达标
- 原卡组::理解关未达标
- 原卡组::行动关未达标

规则：
- 在记忆关页点击，只分出记忆关未达标卡片。
- 在理解关页点击，只分出理解关未达标卡片。
- 在行动关页点击，只分出行动关未达标卡片。
- 不会顺手移动另一关的未达标卡片。
- 已经有分出记录的卡片会跳过，避免恢复数据和实际卡组位置不一致。

五、恢复卡片

仪表盘提供两个恢复按钮：

1. 恢复已过关
- 只恢复当前所选卡组里已经通过对应关卡的分出卡片。
- 仍未达标的卡片继续留在未达标子卡组。

2. 全恢复
- 不检查是否过关。
- 直接恢复当前所选卡组中所有已有分出记录的卡片。

恢复时会写回原卡组 ID 和原 due 排序值，尽量保持原来的卡片顺序。恢复成功后，对应备份记录会自动删除。如果某条记录指向的卡片已经不存在，恢复流程会清理这条陈旧记录。

六、设置

打开路径：
工具 -> 构建体系 -> 设置

可配置内容包括：
- 记忆关自动过关次数。
- 是否刷够次数自动过记忆关。
- 是否允许三关手动过关或保持未过。
- 是否显示刷卡单卡面板。
- 单卡面板显示位置。
- 同步数据卡组。
- 理解关思卡字段名。
- 行动关行动管理字段名。
- 行动项标记。
- 行动关过关行动次数。
- 三个未达标子卡组后缀。

七、数据存储和同步

默认同步数据卡组：
0.1.0归档::@六大关卡数据备份@

默认数据笔记类型：
Memory Gate Sync Data

数据笔记主要保存：
- 记忆关手动状态。
- 理解关手动状态。
- 行动关手动状态。
- 分出未达标前的原卡组和原排序信息。

复习次数不额外保存，始终读取 Anki 原生 revlog。

八、适用场景

适合想把 Anki 学习拆成阶段的人：
- 先确认一张卡是否复习够次数。
- 再检查是否写过理解、感悟或思卡。
- 最后追踪是否完成至少一次真实行动。
- 把未达标卡片临时分组集中处理。
- 达标后恢复回原卡组和原排序。

九、注意事项

- 当前版本实现记忆关、理解关和行动关。
- 表达关、应用关等后续关卡还在开发计划中，当前版本不会把它们当作已完成能力。
- 如果你以前安装过旧版六大关卡插件，并且旧插件给普通卡片模板新增过字段，建议先清理旧字段，再使用当前插件。
- 默认同步数据卡组名仍包含“六大关卡”，这是为了兼容旧数据；插件菜单和显示名已经改为“构建体系”。
- 本插件依赖 Anki 的 revlog 统计复习次数。如果某张卡没有正常复习记录，记忆关不会自动过关。

十、反馈信息

反馈问题时建议提供：
- Anki 版本。
- 插件版本。
- 复现步骤。
- 出错卡组名称。
- 是否使用了自定义同步数据卡组。

项目主页：
https://gitee.com/harel-zhao/anki-six-gates-plugin

更新日志

0.2.6
- 插件显示名和菜单入口更新为“构建体系”。
- 仪表盘标题同步更新为“构建体系仪表盘”。
- 支持记忆关、理解关、行动关三关统计和单卡面板横向切换。
- 记忆关读取 Anki 原生 revlog，默认有效复习 10 次过关。
- 理解关默认读取“思：经验感悟”，兼容 thinking_card、字段2 等旧字段名。
- 行动关默认读取“行：计划准备”，识别“#行动”，行动次数达到 1 次即过关。
- 仪表盘支持按当前关卡分出未达标卡片，不会顺手移动另一关未达标卡片。
- 恢复功能会写回原卡组和原 due 排序值，并清理已恢复或陈旧的分出记录。
- 新增独立使用文档，方便安装和上手。

发布前检查

1. manifest.json 中 name 为“构建体系”。
2. 打包文件根目录直接包含 manifest.json、__init__.py、config.json。
3. 安装后菜单路径为：工具 -> 构建体系。
4. 刷卡背面能看到记忆关 / 理解关 / 行动关横向按钮。
5. 仪表盘标题显示“构建体系仪表盘”。
6. 默认同步数据卡组保持 0.1.0归档::@六大关卡数据备份@，确保旧数据兼容。