@fanchao8609/agent_brain_sync 1.7.4 → 1.7.6

package/bin/abs.js

@@ -2,7 +2,7 @@
 // bin/abs.js — abs CLI 入口。
 // abs <cmd> [args]
 // 命令: init / board / status / load / task / install / uninstall / help
-import { cmdInit, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdShow, cmdRepair, cmdWrapup, cmdTeardownCheck, cmdTodoArchive } from '../src/store.js';
+import { cmdInit, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdShow, cmdRepair, cmdWrapup, cmdRule, cmdTeardownCheck, cmdTodoArchive } from '../src/store.js';
 import { setUser, getUser, userConfigPath } from '../src/userconfig.js';
 import { runInstall, runUninstall } from '../src/install.js';
 import { readFileSync } from 'node:fs';
@@ -186,6 +186,8 @@ const usage = `abs — agent-brain-sync 记忆工具
                             归档 Done 区旧日期组 → sessions/<日期>-todo归档.md
                             (默认保留近 3 天; 任一天有未完成则整天不归档)
   abs lint                   图谱体检 (死链/孤岛/超尺寸/堆积)
+  abs rule                   列出 index.md 的 ## Rules 硬规则
+  abs rule add "一句话"      追加一条硬规则 (只放违反会丢数据/静默失效级的；展开写概念页)
   abs config [show]          查看使用者姓名 (标记作者用)
   abs config set user <名字> 设置使用者姓名 → ~/.abs/config.json
                              未设置时写操作(todo/log/note)会报错要求先设置
@@ -386,6 +388,15 @@ async function main() {
         console.log(await cmdConfig({ sub: opts._[0], value: opts._.slice(1).join(' ') }));
         break;
       }
+      case 'rule': {
+        // abs rule            列出
+        // abs rule add "..."  追加一条
+        const [sub, ...rest3] = opts._;
+        const isAdd = sub === 'add';
+        if (!isAdd && sub) throw new Error(`✗ 未知子命令 "${sub}"\n  用法: abs rule / abs rule add "一句话"`);
+        console.log(await cmdRule({ dir: opts.dir, action: isAdd ? 'add' : 'list', text: rest3.join(' ') }));
+        break;
+      }
       case 'query': {
         console.log(await cmdQuery({ dir: opts.dir, terms: opts._ }));
         break;

package/bin/mcp.js

@@ -12,7 +12,7 @@ import { readFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { findBrainRoot, absLogDir } from '../src/index.js';
-import { cmdBoard, cmdLoad, cmdStatus, cmdTask, cmdQuery, cmdLint, cmdNote, cmdWrapup } from '../src/store.js';
+import { cmdBoard, cmdLoad, cmdStatus, cmdTask, cmdQuery, cmdLint, cmdNote, cmdWrapup, cmdRule } from '../src/store.js';
 
 // ---------- 技术日志: MCP 请求跟踪（调试用, 与图谱 log.md 完全分开） ----------
 // 落 ~/.abs/log/mcp.log: 每次工具调用一行 [时间] tool cwd 参数摘要 → 耗时/结果摘要。
@@ -142,6 +142,21 @@ tool(
   }
 );
 
+tool(
+  'abs_rule',
+  '读/写 index.md 的 ## Rules 硬规则区。action=list 列出；action=add 追加一条（只放一句话 + [[链接]]，展开写概念页）。',
+  {
+    cwd: z.string().describe('项目根目录（.brain/ 所在处）'),
+    action: z.enum(['list', 'add']).optional().describe('list=列出(默认)；add=追加一条'),
+    text: z.string().optional().describe('action=add 时的一句话硬规则'),
+  },
+  async ({ cwd, action, text }) => {
+    const root = await findBrainRoot(cwd || process.cwd());
+    if (!root) return err('未找到 .brain/，先 abs init');
+    return { content: [{ type: 'text', text: await cmdRule({ dir: root, action: action || 'list', text }) }] };
+  }
+);
+
 tool(
   'abs_lint',
   '图谱体检：死链/孤岛/缺 frontmatter/超尺寸/sources 堆积/index 漏列。',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.7.4",
+  "version": "1.7.6",
   "description": "agent-brain-sync: 跨会话 AI 编码记忆 — hook 纯触发 + CLI/MCP 读写 .brain markdown 图谱, 防并发写保护。",
   "type": "module",
   "license": "MIT",

package/skill/SKILL.md

@@ -11,6 +11,36 @@ Obsidian 可直接打开的 Markdown 图谱（`.brain/`）做统一落点。
 **骨架/任务/暂存/检索/体检走 abs 工具（不手工建骨架、不手工登记任务）；深提炼（把暂存经验
 写成 concept/entity 页）必须手工——那是判断力，abs 不替你判断什么值得沉淀。**
 
+## CLI 命令速查（`abs`，完整帮助：`abs help`）
+
+```bash
+# 读
+abs load                     # 开机读状态（Roadmap + Rules + todo + 最新 log）
+abs todo                     # 看板（Done 折成计数；明细 abs todo --full）
+abs index / abs log          # 完整 index.md / log.md
+abs status                   # 当前项目 + 图谱概要
+abs query <词1> [词2 …]      # 检索 .brain/ 知识页（多词 OR）
+abs lint                     # 图谱体检（死链/孤岛/超限/堆积/Rules 超限）
+
+# 写
+abs todo add <id> --note "做什么"              # 登记任务（start 同义）
+abs todo note <id> --note "断点/进度"           # 实时落 ↳ 断点 行
+abs todo blocked <id> --note "卡点原因"         # 移入 Blocked
+abs todo done <id> [--as 落地|否决|仅方案]      # 完成（默认 落地）
+abs log "完成 X：…"                            # 记一行工作成果（无参=查看）
+abs note "经验一句话" [--tags 坑,docker]        # 经验实时暂存 → sources/
+abs rule [add "一句话"]                        # 读写 index.md 的 ## Rules 硬规则
+
+# 维护
+abs todo archive [--keep-days N] [--dry-run]   # 归档 Done 旧日期组 → sessions/
+abs init [--repair]                            # 建图谱；--repair 只补缺不覆盖
+abs config [set user <名字>]                   # 使用者姓名（写操作需先设）
+```
+
+> **agent 读写优先走 MCP**（`abs_load`/`abs_task`/`abs_note`/`abs_query`/`abs_lint`/
+> `abs_rule`）—— 常驻 ~2ms，比 bash 跑 CLI（每次起 node 进程 27ms）快一个量级。
+> CLI 留给「人手动查看」。`abs wrapup` / `abs teardown-check` 是 hook 内部命令，不需手动调。
+
 ## 触发总入口（每次命中技能，第一步先走这里）
 
 技能被触发（用户问话、开新会话、或说 `abs ...`）时，**第一步永远是下面这条链**，
@@ -57,100 +87,82 @@ Obsidian 可直接打开的 Markdown 图谱（`.brain/`）做统一落点。
 
 > 为什么：方案先过目能省掉整轮返工；登记让跨会话可续；"问开工"把决定权留在用户手里。
 > **这不是拖延** —— 总结方案本身就是工作，做完再问。
+## 图谱定位
 
-## 使用者姓名（作者标记）
-
-图谱需要知道「谁登记的」。写操作（`todo add/note/blocked/done`、`log`、`note`）会检查：
-**未设置姓名则报错并给设置命令**，不默默落盘无名条目。
-
-```bash
-abs config set user <你的名字>     # 写入 ~/.abs/config.json，一次即可
-abs config                        # 查看当前姓名
-ABS_USER=<名字> abs todo add ...   # 临时覆盖（CI/多身份），不改落盘配置
-```
+`.brain/` 放**项目根**，一个项目一份。所有命令只认**当前目录**的 `.brain/`（在项目根运行，不传路径）。
+**不向子目录归属，也不向上搜索**（上爬会命中 `~/.brain`，把无关项目静默挂错）。宁可报错也不猜。
+`abs status` 显示当前定位。
 
-设置后自动标记（**作者是人页的 wikilink，点得进去看技术栈/特点**）：
-- `todo.md`：`- [ ] TASK-ID [[fanchao]] — 说明 (认领 2026-09-12)`（作者紧跟 id，扫板先看到人）
-- `log.md`：`## [2026-09-12 13:17] [[fanchao]] dev | 完成 X`（作者前置于 kind）
-- `sources/`：frontmatter `author: fanchao`
+## `.brain/` 怎么组织（每个文件/分区做什么、怎么用）
 
