@fanchao8609/agent_brain_sync 1.17.2 → 1.19.0

package/hooks/abs.pi.ts

@@ -336,8 +336,11 @@ export function boardGuideline(md: string, who: string, touched: string[] = [],
     let tag = ''
     if (r.sid) tag = r.sid === mySid ? '[本会话] ' : `[会话 ${r.sid}] `
     const head = `  ${tag}${r.state ? `[${r.state}] ` : ''}${r.id}${r.desc ? ` — ${r.desc}` : ''}`
-    // 断点必须带上：它就是「改到哪一步」，丢了等于对齐了也接不上。
-    return r.note ? `${head}\n    ↳ ${r.note}` : head
+    // 子项必须带上：它就是「改到哪一步」，丢了等于对齐了也接不上（2026-10-05 实测）。
+    // 与面板同形（`- [ ]` 缩进），让 LLM 看到的就是文件里的结构。
+    if (!r.kids || !r.kids.length) return head
+    const kidLines = r.kids.map((k) => `    - ${k.done ? '[x]' : '[ ]'} ${k.text}`)
+    return [head, ...kidLines].join('\n')
   })
   const more = total > rows.length ? `  …另 ${total - rows.length} 条` : ''
   // 本会话动过的文件 —— 与看板并列摆出，让 LLM 自己对照（不判断算不算任务）。
@@ -717,13 +720,13 @@ export function pickNickname(rnd: () => number = Math.random): string {
  * 断点行（缩进的 ↳）归属到它上一条任务，不单独成条。 */
 export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
   total: number
-  rows: { state: string; id: string; desc: string; note: string; sid: string }[]
+  rows: { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; sid: string }[]
   hidden: number
 } {
   // 两阶段：先无过滤地按序解析（断点归属需要“上一条”是原文里真正的前一条），
   // 再按作者过滤。若边解析边过滤，被滤掉的条目下方的断点会挂到它上面那一条
   // —— 实测：别人任务的断点会显示在我的任务下面（2026-10-03 审查发现）。
-  type Row = { state: string; id: string; desc: string; note: string; authors: string[]; sid: string }
+  type Row = { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; authors: string[]; sid: string }
   const parsed: Row[] = []
   let inTodo = false
   for (const raw of String(md || '').split('\n')) {
@@ -731,15 +734,19 @@ 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
-    // 断点行：`  ↳ 断点: …`（缩进）→ 挂到上一条任务
-    const note = line.match(/^\s+↳\s*断点:\s*(.*)$/)
-    if (note) {
+    // 子项行（标准 md：缩进的 `- [ ]`；旧格式 `↳ 断点:` 继续认）→ 挂到上一条任务。
+    // 子项可多条、可各自勾选（2026-10-16 用户定）。
+    const kid = parseChildLine(line)
+    if (kid && kid.indent > 0) {
       const last = parsed[parsed.length - 1]
-      if (last && !last.note) last.note = note[1].trim()
+      if (last) last.kids.push(kid)
       continue
     }
-    // `- [ ] [状态] <id> …`；状态标记可能缺省
-    const m = line.match(/^-\s+\[\s\]\s+(?:\[([^\]]+)\]\s+)?(\S+)\s*(.*)$/)
+    // `- [ ] [状态] <id> …`；状态标记可能缺省。
+    // 两种前缀都收：`- [ ]`（普通任务）与 `↳ [ ]`（断点任务，2026-10-16 新增）。
+    // 断点任务必须显示 —— 它就是一等等任务（写得进去、看得见、能 done），
+    // 否则落回「静默死区」（用户在 .brain 里报的原症状）。
+    const m = line.match(/^\s*(?:-\s*\[ \]|↳\s*\[ \])\s*(?:\[([^\]]+)\]\s*)?(\S+)\s*(.*)$/)
     if (!m) continue
     const state = m[1] || '进行中'
     const id = m[2]
@@ -757,12 +764,12 @@ export function parseOpenTasks(md: string, max = PANEL_MAX_ROWS, who = ''): {
       .replace(/^\s*—\s*/, '')
       .replace(/\s*\(认领[^)]*\)\s*$/, '')
       .trim()
-    parsed.push({ state, id, desc, note: '', authors, sid })
+    parsed.push({ state, id, desc, kids: [], authors, sid })
   }
   const mine = who
     ? parsed.filter((r) => r.authors.length === 0 || r.authors.includes(who))
     : parsed
