@fanchao8609/agent_brain_sync 1.14.1 → 1.15.2

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, cmdAutoTask, cmdAutoTaskSweep } from '../src/store.js';
+import { cmdInit, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdConcept, cmdShow, cmdRepair, cmdWrapup, cmdRule, cmdTeardownCheck, cmdTodoArchive, cmdResolve, cmdSupersede, cmdReview } 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,10 +92,6 @@ 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' },
@@ -284,6 +280,7 @@ const subUsage = {
     '用法:',
     '  abs todo                       看板',
     '  abs todo add <id> [--note "做什么"] [--section 讨论中|滞留中]',
+    '  abs todo rename <旧id> --note "<新id>"   给自动登记的占位条目起真名',
     '  abs todo note <id> --note "断点/进度"',
     '  abs todo state <id> --note 进行中|讨论中|滞留中',
     '  abs todo done <id> [--as 落地|否决|仅方案] [结语文字]',
@@ -351,6 +348,7 @@ const TODO_ACTIONS = {
   start: 'start', // add 的别名(老习惯保留)
   note: 'note',
   state: 'state', // 改行首状态标记：进行中|讨论中|滞留中（原地，不搬区）
+  rename: 'rename', // 改任务 id：hook 只开 auto-TBD-<会话> 占位，真名由此处补
   done: 'done',
 };
 
@@ -531,16 +529,7 @@ async function main() {
       // 内部命令（hook 专用，不出现在 help）：Stop 时机械快照未完成任务
       case 'wrapup': {
         rejectExtra(opts._, 'abs wrapup（内部命令, 供 hook 调用）');
-        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);   // 无事发生则静默（不制造空动作噪音）
+        console.log(await cmdWrapup({ dir: opts.dir }));
         break;
       }
       // Stop hook 用: 判定是否注入收尾指令。stdout 给 shell (`push:<json>` / `{}`), 无额外输出。

package/hooks/abs.pi.ts

@@ -44,19 +44,6 @@ function sessionIdFor(ctx: any): string {
   } 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」当判据，断点会被写在与任务无关的文件上。
  *
@@ -112,13 +99,6 @@ let pendingTodoTool = false
  *  只记第一次写文件，不是每次都记：断点是「记到哪」不是流水账。 */
 let autoTaskSeen = false
 
-/** 本会话最后被写到的文件（agent_end 落断点用）。
- *  只存文件名，不存内容 —— 断点是"记到哪"，不是快照。 */
-let lastTouchedFile = ''
-
-/** 最近一轮的用户指令原文。只用于「第一次真改文件时」抽任务关键词 ——
- *  登记时机已从 before_agent_start 挪到 tool_call（用户实报：一按回车就登记太早）。 */
-let pendingPrompt = ''
 
 /** 最近一次渲染拿到的 tui 引用。hidePanel 用它请求重绘 —— 面板消失时动画
  *  定时器已停，没有别的重绘通道（见 hidePanel 的坑注解）。 */
@@ -626,8 +606,6 @@ export default function absPiHook(pi: ExtensionAPI): void {
   pi.on("session_start", (event: any, ctx: any) => {
     // 新会话 = 重新登记：不重置则同进程的第二个会话永远不再落断点
     autoTaskSeen = false
-    lastTouchedFile = ''
-    pendingPrompt = ''
     resetThrottle()
     // 本会话的随机昵称 —— 在这里抽一次（不是每帧抽，否则面板会疯狂闪）。
     // 每次 session_start（startup/reload/new/resume/fork）重抽 → “每次打开 pi 都是随机的”。
@@ -665,21 +643,11 @@ export default function absPiHook(pi: ExtensionAPI): void {
     }
     // 自动登记断点（2026-10-05）：真的动文件时，把「改到哪个」记进本会话的自动任务。
     // 为何不用「第一次 tool_call」：排查类会话先跑一堆读命令，断点会落在无关文件上。
+    // 写类工具只留一行痕（可观测），不 spawn、不写看板 —— 见上面的删除说明。
     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)
-      // 首次真改文件 = "真开工了" → 此刻才登记（带用户指令抽关键词）+ 落断点。
-      // 这是唯一登记入口：光说/说问/讨论都不登记（2026-10-05 用户实报时机太早）。
-      if (sid) {
-        const args = ['--session', sid, '--note', bp]
-        if (pendingPrompt) args.push('--prompt', pendingPrompt)
-        spawnAutoTask(cwd, args)
-      }
-      logHook(`tool_call auto_task name=${name} sid=${sid || '-'}`).catch(() => {})
+      logHook(`tool_call first_write name=${name} sid=${sid || '-'}`).catch(() => {})
     }
   })
 
