@fanchao8609/agent_brain_sync 1.2.3 → 1.3.1

package/README.md

@@ -62,10 +62,10 @@ abs init          # 建 .brain/ 图谱，只需一次
 abs load                       # 开机读状态（路线 + 看板 + 最近流水）
 abs todo                       # 看板 Today / In Progress / Blocked / Done
 
-abs task start   TASK-1 --note "要做什么"
-abs task note    TASK-1 --note "改到 X 文件 L40"   # 实时断点
-abs task blocked TASK-1 --note "卡在哪"
-abs task done    TASK-1
+abs todo add     TASK-1 --note "要做什么"
+abs todo note    TASK-1 --note "改到 X 文件 L40"   # 实时断点
+abs todo blocked TASK-1 --note "卡在哪"
+abs todo done    TASK-1
 
 abs note "一句话经验" --tags 坑,docker    # 经验暂存 → sources/
 abs log "完成 X"                          # 记一行流水；abs log 无参 = 查看
@@ -74,10 +74,13 @@ abs status                                # 当前项目 + 图谱概要
 abs lint                                  # 体检：死链/孤岛/超尺寸/堆积
 ```
 
+> `abs todo start` 与 `abs todo add` 等价（都登记任务）。
+> 旧版 `abs task ...` / `abs board` 已改名，会报错并提示新写法。
+
 ### 工作流
 
 - **hook 自动**：宿主生命周期事件写技术流水到 `~/.abs/log/`
-- **实时层（你/AI 手动）**：任务和经验在边界处立刻用 `abs task` / `abs note` 落盘
+- **实时层（你/AI 手动）**：任务和经验在边界处立刻用 `abs todo` / `abs note` 落盘
 - **收尾层**：`abs wrapup` 在 Stop 时快照未完成任务；下个会话开头对账 todo、沉淀经验、修 index
 
 ---

package/bin/abs.js

@@ -82,43 +82,83 @@ function parseArgv(args) {
 
 const usage = `abs — agent-brain-sync 记忆工具
 
-用法:
-  abs init [--repair]        建 .brain/ 图谱；结构不完整时报明细，--repair 只补缺不覆盖
+读:
   abs load                   开机读状态 (index/todo/log)
-  abs todo                   查看任务看板 (board 的正名)
-  abs index                  查看图谱索引 index.md
-  abs log                    无参查看流水 log.md；带参追加一行: abs log "标题" (仅用户/AI 主动记, hook 事件走 ~/.abs/log/hooks.log)
-  abs status                 显示当前项目 + 图谱概要
-  abs task start   <id> [--note ..] [--section Today / In Progress]  登记任务
-  abs task note    <id> --note "断点/进度"   实时落 ↳ 断点 行
-  abs task blocked <id> --note "卡点原因"    移入 Blocked 区
-  abs task done    <id>                      完成并归位 Done
+  abs todo                   任务看板 Today / In Progress / Blocked / Done
+  abs index                  图谱索引 index.md
+  abs log                    流水 log.md
+  abs status                 当前项目 + 图谱概要
+
+写:
+  abs todo add     <id> [--note ..] [--section ..]  登记任务 (start 同义)
+  abs todo note    <id> --note "断点/进度"   实时落 ↳ 断点 行
+  abs todo blocked <id> --note "卡点原因"    移入 Blocked 区
+  abs todo done    <id>                      完成并归位 Done
+  abs log "完成 X：…"         记一行工作成果 (无参=查看)
   abs note "经验一句话" [--tags 坑,docker]    经验实时暂存 → sources/
+
+维护:
   abs query <词1> [词2 …]    检索 .brain/ 知识页 (多词 OR)
   abs lint                   图谱体检 (死链/孤岛/超尺寸/堆积)
-  abs wrapup                 快照当前未完成任务到 ~/.abs/log/wrapup.log (收尾保险)
-  abs install [--agent <claude-code|opencode|codex|pi>]  安装 MCP+hook+skill
-  abs uninstall [--agent <...>]                            卸载
+  abs init [--repair]        建 .brain/ 图谱; 结构不完整时报明细, --repair 只补缺不覆盖
+  abs install [--agent <宿主>]   安装 MCP+hook+skill (宿主: claude-code/codex/opencode/pi)
+  abs uninstall [--agent <...>]  卸载
   abs update                 升级到最新版并刷新四宿主 hook/skill
   abs --version              显示当前版本
   abs help                   本帮助
