dsh-mastery-loop 0.0.0-stage → 0.2.0

package/CHANGELOG.md

@@ -0,0 +1,49 @@
+# Changelog
+
+## 0.2.0
+
+**架构重写（不兼容）** —— 库的布局、文件格式、脚本边界全变了。已有的库要重新对齐一次。
+
+**修复（自 0.1.0 起就坏的 bug）**：`mastery-loop-setup` 的 frontmatter 是**非法 YAML** —— `description` 写成裸标量，里面含 `mastery-loop: explore` 的「冒号 + 空格」。DSH 加载器对非法 frontmatter 的处理是**把整个 skill 丢弃**，所以 **`/mastery-loop-setup` 从 0.1.0 起就从未出现过**（模型侧、用户侧都没有），不是开关问题。已改成 `>-` 折行块标量（文字未改）。
+
+**布局**：工作区根下两个并列文件夹 —— `kb/`（内容区，给人看）+ `sys/`（机器区，给脚本读）。
+
+- `kb/knowledge/` 知识点 · `kb/MOC/` 聚合产物（镜像分类层级）
+- `sys/config.json` · `sys/graph.json` · `sys/ledger.jsonl` · `sys/errors.jsonl` · `sys/error-taxonomy.json` · `sys/paper-format.json` · `sys/state.jsonl`
+- `sys/changes.jsonl` 只在「没有 git 且用户不装 git」时启用
+
+**知识点契约**
+
+- `归属` = **来源文件**（多值、必填）；**删 `课程:` / `主题:` / `难度:`** —— 课程与讲次改为**从 `归属` 解析**
+- 正文固定六节，**删 `## 平行关联`**；`## 后置知识` 由图反算、不手写
+- 链接一律**带路径、相对工作区根、带后缀、带别名**
+
+**分类与范围**：分类是**全库级定义**（层数不固定、每层一条解析规则、类值经用户确认后写进 config）；**范围 = 分类里的一个或多个类值**。
+
+**关系图**：`sys/graph.json`（`用途` / `规则` / `coverage` / `edges`）；边带 **≤30 字**理由；**后置由图反算**；**六项校验**（双向自洽 / 无自链 / 无悬空 / 同段无重复 / 前后置互斥 / 前置两两不可比）。
+
+**聚合与两区**：`kb/MOC/` 的**机器区**由 `aggregate.mjs` 从「`归属` + 图」生成并覆盖；**手写区**（主线、脉络、考点提示）脚本**永不碰**。
+
+**脚本边界**：脚本只做重复性、机械性、不需要变通的事（校验 / 渲染 / 聚合 / 哈希跳过 / 账本运算 / 批量写回）；判断前置、写理由、出题、批改、**错误原因逐字去重**留给 agent。
+
+**git 不硬依赖**：有 git 就用它承担历史（**不自动 commit、绝不 push**）；没有且用户不装 → 回退 `sys/changes.jsonl`。
+
+**其它**：删掉 `index.md`（索引 = 聚合结果的层级视图）；Miyo 仍为**可选**、发布版不依赖。
+
+## 0.1.0
+
+首个版本。
+
+**两个 skill**：
+
+- **`mastery-loop`** —— 复习闭环。模型可自动调用，也可手动 `/mastery-loop`。
+- **`mastery-loop-setup`** —— 一次性初始化。**纯手动**（`disable-model-invocation`），只响应 `/mastery-loop-setup`。
+
+**内容**：
+
+- 出题 → 批改 → 再出题，直到逐点达标（`总共出过 ≥ 5` 且 `熟练程度 ≥ 目标正确率`）
+- **每题必须写思维链**；批改**先判思维链、再判答案**；**蒙对不算对**
+- 错误原因**逐字复用**、按知识点分组、追加日期 → 可统计
+- 错误原因写法**借用 ASD-STE100 原则**（≤20 词、一句一个偏移、动词开头）
+- 初始化生成 **6 个根目录文件**，并可用 `scripts/validate.mjs` **机械校验**
+- 不做间隔重复排程（SM-2 那套）—— 那该由日历与考试表决定

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Noct2vis
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,3 +1,82 @@
-# Temporary Holding Version
+# mastery-loop
 