-同时自动建人页 `.brain/entities/<name>.md`（含「技术栈 / 特点·工作习惯 / 名下踩过的坑」三个空槽），
-并登记进 `index.md` 的 Entities 区。**已存在则一律不动** —— 里面的内容是人工沉淀的，机器不许覆盖。
+骨架由 `abs init` 生成（`--repair` 只补缺不覆盖）。
 
-> **沉淀时顺手填人页**：经验提炼进 concepts/ 时，若观察到工程师的技术栈或判断倾向，
-> 写进 `entities/<name>.md`。这页是可积累的画像，不是一次性标签。
+### `index.md` —— 图谱入口
 
-**只读命令不检查**（`load`/`todo`/`status`/`lint`/`query`/`index`/`log` 无参）——
-hook 在会话结束时非交互调 `abs wrapup`/`abs teardown-check`，那儿拦人会卡断收尾。
-
-> `index.md` 的**经验行不加作者**：index 行是覆盖式更新的，作者会从"创建者"漂成"最后改的人"，
-> 语义不固定。要查谁写的，看该页自己的 `author`，或 `abs query` 输出（带每页 author）。
-> 历史条目**不回填**：旧行的裸 `@name` 只在原位更新时按原形态保留，不批量改写（原文/现场已不在，
-> 回填等于编造）。
-
-## 图谱定位（一个项目一个 `.brain/`，abs 自动定位不用手工指定路径）
-
-`.brain/` 放项目根，一个项目只建一份。所有 `abs` 命令（`abs load/todo/note/task/query/lint...`）
-**只认当前目录的 `.brain/`**——必须在项目根目录（即 `.brain/` 所在处）运行，
-不用传路径。
-
-**不在子目录自动归属，也不向上搜索**。原因是上爬会命中家目录 `~/.brain`
-（vault / 临时目录 / 任意路径都可能爬到），把无关项目静默挂到别人图谱上。
-宁可报错也不猜。多项目各自独立，各自 `cd` 到自己的根再跑。
+| 分区 | 放什么 | 怎么用 |
+|---|---|---|
+| `## Roadmap` | 方向：已落地 / 下一阶段候选 | **写方向不写版本号**（复述第三方状态必然漂移）。有界的，load 原样展示 |
+| `## Rules` | 本项目铁律 | 见下 |
+| `## Concepts` `## Entities` `## Sources` `## Syntheses` `## Sessions` | 各类页的清单 | 每页一行 `- [[slug]] — 一句话`（`abs note`/建归档页会自动登记），load 里折成计数 |
 
-monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs status` 显示当前定位到哪个项目。
+**`## Rules` 区**：铁律清单，`abs load` 每次都全量读（代码里明确不折它）。
+- 一句一条；有概念页就用 `[[链接]]` 指过去，**不在此展开**。
+- 只有「违反会丢数据 / 静默失效 / 白干活」级才进 —— 普通经验进 `concepts/`。
+- 读写：`abs rule` / `abs rule add "一句话"`（>120 字符被拒）；`abs lint` 超 30 条会报。
 
-## 图谱长什么样（都在 `.brain/` 下）
+### `log.md` —— 工作成果流水
 
-```
-.brain/
-├── index.md        # 总索引 + 当前路线(Roadmap)。入口。
-├── log.md          # 工作成果流水：完成 X 的一行摘要，倒序。不写工具动作。
-├── todo.md         # 动态看板：进行中/待办/阻塞/已完成。进度唯一真源。
-├── entities/       # 实体页：一个"具名事物"一页。
-├── concepts/       # 概念页：一个"可复用规律/坑"一页。
-├── sources/        # 暂存页：实时经验(abs note)落点。提炼完即归档/删。
-├── syntheses/      # 综合页：跨实体横向判断/选型/路线。
-└── sessions/       # 会话快照 + Next Session Hook。
-```
+倒序一行摘要（`abs log "完成 X：…"`）。**只记成果，不收工具动作流水**（那在 `~/.abs/log/`）。
+load 只展示最新 5 条、每条按语义边界收口。
 
-**骨架由 `abs init` 生成，不手工建。** 每个 `.brain/` 建一份，不逐子目录乱建。结构不完整时
-`abs init --repair` 只补缺、不覆盖已有文件。
+### `todo.md` —— 活看板（进度唯一真源）
 
-### 归类规则（新知识进哪类——判断力）
+| 分区 | 放什么 |
+|---|---|
+| `## Backlog` | 想做但没开工 |
+| `## Today / In Progress` | 正在做 |
+| `## Blocked` | 卡住（附原因，`abs todo blocked`） |
+| `## Done` | 已完成，**必须带结语 `【落地/否决/仅方案】` + `(完成 YYYY-MM-DD)`** |
 
-| 类别 | 放什么 | 命名 |
-|------|--------|------|
-| `entities/` | 具名的**事物**：`docker`、`auth-module` | TitleCase：`Docker.md` |
-| `concepts/` | 可复用的**规律/坑**：`docker-prisma-429` | kebab-case |
-| `sources/` | 实时经验**暂存**（`abs note` 自动落这里） | `YYYY-MM-DD-slug.md` |
-| `syntheses/` | **横向综合**：选型、架构取舍 | `synthesis-slug.md` |
+`abs todo done <id>` 会勾选并归位到 Done 的日期组顶部，断点（`↳` 行）随迁；
+Done 区由 `abs wrapup` 在会话结束时自动把「超 3 天且整天都已完成」的组迁到 `sessions/<日期>-todo归档.md`
+（任一天有未完成则整天不迁）。**什么时候动它见「进行中」一节。**
 
-判断一问：能说"它是什么"→ entities；能说"这么做就避坑"→ concepts；卡住默认 concepts。
+### `entities/` `concepts/` `sources/` `syntheses/` `sessions/`
 
-## 容量纪律（最重要的节——别什么都往里扔）
+| 目录 | 放什么 | 命名 |
+|---|---|---|
+| `entities/` | 具名的**事物**（能说"它是什么"） | `Docker.md` |
+| `concepts/` | 可复用的**规律/坑**（能说"这么做就避坑"） | `docker-prisma-429.md` |
+| `sources/` | 实时经验**暂存**（`abs note` 自动落） | `YYYY-MM-DD-slug.md` |
+| `syntheses/` | **横向**选型/架构取舍（跨多个 entity/concept 的判断） | `synthesis-slug.md` |
+| `sessions/` | 会话快照 + `## 🪝 Next Session Hook`、todo 归档页 | `log-YYYY-MM-DD.md` |
 
-图谱贵在**精**不在全。写页前过四关，不过就不写或压缩：
+归类拿不准时**默认 `concepts/`**。
 
-1. **再命中测试**：下个会话不知道这条，会不会踩同坑/重做同决定？会→存；不会→不存。
-   能从代码 grep 读出的细节一律不记。
-2. **单页硬上限**：`entities/ concepts/ syntheses/` 单页 <150 行/<5KB。超了拆或外链。
-3. **sources 是暂存不是存档**：提炼成规律后删/归档 source（同步清引用，防死链）。
-4. **写前压缩三问**：规律还是噪音？不记会怎样？能不能用一行链接已有页代替新增整页？
+### 容量纪律（写任何页之前过四关）
 
