下载 v0.9.0 · Lab 作答与批注 · 在线复习册 · 安装与使用 · 更新日志
v0.9.0：论文先看扣题和业务实践。 普通论文写作与批改由高级备考 Skill 处理，Lab 论文评阅与题库模拟范文共用同一套方法：逐项回应题干、核对技术机制和本人行动，再调整摘要、结构与语言。已授权的应试模拟按可行性和自洽性评阅。更新说明。
v0.8.0：直接在答卷上看批改痕迹。 soft-exam-lab 为系统架构设计师准备本地作答网页，交卷后由当前 Agent 逐点评阅。你能看见具体在哪个词句得分、哪里容易误解、哪里已被判错，再对照下方的完整参考答案复盘。
上图是经答卷作者授权展示的 2018 年下半年试题一、问题 1 的真实作答节选，保留原来的 6/8 分。绿色标出真正支撑得分的词句，黄色提示表述风险，红色标出明确错误。没有批注的部分保持原样。点击右侧引文，会定位并框出左侧相应片段；原始 Markdown 可展开查看。
黄色提示不额外扣分。红色的影响取决于已有评分依据，反馈中会区分未得分、来源细则扣分和严格训练扣分，避免同因重复扣罚。完整参考答案放在你的原答卷下方；来源只有笼统建议时，Skill 会根据题干和可靠依据补成应试答案，并注明生成方式。
按原卷自动确定计分题。 对2018案例卷，试题一必计，选答题取题号最小的两道已答题；多答题仍给出批改和得分，并明确“不计入总分”。原卷规则、实际计分范围、75分总分和及格判定在报告上方显示。旧练习也可在保留原始提交的前提下更正口径。
参考答案与评分使用同一版依据。 Agent 先核实原始资料，再从完整答案提取采分点；报告前逐题核对分类、空号、候选项、条件和方案顺序。运行器会拦截独立答案覆盖、来源分叉和缺少核对记录，无法解决的争议保留待核验。全文的语义审阅由当前 Agent 完成；更正会保留原答卷与旧报告。
- 指定试卷或练习范围。 年度案例按原卷必答、选答规则准备，页面顶部显示要求；2018 年案例一必答、二至五选二，满分 75 分。明确单题时，保留该大题的全部小问。其它年份以实际原卷为准。
- 在网页中作答。 Agent 在正文给出实际的 127 本地链接并打开页面，在当前会话等待交卷；网页交卷成功后无需再点聊天确认卡。当前小问同时显示在右侧编辑区上方，支持计时、暂停、自动保存、常驻 20 步撤销、Markdown／公式预览和绘图。内建浏览器或 Chrome 等普通浏览器均可使用同一本机地址；草稿可导出续接。
- 交卷后逐点复盘。 当前 Agent 阅读冻结答卷和评分表，给出参考估分、严格训练分、单科及格判定与主要失分位置。彩色批注与引文使用同一组证据；遗漏和待核验不会被伪装成已写出的错误。可靠失分点按既有章节契约归档。
$soft-exam-lab 为我准备 2018 年下半年系统架构设计师案例分析真题，按原卷选答规则练习，使用自由计时。
论文使用同样的批注方式。 按原卷选一篇，分别填写摘要与正文；报告逐条对照论述要求、检查字数，并提供完整应试参考范文。未公开的逐点权重明确标为推定训练评分，不冒充官方细则。
上图是自编 SOA 论文片段，用来演示批注交互；固定分值不代表正式论文阅卷结果。
$soft-exam-lab 为我准备 2018 年下半年系统架构设计师论文真题，按原卷四选一作答。
使用者需要当前 Agent 的阅读与本地工具能力，以及 Python 3.9+；无需 npm 或额外模型 API。首次会确认题库和档案位置。未经核实年份、题号的材料仅作为普通练习，不冒充历年真题。
Lab 完整说明 · Lab 功能与验证 · 安装到你的工作区
公开包包含八个完整 Skill，支持 Antigravity、Codex、Claude Code／Claudian、Trae 和 ZCode。它们共用章节与归档契约，各自负责不同任务。
| Skill | 用途 | 入口 |
|---|---|---|
soft-exam-lab |
案例与论文作答、原文三色批注、按原卷计分及完整参考答案 | 显式点名 |
soft-exam-question-tutor |
单题讲解、错因诊断、变式 Grill、授权后章级归档 | 发送完整题图或文本并要求讲题 |
soft-exam-bank-ingest |
浏览器案例／论文入库，原图保存、小问合并、逐问解析与续接 | 显式点名 |
soft-exam-review-book |
已学章节二次蒸馏为图文、速查与自测 | 要求制作、续写或修订复习册 |
soft-exam-prep |
软件设计师中级学习计划、练习和复习进度 | 中级备考请求 |
soft-exam-organizer |
导入明确提交的完整中级历史对话 | 点名或提交历史导入任务 |
soft-exam-architect-prep 本版更新 |
高级计划、案例、论文写作与批改、周期复习 | 高级备考请求，含单篇论文改稿 |
soft-exam-architect-organizer |
导入明确提交的完整高级历史对话 | 点名或提交历史导入任务 |
题库整理与实验室仅接受 $skill-name、@skill-name 或“使用 skill-name”的实际调用；引用名称和初始化时提及不启动。已启动批次或场次可直接“继续”。普通客观题与案例题讲解保持 tutor 路由；单篇论文改稿走高级备考，不自动启动 Lab。章节制作和题库批次不继承单题工具限制、强制 Grill 或逐题归档卡。
安装时保留八个完整目录与各自的 references/、assets/、scripts/，不能只复制入口文件。两级知识资料与空错题本随包提供，个人题库、登录信息与本机配置不进入发布包。
当前已整理高级／系统架构设计师的以下章节，每个小节均可切换“图文、速查、自测”。
| 在线阅读 | 范围与内容 | 最近更新 |
|---|---|---|
| 第二章 · 计算机系统基础知识 新 | 2.1–2.9；151 张图、348 道自测 | 2026-10-05 |
| 第三章 · 信息系统基础知识 新 | 3.1–3.8；88 张图、243 道自测、276 条术语索引 | 2026-10-05 |
| 第五章 · 软件工程基础知识 | 5.1–5.7；42 个知识组、159 道自测 | 2026-10-04 |
| SMTP／POP3 图文样章 | 邮件收发机制、速查与 6 道自测 | 2026-10-03 |
复习册会随整理与勘误持续更新；合并到 main 后由 GitHub Pages 发布。欢迎其他考生协作推送，一起完成各个科目的知识库搭建。 可提交 Issue 或 Pull Request，补充讲解、图解、变式题及完整章节。
章节按 artifacts/<级别>/<科目>/NN_章名/ 保存。贡献请注明教材版本和来源，区分原题、改编题与自编题，检查图文关系、导航和自测；仅提交可公开的复习内容。教材全文、个人作答、项目底稿与制作日志保留本地，出处与许可见 NOTICE。
复习册不放入 Release 安装包，也不放入 GitHub 自动生成的 Source code 压缩包。 在线直接阅读；离线使用可 克隆完整仓库 后打开相应 index.html，保留其图片、CSS 与 JavaScript。SMTP／POP3 样章仍随安装包提供。
以上是宣传示意；复习册图中包含现有 SMTP／POP3 样章截图，作答实验室布局以实际页面为准。
发一张完整题图，告诉它“我选 B，请解析”。讲解会围绕题目考查的知识、推理过程和选项边界展开。有需要时继续做变式练习，看看条件改变后还能不能判断；未作答或只想快速听解析，也可以跳过练习。
普通讲题后可确认归档；明确要求“只讲解”时直接结束。确认归档后，Agent 将本题的知识点与错题记录整理到对应章节，并回读核验。省下手动复制和排版的时间，下一次能找到当时的错因。本题已有明确归档授权时直接沿用；用户明确授权第 1–3 题及目标时，逐题执行并记录结果，范围之外的新题重新确认。
复习册按教材小节连续展开，正文解释机制，大图表达关系，速查保存判断线索，自测检验条件迁移。相似名词放在同尺度图中比较，通信采用时序图，计算用小黑板与逐步演算；经核验反复出错或用户点名的考点详细讲解。
创意写作优先交给 Antigravity（agy）中的 Gemini，Claude Code 作为后备；Codex 核验并制作核心图，Grok 可制作少文字的辅助图。CLI 找不到时填写位置或跳过，无需全部安装。生图前两轮提示词复核、tutor 方法复核，生成后实际看图，再在内建浏览器检查页面。原始教材和笔记保留，局部修订不重置无关自测。
使用 soft-exam-review-book，将系统架构设计师高级第三章“信息系统基础知识”做成图文、速查与自测复习册。重点比较 TPS、MIS、DSS、ES、OAS、ERP；按小节完成，整章结束后统一审阅。
在内建浏览器中打开题库并登录，直接点名 soft-exam-bank-ingest，指定题号或整理剩余题目。Agent 保存题干和原图，合并同案例的小问，补上考场答案、采分要点与详细解析；论文生成完整应试模拟范文，整理中断后可续接。
@soft-exam-bank-ingest 为我完成当前打开页面 79～85 题的案例题和论文题整理。
需要能实际看图的模型、浏览器工具与本地保存能力。首次资料位置不明确时，从真实目录候选中选择。只读取题目、展开解析和导航，答案保存本地，不代填网站或交卷。详见 题库整理说明。
需要 Python 3.9 或更新版本。脚本仅使用标准库，无需安装 Python 依赖。
从 v0.9.0 Release 下载 ruankao-toolkit-v0.9.0.zip 并解压。该包保留全部八个 Skill、实验室本地运行资源与 SMTP／POP3 样章，排除 artifacts/。也可以获取相同版本的完整 Git 仓库（包含知识库）：
git clone --branch v0.9.0 --depth 1 https://github.com/Goodyzhang/ruankao.skill.git
cd ruankao.skill以下命令在解压目录或仓库根目录中运行。../RuankaoVault 是目标 Vault，可替换为自己的路径；目标应与发布包目录分开。
macOS / Linux：
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform antigravity --dry-run
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform antigravityWindows PowerShell：
py -3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform antigravity --dry-run
py -3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform antigravity脚本将八个完整 Skill 放入 .agents/skills/，将资料放入 个人资料/笔记/软考/。已有文件默认保留，并列出跳过的文件；重复运行不会清空错题和进度。
在 Antigravity 中打开目标目录并新建会话；使用 Obsidian 时，也将这个目录作为 Vault 打开。普通学习资料目录同样可用。发现目录与加载行为见 Antigravity 官方说明。
Antigravity 用户可以安装 可选 Harness。它仅在已确认的软考单题会话中提醒卡片续接、约束工具并拦截讲题后裸退；普通图片、文档和其它 Agent 不受影响。
当前工作区就是我的 Obsidian Vault。
软考知识库位于“个人资料/笔记/软考”。
我准备系统架构设计师高级，请读取 soft-exam-architect-prep，
先了解我的考试批次、基础与每周学习时间，再给本周计划。
不要把模板或虚构论文案例当成我的真实经历。
中级学习换成 soft-exam-prep。计划、进度和项目底稿由使用者提供事实后填写。
安装后在目标工作区新建会话，复制下面的 prompt。将 {请在这里填写你的工作区或 Vault 路径} 替换为你的路径；已经在目标工作区中时，也可改为 .。Skill 根目录由 Agent 探测，无需照抄作者的本机路径。
请执行软考学习导师（Soft Exam Tutor）初始化流程。
我的工作区或 Vault：{请在这里填写你的工作区或 Vault 路径}
请先确认该目录存在，将以下路径均相对于它解析。读取现有的最新 SOP、契约与规则，作为后续执行依据；本次仅初始化，不启动讲题、案例题场次、复习册制作或归档。
1. 【探测权威目录与分工】
- 如存在 AGENTS.md，完整读取其软考入口、路由与方法学；不要假定安装包一定提供这个文件。
- 优先遵循工作区已声明的权威目录。如 .agents/skills/ 或 .trae/skills/ 中只是发现桥接，继续读取其指向的完整源文件。
- 独立安装时，核对 .claude/skills/、.agents/skills/、.trae/skills/、.zcode/skills/ 中实际存在的 soft-exam-question-tutor，以完整且已声明的源作为 SKILL_ROOT。存在多个冲突版本时先说明差异，不能静默任选或混用。
- 确认八个 Skill 的分工：单题由 soft-exam-question-tutor 负责；学习计划和周期复习由对应级别的 prep 负责；完整历史导入由 organizer 负责；章节复习册由 soft-exam-review-book 负责；soft-exam-lab 只接受用户显式点名，初始化中提及名称不算启动；题库整理 soft-exam-bank-ingest 同样只接受显式调用。
2. 【运行时与终止保护】
- 如存在 GEMINI.md、.agents/rules/soft-exam-suspension.md，读取相关规则；缺失时如实报告，不伪造加载结果，也不自行安装 Hook。
- 卡片必须通过当前会话实际提供的原生提问工具调用，不能在正文输出伪 JSON 或调用文字冒充卡片。
- 卡片待答时等待真实返回，不重复弹卡；预选、空回复和超时不当作用户作答或授权。
- 识别带 (Recommended)、[推荐]、选项编号的真实终止选择；用户选择结束本题、已完成等待下一题或不归档时正常结束，不能循环补卡。
- 核对已有归档授权与实际写入、回读结果；已经完成的步骤不重复执行，不能仅凭模型声称“已归档”判断完成。
3. 【完整读取单题核心契约】
- SKILL_ROOT/soft-exam-question-tutor/SKILL.md
- SKILL_ROOT/soft-exam-question-tutor/references/first-use.md
- SKILL_ROOT/soft-exam-question-tutor/references/runtime-interaction.md
- SKILL_ROOT/soft-exam-question-tutor/references/knowledge-base-contract.md
- SKILL_ROOT/soft-exam-question-tutor/references/grill-diagnostic-contract.md
- 后续只按实际任务加载其它 Skill 的完整 SOP，不让单题规则限制章节制作或实验室。
4. 【资料位置】
- 检查已有本地绑定及工作区默认资料目录，已有有效绑定直接复用。
- 必要位置不明确时，用实际可用的追问卡提供 1～2 个真实候选，或请我手动填写绝对路径；没有候选就说明没有探测到。没有卡片工具时说明限制，并按契约处理。
- 选择位置不等于同意归档本题，不创建虚构做题记录，不把初始化扩展为批量归档授权。
【完成汇报】
1. 列出实际读取的核心契约相对路径；版本、哈希或修改时间只报告实际可核验的信息，缺失文件另列。
2. 简述五项守则：输入 Gate 补齐、五段式讲解、基于真实作答的 Grill 门控、授权范围内章级归档与回读、终止与中断保护。
3. 核心契约齐全且工具检查完成后回复：“软考辅导环境已就绪，请上传软考题目图片、截图或文本开始。”未完成时说明缺口，不声称就绪。需要案例题时，初始化后另发显式调用：
$soft-exam-lab 为我来一道系统架构设计师软件系统设计案例题真题，就做一道。先确认题库和练习档案位置，使用自由计时。
不用事先把每个目录都改成示例中的样子。Skill 会先检查你明确提供的位置、已有绑定，以及工作区中的默认资料布局；已有有效配置直接沿用。
需要选择时，会出现位置卡片：点击探测到的资料目录，或直接输入你自己的绝对路径。候选会显示实际路径；没有候选就请你填写。选择保存位置不等于同意归档某一道题，单题仍按本题授权执行。
- 只想讲题：可以先讲解，归档前再确定目标科目与位置。
- 已有笔记：沿用现有章级文件和命名，不另造一份平行错题本。
- 制作复习册：需要协作时才查找对应 CLI；找不到可填写可执行文件位置或跳过，由后备角色继续。
- 没有 Obsidian 或卡片工具：普通资料目录也能使用；环境配置可用简短文字问答，单题练习与归档仍遵守其实际交互规则。
已选择的位置与跳过项按本地续接约定复用；换机器或路径失效后再核验。工具探测不会自动安装软件、修改 PATH 或替换你的模型配置。
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform codex
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform claude
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform trae
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform zcode| 参数 | 目标目录 |
|---|---|
antigravity / codex |
.agents/skills/（共用一份） |
claude |
.claude/skills/（Claude Code / Claudian） |
trae |
.trae/skills/ |
zcode |
.zcode/skills/ |
--platform antigravity claude 可同时安装。结构化提问工具以当前会话实际暴露的能力为准；脚本不会安装或伪造工具。
把 skills/ 下八个目录完整复制到平台目录，或使用 Skills CLI：
npx skills add Goodyzhang/ruankao.skill -a antigravity在选择界面选齐八个 Skill。此方式只安装 Skill；知识资料仍需通过初始化脚本或手动复制 vault/ 的内容取得。
若已有 .claude/skills/ 权威源与 .agents/skills/ 发现桥接，应沿用该组织方式，将公开包合并到权威源，再维护桥接。不要用 --upgrade-skills 覆盖发现桥接。通用初始化面向独立 Vault，不负责迁移已有多端同步配置。
- 讲题：提供完整题图后说“我选 B，请解析”。Agent 先复原题目、说明考点、解题链和选项边界，再询问是否 Grill。未作答或明确快速讲时跳过 Grill；明确要求直接归档时沿用授权写入。
- Grill：“开始 Grill”。生成变式含一个正确项和两个干扰项；复用原题时按宿主能力保留完整选项。选择后先反馈，再决定下一题，最多三轮。“结束”或“换题”结束当前题。
- 归档：“将本题归档到高级”。授权只用于本题；写入章级知识点和错题本后回读核验。下一题重新建立状态与授权。
- 章节复习册：“第五章已经学完，请制作图文速查复习册”。按小节取材、写作、生图、复核，整章完成后统一审阅；也可指定某个专题或局部修订。
- 复习：“今天有哪些 D1/D7/D21 到期？”依据实际完成日期计算，空日期不会被当作今天到期。
- 论文：“按题干逐项批改这篇论文，并改成完整考场稿”。先给出原文的扣题证据、技术问题与具体改法，再写完整摘要和正文；用户已明确的真实经历或应试模拟口径持续沿用。模拟写作允许合理设计技术与结果，正文保持完整表达，设定说明另存。详见 论文写作与批改。
- 历史导入：“请用高级 organizer 整理下面这份完整历史对话”。只导入明确提交的材料；题干、选项或必要图片缺失时先补齐。
skills/ 八个完整 Skill
scripts/ 初始化与包验证
tests/ 初始化、路由与阅读状态测试
docs/demo/smtp-pop3/ 可离线打开的 SMTP／POP3 样章
artifacts/高级/系统架构设计师/ 仅完整 Git 仓库／在线知识库提供
02_计算机系统基础知识/ 第二章复习册
03_信息系统基础知识/ 第三章复习册
05_软件工程基础知识/ 第五章完整复习册，index.html 为入口
integrations/antigravity-harness/ 可选长上下文 Harness 与安装器
vault/
软考工具包使用说明.md
个人资料/笔记/软考/
系统架构设计师-高级/
知识点/ 20 章
错题本/ 20 个空错题框架
真题库/ 上午、下午、论文、案例
00_学习总计划.md
01_学习进度看板.md
02_论文项目底稿.md 空白项目事实表
03_错题与复盘模板.md
… 学习卡、速查、论文示例与模板
软件设计师-中级/
知识点/ 12 章 + 4 份速查
真题库/ 上午、下午
软考-软设-错题本.md 12 章空框架
00_学习总计划.md
00_备考仪表盘.md
两级目录合计 126 份初始化资料，另有一份 Vault 使用说明。部分知识章尚为骨架；真题库覆盖不完整，并保留 OCR、回忆版、缺图及答案分歧标记。关键图示缺失时需补图，不能依据答案猜题。来源与许可范围见 NOTICE。
下载新版到独立目录，运行初始化，默认只补充缺少的文件。需要更新 Skill 时使用：
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform antigravity --upgrade-skills --dry-run
python3 scripts/init_toolkit.py --vault "../RuankaoVault" --platform antigravity --upgrade-skills--upgrade-skills 会覆盖所选平台的同名 Skill 文件，包括手工定制的内容。它始终保留已有知识点、错题本、计划与论文底稿。知识资料升级需人工比较、合并；不要用公开模板覆盖个人记录。
已安装旧版可选 Harness 的 Antigravity 工作区，还需从新版发布包根目录单独更新 Hook 与脚本。先预览，再执行：
py -3 integrations/antigravity-harness/install_harness.py --workspace "D:\YourVault" --force --dry-run
py -3 integrations/antigravity-harness/install_harness.py --workspace "D:\YourVault" --forcemacOS / Linux 把 py -3 换成 python3。--force 只替换同名 Harness Hook、脚本和规则，保留其它 Hook；更新后在 Antigravity 中重新打开工作区并新建会话验收。
展开安装、卡片与归档排查
| 现象 | 处理 |
|---|---|
| 没发现 Skill | 确认打开的是目标 Vault，检查 .agents/skills/soft-exam-question-tutor/SKILL.md，再新建会话 |
| Lab 只有卡片、没有作答入口 | 升级到 v0.8.4 完整 Lab Skill；正文先显示已核验的 127 链接，默认打开页面并等待真实交卷。索要 URL 时直接重发正文链接，不再弹状态卡 |
| 只讲题、不弹卡 | 升级到 v0.3.7 并用 --force 更新可选 Harness。PostInvocation 在每轮回复后检查漏卡并要求自动补发；以真实工具事件判断是否成功，正文中的调用文字不能替代卡片。工具未暴露时检查所选 Agent 的工具配置 |
| 对话变长或回复“？”后再次漏卡 | v0.3.7 按当前题和真实卡片返回续接，不再依赖反馈标题；大段工具结果不会按 256 KiB 截断题目上下文。升级后重开工作区以加载新 Hook；执行结果见会话产物目录下 soft-exam-card-events.jsonl |
| Grill 收尾后没有归档确认卡 | 提前达到掌握证据可以结束追问，但仍需本题的归档确认。v0.3.6 的 Stop Hook 会在已确认的单题流程中尝试补发原生归档卡；用户已明确结束、拒绝或确认归档时不重复发卡 |
Grill 收尾时出现 call:default_api:ask_question 文字 |
这是正文文本，没有真实卡片。升级可选 Harness 后新建会话验证；已显示的乱码无法由 Hook 撤回 |
| 卡片已弹出，正文却夹着调用参数 | 直接点选已出现的卡片，不根据正文重复作答或重发；升级 Skill 与可选 Harness 后新建会话复测 |
Hook 路径出现 .agents/.agents/scripts |
升级到 v0.3.2 并用 --force 更新可选 Harness；Hook 脚本路径应相对于 .agents/ 写成 scripts/... |
| 等待卡片 | 先完成已有卡片；没有返回结果不能当作同意 |
| 工具缺失或报错 | Agent 应报告阻塞位置；用户明确选择文字交互后才能改用文字问答 |
| 对话中断 | 发送“继续当前题”，核对最近工具结果与写入状态后续接 |
| 缺图或 OCR 损坏 | 补齐原题，不根据解析反推题干 |
| 提示保留已有文件 | 属于默认保护行为；Skill 可显式升级，资料人工合并 |
python3 scripts/validate_toolkit.py
python3 -m unittest discover -s tests -v
# 开发验证：若已有支持 node:test 的 Node.js
node --test tests/test_review_quiz_state.cjs本次论文批改方法见 v0.9.0 发布说明；入口与监听补丁见 v0.8.4 发布说明；自动计分验证范围见 v0.8.3 发布说明；参考答案一致性修复见 v0.8.2 发布说明；Tutor 续接修复见 v0.8.1 发布说明；Lab 三色批注验证见 v0.8.0 发布说明；既有安装与功能验证见 v0.6.0 发布说明、题库整理验收 和 实验室验收。安装脚本与确定性保存、续接、路由均有行为测试；浏览器检查单列。Windows、其它 Agent 的真实卡片／浏览器与物理触控未实测。Node 仅用于开发验证，安装和离线阅读不需要它。
- 新增统一论文写作与批改方法，普通改稿、Lab 评阅和题库模拟范文共用。
- 先检查逐项扣题、技术机制、业务流程及本人行动，再检查结构和语言；反馈引用原文并给出可直接采用的修改。
- 统一真实经历与应试模拟口径，模拟技术与效果按可行性及自洽性评阅，避免入口冲突和正文中的反复免责声明。
- 补充十段式、两段摘要格式、全部要求回应与三个实践论点的组织方法；题面和可靠评分依据优先。
- 匿名功能命名、教材术语、时间规模、指标比较条件纳入一致性核对。
- 修复可选 Harness 将论文改稿误判为单题的问题；已安装该模块的工作区需同时更新 Hook 脚本。
- 作答交接先发正文与真实 127 链接；用户索要 URL 时直接重发入口。
- 服务默认请求浏览器打开页面，提供
--no-open供内建浏览器使用。 - 新增有时限的交卷监听，依据冻结答卷接续评阅；默认不弹状态卡，超时不算提交。
- 服务失效、用户中断与无等待工具时明确续接方式，不承诺未建立的后台阅卷。
- “按照真题评分标准”触发按原卷计分；案例按作答内容与核实题号自动确定有效选答。
- 多答题取题号较小者计入，超出题目单列批改及得分，不进入总分、合格判定或主要失分统计。
- 少答仍保留75分分母；未答的非计分候选题不算遗漏。
- 旧场次可补记正式规则重评，保留原始题包与答卷，后续评阅沿用更正口径。
- 完整参考答案只来自冻结评分表，评阅文件不能另写或覆盖。
- 答案来源与采分点来源一致，
correct直接摘自同版完整答案，案例和论文共用校验。 - 出报告前逐题记录实际一致性核对；漏点、冲突和来源分叉会被拦截，争议保留待核验。
- 更正通过评分表版本修订完成，保留原始提交、旧评分表和历史报告。
- tutor 讲解后同轮完成真实卡片调用，适配不同客户端的工具与消息记录方式。
- 区分漏卡与缺正文：已发卡片不重发，空正文只提示核对，不按固定字数强制续写。
- 换题时保留逐题进度，按实际未完成步骤提醒；不混用答复和归档授权。
- 修复“只看解析”门控答复后的重复催卡，保留文字模式、目录选择、批量授权和其它 Skill 路由。
- 案例与论文的原答卷支持绿色得分、黄色表述风险、红色明确错误的精确词句批注，保留 Markdown 格式和可展开的原始文本。
- 右侧反馈使用相同高亮，点击定位到左侧原文；支持重复词句、中文与 Unicode 偏移，代码和公式保留原有呈现。
- 新增 evidence.focus 与不扣分的 warnings，更新阅卷 SOP 和证据校验；批注不改变冻结答卷和原评分规则。
- README 将 Lab 提到首屏，加入已获授权的真实案例答卷截图和自编论文演示。
- 年度案例与论文按原卷选答和75分总分准备，选题随答卷冻结，报告显示单科参考及格判定与主要失分位置。
- 作答区上方复述当前小问，论文分别填写摘要、正文，并按原卷论述要求逐点评阅。
- 原作答下方新增完整参考答案；来源仅有建议时由 Skill 补成应试答案，论文提供完整参考范文并注明来源与模拟设定。
- 修复论文刷新后的论题定位及未落盘图稿备份恢复，保留现有正文撤销、保存和归档流程。
- 修复作答期间“恢复浏览器未保存稿”随输入和自动保存反复出现、消失的问题；恢复候选在打开页面时读取，恢复后提示收起。
- 作答区右侧新增常驻“撤销”，按当前小问保留最近 20 次正文编辑，中文输入合成阶段合并为一次编辑。
- 更新随包前端构建产物；已保存草稿继续保留。刷新后从新的编辑开始记录撤销历史。
- 浏览器实测覆盖单步撤销、20 步上限、小问隔离、暂停恢复以及撤销后保存和刷新。
- 新增第八个 Skill
soft-exam-bank-ingest：在内建浏览器登录“软考〇人”，按小节或题号整理案例题与论文题，保存原图、合并小问、补充 tutor 解析与完整模拟范文。 - 保存与续接使用版本化台账，保护人工备注；普通网站材料以
web-bank接入实验室，真题身份检查保持严格。 - 同步八 Skill 安装校验和 Harness 路由，新增 ZCode 安装目标；首次位置引导与普通单题流程保留。
- 发布第二、第三章在线复习册，新增资产目录，将 Skill 分工、阅读入口与安装使用前移。
- 复用三张宣传图片说明使用场景；Release 和 Source code 继续排除
artifacts/。
- 新增第七个 Skill
soft-exam-lab：显式启动架构师案例题作答环境，可靠保存、绘图、提交冻结与中断续接。 - 当前 Agent 按冻结采分点严格评阅，分别提供参考估分与训练分；生成图形报告、失分对照、强化 prompt 和本地练习档案。
- 同步安装、发现元数据、Harness 路由与恢复包；普通单题和复习册继续沿用原入口。
- 新增可复制的安装后初始化 prompt，探测实际权威目录，使用相对路径或使用者填写的路径。
- Release 安装包和 Source code 压缩包排除
artifacts/；完整知识库保留在 Git 仓库与在线站点。
升级方法与验证范围见 v0.5.0 发布说明。
- 复习册 Goal 沿用任务内的协作授权，明确 tutor／Grill 通用方法、提示词和公开知识的交接范围，同范围不重复确认。
- 续接区分待授权、重复卡、未发送与已返回结果；保存真实依据，不伪造用户回答或绕过平台审批。
- 加入 Goal 授权范围模板；独立演练三个场景，并通过正常审批完成一次真实 agy 教学方法复核。
升级与验证范围见 v0.4.3 发布说明。
- 吸收 DreamLanter 的 PR #1：移除默认“我已选 C”，区分候选错因与实际证据，保留原题与练习选项映射，按需加载资料。
- 文字模式由用户明确选择后启用；同步 Harness，防止合法文字练习被重复补卡。明确只讲解时正常收尾。
- 明确批量归档授权绑定题号、目标与操作；逐题查重、保存状态并从实际未完成位置恢复，保留人工记录。
升级与验证范围见 v0.4.2 发布说明。
- 强化复习册生图流程：两轮提示词改稿、Gemini tutor 复核、生成后整图核验；35 字作为知识密度下限，公式保留符号、单位、条件和逐步演算。
- 修正协作探测：Gemini 经 Antigravity（
agy）调用；核对真实帮助、完整参数和业务状态，分别记录请求模型与返回披露。 - 核验前先读完整案例，区分局部与全局结论；优先内建浏览器检查，局部更新不重置无关作答。
- 下载包加入高级／系统架构设计师第五章完整复习册：7 节、42 个知识组、159 道自测；在线知识库继续随主分支更新。
升级方法与验证范围见 v0.4.1 发布说明。
- 新增第六个 Skill
soft-exam-review-book：教材、知识点和错题二次蒸馏为图文、速查、自测，支持按小节顺序接力与局部更新。 - 原有五个 Skill 加入首次使用引导：检查已有环境，按实际候选选择资料与归档位置，支持绝对路径和可选工具跳过。
- 公开 SMTP／POP3 样章，提供在线阅读与离线资源；README 新增协作工作室和做题对比漫画。
- 安装与升级覆盖完整复习册资源，保留已有笔记；可选 Harness 区分章节制作与当前单题，保留 v0.3.9 的卡片收尾修复。
详细变化与验证范围见 v0.4.0 发布说明。
已发布版本记录（v0.3.9 及更早）
- 修复 Antigravity 归档确认与流程收尾阶段的卡片死循环 Bug：
- 增强
harness_stop_guard.py对带(Recommended)/[推荐]标识或选项编号前缀的选项文本提取能力（解决 Antigravity 原生推荐项导致前缀匹配失败的问题）。 - 扩充终止关键词（支持
已完成、等待下一题、等待上传、全流程已归档等常见收尾状态）。 - 新增正文已宣布全流程归档完成时的防御性旁路，避免循环要求模型补发。
- 同步更新 Harness 挂起规则与单元测试套件。
- 增强
- 在 v0.3.7 的卡片自动恢复基础上，修复“下一题”“再来一题”或新截图加“我选 B”的新题边界：旧题的归档选择不再使新题漏卡被放行。
- 保留问号续接与故障排查边界，新增三种连续做题输入的回归覆盖；17 项 Harness 测试通过。
- 新增 PostInvocation 卡片检查，模型回复结束后立即要求补发缺失卡片；Stop 复用同一检查，避免只依赖最终停止事件。
- 修复真实 Antigravity 消息包装、问号续接和无固定标题的 Grill 反馈导致上下文丢失；依据真实卡片返回确定下一张卡是否待发。
- 读取完整的最近事件，避免大段文件读取结果截断当前题上下文；已有真实调用、等待作答、明确结束或归档授权不重复发卡。
- 连续两次补发失败时明确报告未完成，不静默跳过或误归档。新增不包含题目内容的 Hook 执行记录，以追查实际运行情况。
- 重放真实会话中的两次漏卡及正常收尾，并增加对应回归测试；仍需在目标客户端验证真实卡片显示。
- 修正 Grill 提前达到掌握证据时只输出总结、不弹归档确认卡：Stop Hook 在确认的单题流程中补发归档卡，并避免用户已明确结束或已作出归档选择时重复发卡。
- 当前题一经明确判定为软考，后续 G1/G2 等不带五段式或
### Grill标题的反馈仍保持 Harness 激活；PreInvocation 提醒明确包含提前收尾的归档步骤。 - 用实际 Antigravity 会话的收尾片段重放，并新增回归测试。
- 修正 Grill 轮次后 Harness 上下文丢失：当前题已由模型明确判为软考时，后续 Grill 回复继续保持提醒与工具守卫生效。
- Stop Hook 识别 Grill 收尾正文里的伪
ask_question调用且没有真实工具事件的情况，请求 Agent 继续补发原生归档确认卡。 - 用真实会话片段重放确认此前返回
allow、修复后返回continue；增加 Grill 收尾回归测试。
- 修正“题图＋为我讲一下这道题”的首轮 Harness 漏激活：模型本轮已明确判定为软考题并完成讲解时，Stop Hook 会拦截只有调用文字、没有真实卡片的裸退。
- 激活依据限定在当前用户消息之后的讲题回复，避免旧题回复影响下一项普通任务。
- 用实际 Antigravity 会话片段复现并验证修复；增加对应回归测试。
- 调整单题运行时指引：正文只放讲解或上一题反馈，下一张卡的题干、选项与参数交给原生工具调用，减少重复与原始调用文本混入正文。
- 按真实工具事件判断卡片状态：卡片已显示时等待点选，不因正文混入调用文字而重发。
- 精简容易被照搬的调用示例，并更新可选 Harness 的瞬时提醒和排查说明。
- 修正三个 Antigravity Hook 命令的相对路径：运行目录已是
.agents/，无需再写.agents/scripts/...。 - 修正安装测试的路径基准，确保发布包中的 Hook 命令能从
.agents/找到脚本。 - 已安装 v0.3.1 Harness 的工作区需用
--force更新同名 Hook；无需为此重新安装知识资料。
- 修正可选 Antigravity Harness 的 Hook 命令路径和 Python 启动器选择，避免安装后脚本无法运行。
- 收紧 Harness 的软考单题激活条件，避免历史对话中的泛化词触发工具白名单与强制续写。
- 允许在
ask_question未暴露时明确报告能力缺口；补充对伪工具调用文本的排查说明。 - 增加相关安装和守卫测试。真实 Antigravity 卡片 UI 仍需在目标客户端验收。
- 新增可选 Antigravity 超长上下文 Harness：PreInvocation 续接提醒、PreToolUse 白名单和 fullyIdle Stop 拦截协同工作。
- Harness 只对已确认的软考单题流程生效；图片附件和泛化讲题用语不再单独触发。
- 增加独立安装器，可合并三个命名 Hook 并保留工作区其它 Hook；同名 Harness 升级需要显式 --force。
- 新增 Harness 安装行为测试和包结构校验。真实 Antigravity UI 回归仍需在目标客户端完成。
- 从单题 Skill 扩展为五个 Skill 的完整 toolkit。
- 加入两级脱敏知识资料、真题转录、空白错题本、计划及项目底稿。
- 修正中级资料路径，补齐高级目录和专项参考，统一 Skill 依赖。
- 增加多平台初始化、只升级 Skill 的选项和保留个人资料的行为测试。
- 修正可定位的资料链接，标记缺失内容；补齐来源、升级和排查说明。
- 前置讲解、卡片、Grill、归档与中断续接契约。
- 依据实际工具能力交互，沿用同题已有工具结果与归档授权。
- 增加运行时参考和人工验收步骤。
- 首次发布独立
soft-exam-question-tutor，提供单题讲解和确认后归档。
感谢软考达人等公开学习资源。第三方出处以具体条目标记为准；本项目与这些资源相互独立。