@fanchao8609/agent_brain_sync 1.5.4 → 1.5.6

package/README.md

@@ -3,7 +3,7 @@
 **跨会话 AI 编码记忆。** 让 AI 会话不再「重开就失忆」：任务进度、经验、踩坑都落盘到项目里的 markdown 图谱，下一个会话开机能直接读回来。
 
 - 图谱纯 markdown，放在项目根 `.brain/`，**可以进 git**，人和 AI 读同一份
-- 多项目自动隔离：从当前目录向上找最近的 `.brain/`
+- 多项目自动隔离：只在当前目录找 `.brain/`，不向上穿透
 - 并发安全：CLI / MCP / hook 同时写不会互相覆盖
 
 npm 包名 `@fanchao8609/agent_brain_sync`，全局命令 **`abs`**。
@@ -130,7 +130,7 @@ npm run pack:check # 预览 npm 发布产物
 agent_brain_sync/
 ├── bin/abs.js      CLI 入口
 ├── bin/mcp.js      MCP server (stdio)
-├── src/index.js    图谱定位（向上找最近 .brain/）
+├── src/index.js    图谱定位（只认当前目录的 .brain/）
 ├── src/lock.js     并发写保护（原子锁 + 排队 + SKIP）
 ├── src/brainio.js  统一读写收口
 ├── src/todo.js     todo.md 分区读写

package/bin/abs.js