+
+注: abs wrapup / abs teardown-check 是 hook 内部命令, 不需手动调用。
 `;
 
+/**
+ * 拒绝多余的未知位置参数。
+ * 坑: 以前只读命令(如 abs todo)会静默忽略多余词 —— `abs todo add x` 照样打印看板、
+ * exit 0、不报错, 用户以为登记成功实际什么都没写。现在一律报错并给正确用法。
+ * @param {string[]} extra 收到的位置参数
+ * @param {string} fix 正确用法的提示行
+ */
+function rejectExtra(extra, fix) {
+  if (!extra.length) return;
+  const q = extra.map((s) => `"${s}"`).join('、');
+  throw new Error(`✗ 不认识多余参数 ${q}\n  正确用法: ${fix}`);
+}
+
+// 已改名/已废弃命令 → 新写法（报错而非静默，避免用户白跑一趟）
+const RENAMED = {
+  task: () => '命令已改名: abs task → abs todo\n  例: abs todo add <id> --note "…"  /  abs todo done <id>',
+  board: () => '命令已改名: abs board → abs todo',
+};
+
+// task/todo 共用的子命令 → 归一化后的 action
+const TODO_ACTIONS = {
+  add: 'start',
+  start: 'start', // add 的别名(老习惯保留)
+  note: 'note',
+  blocked: 'blocked',
+  done: 'done',
+};
+
 async function main() {
   const opts = parseArgv(rest);
   try {
+    if (RENAMED[cmd]) throw new Error(RENAMED[cmd]());
     switch (cmd) {
       case 'init': {
+        rejectExtra(opts._, 'abs init [--repair]');
         const msg = opts.repair
           ? await cmdRepair({ dir: opts.dir })
           : await cmdInit({ dir: opts.dir });
         console.log(msg);
         break;
       }
-      case 'load':     console.log(await cmdLoad({ dir: opts.dir })); break;
-      case 'board':    console.log(await cmdShow({ dir: opts.dir, view: 'todo' })); break;
-      case 'todo':     console.log(await cmdShow({ dir: opts.dir, view: 'todo' })); break;
-      case 'index':    console.log(await cmdShow({ dir: opts.dir, view: 'index' })); break;
+      case 'load':
+        rejectExtra(opts._, 'abs load');
+        console.log(await cmdLoad({ dir: opts.dir }));
+        break;
+      case 'index':
+        rejectExtra(opts._, 'abs index');
+        console.log(await cmdShow({ dir: opts.dir, view: 'index' }));
+        break;
       case 'log': {
         // 无参=查看 log.md；带参=追加一行 (用户/AI 主动记; hook 生命周期事件走技术日志 hooks.log, 不经这里)
         if (opts._.length) {
@@ -128,12 +168,29 @@ async function main() {
         }
         break;
       }
-      case 'status':   console.log(await cmdStatus({ dir: opts.dir })); break;
-      case 'task': {
-        const [action, id] = opts._;
-        if (!action || !['start', 'done', 'blocked', 'note'].includes(action)) {
-          throw new Error('abs task <start|done|blocked|note> <id>');
+      case 'status':
+        rejectExtra(opts._, 'abs status');
+        console.log(await cmdStatus({ dir: opts.dir }));
+        break;
+      // abs todo —— 无子命令=看板；带子命令=任务写操作
+      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' }));
+          break;
+        }
+        const action = TODO_ACTIONS[sub];
+        if (!action) {
+          throw new Error(
+            `✗ 未知子命令 "${sub}"\n` +
+            `  可用: add / start / note / blocked / done\n` +
+            `  看板: abs todo（不带参数）\n` +
+            `  登记任务: abs todo add <id> --note "做什么"`,
+          );
         }
+        rejectExtra(rest2, `abs todo ${sub} <id>${action === 'done' ? '' : ' --note "…"'}`);
+        if (!id) throw new Error(`✗ 缺 <id>\n  用法: abs todo ${sub} <id>${action === 'done' ? '' : ' --note "…"'}`);
         console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note: opts.note }));
         break;
       }
@@ -149,10 +206,13 @@ async function main() {
         break;
       }
       case 'lint': {
+        rejectExtra(opts._, 'abs lint');
         console.log(await cmdLint({ dir: opts.dir }));
         break;
       }
+      // 内部命令（hook 专用，不出现在 help）：Stop 时机械快照未完成任务
       case 'wrapup': {
+        rejectExtra(opts._, 'abs wrapup（内部命令, 供 hook 调用）');
         console.log(await cmdWrapup({ dir: opts.dir }));
         break;
       }

package/bin/mcp.js

@@ -8,8 +8,10 @@ import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { z } from 'zod';
 import { appendFile, mkdir } from 'node:fs/promises';
+import { readFileSync } from 'node:fs';
 import { homedir } from 'node:os';
-import { join } from 'node:path';
+import { join, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
 import { findBrainRoot } from '../src/index.js';
 import { cmdBoard, cmdLoad, cmdStatus, cmdTask, cmdQuery, cmdLint, cmdNote, cmdWrapup } from '../src/store.js';
 
@@ -44,13 +46,29 @@ function withTrace(name, handler) {
   };
 }
 
+// 版本号从本包 package.json 读（曾硬编码 '0.1.0'，与包版本脱节，宿主里看着困惑）
+function pkgVersion() {
+  try {
+    const root = join(dirname(fileURLToPath(import.meta.url)), '..');
+    return JSON.parse(readFileSync(join(root, 'package.json'), 'utf8')).version || 'unknown';
+  } catch { return 'unknown'; }
+}
+
 const server = new McpServer({
   name: 'abs',
-  version: '0.1.0',
+  version: pkgVersion(),
 });
 
+// 统一注册入口（总是经 withTrace）。
+// 坑: 以前 9 处工具各自直接调 server.tool(...) 而不包 withTrace, 导致 withTrace 定义了
+// 但从未被调用 → mcp.log 永远不生成。可观测性静默缺失(无任何症状), 藏了很久。
+// 现在工具只经本函数注册, 包 trace 这件事无法再被遗漏。
+function tool(name, description, schema, handler) {
+  server.tool(name, description, schema, withTrace(name, handler));
+}
+
 // 工具面（narrow on purpose — 只暴露读/查/记状态，不做深提炼）
-server.tool(
+tool(
   'abs_resolve_project',
   '定位当前项目的 .brain 图谱根（从给定目录向上找最近 .brain/）。多项目隔离的唯一入口。',
   { cwd: z.string().describe('当前工作目录，默认进程 cwd') },
@@ -63,7 +81,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_board',
   '读取当前项目 todo 看板（含断点/Next-Step）。先 resolve 得到项目，再传其根目录。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -74,7 +92,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_load',
   '开机读状态：index 路线 + todo 看板 + 最近 log。跨会话续接的入口。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -85,23 +103,25 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_task',
-  '任务实时落盘（幂等键 = id）。start 登记 / note 补断点(改到哪个文件哪行) / blocked 碰壁 / done 完成归位。',
+  '任务实时落盘（幂等键 = id）。add/start 登记 / note 补断点(改到哪个文件哪行) / blocked 碰壁 / done 完成归位。',
   {
-    action: z.enum(['start', 'done', 'note', 'blocked']),
+    action: z.enum(['add', 'start', 'done', 'note', 'blocked']),
     id: z.string().describe('任务幂等键，如 TASK-xxx 或子任务名'),
     cwd: z.string().describe('项目内任意目录'),
-    note: z.string().optional().describe('start=做什么; note=断点(文件/到哪步); blocked=卡点原因'),
+    note: z.string().optional().describe('add/start=做什么; note=断点(文件/到哪步); blocked=卡点原因'),
   },
   async ({ action, id, cwd, note }) => {
     const root = await findBrainRoot(cwd || process.cwd());
     if (!root) return err('未找到 .brain/，先 abs init');
-    return { content: [{ type: 'text', text: await cmdTask({ dir: root, action, id, note }) }] };
+    // add 是 start 的别名（与 CLI `abs todo add` 对齐）
+    const act = action === 'add' ? 'start' : action;
+    return { content: [{ type: 'text', text: await cmdTask({ dir: root, action: act, id, note }) }] };
   }
 );
 
-server.tool(
+tool(
   'abs_status',
   '当前项目 + 图谱概要（各类页数）。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -112,7 +132,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_query',
   '检索当前项目 .brain/ 知识页（多词 OR）：以前踩过什么坑、哪页记了 X。',
   { cwd: z.string().describe('项目内任意目录'), terms: z.array(z.string()).min(1).describe('检索词') },
@@ -123,7 +143,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_lint',
   '图谱体检：死链/孤岛/缺 frontmatter/超尺寸/sources 堆积/index 漏列。',
   { cwd: z.string().describe('项目内任意目录') },
@@ -134,7 +154,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_note',
   '经验实时暂存：把刚踩的坑/技巧/结论一句话落进 sources/（防 context 断了流失）。Teardown 时再提炼进 concepts/。',
   {
@@ -149,7 +169,7 @@ server.tool(
   }
 );
 
-server.tool(
+tool(
   'abs_wrapup',
   '收尾保险：把当前 todo 未完成任务快照到 ~/.abs/log/wrapup.log（下会话 load 时展示滞留对账）。',
   { cwd: z.string().describe('项目内任意目录') },

package/package.json

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

package/skill/SKILL.md

@@ -90,18 +90,18 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`；横向
 
 1. **读状态**：`abs load`（或 MCP `abs_load`）读 index 路线 + todo 看板 + 最近 log。
 2. **对账滞留（强制，别跳过）**：若 `abs load` 顶部出现 `⏳ 上会话滞留`，说明上会话有任务做完/做到一半就断了。**先收尾再开工**：