-`abs lint` 检查单页超限、sources 堆积、死链、index 漏列。
+图谱贵在**精**不在全，不过关就不写或压缩：
+1. **再命中**：下会话不知道这条会踩同坑/重做同决定？会→存，不会→不存。代码能 grep 到的一律不记。
+2. **单页上限**：`entities/concepts/syntheses` 单页 <150 行且 <8KB，超了拆或外链。
+3. **sources 是暂存**：提炼成规律后删/归档，并清掉指向它的引用（防死链）。
+4. **能不能用一行链接代替新增整页**？
 
+`abs lint` 兜底：死链/孤岛/缺 frontmatter/超限/sources 堆积/index 漏列/Rules 超限。
 ## 开场：Init Sync（开工 / 默认续 todo）
 
 图谱已存在；收到第一个核心开发指令**之前**走这条链载入上下文：
 
-1. **读状态**：`abs load`（或 MCP `abs_load`）读 index 路线 + todo 看板 + 最近 log。
+1. **读状态**：`abs load`（或 MCP `abs_load`）读 index 路线 + Rules + todo 看板 + 最近 log。
+   > **开工前先看 `## Rules`** —— 那是本项目踩过坑后定下的硬规则，每条都是曾经付过代价的。
+   > 违反的代价一般是丢数据/静默失效/白干活，而它就在 load 输出里，没有理由不看。
+   >
    > **load 输出是折叠过的，不是全量。** 两个无上限增长的区块在读取侧收口：
    > - **Done 区** → 按日期计数（曾占 load 输出 68.8%，长历史项目上单次 load 吃掉 40% 上下文）
    > - **index 页面清单** → 各分区只给页数（concept 清单占 load 输出 64%，隨图谱线性增长）
    > - 「最近动作」每条按语义边界收口到 220 字符
    >
-   > **路线（Roadmap）区原样保留** —— 那是 load 要传达的状态本身。
+   > **路线(Roadmap) 与 Rules 两区原样保留** —— 那是 load 要传达的状态本身（代码里明确不折）。
    > 要全量明细：`abs todo --full` / `abs index`，或直接读 `.brain/` 文件、
    > `.brain/sessions/<日期>-todo归档.md`。
 2. **对账滞留（强制，别跳过）**：若 `abs load` 顶部出现 `⏳ 上会话滞留`，说明上会话有任务做完/做到一半就断了。**先收尾再开工**：
@@ -158,68 +170,44 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
    - 还没做完 → `abs todo note <id> --note "接到哪/改到哪个文件"` 补断点（别空手续接）。
    滞留没清完就不算接上了状态——这是「任务做完没进 Done」的根治动作。
 3. **读命中页**：按关键词在 index 定位 → 读对应 concepts/entities 全文。
-   > ⚠️ **绝不通读 `.brain/`**。它是一个不断长大的知识图谱，当前仓库 29 页就约 11 万 token
-   > （单页最大 16KB）—— 全读会把窗口直接塞满。正确姿势：
-   > - 要状态 → `abs load`｜要主题 → `abs query <词>`（只回命中几页）
-   > - 要某页 → 只读那一页；页太长则只取相关小节
-   > - 需要汇总多页/多命令时，用 context-mode 的 `ctx_execute` 类工具在沙箱里处理后
-   >   **只打印结论**，别把原始文件内容拉进上下文。
+   > ⚠️ **绝不通读 `.brain/`**（29 页就约 11 万 token，全读塞满窗口）。
+   > 要状态→`abs load`；要主题→`abs query <词>`（只回命中几页）；要某页→只读那页。
+   > 汇总多文件时用 `ctx_execute` 类工具在沙箱里处理，**只打印结论**。
 4. **续 todo**：默认续 todo 分支 → 把顶部未完成项当当前任务开做。
-5. **登记新任务**：有明确新任务而 todo 没有 → `abs todo add <id> --note 做什么` 登记
-   再动工。不登记，会话一切断就丢。
-
-## 进行中：todo 是活看板 + 经验实时落（最重要的纪律）
+5. **登记新任务**：有明确新任务而 todo 没有 → `abs todo add <id> --note 做什么` 再动工。
 
-**todo 不是收尾仪式，是干活中随改随写的活看板。** 每个任务边界立即更新，和 git commit
-同一个反射，别等收尾。用工具（MCP `abs_task` / CLI `abs todo`）：
+## 进行中：什么时候动它（最重要的节）
 
-> **写操作优先 MCP，不要用 `bash` 跑 `abs`。** 实测：MCP 单次 ~2ms（server 常驻），
-> CLI 单次 27ms（其中 20ms 是每次起 node 进程的固定开销，读写本身仅 3ms）。
-> 一轮发多条命令时差距明显。CLI 留给「人手动查看看板」，agent 读写走 MCP。
-> 详见 [[perf-fixed-overhead]]。
+**todo 不是收尾仪式，是随改随写的活看板。** 每个任务边界立即更新，与 git commit 同反射。
 
 | 时机 | 动作 |
 |---|---|
 | 认领新任务 | `abs todo add <id> --note "做什么"` |
-| 子任务做完 | `abs todo done <id>`（自动归位 Done 对应 `### YYYY-MM-DD` 分组顶部，新完成在前；断点随迁） |
-| 碰壁/阻塞 | `abs todo blocked <id> --note "卡点原因"`（移 Blocked） |
-| 被打断/改向/干到一半停 | `abs todo note <id> --note "改到哪个文件/到哪步"`（补 ↳ 断点 行） |
-
-**Done 区会自动收口**：会话结束时 hook 调 `abs wrapup`，顺手把「超过 3 天 且 整天都已完成」
-的日期组迁到 `.brain/sessions/<日期>-todo归档.md`，并在 Done 区尾部留一行
-`### 归档` → `- [[<日期>-todo归档]] 完成任务 N 条`。
-**任一天只要还有未完成任务（`- [ ]`），整天都不归档** —— 不会把半成品扫走。
-手动跑：`abs todo archive [--keep-days N] [--dry-run]`。
-
-> `abs todo start` 与 `abs todo add` 等价（老写法仍可用）。
-> 旧版 `abs task ...` / `abs board` 已改名，会报错并提示新写法。
-> 只读命令（`todo`/`status`/`lint`/`load`/`index`）遇多余参数会报错 —— 不再静默吞掉。
-
-> **跨会话任务只用 abs todo，别用宿主原生 todo。** Cl​aude TodoWrite/Task、co​dex todo-list、
-> Op​enCode todowrite、pi `/list`/goal 各有各的原生任务——但**多是会话内临时**，不会写进
-> `.brain/todo.md`。若用原生 todo 建了跨会话任务，它就会「只在界面 0/N 里、abs 看不到」，
-> 下会话接不上、收尾没影。**分工**：跨会话/会被打断的任务 → `abs todo add`（唯一真源）；
-> 原生 todo 顶多记「本会话内不跨断点的临时拆解草稿」。
-
-**经验/坑刚冒出来就落**：`abs note "一句话经验" --tags 坑,docker`（MCP `abs_note`）——
-暂存进 sources/（幂等去重、自动进 index/log），防 context 爆/截断流失。宁少勿滥。
-
-## 每轮结束：收尾循环（Stop/告一段落后必做）
-
-**每个任务边界、每轮被 Stop/打断、告一段落时，别停半空——走收尾循环。**
-这是"开场接上状态、结束落回状态"的闭环，否则下会话接不上、经验流失。
-
-> 触发信号：Stop/会话结束 时 hook 会把「当前项目仍未完成任务 + 断点」快照进 `~/.abs/log/wrapup.log`
-> （经 `abs wrapup`，机械、幂等去重，不替你做判断）。**下会话 `abs load` 会自动把滞留顶到顶部**
-> （`⏳ 上会话滞留`），所以收尾不是靠自觉记日志，而是开场被强制接上。要不要把某个任务标 done，
-> 仍由你判断（快照只记录「哪些还开着」，不猜完成）。
+| 子任务做完 | `abs todo done <id>` |
+| 碰壁/阻塞 | `abs todo blocked <id> --note "卡点原因"` |
+| 被打断/干到一半 | `abs todo note <id> --note "改到哪个文件/到哪步"` |
+
+**经验刚冒出来就落**：`abs note "一句话经验" --tags 坑,docker` → 暂存 `sources/`（幂等去重）。宁少勿滥。
+
+> **写操作走 MCP（`abs_task`/`abs_note`），别用 bash 跑 CLI** —— MCP 常驻 ~2ms，
+> CLI 每次起 node 进程 27ms。（[[perf-fixed-overhead]]）
+>
+> **跨会话任务只用 abs todo，别用宿主原生 todo**（Cl​aude TodoWrite / co​dex todo-list /
+> Op​enCode todowrite / pi `/list`）—— 那些多是会话内临时，不写 `.brain/todo.md`，
+> 下会话接不上、收尾没影。原生 todo 顶多记“本会话不跨断点的临时拆解”。
+
+## 每轮结束：收尾循环（Stop / 告一段落后必做）
+
+**每个任务边界、被 Stop/打断、告一段落时，别停半空。** 这是“开场接上状态、结束落回状态”的闭环。
+
+> Stop 时 hook 把「未完成任务 + 断点」快照进 `~/.abs/log/wrapup.log`（`abs wrapup`，机械幂等），
+> 下会话 `abs load` 会自动把滞留顶到顶部（`⏳ 上会话滞留`）—— 所以收尾不靠自觉，是开场被强制接上。
 >
