@fanchao8609/agent_brain_sync 1.5.4 → 1.5.5

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/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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.5.4",
+  "version": "1.5.5",
   "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;

package/src/install.js

@@ -310,15 +310,10 @@ const server = async ({ client, directory }) => {
     } catch {} // fire-and-forget: 永不阻塞宿主
   }
 
-  // 从 cwd 向上找最近含 .brain/ 的祖先目录
+  // 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）
   async function findBrain(cwd) {
-    let d = cwd || process.cwd()
-    for (;;) {
-      try { const st = await stat(join(d, ".brain")); if (st.isDirectory()) return join(d, ".brain") } catch {}
-      const up = dirname(d)
-      if (up === d) return null
-      d = up
-    }
+    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]'。
@@ -436,7 +431,7 @@ async function logHook(evt: string): Promise<void> {
 }
 
 // 会话结束时快照当前项目滞留任务到 wrapup.log（detached fire-and-forget，wrapup 自身幂等去重不刷屏）。
-// cwd 用事件 ctx.cwd（当前项目），让 abs 从该目录向上定位 .brain/。
+// cwd 用事件 ctx.cwd（当前项目），让 abs 在该目录定位 .brain/。
 function snapshotWrapup(cwd: string): void {
   try {
     const child = spawn(process.execPath, [ABS_BIN, "wrapup"], {
@@ -466,18 +461,10 @@ function hasWriteWork(toolResults: any[]): boolean {
   return false
 }
 
-/** 从 cwd 向上找最近含 .brain/ 的祖先目录。 */
+/** 定位当前项目的 .brain/：只看 cwd 本身，不向上搜索（防爬到家目录图谱）。 */
 async function findBrain(cwd: string): Promise<string | null> {
-  let d = cwd || process.cwd()
-  for (;;) {
-    try {
-      const st = await stat(join(d, ".brain"))
-      if (st.isDirectory()) return join(d, ".brain")
-    } catch {}
-    const up = dirname(d)
-    if (up === d) return null
-    d = up
-  }
+  const d = cwd || process.cwd()
+  try { const st = await stat(join(d, ".brain")); return st.isDirectory() ? join(d, ".brain") : null } catch { return null }
 }
 
 /**