@@ -711,10 +679,11 @@ 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 用户实报时机太早）。
-        // 旧行为: 一按回车就登记 → 用户还在说/聊、需求没成型，看板上就已经开出了任务。
-        // 现在: 留到第一次真改文件时(tool_call)才登记，那时才算"真开工了"。
-        if (event?.prompt) pendingPrompt = String(event.prompt).slice(0, 200)
+        // 自动登记已整体移除（2026-10-05 用户实报两点）：
+        //   ① 卡顿 —— agent_end 每轮 spawn 一个 node 进程
+        //   ② 看板冒出大量 `auto-TBD-xxx — 待命名` 占位
+        // 结论: hook 只留【可观测痕迹】，不写看板、不起进程。登记回到 agent 主动调 abs task。
+        // 教训见 concept auto-todo-register-design 的"为什么最后删掉自动登记"一节。
       } catch (e: any) {
         logHook(`before_agent_start error=${e?.message || 'unknown'}`).catch(() => {})
       }
@@ -736,16 +705,9 @@ export default function absPiHook(pi: ExtensionAPI): void {
       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(() => {})
+    // 每轮 spawn 已删除（2026-10-05 用户实报"卡顿"）：agentEndSeen 一旦置位，
+    // 下面那个条件就恒真 → 每轮结束都起一个 node 进程，纯属白烧。
+    // 断点改由 agent 在用 abs_task 时自己写（那时它本来就在跑，不额外起进程）。
   })
 
   pi.on("session_shutdown", (_e: any, ctx: any) => {

package/package.json

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

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

@@ -116,6 +116,12 @@ abs rule [add "一句话"]           # 读写 ## Rules；abs lint 体检；abs t
 **硬规则（开工前触发器，别被状态表漏掉）：**
 
 1. **开工前先登记** —— 认领任何要动文件/跑命令的任务，**第一步是 `abs_task` action=start**，然后才读第一个文件。名字想不到就先起粗糙的（`fix-hook-nudge`）—— 名字可事后改，**未登记的开工补不回来**。
+   - **登记只能由你主动做**（hook 自动登记已在 v1.15.2 移除 —— 试过两版，用户实报
+     "卡顿 + 看板冒出大量 `auto-TBD-xxx 待命名`"：每轮 spawn 进程 + 占位直接写看板）。
+     结论：hook 只会"看到动过文件"，不知道"这是件什么事"；名字必须由读懂上下文的你起。
+   - 名字要像 `fix-skill-trigger` / `fix-opencode-v2-plugin` 那样说清**在干什么**，
+     不是抄用户的原话（实测抄出来的是 `我已经重启测试一下` 这种开场白）。
+   - 需要改已有任务的 id：`abs todo rename <旧id> --note "<新id>"`（描述同步换掉）。
 2. **一段活儿干完立刻 done** —— 不是等整个需求收尾。宁可拆成 5 条小的，别攒成 1 条大的。
 3. **动手超过两三轮还没登记 = 已在失控路上** —— 立刻补 `start`。
 

package/src/store.js

@@ -1120,6 +1120,31 @@ export async function cmdTask({ dir, action, id, section, note, as }) {
     });
     return `✓ 任务${r.updated ? '更新(幂等)' : '登记'} → ${brainPath(root, 'todo.md')}\n  [${st}] ${id} ${atTag(who)}${note ? ' — ' + note : ''}`;
   }