-> **主动注入（pi 已实现，别等它、也别嫌它吵）**：pi 扩展在 `agent_end` 检测「本会话真改过文件
-> （write/edit/非只读 bash）」且「`.brain/log.md` 今日无记录」时，会注入一条 `[abs 收尾提醒]` 消息
-> 逼你走本循环（每会话最多一次，已收尾/无图谱则不打扰）。**收到就照做，别复述提醒、别解释为什么在收尾**；
-> 确无可沉淀产出回一句「无可沉淀」即可。Cl​aude/Co​dex 侧靠 `Stop` 事件（见 event.sh）达成同样效果。
+> **主动注入**：pi 扩展在 `agent_end` 检测「本会话真改过文件」且「log.md 今日无记录」时注入
+> `[abs 收尾提醒]`（每会话最多一次）。**收到就照做，别复述提醒**；确无可沉淀回一句「无可沉淀」。
+> Cl​aude/Co​dex 靠 `Stop` 事件达成同样效果。
 
-收到 Stop / "结束/先这样/切别的事" / 长任务告一段落，立即执行（快、准、不啰嗦）：
+收到 Stop / "结束/先这样/切别的事" / 长任务告一段落，立即执行：
 
 1. **读 todo** → `abs load`，看 Today 还有哪些没完成。
 2. **判有没有做完没登记** → 实际完成了漏登记的 `abs todo done <id>`；做到一半补
@@ -227,7 +215,10 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
 3. **沉淀经验（该沉淀才沉淀）** → 踩了值得记的坑/有可复用技巧/跨会话判断 → `abs note`
    暂存；值得深提炼的（规律/坑/决策）按 Teardown 走完整流程。
 4. **更新 index/log/todo** → 新页同步进 index；`log.md` 倒序记一行**工作成果**摘要
-   （`abs log "完成 X：..."`，不是工具动作）；todo 对账。跑 `abs lint` 确认自洽。
+   （`abs log "完成 X：..."`，不是工具动作）；todo 对账。
+   **新规律是「违反会丢数据/静默失效/白干活」级别 → 往 index 的 `## Rules` 加一行**
+   （短句 + `[[概念页]]`，不展开）。普通经验不进 Rules —— 否则会长成第二份概念库。
+   跑 `abs lint` 确认自洽。
 
 **完成标准**：看板反映真实状态（Done 无滞留半成品）、该沉淀已落、index/log/todo 与事实一致。
 
@@ -241,53 +232,40 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
 4. **对账 todo**：滞留 Today 归位（Done 标日期 / Backlog 补断点）；遗留 bug 写 Backlog/Blocked。
 5. **综合(可选)**：推进了选型/取舍 → `syntheses/`。
 6. **收拢 sources**：提炼成规律的删 source，**同步清指向它的引用**（防死链）。
-7. **修 index + 记 log**：新页同步 index；`log.md` 倒序记一行摘要。
+7. **修 index + 记 log**：新页同步 index；**过 Rules 门槛的规律加一行到 `## Rules`**；
+   `log.md` 倒序记一行摘要。
 8. **留接力棒**：`sessions/log-YYYY-MM-DD.md`，强制写 `## 🪝 Next Session Hook`。
 
 **完成标准**：每条过了容量纪律的知识一处落点；index 与事实一致；sessions 有带 Hook 快照。
 
-## 知识页格式（concepts/entities/syntheses）
+## 知识页格式
 
-所有页统一 frontmatter：`tags / author / updated / status`。
+统一 frontmatter：`tags / author / updated / status`（`status: draft`，或 `reviewed` = 冲突已裁决）。
+`tags` 首标签 ∈ `entity|concept|source|synthesis|session-log`。`author` 与 `entities/<name>.md` 同名。
 
-```markdown
----
-tags: [concept, 领域]   # 首标签 ∈ entity|concept|source|synthesis|session-log
-author: fanchao         # 作者（abs note 自动写；手写页也须填，且与 entities/<name>.md 同名）
-updated: YYYY-MM-DD
-status: draft           # 或 reviewed（仅指知识冲突裁决结案）
----
-```
-
-作者名同时是**人页 slug**：`[[fanchao]]` → `entities/fanchao.md`（技术栈 / 特点 / 名下踩过的坑）。
-
-- **关联连接区**：每页必须有 `## 关联连接`，用 `[[页面名]]` 链相关页。严禁孤岛页。
-- **知识冲突**：与旧页矛盾不静默覆盖。加 `## 知识冲突` 两版都留、标来源时间，交人工裁决。
-- **命名即链接**：`[[Docker]]` 落 entities/Docker.md；`[[docker-prisma-429]]` 落 concepts/。别建别名层。
-
-概念页核心结构（坑）：`触发场景 / ❌表现(贴报错) / 🛠解法(根因+修复+验证命令) / 关联连接`。
+- **每页必须有 `## 关联连接`**，用 `[[页面名]]` 链相关页 —— 严禁孤岛页。
+- **命名即链接**：`[[Docker]]` → `entities/Docker.md`；`[[docker-prisma-429]]` → `concepts/`。不建别名层。
+- **知识冲突**：不静默覆盖，加 `## 知识冲突` 两版都留、标来源时间，交人工裁决。
+- 概念页骨架：`触发场景 / ❌表现(贴报错) / 🛠解法(根因+修复+验证命令) / 关联连接`。
 
 ## 维护：query / lint
 
-- **query（检索）**：`abs query <词>`（或先读 index 定位）→ 读命中页 → 答用 `[[页面名]]` 标来源。
-  **代码问题（符号在哪/谁调用）答案不在 .brain，直接读源码**；.brain 只答"踩过什么坑/上次做到哪"。
-- **lint（体检）**：`abs lint`。查死链/孤岛/缺 frontmatter/模板残留/未决冲突/超尺寸/sources 堆积/
-  index 漏列。按报告修（死链→补链；孤岛→补关联；超大→拆；sources 积压→提炼归档）。
+- `abs query <词>` 检索（多词 OR）→ 读命中页 → 答用 `[[页面名]]` 标来源。
+  **代码问题（符号在哪/谁调用）不在 .brain，直接读源码**；.brain 只答"踩过什么坑/上次做到哪"。
+- `abs lint` 体检：死链/孤岛/缺 frontmatter/模板残留/超尺寸/sources 堆积/index 漏列/Rules 超限。
 
-## 分工：hook 机械记 / 工具实时落 / skill 深提炼（装了 abs 的项目）
+## 三层分工
 