-   - 快照里的任务现在真做完了 → `abs task done <id>`（done 后下次 load 滞留自动消失）；
-   - 还没做完 → `abs task note <id> --note "接到哪/改到哪个文件"` 补断点（别空手续接）。
+   - 快照里的任务现在真做完了 → `abs todo done <id>`（done 后下次 load 滞留自动消失）；
+   - 还没做完 → `abs todo note <id> --note "接到哪/改到哪个文件"` 补断点（别空手续接）。
    滞留没清完就不算接上了状态——这是「任务做完没进 Done」的根治动作。
 3. **读命中页**：按关键词在 index 定位 → 读对应 concepts/entities 全文。
 4. **续 todo**：默认续 todo 分支 → 把顶部未完成项当当前任务开做。
-5. **登记新任务**：有明确新任务而 todo 没有 → `abs task start <id> --note 做什么` 登记
+5. **登记新任务**：有明确新任务而 todo 没有 → `abs todo add <id> --note 做什么` 登记
    再动工。不登记，会话一切断就丢。
 
 ## 进行中：todo 是活看板 + 经验实时落（最重要的纪律）
 
 **todo 不是收尾仪式，是干活中随改随写的活看板。** 每个任务边界立即更新，和 git commit
-同一个反射，别等收尾。用工具（MCP `abs_task` / CLI `abs task`）：
+同一个反射，别等收尾。用工具（MCP `abs_task` / CLI `abs todo`）：
 
 > **写操作优先 MCP，不要用 `bash` 跑 `abs`。** 实测：MCP 单次 ~2ms（server 常驻），
 > CLI 单次 27ms（其中 20ms 是每次起 node 进程的固定开销，读写本身仅 3ms）。
