@fanchao8609/agent_brain_sync 1.25.0 → 1.26.0

package/README.md

@@ -75,7 +75,7 @@ pi 与 omp 宿主额外多一层 UI（其它宿主没有）：**编辑器上方
 - **子项（缩进的 `- [ ]`）挂在父任务下**；`├─` / `└─` 表结构
 - **子项可各自勾选**：`  - [ ] 一句话` → `  - [x] 一句话`；全部勾上才能 `done` 父任务
 - **「进行中」带三点动画**`○○○ → ●●○ → ●●●`（250ms/帧）—— 一眼看出哪条在跑
-- **实时刷新**：我调 `abs_task` / `abs_board` 后立即重画，不用等我讲完话
+- **实时刷新**：我调 `abs_task` 后立即重画，不用等我讲完话
 - **上描边与输入框同色满宽**（主题色 `thinkingOff`，跟 pi 输入框的边框一致）
 - 窄终端按显示宽度截断（CJK 计 2 列），不溢出
 
@@ -120,13 +120,15 @@ abs todo done    TASK-1
 abs note "一句话经验" --tags 坑,docker    # 经验暂存 → sources/
 abs log "完成 X"                          # 记一行流水；abs log 无参 = 查看
 abs query <词>                            # 检索图谱（多词 OR）；已被推翻的经验默认隐藏（--all 可看）
-abs capture [--layer 1-7] [--kind …] "一句话"  # 按七层判层后落到位（--kind: gotcha|decision|tradeoff|howto）
+abs capture [--layer 1-6] [--kind …] "一句话"  # 按七层判层后落到位（L7 用 abs note；--kind: gotcha|decision|tradeoff|howto）
 abs db rebuild                            # 扫所有登记项目 → 建图数据库（~/.abs/graph.db）
-abs db search <词> [--full]              # 走库检索：默认只给摘要+token 成本，--full 才附正文
+abs db search <词> [--full] [--no-rules] # 走库检索：亮度排序+跨项目；--full 附正文，--no-rules 省铁律
 abs db status                             # 库体检：七层分布 / 悬挂链接 / 已入库项目
 abs db add                                # 把当前项目登记进 ~/.abs/projects.json
 abs db evolve                             # 知识进化体检：被推翻/断链/主题堆积/僵化页
-abs summon [--mark|--status]              # 会话总结托底：列出未总结 / 有更新的会话（不写盘）
+abs summon [--status]                   # 列出还没落页的会话（只读，不写盘）
+abs ingest <会话文件或 id>                 # 把一场 pi 会话落成会话页（session-id 双向回溯）
+                                           #   已填 → 亮度×0.5；未填 → 整页不进检索
 abs resolve <页名或id>                    # 反查页面路径（页改名后 id 不变）
 abs supersede <页名> [--by <新页>]        # 标记经验已失效（不删文件，保留历史；query 默认不再返回）
 abs status                                # 当前项目 + 图谱概要

package/bin/abs.js