-| 层 | 干什么 | 靠什么 |
-|---|---|---|
-| **hook（机械）** | SessionStart/UserPromptSubmit/Stop/SessionEnd 自动记**技术日志**（~/.abs/log/） | 宿主 hook 配置。你不写技术日志。 |
-| **CLI/MCP（实时）** | 任务/经验**实时落盘**：`abs todo add/note/blocked/done`、`abs note` | 每个任务边界立即调；经验随时 abs note。 |
-| **skill（自觉）** | **深提炼**（sources→concepts）+ 收尾循环 + 修 index | 判断什么值得沉淀，工具不替你判断。 |
+| 层 | 干什么 |
+|---|---|
+| **hook（机械）** | 自动记技术日志到 `~/.abs/log/`，你不用管 |
+| **CLI/MCP（实时）** | 任务/经验实时落盘：`abs todo …`、`abs note` |
+| **skill（自觉）** | **深提炼**（sources→concepts）+ 收尾 + 修 index —— 工具不替你判断 |
 
-实时层解决"断了就丢"；自觉层解决"噪音污染"。分工明确：骨架/任务/暂存/检索/体检走 abs 工具
-（`abs init`/`abs_task`/`abs note`/`abs query`/`abs lint`）；**深提炼（sources→concept/entity 页）
-手工写**——那是判断力，工具不替。改完 `abs lint` 确认自洽。
+骨架/任务/暂存/检索/体检走工具；**深提炼手工写**（那是判断力）。改完跑 `abs lint`。
 
 ## 自我约束
 
-- 只读写 `.brain/` 与目标代码，不动全局配置（一次性接入安装除外）。
-- 内容基于真实发生的事实；遵守容量纪律宁缺毋滥。
-- 双链/frontmatter/index 必须自洽——图谱给下个会话读，坏链=掰断接力棒。
+- 只读写 `.brain/` 与目标代码，不动全局配置（一次性接入除外）。
+- 只写真实发生的事实；遵守容量纪律，宁缺毋滥。
+- 双链/frontmatter/index 必须自洽 —— 坏链 = 掰断接力棒。

package/src/store.js

@@ -4,7 +4,7 @@ import { promises as fs } from 'node:fs';
 import { join, resolve, dirname } from 'node:path';
 import { requireBrain, brainPath, absLogDir, BRAIN_DIR } from './index.js';
 import { requireUser, atTag, getUser } from './userconfig.js';
-import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine, archiveDoneInText, renderArchivePage, renderArchiveBody, DONE_KINDS, withDoneKind, doneKindOf, doneDateOf, collapseDone } from './todo.js';
+import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine, archiveDoneInText, renderArchivePage, renderArchiveBody, DONE_KINDS, withDoneKind, doneKindOf, doneDateOf, collapseDone, SEC, rebuildStructure } from './todo.js';
 import { editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor } from './wrapup.js';
 
@@ -108,23 +108,112 @@ function resolveProjectDir(dir) {
 }
 
 export function indexTemplate() {
-  return [
-    '# 🗂 图谱索引',
-    '',
-    '本文件唯一入口。每新建/大改一页，同步在此分类下加一行 [[页面名]] — 一句话。',
-    '',
-    '## 当前路线 (Roadmap)',
-    '## Concepts',
-    '## Entities',
-    '## Sources',
-    '## Syntheses',
-    '## Sessions',
-    '',
-  ].join('\n');
+  // 同 todoTemplate：由 rebuildStructure 生成，模板 = 重排结果，不会来回抖。
+  return rebuildStructure(
+    ['# 🗂 Graph Index', '',
+      '本文件唯一入口。每新建/大改一页，同步在此分类下加一行 [[页面名]] — 一句话。', '',
+      '## Roadmap', '## Rules', '## Concepts', '## Entities', '## Sources', '## Syntheses', '## Sessions'].join('\n'),
+    {
+      h1: '# 🗂 Graph Index',
+      order: ['## Roadmap', '## Rules', '## Concepts', '## Entities', '## Sources', '## Syntheses', '## Sessions'],
+    },
+  ).text;
 }
 
 export function logTemplate() {
-  return ['# 🗒 操作日志', '', '## [YYYY-MM-DD] ingest | 沉淀 <slug>', ''].join('\n');
+  return ['# 🗒 Activity Log', '', '## [YYYY-MM-DD] ingest | 沉淀 <slug>', ''].join('\n');
+}
+
+// ---------- 结构核对: load 每次都读 index/log/todo，顺手核形状 ----------
+/** 标准形状表（与 indexTemplate/logTemplate/todoTemplate 同源）。
+ * 标记不一致 = 直接改成标准（“能自己处理的先处理”）。
+ * 只按**整行精确匹配**改标题，绝不动正文 —— 不做模糊替换，否则正文里提到的旧名会被误改。 */
+export const BRAIN_SHAPE = {
+  'todo.md': {
+    h1: '# 📋 Todo Board',
+    order: ['## Backlog', '## Today / In Progress', '## Blocked', '## Done'],
+  },
+  'log.md': {
+    h1: '# 🗒 Activity Log',
+    order: [],   // log 无固定分区（条目行自带时间，倒序）
+  },
+  'index.md': {
+    h1: '# 🗂 Graph Index',
+    order: ['## Roadmap', '## Rules', '## Concepts', '## Entities', '## Sources', '## Syntheses', '## Sessions'],
+  },
+};
+
+/** 旧标记 → 标准标记。load 发现就改（幂等）。含 H1 与分区/分组标题的旧名。 */
+export const LEGACY_MARKS = [
+  ['# 🗂 图谱索引', '# 🗂 Graph Index'],
+  ['# 🗒 操作日志', '# 🗒 Activity Log'],
+  ['# 📋 Todo 看板', '# 📋 Todo Board'],
+  ['# 操作日志', '# 🗒 Activity Log'],
+  ['# 图谱索引', '# 🗂 Graph Index'],
+  ['# Todo 看板', '# 📋 Todo Board'],
+  ['## 当前路线 (Roadmap)', '## Roadmap'],
+  ['## Done（只留近期，旧的迁 log.md/快照）', '## Done'],
+  ['### 归档', '### Archived'],
+  ['### （未标日期）', '### Undated'],
+];
+
+/** 把不符标准的标记改成标准（按整行精确匹配，不碰正文）。
+ * log.md 特殊：它没有固定分区，只有条目行 —— 不做结构重排，只改 H1。
+ * 返回 { text, changed }；无不一致时 changed 为空。 */
+export function fixMarks(text, spec) {
+  const lines = String(text ?? '').split('\n');
+  const changed = [];
+  const h1At = lines.findIndex((l) => l.trim().startsWith('# '));
+  if (h1At !== -1 && lines[h1At].trim() !== spec.h1) {
+    const cur = lines[h1At].trim();
+    const hit = LEGACY_MARKS.find(([o]) => o === cur && o.startsWith('# '));
+    if (hit) { lines[h1At] = spec.h1; changed.push(`${cur} → ${spec.h1}`); }
+  }
+  for (let i = 0; i < lines.length; i++) {
+    if (i === h1At) continue;
+    const t = lines[i].trim();
+    const hit = LEGACY_MARKS.find(([o]) => o === t && !o.startsWith('# '));
+    if (hit) { lines[i] = hit[1]; changed.push(`${hit[0]} → ${hit[1]}`); }
+  }
+  return { text: lines.join('\n'), changed };
+}
+
+/**
+ * 核对 index/log/todo 的结构，不符就按标准重建（B 档：重排分区 + 内容按归属回填）。
+ * 它每次 load 都跑，所以改动立即生效，不必等额外命令。
+ *
+ * 边界（内容安全）：
+ *   - 只动**标题行位置**与缺失分区的空位，已有内容行按原归属搬运，不改写；
+ *   - **非标准分区原样留在末尾**（人自加的区不合入，机器不猜语义）；
+ *   - log.md 不做重排（无固定分区，条目自带时间倒序）；
+ *   - 锁内重算 + “改了才写盘”，幂等。
+ *
+ * 不抛错（load 不能因核对失败而挂）。返回 { fixed:[描述], warn:[描述] }。
+ */
+export async function checkBrainShape(root) {
+  const fixed = [];
+  const warn = [];
+  for (const [file, spec] of Object.entries(BRAIN_SHAPE)) {
+    const p = brainPath(root, file);
+    let text;
+    try { text = await fs.readFile(p, 'utf8'); } catch { continue; }
+    if (!text.trim()) continue;
+    const l1 = (text.split('\n')[0] || '').trim();
+    const knownH1 = l1 === spec.h1 || LEGACY_MARKS.some(([o]) => o === l1 && o.startsWith('# '));
+    let changed = [];
+    await editFile(p, (cur) => {
+      if (cur === null) return SKIP;
+      const r = spec.order.length
+        ? rebuildStructure(cur, { ...spec, renames: LEGACY_MARKS.filter(([o]) => o.startsWith('## ') || o.startsWith('### ')) })
+        : fixMarks(cur, spec);
+      if (!r.changed.length) return SKIP;
+      changed = r.changed;
+      return { text: r.text };
+    }).catch(() => {});
+    if (changed.length) fixed.push(`${file}: ${changed.join('; ')}`);
+    if (!knownH1) warn.push(`${file}: 标题非标准（读到 "${clip(l1, 24) || '(空)'}"）`);
+  }
+  return { fixed, warn };
 }
 
 // ---------- board: 看板 ----------