+  if (action === 'rename') {
+    // 给任务改名（2026-10-05）：hook 只开 `auto-TBD-<会话>` 占位，真名由理解任务的一方起
+    // （`fix-skill-trigger` 这种不是从用户字面抽出来的，是读懂在干什么之后起的）。
+    // --note 传新 id（沿用既有 CLI 习惯，免得再加一个 flag）。
+    if (!note) throw new Error('✗ 用法: abs todo rename <旧id> --note "<新id>"');
+    const newId = String(note).replace(/[\u200b\u200c\u200d\ufeff]/g, '').trim();
+    if (!newId || /\s/.test(newId)) throw new Error(`✗ 新 id 不能为空或含空白: "${newId}"`);
+    const f = brainPath(root, 'todo.md');
+    let done = false;
+    await editFile(f, (cur) => {
+      if (cur === null) return SKIP;
+      const lines = cur.split('\n');
+      const want = String(id).replace(/[\u200b\u200c\u200d\ufeff]/g, '');
+      for (let i = 0; i < lines.length; i++) {
+        if (idOfTaskLine(lines[i]) !== want) continue;
+        lines[i] = lines[i].replace(want, newId);
+        // 占位描述「待命名」随之换掉 —— 改完名还写着"待命名"会让人以为没改。
+        lines[i] = lines[i].replace(/—\s*待命名\s*/, `— ${newId.replace(/^(auto-|fix-|feat-)/, '')} `);
+        done = true;
+        break;
+      }
+      return done ? { text: lines.join('\n') } : SKIP;
+    });
+    return done ? `✓ 任务改名 ${id} → ${newId}` : `[NO_MATCH] 未找到含 "${id}" 的未完成任务行`;
+  }
   if (action === 'state') {
     // 改状态标记（原地，不搬区）：进行中 / 讨论中 / 滞留中
     if (!note) throw new Error(`✗ 用法: abs todo state <id> --note "${TASK_STATES.join('|')}"`);
@@ -1162,150 +1187,6 @@ 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;
-}
-
-/** 从断点文本提一个像样的 slug。
- *
- * 断点形如 `改了 src/store.js` / `本轮到 hooks/abs.pi.ts`；直接当 slug 会得到
- * `改了`（首词）这种废名。这里取【文件名】当 slug —— 「改了哪个文件」比「改了」有意义。
- */
-export function autoTaskSlugFromNote(note) {
-  const s = String(note || '').replace(/[\u200b\u200c\u200d\ufeff]/g, '');
-  // 文件路径优先（含 / 或 . 扩展名）
-  const m = s.match(/[\w./-]*[\w-]+\.[A-Za-z0-9]{1,8}/);
-  if (m) {
-    const base = m[0].split('/').pop().replace(/\.[A-Za-z0-9]{1,8}$/, '');
-    if (base && base.length >= 2) return `改 ${base}`;
-  }
-  // 退而求其次：抽到的关键词（可能为空）
-  return autoTaskId(s);
-}
-
-/** 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;
-  }
-
-  // 首次登记: 关键词优先从用户指令抽；抽不出（寒暄/提问/无指令）时用断点兜底。
-  //
-  // 为何 note 也能兜底（2026-10-05 时机改动后新增）：登记时机已挪到"第一次真改文件"，
-  // 那一刻【已经动过文件】就是最可靠的"这是件事"的证据 —— 此时因抽不出关键词而放弃，
-  // 等于用户寒暄两句后开始干活却什么都没记。用文件名当兜底 slug 比不登记有用。
-  // 兜底仅在【有断点】时启用 —— 断点的存在本身就意味着"刚动过文件"。
-  // 只有 prompt 而抽不出关键词（纯寒暄/提问、且没动文件）→ 依然不登记（用户实报的那个坑）。
-  const slug = autoTaskId(prompt) || (note ? autoTaskSlugFromNote(note) : null);
-  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');