@@ -110,15 +110,19 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`；横向
 
 | 时机 | 动作 |
 |---|---|
-| 认领新任务 | `abs task start <id> --note "做什么"` |
-| 子任务做完 | `abs task done <id>`（自动归位 Done 对应 `### YYYY-MM-DD` 分组顶部，新完成在前；断点随迁） |
-| 碰壁/阻塞 | `abs task blocked <id> --note "卡点原因"`（移 Blocked） |
-| 被打断/改向/干到一半停 | `abs task note <id> --note "改到哪个文件/到哪步"`（补 ↳ 断点 行） |
+| 认领新任务 | `abs todo add <id> --note "做什么"` |
+| 子任务做完 | `abs todo done <id>`（自动归位 Done 对应 `### YYYY-MM-DD` 分组顶部，新完成在前；断点随迁） |
+| 碰壁/阻塞 | `abs todo blocked <id> --note "卡点原因"`（移 Blocked） |
+| 被打断/改向/干到一半停 | `abs todo note <id> --note "改到哪个文件/到哪步"`（补 ↳ 断点 行） |
 
-> **跨会话任务只用 abs task，别用宿主原生 todo。** Cl​aude TodoWrite/Task、co​dex todo-list、
+> `abs todo start` 与 `abs todo add` 等价（老写法仍可用）。
+> 旧版 `abs task ...` / `abs board` 已改名，会报错并提示新写法。
+> 只读命令（`todo`/`status`/`lint`/`load`/`index`）遇多余参数会报错 —— 不再静默吞掉。
+
+> **跨会话任务只用 abs todo，别用宿主原生 todo。** Cl​aude TodoWrite/Task、co​dex todo-list、
 > Op​enCode todowrite、pi `/list`/goal 各有各的原生任务——但**多是会话内临时**，不会写进
 > `.brain/todo.md`。若用原生 todo 建了跨会话任务，它就会「只在界面 0/N 里、abs 看不到」，
