@fanchao8609/agent_brain_sync 1.13.2 → 1.14.0

package/README.md

@@ -188,8 +188,12 @@ agent_brain_sync/
 ├── bin/mcp.js      MCP server (stdio)
 ├── src/index.js    图谱定位（只认当前目录的 .brain/）+ 全局技术日志目录
 ├── src/lock.js     并发写保护（原子锁 + 排队 + SKIP）
-├── src/todo.js     todo.md 分区读写
+├── src/todo.js     todo.md 分区读写 + 格式闸门
 ├── src/store.js    CLI 命令实现
+├── src/lint.js     图谱体检（死链/孤岛/超尺寸/堆积；同类问题折叠计数）
+├── src/query.js    检索知识页（多词 OR）
+├── src/relevant.js 相关页推荐（按"当前在干什么"挑该读的页）
+├── src/codegraph.js  借本机 CodeGraph 取"代码影响面"，写回图谱
 ├── src/hosts.js    四宿主接入定义
 ├── src/install.js  安装/卸载（分区共存合并）
 ├── src/userconfig.js  使用者姓名配置（作者标记；占位名如 tester/foo 会被拒）
@@ -197,7 +201,7 @@ agent_brain_sync/
 ├── hooks/event.sh  hook 模板
 ├── hooks/abs.pi.ts pi 扩展模板（含 todo 面板 / 随机昵称 / 常驻指引）
 ├── skill/<名称>/SKILL.md  技能（每个子目录 = 一个 skill，装到各智能体）