-This version is a temporary placeholder for this package. An operational version to replace this has been submitted for review and is awaiting a staged release.
+**A general exam-revision loop for DeepSeek Harness.** It reads your course materials and your notes vault, then drills you — question, grade, question again — until **every knowledge point** reaches your target accuracy, and finally hands you a pre-exam list.
+
+Two things make it different from a quiz bot:
+
+- **Every question requires you to write your reasoning, not just your answer.** Grading checks the reasoning first, then the answer. **A lucky guess does not count as correct.**
+- **Wrong-answer reasons are stored verbatim and reused.** So a mistake you make three times is counted three times, instead of splitting into three near-synonyms and vanishing from the statistics.
+
+通用应试复习闭环：读你的课程材料与笔记库 → 出题 → 批改 → 再出题，直到每个知识点的熟练度都达到目标正确率，最后产出考前 list。**每道题都要求你写出思维链**，批改先判思维链再判答案，**蒙对不算对**。
+
+---
+
+## 安装
+
+```bash
+dsh plugin --profile web add dsh-mastery-loop
+```
+
+## 用法：两步
+
+### 1 · 先初始化（只跑一次）
+
+```
+/mastery-loop-setup
+```
+
+它会探测你的课程材料与笔记库，问清路径 / 素材 / 语言 / 融合方式 / 卷子格式，然后在你**知识库根目录**生成 6 个文件并校验：
+
+| 文件 | 作用 |
+| --- | --- |
+| `ledger.md` | 复习账本（进度 + 已初始化的凭据） |
+| `index.md` | 主题 → 知识点的反向索引 |
+| `errors.md` | 错误原因表 |
+| `paper-format.md` | 每个课程的每个考试的卷子格式 |
+| `error-taxonomy.md` | 失分原因分类（**初始为空**，等归纳） |
+| `config.md` | 路径 / 每门课的素材选择 / 语言标准 |
+
+> 初始化**有意做成独立的 skill**：它要问六组问题，跟日常复习是两件事。分开之后 `mastery-loop` 本身短得多。
+
+### 2 · 之后正常复习
+
+```
+/mastery-loop
+```
+
+或者直接用自然语言说「我想开始复习了」—— 这个 skill **模型可以自动调用**。
+
+## 复习循环长什么样
+
+```
+读状态 → 与用户逐步确认（范围 / 目标正确率 / 是否混合考）
+   → 复习清单
+   → 出题（每题后面挂「答案：」「思维链：」两行）
+   → 批改（先判思维链 → 再判答案 → 错了才提炼错误原因）
+   → 写回账本与错误原因表
+   → 达标？→ 问是否继续
+   → 考前 list（从第一轮就开始攒，不是最后生成）
+```
+
+**达标是逐点判断的**：一个知识点要「**总共出过 ≥ 5** 且 **熟练程度 ≥ 目标正确率**」。不到 5 次标「样本不足」，继续出题。
+
+## 错误原因为什么写成英文
+
+`errors.md` 里的错误原因**默认用英文** —— 因为要套 **ASD-STE100（简化技术英语）** 的写法：一句一个偏移、不超过 20 词、动词开头、不写题号和数字。
+
+这样做的目的是**可统计**：同名错误必须逐字一致，才能数出「我在这一点上错了几次」。
+
+> ⚠️ 口径说明：本 skill **借用 ASD-STE100 的原则**，**不声称符合** ASD-STE100 —— 官方明说它不适用于一般写作。
+> 另外，「同一表述必须逐字复用」是本 skill 的**跨文档外推**（STE 只要求「一篇文档内一致」）。**这个外推的责任在本 skill，不在 ASD。**
+
+## 一次只复习一门课吗
+
+**建议**。但范围由你定 —— 跨多门时 skill 会问你是否要**跨课程混合出题**（**默认不混合**）。
+
+## 语言
+
+**按产物类别分别定**（知识点笔记 / 出的题 / 批改解析 / 记录性文件 / 产出 / 机制层），在初始化时问你。想要中英双语对照、法文、或纯中文都行 —— 除了 `errors.md` 的错误原因默认英文（要套 STE）。
+
+## License
+
+MIT

package/cordis.patch.yml