-> 下会话接不上、收尾没影。**分工**：跨会话/会被打断的任务 → `abs task start`（唯一真源）；
+> 下会话接不上、收尾没影。**分工**：跨会话/会被打断的任务 → `abs todo add`（唯一真源）；
 > 原生 todo 顶多记「本会话内不跨断点的临时拆解草稿」。
 
 **经验/坑刚冒出来就落**：`abs note "一句话经验" --tags 坑,docker`（MCP `abs_note`）——
@@ -142,8 +146,8 @@ monorepo 若多个子包各自独立交付，可各建一份 `.brain/`；横向
 收到 Stop / "结束/先这样/切别的事" / 长任务告一段落，立即执行（快、准、不啰嗦）：
 
 1. **读 todo** → `abs load`，看 Today 还有哪些没完成。
-2. **判有没有做完没登记** → 实际完成了漏登记的 `abs task done <id>`；做到一半补
-   `abs task note <id> --note 断点`；碰壁 `abs task blocked`。别让干完的事还停 Today。
+2. **判有没有做完没登记** → 实际完成了漏登记的 `abs todo done <id>`；做到一半补
+   `abs todo note <id> --note 断点`；碰壁 `abs todo blocked`。别让干完的事还停 Today。
 3. **沉淀经验（该沉淀才沉淀）** → 踩了值得记的坑/有可复用技巧/跨会话判断 → `abs note`
    暂存；值得深提炼的（规律/坑/决策）按 Teardown 走完整流程。
 4. **更新 index/log/todo** → 新页同步进 index；`log.md` 倒序记一行**工作成果**摘要
@@ -196,7 +200,7 @@ status: draft           # 或 reviewed（仅指知识冲突裁决结案）
 | 层 | 干什么 | 靠什么 |
 |---|---|---|
 | **hook（机械）** | SessionStart/UserPromptSubmit/Stop/SessionEnd 自动记**技术日志**（~/.abs/log/） | 宿主 hook 配置。你不写技术日志。 |
-| **CLI/MCP（实时）** | 任务/经验**实时落盘**：`abs task start/note/blocked/done`、`abs note` | 每个任务边界立即调；经验随时 abs note。 |
+| **CLI/MCP（实时）** | 任务/经验**实时落盘**：`abs todo add/note/blocked/done`、`abs note` | 每个任务边界立即调；经验随时 abs note。 |
 | **skill（自觉）** | **深提炼**（sources→concepts）+ 收尾循环 + 修 index | 判断什么值得沉淀，工具不替你判断。 |
 
 实时层解决"断了就丢"；自觉层解决"噪音污染"。分工明确：骨架/任务/暂存/检索/体检走 abs 工具