-└── test/           单测（400+，node:test）
+└── test/           单测（448，node:test，零外部测试依赖）
 ```
 
 MIT

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, cmdConcept, cmdShow, cmdRepair, cmdWrapup, cmdRule, cmdTeardownCheck, cmdTodoArchive, cmdResolve, cmdSupersede, cmdReview } from '../src/store.js';
+import { cmdInit, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdConcept, cmdShow, cmdRepair, cmdWrapup, cmdRule, cmdTeardownCheck, cmdTodoArchive, cmdResolve, cmdSupersede, cmdReview, cmdAutoTask, cmdAutoTaskSweep } from '../src/store.js';
 import { setUser, getUser, userConfigPath } from '../src/userconfig.js';
 import { runInstall, runUninstall } from '../src/install.js';
 import { readFileSync } from 'node:fs';
@@ -92,6 +92,10 @@ const FLAG_SPEC = {
   // ★ 漏声明就是真 bug（2026-10-05 本机实测）：不在 FLAG_SPEC 的选项会被静默丢掉，
   //   于是 `abs log "x" --kind note` 全写成默认的 dev，而 cmdLog 的枚举校验看不见它。
   'kind': { type: 'string' },
+  // auto-task 用（hook 调）：--session 作幂等键（一会话一条），--prompt 抽任务关键词。
+  // ★ 同上：不在这声明就会被 parseArgv 静默丢掉，登记变成"永远首次"、闸门形同虚设。
+  'session': { type: 'string' },
+  'prompt': { type: 'string' },
   'by': { type: 'string' },
   'all': { type: 'boolean' },
   'keep-days': { type: 'string' },
@@ -527,7 +531,16 @@ async function main() {
       // 内部命令（hook 专用，不出现在 help）：Stop 时机械快照未完成任务
       case 'wrapup': {
         rejectExtra(opts._, 'abs wrapup（内部命令, 供 hook 调用）');
-        console.log(await cmdWrapup({ dir: opts.dir }));
+        const r = await cmdWrapup({ dir: opts.dir });
+        // 收尾时顺带清理 hook 自动登记的条目（它们不代表人工接管的成果）
+        const swept = await cmdAutoTaskSweep({ dir: opts.dir }).catch(() => null);
+        console.log([r, swept].filter(Boolean).join('\n') || '（无滞留任务）');
+        break;
+      }
+      // hook 自动登记（pi/opencode 侧调）: 一会话一条，同会话只更新断点
+      case 'auto-task': {
+        const r = await cmdAutoTask({ dir: opts.dir, session: opts.session, prompt: opts.prompt, note: opts.note });
+        if (r) console.log(r);   // 无事发生则静默（不制造空动作噪音）
         break;
       }
       // Stop hook 用: 判定是否注入收尾指令。stdout 给 shell (`push:<json>` / `{}`), 无额外输出。

package/hooks/abs.opencode.ts

@@ -3,6 +3,10 @@
  * 纯触发: 生命周期事件 → 技术日志一行 (~/.abs/log/hooks.log, ABS_LOG_DIR 可覆盖)。fire-and-forget。
  * 纪律: hook 事件只进技术日志, 不进图谱 log.md (log.md 只收工作成果沉淀, 与 event.sh 同纪律)。
  * Op​encode 事件: session.created / session.idle / session.deleted (idle = 每轮结束, 对应 pi 的 agent_end)。
+ * Opencode v2 API: 默认导出 { id, setup }, setup(api) 里用 api.event.subscribe 订阅。
+ *   (v1 的 { id, server } + return { event } 在 v2 已移除, 会让插件加载失败报
+ *    "Plugin failed", 见 concept host-plugin-silent-failure。本文件与
+ *    ~/.config/opencode/plugins/abs.ts 必须同改, 否则下次 abs install 覆盖回去。)
  * 收尾注入已删除（2026-09-18）：曾用 session.idle + promptAsync 推一条收尾提醒, 用户实报
  *   「每次干活干一会就出来, 任务就中断了」。根因同 pi 侧: 主动往对话里插 turn = 打断,
  *   不是频率问题（2026-09-15 删登记注入时已得出同一结论）。保留 session.idle:seen 埋点。
@@ -10,32 +14,32 @@
 import { appendFile, mkdir, stat } from "node:fs/promises"
 import { homedir } from "node:os"
 import { join } from "node:path"
-const server = async ({ directory }) => {
+// 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）
+async function findBrain(cwd) {
+  const d = cwd || process.cwd()
+  try { const st = await stat(join(d, ".brain")); return st.isDirectory() ? join(d, ".brain") : null } catch { return null }
+}
+
+const setup = async (api) => {
   // 本会话首次 idle 是否已埋点
   let idleSeen = false
-  async function logHook(evt) {
-    try {
-      const dir = process.env.ABS_LOG_DIR || join(homedir(), ".abs", "log")
-      const d = new Date()
-      const pad = (n) => String(n).padStart(2, "0")
-      const stamp = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate()) + " " + pad(d.getHours()) + ":" + pad(d.getMinutes()) + ":" + pad(d.getSeconds())
-      await mkdir(dir, { recursive: true })
-      await appendFile(join(dir, "hooks.log"), "[" + stamp + "] opencode:" + evt + "\n")
-    } catch {} // fire-and-forget: 永不阻塞宿主
-  }
+    async function logHook(evt) {
+      try {
+        const dir = process.env.ABS_LOG_DIR || join(homedir(), ".abs", "log")
+        const d = new Date()
+        const pad = (n) => String(n).padStart(2, "0")
+        const stamp = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate()) + " " + pad(d.getHours()) + ":" + pad(d.getMinutes()) + ":" + pad(d.getSeconds())
+        await mkdir(dir, { recursive: true })
+        await appendFile(join(dir, "hooks.log"), "[" + stamp + "] opencode:" + evt + "\n")
+      } catch {} // fire-and-forget: 永不阻塞宿主
+    }
 
-  // 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）
-  async function findBrain(cwd) {
-    const d = cwd || process.cwd()
-    try { const st = await stat(join(d, ".brain")); return st.isDirectory() ? join(d, ".brain") : null } catch { return null }
-  }
-
-  // 收尾注入已停用（2026-09-18）：promptAsync 会在每轮 idle 抢一个 turn，用户实报
-  // 「每次干活干一会就出来, 任务就中断了」。wroteFiles / nudged / READONLY_CMD /
-  // tool.execute.after / loggedToday 随注入一起删除（注入没了，它们已无消费方）。
-  // 保留 session.idle:seen 埋点：区分「事件没触发」与「被守卫拦下」。
-  return {
-    event: async ({ event }) => {
+    // 收尾注入已停用（2026-09-18）：promptAsync 会在每轮 idle 抢一个 turn，用户实报
+    // 「每次干活干一会就出来, 任务就中断了」。wroteFiles / nudged / READONLY_CMD /
+    // tool.execute.after / loggedToday 随注入一起删除（注入没了，它们已无消费方）。
+    // 保留 session.idle:seen 埋点：区分「事件没触发」与「被守卫拦下」。
+  api.event.subscribe(async (event) => {
+    try {
       const type = event && event.type
       if (!type) return
       if (type === "session.created" || type === "session.deleted") {
@@ -49,19 +53,19 @@ const server = async ({ directory }) => {
         return
       }
       if (type !== "session.idle") return // idle = 每轮结束, 不记日志(太吵), 只做可观测性埋点
-      const cwd = directory || process.cwd()
+      const cwd = api.location?.directory || process.cwd()
       const brain = await findBrain(cwd)
       // 可观测性: 首次 idle 留一行痕(否则无法区分“事件没触发”与“被守卫拦下”)
       if (!idleSeen) {
         idleSeen = true
         await logHook(`session.idle:seen cwd=${cwd} brain=${brain || 'none'}`)
       }
-    },
-  }
+    } catch {} // 订阅回调抛错会污染宿主, 一律吞掉
+  })
 }
 
 export default {
   id: "abs",
-  server,
+  setup,
 }
 @@MARK@@

package/hooks/abs.pi.ts

@@ -18,7 +18,9 @@ import { homedir } from "node:os"
 import { join } from "node:path"
 import { spawn } from "node:child_process"
 
-const ABS_BIN = "@@ABS_BIN@@"
+// abs CLI 路径。安装时替换为 stableBinPath（全局优先），
+// 但允许 ABS_BIN_PATH 覆盖 —— 测试需隔离到沙盒副本，开发机也可能同时有多份。
+const ABS_BIN = process.env.ABS_BIN_PATH || "@@ABS_BIN@@"
 
 async function logHook(evt: string): Promise<void> {
   const dir = process.env.ABS_LOG_DIR || join(homedir(), ".abs", "log")
@@ -32,6 +34,51 @@ async function logHook(evt: string): Promise<void> {
 
 // 会话结束时快照当前项目滞留任务到 wrapup.log（detached fire-and-forget，wrapup 自身幂等去重不刷屏）。
 // cwd 用事件 ctx.cwd（当前项目），让 abs 在该目录定位 .brain/。
+
+/** 会话 id（作自动登记的幂等键，一会话一条）。取不到返回空串 —— 那时不登记，
+ *  因为空键会让每条指令都"首次"，看板被刷爆。 */
+function sessionIdFor(ctx: any): string {
+  try {
+    const id = ctx?.sessionManager?.getSessionId?.()
+    return String(id || '').replace(/[^\w-]/g, '').slice(0, 16)
+  } catch { return '' }
+}
+
+/** 调 abs auto-task（hook 自动登记）。detached fire-and-forget，不阻塞 turn。
+ *
+ * 为何走 spawn 而非 import：与 snapshotWrapup 同源 —— 扩展进程里不能阻塞用户 turn，
+ * 且 abs 的写入要经过它自己的文件锁（跨进程锁才有效）。 */
+function spawnAutoTask(cwd: string, args: string[]): void {
+  try {
+    const child = spawn(process.execPath, [ABS_BIN, "auto-task", ...args], {
+      cwd: cwd || process.cwd(), stdio: "ignore", detached: true,
+    })
+    child.unref()
+  } catch {} // fire-and-forget: 登记失败不得影响宿主
+}
+
+/** 会改文件的工具名。用于判定「真的开始干活了」—— 排查类会话先跑一堆读命令，
+ *  若用「第一次 tool_call」当判据，断点会被写在与任务无关的文件上。
+ *
+ * 为何含 bash：大量修改是经 bash 完成的（heredoc / sed -i / > 重定向），
+ * 漏掉它 = 纯 bash 会话永远不记断点（见 concept opencode-inject-channel-verdict
+ * 的同源教训：白名单必须按宿主实际用法穷举，漏一个就把功能静默关掉）。
+ */
+const WRITE_TOOL = /^(write|edit|apply_patch|patch|multiedit|notebookedit|bash|shell)$/i
+
+/** bash 命令里没有写入迹象则不算「干活」—— 否则 `ls`/`git status` 也会记断点。 */
+const BASH_WRITES = /(^|[^\w])(>|>>|sed\s+-i|tee\b|mkdir\b|rm\b|mv\b|cp\b|touch\b|cat\s*>)/
+
+/** 这次 tool_call 是否算「真的动了文件」。 */
+function isWriteCall(name: string, input: any): boolean {
+  if (!WRITE_TOOL.test(String(name || ''))) return false
+  // bash 要额外甄别：只有带写入操作的命令才算
+  if (/^(bash|shell)$/i.test(String(name || ''))) {
+    return BASH_WRITES.test(String(input?.command ?? ''))
+  }
+  return true
+}
+
 function snapshotWrapup(cwd: string): void {
   try {
     const child = spawn(process.execPath, [ABS_BIN, "wrapup"], {
@@ -61,6 +108,18 @@ let agentEndSeen = false
  * 同样在模块级，理由同上（闭包 flag 在重复注册时不共享）。 */
 let pendingTodoTool = false
 
+/** 本会话是否已记过自动任务断点。模块级（重复注册时闭包 flag 不共享 —— 同 agentEndSeen 的坑）。
+ *  只记第一次写文件，不是每次都记：断点是「记到哪」不是流水账。 */
+let autoTaskSeen = false
+
+/** 本会话最后被写到的文件（agent_end 落断点用）。
+ *  只存文件名，不存内容 —— 断点是"记到哪"，不是快照。 */
+let lastTouchedFile = ''
+
+/** 最近一次渲染拿到的 tui 引用。hidePanel 用它请求重绘 —— 面板消失时动画
+ *  定时器已停，没有别的重绘通道（见 hidePanel 的坑注解）。 */
+let lastTui: any = null
+
 /** 会话边界重置埋点状态。
  *  不重置 → 同进程第二个会话继承 true 永久不留痕（2026-09-13 实测过的坑）。 */
 function resetThrottle(): void {
@@ -502,15 +561,28 @@ export function renderPanelLines(
   if (data.hidden > 0) lines.push(clipToWidth(fg('dim', `  +${data.hidden} more`), width))
   return lines
 }
+/** 隐藏面板。**必须主动 requestRender** —— 否则数据清了、屏幕还留着旧画面。
+ *
+ * 坑(2026-10-05 用户实报): 任务全标完后面板不消失, 按 ESC 或重启才正常。
+ * 根因: 唯一的重绘入口是动画定时器里的 requestRender, 而"任务全完成"恰好让
+ *   needAnim=false → stopAnimTimer() → 从此没有任何人请求重绘 → 屏幕冻结在旧帧。
+ * 即"消失"这个动作本身把它自己的重绘通道关掉了。
+ * 故消失路径要自己 requestRender 一次。 */
+function hidePanel(ui: any): void {
+  try { ui.setWidget(PANEL_KEY, undefined) } catch {}
+  stopAnimTimer()
+  try { lastTui?.requestRender?.() } catch {}
+}
+
 async function refreshTodoPanel(ui: any, cwd: string): Promise<void> {
   if (String(process.env.ABS_TODO_PANEL || '') === '0') return
   if (!ui || typeof ui.setWidget !== 'function') return
   try {
-    if (!(await hasBrain(cwd))) { ui.setWidget(PANEL_KEY, undefined); stopAnimTimer(); return }
+    if (!(await hasBrain(cwd))) { hidePanel(ui); return }
     const md = await readFile(join(cwd, '.brain', 'todo.md'), 'utf8')
     const who = await currentUser()
     const data = parseOpenTasks(md, PANEL_MAX_ROWS, who)
-    if (data.total === 0) { ui.setWidget(PANEL_KEY, undefined); stopAnimTimer(); return }
+    if (data.total === 0) { hidePanel(ui); return }
     // factory 形式：render(width) 每帧拿真实宽度 → 按宽度截断，不再断字。
     // 动画：phase 存在模块级，render 时读当前值；定时器只在本帧重绘，不重建 widget。
     let tuiRef: any = null
@@ -518,6 +590,7 @@ async function refreshTodoPanel(ui: any, cwd: string): Promise<void> {
       PANEL_KEY,
       (tui: any, theme: any) => {
         tuiRef = tui
+        lastTui = tui   // 供 hidePanel 在"无动画"时也能请求重绘
         return {
           render: (width: number) =>
             renderPanelLines(
@@ -538,8 +611,7 @@ async function refreshTodoPanel(ui: any, cwd: string): Promise<void> {
     if (needAnim) startAnimTimer(() => tuiRef)
     else stopAnimTimer()
   } catch {
-    try { ui.setWidget(PANEL_KEY, undefined) } catch {}
-    stopAnimTimer()
+    hidePanel(ui)
   }
 }
 
@@ -548,6 +620,9 @@ export default function absPiHook(pi: ExtensionAPI): void {
   resetThrottle()
 
   pi.on("session_start", (event: any, ctx: any) => {
+    // 新会话 = 重新登记：不重置则同进程的第二个会话永远不再落断点
+    autoTaskSeen = false
+    lastTouchedFile = ''
     resetThrottle()
     // 本会话的随机昵称 —— 在这里抽一次（不是每帧抽，否则面板会疯狂闪）。
     // 每次 session_start（startup/reload/new/resume/fork）重抽 → “每次打开 pi 都是随机的”。
@@ -574,7 +649,7 @@ export default function absPiHook(pi: ExtensionAPI): void {
   // 故：tool_call 认出“刚才调的是 todo 工具”→ 置标记；tool_execution_end 看到标记就刷 → 清标记。
   // 始终保留 turn_end 兜底（实测每条 assistant 消息都触发，约 4 秒一次）。
   // 标记在模块级（重复注册时闭包 flag 不共享 —— 见 agentEndSeen 的注解）。
-  pi.on("tool_call", (event: any) => {
+  pi.on("tool_call", (event: any, ctx: any) => {
     const name = String(event?.toolName || '')
     const input = event?.input || {}
     // 两种形态：① MCP 代理入口 mcp__abs + input.tool=abs_task；② 直接工具名 abs_task
@@ -583,6 +658,18 @@ export default function absPiHook(pi: ExtensionAPI): void {
       pendingTodoTool = true
       logHook(`tool_call todo_tool name=${name} target=${target || '-'}`).catch(() => {})
     }
+    // 自动登记断点（2026-10-05）：真的动文件时，把「改到哪个」记进本会话的自动任务。
+    // 为何不用「第一次 tool_call」：排查类会话先跑一堆读命令，断点会落在无关文件上。
+    if (!autoTaskSeen && isWriteCall(name, input)) {
+      autoTaskSeen = true
+      const cwd = (ctx && ctx.cwd) || process.cwd()
+      const file = String(input?.path ?? input?.file_path ?? input?.filePath ?? '')
+      const bp = file ? `改了 ${file.slice(0, 120)}` : '开始改文件'
+      if (file) lastTouchedFile = file.slice(0, 120)
+      const sid = sessionIdFor(ctx)
+      if (sid) spawnAutoTask(cwd, ['--session', sid, '--note', bp])
+      logHook(`tool_call auto_task name=${name} sid=${sid || '-'}`).catch(() => {})
+    }
   })
 
   pi.on("tool_execution_end", (_event: any, ctx: any) => {
@@ -612,6 +699,15 @@ export default function absPiHook(pi: ExtensionAPI): void {
         }
         const ok = injectTodoGuidelines(event?.systemPromptOptions)
         logHook(`before_agent_start todo_guide=${ok ? 'on' : 'off'} cwd=${cwd}`).catch(() => {})
+
+        // 自动登记（2026-10-05）：有图谱 + 指令有实质内容 → 先把任务落到看板上。
+        // 抽不出关键词（"在吗"/"继续"）时 abs 侧会静默跳过 —— 宁可不登记也不脏看板。
+        // 一会话一条：同会话后续的 before_agent_start 会命中已有条目，只更新断点。
+        // ★ 位置必须在 no_brain 分支【之后】—— 放到里面等于"只有没图谱时才登记"，逻辑全反。
+        const sid = sessionIdFor(ctx)
+        if (sid && event?.prompt) {
+          spawnAutoTask(cwd, ['--session', sid, '--prompt', String(event.prompt).slice(0, 200)])
+        }
       } catch (e: any) {
         logHook(`before_agent_start error=${e?.message || 'unknown'}`).catch(() => {})
       }
@@ -626,11 +722,23 @@ export default function absPiHook(pi: ExtensionAPI): void {
   // 每项目弹，都还是在打断用户。故不再有 teardownNudged/inFlight/loggedToday 判据。
   // 只保留 agent_end:seen 埋点：区分「事件没触发」与「被守卫拦下」。
   pi.on("agent_end", async (_event: any, ctx: any) => {
-    if (agentEndSeen) return
-    agentEndSeen = true
     const cwd = (ctx && ctx.cwd) || process.cwd()
     const brain = await findBrain(cwd)
-    await logHook(`agent_end:seen cwd=${cwd} brain=${brain || 'none'}`).catch(() => {})
+    // 可观测性: 每会话首次留一行痕（区分"事件没触发"与"被守卫拦下"）。
+    if (!agentEndSeen) {
+      agentEndSeen = true
+      await logHook(`agent_end:seen cwd=${cwd} brain=${brain || 'none'}`).catch(() => {})
+    }
+    // 每轮结束落一次断点（2026-10-05）: 本会话若真动过文件, 把"干到哪"推进到最新。
+    // 为何只在动过文件后: 纯对话/查询轮不需要推进断点, 否则白 spawn 一堆进程。
+    // 为何不放在 session_shutdown: 那是进程退出, 而"一轮干完"才是自然的落盘点 ——
+    //   用户可能一直开着 pi 跨很多轮, 断点必须活着的时候就已经是最新的。
+    if (!brain || !autoTaskSeen) return
+    const sid = sessionIdFor(ctx)
+    if (!sid) return
+    const last = lastTouchedFile
+    spawnAutoTask(cwd, ['--session', sid, '--note', last ? `本轮到 ${last}` : '本轮有改动'])
+    logHook(`agent_end auto_task breakpoint sid=${sid}`).catch(() => {})
   })
 
   pi.on("session_shutdown", (_e: any, ctx: any) => {
@@ -640,4 +748,4 @@ export default function absPiHook(pi: ExtensionAPI): void {
   })
 }
 
-@@MARK@@
+@@MARK@@

package/package.json

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

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

@@ -1,6 +1,6 @@
 ---
 name: abs-agent-brain-sync
-description: abs (agent-brain-sync) 跨会话记忆与任务续接。适用于「开工续接状态」「沉淀会话收获」「任务登记不丢」「经验落成知识页」「图谱体检」等任务。
+description: "USE FOR abs / agent-brain-sync 跨会话记忆与任务续接。触发词：用户直接输入 abs（单独一个词，或 abs + 命令，如 'abs 开工'、'abs 沉淀'）；以及「开工续接状态」「沉淀会话收获」「任务登记不丢」「经验落成知识页」「图谱体检」等任务。"
 ---
 
 # abs — 跨会话记忆 (agent-brain-sync)
@@ -9,6 +9,8 @@ description: abs (agent-brain-sync) 跨会话记忆与任务续接。适用于
 
 **关键词不是触发器，意图才是。**句子里出现 abs 词（收尾/todo/沉淀/load/log/note）不等于要执行 abs 动作：谈论、提问、吐槽、定规则（"太啰嗦""这个设计怎样"）**只回应，不执行动作**；明确让我做事才执行。
 
+**例外（唯一）：用户直接输入 `abs`** —— 单独一个词、或 `abs` 后跟命令/意图（如 `abs`、`abs 开工`、`abs 沉淀`、`abs load`）。这是明确的"我要用 abs"，不算关键词误触发，**直接按 abs 流程执行**（无子命令时默认走开工续接）。
+
 - 拿不准时**先问**。规则变更（"以后简短点"）写入本文，不执行动作。
 - 输出简短：收尾/提示/todo 汇报一两句。本总则适用于所有工具。
 

package/src/store.js

@@ -1162,6 +1162,127 @@ export async function cmdTask({ dir, action, id, section, note, as }) {
   throw new Error(`unknown task action: ${action}`);
 }
 
+// ---------- 自动登记（hook 专用，2026-10-05） ----------
+// 背景: pi 的 promptGuidelines 常驻指引已注入(实检 414 次有痕), 但行为没变 ——
+//   指引假设 agent 已决定"要开一个任务", 而排查类工作没有清晰起点("我先看看怎么回事"
+//   看明白了活儿已经干完一半)。故改为 hook 侧自动登记, 不靠 agent 自觉。
+//
+// 粒度: **一会话一条**(幂等键 = 会话 id), 后续改动只更新断点 —— 不是一文件一条。
+//   否则一个会话改 20 个文件就塞 20 条, 看板被垃圾淹没(违"读取侧不得随规模增长")。
+const AUTO_TASK_PREFIX = 'auto-';
+
+/** 从用户指令抽任务关键词。抽不到返回 null —— 宁可不登记, 也不脏看板。
+ *
+ * 为何不抽不到就用机器 id: 看板是给人看的, `auto-c3f1` 认不出是什么;
+ * "在吗"/"继续"/"abs" 这类纯对话开头抽出的是噪声, 登了反而增加负担。
+ */
+export function autoTaskId(text) {
+  const s = String(text || '').replace(/[\u200b\u200c\u200d\ufeff]/g, '').trim();
+  if (!s) return null;
+  // 纯对话/寒暄不算指令
+  if (/^(在吗|在不在|你好|hi|hello|ok|好的|收到|继续|谢了|谢谢|abs|嗯|对|是的|行)[\s!！。.~]*$/i.test(s)) return null;
+  // 疑问句不算开工指令（2026-10-05 实报）: 用户问"为什么任务是这个啊"被登记成了任务 ——
+  //   提问/质疑/求助不是"让我动手"，登记它等于把用户的疑问变成待办，很荒唐。
+  //   判据用两档: ①句中有疑问词 ②句尾是问号（含全角）。
+  if (/[?？]\s*$/.test(s)) return null;
+  if (/(为什么|为啥|怎么会|怎么|如何|什么是|是什么|哪里|哪个|能不能|可不可以|是否|吗\s*[?？。!！]?$|呢\s*[?？。!！]?$)/.test(s)) return null;
+  // 取首个意群（标点/换行切）作为 id 来源
+  const head = s.split(/[\n。！？!?;；,，]/)[0].trim();
+  if (head.length < 4) return null;
+  // 中文取字，英文/数字取词；保留可读性，限长
+  const words = head.match(/[A-Za-z0-9_.-]+/g) || [];
+  const cjk = head.replace(/[A-Za-z0-9_.\-\s]+/g, '').slice(0, 12);
+  const slug = (words.length && cjk.length < 2 ? words.slice(0, 4).join('-') : cjk)
+    .replace(/[^\w\u4e00-\u9fa5-]/g, '')
+    .slice(0, 24);
+  return slug.length >= 2 ? slug : null;
+}
+
+/** hook 自动登记: 一会话一条 + 断点更新。
+ *
+ * @param {object} o
+ * @param {string} o.dir    项目目录
+ * @param {string} o.session 会话 id（幂等键）
+ * @param {string} o.prompt  用户指令原文（抽 id 用，仅首次需要）
+ * @param {string} o.note    断点内容（后续调用时更新到同一条）
+ * @returns {Promise<string|null>} 动作说明；无事发生返回 null
+ */
+export async function cmdAutoTask({ dir, session, prompt, note }) {
+  if (String(process.env.ABS_AUTO_TASK || '') === '0') return null;
+  const root = await requireBrain(dir || process.cwd());
+  const sid = String(session || '').replace(/[^\w-]/g, '').slice(0, 16);
+  if (!sid) return null;
+
+  // 幂等键藏在标记里而不是 id 里（2026-10-05 实报）: 原先 id = `auto-<会话uuid前16位>`,
+  //   用户看到 `auto-01a10b96-372d-71` 完全认不出是什么。id 是给人看的，改用关键词；
+  //   会话 id 退成机器用的隐藏键（`(自动登记 <sid>)`），sweep 靠它认领自动条目。
+  const MARK = `自动登记 ${sid}`;
+  const todoPath = brainPath(root, 'todo.md');
+
+  // 已登记过 → 只更新断点（一会话一条）
+  let existingId = null;
+  await editFile(todoPath, (cur) => {
+    if (cur === null) return SKIP;
+    for (const l of cur.split('\n')) {
+      const id = idOfTaskLine(l);
+      if (id && id.startsWith(AUTO_TASK_PREFIX) && l.includes(MARK)) { existingId = id; break; }
+    }
+    return SKIP;
+  });
+  if (existingId) {
+    if (!note) return null;
+    const r = await setBreakpoint(root, { id: existingId, text: note });
+    return r?.changed ? `↳ ${existingId} 断点更新` : null;
+  }
+
+  // 首次: 抽不出关键词就不登记
+  const slug = autoTaskId(prompt);
+  if (!slug) return null;
+  // id = 关键词（可读）；同 slug 已存在则加序号，避免两条不同活撞同一个 id。
+  let id = `${AUTO_TASK_PREFIX}${slug}`;
+  let n = 1;
+  await editFile(todoPath, (cur) => {
+    if (cur === null) return SKIP;
+    const ids = new Set(cur.split('\n').map((l) => idOfTaskLine(l)).filter(Boolean));
+    while (ids.has(id)) id = `${AUTO_TASK_PREFIX}${slug}-${++n}`;
+    return SKIP;
+  });
+  const who = await requireUser();
+  await ensurePersonPage(root, who);
+  await upsertTask(root, {
+    section: SEC.todo,
+    text: `[进行中] ${id} ${atTag(who)} — ${slug} (${MARK})`,
+  });
+  if (note) await setBreakpoint(root, { id, text: note });
+  return `✓ 自动登记 ${id} — ${slug}`;
+}
+
+/** 收尾: 把自动登记的未完成任务标 done（用户没显式接管它们）。
+ *  结语用【仅方案】—— 自动条目本身不代表"成果落地"，不该冒充【落地】。 */
+export async function cmdAutoTaskSweep({ dir }) {
+  const root = await requireBrain(dir || process.cwd());
+  const todoPath = brainPath(root, 'todo.md');
+  const ids = [];
+  await editFile(todoPath, (cur) => {
+    if (cur === null) return SKIP;
+    for (const l of cur.split('\n')) {
+      const id = idOfTaskLine(l);
+      // 自动条目的判据是「自动登记」标记, 不是 id 前缀 —— id 现在是给人看的关键词,
+      //   `auto-fix-panel` 这种名字人工也可能起得出来, 靠前缀认领会误杀真任务。
+      if (id && /自动登记\s+\S+/.test(l)) ids.push(id);
+    }
+    return SKIP;
+  });
+  let n = 0;
+  for (const id of ids) {
+    try {
+      await markDone(todoPath, id, '仅方案', '自动登记未接管，收尾清理');
+      n++;
+    } catch { /* 单条失败不阻塞其余 */ }
+  }
+  return n ? `✓ 自动任务收尾 ${n} 条` : null;
+}
+
 async function markDone(file, id, kind = '落地', conclusion) {
   const res = await editFile(file, (text) => {
     const lines = text.split('\n');