@@ -0,0 +1,10 @@
+# Opt-in mastery-loop filesystem Skill provider for DeepSeek Harness.
+# Resolves the packaged Skill root from the installed npm identity anchored at
+# the DSH profile (Loader baseUrl), never as a path concatenated onto baseUrl.
+- insert:
+    - id: mastery-loop-skill-filesystem
+      name: '@deepseek-ai/dsh-skill-filesystem'
+      config:
+        providerName: mastery-loop
+        includeDefaultRoots: false
+        bundledSkillDir: !!js process.getBuiltinModule('node:path').join(process.getBuiltinModule('node:path').dirname(process.getBuiltinModule('node:module').createRequire(baseUrl).resolve('dsh-mastery-loop/package.json')), 'skills')

package/lib/index.js

@@ -0,0 +1,9 @@
+// dsh-mastery-loop carries no runtime code of its own.
+//
+// The bundle works entirely through cordis.patch.yml, which inserts the
+// official `@deepseek-ai/dsh-skill-filesystem` provider and points
+// `bundledSkillDir` at this package's `skills/` directory. Keeping the skill
+// content declarative is deliberate: there is no provider to maintain, no
+// discovery logic to get wrong, and nothing to break when DSH changes.
+
+export {};

package/package.json

@@ -1,6 +1,49 @@
 {
   "name": "dsh-mastery-loop",
-  "version": "0.0.0-stage",
-  "stub": true,
-  "description": "Temporary package placeholder for staged publishing"
-}
+  "version": "0.2.0",
+  "description": "Opt-in DeepSeek Harness skill bundle: mastery-loop — an exam-revision loop that drills until every knowledge point reaches your target accuracy. / 通用应试复习闭环。",
+  "license": "MIT",
+  "type": "module",
+  "main": "./lib/index.js",
+  "exports": {
+    ".": "./lib/index.js",
+    "./package.json": "./package.json"
+  },
+  "files": [
+    "lib",
+    "cordis.patch.yml",
+    "skills",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "keywords": [
+    "dsh-plugin",
+    "deepseek-harness",
+    "agent-skill",
+    "study",
+    "revision",
+    "exam",
+    "mastery"
+  ],
+  "engines": {
+    "node": "^22.19.0 || >=24.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/Noct2vis/dsh-mastery-loop.git"
+  },
+  "homepage": "https://github.com/Noct2vis/dsh-mastery-loop#readme",
+  "bugs": "https://github.com/Noct2vis/dsh-mastery-loop/issues",
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    }
+  },
+  "scripts": {
+    "sync": "node scripts/sync-dev.mjs"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}

package/skills/mastery-loop/SKILL.md