-  const rows = mine.map(({ state, id, desc, note, sid }) => ({ state, id, desc, note, sid }))
+  const rows = mine.map(({ state, id, desc, kids, sid }) => ({ state, id, desc, kids, sid }))
   return { total: rows.length, rows: rows.slice(0, max), hidden: Math.max(0, rows.length - max) }
 }
 
@@ -789,6 +796,23 @@ async function currentUser(): Promise<string> {
  *
  * 宽度规则：CJK/全角记 2 列，其余记 1 列。足够让面板不溢出（不能处理 emoji ZWJ 序列，
  * 但面板里没有—— todo 内容是任务名与说明）。 */
+/** 解析子项行（与 src/todo/common.js 的 parseChild 同规则，双份实现）。
+ *
+ * 为何不 import src：面板是宿主扩展，单独装到 ~/.pi/extensions/，与包内 src/ 不同目录
+ * （装完就断了）。故两端各一份 —— 规则简单（两步正则），且两边测试都盖。
+ * 标准 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*(.*)$/)
+  if (!m) return null
+  return { done: m[2] === 'x', text: m[3].trim(), indent: m[1].length }
+}
+
 function dispWidth(s: string): number {
   let w = 0
   let i = 0
@@ -884,7 +908,7 @@ export function todoAnimFrame(phase: number): string {
 }
 
 export function renderPanelLines(
-  data: { total: number; rows: { state: string; id: string; desc: string; note: string }[]; hidden: number },
+  data: { total: number; rows: { state: string; id: string; desc: string; kids?: { done: boolean; text: string }[] }[]; hidden: number },
   who: string,
   width: number,
   fg: (color: string, s: string) => string,
@@ -928,13 +952,26 @@ export function renderPanelLines(
     const branch = isLast ? '└─' : '├─'
     // 进行中的行带一个小动画（其余行不加，避免满屏都在跳）
     const anim = t.state === '进行中' && animPhase >= 0 ? ' ' + fg('accent', todoAnimFrame(animPhase)) : ''
-    const head = `${fg('dim', branch)} ${fg(colorOf(t.state), `[${t.state}]`)} ${fg('text', t.id)}${anim}`
+    // 复选框 `[ ]`（2026-10-16 用户要求）：面板是 todo.md 的只读视图，
+    // 就该长成 todo 原貌 —— 摆成与文件里 `- [ ]` 同形，读到就认得出对应哪一行。
+    const box = fg('dim', '[ ]')
+    const head = `${fg('dim', branch)} ${box} ${fg(colorOf(t.state), `[${t.state}]`)} ${fg('text', t.id)}${anim}`
     const desc = t.desc ? ` ${fg('dim', '—')} ${fg('muted', t.desc)}` : ''
     lines.push(clipToWidth(head + desc, width))
-    if (t.note) {
-      // 断点行：挂在父任务下。末条时用空格对齐（└─ 下方无续）；否则用 │ 延伸。
-      const cont = isLast ? '  ' : fg('dim', '│ ')
-      lines.push(clipToWidth(`${cont} ${fg('dim', '↳ ' + t.note)}`, width))
+    if (t.kids && t.kids.length) {
+      // 子项：标准 md 嵌套列表 → 画成树
+      //   ├─ [ ] 子项一
+      //   └─ [x] 子项二
+      // 树线前缀 = 父任务的 │（非末条）或空格（末条），与父任务分支对齐。
+      // 勾过的用 dim 压暗（一眼看出哪些已完成），未勾用正常色。
+      const stem = isLast ? '  ' : fg('dim', '│ ')
+      const n = t.kids.length
+      t.kids.forEach((k, ki) => {
+        const kb = ki === n - 1 ? '└─' : '├─'
+        const kbox = fg('dim', k.done ? '[x]' : '[ ]')
+        const ktext = fg(k.done ? 'dim' : 'muted', k.text)
+        lines.push(clipToWidth(`${stem} ${fg('dim', kb)} ${kbox} ${ktext}`, width))
+      })
     }
   })
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fanchao8609/agent_brain_sync",
-  "version": "1.17.2",
+  "version": "1.19.0",
   "description": "agent-brain-sync: 跨会话 AI 编码记忆 — hook 纯触发 + CLI/MCP 读写 .brain markdown 图谱, 防并发写保护。",
   "type": "module",
   "license": "MIT",
@@ -36,6 +36,7 @@
     "abs": "node bin/abs.js",
     "mcp": "node bin/mcp.js",
     "test": "node --test 'test/*.test.js' 'skill/**/*.test.js'",
+    "fuzz": "node scripts/fuzz.mjs 800",
     "lint": "eslint .",
     "check": "node --experimental-vm-modules --no-warnings scripts/check-syntax.mjs && eslint .",
     "prepack": "node -e \"require('fs').chmodSync('bin/abs.js',0o755);require('fs').chmodSync('bin/mcp.js',0o755)\"",

package/src/hosts.js

@@ -45,6 +45,16 @@ export const HOSTS = [
     skillSub: join('agent', 'skills'), // pi 用户级 skill 在 ~/.pi/agent/skills (非 ~/.pi/skills)
     events: ['SessionStart', 'UserPromptSubmit', 'Stop'],
   },
+  {
+    key: 'omp',
+    label: 'omp (oh-my-pi)',
+    // 落盘: <configRoot>/agent/extensions/abs.ts（native provider 自动发现 .ts/.js）
+    // 与 pi 的差异（源码核对，见 hooks/abs.omp.ts 文件头）：before_agent_start 只给
+    // systemPrompt 整体替换（无 promptGuidelines）；session_start 无 reason 字段。
+    configRoot: () => process.env.ABS_OMP_HOME || join(HOME, '.omp'),
+    skillSub: join('agent', 'skills'), // omp 用户级 skill 在 ~/.omp/agent/skills
+    events: ['SessionStart', 'UserPromptSubmit', 'Stop'],
+  },
 ];
 
 export function hostByKey(key) {

package/src/install.js

@@ -854,12 +854,65 @@ async function uninstallPi() {
   return steps;
 }
 
+// ============================ omp (oh-my-pi, TS extension) ============================
+// 与 pi 宿主**不同构**：omp 的 before_agent_start 只给 `systemPrompt: string[]`（整体替换），
+// 没有 pi 的 promptGuidelines；session_start 也没有 reason 字段。故用专用模板 abs.omp.ts。
+// MCP 落 <configRoot>/agent/mcp.json 的 mcpServers（omp 官方首选用户级路径，见 omp://mcp-config.md）。
+function ompPluginSource() {
+  return renderPluginTemplate('abs.omp.ts', {
+    '@@ABS_BIN@@': stableBinPath('abs.js'),
+    '@@MARK@@': MARK,
+  });
+}
+
+async function installOmp({ withMcp, withSkill }) {
+  const steps = [];
+  const dir = join(hostConfigRoot('omp'), 'agent', 'extensions');
+  const p = join(dir, 'abs.ts');
+  await atomicWrite(p, ompPluginSource());
+  steps.push(`✓ hook(ts extension) → ${p}`);
+  if (withMcp) {
+    // omp native MCP 配置：<configRoot>/agent/mcp.json 的 mcpServers（stdio）。
+    // 不用 .mcp.json / 项目根 mcp.json —— 那两个是「可移植 fallback」，优先级最低。
+    const mcpP = join(hostConfigRoot('omp'), 'agent', 'mcp.json');
+    await backup(mcpP);
+    const cfg = await readJson(mcpP);
+    cfg.mcpServers = cfg.mcpServers || {};
+    cfg.mcpServers['abs'] = { type: 'stdio', command: process.execPath, args: [mcpEntryPath()] };
+    await atomicWrite(mcpP, JSON.stringify(cfg, null, 2));
+    steps.push(`✓ MCP    → ${mcpP} (mcpServers.abs, stdio)`);
+  }
+  if (withSkill) {
+    steps.push(...await installSkills('omp'));
+  }
+  return steps;
+}
+
+async function uninstallOmp() {
+  const steps = [];
+  await fs.rm(join(hostConfigRoot('omp'), 'agent', 'extensions', 'abs.ts'), { force: true });
+  steps.push(`✓ extension 已删除`);
+  steps.push(...await uninstallSkills('omp'));
+  const mcpP = join(hostConfigRoot('omp'), 'agent', 'mcp.json');
+  const cfg = await readJson(mcpP, { strict: false });
+  if (cfg === null) {
+    steps.push(`⚠ ${mcpP} 无法解析为 JSON，已跳过（未改动你的配置）`);
+  }
+  if (cfg && cfg.mcpServers && cfg.mcpServers.abs) {
+    delete cfg.mcpServers.abs;
+    await atomicWrite(mcpP, JSON.stringify(cfg, null, 2));
+    steps.push(`✓ MCP 已从 ${mcpP} 移除`);
+  }
+  return steps;
+}
+
 // ============================ 向导入口 ============================
 const INSTALLERS = {
   'claude-code': { on: installClaudeCode, off: uninstallClaudeCode },
   codex:         { on: installCodex,      off: uninstallCodex },
   opencode:      { on: installOpenCode,   off: uninstallOpenCode },
   pi:            { on: installPi,         off: uninstallPi },
+  omp:           { on: installOmp,        off: uninstallOmp },
 };
 
 export function installSummary() {

package/src/lint.js

@@ -5,7 +5,7 @@ import { join } from 'node:path';
 import { requireBrain, brainPath, BRAIN_DIR } from './index.js';
 import { readRules, idOfPage, statusOfPage, supersededByOf, clip, RULE_BODY_MAX } from './store.js';
 import { doneKindOf, doneDateOf, checkFileShape, TODO_MAX_LINES, LOG_MAX_LINES, INDEX_MAX_LINES } from './todo.js';
-import { isAllowedTodoLine, todoSectionOf } from './todo/common.js';
+import { isAllowedTodoLine, todoSectionOf, parseChild } from './todo/common.js';
 
 // ---------- 图谱遍历 ----------
 
@@ -143,8 +143,10 @@ async function checkRootFiles(vault) {
           `总结/报告/清单请分流：流水 → abs log，经验 → abs note，长设计 → sources/)`,
         );
       }
-      if (!l.trimStart().startsWith('↳ 断点:')) continue;
-      const bp = l.trimStart().slice('↳ 断点:'.length).trim();
+      // 断点行（新旧格式同一个解析器 —— 不再自己切前缀）
+      const bpLine = parseChild(l);
+      if (!bpLine) continue;
+      const bp = bpLine.text;
       if (bp.length > LINT_BREAKPOINT_MAX) {
         issues.push(
           `TODO-BREAKPOINT-BLOAT: ${BRAIN_DIR}/${file}:${i + 1} (断点 ${bp.length} 字 > ${LINT_BREAKPOINT_MAX}；` +

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 } from './index.js';
 import { requireUser, atTag, getUser, placeholderWarn } from './userconfig.js';
-import { stripStateMark, ensureStateMark, stateOfTaskLine, TODO_MAX_LINES, upsertTask, boardText, readTodo, todoTemplate, today, localStamp, setBreakpoint, setMemo, readMemo, setStateMark, TASK_STATES, insertDoneGrouped, idOfTaskLine, archiveDoneInText, upsertArchiveSection, DONE_KINDS, withDoneKind, collapseDone, SEC, rebuildStructure, enforceBrainFormat, sessionOf } from './todo.js';
+import { stripStateMark, checkTaskBox, ensureStateMark, stateOfTaskLine, TODO_MAX_LINES, upsertTask, boardText, readTodo, todoTemplate, today, localStamp, setBreakpoint, setBreakpointDone, setMemo, readMemo, setStateMark, TASK_STATES, insertDoneGrouped, idOfTaskLine, archiveDoneInText, upsertArchiveSection, DONE_KINDS, withDoneKind, collapseDone, SEC, rebuildStructure, enforceBrainFormat, sessionOf, parseChild } from './todo.js';
 import { setFormatGate, editFile, SKIP } from './lock.js';
 import { appendWrapup, strandedFor } from './wrapup.js';
 import { keywords, recentFiles, topicStrength } from './relevant.js';
@@ -350,7 +350,7 @@ export async function cmdLoad({ dir }) {
   );
   if (stranded.length) {
     const rows = stranded.map((t) => {
-      const bp = t.bp.length ? `\n    ${t.bp.map((b) => `↳ 断点: ${b}`).join('\n    ')}` : '';
+      const bp = t.bp.length ? `\n    ${t.bp.map((b) => (b.startsWith('[') ? `↳ ${b}` : `↳ 断点: ${b}`)).join('\n    ')}` : '';
       return `  - ${t.body}${bp}`;
     });
     // 插在项目行之后、其它内容之前
@@ -807,7 +807,18 @@ function recentLogLines(text, n) {
 // ---------- task: 登记/推进（幂等键 = 行首 id；hook 也调这个） ----------
 // 纪律: task 过程动作(start/done/note/blocked)只改 todo.md, 不写 log.md。
 // log.md 是「工作成果沉淀摘要」(用户/AI 主动 abs log "..." 记), 不收工具动作流水。
-export async function cmdTask({ dir, action, id, section, note, as, session }) {
+export async function cmdTask({ dir, action, id, section, note, as, session, n }) {
+  // ★ id 校验（2026-10-16 模糊测试找出来的真 bug）：id 不能含空白/方括号。
+  //   不校就是**静默丢信息**：id="带 空格" 写进文件时被 extractId 截成 "带"，
+  //   后面的 "空格" 与描述一起消失，不报错（实测：`abs todo start "带 空格"` 落成 `- [ ] 带`）。
+  //   宁可明确拒掉，也不替人猜哪个词算 id。
+  const idStr = id === undefined || id === null ? '' : String(id);
+  if (idStr && (idStr.includes(' ') || idStr.includes('\t'))) {
+    throw new Error(
+      `✗ 任务 id 不能含空格（收到 "${idStr}"）—— id 是一个词，空白会被当分隔符。\n` +
+      `  想要带空格的名字：用连字符或下划线；完整名称写进 --note。`,
+    );
+  }
   const root = await requireBrain(dir || process.cwd());
   // 写操作守卫：无姓名不落盘（hook 调的 wrapup/teardown-check 不经过这里，不受影响）
   const who = await requireUser();
@@ -929,6 +940,12 @@ export async function cmdTask({ dir, action, id, section, note, as, session }) {
     const r = await setBreakpoint(root, { id, text: note });
     return r.msg;
   }
+  // 勾/取消勾断点：断点是待办，做完要勾（2026-10-16）。
+  // 单独两个子命令而不是 `--done true/false` —— 勾与取消是两件事，各自一个动词更顺手。
+  if (action === 'bp-done' || action === 'bp-undone') {
+    const r = await setBreakpointDone(root, { id, n, done: action === 'bp-done' });
+    return r.msg;
+  }
   if (action === 'memo') {
     // 任务随手记：多句/不定长/可追加，不占看板。无 note 时 = 查看已有笔记。
     if (!id) return '用法: abs todo memo <id> "随手记（可多句）"  |  abs todo memo <id>（查看）';
@@ -982,7 +999,7 @@ async function markDone(file, id, kind = '落地', conclusion, bySid = '') {
         //   done 未给 sid → 沿用认领的（无新信息，不凭空编）
         const claimSid = sessionOf(l);
         const doneSid = bySid || claimSid;
-        const base = stripStateMark(l).replace('- [ ]', '- [x]').replace(/\s*\(认领[^)]*\)/, '');
+        const base = checkTaskBox(stripStateMark(l)).replace(/\s*\(认领[^)]*\)/, '');
         const parts = [];
         if (claimSid && doneSid && claimSid !== doneSid) {
           parts.push(`(认领 ${today()} ${claimSid})`);
@@ -990,7 +1007,16 @@ async function markDone(file, id, kind = '落地', conclusion, bySid = '') {
         parts.push(`(完成 ${today()}${doneSid ? ' ' + doneSid : ''})`);
         const head = withDoneKind(`${base}${tail} ${parts.join(' ')}`, kind);
         const bp = [];
-        while (i + 1 < lines.length && lines[i + 1].trimStart().startsWith('↳')) bp.push(lines[++i]);
+        // 子项随任务一起搬运（标准 md：缩进的 `- [ ]`；旧格式 `↳ …` 也认）。
+        // 原实现只认 `↳`，换成标准 md 后子项会留在原区——即「任务走了子项没走」。
+        while (i + 1 < lines.length) {
+          const nx = lines[i + 1];
+          if (!nx.trim()) break;
+          const kid = parseChild(nx);
+          if (kid && kid.indent > 0) bp.push(lines[++i]);
+          else if (nx.trimStart().startsWith('↳')) bp.push(lines[++i]);
+          else break;
+        }
         moved = [head, ...bp];
         continue;
       }

package/src/todo/archive.js

@@ -23,10 +23,15 @@ export function doneKindOf(line) {
 
 export function withDoneKind(line, kind) {
   if (!kind) return line;
-  const base = String(line).replace(/【(落地|否决|仅方案)】/g, '').replace(/\s{2,}/g, ' ').trimEnd();
-  const i = base.lastIndexOf(' (完成 ');
-  if (i === -1) return `${base} 【${kind}】`;
-  return `${base.slice(0, i)} 【${kind}】${base.slice(i)}`;
+  const s = String(line);
+  // 行首缩进必须原样保留 —— 断点任务（`  ↳ [ ] …`）靠缩进表达它挂在父任务下。
+  // 原实现整体 `.replace(/\s{2,}/g,' ')` 会把两空格缩进压成一个，
+  // 完成行归位 Done 后缩进就丢了（2026-10-16 实测）。
+  const lead = (s.match(/^\s*/) || [''])[0];
+  const rest = s.slice(lead.length).replace(/【(落地|否决|仅方案)】/g, '').replace(/\s{2,}/g, ' ').trimEnd();
+  const i = rest.lastIndexOf(' (完成 ');
+  if (i === -1) return `${lead}${rest} 【${kind}】`;
+  return `${lead}${rest.slice(0, i)} 【${kind}】${rest.slice(i)}`;
 }
 
 /** 判断一行是否为任务行（- [x] / - [ ]，允许缩进）。 */
@@ -36,11 +41,13 @@ function parseDoneUnits(bodyLines) {
   let cur = null;
   for (const l of bodyLines) {
     if (/^### /.test(l.trim()) || l.trim() === '') { cur = null; continue; } // 分组标题/空行断开会话
-    if (isTaskLine(l)) {
+    // 先判子项再判任务：缩进的 `- [ ]` 两个判据都为真，而它应挂到父任务。
+    // （标准 md 嵌套下子项本身就是任务行 —— 靠缩进区分层级，不靠形态。）
+    if (cur && isChildLine(l)) {
+      cur.lines.push(l);
+    } else if (isTaskLine(l)) {
       cur = { date: doneDateOf(l), lines: [l] };
       units.push(cur);
-    } else if (isChildLine(l) && cur) {
-      cur.lines.push(l); // 附属行挂到上一个任务
     }
   }
   return units;
@@ -217,7 +224,10 @@ export function archiveDoneInText(text, { keepDays = 3, from = today(), maxLines
       date,
       lines: gLines,
       slug: slugFor(date),
-      count: gLines.filter((l) => /^\s*- \[x\]/.test(l)).length,
+      // 只数顶层任务（缩进 0）—— 子项也是 `- [x]`，用 /^\s*- \[x\]/
+      // 会把子项一起计数（实测：1 任务 + 1 子项 → 报 "完成任务 2 条"）。
+      // 归档标记的语义是「完成了多少条任务」，子项不算。
+      count: gLines.filter((l) => /^- \[x\]/.test(l)).length,
     });
   }
 

package/src/todo/common.js

@@ -98,13 +98,61 @@ export function sentenceCount(s) {
  *  现在直接报错，让写入方自己写对。
  *  允许的位置：H1 与首个标签之间、标签与首条目之间、区与区之间（排版需要）。 */
 
+/** 任务行：`- [ ] …` / `- [x] …`。
+ *
+ * 顶层任务：顶格（缩进 0）的 `- [ ]` 行。
+ * 子任务：缩进的 `- [ ]` 行（标准 Markdown 嵌套列表，2 空格一层）。
+ * 两者**都是任务行**（子任务可各自勾选）；层级的区分看缩进，不在本函数。
+ *
+ * 为何也收 `↳ [ ]`：2026-10-16 早上刚把断点任务升级成一等任务（存量数据里有），
+ * 现在改用标准 md 嵌套列表，旧形态继续认（存量不能变“看不见”）。 */
 export function isTaskLine(l) {
-  return /^\s*- \[[ x]\]/.test(l);
+  // 先排旧式断点行：`↳ [ ] 断点: x` 形似任务行，但它带 `断点:` ⇒ 是子项文本，不是任务。
+  if (/^\s*↳\s*\[[ x]\]\s*断点[:：]/.test(l)) return false;
+  return /^\s*(?:-\s*\[[ x]\]|↳\s*\[[ x]\])/.test(l);
 }
-/** 判断一行是否为任务附属行（↳ 开头）。 */
 
+/** 一行是否任务附属行（子项）：缩进的 `- [ ]`，或旧的 `↳ …` 形态。
+ *
+ * 标准 md 下子项就是缩进的列表项 —— 它本身也是任务行（isTaskLine 为真），
+ * 但**不单独成条**：它挂在父任务下，不占顶层 id、不参与 `abs todo done`。
+ * 故 isChild 的判据是「有缩进」，不是「形态不同」。 */
 export function isChildLine(l) {
-  return /^\s*↳/.test(l);
+  if (/^\s*↳/.test(l)) return true;          // 旧形态（含 `↳ [ ]` 断点任务）
+  return /^\s+-\s*\[[ x]\]/.test(l);         // 缩进的 `- [ ]`（新形态）
+}
+
+// ---------- 子项行（标准 md 嵌套列表：缩进 2 空格 + `- [ ]`） ----------
+/** 子项 = 挂在任务下的可勾条目（旧的「断点」就是一条子项）。
+ *
+ * 格式（2026-10-16 用户定）：标准 Markdown 嵌套列表，不搞自定义前缀。
+ *   - [ ] [进行中] 主任务
+ *     - [x] 已完成的子项
+ *     - [ ] 还没做的子项
+ * 旧格式 `↳ 断点: 内容` **继续承认**（存量数据不能坏），新写入一律用标准 md。 */
+export const CHILD_INDENT = '  ';
+
+/** 解析子项行 → { done, text, indent }；不是子项返回 null。
+ * 两种形态都收：新的 `  - [ ] 内容` 与旧的 `  ↳ [ ] 断点: 内容` / `  ↳ 断点: 内容`。 */
+export function parseChild(l) {
+  const s = String(l || '');
+  // 旧形态（↳ 开头）：剥掉 ↳ 与可选复选框及可选的 `断点:` 标签
+  const old = s.match(/^(\s*)↳\s*(\[[ x]\])?\s*(?:断点[:：]\s*)?(.*)$/);
+  if (old) {
+    // 勾选看 ↳ 后的那个复选框；旧格式无勾 ⇒ false
+    if (!old[3].trim()) return null;  // `↳ [ ]` 后面没内容 = 不是子项（是旧一等任务的空壳）
+    return { done: old[2] === '[x]', text: old[3].trim(), indent: old[1].length };
+  }
+  // 新形态（缩进的 `- [ ]`）—— 必须缩进，否则那是顶层任务
+  const m = s.match(/^(\s+)-\s*\[([ x])\]\s*(.*)$/);
+  if (!m) return null;
+  return { done: m[2] === 'x', text: m[3].trim(), indent: m[1].length };
+}
+
+/** 生成子项行（标准 md，统一入口 —— 格式只有这一个真源）。
+ * indent 默认 2（挂在顶层任务下）；多层嵌套时传更深的值。 */
+export function renderChild(text, { done = false, indent = CHILD_INDENT } = {}) {
+  return `${indent}- ${done ? '[x]' : '[ ]'} ${text}`;
 }
 
 /** Todo 分区里「合法行」以外的东西 = 裸文本（总结/报告/清单）。
@@ -148,9 +196,16 @@ export function isPlaceholder(line) {
 
 export function extractId(text) {
   // 先剥行首状态标记（`[进行中] <id>`），否则 id 会取成 "[进行中]"（2026-09-13 实测）。
-  const t = String(text).replace(/^\[[^\]]+\]\s+/, '');
-  const m = t.match(/^([A-Za-z][\w-]*)\b/);
-  return m ? m[1] : null;
+  // 再剥具体的 `- [ ] ` / `↳ [ ] ` 前缀（CLI 传完整行时）。
+  const t = String(text)
+    .replace(/^\s*(?:-\s*\[[ x]\]|↳\s*\[[ x]\])\s*/, '')
+    .replace(/^\[[^\]]+\]\s+/, '');
+  // id = 到第一个空白 / `[` 为止的连续字符（id 不允许含空格或方括号）。
+  // ★ 必须支持**中文 id**（2026-10-16 实测）：原正则 `^[A-Za-z][\w-]*` 要求英文开头，
+  //   中文 id 一律返回 null → findTaskLine 永远找不到 → 同 id 重复 start 每次都新建
+  //   （幂等静默失效，实测同一 id 落了两行）。中文写作里拿短语当 id 很自然，不能只收 ASCII。
+  const m = t.match(/^([^\s[\]]+)/);
+  return m ? m[1].replace(/\u200b/g, '') : null;
 }
 
 /** 提取 " — " 后的 note 部分（剥掉紧跟在 id 后的 `@author` 标记及尾部 `(认领 ...)`）。

package/src/todo/spec.js

@@ -140,8 +140,8 @@ export const ENTRY_SHAPES = {
         if (m[1] === ' ' && !/^\[[^\]]+\]\s*\S/.test(rest)) {
           return '未完成任务应为 `- [ ] [状态] …`（状态：进行中/讨论中/滞留中）';
         }
-        // 断点附属行不能挤在同一行（应另起 `  ↳ 断点: `）
-        if (/↳\s*断点:/.test(rest)) return '断点要另起一行写 `  ↳ 断点: …`';
+        // 断点附属行不能挤在同一行（应另起 `  ↳ [ ] 断点: `）
+        if (/↳\s*(?:\[[ x]\]\s*)?断点[:：]/.test(rest)) return '断点要另起一行写 `  ↳ [ ] 断点: …`';
         return null;
       },
     },

package/src/todo/structure.js

@@ -299,26 +299,34 @@ export function normalizeTodo(text) {
   return out.join('\n');
 }
 
-/** 给任务行补行首状态标记（已有则不覆盖）。`- [ ] id …` → `- [ ] [状态] id …` */
-
+/** 给任务行补行首状态标记（已有则不覆盖）。`- [ ] id …` → `- [ ] [状态] id …`
+ *  两种前缀（`- [ ]` / 断点任务 `↳ [ ]`）与缩进都认 —— 否则存量迁移时断点任务补不上标记。 */
 export function ensureStateMark(line, state) {
-  const m = String(line).match(/^(- \[[ x]\] )(\[[^\]]+\]\s+)?(.*)$/);
+  const m = String(line).match(/^(\s*(?:-\s*\[[ x]\]|↳\s*\[[ x]\])\s*)(\[[^\]]+\]\s+)?(.*)$/);
   if (!m) return line;
   if (m[2] && TASK_STATES.includes(m[2].trim().replace(/[\x5B\x5D]/g, ''))) return line;
   return `${m[1]}[${state}] ${m[3]}`;
 }
 
-/** 取任务行的状态标记；无标记返回 null。 */
-
+/** 读任务行的状态标记；两种前缀（`- [ ]` / 断点任务 `↳ [ ]`）与缩进都认。 */
 export function stateOfTaskLine(line) {
-  const m = String(line).match(/^- \[[ x]\] \[([^\]]+)\]/);
+  const m = String(line).match(/^\s*(?:-\s*\[[ x]\]|↳\s*\[[ x]\])\s*\[([^\]]+)\]/);
   return m && TASK_STATES.includes(m[1]) ? m[1] : null;
 }
 
-/** 改任务行的状态标记（原地）。未找到或非法状态返回原样。 */
+/** 剥掉任务行的状态标记（`- [ ] [进行中] id …` → `- [ ] id …`），保留前缀与缩进。 */
 
 export function stripStateMark(line) {
-  return String(line).replace(/^(- \[[ x]\] )\[[^\]]+\] /, '$1');
+  // 两种前缀都剥：`- [ ] `（普通任务）与 `↳ [ ] `（断点任务，带缩进）。
+  // 原正则写死 `^- \[[ x]\] ` —— 断点任务（2026-10-16 新增形态）匹配不上，
+  // 后果是状态标记没被剥掉、markDone 的 `- [ ]`→`- [x]` 也落空（实测：完成行仍是 `[ ]`）。
+  return String(line).replace(/^(\s*(?:-\s*\[[ x]\]|↳\s*\[[ x]\])\s*)\[[^\]]+\]\s*/, '$1');
+}
+
+/** 把未完成任务行的复选框从 `[ ]` 翻到 `[x]`（保留原前缀与缩进）。
+ *  单独抽出：断点任务的 `↳ ` 前缀 + 缩进必须原样保留，用固定的 `- [ ]` 字面替换会漏。 */
+export function checkTaskBox(line) {
+  return String(line).replace(/^(\s*(?:-\s*|↳\s*))\[ \]/, '$1[x]');
 }
 
 /** 从已完成任务行提取 `(完成 YYYY-MM-DD)` 日期；无则返回 ''。兼容中英文括号。 */