@fanchao8609/agent_brain_sync 1.5.3 → 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.3",
+  "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 }
 }
 
 /**

package/src/store.js

@@ -347,12 +347,46 @@ function recentLogLines(text, n) {
     .join('\n');
 }
 
+/** 摘要收口：超过 n 码点在**语义边界**收尾（标点 → 空格 → 硬切），加省略号。
+ * 坑: 曾直接 `.slice(0, n)` 硬切 → log.md 34/85 条断在词中间(revert-c / file-write-lockin /
+ * ~/.cl​aude/ski), 文件名也被切成 ...-decision-blo。而 abs load 开机读的就是这份残句,
+ * 用户与后续会话看到的天然是半句 —— "摘要读起来抽象"的真因在写入口, 不在表述能力。 */
+export function clip(text, n) {
+  const s = String(text || '').trim();
+  if (s.length <= n) return s;
+  const head = s.slice(0, n);
+  // 优先在标点处断开（中文句读 + 英文句读），其次空格，最后才硬切
+  const cut = Math.max(
+    head.lastIndexOf('。'), head.lastIndexOf('；'), head.lastIndexOf('！'), head.lastIndexOf('？'),
+    head.lastIndexOf('，'), head.lastIndexOf('、'), head.lastIndexOf(';'), head.lastIndexOf(','),
+    head.lastIndexOf('.'), head.lastIndexOf(' '),
+  );
+  // 边界太靠前（< 一半）说明这一段本就是长句，宁可硬切也不留个残破的短头
+  const keep = cut > n / 2 ? cut : n;
+  return `${s.slice(0, keep).replace(/[\s,，、;；.。]+$/, '')}…`;
+}
+
+/** slug：取前 n 码点 → 非词字符折叠为 '-'。只用于**文件名**，完整标题另存 TITLE 行。
+ * 在标点/空格边界收口，不在字中间切断（否则出 `...-硬切-不` 这种残尾）。 */
+function slugOf(text, n = 24) {
+  const s = String(text || '').trim();
+  let head = s.slice(0, n);
+  if (s.length > n) {
+    const cut = Math.max(head.lastIndexOf('，'), head.lastIndexOf('。'), head.lastIndexOf('、'),
+      head.lastIndexOf('：'), head.lastIndexOf(','), head.lastIndexOf('.'), head.lastIndexOf(' '));
+    if (cut > n / 2) head = head.slice(0, cut);
+  }
+  return head.replace(/[^\w一-鿿]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase();
+}
+
 // ---------- log: 追加工作成果沉淀摘要（用户/AI 主动 abs log "..." 记, 不收工具动作流水） ----------
 export async function cmdLog({ dir, title, kind = 'dev' }) {
   const root = await requireBrain(dir || process.cwd());
   const p = brainPath(root, 'log.md');
   const stamp = localStamp();
-  const clean = String(title || '').replace(/\n/g, ' ').slice(0, 100); // 整行含前缀 ≤120
+  // 不硬切: log.md 是人类读的成果摘要, 也是 abs load 的开机入口。600 码点够一条完整小结,
+  // 超出才在语义边界收口（曾 slice(0,100) → 34/85 条断在词中间）
+  const clean = clip(String(title || '').replace(/\n/g, ' '), 600);
   const line = `## [${stamp}] ${kind} | ${clean}`;
   await editFile(p, (cur) => {
     const text = cur ?? '# 🗒 操作日志\n';
@@ -487,7 +521,7 @@ function firstHitLine(body, words) {
   for (const line of body.split('\n')) {
     const l = line.toLowerCase();
     if (words.some((w) => l.includes(w.toLowerCase())) && line.trim() && !KNOWN_SLUG_HINT.test(line)) {
-      return line.trim().slice(0, 100);
+      return clip(line.trim(), 160);
     }
   }
   return '';
@@ -517,8 +551,9 @@ export async function cmdNote({ dir, text, tags }) {
   }
   const tagList = String(tags || '').split(',').map((t) => t.trim()).filter(Boolean);
   const fmTags = ['source', ...tagList].join(', ');
-  const slugSrc = clean.slice(0, 24).replace(/[^\w一-鿿]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase();
+  const slugSrc = slugOf(clean);
   const file = `${today()}-${slugSrc || 'note'}.md`;
+  const heading = clip(clean, 80); // 页面标题: 完整优先, 超长才收口
   const body = [
     '---',
     `tags: [${fmTags}]`,
@@ -526,7 +561,9 @@ export async function cmdNote({ dir, text, tags }) {
     'status: draft',
     '---',
     '',
-    `# 来源：${clean.slice(0, 40)}`,
+    `# 来源：${heading}`,
+    '',
+    `TITLE: ${clean}`,
     '',
     `## 记录（实时暂存，Teardown 时提炼进 concepts/ 后本页可删）`,
     `- ${clean}`,
@@ -543,7 +580,7 @@ export async function cmdNote({ dir, text, tags }) {
   // index Sources 区登记（锁内幂等：别页已登记则跳过，防并发重复） + log 一行
   const iP = brainPath(root, 'index.md');
   const slug = file.replace(/\.md$/, '');
-  const line = `- [[${slug}]] — ${clean.slice(0, 40)}`;
+  const line = `- [[${slug}]] — ${heading}`;
   await editFile(iP, (index) => {
     if (!index || index.includes(`[[${slug}]]`)) return SKIP;
     const sIdx = index.indexOf('## Sources');
@@ -554,8 +591,8 @@ export async function cmdNote({ dir, text, tags }) {
       : index.slice(0, after) + `\n${line}` + index.slice(after);
     return { text: next };
   });
-  await cmdLog({ dir: root, title: clean.slice(0, 60), kind: 'note' });
-  return `✓ 经验暂存 → sources/${file}\n  ${clean.slice(0, 60)}`;
+  await cmdLog({ dir: root, title: clean, kind: 'note' });
+  return `✓ 经验暂存 → sources/${file}\n  ${clean}`;
 }
 // ---------- lint: 体检（与 scripts/lint.sh 同规则的 Node 版，供 CLI/MCP 直调） ----------
 export async function cmdLint({ dir }) {