@@ -161,6 +250,9 @@ async function listBrainFiles(root) {
 // ---------- load: 开机读状态 ----------
 export async function cmdLoad({ dir }) {
   const root = await requireBrain(dir || process.cwd());
+  // 结构核对先跑：load 每回都要读这三个文件，顺手把它们形状摆正（缺分区）或提个醒（无头）。
+  // 正常时完全静默、零字节，不增加 load 体积（load 已被压缩到 ~1.8k token）。
+  const shape = await checkBrainShape(root).catch(() => ({ fixed: [], warn: [] }));
   const todo = await readTodo(root);
   const index = await readIfExists(brainPath(root, 'index.md'));
   const log = await readIfExists(brainPath(root, 'log.md'));
@@ -168,6 +260,14 @@ export async function cmdLoad({ dir }) {
   const sections = [
     `📂 abs → 项目: ${root}`,
   ];
+  if (shape.fixed.length || shape.warn.length) {
+    const rows = [
+      ...shape.fixed.map((a) => `  ✓ 已补: ${a}`),
+      ...shape.warn.map((a) => `  ⚠ ${a}`),
+    ];
+    if (shape.warn.length) rows.push('  （无头文件不自动改：结构可能整体脱轨，请手工对齐 .brain/ 模板）');
+    sections.push('--- 文件形状核对 ---', ...rows, '');
+  }
   // 未设姓名时开场就提醒 —— load 是开机第一屏，不在这里提，
   // 用户要撞到第一次写操作才知道（init/load 一路沉默）。
   if (!(await getUser())) {
@@ -178,10 +278,13 @@ export async function cmdLoad({ dir }) {
     );
   }
   sections.push(
-    '--- 当前路线 (index.md) ---',
+    // Rules 单独成段且放在最前（仅次于项目行/滞留）：它是硬规则，不是普通清单。
+    // 坑: 曾在 index 段内与页面清单平铺 —— AI 会当普通清单划过，而它每条都是付过代价的。
+    ...(rulesSection(index) ? [rulesSection(index), ''] : []),
+    '--- Roadmap (index.md) ---',
     collapseIndex(index) || '(index.md 为空)',
     '',
-    '--- Todo 看板 (todo.md) ---',
+    '--- Todo Board (todo.md) ---',
     collapseDone(todo).text || '(todo.md 为空)',
     '\n（Done 已按日期折叠计数；明细: abs todo --full）',
     '',
@@ -205,6 +308,91 @@ export async function cmdLoad({ dir }) {
   return sections.join('\n');
 }
 
+// ---------- Rules: index.md 里的硬规则区 ----------
+/** index.md 的 `## Rules` 区名与上限。 */
+export const RULES_HEADING = '## Rules';
+export const RULES_MAX = 30; // 超过就 lint 报：它属于“被读到才有价值”的区，不能无界增长
+
+/** 提取 index.md 里的 Rules 区条目（不含标题）。返回 { items:[行], body, found }。 */
+export function readRules(indexText) {
+  const lines = String(indexText || '').split('\n');
+  const i = lines.findIndex((l) => l.trim() === RULES_HEADING);
+  if (i === -1) return { items: [], body: '', found: false };
+  const rest = lines.slice(i + 1);
+  const j = rest.findIndex((l) => /^##\s/.test(l));
+  const body = rest.slice(0, j === -1 ? rest.length : j);
+  return { items: body.filter((l) => l.trim().startsWith('- ')), body: body.join('\n').trim(), found: true };
+}
+
+/** load 里 Rules 的呈现：带独立段头，条目原样（不折、不截）。无条目则不占字节。 */
+function rulesSection(indexText) {
+  const { items, body, found } = readRules(indexText);
+  if (!found || !body) return '';
+  // 有引言句（> 开头）时一并带上，它解释了这个区是干什么的。
+  const intro = body.split('\n').filter((l) => l.trim().startsWith('>')).join('\n');
+  return [
+    `--- Rules (硬规则，先读) — ${items.length} 条 ---`,
+    intro,
+    ...items,
+  ].filter((x) => x !== '').join('\n');
+}
+
+/**
+ * `abs rule` —— 读写 index.md 的 Rules 区。
+ * 无参 = 列出（只给规则，不被 load 的其它内容占上下文）。
+ * add <一句话> = 追加一条（走锁写、幂等去重）。
+ * 门槛：只该放“违反会丢数据/静默失效/白干活”级规律；长句会被拒并指向概念页。
+ */
+export async function cmdRule({ dir, action, text }) {
+  let root;
+  try { root = await requireBrain(dir || process.cwd()); } catch {
+    return '未找到 .brain/ 图谱。先在项目根运行: abs init';
+  }
+  const p = brainPath(root, 'index.md');
+  if (!action || action === 'list' || action === 'show') {
+    const { items, found } = readRules(await readFileOrNull(p));
+    if (!found) return `index.md 无 \`${RULES_HEADING}\` 区（跑 abs load 会自动补位）`;
+    if (!items.length) return `${RULES_HEADING} 区为空（add "一句话" 追加）`;
+    return [`${RULES_HEADING} — ${items.length} 条:`, ...items].join('\n');
+  }
+  if (action !== 'add') {
+    return `用法: abs rule            列出硬规则\n      abs rule add "一句话" [--note "补充"]`;
+  }
+  const clean = String(text || '').replace(/\s+/g, ' ').trim();
+  if (!clean) return '用法: abs rule add "一句话硬规则"';
+  // 门槛：一句话说完。太长说明该写概念页，Rules 只放指针。
+  if (clean.length > 120) {
+    return `✗ 太长（${clean.length} 字符 > 120）—— Rules 只放一句话摘要，展开写成概念页，\n  这里改成短句 + [[页面名]] 链接。`;
+  }
+  let added = null;
+  await editFile(p, (cur) => {
+    if (cur === null) return SKIP;
+    const lines = cur.split('\n');
+    const i = lines.findIndex((l) => l.trim() === RULES_HEADING);
+    if (i === -1) return SKIP; // 无该区不擅自建（load 会补位）
+    if (lines.some((l) => l.trim() === `- ${clean}`)) return SKIP; // 幂等：同句不重复
+    // 插在该区最后一条条目之后（保序、不搅动其它条目）
+    let at = i + 1;
+    for (let k = i + 1; k < lines.length; k++) {
+      if (/^##\s/.test(lines[k])) break;
+      if (lines[k].trim().startsWith('- ')) at = k + 1;
+    }
+    lines.splice(at, 0, `- ${clean}`);
+    added = clean;
+    return { text: lines.join('\n') };
+  });
+  if (added === null) return `• 已有同句或 index.md 无 ${RULES_HEADING} 区（跳过）`;
+  const { items } = readRules(await readFileOrNull(p));
+  const warn = items.length > RULES_MAX
+    ? `\n⚠ Rules 已 ${items.length} 条 > ${RULES_MAX}：考虑把其中几条提炼成概念页（跑 abs lint 会报）`
+    : '';
+  return `✓ 已加硬规则（共 ${items.length} 条）\n  - ${clean}${warn}`;
+}
+
+async function readFileOrNull(p) {
+  try { return await fs.readFile(p, 'utf8'); } catch { return ''; }
+}
+
 /** index.md 在 `abs load` 里的折叠形态：保留「当前路线」（那是 load 要传达的状态，
  * 且有界），把页面清单各分区折成计数。
  *
@@ -231,8 +419,10 @@ export function collapseIndex(text) {
     if (m) {
       flush();
       const name = m[1].trim();
-      if (/路线|Roadmap/i.test(name)) {
-        out.push(l);   // 「当前路线」是内容不是清单：原样保留
+      // 「Roadmap」与「Rules」都是**内容**不是清单：原样保留。
+      // Rules 区尤其不能折 —— 它的全部价值就是被读到；折成"（N 页）"等于把它静默删掉。
+      if (/路线|Roadmap|Rules?|规则/i.test(name)) {
+        out.push(l);
         mode = null;
       } else {
         mode = name;   // 页面清单分区：只计数
@@ -460,7 +650,7 @@ export async function cmdLog({ dir, title, kind = 'dev' }) {
   // 一眼先看到谁做的（与 todo 行 `ID @name — 说明` 排版对齐）。
   const line = `## [${stamp}] ${atTag(who)} ${kind} | ${clean}`;
   await editFile(p, (cur) => {
-    const text = cur ?? '# 🗒 操作日志\n';
+    const text = cur ?? '# 🗒 Activity Log\n';
     // 倒序：新行插在标题后（若已是模板占位行则替换它）
     const lines = text.split('\n');
     const headerIdx = lines.findIndex((l) => l.startsWith('#'));
@@ -541,7 +731,7 @@ async function markDone(file, id, kind = '落地') {
 export async function cmdShow({ dir, view, full }) {
   const v = String(view || '').toLowerCase();
   if (!['todo', 'index', 'log'].includes(v)) {
-    return '用法: abs <todo|index|log>  — todo=看板(原 board), index=图谱索引, log=操作流水';
+    return '用法: abs <todo|index|log>  — todo=看板(原 board), index=Graph Index, log=操作流水';
   }
   const root = await requireBrain(dir || process.cwd());
   const p = brainPath(root, `${v === 'todo' ? 'todo' : v}.md`);
@@ -765,8 +955,16 @@ export async function cmdLint({ dir }) {
   for (const pg of pages) {
     if (!pg.hasFrontmatter) issues.push(`NO-FRONTMATTER: ${pg.rel}`);
     for (const ln of pg.links) {
-      if (/slug|Name|name|Date|页面名$/.test(ln)) issues.push(`TEMPLATE-LINK: ${pg.rel} -> [[${ln}]]`);
-      if (!names.has(ln)) issues.push(`DEAD-LINK: ${pg.rel} -> [[${ln}]]`);
+      // 两类都不是真链接，只报 TEMPLATE-LINK（且不短路就会再报一次 DEAD-LINK，同一条报两遍）：
+      //   ① 模板占位: `[[页面名]]` / `[[slug]]` / `[[Name]]` —— 模板没填
+      //   ② 描述语法时引用的字面量: `[[<slug>]]` —— 尖括号不是合法 wikilink 字符，
+      //      而是任务描述在解释格式（如 “在 ### 归档 段留下 [[<slug>]] 完成任务 N 条”）。
+      // 单靠关键字（slug/name）分辨不了两者，故额外认尖括号形态。
+      if (/^<.+>$/.test(ln) || /slug|Name|name|Date|页面名$/.test(ln)) {
+        issues.push(`TEMPLATE-LINK: ${pg.rel} -> [[${ln}]]`);
+      } else if (!names.has(ln)) {
+        issues.push(`DEAD-LINK: ${pg.rel} -> [[${ln}]]`);
+      }
     }
     // ORPHAN: sources/ 暂存页与 todo 归档页豁免。前者是暂存线索（提炼成 concept 前天然孤立），
     // 后者是历史数据倾倒（已登记在 index.md，就是图谱入口，无需再制造双链）。
@@ -797,6 +995,21 @@ export async function cmdLint({ dir }) {
   const nsrc = pages.filter((p) => p.dir === 'sources').length;
   if (nsrc > 10) issues.push(`SOURCES-PILED-UP: sources/ has ${nsrc} files > 10; 提炼归档旧 source`);
 
+  // Rules 区：它的价值在“少而重”，且不被折叠（load 每次都全量读）。
+  // 无上限增长 = 把 load 又撑回去（同 Done / index 清单的膨胀根因）。
+  {
+    const idxTxt = await readFileOrNull(join(vault, 'index.md'));
+    const { items, found } = readRules(idxTxt);
+    if (found && items.length > RULES_MAX) {
+      issues.push(`RULES-PILED-UP: Rules 区 ${items.length} 条 > ${RULES_MAX}；把长条目提炼成概念页，这里只留一句 + 链接`);
+    }
+    // 该区是 load 必读的硬规则清单，条目却写得像段落 → 提醒改短句。
+    const longOnes = items.filter((l) => l.trim().length > 160);
+    if (longOnes.length) {
+      issues.push(`RULES-TOO-LONG: Rules 区 ${longOnes.length} 条超 160 字符（如 "${clip(longOnes[0].trim(), 40)}"）；展开写进概念页，这里只留短句 + [[链接]]`);
+    }
+  }
+
   // Done 区堆积：它无上限增长，且 `abs todo`/`abs load` 每次全量打印 → 越积越难用。
   // （与 hooks.log/wrapup.log 同类问题；那两处有轮转，这里靠 `abs todo archive`。）
   // 坑: 曾经写成 brainPath(vault, 'todo.md')，而 vault 已经是 .brain 目录

package/src/todo.js

@@ -45,28 +45,135 @@ export async function ensureTodo(brainRoot) {
   return p;
 }
 
+/** 分区名常量（单一真源）。改名时只改这里 —— 之前散在 20+ 处，一改就漏。
+ * 旧名（中文）留在 LEGACY_SECTION_RENAMES 作迁移用。 */
+export const SEC = {
+  backlog: 'Backlog',
+  today: 'Today / In Progress',
+  blocked: 'Blocked',
+  done: 'Done',
+  archived: 'Archived',   // Done 区内部的归档标记区（原 '### 归档'）
+  undated: 'Undated',     // Done 区内部无完成日期的尾组（原 '### （未标日期）'）
+};
+
+/** 旧名 → 新名。供 `abs init --repair` 一次性迁移（幂等）。
+ * 只改匹配整行的标题，不动正文；不做模糊替换（防误改正文里提到的旧名）。 */
+export const LEGACY_SECTION_RENAMES = [
+  // H1（文件标题）
+  ['# 🗂 图谱索引', '# 🗂 Graph Index'],
+  ['# 🗒 操作日志', '# 🗒 Activity Log'],
+  ['# 📋 Todo 看板', '# 📋 Todo Board'],
+  // ## 分区
+  ['## 当前路线 (Roadmap)', '## Roadmap'],
+  ['## Done（只留近期，旧的迁 log.md/快照）', '## Done'],
+  // ### 区内分组标题
+  ['### 归档', '### Archived'],
+  ['### （未标日期）', '### Undated'],
+];
+
+/** 把文件里的旧分区名就地改成新名（只改匹配整行的标题，不动正文）。
+ * 返回 { text, changed:[旧名→新名] }。幂等：已改过的再跑 changed 为空。 */
+export function renameLegacySections(text) {
+  const lines = String(text ?? '').split('\n');
+  const changed = [];
+  const out = lines.map((l) => {
+    const t = l.trim();
+    for (const [oldN, newN] of LEGACY_SECTION_RENAMES) {
+      if (t === oldN) { changed.push(`${oldN} → ${newN}`); return newN; }
+    }
+    return l;
+  });
+  return { text: out.join('\n'), changed };
+}
+
 export function todoTemplate() {
-  return [
-    '# 📋 Todo 看板',
-    '## Backlog',
-    '- [ ] 待办任务',
-    '## Today / In Progress',
-    '## Blocked',
-    '## Done（只留近期，旧的迁 log.md/快照）',
-    '',
-  ].join('\n');
+  // 由 rebuildStructure 生成，保证“模板”与“重排结果”逐字节一致
+  // （否则 load 会把新建的模板又重排一次 = 无意义的写盘）。
+  return rebuildStructure(
+    ['# 📋 Todo Board', '## Backlog', '- [ ] 待办任务', '## Today / In Progress', '## Blocked', '## Done'].join('\n'),
+    { h1: '# 📋 Todo Board', order: ['## Backlog', '## Today / In Progress', '## Blocked', '## Done'] },
+  ).text;
 }
 
 /** 归一化 todo.md 分区：老格式（In Progress/Todo）迁移为 B4 定稿格式（Backlog→Today / In Progress→Blocked→Done）。
  * 幂等：已是新格式则原样返回。迁移原则——老 "In Progress" 内容进 "Today / In Progress"，老 "Todo" 内容进 "Backlog"。 */
 export const TODO_SECTIONS = ['Backlog', 'Today / In Progress', 'Blocked', 'Done'];
 
+/** 结构重建（B 档）：以标准分区表为准重排整个文件。
+ *
+ * 规则（保证内容不丢、不挪错）：
+ *   1. 按 spec.order 顺序输出标准分区，每个分区下放**归属于它**的内容行；
+ *   2. 归属判定：按行所处的原分区归入对应标准分区；旧名先按 spec.renames 归一；
+ *   3. **非标准分区**（人自加的，如 `## 备忘`）→ 内容连同它自己的标题一起**原样保留在末尾**，
+ *      绝不合入已有标准分区（机器不知道它的语义，猜错就是挪错内容）；
+ *   4. 自由正文（不属于任何分区的行，如 H1 后的说明句）保留在 H1 之后；
+ *   5. 幂等：已是标准结构 → 输出逐字节相同。
+ *
+ * 返回 { text, changed }；changed 为空的描述列表（空=无需改盘）。 */
+export function rebuildStructure(text, spec) {
+  const s = String(text ?? '');
+  const lines = s.split('\n');
+  const h1At = lines.findIndex((l) => l.trim().startsWith('# '));
+  const bodyStart = h1At === -1 ? 0 : h1At + 1;
+  const bucket = new Map();   // 标准分区名 -> 内容行
+  const extras = [];          // [{ title, lines }] 非标准分区，原样保留到末尾
+  const preamble = [];        // H1 与第一个 ## 之间的自由正文
+  let curStd = null;          // 当前在的标准分区名（null = 前言）
+  let curExtra = null;        // 当前在的额外分区对象
+  for (let i = bodyStart; i < lines.length; i++) {
+    const l = lines[i];
+    if (/^#{2,3}\s/.test(l)) {
+      const t = l.trim();
+      const renamed = (spec.renames?.find(([o]) => o === t) || [, t])[1];
+      if (spec.order.includes(renamed)) {
+        curStd = renamed;
+        curExtra = null;
+        if (!bucket.has(curStd)) bucket.set(curStd, []);
+      } else {
+        curExtra = { title: renamed, lines: [] };
+        extras.push(curExtra);
+        curStd = null;
+      }
+      continue;
+    }
+    if (curExtra) curExtra.lines.push(l);
+    else if (curStd) bucket.get(curStd).push(l);
+    else preamble.push(l);
+  }
+  const out = [spec.h1];
+  const pre = trimBlank(preamble);
+  if (pre.length) out.push('', ...pre);
+  // 空分区之间不插空行（否则每次首跑都会“把空行加进去”而写盘一次，
+  // 而 load 是好读命令 —— 不该因纯排版差异去改文件）。
+  // 有内容的第一个分区与前言之间保留一个空行（排版），其余紧凑。
+  for (const [idx, name] of spec.order.entries()) {
+    const body = trimBlank(bucket.get(name) || []);
+    if (body.length || (idx === 0 && pre.length)) out.push('', name, ...body);
+    else out.push(name);
+  }
+  for (const e of extras) {
+    const body = trimBlank(e.lines);
+    out.push('', e.title);
+    if (body.length) out.push(...body);
+  }
+  const next = out.join('\n').replace(/\n{3,}/g, '\n\n').replace(/\s+$/, '') + '\n';
+  return { text: next, changed: next === s ? [] : ['结构按标准重排'] };
+}
+
+/** 去掉首尾空行，不动中间（保留用户的分段）。 */
+function trimBlank(arr) {
+  const a = [...arr];
+  while (a.length && !a[0].trim()) a.shift();
+  while (a.length && !a[a.length - 1].trim()) a.pop();
+  return a;
+}
+
 export function normalizeTodo(text) {
   const lines = text.split('\n');
   const has = (name) => lines.some((l) => l.trim() === `## ${name}`);
   if (has('Backlog') || has('Today / In Progress')) return text; // 已是新格式
   if (!has('In Progress') && !has('Todo')) return text;          // 不是老格式，不动
-  const out = ['# 📋 Todo 看板'];
+  const out = ['# 📋 Todo Board'];
   const grab = (name) => {
     const items = [];
     let inSec = false;
@@ -83,7 +190,7 @@ export function normalizeTodo(text) {
   out.push('## Backlog', ...todo.length ? todo : []);
   out.push('## Today / In Progress', ...inprog.length ? inprog : []);
   out.push('## Blocked', ...blocked.length ? blocked : []);
-  out.push('## Done（只留近期，旧的迁 log.md/快照）', ...done.length ? done : []);
+  out.push('## Done', ...done.length ? done : []);
   return out.join('\n');
 }
 
@@ -156,7 +263,7 @@ function renderDoneGroups(units) {
   const dates = [...byDate.keys()].sort().reverse(); // 新日期在前
   const out = [];
   for (const d of dates) out.push(`### ${d}`, '', ...byDate.get(d).flatMap((u) => u.lines), '');
-  if (undated.length) out.push('### （未标日期）', '', ...undated.flatMap((u) => u.lines), '');
+  if (undated.length) out.push(`### ${SEC.undated}`, '', ...undated.flatMap((u) => u.lines), '');
   return out;
 }
 
@@ -206,11 +313,11 @@ export function collapseDone(text) {
 }
 
 /** 归档标记区标题。它在 Done 区内部、日期分组之后，形如：
- *   ### 归档
+ *   ### Archived
  *   - [[2026-09-10-todo归档]] 完成任务 10 条
  * 这区不是任务行，不能被 parseDoneUnits 吃挂，否则 markDone 重建 Done 时会把它丢掉。
  * 故先切出去当"不透明区域"原样保留。 */
-const ARCHIVE_HEADING = '### 归档';
+const ARCHIVE_HEADING = `### ${SEC.archived}`;
 
 /** 把 Done 主体行切成 { groupLines, archiveLines }：把 `### 归档` 区当"不透明块"原样保留。
  * 注意不能简单"从标题切到文件尾" —— 否则一旦有日期组落在归档区之后（手改/旧数据），