@@ -0,0 +1,201 @@
+---
+name: mastery-loop
+description: >-
+  通用应试复习闭环 / A general exam-revision loop：读你的课程材料与笔记库 → 出题 → 批改 → 再出题，直到每个知识点的熟练度都达到目标正确率，最后产出考前 list。
+  每道题都要求你写出思维链，批改先判思维链再判答案，蒙对不算对。错误原因逐字复用、可统计。
+  Use when the user wants to start revising or review for a course ("我想开始复习", "复习某门课", "考前突击", "start revising", "review for my exam"), or mentions review progress, mistakes, weak spots, mastery, or knowledge points.
+---
+
+# mastery-loop —— 复习闭环
+
+出题 → 批改 → 再出题，直到**每个知识点的熟练度都达到目标正确率**，最后收成**考前 list**。
+
+---
+
+## 0 · 四条硬规矩
+
+1. **不主动扫库。** 初始化之后只在三种情况下才动知识库：① 读到**不符合要求**的文件 → 处理那**一个**；② 出现**新文件** → 处理；③ **用户主动调用** → 才做。
+2. **笔记的定义部分默认不动。** 平时只写 `sys/`（*机器区：账本 / 错误原因 / 关系图 / 状态*）与 `kb/MOC/` 的**机器区**。
+   **没有新增或修订知识点时不碰；当知识库的架构本身要改（如关系图重建）时，改写是正当的。**
+3. **不声称符合 ASD-STE100。** 错误原因**尽可能按 STE 的规则写**，这是借用它的原则，不是合规声明。
+4. **脚本只做机械重复的事。** 校验、渲染、聚合、哈希比对、账本运算交给 `scripts/`（Node，零依赖，`node xxx.mjs`）；**判断谁是谁的前置、写理由、出题、批改、错误原因逐字去重**留给自己。**不自动 `commit`、绝不 `push`。**
+
+---
+
+## 1 · 入口
+
+### 1.1 先确认初始化过
+
+读 `sys/config.json` → 找**工作区根** → 读 `sys/ledger.jsonl`。
+
+- **`sys/ledger.jsonl` 不存在** → **停下来**，告诉用户：
+
+  > 这个知识库还没初始化过。先跑一次 `/mastery-loop-setup`，它会把 `kb/` 与 `sys/` 建好，之后我再开工。
+
+  **不要自己进初始化流程** —— 那件事归 `mastery-loop-setup`。
+
+- 初始化过 → 继续。
+
+### 1.2 读状态
+
+顺序固定：
+
+```
+sys/config.json（路径 + 分类 + 语言标准）
+   → sys/ledger.jsonl（进度）
+   → sys/paper-format.json（本次考试的格式）
+```
+
+然后**把读到的状态摆出来**：
+
+- **一段话**：「你上次复习到 X，本次范围内 Y 个知识点，已达标 Z 个。」
+- **一张小表**：本次范围的知识点按熟练度排序，标出「样本不足」和 `NULL` 的。
+
+### 1.3 与用户确认 —— **用提问窗口，逐步问**
+
+⚠️ **不许把问题堆成一条消息。** 拉起**交互式提问窗口**，**一次一问**：
+
+1. **状态确认** ——「我查到你复习到这一步，对吗？」
+2. **本次范围** ——（建议一次一门课，但**范围由用户定**）
+3. **本次目标正确率** ——（推荐 90%）
+4. **是否跨课程混合考** —— **仅当范围跨多门时**才问（**默认不混合**）
+
+---
+
+## 2 · 环境勘察
+
+**顺序：问 → 读 → 确认匹配度。**
+
+1. **问**：这次要读什么 / 你手上有哪些。**先问，不扫盘猜。**
+2. **读**：按用户指的去读，**不预设文件类型**（别写死 `.pdf`）。
+3. **确认匹配度**：把结论摆出来，逐条说清 —— 哪些**匹配**、为什么；哪些**不匹配**、为什么；还**缺**什么、**去哪找**。
+   - **要写出具体后果**（「判分会偏松」，不是「缺少答案」）；**不必把文件列全**；判定标准只有一条：**两个类别都有着落**。
+   - 问一句：**「有没有你不想让我读的？」**
+4. **缺默认成员时**问用户是否用类里别的成员顶（**换成员必须问**）。**某一类整类为空**才是真缺必需项。
+
+> 每门课的**第一讲**（`W1L1 Introduction to the Unit` / `Unit organisation` 这类）通常就是**考试边界的来源** —— 哪些考、哪些不考。
+
+---
+
+## 3 · 复习循环
+
+### 3.1 先给复习清单
+
+按 `sys/ledger.jsonl` 排：**熟练度低的在前**，`NULL`（没学过）和「样本不足」标出来。
+
+### 3.2 出题
+
+**卷子参数从 `sys/paper-format.json` 查**对应考试的那一条 —— **不要从往年卷现抄**。
+查不到 → 用**默认出卷法：判断题 + 每题说明理由**。
+
+配比（按本次范围的题池算，不按课程切分）：
+
+| 占比 | 打什么 |
+| --- | --- |
+| 60% | 熟练度最低的点 |
+| 30% | `是否学习过 = 否` 的点 |
+| 10% | `最后复习日期` 最久远的点（防遗忘） |
+
+卷子模板 → [exam-templates.md](exam-templates.md#试卷模板)。
+
+### 3.3 每题后面必须挂两行
+
+**不分题型，思维链是必写的。** 每道题后面就是这两行，别的都不要：
+
+```
+答案：
+思维链：
+```
+
+- **选题也要写** —— 有足够的推导过程即可，**不强制把所有选项都写出来**。
+- 用户不写思维链 → 那一题**无法判定**，记「**未判**」、**不入账本**，并**提示他补写**。
+
+### 3.4 批改 —— 顺序不能反
+
+```
+① 先确认思维链的逻辑对不对
+② 再确认答案对不对
+③ 只要错的个数 ≥ 1  →  才去提炼并规范化错误原因
+```
+
+- **做对 = 思维链对 且 答案对。** 任一不对 = 错 —— **蒙对不算对**。
+- 两样都错 = **错 2 个** → 很可能要提炼出**两条**错误原因（复合错误要拆）。
+- 两个都对 → 不走第 ③ 步。
+
+**批改产出三块**：
+
+1. **评分表** —— 逐题「你的判断 vs 正确答案」+ 得分 + 失分点 + 总分与正确率
+2. **详细解析** —— 引用材料原文逻辑；计算题给完整中间步骤
+3. **薄弱点定位** —— 说清**为什么错**（从思维链里看），别笼统说「理解不到位」
+
+判分口径 → [exam-templates.md](exam-templates.md#判分口径)。
+
+### 3.5 提炼错误原因（只在错 ≥1 时）
+
+写法**按 ASD-STE100 的规则**（**英文**）：
+
+- 句式优先 **`把 A 当成 B`**（概念混淆类，**必须写出 A 和 B**）；其余用 **`<动作> + <对象>`**
+- **一句只写一个偏移** —— 出现 `and / but / because / so / then` 就是两个命题，拆开
+- **≤20 词**；**名词短语 ≤3 词**
+- **不写**题号、数字、时间词、第一人称、情绪词
+- **动词开头**且**必须带对象**（禁 `wrong`、`didn't know`）
+- **指代不悬空**
+
+然后**去 `sys/errors.jsonl` 里查**：
+
+1. **在该知识点分组内全量检索**
+2. 有**逐字一样**的 → **只追加日期**，**绝不重新措辞**
+3. 没有 → 新增一条
+
+### 3.6 写回（顺序写死，不许反向；契约正文 → [templates.md](templates.md)）
+
+- **关系图** —— 本次**若新增或修订了知识点**：先改 `sys/graph.json`（逻辑定前置 → 写边与 ≤30 字理由），再由 `graph.mjs` 算后置并渲染 `## 前置知识` / `## 后置知识`，最后跑六项校验。**没动知识点就跳过这一步。**
+- **账本** —— 你只输出字段（做对 / 总共出过 / 熟练程度 / 最后复习日期 / 是否学习过），由 `ledger.mjs` 写进 `sys/ledger.jsonl`。（`做对` 只在**思维链对且答案对**时 +1。）
+- **错误原因** —— 逐字去重由**你**做（脚本会把「把 A1 和 B 弄混」和「把 A2 和 B 弄混」误判成重复），写完让脚本写进 `sys/errors.jsonl`。
+- **`kb/MOC/` 的机器区** —— 跑 `aggregate.mjs` 从「`归属` + 图」聚合；**手写区一个字不动**。
+
+### 3.7 达标与继续
+
+**达标是逐点判断的**（不是单轮卷面分）：
+
+```
+一个知识点达标  ⇔  总共出过 ≥ 5  且  熟练程度 ≥ 本次目标正确率
+```
+
+`总共出过 < 5` → 标「**样本不足**」：继续出题，**不算达标、也不算失败**。
+
+- 本次范围内**所有**知识点都达标 → **用提问窗口问**用户是否继续
+- 继续 → 回到 3.2
+- 不继续 → 进第 4 节
+
+### 3.8 考前 list 是**攒出来的**，不是最后生成的
+
+**从第一轮批改就开始攒。** 每轮出错，就把该点的 `规则 / ⚠️ 常见错误 / 🔑 锚` 三行补进去 —— 出错的那一刻正是信息最鲜活的时候。到复习结束时，它**已经**是成品。
+
+模板 → [exam-templates.md](exam-templates.md#考前-list)。
+
+---
+
+## 4 · 产出：考前 list
+
+**独立成文**（一篇 Markdown 笔记，放在 `kb/` 下）。**只收出过错的点**，按知识点一条，三行结构：
+
+```
+### <知识点>
+> **规则**：<正确说法>
+> ⚠️ **常见错误**：<我实际犯的错>
+> 🔑 **锚**：<一句话记忆钩子 / 反例>
+```
+
+末尾附「**考前 15 分钟速查**」：最致命的 N 条，一行一条。
+
+---
+
+## 固定参考
+
+[templates.md](templates.md) —— 试卷模板、判分口径、考前 list 模板。**按需查，别通读。**
+
+## 版本与口径
+
+- 错误原因的写法**借用 ASD-STE100 的原则**，**不声称符合 ASD-STE100**。
+- **「同一表述复用」是本 skill 的外推**：STE 只要求「一篇文档内一致」，这里放大成「跨全库、跨时间的去重键」—— **这个外推的责任在本 skill，不在 ASD**。

package/skills/mastery-loop/exam-templates.md

@@ -0,0 +1,102 @@
+# 出题 · 判分 · 考前 list 模板
+
+> **本文件是三个固定模板**：试卷骨架、判分口径、考前 list。契约正文（*库长什么样*）在 [templates.md](templates.md)。
+> **按需查，别通读。**
+
+---
+
+## 试卷模板
+
+> ⚠️ **参数从 `sys/paper-format.json` 查**对应考试的那一条 —— **不要从往年卷现抄**。
+> 查不到 → 用**默认出卷法：判断题 + 每题说明理由**。
+
+```markdown
+# PRACTICE EXAM PAPER — ROUND N
+
+**Based on**: <paper-format.json 里的考试名>
+**Time Allowed**: <抄自 paper-format.json>
+**Total Marks**: <抄自 paper-format.json>
+
+---
+
+## Question 1 (<marks> marks)
+
+<题干>
+
+(a) <小问> (<marks> marks)
+(b) ...
+
+答案：
+思维链：
+
+## Question 2 (<marks> marks)
+
+...
+
+答案：
+思维链：
+
+**END OF PAPER**
+```
+
+硬性要求：
+
+- **Round N** 每轮递增；**跨轮保持同一套卷子参数**，这样正确率才可比。
+- **每道题后面必须挂 `答案：` / `思维链：` 两行** —— 选择题也要。
+- 判断正误类小题，题干里就写明「**先判对错，再给理由**」。
+- 分值分配**照 `sys/paper-format.json`**，不要自己发明比例。
+- 卷尾之后**不得**出现任何答案、提示、「解析见下」的字样。
+
+---
+
+## 判分口径
+
+| 题型 | 给分 | 扣分 / 零分 |
+| --- | --- | --- |
+| 判断正误 | 分类正确 + 解释命中关键词 | 只写 T/F 没解释 → 0；解释不引材料逻辑 → 减半 |
+| 计算 | 结果正确 + 中间步骤齐全 | 结果对但无 working → 扣步骤分；结果错但步骤对 → 给步骤分 |
+| 定义 | 关键词出现 + 给出具体示例 | 只背课本句式、无示例 → 不满分 |
+| 画图 / 证明 | 图元齐全（轴标签、方向、边界）/ 每步有依据 | 图对但无标注 → 扣分 |
+
+**总分与正确率按卷面原始分算**，不折算、不向上取整。
+
+### ⚠️ 与「做对」的区别
+
+- **判分**用的是上面这张表（看答案）。
+- **账本里的「做对」是另一回事**：必须 **思维链对 且 答案对**。
+  **蒙对**在评分表里可能得分，但在账本里**不算做对** —— 而且**要提炼一条错误原因**。
+
+批改纪律：
+
+- **给分严格，只认关键词。** 别给「思路对了」这种虚分。
+- 判错要**指到用户具体的句子**（在思维链里找），不要笼统说「理解不到位」。
+- 也要指出**答得好**的部分 —— 避免用户误以为整块都薄弱。
+
+---
+
+## 考前 list
+
+**独立成文**（一篇 Markdown 笔记，放在 `kb/` 下）。**只收出过错的点**，按知识点一条。
+
+**从第一轮批改就开始攒** —— 每轮出错就把三行补进去，别等最后生成。
+
+```markdown
+# 考前 list
+
+## Section A: <分类里的类值>
+
+### <知识点>
+> **规则**：<正确说法>
+> ⚠️ **常见错误**：<我实际犯的错 —— 与 sys/errors.jsonl 里的错误原因一致>
+> 🔑 **锚**：<一句话记忆钩子 / 反例>
+
+## ⏱️ 考前 15 分钟速查
+- <最致命的 N 条，一行一条>
+```
+
+要求：
+
+- 一个知识点**只占三行**，超过说明还没提炼干净。
+- **`⚠️ 常见错误` 必须与 `sys/errors.jsonl` 里的错误原因逐字一致** —— 那是同一份事实，不要换措辞。
+- 锚点优先用**反例**或**极端情形**，不要口诀式废话。
+- 涵盖**全部轮次**，不重复同一意思的条目。