@fanchao8609/agent_brain_sync 1.5.8 → 1.6.1

package/bin/abs.js

@@ -3,6 +3,7 @@
 // abs <cmd> [args]
 // 命令: init / board / status / load / task / install / uninstall / help
 import { cmdInit, cmdStatus, cmdLoad, cmdTask, cmdLog, cmdQuery, cmdLint, cmdNote, cmdShow, cmdRepair, cmdWrapup, cmdTeardownCheck, cmdTodoArchive } from '../src/store.js';
+import { setUser, getUser, userConfigPath } from '../src/userconfig.js';
 import { runInstall, runUninstall } from '../src/install.js';
 import { readFileSync } from 'node:fs';
 import { join, dirname, resolve } from 'node:path';
@@ -159,6 +160,10 @@ const usage = `abs — agent-brain-sync 记忆工具
                             归档 Done 区旧日期组 → sessions/<日期>-todo归档.md
                             (默认保留近 3 天; 任一天有未完成则整天不归档)
   abs lint                   图谱体检 (死链/孤岛/超尺寸/堆积)
+  abs config [show]          查看使用者姓名 (标记作者用)
+  abs config set user <名字> 设置使用者姓名 → ~/.abs/config.json
+                             未设置时写操作(todo/log/note)会报错要求先设置
+                             临时覆盖: ABS_USER=<名字> abs ...
   abs init [--repair]        建 .brain/ 图谱; 结构不完整时报明细, --repair 只补缺不覆盖
   abs install [--agent <宿主>]   安装 MCP+hook+skill (宿主: claude-code/codex/opencode/pi)
   abs uninstall [--agent <...>]  卸载
@@ -238,6 +243,28 @@ const TODO_ACTIONS = {
   done: 'done',
 };
 
+/** abs config —— 读/写用户设置（目前只有 user）。 */
+async function cmdConfig({ sub, value }) {
+  const p = userConfigPath();
+  if (!sub || sub === 'show' || sub === 'get') {
+    const u = await getUser();
+    return u
+      ? `user = ${u}\n  (来源: ${process.env.ABS_USER ? 'ABS_USER 环境变量' : p})`
+      : `user 未设置\n  设置: abs config set user <你的名字>\n  (或临时: ABS_USER=<名字> abs ...)`;
+  }
+  if (sub === 'set') {
+    const [key, ...rest] = String(value || '').split(/\s+/).filter(Boolean);
+    if (key !== 'user') throw new Error(`✗ abs config set 目前只支持 user\n  用法: abs config set user <你的名字>`);
+    // 名字含空格时不该静默只取第一个词（会被 setUser 的字符校验拒）。
+    // 拼接后交给 setUser 统一判定，报错文案里能看到完整输入。
+    const name = rest.join(' ');
+    if (rest.length > 1) throw new Error(`✗ 姓名不能含空格（收到 "${name}"）\n  @标记无法解析带空格的姓名`);
+    const u = await setUser(name);
+    return `✓ user = ${u}\n  → ${p}`;
+  }
+  throw new Error(`✗ 未知子命令 "${sub}"\n  用法: abs config [show] / abs config set user <名字>`);
+}
+
 async function main() {
   try {
     const opts = parseArgv(rest);
@@ -319,6 +346,10 @@ async function main() {
         }
         break;
       }
+      case 'config': {
+        console.log(await cmdConfig({ sub: opts._[0], value: opts._.slice(1).join(' ') }));
+        break;
+      }
       case 'query': {
         console.log(await cmdQuery({ dir: opts.dir, terms: opts._ }));
         break;

package/package.json

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

package/skill/SKILL.md

@@ -58,6 +58,29 @@ Obsidian 可直接打开的 Markdown 图谱（`.brain/`）做统一落点。
 > 为什么：方案先过目能省掉整轮返工；登记让跨会话可续；"问开工"把决定权留在用户手里。
 > **这不是拖延** —— 总结方案本身就是工作，做完再问。
 
+## 使用者姓名（作者标记）
+
+图谱需要知道「谁登记的」。写操作（`todo add/note/blocked/done`、`log`、`note`）会检查：
+**未设置姓名则报错并给设置命令**，不默默落盘无名条目。
+
+```bash
+abs config set user <你的名字>     # 写入 ~/.abs/config.json，一次即可
+abs config                        # 查看当前姓名
+ABS_USER=<名字> abs todo add ...   # 临时覆盖（CI/多身份），不改落盘配置
+```
+
+设置后自动标记：
+- `todo.md`：`- [ ] TASK-ID @fanchao — 说明 (认领 2026-09-12)`（作者紧跟 id，扫板先看到人）
+- `log.md`：`## [2026-09-12 13:17] @fanchao dev | 完成 X`（作者前置于 kind）
+- `sources/`：frontmatter `author: fanchao`
+
+**只读命令不检查**（`load`/`todo`/`status`/`lint`/`query`/`index`/`log` 无参）——
+hook 在会话结束时非交互调 `abs wrapup`/`abs teardown-check`，那儿拦人会卡断收尾。
+
+> `index.md` **不加**作者：index 行是覆盖式更新的，作者会从"创建者"漂成"最后改的人"，
+> 语义不固定。要查谁写的，看该页自己的 `author`。
+> 历史条目**不回填**（原文/现场已不在，回填等于编造）。
+
 ## 图谱定位（一个项目一个 `.brain/`，abs 自动定位不用手工指定路径）
 
 `.brain/` 放项目根，一个项目只建一份。所有 `abs` 命令（`abs load/todo/note/task/query/lint...`）
