@fanchao8609/agent_brain_sync 1.7.0 → 1.7.2

package/bin/abs.js

@@ -76,12 +76,16 @@ const FLAG_SPEC = {
   'keep-days': { type: 'string' },
   'help': { type: 'boolean' },
   'dry-run': { type: 'boolean' },
+  'full': { type: 'boolean' },
   'yes': { type: 'boolean' },
   'repair': { type: 'boolean' },
   'no-mcp': { type: 'boolean' },
   'no-skill': { type: 'boolean' },
 };
 
+/** 已被"规范键"接管的 raw flag：不再原样漏出（见 parseArgv 返回处的白名单注释）。 */
+const KNOWN_RAW = new Set(['keep-days', 'dry-run', 'no-mcp', 'no-skill']);
+
 function parseArgv(args) {
   // 坑: parseArgs 会把**任何** `-` 开头的 token 当选项，连正文一起吃：
   // `abs note "-X 是个坑"` → values={X:true,' ':true,是:true,…}，正文全丢（旧手写版只认 `--` 长选项）。
@@ -124,17 +128,39 @@ function parseArgv(args) {
   if (missing.length) {
     throw new Error(`✗ ${missing.join('、')} 缺少值\n  用法: --<flag> <值>（如 --dir /path/to/project）`);
   }
+  // 只输出**读者实际用的**规范形状：camelCase 键 + mcp/skill 正向布尔。
+  // 坑(OPTS-DOUBLE-KEYS): 曾 `...values` 之后再叠加 camelCase → opts 同时带两份 key
+  // （keep-days 与 keepDays、no-mcp 与 mcp），读者得自己猜哪份算数。raw 键无人读，
+  // 属纯噪音（grep 验证：opts['keep-days'] 零引用）。
+  // 用显式白名单而非 ...values：新增 flag 必须在此声明一次，否则"声明了却没接线"
+  // 会静默变成"读不到"，而不是意外漏出一个无名键。
   const o = {
-    ...values,
     _: positionals,
+    dir: values.dir,
+    agent: values.agent,
+    id: values.id,
+    section: values.section,
+    note: values.note,
+    as: values.as,
+    payload: values.payload,
+    tags: values.tags,
+    help: !!values.help,
+    yes: !!values.yes,
+    repair: !!values.repair,
+    full: !!values.full,
     keepDays: values['keep-days'],
-    dryRun: values['dry-run'],
+    dryRun: !!values['dry-run'],
+    mcp: !values['no-mcp'],
+    skill: !values['no-skill'],
   };
-  if (values['no-mcp']) o.mcp = false;
-  if (values['no-skill']) o.skill = false;
+  // 未声明的 `--unknown` 静默收下（旧行为：不进位置参数，也不报错）。
+  // 这条保留是因为 rejectExtra 只看位置参数 —— 把未知 flag 放进去会改成报错，
+  // 那是另一个行为变更，不在本次范围内。
+  for (const [k, v] of Object.entries(values)) {
+    if (!(k in o) && !KNOWN_RAW.has(k)) o[k] = v;
+  }
   return o;
 }
-
 const usage = `abs — agent-brain-sync 记忆工具
 
 读:
@@ -313,8 +339,8 @@ async function main() {
       case 'todo': {
         const [sub, id, ...rest2] = opts._;
         if (!sub) {
-          rejectExtra([id, ...rest2].filter(Boolean), 'abs todo');
-          console.log(await cmdShow({ dir: opts.dir, view: 'todo' }));
+          rejectExtra([id, ...rest2].filter(Boolean), 'abs todo [--full]');
+          console.log(await cmdShow({ dir: opts.dir, view: 'todo', full: opts.full }));
           break;
         }
         const action = TODO_ACTIONS[sub];

package/package.json

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

package/skill/SKILL.md

@@ -145,6 +145,14 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`。`abs st
 图谱已存在；收到第一个核心开发指令**之前**走这条链载入上下文：
 
 1. **读状态**：`abs load`（或 MCP `abs_load`）读 index 路线 + todo 看板 + 最近 log。
+   > **load 输出是折叠过的，不是全量。** 两个无上限增长的区块在读取侧收口：
+   > - **Done 区** → 按日期计数（曾占 load 输出 68.8%，长历史项目上单次 load 吃掉 40% 上下文）
+   > - **index 页面清单** → 各分区只给页数（concept 清单占 load 输出 64%，隨图谱线性增长）
+   > - 「最近动作」每条按语义边界收口到 220 字符
+   >
+   > **路线（Roadmap）区原样保留** —— 那是 load 要传达的状态本身。
+   > 要全量明细：`abs todo --full` / `abs index`，或直接读 `.brain/` 文件、
+   > `.brain/sessions/<日期>-todo归档.md`。
 2. **对账滞留（强制，别跳过）**：若 `abs load` 顶部出现 `⏳ 上会话滞留`，说明上会话有任务做完/做到一半就断了。**先收尾再开工**：
    - 快照里的任务现在真做完了 → `abs todo done <id>`（done 后下次 load 滞留自动消失）；
    - 还没做完 → `abs todo note <id> --note "接到哪/改到哪个文件"` 补断点（别空手续接）。

package/src/store.js

@@ -4,7 +4,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 { addTask, upsertTask, boardText, readTodo, ensureTodo, todoTemplate, today, localStamp, setBreakpoint, moveBlocked, insertDoneGrouped, idOfTaskLine, archiveDoneInText, renderArchivePage, renderArchiveBody, DONE_KINDS, withDoneKind, doneKindOf, collapseDone } from './todo.js';
 import { editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor } from './wrapup.js';
 
@@ -128,9 +128,9 @@ export function logTemplate() {
 }
 
 // ---------- board: 看板 ----------
-export async function cmdBoard({ dir }) {
+export async function cmdBoard({ dir, full }) {
   const root = await requireBrain(dir || process.cwd());
-  return boardText(root);
+  return boardText(root, undefined, { full: !!full });
 }
 
 // ---------- status: 定位报告 + 图谱概要 ----------
@@ -179,10 +179,11 @@ export async function cmdLoad({ dir }) {
   }
   sections.push(
     '--- 当前路线 (index.md) ---',
-    index || '(index.md 为空)',
+    collapseIndex(index) || '(index.md 为空)',
     '',
     '--- Todo 看板 (todo.md) ---',
-    todo.trim() || '(todo.md 为空)',
+    collapseDone(todo).text || '(todo.md 为空)',
+    '\n（Done 已按日期折叠计数；明细: abs todo --full）',
     '',
     '--- 最近动作 (log.md, 最新 5 条) ---',
     recentLogLines(log, 5) || '(log.md 为空)',
@@ -204,6 +205,47 @@ export async function cmdLoad({ dir }) {
   return sections.join('\n');
 }
 
+/** index.md 在 `abs load` 里的折叠形态：保留「当前路线」（那是 load 要传达的状态，
+ * 且有界），把页面清单各分区折成计数。
+ *
+ * 坑: index 的 concept 清单带每一页的一句话描述，**隨图谱线性增长** —— 本仓库 17 条
+ * 占 load 输出 2286/3571 tok（64%），另一台 40 条的项目约 2.3 倍。它刚成了 Done 之后
+ * 最大的单体膨胀源（Done 已折叠，见 collapseDone）。
+ *
+ * 续接真正需要的只是「有哪些分区、各多少页」（据此知道去哪找），不需要每页写了什么 ——
+ * 要那个用 `abs index`（或直接读 index.md / 按词 `abs query`）。
+ * `## 当前路线` 不折（它是路线内容本身，非清单）。 */
+export function collapseIndex(text) {
+  const s = String(text || '').trim();
+  if (!s) return '';
+  const out = [];
+  let mode = null;      // null=逐行透传（路线区/文件头）；字符串=当前在计数的分区名
+  let n = 0;            // mode 非 null 时的清单行计数
+  const flush = () => {
+    if (mode !== null) out.push(n ? `## ${mode}（${n} 页）` : `## ${mode}`);
+    mode = null;
+    n = 0;
+  };
+  for (const l of s.split('\n')) {
+    const m = l.match(/^##\s+(.+?)\s*$/);
+    if (m) {
+      flush();
+      const name = m[1].trim();
+      if (/路线|Roadmap/i.test(name)) {
+        out.push(l);   // 「当前路线」是内容不是清单：原样保留
+        mode = null;
+      } else {
+        mode = name;   // 页面清单分区：只计数
+      }
+      continue;
+    }
+    if (mode === null) out.push(l);      // 透传区（含文件头 H1、路线区正文）
+    else if (l.trim().startsWith('-')) n++;
+  }
+  flush();
+  return out.join('\n').replace(/\n{3,}/g, '\n\n').trim();
+}
+
 // ---------- wrapup: 滞留快照（B）/ load 内展示由 cmdLoad 完成（A） ----------
 export async function cmdWrapup({ dir }) {
   const root = await requireBrain(dir || process.cwd());
@@ -366,6 +408,9 @@ function recentLogLines(text, n) {
     .split('\n')
     .filter((l) => /^##\s*\[/.test(l))
     .slice(0, n)
+    // 每条按语义边界收口：load 是开机读状态，只求"上会话做到哪"的线索，不须全文。
+    // 坑: 不收口时 5 条能占 2.9KB（单条 800B），又是一处随日志变长而膨胀的上下文。
+    .map((l) => clip(l, 220))
     .join('\n');
 }
 
@@ -493,7 +538,7 @@ async function markDone(file, id, kind = '落地') {
 }
 
 // ---------- show: 查看 index/todo/log（只读面） ----------
-export async function cmdShow({ dir, view }) {
+export async function cmdShow({ dir, view, full }) {
   const v = String(view || '').toLowerCase();
   if (!['todo', 'index', 'log'].includes(v)) {
     return '用法: abs <todo|index|log>  — todo=看板(原 board), index=图谱索引, log=操作流水';
@@ -510,7 +555,7 @@ export async function cmdShow({ dir, view }) {
     return `${v}.md 不存在于 ${brainPath(root)}。初始化/补齐: abs init --repair`;
   }
   if (!text) return `(${v}.md 为空)`;
-  return v === 'todo' ? boardText(root, text) : text;
+  return v === 'todo' ? boardText(root, text, { full: !!full }) : text;
 }
 // ---------- query: 检索知识图谱（多词 OR，扫全 .md 页） ----------
 const KNOWN_SLUG_HINT = /模板残留|\[\[slug\]\]/;

package/src/todo.js

@@ -160,6 +160,51 @@ function renderDoneGroups(units) {
   return out;
 }
 
+/** 把 Done 区从「全量行」折叠为「按日期计数」，供 `abs load` / `abs todo` 这类
+ * 给人（和 AI 上下文）看的视图用。
+ *
+ * 坑: 这两个命令此前直接 `todo.trim()` 全量打印，而 Done 区**无上限增长** ——
+ * 本仓库一处就占 load 输出的 68.8%（19.6KB/28.4KB）。长历史机器上直接把
+ * 上下文塞满（实报：「另一台机器 abs load 塞了 40%」）。
+ * 这与 hooks.log / wrapup.log 同类问题（那两处有轮转），故这里只给计数，
+ * 要看明细用 `abs todo` 加 `--full`，或直接看 todo.md / 归档页。
+ *
+ * `### 归档` 区（历史的「归档 N 条」标记行）体积小且是长期引用，原样保留。
+ * 返回 { text, doneCount }；text 不含 `## Done` 标题行。 */
+export function collapseDone(text) {
+  const lines = String(text).split('\n');
+  const di = lines.findIndex((l) => l.startsWith('## Done'));
+  if (di === -1) return { text: String(text).trim(), doneCount: 0 };
+  const head = lines.slice(0, di);
+  const rest = lines.slice(di + 1);
+  const { groupLines, archiveLines } = splitDoneBody(rest);
+  const units = parseDoneUnits(groupLines);
+  // 按日期归组计数（新日期在前），未标日期的归尾
+  const byDate = new Map();
+  let undated = 0;
+  for (const u of units) {
+    if (!u.date) undated++;
+    else byDate.set(u.date, (byDate.get(u.date) || 0) + 1);
+  }
+  const counts = [...byDate.entries()]
+    .sort((a, b) => (a[0] < b[0] ? 1 : -1))
+    .map(([d, n]) => `${d} ${n} 条`);
+  if (undated) counts.push(`未标日期 ${undated} 条`);
+  // 只列最近 MAX_DONE_DATE_LINES 个日期组：日期组本身也随历史增长（实测 300 条跨 28 天
+  // 会把 load 输出从 660B 拉到 1203B）。载入视图只需"最近做了多少"，早期历史看归档页。
+  const MAX_DONE_DATE_LINES = 7;
+  const shown = counts.slice(0, MAX_DONE_DATE_LINES);
+  if (counts.length > MAX_DONE_DATE_LINES) {
+    const rest = counts.length - MAX_DONE_DATE_LINES;
+    shown.push(`… 另有 ${rest} 个更早日期组（abs todo --full 看全量）`);
+  }
+  const doneLines = units.length
+    ? [`## Done（${units.length} 条，按日期折叠）`, ...shown.map((c) => `- ${c}`)]
+    : ['## Done（0 条）'];
+  const out = [...head, ...doneLines, '', ...archiveLines].join('\n').replace(/\n{3,}/g, '\n\n').trim();
+  return { text: out, doneCount: units.length };
+}
+
 /** 归档标记区标题。它在 Done 区内部、日期分组之后，形如：
  *   ### 归档
  *   - [[2026-09-10-todo归档]] 完成任务 10 条
@@ -513,9 +558,12 @@ export async function moveBlocked(brainRoot, { id, reason }) {
 }
 
 // ---------- 看板输出 ----------
-export async function boardText(brainRoot, textOverride) {
+export async function boardText(brainRoot, textOverride, { full = false } = {}) {
   const text = textOverride !== undefined ? textOverride : await readTodo(brainRoot);
   const head = `📂 abs → 项目: ${brainRoot}`;
   if (!text.trim()) return `${head}\n\n（todo.md 为空，先 abs todo add 登记任务）`;
-  return `${head}\n\n${text.trim()}`;
+  // Done 区折叠：它无上限增长，全量打印会把上下文塞满（见 collapseDone 注释）
+  const body = full ? text.trim() : collapseDone(text).text;
+  const hint = full ? '' : '\n\n（Done 只给计数；看明细: abs todo --full）';
+  return `${head}\n\n${body}${hint}`;
 }