@@ -6,6 +6,7 @@ import { cmdInit, cmdStatus, cmdLoad, cmdRecall, cmdTask, cmdLog, cmdQuery, cmdL
 import { cmdDbRebuild, cmdDbSearch, cmdDbStatus, cmdDbEvolve, addProject } from '../src/brain/db-cmd.js';
 import { cmdCapture } from '../src/brain/capture.js';
 import { cmdSummon } from '../src/brain/summon-cmd.js';
+import { cmdIngest } from '../src/brain/ingest.js';
 import { setUser, getUser, userConfigPath } from '../src/userconfig.js';
 import { runInstall, runUninstall } from '../src/install.js';
 import { readFileSync } from 'node:fs';
@@ -144,6 +145,17 @@ const FLAG_SPEC = {
   'repair': { type: 'boolean' },
   'no-mcp': { type: 'boolean' },
   'no-skill': { type: 'boolean' },
+  // ingest 用：强制重建已有会话页。
+  // ★ 不声明就会被 parseArgs 当布尔 true（见上面 kind 的注释）。
+  // （--mark 已在 summon 那里声明过，两家共用，不能重复写 —— no-dupe-keys 会报）
+  'force': { type: 'boolean' },
+  // ingest 用：--last 取最近一场会话（hook 在 session_shutdown 调，不用给 id）；
+  //           --auto 只落真改过文件的会话（纯聊天不落页）。
+  'last': { type: 'boolean' },
+  'auto': { type: 'boolean' },
+  // db search 用：不输出 L1 铁律（查主题时它们是噪音；开工看铁律是 load 的职责）。
+  // ★ 不声明会被 parseArgs 当布尔 true —— 见上面 kind 的注释。
+  'no-rules': { type: 'boolean' },
 };
 
 /** 已被"规范键"接管的 raw flag：不再原样漏出（见 parseArgv 返回处的白名单注释）。 */
@@ -250,8 +262,9 @@ const usage = `abs — 跨会话记忆工具（.brain/ 图谱）
   todo                       任务看板 (add/note/state/done/archive)
   index | log | status       索引 / 流水 / 概要
   note <经验> [--tags a,b]   经验暂存 → sources/
-  capture [--layer 1-7] "…"  按七层判定落点后直接写入 (不传=L4)
+  capture [--layer 1-6] "…"  按层判定落点后直接写入 (不传=L4; L7 用 abs note)
   summon [--mark|--status]   会话总结托底: 列出未总结/有更新的会话 (不写盘)
+  ingest <会话文件>           把一场 pi 会话落成会话页 (带 session id 双向回溯)
   concept <slug> --title …   建概念页骨架
   query <词…> [--all]       检索知识页 (多词 OR)
   db rebuild|search|status|evolve  图数据库: 建库 / 亮度搜索 / 体检 / 进化体检
@@ -555,6 +568,13 @@ async function main() {
         console.log(await cmdSummon({ dir: opts.dir, mark: !!opts.mark, full: !!opts.full, status: !!opts.status, limit: Number(opts.limit) || 15 }));
         break;
       }
+      case 'ingest': {
+        console.log(await cmdIngest({
+          dir: opts.dir, file: opts._.join(' '), force: !!opts.force, mark: !!opts.mark,
+          last: !!opts.last, auto: !!opts.auto, session: opts.session,
+        }));
+        break;
+      }
       case 'capture': {
         console.log(await cmdCapture({ dir: opts.dir, text: opts._.join(' '), layer: opts.layer, tags: opts.tags, title: opts.title, kind: opts.kind }));
         break;
@@ -601,7 +621,7 @@ async function main() {
         const sub = opts._[0];
         const rest = opts._.slice(1);
         if (sub === 'rebuild') { console.log(await cmdDbRebuild({ dir: opts.dir })); break; }
-        if (sub === 'search') { console.log(await cmdDbSearch({ query: rest.join(' '), limit: Number(opts.limit) || 8, full: !!opts.full })); break; }
+        if (sub === 'search') { console.log(await cmdDbSearch({ query: rest.join(' '), limit: Number(opts.limit) || 8, full: !!opts.full, noRules: !!opts['no-rules'] })); break; }
         if (sub === 'status') { console.log(await cmdDbStatus()); break; }
         if (sub === 'evolve') { console.log(await cmdDbEvolve({ staleDays: Number(opts.staleDays) || 90 })); break; }
         if (sub === 'add') {

package/bin/mcp.js

@@ -12,7 +12,9 @@ import { readFileSync } from 'node:fs';
 import { join, dirname } from 'node:path';
 import { fileURLToPath } from 'node:url';
 import { findBrainRoot, absLogDir, AbsError } from '../src/index.js';
-import { cmdBoard, cmdLoad, cmdStatus, cmdTask, cmdQuery, cmdLint, cmdNote, cmdConcept, cmdWrapup, cmdRule, cmdResolve, cmdSupersede } from '../src/store.js';
+import { cmdLoad, cmdStatus, cmdTask, cmdQuery, cmdLint, cmdNote, cmdConcept, cmdRule, cmdResolve, cmdSupersede } from '../src/store.js';
+// abs_search 用：db search 的实现（它比 cmdQuery 强 —— 带亮度排序、能扩散、能跨项目）
+import { cmdDbSearch } from '../src/brain/db-cmd.js';
 
 // ---------- 技术日志: MCP 请求跟踪（调试用, 与图谱 log.md 完全分开） ----------
 // 落 ~/.abs/log/mcp.log: 每次工具调用一行 [时间] tool cwd 参数摘要 → 耗时/结果摘要。
@@ -76,8 +78,14 @@ function tool(name, description, schema, handler) {
 // 分级标注（借 OpenContext 的 P0/P1/P2 惯例）：P0=每次开机必调；P1=干活中按需；P2=诊断/收尾。
 // 后来人（和 AI）照这个顺序调，别一上来就 lint。
 //   P0  abs_resolve_project / abs_load
-//   P1  abs_board / abs_task / abs_query / abs_note / abs_resolve
-//   P2  abs_status / abs_rule / abs_lint / abs_wrapup
+//   P1  abs_task / abs_query / abs_note / abs_resolve
+//   P2  abs_status / abs_rule / abs_lint
+//
+// 2026-11-05 删两个（用户定，判据见 concept feature-delete-not-patch）：
+//   abs_board  ── 它吐的内容已被 abs_load 完全覆盖（load 里就有 Todo Board 段），
+//                 是「与已有功能重叠 → 删」的又一例。
+//   abs_wrapup ── 它是 hook 的内部命令（session_shutdown 自己会跑），
+//                 给人调没有意义；暴露成工具只会诱使 agent 手动跑一遍。
 tool(
   'abs_resolve_project',
   '定位当前项目的 .brain 图谱根（只认给定目录本身的 .brain/，不向上搜索）。多项目隔离的唯一入口。',
@@ -94,17 +102,6 @@ tool(
   }
 );
 
-tool(
-  'abs_board',
-  '读取当前项目 todo 看板（含任务与子项）。先 resolve 得到项目，再传其根目录。',
-  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
-  async ({ cwd }) => {
-    const root = await findBrainRoot(cwd || process.cwd());
-    if (!root) return errNoBrain(cwd || process.cwd());
-    return { content: [{ type: 'text', text: await cmdBoard({ dir: root }) }] };
-  }
-);
-
 tool(
   'abs_load',
   '开机读状态：index 的 Rules + 图谱计数 + todo 看板 + 最近 log。跨会话续接的入口。',
@@ -212,6 +209,36 @@ tool(
   }
 );
 
+tool(
+  'abs_search',
+  '按亮度检索知识图谱（跨项目）：比 abs_query 更强 —— 带亮度排序、能从邻居页扩散、能查到别的项目的经验（标 [跨项目]）。'
+  + '适合「我上次怎么解决 X」这类回忆。铁律默认省略（开工时 abs_load 会给），需要时传 include_rules=true。',
+  {
+    cwd: z.string().describe('项目根目录（.brain/ 所在处）'),
+    query: z.string().describe('检索词（一句话或几个词都行，中文两字以上即可）'),
+    limit: z.number().int().min(1).max(20).optional().describe('最多几页，默认 8'),
+    include_rules: z.boolean().optional().describe('true=连 L1 铁律一起返回（默认省略，省 token）'),
+  },
+  async ({ cwd, query, limit, include_rules }) => {
+    // 库是全局的（~/.abs/graph.db），不需要 findBrainRoot —— 但先确认项目本身有图谱，
+    // 否则用户在一个陌生目录调用会得到「别的项目的结果」而不自知。
+    const root = await findBrainRoot(cwd || process.cwd());
+    if (!root) return errNoBrain(cwd || process.cwd());
+    const text = await cmdDbSearch({
+      query: String(query || ''),
+      limit: Number(limit) || 8,
+      noRules: !include_rules,
+    });
+    if (/库还没建|无命中/.test(text)) {
+      return err(text, {
+        code: 'NO_MATCH',
+        fallback: '库可能是旧的：跑 abs db rebuild 重扫；或换更具体的词',
+      });
+    }
+    return { content: [{ type: 'text', text }] };
+  }
+);
+
 tool(
   'abs_rule',
   '读/写 index.md 的 ## Rules 硬规则区。action=list 列出；action=add 追加一条（只放一句话，≤42 字符、不带链接；展开写概念页）。',
@@ -276,17 +303,6 @@ tool(
   }
 );
 
-tool(
-  'abs_wrapup',
-  '收尾保险：把当前 todo 未完成任务快照到 ~/.abs/log/wrapup.log（下会话 load 时展示滞留对账）。',
-  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
-  async ({ cwd }) => {
-    const root = await findBrainRoot(cwd || process.cwd());
-    if (!root) return errNoBrain(cwd || process.cwd());
-    return { content: [{ type: 'text', text: await cmdWrapup({ dir: root }) }] };
-  }
-);
-
 // 错误带逃生口：Agent 收到错要能自救，而不是回来问人。
 // 借 OpenContext 的做法——错误里直接给「退一步怎么做」，且带结构化 code 供程序判分支。
 // 判据：凡 isError 的返回，调用方读完应知道下一步跑什么命令。

package/hooks/{pi-rounded-format.ts → abs-rounded-editor/format.ts}

@@ -1,7 +1,7 @@
 /**
  * 圆角输入框的纯格式化函数（无宿主依赖，可单测）。
  *
- * 单独成文件的原因：hooks/pi-rounded-editor.ts 要 import `@earendil-works/pi-coding-agent`，
+ * 单独成文件的原因：hooks/abs-rounded-editor/index.ts 要 import `@earendil-works/pi-coding-agent`，
  * 测试进程里没有这个包；把纯函数抽出来才能直接 import 断言。
  */
 

package/hooks/{pi-rounded-editor.ts → abs-rounded-editor/index.ts}

@@ -18,7 +18,7 @@
  * 注意：自动补全菜单行排在底边之下、且自带内容宽度，不套竖线（否则菜单被框住会错位）。
  */
 import { CustomEditor } from '@earendil-works/pi-coding-agent'
-import { buildStatus, roundBorder, shortenModel } from './pi-rounded-format.ts'
+import { buildStatus, roundBorder, shortenModel } from './format.ts'
 
 const SIDE = '│'
 

package/hooks/abs.omp.ts

@@ -130,6 +130,27 @@ function snapshotWrapup(cwd: string): void {
   } catch {} // fire-and-forget
 }
 
+/** 会话关闭时把这场会话落成会话页（2026-11-05，与 pi 侧同一机制）。
+ *
+ * 为何挂 session_shutdown 而不靠 agent 主动调：「靠提醒让 LLM 养成习惯」本仓已
+ * 两次实测否证（concept remind-vs-gate）；收尾必须由机械事件触发。
+ *
+ * 为何传 --session 而不是 --last：`--last` 按文件 mtime 选，同时开两个会话时会选错
+ * —— pi 侧实测「关会话 A 却落了 B 的页」。这里能拿到 sid 就传，拿不到才退回 --last。
+ *
+ * 为何不往对话里插话：走到 shutdown 已经没有对话了，只落盘，输出丢弃。
+ * 下次开工 abs load 会把未填的会话页摆出来 —— 摆事实，判断仍归 agent。 */
+function snapshotSessionPage(cwd: string, sid = ""): void {
+  const args = ["ingest", "--auto"]
+  if (sid) args.push("--session", sid); else args.push("--last")
+  try {
+    const child = spawn(process.execPath, [ABS_BIN, ...args], {
+      cwd: cwd || process.cwd(), stdio: "ignore", detached: true,
+    })
+    child.unref()
+  } catch {} // fire-and-forget，失败不影响关会话
+}
+
 /** 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）。 */
 async function findBrain(cwd: string): Promise<string | null> {
   const d = cwd || process.cwd()
@@ -525,8 +546,8 @@ export function renderPanelLines(
   // 上描边行已删除（2026-11-04 与 pi 版同步，用户要求「去掉上边框」）。首行现在是标题行。
   const whoPart = who ? who + (nickname ? ` · ${nickname}` : '') : nickname
   const title = whoPart ? `Todo (${data.total}) — ${whoPart}` : `Todo (${data.total})`
-  // 前导一格空格：对齐输入框内文本（输入框左右竖线内侧各留一格，见 hooks/pi-rounded-editor.ts）。
-  lines.push(clipToWidth(' ' + fg('accent', title), width))
+  // 空看板标题前加 1 格（与输入框文字对齐）；有任务时不加，任务行顶到最左（2026-11-04 用户）。
+  lines.push(clipToWidth((data.total === 0 ? ' ' : '') + fg('accent', title), width))
 
   const lastIdx = data.rows.length - 1
   // 空看板只显示标题行（2026-11-04 用户要求去掉「（无未完成任务）」那行）。
@@ -540,7 +561,7 @@ export function renderPanelLines(
     const box = fg('dim', '[ ]')
     const head = `${fg('dim', branch)} ${box} ${fg(colorOf(t.state), `[${t.state}]`)} ${fg('text', t.id)}${anim}`
     const desc = t.desc ? ` ${fg('dim', '—')} ${fg('muted', t.desc)}` : ''
-    lines.push(clipToWidth(' ' + head + desc, width))
+    lines.push(clipToWidth(head + desc, width))
     if (t.kids && t.kids.length) {
       // 子项：标准 md 嵌套列表 → 画成树
       const stem = isLast ? '  ' : fg('dim', '│ ')
@@ -554,7 +575,7 @@ export function renderPanelLines(
     }
   })
 
-  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `   +${data.hidden} more`), width))
+  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `  +${data.hidden} more`), width))
   return lines
 }
 
@@ -845,6 +866,7 @@ export default function absOmpExtension(pi: ExtensionAPI): void {
   pi.on("session_shutdown", (_e: SessionShutdownEvent, ctx: ExtensionContext) => {
     stopAnimTimer() // 面板没了，动画定时器必须一起停（否则残留定时器白刷已丢弃的 tui）
     snapshotWrapup(ctx.cwd)
+    snapshotSessionPage(ctx.cwd, sessionIdFor(ctx))
     logHook("session_shutdown").catch(() => {})
   })
 }

package/hooks/abs.pi.ts

@@ -125,6 +125,37 @@ function snapshotWrapup(cwd: string): void {
   } catch {} // fire-and-forget
 }
 
+/** 会话关闭时把这场会话落成会话页（2026-11-05）。
+ *
+ * 为何挂这里而不是靠 agent 主动调：本仓已两次实测「靠提醒让 LLM 养成习惯」必失败
+ * （concept remind-vs-gate）——「有疑惑就查」这种规矩写进 skill 开场后也仍然漏
+ * （concept 检索有效不等于记忆被用）。所以收尾不能靠它想起来，得靠机械事件。
+ *
+ * 为何用 session_shutdown 而不是 agent_end：agent_end 是**每一轮回复**结束都触发，
+ * 2026-09-21/22 两次实测被用户当场指出「聊一句话就触发」；而且往对话里插消息
+ * 这条路已被 2026-09-18 / 2026-10-05 两次用户实报（任务中断 / 卡顿）否决。
+ * session_shutdown 是真正关会话，此刻 jsonl 已写完（实测 347 行 0 坏行），读得到全文。
+ *
+ * 为何不往对话里回话：这里没有对话了。它只落盘，输出丢弃。
+ * 下次开工 abs load 会把未填的会话页摆出来 —— 摆事实，判断仍归 agent。
+ *
+ * 判据在 ingest 的 --auto 里（只收真改过文件的会话）；这里只负责把它叫起来。 */
+function snapshotSessionPage(cwd: string, sid = ""): void {
+  // ★ 传本会话 id，不用 --last 猜（2026-11-05 实测修正）：
+  //   `--last` 按文件 mtime 选，同时开两个会话时会选错 ——
+  //   实测关会话 A 却落了 B 的页，因为 B 的 jsonl 更新。
+  //   hook 这侧本来就能拿到会话 id（sessionIdFor），传下去即可精确定位。
+  //   取不到 id 时才退回 --last（老版本语境 / 宿主不提供），至少还能落一场。
+  const args = ["ingest", "--auto"];
+  if (sid) args.push("--session", sid); else args.push("--last");
+  try {
+    const child = spawn(process.execPath, [ABS_BIN, ...args], {
+      cwd: cwd || process.cwd(), stdio: "ignore", detached: true,
+    })
+    child.unref()
+  } catch {} // fire-and-forget，失败不影响关会话
+}
+
 /** 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）。 */
 async function findBrain(cwd: string): Promise<string | null> {
   const d = cwd || process.cwd()
@@ -936,8 +967,8 @@ export function renderPanelLines(
   // 昵称附在作者名后（会话内固定，启动时随机抽）。
   const whoPart = who ? who + (nickname ? ` · ${nickname}` : '') : nickname
   const title = whoPart ? `Todo (${data.total}) — ${whoPart}` : `Todo (${data.total})`
-  // 前导一格空格：对齐输入框内文本（输入框左右竖线内侧各留一格，见 hooks/pi-rounded-editor.ts）。
-  lines.push(clipToWidth(' ' + fg('accent', title), width))
+  // 空看板标题前加 1 格（与输入框文字对齐）；有任务时不加，任务行顶到最左（2026-11-04 用户）。
+  lines.push(clipToWidth((data.total === 0 ? ' ' : '') + fg('accent', title), width))
 
   const lastIdx = data.rows.length - 1
   // 空看板只显示标题行（2026-11-04 用户要求去掉「（无未完成任务）」那行）。
@@ -955,7 +986,7 @@ export function renderPanelLines(
     const box = fg('dim', '[ ]')
     const head = `${fg('dim', branch)} ${box} ${fg(colorOf(t.state), `[${t.state}]`)} ${fg('text', t.id)}${anim}`
     const desc = t.desc ? ` ${fg('dim', '—')} ${fg('muted', t.desc)}` : ''
-    lines.push(clipToWidth(' ' + head + desc, width))
+    lines.push(clipToWidth(head + desc, width))
     if (t.kids && t.kids.length) {
       // 子项：标准 md 嵌套列表 → 画成树
       //   ├─ [ ] 子项一
@@ -973,7 +1004,7 @@ export function renderPanelLines(
     }
   })
 
-  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `   +${data.hidden} more`), width))
+  if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `  +${data.hidden} more`), width))
   return lines
 }
 /** 隐藏面板。**必须主动 requestRender** —— 否则数据清了、屏幕还留着旧画面。
@@ -1205,6 +1236,7 @@ export default function absPiHook(pi: ExtensionAPI): void {
   pi.on("session_shutdown", (_e: any, ctx: any) => {
     stopAnimTimer() // 面板没了，动画定时器必须一起停（否则残留定时器白刷已丢弃的 tui）
     snapshotWrapup((ctx && ctx.cwd) || process.cwd())
+    snapshotSessionPage((ctx && ctx.cwd) || process.cwd(), sessionIdFor(ctx))
     logHook("session_shutdown").catch(() => {})
   })
 }

package/package.json

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

package/skill/abs-agent-brain-sync/SKILL.md

@@ -14,12 +14,17 @@ description: "USE FOR abs / agent-brain-sync 跨会话记忆与任务续接。
 怎么查：
 
 ```bash
-abs recall <关键词>     # 有疑问时用：按亮度出最相关的几页（不给词就从当前处境推）
-ab query <词>           # 想拿更全：多词 OR，枚举全图命中
-db search <词>          # 更高级：种子扩散亮起相关页，先出铁律
-abs resolve <页名>      # 拿到页名后反查路径，只读那一页
+abs recall <关键词>       # 有疑问时用：按亮度出最相关的几页（不给词就从当前处境推）
+abs query <词>            # 多词 OR，枚举全图字面命中；输出短（页名+摘要），省 token
+abs db search <词>        # CLI：亮度排序 + 邻居扩散 + 跨项目；加 --no-rules 省掉 18 条铁律
+abs resolve <页名>        # 拿到页名后反查路径，只读那一页
 ```
 
+MCP 侧走 `abs_search`（等价于 `abs db search --no-rules`）—— 比 `abs_query` 强：
+带亮度排序、能从邻居页扩散、能查到别的项目（标 `[跨项目]`）。
+两者是**详略两档**，不是重复：`abs_query` 给字面命中的页名+摘要，最省；
+`abs_search` 给亮度与扩散，找「我上次怎么解决 X」时更准。
+
 查完只读命中那几页，**绝不通读 `.brain/`**。答用 `[[页面名]]` 标来源。
 
 ## 触发器
@@ -30,13 +35,15 @@ abs resolve <页名>      # 拿到页名后反查路径，只读那一页
 
 ## 命令速查
 
-完整帮助 `abs help`。读写优先走 MCP（`abs_load`/`abs_task`/`abs_note`/`abs_query`/`abs_lint`/`abs_rule`），比 CLI 快；`abs wrapup`/`abs teardown-check` 是 hook 内部命令。分工：hook 记技术日志；CLI/MCP 实时落盘；skill 负责深提炼 + 收尾 + 修 index。
+完整帮助 `abs help`。读写优先走 MCP（`abs_load`/`abs_task`/`abs_note`/`abs_search`/`abs_query`/`abs_lint`/`abs_rule`），比 CLI 快；`abs wrapup`/`abs teardown-check` 是 hook 内部命令。分工：hook 记技术日志；CLI/MCP 实时落盘；skill 负责深提炼 + 收尾 + 修 index。
 
 ```bash
 abs load                          # 开机读状态
-abs query <词>                    # 检索；abs resolve <页名> 反查路径
+abs query <词>                    # 字面 OR 命中，输出短；MCP 侧更推荐 abs_search（更准）
 abs todo add <id> --note "做什么"   # 登记；note/memo/state/done 见「进行中」
-abs capture [--layer 1-7] [--kind …] "…"   # 按七层判定落点后写入（--kind 分作用）
+abs capture [--layer 1-6] [--kind …] "…"   # 按七层判定落点后写入（L7 走 abs note）
+abs summon                        # 列出没落页的会话（只读，不写盘）
+abs ingest <会话文件或 id>         # 把一场 pi 会话落成会话页（带 session id 双向回溯）
 abs note "经验" [--tags a,b]      # 暂存经验（一律 L7 混沌层）
 abs concept <slug> --title "…"    # 建概念页骨架
 abs rule add "一句话"             # 加 Rules；abs lint 体检；abs init 建图谱
@@ -121,9 +128,9 @@ abs rule add "一句话"             # 加 Rules；abs lint 体检；abs init
 | L2 规则 | 这个项目要遵守的做法 | `concepts/` + `layer: 2` | `abs capture --layer 2` |
 | L3 工具 | 某工具怎么用、有什么坑 | `concepts/` + `layer: 3` | `abs capture --layer 3` |
 | L4 认知 | 踩坑的根因与解法 | `concepts/` + `layer: 4` | `abs capture "…"`（默认） |
-| L5 会话 | 这次做了什么 | `log.md` / `sessions/` | `abs log` / `abs todo done` |
+| L5 会话 | 这次做了什么 | `log.md` / `sessions/` | `abs log`（当天工作）/ `abs ingest`（一场会话） |
 | L6 断点 | 双链词 | 不立页，机器自动抽 | 不接手写 |
-| L7 混沌 | 还没想清的碎片 | `sources/` | `abs capture --layer 7` |
+| L7 混沌 | 还没想清的碎片 | `sources/` | `abs note`（capture 的 L7 已拒，同一个落点） |
 
 判据不明时用 L4 —— 但**知道是工具经验就写 L3**：实测算过，本仓 52 页 concepts 里 23 页其实是 L3。
 
@@ -139,6 +146,43 @@ abs rule add "一句话"             # 加 Rules；abs lint 体检；abs init
 不传就不写（旧页留空，不强制补）。实测只有 `gotcha` 能靠 tags/标题机械识别，
 另三类判据在内容里 —— 别拿关键词瞎猜。
 
+**尾巴按 kind 分档**（`abs lint` 的 NO-TAIL）：`gotcha`/`howto` 必须有验证命令；
+`decision`/`tradeoff` 写「当时依据什么选的」（取舍依据，不是可跑的命令）；
+无 `kind` 的旧页保持原要求。理由：决策类知识天生没有验证命令，硬要写就是编。
+
+## 会话总结（把整场会话变成知识）
+
+abs 不只记编程经验 —— **会话本身的结论也是知识**。两条路径，用途不同：
+
+| 想要 | 命令 | 产出 |
+|---|---|---|
+| 一场会话干了什么/谈成了什么 | `abs ingest <会话文件或 id 前 8 位>` | `sessions/session-<日期>-s<id8>.md`，带三种骨架之一 |
+| 还没落页的会话 | `abs summon` | 清单，不写盘 |
+
+`abs ingest` 按「改过什么文件」机械判形状，不让模型猜：
+
+- **技术类**（改了代码）→ 出了什么问题 / 怎么解决的 / 验证什么命令
+- **业务操作类**（只改数据/配置/文档）→ 做了什么操作 / 结果怎样 / 下次注意事项
+- **讨论类**（一个文件没改）→ 谈成了什么 / 没结论的地方
+
+它只给骨架和素材（用户原话、改过的文件、工具调用次数），**不写结论** —— 内容要读会话后填。
+
+**与会话的双向挂钩**（不要手改这三行）：`session`（pi 会话 id）、`session-file`（jsonl 文件名）、
+`project`（会话发生时的 cwd）。页文件名也带会话 id 前 8 位，拿会话文件能反查有没有总结过。
+
+会话页在检索里的待遇按「填没填」分两档（判据 `digestFilled`，`layers.js`）：
+
+| 状态 | 检索 |
+|---|---|
+| **已填**（骨架段有真内容） | 亮度乘 0.5，能搜到也能扩散，但不抢知识页位置 |
+| **未填**（骨架段只有占位注释） | **整页排除**，种子和扩散都进不来 |
+
+未填整页排除的理由（实测）：空骨架的「用户原话」段词频高、正文又短，bm25 天然占优。
+造 20 张空骨架后查「登录超时」，前 12 名全是空页，真正讲过该问题的知识页被彻底挤出结果。
+
+`abs load` 顶部会列出未填的张数（最多 5 个页名，按日期倒序）。**不必全部填** ——
+挑最近、有结论的几场；其余留着当流水，不填也不会污染检索。
+
 `abs capture` 之后跑 `abs db rebuild` 让图数据库收录，否则检索拿不到它。
 
 ## 进行中：什么时候动它

package/src/brain/capture.js

@@ -22,12 +22,13 @@ import { autoIndex } from './db-cmd.js';
 import { summonTail } from './summon.js';
 
 /** 层 → 落点目录。L1/L6 不立页，由下面的分支单独处理。 */
+// 落点目录。L1/L6 不立页、L5/L7 不在 capture 职责内，都由下面的分支单独处理。
+// （2026-11-05 审查删掉 `7: 'sources'`：L7 改成直接拒后它已是死代码，
+//   留着会让下个读者以为走 capture 就能落混沌层。）
 const LAYER_DIR = {
   2: 'concepts',
   3: 'concepts',
   4: 'concepts',
-  5: 'sessions',
-  7: 'sources',
 };
 
 /** 判据表：输入时就看得到，不用记。 */
@@ -37,9 +38,9 @@ export function layerGuide() {
     ['2', '规则', '这个项目要遵守的做法', 'abs capture --layer 2 "…"'],
     ['3', '工具', '某工具怎么用、有什么坑', 'abs capture --layer 3 "…"'],
     ['4', '认知', '踩坑的根因与解法（默认）', 'abs capture "…"'],
-    ['5', '会话', '这次会话做了什么', 'abs log / abs todo done'],
+    ['5', '会话', '这次会话做了什么', 'abs log / abs ingest'],
     ['6', '断点', '双链词，机器自动抽，不用手写', '（无）'],
-    ['7', '混沌', '还没想清的碎片', 'abs capture --layer 7 "…"'],
+    ['7', '混沌', '还没想清的碎片', '用 abs note（同一个落点）'],
   ];
   return [
     '按七层判定这一句该落在哪：',
@@ -58,7 +59,8 @@ export async function cmdCapture({ dir, text, layer, tags, title, kind }) {
 
   if (!clean) {
     return [
-      '用法: abs capture [--layer 1-7] [--kind gotcha|decision|tradeoff|howto] "一句话" [--tags a,b] [--title "页标题"]',
+      '用法: abs capture [--layer 1-6] [--kind gotcha|decision|tradeoff|howto] "一句话" [--tags a,b] [--title "页标题"]',
+      '  注: L7（混沌/碎片）用 abs note，两者落点相同，不再留两个入口。',
       '',
       layerGuide(),
     ].join('\n');
@@ -79,6 +81,34 @@ export async function cmdCapture({ dir, text, layer, tags, title, kind }) {
     return '✗ L6 断点层是机器从双链里自动抽的词，不接手写。\n  想加索引词：在页面正文写 [[词]]，abs db rebuild 时会自动收录。';
   }
 
+  // L7 混沌层：`abs note` 与 `abs capture --layer 7` 是**同一个落点**
+  //   （都进 sources/，同样的文件名与正文结构）。实测 2026-11-05 确认。
+  //   两个入口做同一件事 = 每次都得先选一个，而选不选对没有任何后果 ——
+  //   纯认知负担。按本仓判据「与已有功能重叠 → 复用/删，别新增」
+  //   （concept feature-delete-not-patch），保留被真实用过 228 次的 note，
+  //   这里直接拒，并给出等价命令 —— 不静默转发（静默转发会把两个入口都留着）。
+  if (L === 7) {
+    return [
+      '✗ L7 混沌层用 abs note，不用 capture。',
+      `  abs note "${clip(clean, 40)}"`,
+      '  两者落点完全相同（都进 sources/）；note 是这条主路径，别再二选一。',
+    ].join('\n');
+  }
+
+  // L5 会话层同样不接 capture（2026-11-05 审查发现）：它落 sessions/，
+  //   而 sessions/ 有两条硬规则（lint 的 SESSIONS-NAMING / SESSIONS-MISPLACED）——
+  //   当天只允许 `log-<日期>.md`、tags 必须是 session-log 类。capture 生成的
+  //   `<日期>-<内容>.md` + `tags: [concept]` 必然被这两条同时报错。
+  //   实测：`abs capture --layer 5 "x"` → lint 报 2 个问题。命令自己产出坏数据。
+  //   真实用法各有正主：当天工作 → abs log；一场会话的结构化记录 → abs ingest。
+  if (L === 5) {
+    return [
+      '✗ L5 会话层不接 capture（它落 sessions/，会违反那里的命名与 tags 规则）。',
+      '  当天工作成果 → abs log "完成 X：…"',
+      '  一场会话的结构化记录 → abs ingest --last（或给会话 id）',
+    ].join('\n');
+  }
+
   // L1 铁律：复用 cmdRule 的门槛（≤42 字、禁链接），不另起一套
   if (L === 1) {
     const { cmdRule } = await import('./rules.js');

package/src/brain/db-cmd.js

@@ -190,7 +190,7 @@ export async function cmdDbRebuild({ dir } = {}) {
 }
 
 /** `abs db search <词>` —— 走库搜索：FTS 种子 → 亮度扩散。 */
-export async function cmdDbSearch({ query, limit = 8, full = false } = {}) {
+export async function cmdDbSearch({ query, limit = 8, full = false, noRules = false } = {}) {
   const q = String(query || '').trim();
   if (!q) return '用法: abs db search <词>';
 
@@ -208,7 +208,11 @@ export async function cmdDbSearch({ query, limit = 8, full = false } = {}) {
     const lit = illuminate(h, seeds, { limit });
 
     const out = [`db search [${q}] → 种子 ${seeds.length} 条，亮起 ${lit.length} 页`];
-    if (rules.length) {
+    // --no-rules：不输出 L1 铁律（2026-11-05）。
+    // 为何要它：铁律 18 条，占输出近一半。开工时（abs load）确实该先看，
+    // 但「查一个主题」时它们是噪音 —— 实测同一查询 43 行里有 4 行是铁律区，
+    // 而 MCP 侧每次调用都受这个成本影响。省略不等于不遵守：铁律由 load 负责送达。
+    if (rules.length && !noRules) {
       out.push('', `--- L1 铁律 ${rules.length} 条（任何检索先出）---`);
       for (const r of rules) out.push(`- ${r}`);
     }
@@ -256,9 +260,13 @@ export async function cmdDbSearch({ query, limit = 8, full = false } = {}) {
         if (body.split('\n').length > 60) out.push('      │ …（已截断，用 abs resolve 看全文）');
       }
     }
-    out.push('', '（L1 铁律恒在最前；↝ 表示由邻居扩散点亮，非直接命中）');
+    if (noRules) {
+      out.push('', '（↝ 表示由邻居扩散点亮，非直接命中；铁律已省略，开工时 abs load 会给）');
+    } else {
+      out.push('', '（L1 铁律恒在最前；↝ 表示由邻居扩散点亮，非直接命中）');
+    }
     out.push('（只给摘要与成本；要看全文: abs db search <词> --full  或  abs resolve <页名>）');
-    if (project) {
+    if (project && !noRules) {
       out.push(`（铁律只显示本项目 "${project}" 的 —— 别的项目的铁律不外借）`);
     }
     return out.join('\n');