@@ -204,11 +227,12 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
 
 ## 知识页格式（concepts/entities/syntheses）
 
-所有页统一 frontmatter 三项：`tags / updated / status`（无额外字段）。
+所有页统一 frontmatter：`tags / author / updated / status`。
 
 ```markdown
 ---
 tags: [concept, 领域]   # 首标签 ∈ entity|concept|source|synthesis|session-log
+author: fanchao         # 作者（abs note 自动写；手写页也须填）
 updated: YYYY-MM-DD
 status: draft           # 或 reviewed（仅指知识冲突裁决结案）
 ---

package/src/store.js

@@ -3,6 +3,7 @@
 import { promises as fs } from 'node:fs';
 import { join, resolve, dirname } from 'node:path';
 import { requireBrain, brainPath, absLogDir, BRAIN_DIR } from './index.js';
+import { requireUser, atTag, getUser } from './userconfig.js';
 import { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine, archiveDoneInText, renderArchivePage, renderArchiveBody, DONE_KINDS, withDoneKind, doneKindOf } from './todo.js';
 import { editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor } from './wrapup.js';
@@ -34,7 +35,11 @@ async function createSkeleton(root, brain) {
   await fs.writeFile(join(brain, 'index.md'), indexTemplate(), 'utf8');
   await fs.writeFile(join(brain, 'log.md'), logTemplate(), 'utf8');
   await fs.writeFile(join(brain, 'todo.md'), todoTemplate(), 'utf8');
-  return `✓ 已建图谱 ${brain}\n  (模板见 SKILL.md「文件标准」)`;
+  // 建完就提示设姓名 —— 否则用户一路到第一次 todo add 才撞墙，
+  // 中间 init/load 都不提，根本不知道该设。
+  const who = await getUser();
+  const hint = who ? '' : `\n  ⚠ 尚未设置使用者姓名，写操作(todo add/log/note)会先报错。\n    请先设置: abs config set user <你的名字>`;
+  return `✓ 已建图谱 ${brain}\n  (模板见 SKILL.md「文件标准」)${hint}`;
 }
 
 /** 结构体检：6 目录 + 3 文件逐一核对。ok=false 时 problems 列出缺失项。 */
@@ -162,6 +167,17 @@ export async function cmdLoad({ dir }) {
   const stranded = await strandedFor(root);
   const sections = [
     `📂 abs → 项目: ${root}`,
+  ];
+  // 未设姓名时开场就提醒 —— load 是开机第一屏，不在这里提，
+  // 用户要撞到第一次写操作才知道（init/load 一路沉默）。
+  if (!(await getUser())) {
+    sections.push(
+      '⚠ 尚未设置使用者姓名（写操作会先报错）',
+      '→ abs config set user <你的名字>    (或临时: ABS_USER=<名字> abs ...)',
+      ''
+    );
+  }
+  sections.push(
     '--- 当前路线 (index.md) ---',
     index || '(index.md 为空)',
     '',
@@ -170,15 +186,15 @@ export async function cmdLoad({ dir }) {
     '',
     '--- 最近动作 (log.md, 最新 5 条) ---',
     recentLogLines(log, 5) || '(log.md 为空)',
-  ];
+  );
   if (stranded.length) {
     const rows = stranded.map((t) => {
       const bp = t.bp.length ? `\n    ${t.bp.map((b) => `↳ 断点: ${b}`).join('\n    ')}` : '';
       return `  - ${t.body}${bp}`;
     });
+    // 插在项目行之后、其它内容之前
     sections.splice(
-      0, 1,
-      `📂 abs → 项目: ${root}`,
+      1, 0,
       '⏳ 上会话滞留（未 done，先对账）',
       rows.join('\n'),
       '→ 完成: abs todo done <id>；未完: abs todo note <id> --note 断点',
@@ -318,7 +334,12 @@ export async function cmdTeardownCheck({ dir, payload }) {
     await fs.writeFile(mark, stamp).catch(() => {});
 
     const msg = [
-      '[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：',
+      // 未设姓名时把设置指令插到第0条 —— 否则后续 todo add/log/note 全会被守卫拦下，
+    // 而收尾提醒本身不提这事，使用者只会看到一连串报错。
+    (await getUser() ? [] : [
+      '0) 本机尚未设置使用者姓名 —— 先跑 abs config set user <你的名字>，否则下面 2/3/4 都会被拦下；',
+    ]),
+    '[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：',
       '1) 跑 abs load 看 Today 还有哪些未完成；',
       '2) 实际做完漏登记的 abs todo done <id>，做到一半的 abs todo note <id> --note "断点"；',
       '3) 值得留的经验 abs note "..."（宁少勿滥，能从代码 grep 到的不记）；',
@@ -383,12 +404,15 @@ function slugOf(text, n = 24) {
 // ---------- log: 追加工作成果沉淀摘要（用户/AI 主动 abs log "..." 记, 不收工具动作流水） ----------
 export async function cmdLog({ dir, title, kind = 'dev' }) {
   const root = await requireBrain(dir || process.cwd());
+  const who = await requireUser(); // 写操作守卫
   const p = brainPath(root, 'log.md');
   const stamp = localStamp();
   // 不硬切: log.md 是人类读的成果摘要, 也是 abs load 的开机入口。600 码点够一条完整小结,
   // 超出才在语义边界收口（曾 slice(0,100) → 34/85 条断在词中间）
   const clean = clip(String(title || '').replace(/\n/g, ' '), 600);
-  const line = `## [${stamp}] ${kind} | ${clean}`;
+  // 作者前置于 kind：`## [时间] @name dev | 内容`。
+  // 一眼先看到谁做的（与 todo 行 `ID @name — 说明` 排版对齐）。
+  const line = `## [${stamp}] ${atTag(who)} ${kind} | ${clean}`;
   await editFile(p, (cur) => {
     const text = cur ?? '# 🗒 操作日志\n';
     // 倒序：新行插在标题后（若已是模板占位行则替换它）
@@ -405,13 +429,14 @@ export async function cmdLog({ dir, title, kind = 'dev' }) {
 // log.md 是「工作成果沉淀摘要」(用户/AI 主动 abs log "..." 记), 不收工具动作流水。
 export async function cmdTask({ dir, action, id, section, note, as }) {
   const root = await requireBrain(dir || process.cwd());
+  // 写操作守卫：无姓名不落盘（hook 调的 wrapup/teardown-check 不经过这里，不受影响）
+  const who = await requireUser();
   if (action === 'start') {
-    const text = `${id}${note ? ' — ' + note : ''}`;
     const r = await upsertTask(root, {
       section: section || 'Today / In Progress',
-      text: `${text} (认领 ${today()})`,
+      text: `${id} ${atTag(who)}${note ? ' — ' + note : ''} (认领 ${today()})`,
     });
-    return `✓ 任务${r.updated ? '更新(幂等)' : '登记'} → ${brainPath(root, 'todo.md')}\n  ${id}${note ? ' — ' + note : ''}`;
+    return `✓ 任务${r.updated ? '更新(幂等)' : '登记'} → ${brainPath(root, 'todo.md')}\n  ${id} ${atTag(who)}${note ? ' — ' + note : ''}`;
   }
   if (action === 'blocked') {
     const r = await moveBlocked(root, { id, reason: note });
@@ -547,6 +572,7 @@ export async function cmdNote({ dir, text, tags }) {
   } catch {
     return `未找到 .brain/ 图谱。先在项目根运行: abs init`;
   }
+  const who = await requireUser(); // 写操作守卫
   const srcDir = brainPath(root, 'sources');
   await fs.mkdir(srcDir, { recursive: true });
   // 幂等: 同文本 60s 内只落一份
@@ -565,6 +591,7 @@ export async function cmdNote({ dir, text, tags }) {
   const body = [
     '---',
     `tags: [${fmTags}]`,
+    `author: ${who}`,
     `updated: ${today()}`,
     'status: draft',
     '---',
@@ -600,7 +627,7 @@ export async function cmdNote({ dir, text, tags }) {
     return { text: next };
   });
   await cmdLog({ dir: root, title: clean, kind: 'note' });
-  return `✓ 经验暂存 → sources/${file}\n  ${clean}`;
+  return `✓ 经验暂存 → sources/${file}\n  ${clean} ${atTag(who)}`;
 }
 // ---------- lint: 体检（与 scripts/lint.sh 同规则的 Node 版，供 CLI/MCP 直调） ----------
 export async function cmdLint({ dir }) {

package/src/todo.js

@@ -390,10 +390,12 @@ export async function upsertTask(brainRoot, { section, text }) {
     // 在所有分区中找该 id 对应的未完成任务行（Done 的已完成行不重复动）；全等比对
     const idx = findTaskLine(lines, id);
     if (idx !== -1) {
-      // 原位更新：保留断点附属行，只换任务行本体
+      // 原位更新：保留断点附属行 + 原@作者，只换任务行本体
+      const author = extractAuthor(lines[idx].replace(/^- \[ \] /, ''));
       const oldNote = extractNote(lines[idx].replace(/^- \[ \] /, ''));
       const merged = note && oldNote && oldNote.startsWith(note) ? `${note}${oldNote.slice(note.length)}` : note || oldNote;
-      const newLine = `- [ ] ${id}${merged ? ' — ' + merged : ''} (认领 ${today()})`;
+      const at = author ? ` @${author}` : '';
+      const newLine = `- [ ] ${id}${at}${merged ? ' — ' + merged : ''} (认领 ${today()})`;
       lines[idx] = newLine;
       return { text: lines.join('\n'), updated: true };
     }
@@ -410,10 +412,18 @@ export function extractId(text) {
   return m ? m[1] : null;
 }
 
-/** 提取 " — " 后的 note 部分。 */
+/** 提取 " — " 后的 note 部分（剥掉紧跟在 id 后的 `@author` 标记及尾部 `(认领 ...)`）。
+ * 格式: `<id> @author — <note> (认领 date)`。@author 可选（旧行/未设置姓名时无）。 */
 export function extractNote(text) {
   const i = String(text).indexOf(' — ');
-  return i === -1 ? '' : String(text).slice(i + 3).replace(/\s*\(认领[^)]*\)\s*$/, '');
+  if (i === -1) return '';
+  return String(text).slice(i + 3).replace(/\s*\(认领[^)]*\)\s*$/, '').trim();
+}
+
+/** 提取 id 后的 `@author` 标记（无则空）。供 upsertTask 原位重建行时保留作者。 */
+export function extractAuthor(text) {
+  const m = String(text).match(/^\S+\s+@([\w\u4e00-\u9fff.-]+)/);
+  return m ? m[1] : '';
 }
 
 /**

package/src/userconfig.js

@@ -0,0 +1,68 @@
+// src/userconfig.js — 用户身份（作者名）配置。
+// 用途：todo/log/生成的文档标 @name，让跨会话图谱能看出"谁登记的"。
+//
+// 配置源（后者优先）：
+//   1. ~/.abs/config.json 的 { "user": "fanchao" }  —— abs config set user <name> 写入
+//   2. 环境变量 ABS_USER                          —— 临时/CI 覆盖，不改落盘配置
+//
+// 纪律：**只在写操作检查**。hook 会在会话结束时非交互调 abs wrapup / abs teardown-check，
+// 只读命令若也拦人，hook 路径会卡住或报错。故 requireUser 只被写命令调用。
+import { promises as fs } from 'node:fs';
+import { join } from 'node:path';
+import { homedir } from 'node:os';
+
+/** 配置文件路径（ABS_CONFIG_DIR 可覆盖，测试隔离用）。 */
+export function userConfigPath() {
+  const dir = process.env.ABS_CONFIG_DIR || join(homedir(), '.abs');
+  return join(dir, 'config.json');
+}
+
+/** 读配置的 user 字段（不存在/坏 JSON 一律返回 null，不抛）。 */
+export async function getUser() {
+  const env = String(process.env.ABS_USER || '').trim();
+  if (env) return env; // 环境变量优先：临时覆盖不必改落盘配置
+  try {
+    const raw = await fs.readFile(userConfigPath(), 'utf8');
+    const u = JSON.parse(raw).user;
+    return typeof u === 'string' && u.trim() ? u.trim() : null;
+  } catch {
+    return null;
+  }
+}
+
+/** 写配置的 user 字段（保留其它键）。 */
+export async function setUser(name) {
+  const clean = String(name || '').trim();
+  if (!clean) throw new Error('✗ 姓名不能为空');
+  // 合法性：允许字母数字中文下划线连字符点，禁空白（空白会破坏 @name 标记的解析）
+  if (!/^[\w\u4e00-\u9fff.-]+$/.test(clean)) {
+    throw new Error(`✗ 姓名 "${clean}" 含不支持的字符（只允许字母/数字/中文/._-，且不含空格）`);
+  }
+  const p = userConfigPath();
+  await fs.mkdir(join(p, '..'), { recursive: true });
+  let cfg = {};
+  try { cfg = JSON.parse(await fs.readFile(p, 'utf8')); } catch { /* 首次或坏 JSON → 重建 */ }
+  cfg.user = clean;
+  await fs.writeFile(p, JSON.stringify(cfg, null, 2) + '\n', 'utf8');
+  return clean;
+}
+
+/**
+ * 写操作入口守卫：拿到作者名，拿不到就抛带指引的错误。
+ * 错误文案给出两条路（持久设置 / 临时覆盖），别让用户猜。
+ */
+export async function requireUser() {
+  const u = await getUser();
+  if (u) return u;
+  throw new Error(
+    '✗ 尚未设置使用者姓名 —— 图谱需要标记每条记录的作者。\n' +
+    '  请任选其一设置后重试:\n' +
+    '    abs config set user <你的名字>     (写入 ~/.abs/config.json, 一次即可)\n' +
+    '    ABS_USER=<你的名字> abs ...        (仅本次生效)'
+  );
+}
+
+/** 标记串：`@name`。用于 todo 行 / log 行 / 页面 frontmatter。 */
+export function atTag(name) {
+  return `@${name}`;
+}