@fanchao8609/agent_brain_sync 1.13.1 → 1.13.3

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

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.13.1",
+  "version": "1.13.3",
   "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/lint.js

@@ -170,11 +170,20 @@ function checkPage(pg, names, linkedNames, inbound) {
         `引用请用 [[${id}]] 或改回文件名)`);
     }
   }
-  for (const ln of pg.links) {
-    if (/^<.+>$/.test(ln) || /slug|Name|name|Date|页面名$/.test(ln)) {
-      issues.push(`TEMPLATE-LINK: ${pg.rel} -> [[${ln}]]`);
-    } else if (!names.has(ln)) {
-      issues.push(`DEAD-LINK: ${pg.rel} -> [[${ln}]]`);
+  // 链接检查
+  // ★ sessions/ 豁免 DEAD-LINK（2026-10-05 实测）：会话快照正文是「当时的笔记」，
+  //   里面的 `[[x]]` 常是在**谈这个记号本身**（如「缺 [[作者]] 这个标记」、
+  //   「剥掉 <id>/[[作者]] 记号」），不承担图谱链接职责；而 sessions 是不可改的历史，
+  //   改它就是改历史。→ 对快照报断链是规则错，不是数据脏。
+  //   注：sessions 的链接职责只体现在 `## 关联连接` 段，那段的断链仍值得管，
+  //   但对历史快照而言也已无法修正，故一并豁免。
+  if (pg.dir !== 'sessions') {
+    for (const ln of pg.links) {
+      if (/^<.+>$/.test(ln) || /slug|Name|name|Date|页面名$/.test(ln)) {
+        issues.push(`TEMPLATE-LINK: ${pg.rel} -> [[${ln}]]`);
+      } else if (!names.has(ln)) {
+        issues.push(`DEAD-LINK: ${pg.rel} -> [[${ln}]]`);
+      }
     }
   }
   const isTerminal = pg.dir === 'sources'
@@ -270,6 +279,11 @@ async function checkGraph(root, pages) {
   for (const pg of pages) {
     if (pg.status !== 'draft') continue;
     if (pg.dir === 'sources') continue;
+    // ★ sessions/ 也不参与（2026-10-05 实测误报）：会话快照是**历史事实记录**
+    //   （「那天发生什么」），不存在「是否仍然有效」—— 它永远不该被标 active，
+    //   标了反而是撒谎。对快照报「已 N 天停在 draft」是规则错，不是数据脏。
+    //   同理若未来加别的「存档型」目录（归档页等），也该在此豁免。
+    if (pg.dir === 'sessions') continue;
     let ageMs = 0;
     try { ageMs = Date.now() - (await fs.stat(join(root, pg.rel))).mtimeMs; } catch { continue; }
     if (ageMs > DRAFT_STALE_DAYS * 86400 * 1000) {