package/src/install.js

@@ -302,7 +302,7 @@ const server = async ({ client, directory }) => {
   const TEARDOWN_MSG =
     "[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：\\n" +
     "1) 跑 abs load 看 Today 还有哪些未完成；\\n" +
-    "2) 实际做完漏登记的 abs task done <id>，做到一半的 abs task note <id> --note \\"断点\\"；\\n" +
+    "2) 实际做完漏登记的 abs todo done <id>，做到一半的 abs todo note <id> --note \\"断点\\"；\\n" +
     "3) 值得留的经验 abs note \\"...\\"（宁少勿滥，能从代码 grep 到的不记）；\\n" +
     "4) abs log \\"完成 X：...\\" 记一行工作成果，新页同步进 index。\\n" +
     "简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句\\"无可沉淀\\"即可。"
@@ -487,7 +487,7 @@ export default function absPiHook(pi: ExtensionAPI): void {
       pi.sendUserMessage(
         "[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：\\n" +
         "1) 跑 abs load 看 Today 还有哪些未完成；\\n" +
-        "2) 实际做完漏登记的 abs task done <id>，做到一半的 abs task note <id> --note \\"断点\\"；\\n" +
+        "2) 实际做完漏登记的 abs todo done <id>，做到一半的 abs todo note <id> --note \\"断点\\"；\\n" +
         "3) 值得留的经验 abs note \\"...\\"（宁少勿滥，能从代码 grep 到的不记）；\\n" +
         "4) abs log \\"完成 X：...\\" 记一行工作成果，新页同步进 index。\\n" +
         "简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句\\"无可沉淀\\"即可。",

package/src/store.js

@@ -180,7 +180,7 @@ export async function cmdLoad({ dir }) {
       `📂 abs → 项目: ${root}`,
       '⏳ 上会话滞留（未 done，先对账）',
       rows.join('\n'),
-      '→ 完成: abs task done <id>；未完: abs task note <id> --note 断点',
+      '→ 完成: abs todo done <id>；未完: abs todo note <id> --note 断点',
       ''
     );
   }
@@ -244,7 +244,7 @@ export async function cmdTeardownCheck({ dir, payload }) {
     const msg = [
       '[abs 收尾提醒] 本会话改过文件但 .brain/ 今天还没有记录。请立即走收尾循环：',
       '1) 跑 abs load 看 Today 还有哪些未完成；',
-      '2) 实际做完漏登记的 abs task done <id>，做到一半的 abs task note <id> --note "断点"；',
+      '2) 实际做完漏登记的 abs todo done <id>，做到一半的 abs todo note <id> --note "断点"；',
       '3) 值得留的经验 abs note "..."（宁少勿滥，能从代码 grep 到的不记）；',
       '4) abs log "完成 X：..." 记一行工作成果，新页同步进 index。',
       '简洁执行，不要复述本条提醒。若本次确实没有可沉淀产出，直接回一句"无可沉淀"即可。',
@@ -302,7 +302,7 @@ export async function cmdTask({ dir, action, id, section, note }) {
     return r.msg;
   }
   if (action === 'note') {
-    if (!note) return '用法: abs task note <id> --note "断点/进度"（实时落 ↳ 断点 行）';
+    if (!note) return '用法: abs todo note <id> --note "断点/进度"（实时落 ↳ 断点 行）';
     const r = await setBreakpoint(root, { id, text: note });
     return r.msg;
   }

package/src/todo.js

@@ -318,6 +318,6 @@ export async function moveBlocked(brainRoot, { id, reason }) {
 export async function boardText(brainRoot, textOverride) {
   const text = textOverride !== undefined ? textOverride : await readTodo(brainRoot);
   const head = `📂 abs → 项目: ${brainRoot}`;
-  if (!text.trim()) return `${head}\n\n（todo.md 为空，先 abs task start 登记任务）`;
+  if (!text.trim()) return `${head}\n\n（todo.md 为空，先 abs todo add 登记任务）`;
   return `${head}\n\n${text.trim()}`;
 }