@@ -69,8 +69,11 @@ function parseArgv(args) {
     else if (a === '--id') { o.id = args[++i]; }
     else if (a === '--section') { o.section = args[++i]; }
     else if (a === '--note') { o.note = args[++i]; }
+    else if (a === '--as') { o.as = args[++i]; }
     else if (a === '--payload') { o.payload = args[++i]; }
     else if (a === '--keep-days') { o.keepDays = args[++i]; }
+    else if (a === '--tags') { o.tags = args[++i]; }
+    else if (a === '--help') { o.help = true; }
     else if (a === '--dry-run') { o.dryRun = true; }
     else if (a === '--yes') { o.yes = true; }
     else if (a === '--repair') { o.repair = true; }
@@ -95,7 +98,9 @@ const usage = `abs — agent-brain-sync 记忆工具
   abs todo add     <id> [--note ..] [--section ..]  登记任务 (start 同义)
   abs todo note    <id> --note "断点/进度"   实时落 ↳ 断点 行
   abs todo blocked <id> --note "卡点原因"    移入 Blocked 区
-  abs todo done    <id>                      完成并归位 Done
+  abs todo done    <id> [--as 落地|否决|仅方案]    完成；结语标明到底"做成了没有"
+                               默认 落地。否决=评估后不做(含做了又撤)；仅方案=只设计过
+                               不加结语或结语失真会让下一个会话把"想过"当成"做完了"。
   abs log "完成 X：…"         记一行工作成果 (无参=查看)
   abs note "经验一句话" [--tags 坑,docker]    经验实时暂存 → sources/
 
@@ -115,6 +120,47 @@ const usage = `abs — agent-brain-sync 记忆工具
 注: abs wrapup / abs teardown-check 是 hook 内部命令, 不需手动调用。
 `;
 
+/** 子命令级用法（abs <cmd> --help 时打印）。 */
+const subUsage = {
+  install: [
+    'abs install — 把 MCP + hook + skill 安装到 AI 编码宿主',
+    '',
+    '用法:',
+    '  abs install [--agent <宿主>] [--yes] [--no-mcp] [--no-skill]',
+    '',
+    '参数:',
+    '  --agent <宿主>   只装一个宿主: claude-code | codex | opencode | pi',
+    '                   (不传则在 TTY 下交互多选; 非 TTY / --yes 时为全部)',
+    '  --yes            不交互，直接装全部宿主（自动化用）',
+    '  --no-mcp         不注册 MCP server',
+    '  --no-skill       不装 skill',
+    '',
+    '说明:',
+    '  • 幂等: 重复安装不会叠加，也不会覆盖宿主的其它配置',
+    '  • 配置文件解析失败时会中止（不会清空你的配置）',
+    '  • 安装前会备份原配置（同日多份保留最近 5 份）',
+    '',
+    '例:',
+    '  abs install                    交互选择',
+    '  abs install --yes              全部宿主',
+    '  abs install --agent pi --yes   只装 pi',
+  ].join('\n'),
+  uninstall: [
+    'abs uninstall — 从 AI 编码宿主移除 abs 的 MCP / hook / skill',
+    '',
+    '用法:',
+    '  abs uninstall [--agent <宿主>] [--yes]',
+    '',
+    '参数:',
+    '  --agent <宿主>   只卸一个宿主: claude-code | codex | opencode | pi（不传=全部）',
+    '  --yes            不交互',
+    '',
+    '说明:',
+    '  • 只删 abs 自己装的东西，保留你其它的 hook / MCP / 配置字段',
+    '  • 配置文件无法解析时会跳过该文件（不覆盖）但仍清理 abs 的脚本与 skill',
+  ].join('\n'),
+};
+
 /**
  * 拒绝多余的未知位置参数。
  * 坑: 以前只读命令(如 abs todo)会静默忽略多余词 —— `abs todo add x` 照样打印看板、
@@ -201,17 +247,29 @@ async function main() {
             `  登记任务: abs todo add <id> --note "做什么"`,
           );
         }
-        rejectExtra(rest2, `abs todo ${sub} <id>${action === 'done' ? '' : ' --note "…"'}`);
-        if (!id) throw new Error(`✗ 缺 <id>\n  用法: abs todo ${sub} <id>${action === 'done' ? '' : ' --note "…"'}`);
-        console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note: opts.note }));
+        rejectExtra(rest2, `abs todo ${sub} <id>${action === 'done' ? ' [--as 落地|否决|仅方案]' : ' --note "…"'}`);
+        if (!id) throw new Error(`✗ 缺 <id>\n  用法: abs todo ${sub} <id>${action === 'done' ? ' [--as 落地|否决|仅方案]' : ' --note "…"'}`);
+        console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note: opts.note, as: opts.as }));
         break;
       }
       case 'note': {
         console.log(await cmdNote({ dir: opts.dir, text: opts._.join(' '), tags: opts.tags }));
         break;
       }
-      case 'install':  await runInstall({ agent: opts.agent, mcp: opts.mcp !== false, skill: opts.skill !== false, yes: opts.yes }); break;
-      case 'uninstall': await runUninstall({ agent: opts.agent, yes: opts.yes }); break;
+      case 'install':
+      case 'uninstall': {
+        // 子命令级 --help: 打印用法后直接返回。
+        // 坑(INSTALL-HELP-FOOTGUN): 以前 --help 只在顶层命令被识别，跟在 install 后面时
+        // 落到 parseArgv 的通用分支，而 install 分支根本不读它 → 用户想看帮助，
+        // 实际执行了全量安装（幂等不炸，但确实改了四宿主配置，写了 15 个文件）。
+        if (opts.help) { console.log(subUsage[cmd]); break; }
+        if (cmd === 'install') {
+          await runInstall({ agent: opts.agent, mcp: opts.mcp !== false, skill: opts.skill !== false, yes: opts.yes });
+        } else {
+          await runUninstall({ agent: opts.agent, yes: opts.yes });
+        }
+        break;
+      }
       case 'agents':   console.log(installSummary()); break;
       case 'query': {
         console.log(await cmdQuery({ dir: opts.dir, terms: opts._ }));

package/bin/mcp.js

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
 // bin/mcp.js — abs MCP server (stdio)。
 // 职责只有两个（PLAN.md v2 定稿）:
-//   ① resolve_project: 用代码写死逻辑定位当前项目目录（从 cwd 向上找最近 .brain/）
+//   ① resolve_project: 用代码写死逻辑定位当前项目目录（只认 cwd 本身的 .brain/）
 //   ② 转接调用 CLI 读写（todo/board/query 的具体实现复用 src/）
 // 无状态：每次调用从入参 cwd 重新解析，多项目各归各位。
 import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
@@ -70,12 +70,12 @@ function tool(name, description, schema, handler) {
 // 工具面（narrow on purpose — 只暴露读/查/记状态，不做深提炼）
 tool(
   'abs_resolve_project',
-  '定位当前项目的 .brain 图谱根（从给定目录向上找最近 .brain/）。多项目隔离的唯一入口。',
-  { cwd: z.string().describe('当前工作目录，默认进程 cwd') },
+  '定位当前项目的 .brain 图谱根（只认给定目录本身的 .brain/，不向上搜索）。多项目隔离的唯一入口。',
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) {
-      return { content: [{ type: 'text', text: `未找到 .brain/（从 ${cwd} 向上无果）。先在该项目运行: abs init` }] };
+      return { content: [{ type: 'text', text: `未找到 .brain/（${cwd} 下没有，不向上搜索）。先在该目录运行: abs init` }] };
     }
     return { content: [{ type: 'text', text: root }] };
   }
@@ -84,7 +84,7 @@ tool(
 tool(
   'abs_board',
   '读取当前项目 todo 看板（含断点/Next-Step）。先 resolve 得到项目，再传其根目录。',
-  { cwd: z.string().describe('项目内任意目录') },
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');
@@ -95,7 +95,7 @@ tool(
 tool(
   'abs_load',
   '开机读状态：index 路线 + todo 看板 + 最近 log。跨会话续接的入口。',
-  { cwd: z.string().describe('项目内任意目录') },
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');
@@ -109,7 +109,7 @@ tool(
   {
     action: z.enum(['add', 'start', 'done', 'note', 'blocked']),
     id: z.string().describe('任务幂等键，如 TASK-xxx 或子任务名'),
-    cwd: z.string().describe('项目内任意目录'),
+    cwd: z.string().describe('项目根目录（.brain/ 所在处）'),
     note: z.string().optional().describe('add/start=做什么; note=断点(文件/到哪步); blocked=卡点原因'),
   },
   async ({ action, id, cwd, note }) => {
@@ -124,7 +124,7 @@ tool(
 tool(
   'abs_status',
   '当前项目 + 图谱概要（各类页数）。',
-  { cwd: z.string().describe('项目内任意目录') },
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');
@@ -135,7 +135,7 @@ tool(
 tool(
   'abs_query',
   '检索当前项目 .brain/ 知识页（多词 OR）：以前踩过什么坑、哪页记了 X。',
-  { cwd: z.string().describe('项目内任意目录'), terms: z.array(z.string()).min(1).describe('检索词') },
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）'), terms: z.array(z.string()).min(1).describe('检索词') },
   async ({ cwd, terms }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');
@@ -146,7 +146,7 @@ tool(
 tool(
   'abs_lint',
   '图谱体检：死链/孤岛/缺 frontmatter/超尺寸/sources 堆积/index 漏列。',
-  { cwd: z.string().describe('项目内任意目录') },
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');
@@ -158,7 +158,7 @@ tool(
   'abs_note',
   '经验实时暂存：把刚踩的坑/技巧/结论一句话落进 sources/（防 context 断了流失）。Teardown 时再提炼进 concepts/。',
   {
-    cwd: z.string().describe('项目内任意目录'),
+    cwd: z.string().describe('项目根目录（.brain/ 所在处）'),
     text: z.string().min(1).describe('经验/坑/技巧一句话'),
     tags: z.string().optional().describe('逗号分隔标签，如 "docker,坑"'),
   },
@@ -172,7 +172,7 @@ tool(
 tool(
   'abs_wrapup',
   '收尾保险：把当前 todo 未完成任务快照到 ~/.abs/log/wrapup.log（下会话 load 时展示滞留对账）。',
-  { cwd: z.string().describe('项目内任意目录') },
+  { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');

package/hooks/abs.opencode.ts

@@ -0,0 +1,113 @@
+/**
+ * abs (agent-brain-sync) — Op​encode plugin。
+ * 纯触发: 生命周期事件 → 技术日志一行 (~/.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)。
+ * 收尾注入: session.idle 且本会话真改过文件 + .brain 今日无记录 → promptAsync 推 agent 走收尾循环。
+ */
+import { appendFile, mkdir, readFile, stat } from "node:fs/promises"
+import { homedir } from "node:os"
+import { join, dirname } from "node:path"
+
+const server = async ({ client, directory }) => {
+  // 本会话是否真改过文件 (由 tool.execute.after 观测)
+  let wroteFiles = false
+  let nudged = false
+  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: 永不阻塞宿主
+  }
+
+  // 定位当前项目的 .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 }
+  }
+
+  // 判定"今天是否收尾过": 必须匹配 log.md 的条目头 '## [YYYY-MM-DD HH:MM]'。
+  // 坑: 曾用裸日期 substring(includes('2026-09-10')), 结果正文/任务行里任何一处
+  //     提到今天就能把 nudge 永久压掉(误判为已收尾), 守卫形同虚设。
+  async function loggedToday(brain) {
+    try {
+      const txt = await readFile(join(brain, "log.md"), "utf8")
+      const d = new Date()
+      const pad = (n) => String(n).padStart(2, "0")
+      const today = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate())
+      return new RegExp("^## \\[" + today + " \\d{2}:\\d{2}\\]", "m").test(txt)
+    } catch { return false }
+  }
+
+  const TEARDOWN_MSG =
+    "[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：\n" +
+    "1) 跑 abs load 看 Today 还有哪些未完成；\n" +
+    "2) 实际做完漏登记的 abs todo done <id>，做到一半的 abs todo note <id> --note \"断点\"；\n" +
+    "3) 值得留的经验 abs note \"...\"（宁少勿滥，能从代码 grep 到的不记）；\n" +
+    "4) abs log \"完成 X：...\" 记一行工作成果，新页同步进 index。\n" +
+    "简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句\"无可沉淀\"即可。"
+
+  // bash 里只跑查询类命令不算改文件 (与 pi 侧 READONLY_CMD 同义, 但生成代码里要写进模板串)
+  const READONLY_CMD = /^\s*(ls|cat|grep|rg|find|head|tail|wc|git\s+(status|log|diff|show|branch)|pwd|which|echo|node\s+-v|npm\s+(ls|view)|curl)\b/
+
+  return {
+    // 观测真实写操作: write/edit/patch 类工具成功即标记。
+    // 坑: 曾漏掉 bash —— op​encode 里很多修改是经 bash(heredoc/sed) 完成的, 纯 bash 会话
+    //     永远不置位 wroteFiles, 于是收尾提醒静默不发。与 pi 侧 WRITE_TOOLS 保持一致。
+    "tool.execute.after": async ({ tool, args }) => {
+      const t = String(tool || "").toLowerCase()
+      if (["write", "edit", "patch", "multiedit", "apply_patch"].includes(t)) {
+        wroteFiles = true
+        return
+      }
+      // bash 里只有非只读命令算改文件(ls/cat/git status 之类不算)
+      if (t === "bash") {
+        const cmd = String((args && (args.command || args.cmd)) || "")
+        if (cmd && !READONLY_CMD.test(cmd)) wroteFiles = true
+      }
+    },
+
+    event: async ({ event }) => {
+      const type = event && event.type
+      if (!type) return
+      if (type === "session.created" || type === "session.deleted") {
+        await logHook(type)
+        return
+      }
+      if (type !== "session.idle") return // idle = 每轮结束, 不记日志(太吵), 只做收尾判定
+      const cwd = directory || process.cwd()
+      const brain = await findBrain(cwd)
+      // 可观测性: 首次 idle 无条件留一行痕(否则无法区分“事件没触发”与“被守卫拦下”)
+      if (!idleSeen) {
+        idleSeen = true
+        await logHook(`session.idle:seen cwd=${cwd} brain=${brain || 'none'}`)
+      }
+      if (nudged || !wroteFiles) return
+      const sessionID = event.properties && event.properties.sessionID
+      if (!sessionID) return
+      if (!brain) return // 无图谱=不在这项目沉淀, 不打扰
+      if (await loggedToday(brain)) return // 今天已收尾过
+      nudged = true
+      await logHook("session.idle:teardown-nudge")
+      try {
+        await client.session.promptAsync({
+          path: { id: sessionID },
+          query: { directory: cwd },
+          body: { parts: [{ type: "text", text: TEARDOWN_MSG }] },
+        })
+      } catch {} // 注入失败不阻塞宿主
+    },
+  }
+}
+
+export default {
+  id: "abs",
+  server,
+}
+@@MARK@@

package/hooks/abs.pi.ts

@@ -0,0 +1,130 @@
+/**
+ * abs (agent-brain-sync) — Pi extension。
+ * 纯触发: 会话生命周期事件 → 技术日志一行 (~/.abs/log/hooks.log, ABS_LOG_DIR 可覆盖)。fire-and-forget。
+ * 纪律: hook 事件只进技术日志, 不进图谱 log.md (log.md 只收工作成果沉淀, 与 event.sh 同纪律)。
+ * Pi 事件: session_start / session_shutdown (对应 host hook 的 SessionStart/SessionEnd)。
+ * session_shutdown 额外触发 abs wrapup: 把当前项目未完成任务快照到 wrapup.log (跨会话收尾保险)。
+ * agent_end 收尾注入: 本会话真改过文件 + .brain 今日无记录 → 注入一条收尾指令, 逼 agent 走收尾循环
+ *   (被动记日志不够 —— 没人提醒就不会有人收尾)。每会话最多一次, 且已收尾后不再打扰。
+ */
+import type { ExtensionAPI } from "@earendil-works/pi-coding-agent"
+import { appendFile, mkdir, readFile, stat } from "node:fs/promises"
+import { homedir } from "node:os"
+import { join, dirname } from "node:path"
+import { spawn } from "node:child_process"
+
+const ABS_BIN = "@@ABS_BIN@@"
+
+async function logHook(evt: string): Promise<void> {
+  const dir = process.env.ABS_LOG_DIR || join(homedir(), ".abs", "log")
+  const d = new Date()
+  const pad = (n: number) => 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())
+  const line = "[" + stamp + "] pi:" + evt + "\n"
+  await mkdir(dir, { recursive: true })
+  await appendFile(join(dir, "hooks.log"), line)
+}
+
+// 会话结束时快照当前项目滞留任务到 wrapup.log（detached fire-and-forget，wrapup 自身幂等去重不刷屏）。
+// cwd 用事件 ctx.cwd（当前项目），让 abs 在该目录定位 .brain/。
+function snapshotWrapup(cwd: string): void {
+  try {
+    const child = spawn(process.execPath, [ABS_BIN, "wrapup"], {
+      cwd: cwd || process.cwd(), stdio: "ignore", detached: true,
+    })
+    child.unref()
+  } catch {} // fire-and-forget
+}
+
+// ---- 收尾注入判定 ----
+// 真改过文件的工具（read/grep/ls 不算, 那些不产生可沉淀的产出）
+const WRITE_TOOLS = new Set(["write", "edit", "multi_edit", "apply_patch", "bash"])
+// bash 里只跑查询类命令不算改文件
+const READONLY_CMD = /^\s*(ls|cat|grep|rg|find|head|tail|wc|git\s+(status|log|diff|show|branch)|pwd|which|echo|node\s+-v|npm\s+(ls|view)|curl)\b/
+
+function hasWriteWork(toolResults: any[]): boolean {
+  for (const r of toolResults || []) {
+    const name = String(r?.toolName || "")
+    if (!WRITE_TOOLS.has(name)) continue
+    if (r?.isError) continue
+    if (name === "bash") {
+      const cmd = String(r?.input?.command ?? r?.args?.command ?? "")
+      if (READONLY_CMD.test(cmd)) continue
+    }
+    return true
+  }
+  return false
+}
+
+/** 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）。 */
+async function findBrain(cwd: string): Promise<string | null> {
+  const d = cwd || process.cwd()
+  try { const st = await stat(join(d, ".brain")); return st.isDirectory() ? join(d, ".brain") : null } catch { return null }
+}
+
+/**
+ * .brain/log.md 今天有记录吗? 有=已收尾, 不再打扰。
+ * 必须匹配条目头 '## [YYYY-MM-DD HH:MM]' —— 裸日期 substring 会被正文里任意一处
+ * 今天的日期误命中, 导致"已收尾"误判、nudge 永不触发。
+ */
+async function loggedToday(brain: string): Promise<boolean> {
+  try {
+    const txt = await readFile(join(brain, "log.md"), "utf8")
+    const d = new Date()
+    const pad = (n: number) => String(n).padStart(2, "0")
+    const today = d.getFullYear() + "-" + pad(d.getMonth() + 1) + "-" + pad(d.getDate())
+    // 注意: 这里是真实 TS, 不是生成代码的模板字符串。用拼接形式避免反斜杠逃逸歧义。
+    return new RegExp("^## \\[" + today + " \\d{2}:\\d{2}\\]", "m").test(txt)
+  } catch { return false }
+}
+
+export default function absPiHook(pi: ExtensionAPI): void {
+  pi.on("session_start", () => logHook("session_start").catch(() => {}))
+
+  // 收尾注入: 每个会话最多一次, 避免反复打扰。
+  let teardownNudged = false
+  let agentEndSeen = false
+  pi.on("agent_end", async (event: any, ctx: any) => {
+    if (teardownNudged) return
+    const cwd = (ctx && ctx.cwd) || process.cwd()
+    const brain = await findBrain(cwd)
+    // 可观测性: 本会话首次 agent_end 无条件留一行痕。
+    // 没有它就无法区分三种状态: ①事件没触发 ②触发了但被守卫拦下 ③真注入了。
+    if (!agentEndSeen) {
+      agentEndSeen = true
+      // 带上 cwd 与命中的 brain —— 否则事后无法解释“为何这条 nudge 会出现”
+      await logHook(`agent_end:seen cwd=${cwd} brain=${brain || 'none'}`).catch(() => {})
+    }
+    if (!brain) return // 无图谱=不在这项目沉淀, 不打扰
+    if (!hasWriteWork(event?.messages ? collectToolResults(event.messages) : [])) return
+    if (await loggedToday(brain)) return // 今天已收尾过
+    teardownNudged = true
+    await logHook("agent_end:teardown-nudge").catch(() => {})
+    try {
+      pi.sendUserMessage(
+        "[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：\n" +
+        "1) 跑 abs load 看 Today 还有哪些未完成；\n" +
+        "2) 实际做完漏登记的 abs todo done <id>，做到一半的 abs todo note <id> --note \"断点\"；\n" +
+        "3) 值得留的经验 abs note \"...\"（宁少勿滥，能从代码 grep 到的不记）；\n" +
+        "4) abs log \"完成 X：...\" 记一行工作成果，新页同步进 index。\n" +
+        "简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句\"无可沉淀\"即可。",
+        { deliverAs: "followUp" },
+      )
+    } catch {}
+  })
+
+  pi.on("session_shutdown", (_e: any, ctx: any) => {
+    snapshotWrapup((ctx && ctx.cwd) || process.cwd())
+    logHook("session_shutdown").catch(() => {})
+  })
+}
+
+/** agent_end 的 event.messages 里翻出 toolResult 消息。 */
+function collectToolResults(messages: any[]): any[] {
+  const out: any[] = []
+  for (const m of messages || []) {
+    if (m && m.role === "toolResult") out.push(m)
+  }
+  return out
+}
+@@MARK@@

package/package.json

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

package/skill/SKILL.md

@@ -16,7 +16,9 @@ Obsidian 可直接打开的 Markdown 图谱（`.brain/`）做统一落点。
 技能被触发（用户问话、开新会话、或说 `abs ...`）时，**第一步永远是下面这条链**，
 然后再看用户真正要什么：
 
-1. **找图谱**：从当前目录向上到最近含 `.brain/` 的祖先目录即命中（一个项目一个 `.brain/`）。
+1. **找图谱**：只看**当前目录**是否含 `.brain/`（一个项目一个 `.brain/`）。
+   **不向上搜索**：向上爬会从子目录甚至 vault 一路命中家目录 `~/.brain` 的无关图谱，
+   静默把项目挂错地方。所以必须 cd 到项目根再跑，子目录不会自动归属。
 2. **没有？按意图决定建档与否**：
    - 用户意图是**沉淀**（收尾/「把这次记下来」）或**即将开工的长期任务**（会跨会话，
      用词如「帮我做 X / 开工 / 继续开发 / 修 X」）→ **先建档**：`abs init`。别在没图谱时就开写。
@@ -59,11 +61,14 @@ Obsidian 可直接打开的 Markdown 图谱（`.brain/`）做统一落点。
 ## 图谱定位（一个项目一个 `.brain/`，abs 自动定位不用手工指定路径）
 
 `.brain/` 放项目根，一个项目只建一份。所有 `abs` 命令（`abs load/todo/note/task/query/lint...`）
-**自动从当前目录向上找最近含 `.brain/` 的祖先目录即命中**——你在项目内任何子目录跑都行，
-不用传路径。多项目各自独立，abs 按你所在目录归属。
+**只认当前目录的 `.brain/`**——必须在项目根目录（即 `.brain/` 所在处）运行，
+不用传路径。
 
-monorepo 若多个子包各自独立交付，可各建一份 `.brain/`；横向规律放最上层图谱 syntheses/。
-`abs status` 显示当前定位到哪个项目。
+**不在子目录自动归属，也不向上搜索**。原因是上爬会命中家目录 `~/.brain`
+（vault / 临时目录 / 任意路径都可能爬到），把无关项目静默挂到别人图谱上。
+宁可报错也不猜。多项目各自独立，各自 `cd` 到自己的根再跑。
+
+monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs status` 显示当前定位到哪个项目。
 
 ## 图谱长什么样（都在 `.brain/` 下）
 

package/src/index.js

@@ -1,23 +1,23 @@
 // src/index.js — 图谱定位：多项目隔离的核心。
-// 从给定 cwd 向上找最近含 `.brain/` 的祖先目录即命中。
+// 只看给定目录本身有没有 `.brain/`，不向上搜索。
 // 这是唯一"项目定位"逻辑，被 CLI / MCP / hook 共用，代码确定、不靠猜。
 import { promises as fs } from 'node:fs';
-import { join, dirname, resolve, basename } from 'node:path';
+import { join, resolve, basename } from 'node:path';
 
 export const BRAIN_DIR = '.brain';
 
-/** 向上找最近含 .brain/ 的祖先目录。找不到返回 null。 */
+/**
+ * 定位图谱根：仅当 `dir` 本身含 `.brain/` 才命中，否则返回 null。
+ * 故意不向上搜索：向上会从任意目录爬到 ~ 命中家目录图谱（如 ~/.brain），
+ * 把无关项目静默挂到别的图谱上。宁可报错，不猜。
+ */
 export async function findBrainRoot(startDir) {
-  let dir = resolve(startDir || process.cwd());
-  for (;;) {
-    try {
-      const st = await fs.stat(join(dir, BRAIN_DIR));
-      if (st.isDirectory()) return dir;
-    } catch { /* not here, keep walking up */ }
-    const parent = dirname(dir);
-    if (parent === dir) return null; // reached filesystem root
-    dir = parent;
-  }
+  const dir = resolve(startDir || process.cwd());
+  try {
+    const st = await fs.stat(join(dir, BRAIN_DIR));
+    if (st.isDirectory()) return dir;
+  } catch { /* 本目录没有图谱 */ }
+  return null;
 }
 
 /** 解析图谱内文件的绝对路径。brainRoot 须已定位。 */
@@ -30,8 +30,8 @@ export async function requireBrain(startDir) {
   const root = await findBrainRoot(startDir);
   if (!root) {
     throw new Error(
-      `abs: 找不到 .brain/ 图谱（从 ${resolve(startDir)} 向上搜索无果）。\n` +
-      `  请在项目根先运行: abs init`
+      `abs: 目录 ${resolve(startDir)} 下没有 .brain/ 图谱（不向上搜索）。\n` +
+      `  请在该目录运行: abs init`
     );
   }
   return root;