@fanchao8609/agent_brain_sync 1.19.6 → 1.20.1

package/README.md

@@ -62,16 +62,15 @@ pi 与 omp 宿主额外多一层 UI（其它宿主没有）：**编辑器上方
 ─────────────────────────────────────────────────
 📋 todo (3) — fanchao · ☕ 靠咖啡续命
 ├─ [进行中] some-task ●●○ — 干活中
-│  ↳ 断点: hooks/abs.pi.ts:120
+│  - [ ] hooks/abs.pi.ts:120
 ├─ [滞留中] waiting — 等外部输入
 └─ [进行中] another ●●● — …
 ```
 
 - **只显示未完成**，Done 归计数不占位（数量在标题里）
 - **按当前使用者过滤**：显示 `[[我]]` 的 + 没标作者的（老任务/手写），别人的不显示
-- **断点行 `↳` 挂在父任务下**；`├─` / `└─` 表结构
-- **断点也可以是任务**：`  ↳ [ ] <id> — 说明` 与普通任务同等对待（上看板、可 `done` / `note` / `state`）；
-  单独的 `↳ 断点: 一句话` 仍是纯附属行、不算任务
+- **子项（缩进的 `- [ ]`）挂在父任务下**；`├─` / `└─` 表结构
+- **子项可各自勾选**：`  - [ ] 一句话` → `  - [x] 一句话`；全部勾上才能 `done` 父任务
 - **「进行中」带三点动画**`○○○ → ●●○ → ●●●`（250ms/帧）—— 一眼看出哪条在跑
 - **实时刷新**：我调 `abs_task` / `abs_board` 后立即重画，不用等我讲完话
 - **上描边与输入框同色满宽**（主题色 `thinkingOff`，跟 pi 输入框的边框一致）
@@ -109,8 +108,8 @@ abs todo                       # 看板 Todo / Done（行首带状态标记）
 
 abs todo add     TASK-1 --note "要做什么"
 abs todo note    TASK-1 --note "改到 X 文件 L40"   # 追加一条子项（标准 md 嵌套列表，可多条）
-abs todo bp-done TASK-1 [--n 2]                  # 勾子项（n=第几条，缺省最后一条）
-abs todo bp-undone TASK-1 [--n 2]                # 取消勾（勾错了退回）
+abs todo child-done   TASK-1 [--n 2]             # 勾子项（n=第几条，缺省最后一条）
+abs todo child-undone TASK-1 [--n 2]             # 取消勾（勾错了退回）
 abs todo memo    TASK-1 "随手记一段（可多句，不上看板）"   # 任务笔记 → sessions/；无参=查看
 abs todo state   TASK-1 --note "进行中|讨论中|滞留中"   # 改行首状态标记
 abs todo done    TASK-1
@@ -132,7 +131,9 @@ abs update                                # 升级到最新版并刷新四宿主
 
 > `abs todo start` 与 `abs todo add` 等价（都登记任务）。
 > **子项就是标准 Markdown 嵌套列表**：任务下缩进 2 空格的 `- [ ] …`，可多条、可各自勾选；
-> 面板按缩进画树线，归档时原样保留缩进。旧格式 `↳ 断点:` 仍能读（存量不坏）。
+> 面板按缩进画树线，归档时原样保留缩进。
+> 旧版的 `↳ 断点:` 写法已在 1.20.0 移除；存量会在 `abs load` 或任意写操作时
+> 自动迁移成标准子项（内容一条不丢），不需要手工改。
 > 任务 id 不能含空格（用连字符），含空格会被明确拒掉。
 > 旧版 `abs task ...` / `abs board` 已废，打它们会报「未知命令」并退出码 1。
 > `abs wrapup` / `abs teardown-check` 是 hook 内部命令，无需手动调用。

package/bin/abs.js

@@ -311,9 +311,9 @@ const subUsage = {
     '  abs todo                       看板',
     '  abs todo add <id> [--note "做什么"] [--section 讨论中|滞留中|搁置]',
     '  abs todo rename <旧id> --note "<新id>"   改任务 id（起错名/不可读时）',
-    '  abs todo note <id> --note "断点/进度"',
-    '  abs todo bp-done <id>            勾断点 → `↳ [x] 断点:`（做完落一句）',
-    '  abs todo bp-undone <id>          取消勾（勾错了退回）',
+    '  abs todo note <id> --note "进度/子项"     追加一条子项（标准 md 缩进列表）',
+    '  abs todo child-done <id> [--n N]   勾子项（缺省最后一条）',
+    '  abs todo child-undone <id> [--n N] 取消勾',
     '  abs todo memo <id> "随手记（可多句）"  任务笔记 → sessions/，不上看板；无文字=查看',
     '  abs todo state <id> --note 进行中|讨论中|滞留中|搁置',
     '  abs todo done <id> [--as 落地|否决|仅方案] [结语文字]',
@@ -378,8 +378,8 @@ const TODO_ACTIONS = {
   add: 'start',
   start: 'start', // add 的别名(老习惯保留)
   note: 'note',
-  'bp-done': 'bp-done', // 勾断点：`↳ [ ] 断点:` → `↳ [x] 断点:`
-  'bp-undone': 'bp-undone', // 取消勾断点（勾错了退回）
+  'child-done': 'child-done', // 勾子项（标准 md 缩进列表项）
+  'child-undone': 'child-undone', // 取消勾子项
   memo: 'memo', // 任务随手记：多句/追加/不占看板（无文字时=查看）
   state: 'state', // 改行首状态标记：进行中|讨论中|滞留中|搁置（原地，不搬区）
   rename: 'rename', // 改任务 id：人工起错名、或旧 id 不可读时用
@@ -475,7 +475,7 @@ async function main() {
         if (!action) {
           throw new Error(
             `✗ 未知子命令 "${sub}"\n` +
-            `  可用: add / start / note / bp-done / bp-undone / memo / state / done / archive\n` +
+            `  可用: add / start / note / child-done / child-undone / memo / state / done / archive\n` +
             `  看板: abs todo（不带参数）\n` +
             `  登记任务: abs todo add <id> --note "做什么"`,
           );
@@ -499,7 +499,7 @@ async function main() {
           break;
         }
         // 勾/取消勾子项：只收 <id>（子项位置 = 「某任务的第 N 条」，没有自己的 id）
-        if (action === 'bp-done' || action === 'bp-undone') {
+        if (action === 'child-done' || action === 'child-undone') {
           rejectExtra(rest2, `abs todo ${sub} <id> [--n N]`);
           if (!id) throw new Error(`✗ 缺 <id>\n  用法: abs todo ${sub} <id> [--n N]`);
           const n = opts.n ? Number(opts.n) : undefined;

package/bin/mcp.js

@@ -90,7 +90,7 @@ tool(
 
 tool(
   'abs_board',
-  '读取当前项目 todo 看板（含断点/Next-Step）。先 resolve 得到项目，再传其根目录。',
+  '读取当前项目 todo 看板（含任务与子项）。先 resolve 得到项目，再传其根目录。',
   { cwd: z.string().describe('项目根目录（.brain/ 所在处）') },
   async ({ cwd }) => {
     const root = await findBrainRoot(cwd || process.cwd());
@@ -112,12 +112,12 @@ tool(
 
 tool(
   'abs_task',
-  '任务实时落盘（幂等键 = id）。start 登记进 Todo / note 补子项（**追加**，标准 md 嵌套列表，`abs todo note`）/ bp_done、bp_undone 勾/取消勾子项（n=第几条，缺省最后一条）/ memo 任务随手记（多句/追加/不上看板）/ state 改状态 / done 完成归位 Done（done 时 note=结语文字，as=结语类型：落地|否决|仅方案）。必填: cwd, action, id。多会话并行时，start/add 带上 session（值见 system prompt 的 [会话] 段）以标记「这条任务谁在做」。',
+  '任务实时落盘（幂等键 = id）。start 登记进 Todo / note 补子项（**追加**，标准 md 嵌套列表，`abs todo note`）/ child_done、child_undone 勾/取消勾子项（n=第几条，缺省最后一条）/ memo 任务随手记（多句/追加/不上看板）/ state 改状态 / done 完成归位 Done（done 时 note=结语文字，as=结语类型：落地|否决|仅方案）。必填: cwd, action, id。多会话并行时，start/add 带上 session（值见 system prompt 的 [会话] 段）以标记「这条任务谁在做」。',
   {
-    action: z.enum(['add', 'start', 'done', 'note', 'bp_done', 'bp_undone', 'memo', 'state']),
+    action: z.enum(['add', 'start', 'done', 'note', 'child_done', 'child_undone', 'memo', 'state']),
     id: z.string().describe('任务幂等键，如 TASK-xxx 或子任务名'),
-    n: z.number().int().positive().optional().describe('bp_done/bp_undone 用：第几条子项（1-based，缺省=最后一条）'),
-    cwd: z.string().describe('项目根目录（.brain/ 所在处）'),    note: z.string().optional().describe('add/start=做什么; note=断点(文件/到哪步，一句话); memo=随手记（可多句、不定长，追加式；不传=查看已有笔记）; state=进行中|讨论中|滞留中|搁置（搁置=用户改方向/不做了；滞留中=还要做只是卡住）; done=结语文字'),
+    n: z.number().int().positive().optional().describe('child_done/child_undone 用：第几条子项（1-based，缺省=最后一条）'),
+    cwd: z.string().describe('项目根目录（.brain/ 所在处）'),    note: z.string().optional().describe('add/start=做什么; note=追加一条子项(改到哪/下一步，一句话); memo=随手记（可多句、不定长，追加式；不传=查看已有笔记）; state=进行中|讨论中|滞留中|搁置（搁置=用户改方向/不做了；滞留中=还要做只是卡住）; done=结语文字'),
     as: z.enum(['落地', '否决', '仅方案']).optional().describe('仅 done：结语类型。默认 落地。做了又撤/评估后不做用 否决，只设计过用 仅方案 —— 别让假【落地】污染看板'),
     // 会话 id：多会话并行时标记「这条任务是谁在做」。
     // 值取自 system prompt 里的 `[会话] 本会话 id = xxx`（hook 注入），由模型原样回传。
@@ -130,8 +130,8 @@ tool(
     if (!root) return errNoBrain(cwd || process.cwd());
     // add 是 start 的别名（与 CLI `abs todo add` 对齐）
     const act = action === 'add' ? 'start' : action;
-    // bp_done → bp-done（MCP 参数名不用连字符，内部 action 用）
-    const act2 = act === 'bp_done' ? 'bp-done' : act === 'bp_undone' ? 'bp-undone' : act;
+    // child_done → child-done（MCP 参数名不用连字符，内部 action 用）
+    const act2 = act === 'child_done' ? 'child-done' : act === 'child_undone' ? 'child-undone' : act;
     return { content: [{ type: 'text', text: await cmdTask({ dir: root, action: act2, id, note, as, session, n }) }] };
   }
 );

package/hooks/abs.omp.ts

@@ -104,7 +104,7 @@ function inputField(input: unknown, key: string): string {
 }
 
 /** 会改文件的工具名。用于判定「真的开始干活了」—— 排查类会话先跑一堆读命令，
- *  若用「第一次 tool_call」当判据，断点会被写在与任务无关的文件上。
+ *  若用「第一次 tool_call」当判据，子项会被写在与任务无关的文件上。
  *  白名单必须按宿主实际用法穷举，漏一个就把功能静默关掉（含 bash：大量修改是经 bash 完成的）。 */
 const WRITE_TOOL = /^(write|edit|apply_patch|patch|multiedit|notebookedit|bash|shell)$/i
 
@@ -193,6 +193,8 @@ const TODO_GUIDELINES = [
   'Never mark a task "done" when tests are failing, the implementation is partial, or an error is unresolved — keep it in progress and add a task for the blocker instead.',
   'Keep exactly one task in "进行中" at a time; when the user switches direction or drops a task, use action "state" with 搁置 (dropped/not doing it); 滞留中 for still-wanted-but-stuck; 讨论中 for still-open. If you finish one and another is ready, promote it explicitly.',
   'When completing, pick the honest conclusion via the `as` field: 落地 (built and verified) / 否决 (decided against, or built then reverted) / 仅方案 (designed only). A wrong conclusion makes the next session treat "considered" as "completed".',
+  // 文档精简九条（用户 2026-10-22 定，原文见 skill 的「文档精简」一节）：管每一行写进 .brain 的文字。
+  'Every line you write into .brain/ (todo rows, log rows, knowledge pages, session snapshots) must pass the nine-bullet doc-slimming rule in the abs skill: only what serves the topic (drop the rest), no unverified summaries, ordered and layered, plain declarative wording (no rhetorical questions, no guessing), no duplication (cite the other doc instead), terse prohibitions, nothing the user did not ask for, plain Chinese.',
 ]
 
 /** 从 skill 里挑出的【硬规则】—— 只第一轮送, 与 load 同机会（同 pi 版方案 B）。 */
@@ -354,8 +356,8 @@ export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
   rows: { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; sid: string }[]
   hidden: number
 } {
-  // 两阶段：先无过滤地按序解析（断点归属需要「上一条」是原文里真正的前一条），
-  // 再按作者过滤。若边解析边过滤，被滤掉的条目下方的断点会挂到它上面那一条。
+  // 两阶段：先无过滤地按序解析（子项归属需要「上一条」是原文里真正的前一条），
+  // 再按作者过滤。若边解析边过滤，被滤掉的条目下方的子项会挂到它上面那一条。
   type Row = { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; authors: string[]; sid: string }
   const parsed: Row[] = []
   let inTodo = false
@@ -364,7 +366,7 @@ export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
     if (/^##\s+Todo\s*$/.test(line)) { inTodo = true; continue }
     if (/^##\s+/.test(line)) { inTodo = false; continue }
     if (!inTodo) continue
-    // 子项行（标准 md：缩进的 `- [ ]`；旧格式 `↳ 断点:` 继续认）→ 挂到上一条任务
+    // 子项行（标准 md：缩进的 `- [ ]`）→ 挂到上一条任务
     const kid = parseChildLine(line)
     if (kid && kid.indent > 0) {
       const last = parsed[parsed.length - 1]
@@ -372,9 +374,9 @@ export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
       continue
     }
     // `- [ ] [状态] <id> …`；状态标记可能缺省。
-    // 两种前缀都收：`- [ ]`（普通任务）与 `↳ [ ]`（断点任务，2026-10-16 新增）。
-    // 断点任务必须显示 —— 它就是一等待任务（写得进去、看得见、能 done）。
-    const m = line.match(/^\s*(?:-\s*\[ \]|↳\s*\[ \])\s*(?:\[([^\]]+)\]\s*)?(\S+)\s*(.*)$/)
+    // 只认 `- [ ]`（2026-10-20 旧 `↳ [ ]` 写法已废弃）。
+    // 子项任务必须显示 —— 它就是一等待任务（写得进去、看得见、能 done）。
+    const m = line.match(/^\s*-\s*\[ \]\s*(?:\[([^\]]+)\]\s*)?(\S+)\s*(.*)$/)
     if (!m) continue
     const state = m[1] || '进行中'
     const id = m[2]
@@ -417,13 +419,9 @@ async function currentUser(): Promise<string> {
  *  宽度规则：CJK/全角记 2 列，其余记 1 列。 */
 /** 解析子项行（与 src/todo/common.js 的 parseChild 同规则，双份实现 —— 见 pi 版说明）。 */
 function parseChildLine(l: string): { done: boolean; text: string; indent: number } | null {
-  const s = String(l || '')
-  const old = s.match(/^(\s*)↳\s*(?:\[[ x]\]\s*)?(?:断点[:：]\s*)?(.*)$/)
-  if (old) {
-    if (!old[2].trim()) return null
-    return { done: /^\s*↳\s*\[x\]/.test(s), text: old[2].trim(), indent: old[1].length }
-  }
-  const m = s.match(/^(\s+)-\s*\[([ x])\]\s*(.*)$/)
+  // 只认标准 md 缩进子项（2026-10-20 旧箭头写法已废弃）。
+  // 旧行由 CLI 侧 migrateLegacyChild 在读写时迁移掉，面板拿到的已是新格式。
+  const m = String(l || '').match(/^(\s+)-\s*\[([ x])\]\s*(.*)$/)
   if (!m) return null
   return { done: m[2] === 'x', text: m[3].trim(), indent: m[1].length }
 }
@@ -532,7 +530,7 @@ export function renderPanelLines(
     return lines
   }
   data.rows.forEach((t, i) => {
-    // `└─` 只给最后一条 —— 不管它有没有断点（否则末条带断点时全篇没有收尾）。
+    // `└─` 只给最后一条 —— 不管它有没有子项（否则末条带子项时全篇没有收尾）。
     const isLast = i === lastIdx
     const branch = isLast ? '└─' : '├─'
     const anim = t.state === '进行中' && animPhase >= 0 ? ' ' + fg('accent', todoAnimFrame(animPhase)) : ''
@@ -707,7 +705,7 @@ export default function absOmpExtension(pi: ExtensionAPI): void {
   resetThrottle()
 
   pi.on("session_start", (_event: SessionStartEvent, ctx: ExtensionContext) => {
-    // 新会话 = 重新登记：不重置则同进程的第二个会话永远不再落断点
+    // 新会话 = 重新登记：不重置则同进程的第二个会话永远不再落子项
     autoTaskSeen = false
     filesSeen.clear()    // 同理：新会话的文件痕迹不能带到下个会话
     loadInjected.clear() // 同：新会话的每个目录都要重新摆一次开局状态
@@ -743,7 +741,7 @@ export default function absOmpExtension(pi: ExtensionAPI): void {
       pendingTodoTool = true
       logHook(`tool_call todo_tool name=${name} target=${target || '-'}`).catch(() => {})
     }
-    // 自动登记断点：真动文件时把「改到哪个」记进本会话（可观测埋点，不写看板）。
+    // 自动登记子项：真动文件时把「改到哪个」记进本会话（可观测埋点，不写看板）。
     if (!autoTaskSeen && isWriteCall(name, input)) {
       autoTaskSeen = true
       const sid = sessionIdFor(ctx)

package/hooks/abs.pi.ts

@@ -95,15 +95,15 @@ function sessionIdFor(ctx: any): string {
 }
 
 /** 会改文件的工具名。用于判定「真的开始干活了」—— 排查类会话先跑一堆读命令，
- *  若用「第一次 tool_call」当判据，断点会被写在与任务无关的文件上。
+ *  若用「第一次 tool_call」当判据，子项会被记在与任务无关的文件上。
  *
  * 为何含 bash：大量修改是经 bash 完成的（heredoc / sed -i / > 重定向），
- * 漏掉它 = 纯 bash 会话永远不记断点（见 concept opencode-inject-channel-verdict
+ * 漏掉它 = 纯 bash 会话永远不记子项（见 concept opencode-inject-channel-verdict
  * 的同源教训：白名单必须按宿主实际用法穷举，漏一个就把功能静默关掉）。
  */
 const WRITE_TOOL = /^(write|edit|apply_patch|patch|multiedit|notebookedit|bash|shell)$/i
 
-/** bash 命令里没有写入迹象则不算「干活」—— 否则 `ls`/`git status` 也会记断点。 */
+/** bash 命令里没有写入迹象则不算「干活」—— 否则 `ls`/`git status` 也会记子项。 */
 const BASH_WRITES = /(^|[^\w])(>|>>|sed\s+-i|tee\b|mkdir\b|rm\b|mv\b|cp\b|touch\b|cat\s*>)/
 
 /** 这次 tool_call 是否算「真的动了文件」。 */
@@ -145,8 +145,8 @@ let agentEndSeen = false
  * 同样在模块级，理由同上（闭包 flag 在重复注册时不共享）。 */
 let pendingTodoTool = false
 
-/** 本会话是否已记过自动任务断点。模块级（重复注册时闭包 flag 不共享 —— 同 agentEndSeen 的坑）。
- *  只记第一次写文件，不是每次都记：断点是「记到哪」不是流水账。 */
+/** 本会话是否已记过自动任务子项。模块级（重复注册时闭包 flag 不共享 —— 同 agentEndSeen 的坑）。
+ *  只记第一次写文件，不是每次都记：子项是「记到哪」不是流水账。 */
 let autoTaskSeen = false
 
 /** 本会话动过的文件（去重，最多记 FILES_SEEN_MAX 个）。
@@ -219,7 +219,7 @@ const TODO_GUIDELINES = [
   'Use the abs task tool as soon as you receive instructions that involve changing this project — including investigation work where you read code or ask questions before any edit. Call it with action "start" and a short id before the work itself, not after. Skip it for pure questions about general knowledge, one-line answers, and conversation. (Tool name varies by host: `mcp__abs` with tool="abs_task", or `mcp__abs__abs_task`, or `abs_task` — use whichever form this session exposes.)',
   // ② 完成即结：不许攒
   'Mark a task "done" immediately when it finishes — never batch completions at the end of a session.',
-  // ③ 断点：跨会话接力靠它
+  // ③ 子项：跨会话接力靠它
   'Before starting a task, record the checkpoint with action "note" (which file, which step) so a later session can resume.',
   // ④ 反例（照 rpiv-todo）：明确什么情况【不许】标完成 —— 只给正向要求时，
   //   模型倾向于把"我以为做完了"当成完成，结语失真会污染下个会话的判断。
@@ -228,6 +228,9 @@ const TODO_GUIDELINES = [
   'Keep exactly one task in "进行中" at a time; when the user switches direction or drops a task, use action "state" with 搁置 (dropped/not doing it); 滞留中 for still-wanted-but-stuck; 讨论中 for still-open. If you finish one and another is ready, promote it explicitly.',
   // ⑥ 结语要真实：三种结语各有含义，别一律写落地。
   'When completing, pick the honest conclusion via the `as` field: 落地 (built and verified) / 否决 (decided against, or built then reverted) / 仅方案 (designed only). A wrong conclusion makes the next session treat "considered" as "completed".',
+  // ⑦ 文档精简九条（用户 2026-10-22 定，原文见 skill 的「文档精简」一节）：
+  // 管每一行写进 .brain 的文字；与上面六条行为规则不重叠，故不合并。
+  'Every line you write into .brain/ (todo rows, log rows, knowledge pages, session snapshots) must pass the nine-bullet doc-slimming rule in the abs skill: only what serves the topic (drop the rest), no unverified summaries, ordered and layered, plain declarative wording (no rhetorical questions, no guessing), no duplication (cite the other doc instead), terse prohibitions, nothing the user did not ask for, plain Chinese.',
 ]
 
 /** 当前项目是否有 .brain 图谱 —— 有才加指引（没图谱的项目里这指引是噪音）。
@@ -717,15 +720,15 @@ export function pickNickname(rnd: () => number = Math.random): string {
  * who 不为空时只收“我的任务”：行内有 [[who]] 的，或**完全没标作者**的
  * （老任务/手写的没标，漏掉比多显示更糟）。标了别人的则不收。
  *
- * 断点行（缩进的 ↳）归属到它上一条任务，不单独成条。 */
+ * 子项行（缩进的 `- [ ]`）归属到它上一条任务，不单独成条。 */
 export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
   total: number
   rows: { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; sid: string }[]
   hidden: number
 } {
-  // 两阶段：先无过滤地按序解析（断点归属需要“上一条”是原文里真正的前一条），
-  // 再按作者过滤。若边解析边过滤，被滤掉的条目下方的断点会挂到它上面那一条
-  // —— 实测：别人任务的断点会显示在我的任务下面（2026-10-03 审查发现）。
+  // 两阶段：先无过滤地按序解析（子项归属需要“上一条”是原文里真正的前一条），
+  // 再按作者过滤。若边解析边过滤，被滤掉的条目下方的子项会挂到它上面那一条
+  // —— 实测：别人任务的子项会显示在我的任务下面（2026-10-03 审查发现）。
   type Row = { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; authors: string[]; sid: string }
   const parsed: Row[] = []
   let inTodo = false
@@ -734,7 +737,7 @@ export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
     if (/^##\s+Todo\s*$/.test(line)) { inTodo = true; continue }
     if (/^##\s+/.test(line)) { inTodo = false; continue }
     if (!inTodo) continue
-    // 子项行（标准 md：缩进的 `- [ ]`；旧格式 `↳ 断点:` 继续认）→ 挂到上一条任务。
+    // 子项行（标准 md：缩进的 `- [ ]`）→ 挂到上一条任务。
     // 子项可多条、可各自勾选（2026-10-16 用户定）。
     const kid = parseChildLine(line)
     if (kid && kid.indent > 0) {
@@ -743,10 +746,10 @@ export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
       continue
     }
     // `- [ ] [状态] <id> …`；状态标记可能缺省。
-    // 两种前缀都收：`- [ ]`（普通任务）与 `↳ [ ]`（断点任务，2026-10-16 新增）。
-    // 断点任务必须显示 —— 它就是一等等任务（写得进去、看得见、能 done），
+    // 只认 `- [ ]`（2026-10-20 旧 `↳ [ ]` 写法已废弃）。
+    // 子项任务必须显示 —— 它就是一等等任务（写得进去、看得见、能 done），
     // 否则落回「静默死区」（用户在 .brain 里报的原症状）。
-    const m = line.match(/^\s*(?:-\s*\[ \]|↳\s*\[ \])\s*(?:\[([^\]]+)\]\s*)?(\S+)\s*(.*)$/)
+    const m = line.match(/^\s*-\s*\[ \]\s*(?:\[([^\]]+)\]\s*)?(\S+)\s*(.*)$/)
     if (!m) continue
     const state = m[1] || '进行中'
     const id = m[2]
@@ -800,15 +803,11 @@ async function currentUser(): Promise<string> {
  *
  * 为何不 import src：面板是宿主扩展，单独装到 ~/.pi/extensions/，与包内 src/ 不同目录
  * （装完就断了）。故两端各一份 —— 规则简单（两步正则），且两边测试都盖。
- * 标准 md：缩进的 `- [ ] 内容`；旧格式 `↳ [ ] 断点: 内容` / `↳ 断点: 内容` 继续认。 */
+ * 标准 md：缩进的 `- [ ] 内容`。 */
 function parseChildLine(l: string): { done: boolean; text: string; indent: number } | null {
-  const s = String(l || '')
-  const old = s.match(/^(\s*)↳\s*(?:\[[ x]\]\s*)?(?:断点[:：]\s*)?(.*)$/)
-  if (old) {
-    if (!old[2].trim()) return null
-    return { done: /^\s*↳\s*\[x\]/.test(s), text: old[2].trim(), indent: old[1].length }
-  }
-  const m = s.match(/^(\s+)-\s*\[([ x])\]\s*(.*)$/)
+  // 只认标准 md 缩进子项（2026-10-20 旧箭头写法已废弃）。
+  // 旧行由 CLI 侧 migrateLegacyChild 在读写时迁移掉，面板拿到的已是新格式。
+  const m = String(l || '').match(/^(\s+)-\s*\[([ x])\]\s*(.*)$/)
   if (!m) return null
   return { done: m[2] === 'x', text: m[3].trim(), indent: m[1].length }
 }
@@ -945,9 +944,9 @@ export function renderPanelLines(
     return lines
   }
   data.rows.forEach((t, i) => {
-    // `└─` 只给最后一条 —— 不管它有没有断点。
-    // （2026-10-03 审查修正：原条件 `i === lastIdx && !t.note` 会让“末条带断点”时
-    //  全篇没有 └─ 收尾，断点行的 │ 又延伸到视觉底部，看起来像列表被截断。）
+    // `└─` 只给最后一条 —— 不管它有没有子项。
+    // （2026-10-03 审查修正：原条件 `i === lastIdx && !t.note` 会让“末条带子项”时
+    //  全篇没有 └─ 收尾，子项行的 │ 又延伸到视觉底部，看起来像列表被截断。）
     const isLast = i === lastIdx
     const branch = isLast ? '└─' : '├─'
     // 进行中的行带一个小动画（其余行不加，避免满屏都在跳）
@@ -1044,7 +1043,7 @@ export default function absPiHook(pi: ExtensionAPI): void {
   resetThrottle()
 
   pi.on("session_start", (event: any, ctx: any) => {
-    // 新会话 = 重新登记：不重置则同进程的第二个会话永远不再落断点
+    // 新会话 = 重新登记：不重置则同进程的第二个会话永远不再落子项
     autoTaskSeen = false
     filesSeen.clear() // 同理：新会话的文件痕迹不能带到下个会话
     loadInjected.clear() // 同：新会话的每个目录都要重新摆一次开局状态
@@ -1085,8 +1084,8 @@ export default function absPiHook(pi: ExtensionAPI): void {
       pendingTodoTool = true
       logHook(`tool_call todo_tool name=${name} target=${target || '-'}`).catch(() => {})
     }
-    // 自动登记断点（2026-10-05）：真的动文件时，把「改到哪个」记进本会话的自动任务。
-    // 为何不用「第一次 tool_call」：排查类会话先跑一堆读命令，断点会落在无关文件上。
+    // 自动登记子项（2026-10-05）：真的动文件时，把「改到哪个」记进本会话的自动任务。
+    // 为何不用「第一次 tool_call」：排查类会话先跑一堆读命令，子项会落在无关文件上。
     // 写类工具只留一行痕（可观测），不 spawn、不写看板 —— 见上面的删除说明。
     if (!autoTaskSeen && isWriteCall(name, input)) {
       autoTaskSeen = true
@@ -1162,11 +1161,7 @@ export default function absPiHook(pi: ExtensionAPI): void {
           }
           if (rulesOn) openingRulesLogged = true
         }
-        // 【临时取证 2026-10-06】seen= 把 Set 内容原样打出来：
-        //   真实环境里 agent_brain_sync 从未 load_delivered 却 still skip → 与「按 cwd 分」矛盾。
-        //   靠这行区分：Set 空（→ 判断写错）vs Set 里已有该 cwd（→ 有东西提前加进去了）。
-        //   定位并修好后删掉这行。
-        logHook(`before_agent_start todo_guide=${ok ? 'on' : 'off'} load_guide=${loadState} opening_rules=${openingRulesLogged ? 'on' : 'skip'} seen=[${[...loadInjected].join(',')}] pending=[${loadPending}] cwd=${cwd}`).catch(() => {})
+        logHook(`before_agent_start todo_guide=${ok ? 'on' : 'off'} load_guide=${loadState} opening_rules=${openingRulesLogged ? 'on' : 'skip'} cwd=${cwd}`).catch(() => {})
 
         // 自动登记已整体移除（2026-10-05 用户实报两点）：
         //   ① 卡顿 —— agent_end 每轮 spawn 一个 node 进程
@@ -1205,7 +1200,7 @@ export default function absPiHook(pi: ExtensionAPI): void {
     }
     // 每轮 spawn 已删除（2026-10-05 用户实报"卡顿"）：agentEndSeen 一旦置位，
     // 下面那个条件就恒真 → 每轮结束都起一个 node 进程，纯属白烧。
-    // 断点改由 agent 在用 abs_task 时自己写（那时它本来就在跑，不额外起进程）。
+    // 子项改由 agent 在用 abs_task 时自己写（那时它本来就在跑，不额外起进程）。
   })
 
   pi.on("session_shutdown", (_e: any, ctx: any) => {

package/hooks/event.sh

@@ -103,7 +103,7 @@ fi
       printf '[%s] wrapup-remind 会话已结束(%s): 若 Today 有滞留任务或经验未沉淀, 下会话开头走收尾循环\n' \
         "$(date '+%Y-%m-%d %H:%M:%S')" "$SESSION_ID"
     } >> "$LOG_DIR/wrapup.log" 2>/dev/null || true
-    # 机械快照滞留清单: abs wrapup 把当前项目未完成任务+断点追加到 wrapup.log (跨会话收尾保险)。
+    # 机械快照滞留清单: abs wrapup 把当前项目未完成任务+子项追加到 wrapup.log (跨会话收尾保险)。
     # abs wrapup 已自行写 wrapup.log (honor ABS_LOG_DIR); 这里 stdout 只进 hooks.log 作痕迹, 避免污染 wrapup.log。
     "$NODE_BIN" "$ABS_BIN" wrapup >>"$LOG_DIR/hooks.log" 2>/dev/null || true
   fi

package/package.json

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