@fanchao8609/agent_brain_sync 1.30.0 → 1.31.1

package/README.md

@@ -114,7 +114,8 @@ abs todo note    TASK-1 --note "改到 X 文件 L40"   # 追加一条子项（
 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 state   TASK-1 --note "进行中|讨论中|滞留中|搁置"      # 改行首状态标记
+abs todo state   TASK-1 --note "滞留中" --n 2                 # 改第 2 条子项的状态（子项也能标四态）
 abs todo done    TASK-1
 
 abs note "一句话经验" --tags 坑,docker    # 经验暂存 → sources/

package/bin/abs.js

@@ -450,7 +450,7 @@ const subUsage = {
     '  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 state <id> --note 进行中|讨论中|滞留中|搁置 [--n N]   --n = 改第 N 条子项（缺省改任务本身）',
     '  abs todo remove <id>              删除任务（连子项，不可恢复；只是先不做请用 state 搁置）',
     '  abs todo done <id> [--as 落地|否决|仅方案] [结语文字]',
     '  abs todo archive [--keep-days N] [--dry-run]',
@@ -632,7 +632,7 @@ async function main() {
         // memo 同：随手记常是多句带空格，位置参数收全段比 --note 顺手。
         const isDone = action === 'done';
         const isMemo = action === 'memo';
-        const usage = `abs todo ${sub} <id>${isDone ? ' [--as 落地|否决|仅方案] [--note "结语"]' : ' --note "…"'}`;
+        const usage = `abs todo ${sub} <id>${isDone ? ' [--as 落地|否决|仅方案] [--note "结语"]' : action === 'state' ? ' --note "…" [--n N]' : ' --note "…"'}`;
         if (isDone) {
           const note = opts.note || (rest2.length ? rest2.join(' ') : undefined);
           console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note, as: opts.as, session: opts.session }));
@@ -655,7 +655,10 @@ async function main() {
         }
         rejectExtra(rest2, usage);
         if (!id) throw new Error(`✗ 缺 <id>\n  用法: ${usage}`);
-        console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note: opts.note, as: opts.as, session: opts.session }));
+        // --n：子项位置（state 用它改第 n 条子项，与 child-done 同一套坐标）
+        const nKid = opts.n ? Number(opts.n) : undefined;
+        if (opts.n && (!Number.isInteger(nKid) || nKid < 1)) throw new Error(`✗ --n 要是正整数（收到 "${opts.n}"）`);
+        console.log(await cmdTask({ dir: opts.dir, action, id, section: opts.section, note: opts.note, as: opts.as, session: opts.session, n: nKid }));
         break;
       }
       case 'ingest': {

package/bin/mcp.js

@@ -113,11 +113,11 @@ tool(
 
 tool(
   'abs_task',
-  '任务实时落盘（幂等键 = 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 的 [会话] 段）以标记「这条任务谁在做」。',
+  '任务实时落盘（幂等键 = id）。start 登记进 Todo / note 补子项（**追加**，标准 md 嵌套列表，`abs todo note`）/ child_done、child_undone 勾/取消勾子项（n=第几条，缺省最后一条）/ state 改状态（带 n = 改该任务第 n 条子项，子项也能标四态）/ memo 任务随手记（多句/追加/不上看板）/ done 完成归位 Done（done 时 note=结语文字，as=结语类型：落地|否决|仅方案）。必填: cwd, action, id。多会话并行时，start/add 带上 session（值见 system prompt 的 [会话] 段）以标记「这条任务谁在做」。',
   {
     action: z.enum(['add', 'start', 'done', 'note', 'child_done', 'child_undone', 'memo', 'state', 'remove']),
     id: z.string().describe('任务幂等键，如 TASK-xxx 或子任务名'),
-    n: z.number().int().positive().optional().describe('child_done/child_undone 用：第几条子项（1-based，缺省=最后一条）'),
+    'n': z.number().int().positive().optional().describe('child_done/child_undone/state 用：第几条子项（1-based，缺省=最后一条；state 不传 n = 改任务本身）'),
     cwd: z.string().describe('项目根目录（.brain/ 所在处）'),    note: z.string().optional().describe('add/start=做什么; note=追加一条子项(改到哪/下一步，一句话); memo=随手记（可多句、不定长，追加式；不传=查看已有笔记）; state=进行中|讨论中|滞留中|搁置（搁置=用户改方向/不做了；滞留中=还要做只是卡住）; done=结语文字（remove 不用此字段）'),
     as: z.enum(['落地', '否决', '仅方案']).optional().describe('仅 done：结语类型。默认 落地。做了又撤/评估后不做用 否决，只设计过用 仅方案 —— 别让假【落地】污染看板'),
     // 会话 id：多会话并行时标记「这条任务是谁在做」。

package/hooks/abs-rounded-editor/format.ts

@@ -20,13 +20,36 @@ export function shortTokens(n: number | null | undefined): string {
   return String(n)
 }
 
-/** 拼右上角状态：`8.0%/1.0M 模型名`。缺哪段就省哪段。 */
-export function buildStatus(usage: any, modelId: string): string {
+/** 推理档位 → 一个大写字母（用户 2026-11-09 要求：右下角只用一个大写字母表示强度）。
+ *
+ * 为何不取首字母：minimal / medium / max 三个都是 M。这套是手选的无重写法：
+ *   off=O、miNimal=N、Low=L、Medium=M、High=H、Xhigh=X、max=MX（用户指定，其余均单字母）。
+ * 改映射只改这里，并把测试里的表一起改。 */
+export const LEVEL_LETTER: Record<string, string> = {
+  off: 'O',
+  minimal: 'N',
+  low: 'L',
+  medium: 'M',
+  high: 'H',
+  xhigh: 'X',
+  max: 'MX',
+}
+
+/** 档位 → 字母；空值或认不得的档位返回空串（那时不显示）。 */
+export function levelLetter(level: string | null | undefined): string {
+  return LEVEL_LETTER[String(level || '').trim().toLowerCase()] || ''
+}
+
+/** 拼右下角状态：`8.0%/1.0M 模型名 · H`。缺哪段就省哪段。
+ * 第三段是推理档位的一个大写字母（见 LEVEL_LETTER）；模型不支持推理时不显。 */
+export function buildStatus(usage: any, modelId: string, level = ''): string {
   const parts: string[] = []
   if (usage && usage.percent != null) parts.push(`${usage.percent.toFixed(1)}%`)
   if (usage && usage.contextWindow) parts.push(`/${shortTokens(usage.contextWindow)}`)
   const model = shortenModel(modelId)
-  return [parts.join(''), model].filter(Boolean).join(' ')
+  const head = [parts.join(''), model].filter(Boolean).join(' ')
+  const letter = levelLetter(level)
+  return letter ? (head ? `${head} · ${letter}` : letter) : head
 }
 
 export function stripAnsi(s: string): string {
@@ -72,24 +95,28 @@ function dropCols(s: string, n: number): string {
 }
 
 /**
- * 推理强度 → 主题色 token。空串表示「不上色，沿用默认色」。
+ * 推理强度 → 主色。六档灰蓝（同一色相族、由亮到暗），查不到或 off 时返回空串 = 不上色，用默认色。
+ *
+ * ⚠ 当前**输入框不再用它**（2026-11-09 用户要求「完全对齐 pi 原版」：边框改用 pi 给的
+ *   editor.borderColor，即主题那七档 thinking 色）。保留是因为两条：用户在这上面来回改过
+ *   两轮（改回去只改 render() 一行），且 todo 面板（abs.pi.ts）另有一份同值副本。
  *
- * 规则：`thinking` + 首字母大写，正好对上主题里的 thinkingMinimal…thinkingMax 七档。
- * 为什么 off 返回空串而不是 `thinkingOff`：主题给 thinkingOff 的是接近背景的暗灰
- * （dark.json: `okhsl(229 8% 49%)`），拿它去染文字会看不清。用户 2026-11-06 定的是
- * 「off 时保持默认色」。
+ * 为什么 off 不上色：主题给 thinkingOff 的是接近背景的暗灰（dark.json: `okhsl(229 8% 49%)`），
+ * 拿它去染文字会看不清。用户 2026-11-06 定的是「off 时保持默认色」。
+ * 色值定于 2026-11-09：先「暗档提亮」把 medium/low/minimal 抬到看得清，试过一版中性灰又还原回蓝调。
+ * 对深色背景（#0D1117）对比度 11.84/9.22/7.72/6.53/5.42/4.51。
  *
- * ★ 同一份逻辑在 hooks/abs.pi.ts 里也有一份（`effortColorToken`）。不抽公共模块是故意的：
+ * ★ 同一份逻辑在 hooks/abs.pi.ts 里也有一份（`effortAnsi`）。不抽公共模块是故意的：
  *   安装后 `abs.ts` 与 `abs-rounded-editor/` 是两个可独立删除的扩展，抽成共享文件会让
- *   「删掉输入框样式目录」连带把 todo 面板搞崩。
+ *   「删掉输入框样式目录」连带把 todo 面板搞崩。改色值时要两边一起改。
  */
 export const EFFORT_COLOR: Record<string, { rgb: string; ansi256: number }> = {
   max: { rgb: '197;205;220', ansi256: 189 },
   xhigh: { rgb: '168;182;204', ansi256: 152 },
   high: { rgb: '150;166;198', ansi256: 110 },
-  medium: { rgb: '122;138;160', ansi256: 110 },
-  low: { rgb: '94;108;132', ansi256: 103 },
-  minimal: { rgb: '70;82;106', ansi256: 240 },
+  medium: { rgb: '139;153;172', ansi256: 110 },
+  low: { rgb: '124;138;162', ansi256: 103 },
+  minimal: { rgb: '108;124;157', ansi256: 67 },
 }
 
 export function effortAnsi(level: string | null | undefined, colorMode = 'truecolor'): string {
@@ -98,21 +125,6 @@ export function effortAnsi(level: string | null | undefined, colorMode = 'trueco
   return colorMode === 'truecolor' ? `38;2;${g.rgb}` : `38;5;${g.ansi256}`
 }
 
-/** 「搁置」橙 #F59E0B —— 与 todo 面板的 `搁置` 标签同色（abs.pi.ts 的 `C.hold`）。
- *  用途（2026-11-08 用户要求）：输入框上边框**右上角的状态文字**。
- *  ★ 左边的 working 状态（`⠼ Working`）**不用**这个色（用户实测要求）：
- *    它跟框线同色，橙色只标记「上下文占用」。
- *  ★ 色值在 abs.pi.ts 里也有一份，不抽公共模块是故意的（见 EFFORT_COLOR 的注释）。 */
-export const HOLD_COLOR = { rgb: '245;158;11', ansi256: 214 }
-
-export function holdAnsi(colorMode = 'truecolor'): string {
-  return colorMode === 'truecolor' ? `38;2;${HOLD_COLOR.rgb}` : `38;5;${HOLD_COLOR.ansi256}`
-}
-
-/** 上边框最左那段（如 `⠼ Working`）由 pi 画、roundBorder 不单独给它上色：
- *  它随整行用框线色。试过给它上橙，用户实测要求“跟框线同色”，已改回 ——
- *  别再拆一段出来单独染色。 */
-
 /** 用 effortAnsi 的结果包一段文字；空串原样返回（off 时不着色）。 */
 export function paintAnsi(ansi: string, text: string): string {
   return ansi ? `\x1b[${ansi}m${text}\x1b[39m` : text
@@ -127,9 +139,12 @@ export function paintAnsi(ansi: string, text: string): string {
  * leftLabel 贴在左圆角之后；label 贴最右端。哪个放不下就丢掉哪个
  * （宁可没有，也不让边框溢出折行）。
  *
- * opts.labelFg（2026-11-08 用户要求）：只给右边那个状态标签换个色，
- *   其余（圆角、虚线、**以及 pi 画在左边的 working 状态**）仍用 fg。
- *   working 曾经也上橙，用户实测要它跟框线同色，已改回（见下面的注释）。
+ * opts.labelFg：只给右边那个标签（右下角的状态文字）换个色，其余（圆角、虚线）仍用 fg。
+ *   当前调用方不传（状态文字跟框线同色，2026-11-09 用户定）；机制留着，要染色时传一个即可。
+ *
+ * 历史（别再重走）：2026-11-08～09 曾有个 leadFg 开关，用来把 pi 嵌进上边框的
+ *   `⠼ Working` 那段单独染色（橙）。现在 working 已还原成 pi 原版（不嵌边框），
+ *   leadSpanOf/leadFg 一并删了 —— 要再嵌回去就照那时候的写法加。
  */
 export function roundBorder(
   line: string,
@@ -166,12 +181,12 @@ export function roundBorder(
     }
   }
   return paintSpans(left + mid + right, fg, [
-    // 右标签从**末尾**找：万一同一串又出现在左边，不能把左边那个也染成标签色。
+    // 标签从**末尾**找：万一同一串又出现在左边，不能把左边那个也染成标签色。
     [label, opts.labelFg, 'last'],
   ])
 }
 
-/** 把 out 里的几个区间换成各自的色，其余整段用 fg。区间按位置排序、重叠则跳过。
+/** 把 out 里的区间换成各自指定的色，其余整段用 fg。区间按位置排序、重叠则跳过。
  *  为何不用「拼段」实现：标签与 working 段的字符是从 mid 里苹/插进去的，
  *  只有拿到最终串才能准确定位（直接拼段会在 dropCols 后错位）。 */
 function paintSpans(

package/hooks/abs-rounded-editor/index.ts

@@ -3,9 +3,14 @@
  *
  * 需求（2026-11-04 用户）：
  *   ① 输入框左右都有竖线、四角圆角
- *   ② working 不单独占一行，只在上边框显示运行图标（embedWorkingStatus）
- *   ③ 上边框最右侧显示「上下文百分比/上限 模型名」，如 `8.0%/1.0M deepseek-v4.1-flash`
- *   ④ 输入框下方原有 footer 两行全部隐藏
+ *   ② 右下角显示「上下文百分比/上限 模型名」，如 `8.0%/1.0M deepseek-v4.1-flash`
+ *   ③ 输入框下方原有 footer 两行全部隐藏
+ *
+ * 2026-11-09 定案（用户来回试过好几版）：
+ *   ① working 状态交给 pi 嵌在上边框（`embedWorkingStatus: true`）—— 就是 pi 原本那个样子：
+ *      左上角 `⠇ Working` + 动画，颜色随整行走框线色。本扩展**不搬不改字**。
+ *      试过并作废的：搬到右下角居中、正文最右一列、右上角单字符 —— 用户看完都要回左上角。
+ *   ② 边框**和框内文字**都用 pi 给的 `editor.borderColor`（即原版那七档 thinking 色）。
  *
  * 为什么要覆写 render()：
  *   pi 的 Editor.render() 只画上下两条 `─`，每行是「左 padding + 文本 + 右 padding」，
@@ -18,26 +23,16 @@
  * 注意：自动补全菜单行排在底边之下、且自带内容宽度，不套竖线（否则菜单被框住会错位）。
  */
 import { CustomEditor } from '@earendil-works/pi-coding-agent'
-import { buildStatus, effortAnsi, holdAnsi, paintAnsi, roundBorder, shortenModel } from './format.ts'
+import { buildStatus, roundBorder, shortenModel } from './format.ts'
 
 const SIDE = '│'
 
-/** 右上角状态文本，如 `8.0%/1.0M deepseek-v4.1-flash`。render() 拿不到 ctx，故由事件回调维护。 */
+/** 右下角状态文本，如 `8.0%/1.0M deepseek-v4.1-flash · H`。render() 拿不到 ctx，故由事件回调维护。 */
 let statusLabel = ''
 
-/** 当前推理强度（off/minimal/low/medium/high/xhigh/max）。render() 拿不到 ctx，同样这里存。
- *  用途：输入文字随推理强度变色（2026-11-06 用户需求）。 */
+/** 当前推理档位（off/minimal/…/max）。也只是为了拼状态文字 —— 边框颜色是 pi 自己上的。 */
 let effortLevel = ''
 
-/** 取当前主题实例的 getter。
- *
- * ★ 为何不能把主题从构造函数里拿：pi 传给编辑器了的是 `getEditorTheme()`，
- *  那对象只有 `{ borderColor, selectList }`，**没有 `fg`** —— 直接用它上色会静默无效
- *  （不报错，只是没颜色）。真正带 fg 的是 `ctx.ui.theme`（interactive-mode 的 getter）。
- * ★ 为何存 getter 而不是存实例：`/theme` 切主题后 ctx.ui.theme 返回**新实例**，
- *  存旧实例会継续用旧主题的色板。 */
-let themeGetter: (() => any) | null = null
-
 export class RoundedEditor extends CustomEditor {
   render(width: number): string[] {
     if (width < 4) return super.render(width)
@@ -45,70 +40,64 @@ export class RoundedEditor extends CustomEditor {
     const lines = super.render(width - 2)
     if (lines.length < 2) return lines
 
-    const borderColor = (this as any).borderColor?.bind(this)
-    // 现代暗色方案（2026-11-08）：文字 #F8FAFC，边框 #444C56，不再跟推理强度变色。
-    // 光标色 / 输入框背景 / 聚焦外发光是 pi 编辑器内部画的，扩展接管不了，先不动。
-    const colorMode = (() => { try { return String(themeGetter?.().getColorMode()) } catch { return 'truecolor' } })()
-    const textFg = (s: string) => paintAnsi(effortAnsi(effortLevel, colorMode), s)
-    const lineFg = textFg
-    const wrap = lineFg
-    // 右上角状态文字用「搁置」橙 #F59E0B（2026-11-08 用户要求）：
-    // 只染那一段 —— 圆角、虚线、以及 pi 画的 working 状态都跟框线同色
-    // （working 曾也上橙，用户实测「要跟输入框线条颜色一致」，已改回）。
-    const holdFg = (s: string) => paintAnsi(holdAnsi(colorMode), s)
+    // 边框颜色直接用 pi 给编辑器设好的那个（2026-11-09 用户要求「完全对齐原版」）：
+    //   pi 的 interactive-mode 在 updateEditorBorderColor() 里把 editor.borderColor 设成
+    //   theme.getThinkingBorderColor(档位)，bash 模式另给一套 —— 直接复用就等于原版那套
+    //   （含 off 的暗灰），而且 /theme、切档、切 bash 模式时 pi 自己会换并请求重绘。
+    //   光标色 / 输入框背景 / 聚焦外发光是 pi 内部画的，接管不了。
+    const border = (this as any).borderColor
+    const wrap = typeof border === 'function' ? border.bind(this) : (s: string) => s
     const out: string[] = []
 
-    // 上边框：原本是整行 `─`（含 working 图标与滚动提示），两端换圆角，右端贴状态。
-    out.push(roundBorder(lines[0], wrap, '╭', '╮', statusLabel, '', { labelFg: holdFg }))
+    // 上边框：原本是整行 `─`（含 pi 嵌进来的 working 状态与滚动提示），两端换圆角。
+    // working 就是 pi 嵌的那个样子（左上角 `⠇ Working` + 动画），不搬不改字（2026-11-09 定稿）。
+    // 整行会被 roundBorder 重上一次框线色，所以它跟边框同色。
+    out.push(roundBorder(lines[0], wrap, '╭', '╮'))
     // 下边框在原结果的倒数第 (1 + 自动补全行数) 位 —— 补全菜单排在它后面。
     const autocompleteHeight = (this as any).renderedAutocompleteHeight ?? 0
     const bottomIdx = lines.length - 1 - autocompleteHeight
 
-    for (let i = 1; i < bottomIdx; i++) {
-      // 剥掉 pi 原生文字色，再包 #F8FAFC —— 否则内层色码赢。
-      const body = lines[i].replace(/\x1b\[(?!7m)[0-9;]*m/g, '')
-      out.push(wrap(SIDE) + textFg(body) + wrap(SIDE))
+    // 正文行：两端各包一根竖线，文字也上推理色（2026-11-09 用户要求「输入框文字颜色与推理一致」）。
+    // 先剥掉 pi 原生文字色再包 —— 否则内层色码会提前收色，看着像只有前半行有颜色。
+    for (const body of lines.slice(1, bottomIdx)) {
+      out.push(wrap(SIDE) + wrap(body.replace(/\x1b\[[0-9;]*m/g, '')) + wrap(SIDE))
     }
     // 下边框（2026-11-07 还原：左下角的 fanchao·昵称已去掉 —— 用户嫌难看，
     // 回 todo 面板标题；roundBorder 的 leftLabel 参数保留备用）。
-    out.push(roundBorder(lines[bottomIdx], wrap, '╰', '╯'))
+    // 状态文字（`31.8%/1.0M 模型名`）2026-11-09 从右上角搬到右下角，颜色跟框线一致
+    // （用户当日先要搁置橙、看完又要改回推理色 —— 以最新为准）。
+    out.push(roundBorder(lines[bottomIdx], wrap, '╰', '╯', statusLabel))
     // 自动补全行原样透传（不套竖线）。
     for (let i = bottomIdx + 1; i < lines.length; i++) out.push(lines[i])
     return out
   }
 }
 
-/** 刷新右上角状态文本（每次渲染前由事件与定时器调用）。 */
+/** 刷新右下角状态文本（每次渲染前由事件与定时器调用）。 */
 function refreshStatus(ctx: any): void {
   try {
-    statusLabel = buildStatus(ctx?.getContextUsage?.(), ctx?.model?.id ?? '')
+    effortLevel = String(ctx?.thinkingLevel || '')
   } catch {
-    statusLabel = shortenModel(ctx?.model?.id ?? '')
+    effortLevel = ''
   }
-  refreshEffort(ctx)
-}
-
-/** 读出当前推理强度。`ctx.thinkingLevel` 是 pi 官方给扩展的入口（effective level）。 */
-function refreshEffort(ctx: any): void {
   try {
-    effortLevel = String(ctx?.thinkingLevel || '')
+    statusLabel = buildStatus(ctx?.getContextUsage?.(), ctx?.model?.id ?? '', effortLevel)
   } catch {
-    effortLevel = ''
+    statusLabel = shortenModel(ctx?.model?.id ?? '')
   }
 }
 
 export default function piRoundedEditor(pi: any): void {
   pi.on('session_start', (_event: unknown, ctx: any) => {
     if (!ctx?.ui?.setEditorComponent) return
-    // 主题 getter（带 fg 的那个）—— 见 themeGetter 注释。
-    themeGetter = () => ctx.ui?.theme
     refreshStatus(ctx)
-    // 第四个参数 embedWorkingStatus: true —— working 状态进上边框，不再单独占一行。
+    // 第四个参数 embedWorkingStatus: true —— working 状态进上边框，不单独占一行（2026-11-09 用户定案）。
+    // 颜色不用管：pi 嵌入时用 editor.borderColor，本扩展又把整行重上一次框线色，两边同为档位色。
     ctx.ui.setEditorComponent(
       (tui: any, theme: any, keybindings: any) =>
         new RoundedEditor(tui, theme, keybindings, { embedWorkingStatus: true }),
     )
-    // ④ 隐藏输入框下方的 footer 两行（路径/git/token、MCP/扩展状态），信息并入右上角。
+    // ③ 隐藏输入框下方的 footer 两行（路径/git/token、MCP/扩展状态），信息并入右下角。
     ctx.ui.setFooter?.(() => ({ render: () => [], invalidate() {} }))
   })
 
@@ -120,11 +109,9 @@ export default function piRoundedEditor(pi: any): void {
     ctx?.ui?.requestRender?.()
   })
 
-  // 切推理强度时重刷输入框文字色（2026-11-06 用户需求）。
-  // 为何不能只靠 session_start 那一次：/model 的强度档位、Alt+T 之类的切换不改会话，
-  // 不重建编辑器也就不会重新读 effortLevel —— 文字会停在旧色。
+  // 切推理强度：档位字母要跟着变（边框色是 pi 自己换并重绘的，不用管）。
   pi.on('thinking_level_select', (_event: any, ctx: any) => {
-    refreshEffort(ctx)
+    refreshStatus(ctx)
     ctx?.ui?.requestRender?.()
   })
 

package/hooks/abs.pi.ts

@@ -780,13 +780,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; kids: { done: boolean; text: string }[]; sid: string }[]
+  rows: { state: string; id: string; desc: string; kids: { done: boolean; text: string; state: string | null }[]; sid: string }[]
   hidden: number
 } {
   // 两阶段：先无过滤地按序解析（子项归属需要“上一条”是原文里真正的前一条），
   // 再按作者过滤。若边解析边过滤，被滤掉的条目下方的子项会挂到它上面那一条
   // —— 实测：别人任务的子项会显示在我的任务下面（2026-10-03 审查发现）。
-  type Row = { state: string; id: string; desc: string; kids: { done: boolean; text: string }[]; authors: string[]; sid: string }
+  type Row = { state: string; id: string; desc: string; kids: { done: boolean; text: string; state: string | null }[]; authors: string[]; sid: string }
   const parsed: Row[] = []
   let inTodo = false
   for (const raw of String(md || '').split('\n')) {
@@ -861,12 +861,20 @@ async function currentUser(): Promise<string> {
  * 为何不 import src：面板是宿主扩展，单独装到 ~/.pi/extensions/，与包内 src/ 不同目录
  * （装完就断了）。故两端各一份 —— 规则简单（两步正则），且两边测试都盖。
  * 标准 md：缩进的 `- [ ] 内容`。 */
-function parseChildLine(l: string): { done: boolean; text: string; indent: number } | null {
+/** 行首状态标记的四个词（任务行与子项共用；与 CLI 侧 common.js 的 TASK_STATES 同值）。
+ *  两个扩展各自独立安装，所以这里再拄一份，不跨包 import。 */
+const STATE_WORDS = ['进行中', '讨论中', '滞留中', '搁置']
+
+function parseChildLine(l: string): { done: boolean; text: string; indent: number; state: string | null } | null {
   // 只认标准 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 }
+  // 子项也能带状态标记（2026-11-09 用户要求，与任务行同形）：只认四个词，
+  // 别的方括号（如 `[WIP]`）是正文的一部分，原样留在 text 里（同 CLI 侧 parseChild）。
+  const s = m[3].match(/^\[([^\]]+)\]\s*(.*)$/)
+  const state = s && STATE_WORDS.includes(s[1]) ? s[1] : null
+  return { done: m[2] === 'x', text: (state ? s![2] : m[3]).trim(), indent: m[1].length, state }
 }
 
 function dispWidth(s: string): number {
@@ -939,73 +947,65 @@ function clipToWidth(s: string, width: number): string {
  *  拿不到 ctx，只能由事件回调先存好。2026-11-06 用户需求：面板主色跟推理强度走。 */
 let effortLevel = ''
 
-/**
- * 推理强度 → 主题色 token。空串表示「不上推理色，用调用方给的兼底色」。
- *
- * 规则：`thinking` + 首字母大写，正好对上主题里的 thinkingMinimal…thinkingMax 七档。
- * 为什么 off 返回空串而不是 `thinkingOff`：主题给 thinkingOff 的是接近背景的暗灰
- * （dark.json: `okhsl(229 8% 49%)`），拿它去染文字会看不清。用户 2026-11-06 定的是
- * 「off 时保持默认色」。
+/** 档位 → pi 主题里那档 thinking 色（与输入框边框同一个来源）。
  *
- * ★ 同一份逻辑在 hooks/abs-rounded-editor/format.ts 里也有一份（`thinkingColorToken`）。
- *   不抽公共模块是故意的：安装后 `abs.ts` 与 `abs-rounded-editor/` 是两个可独立删除的扩展，
- *   抽成共享文件会让「删掉输入框样式目录」连带把 todo 面板搞崩。
- */
-export const EFFORT_COLOR: Record<string, { rgb: string; ansi256: number }> = {
-  max: { rgb: '197;205;220', ansi256: 189 },
-  xhigh: { rgb: '168;182;204', ansi256: 152 },
-  high: { rgb: '150;166;198', ansi256: 110 },
-  medium: { rgb: '122;138;160', ansi256: 110 },
-  low: { rgb: '94;108;132', ansi256: 103 },
-  minimal: { rgb: '70;82;106', ansi256: 240 },
-}
-
-export function effortAnsi(level: string | null | undefined, colorMode = 'truecolor'): string {
-  const g = EFFORT_COLOR[String(level || '').trim().toLowerCase()]
-  if (!g) return ''
-  return colorMode === 'truecolor' ? `38;2;${g.rgb}` : `38;5;${g.ansi256}`
+ * 为何要向主题要（2026-11-09 用户要求「todo 上的颜色也跟着 pi 输入框的颜色」）：
+ *   那七档色写在主题里（dark.json 的 okhsl），自己拄一份就会跟着主题改而跑偏。
+ * 为何要抠一层正则：getFgAnsi() 返回的是整段 `\x1b[38;2;…m`，而面板内部用的是
+ *   「色码串 + paintAnsi 自己包转义」那套，只能取里面的 `38;2;…`。
+ * 空档位或主题不认这个 token → 返回空串，调用处回落到 C.desc。 */
+export function thinkingAnsiOf(theme: any, level: string | null | undefined): string {
+  const lvl = String(level || '').trim().toLowerCase()
+  if (!lvl) return ''
+  const token = `thinking${lvl[0].toUpperCase()}${lvl.slice(1)}`
+  try {
+    const m = String(theme?.getFgAnsi?.(token) || '').match(/\x1b\[([0-9;]+)m/)
+    return m ? m[1] : ''
+  } catch {
+    return ''
+  }
 }
 
-/** 用 effortAnsi 的结果包一段文字；空串原样返回（off 时不着色）。 */
+/** 用色码串包一段文字（如 `paint('38;2;16;185;129', 'x')`）；空串原样返回。 */
 export function paintAnsi(ansi: string, text: string): string {
   return ansi ? `\x1b[${ansi}m${text}\x1b[39m` : text
 }
 
 export function renderPanelLines(
-  data: { total: number; rows: { state: string; id: string; desc: string; kids?: { done: boolean; text: string }[] }[]; hidden: number },
+  data: { total: number; rows: { state: string; id: string; desc: string; kids?: { done: boolean; text: string; state?: string | null }[] }[]; hidden: number },
   who: string,
   width: number,
   fg: (color: string, s: string) => string,
   nickname = '',
-  effort = '',
+  effortColor = '',
 ): string[] {
   // ★ 空看板不再直接返回空数组（2026-10-06 用户要求：「即便 todo 没有列表，也要在 pi 上显示」）。
   //   理由与看板段一致：面板是「机制在不在」的常驻指示，进去就看不见 = 不知道机制活着。
   //   下面仍要画框和标题，所以这里只是不再提前 return。
   //
-  // ★ 主色跟推理强度走（2026-11-06 用户需求）：标题、[状态]、树线 ├─└─、复选框 [ ]、
-  //   进行中动画同用一色，与 pi 输入框描边/文字同色系。
-  // ★ off 时整块面板用灰阶（同日用户补提：「当推理关闭的时候 todo 面板文字应该全是灰色」）——
-  //   高亮色只在真的开着推理时给，否则「推理关了面板还在发光」让人误以为还在深度思考。
-  //   主色用 muted（中灰），描述与子项降一阶到 dim（深灰），两阶灰保留层次，不一整片平。
-  // 现代暗色方案（2026-11-08 用户给定），不再跟推理强度走。
-  // 标题色（2026-11-08 用户实测「太亮了」）：从纯金 #FFD700 换成与「搁置」同一个橙 #F59E0B
-  //   —— 纯金在暗底上抢眼，标题只是分区标签，不该比当天要做的事更跳。
-  //   代价：标题与 `[搁置]` 标签同色；两者一个在最左（标题）一个在行中（状态），位置分得开。
+  // ★ 文字色跟推理强度走（2026-11-09 用户要求「面板上的文字颜色要与输入框推理强度一致」）：
+  //   标题、树线、任务 id、描述、子项、`+N more` 全用档位色（effortColor，由调用处从主题取）。
+  //   ★ 四个状态标签（进行中/讨论中/滞留中/搁置）**保留各自语义色**，不跟档位走 ——
+  //     用户选的方案：否则四态只能靠文字看，一眼分不出。别再顺手把它们也统一了。
+  //   描述色 C.desc 降为「取不到档位色时的兼底」（主题没这个 token / 模型不支持推理）。
+  // 历史（勿重走）：2026-11-08 曾定过「现代暗色方案：标题橙、树线蓝灰、描述次灰」，已作废。
   const C = {
+    // 面板大标题回到擱置橙 #F59E0B（2026-11-09 用户试过灰白，看完要回橙；沿用 2026-11-08 的定）。
+    // 任务行的 id/描述**不用**这个色 —— 它们跟档位色跑。
     title: '38;2;245;158;11',
     task: '38;2;226;232;240',
     desc: '38;2;148;163;184',
-    tree: '38;2;150;170;198',
     doing: '38;2;16;185;129',
     talk: '38;2;59;130;246',
     hold: '38;2;245;158;11',
     stuck: '38;2;139;92;246',
-    done: '38;2;100;116;139',
   }
   const stateAnsi = (st: string): string =>
     st === '进行中' ? C.doing : st === '讨论中' ? C.talk : st === '搁置' ? C.hold : st === '滞留中' ? C.stuck : C.task
   const paint = (ansi: string, t: string) => paintAnsi(ansi, t)
+  // 面板文字色 = 调用处从主题取的档位色；取不到（主题没这个 token / 模型不支持推理）回落描述灰。
+  // 提到循环外：标题与 `+N more` 也在用它。
+  const eff = effortColor || C.desc
   const lines: string[] = []
   // 上描边行已删除（2026-11-04 用户要求「去掉上边框」）。
   // 历史：那行曾用 `thinkingOff` 对齐 pi 输入框描边色（排查三轮才定色）。
@@ -1028,35 +1028,38 @@ export function renderPanelLines(
     const branch = isLast ? '└─' : '├─'
     // 进行中的行曾带圆圈动画（2026-11-08 用户定：「这个动画没啥用」，整个去掉）。
     // 去掉后 [进行中] 靠状态色区分，不再额外消耗一次 200ms 重绘。
-    const hasState = ['进行中', '讨论中', '搁置', '滞留中'].includes(t.state)
+    const hasState = STATE_WORDS.includes(t.state)
     // 复选框 `[ ]`（2026-10-16 用户要求）：面板是 todo.md 的只读视图，
     // 就该长成 todo 原貌 —— 摆成与文件里 `- [ ]` 同形，读到就认得出对应哪一行。
-    const eff = effortAnsi(effort, 'truecolor') || C.desc
     const box = hasState ? '' : paint(eff, '[ ] ')
     const stPart = hasState
       ? paint(stateAnsi(t.state), `[${t.state}]`)
       : paint(eff, '[待办]')
-    const head = `${paint(C.tree, branch)} ${box}${stPart} ${paint(eff, t.id)}`
-    const desc = t.desc ? ' ' + paint(C.desc, `— ${t.desc}`) : ''
+    const head = `${paint(eff, branch)} ${box}${stPart} ${paint(eff, t.id)}`
+    const desc = t.desc ? ' ' + paint(eff, `— ${t.desc}`) : ''
     lines.push(clipToWidth(head + desc, width))
     if (t.kids && t.kids.length) {
       // 子项：标准 md 嵌套列表 → 画成树
       //   ├─ [ ] 子项一
       //   └─ [x] 子项二
       // 树线前缀 = 父任务的 │（非末条）或空格（末条），与父任务分支对齐。
-      // 勾过的用 dim 压暗（一眼看出哪些已完成），未勾用正常色。
-      const stem = isLast ? '  ' : paint(C.tree, '│ ')
+      // 勾过的用删除线区分（颜色已统一为档位色），未勾不着修饰。
+      const stem = isLast ? '  ' : paint(eff, '│ ')
       const n = t.kids.length
       t.kids.forEach((k, ki) => {
         const kb = ki === n - 1 ? '└─' : '├─'
-        const kbox = paint(eff, k.done ? '[x]' : '[ ]')
-        const ktext = k.done ? `\x1b[9m${paint(C.done, k.text)}\x1b[29m` : paint(C.desc, k.text)
-        lines.push(clipToWidth(`${stem} ${paint(C.tree, kb)} ${kbox} ${ktext}`, width))
+        // 有状态的子项跟任务同形：不画 `[ ]`，改画状态标签（2026-11-09 用户要求子项也能标四态）。
+        const kbox = k.state
+          ? paint(stateAnsi(k.state), `[${k.state}]`)
+          : paint(eff, k.done ? '[x]' : '[ ]')
+        // 勾过的子项靠删除线区分（颜色已统一为档位色，不再降灰）
+        const ktext = k.done ? `\x1b[9m${paint(eff, k.text)}\x1b[29m` : paint(eff, k.text)
+        lines.push(clipToWidth(`${stem} ${paint(eff, kb)} ${kbox} ${ktext}`, width))
       })
     }
   })
 
-  if (data.hidden > 0) lines.push(clipToWidth(paint(C.title, `  +${data.hidden} more`), width))
+  if (data.hidden > 0) lines.push(clipToWidth(paint(eff, `  +${data.hidden} more`), width))
   return lines
 }
 /** 隐藏面板。**必须主动 requestRender** —— 否则数据清了、屏幕还留着旧画面。
@@ -1103,7 +1106,8 @@ async function refreshTodoPanel(ui: any, cwd: string): Promise<void> {
               width,
               (c: string, s: string) => theme.fg(c, s),
               sessionNickname,
-              effortLevel,
+              // 面板主色跟 pi 输入框一致：从主题现取当前档位的 thinking 色（2026-11-09 用户要求）。
+              thinkingAnsiOf(theme, effortLevel),
             ),
           invalidate: () => {},
         }

package/package.json

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

package/skill/abs-agent-brain-sync/SKILL.md

@@ -61,7 +61,8 @@ Then run `abs lint` (dead links, over-size, NO-TAIL).
 abs todo start <id> --note "做什么"      # register (note required)
 abs todo note <id> --note "到哪一步"      # append child (one sentence)
 abs todo done <id> --as 落地|否决|仅方案 "结语"
-abs todo state <id> --note 进行中|讨论中|滞留中|搁置
+abs todo state <id> --note 进行中|讨论中|滞留中|搁置   # 任务本身
+abs todo state <id> --note 滞留中 --n 2              # 第 2 条子项（子项也带四态）
 abs todo remove <id>                     # delete incl. children, no undo
 ```
 

package/src/todo/common.js

@@ -127,6 +127,19 @@ export function isChildLine(l) {
  * 存量靠 migrateLegacyChild 一次性迁移（那是全仓唯一还认得 `↳` 的地方）。 */
 export const CHILD_INDENT = '  ';
 
+/** 行首状态标记的四个词（任务行与子项共用；2026-11-09 起子项也能标）。
+ *  放在本文件而不是 spec.js：parseChild / renderChild 要用它判「行首 [xx] 是不是状态」，
+ *  而 common.js 是不 import 任何模块的叶子（spec.js 反向 re-export），放 spec 会成环。 */
+export const TASK_STATES = ['进行中', '讨论中', '滞留中', '搁置'];
+
+/** 把 `[xx] 正文` 拆成 { state, text }：只认 TASK_STATES 里的词，
+ *  别的方括号（如 `[WIP]`）是正文的一部分，原样留在 text 里。 */
+function splitStateMark(rest) {
+  const raw = String(rest ?? '');
+  const m = raw.match(/^\[([^\]]+)\]\s*(.*)$/);
+  return m && TASK_STATES.includes(m[1]) ? { state: m[1], text: m[2] } : { state: null, text: raw };
+}
+
 /** 唯一还认得旧 `↳` 写法的地方 —— 存量迁移。
  *
  * 为何保留这一个函数（2026-10-20 用户定：彻底去掉断点写法，但存量要自动迁移）：
@@ -155,13 +168,15 @@ export function migrateLegacyChild(l) {
 export function parseChild(l) {
   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 };
+  const { state, text } = splitStateMark(m[3]);
+  return { done: m[2] === 'x', text: text.trim(), indent: m[1].length, state };
 }
 
 /** 生成子项行（标准 md，统一入口 —— 格式只有这一个真源）。
- * indent 默认 2（挂在顶层任务下）；多层嵌套时传更深的值。 */
-export function renderChild(text, { done = false, indent = CHILD_INDENT } = {}) {
-  return `${indent}- ${done ? '[x]' : '[ ]'} ${text}`;
+ * indent 默认 2（挂在顶层任务下）；多层嵌套时传更深的值。
+ * state 传四态之一则写成 `  - [ ] [滞留中] 正文`（与任务行同形）。 */
+export function renderChild(text, { done = false, indent = CHILD_INDENT, state = null } = {}) {
+  return `${indent}- ${done ? '[x]' : '[ ]'} ${state ? `[${state}] ` : ''}${text}`;
 }
 
 /** Todo 分区里「合法行」以外的东西 = 裸文本（总结/报告/清单）。

package/src/todo/spec.js

@@ -199,7 +199,9 @@ export function indexLinkSectionNeeds(section) {
  *   搁置   = 不做了 / 用户改方向了           → 下会话不该捡，除非用户又提
  * 混在一起会让下会话分不清「该不该接着干」。 */
 
-export const TASK_STATES = ['进行中', '讨论中', '滞留中', '搁置'];
+// 四个状态词已挪到 common.js（2026-11-09：子项也能标状态，parseChild/renderChild 要用它）——
+// 这里只做转发，别处的 import 路径不变。
+export { TASK_STATES } from './common.js';
 
 /** 结构重建（B 档）：以标准分区表为准重排整个文件。
  *

package/src/todo/task-cmd.js

@@ -4,7 +4,7 @@
 import { brainPath, requireBrain } from '../index.js';
 import { editFile, SKIP } from '../lock.js';
 import { requireUser, atTag } from '../userconfig.js';
-import { stripStateMark, checkTaskBox, stateOfTaskLine, upsertTask, today, setBreakpoint, setBreakpointDone, setMemo, readMemo, setStateMark, TASK_STATES, insertDoneGrouped, idOfTaskLine, DONE_KINDS, withDoneKind, sessionOf, parseChild, migrateLegacyChild, SEC } from '../todo.js';
+import { stripStateMark, checkTaskBox, stateOfTaskLine, upsertTask, today, setBreakpoint, setBreakpointDone, setMemo, readMemo, setStateMark, setChildStateMark, TASK_STATES, insertDoneGrouped, idOfTaskLine, DONE_KINDS, withDoneKind, sessionOf, parseChild, migrateLegacyChild, SEC } from '../todo.js';
 import { ensurePersonPage } from '../note.js';
 
 // 纪律: task 过程动作(start/done/note/blocked)只改 todo.md, 不写 log.md。
@@ -131,8 +131,9 @@ export async function cmdTask({ dir, action, id, section, note, as, session, n }
     return done ? `✓ 任务改名 ${id} → ${newId}` : `[NO_MATCH] 未找到含 "${id}" 的未完成任务行`;
   }
   if (action === 'state') {
-    // 改状态标记（原地，不搬区）：进行中 / 讨论中 / 滞留中
-    if (!note) throw new Error(`✗ 用法: abs todo state <id> --note "${TASK_STATES.join('|')}"`);
+    // 改状态标记（原地，不搬区）：进行中 / 讨论中 / 滞留中 / 搁置。
+    // 带 n = 改某任务的第 n 条子项（2026-11-09 用户要求给子项加状态）；不带给 n = 改任务本身。
+    if (!note) throw new Error(`✗ 用法: abs todo state <id> --note "${TASK_STATES.join('|')}" [--n N]`);
     if (!TASK_STATES.includes(note)) {
       throw new Error(`✗ 状态只接受: ${TASK_STATES.join(' | ')}（收到 "${note}"）`);
     }
@@ -140,11 +141,16 @@ export async function cmdTask({ dir, action, id, section, note, as, session, n }
     let cc = [];
     await editFile(f, (cur) => {
       if (cur === null) return SKIP;
-      const r = setStateMark(cur, id, note);
+      const r = n ? setChildStateMark(cur, id, n, note) : setStateMark(cur, id, note);
       cc = r.changed;
       return r.changed.length ? { text: r.text } : SKIP;
     });
-    return cc.length ? `✓ ${id} 状态 → [${note}]` : `[NO_MATCH] 未找到含 "${id}" 的未完成任务行，或状态未变`;
+    if (!cc.length) {
+      return n
+        ? `[NO_MATCH] "${id}" 下没有第 ${n} 条子项（或任务不存在），或状态未变`
+        : `[NO_MATCH] 未找到含 "${id}" 的未完成任务行，或状态未变`;
+    }
+    return `✓ ${id} ${n ? `第 ${n} 条子项` : ''}状态 → [${note}]`;
   }
   // 删除任务（2026-11-05 用户要求「每次删除任务可烦人了」）。
   // 与 state=搁置 的区别（别混）：

package/src/todo/tasks.js

@@ -198,13 +198,43 @@ export async function setBreakpointDone(brainRoot, { id, n, done = true }) {
     if (target === undefined) return SKIP;
     const child = parseChild(lines[target]);
     picked = child;
-    lines[target] = renderChild(child.text, { done });
+    // 保留印过的状态标记（2026-11-09）：只翻复选框，不能把 [滞留中] 这类标记抹掉。
+    lines[target] = renderChild(child.text, { done, indent: ' '.repeat(child.indent), state: child.state });
     return { text: lines.join('\n'), ok: true };
   });
   if (res === SKIP || !picked) {
     return { ok: false, msg: `[NO_MATCH] "${id}" 下没有第 ${n || '(最后)'} 条子项（或任务不存在）` };
   }
-  return { ok: true, msg: `✓ 子项 ${done ? '已勾' : '已取消勾'} → ${id}\n  ${renderChild(picked.text, { done })}` };
+  return { ok: true, msg: `✓ 子项 ${done ? '已勾' : '已取消勾'} → ${id}\n  ${renderChild(picked.text, { done, state: picked.state })}` };
+}
+
+/** 改**子项**的状态标记（2026-11-09 用户要求：子项也要能标四态）。
+ *
+ * 为何不复用 setStateMark：子项没有自己的 id，findTaskLine 只能定位任务行
+ * （idOfTaskLine 取的是行首第一个 token，子项那行取到的是正文首字），
+ * 所以子项只能按「某任务的第 n 条」定位（与 child-done 同一套坐标）。
+ *   任务行：`- [ ] [进行中] TASK-1 …`
+ *   子项行：`  - [ ] [滞留中] 改到哪一步`
+ * n 必填（1-based）：不带 n 的「改状态」= 改任务本身（setStateMark），
+ * 子项路径只由带 n 的调用进来。非正整数或越界 → 当没匹配，不静默改到别的行。 */
+export function setChildStateMark(text, id, n, state) {
+  if (!TASK_STATES.includes(state)) return { text, changed: [] };
+  if (!Number.isInteger(n) || n < 1) return { text, changed: [] };
+  const lines = String(text ?? '').split('\n');
+  const idx = findTaskLine(lines, id);
+  if (idx === -1) return { text, changed: [] };
+  const kids = childRange(lines, idx);
+  const target = kids[n - 1];
+  if (target === undefined) return { text, changed: [] };
+  const child = parseChild(lines[target]);
+  if (!child || child.state === state) return { text, changed: [] };
+  const ord = kids.indexOf(target) + 1;
+  lines[target] = renderChild(child.text, {
+    done: child.done,
+    indent: ' '.repeat(child.indent),
+    state,
+  });
+  return { text: lines.join('\n'), changed: [`${id} 第 ${ord} 条子项状态 → ${state}`] };
 }
 
 // ---------- 任务随手记（memo）----------

package/src/todo.js

@@ -7,5 +7,5 @@ export { LEGACY_SECTION_RENAMES, TODO_SECTIONS, TODO_SUBSECTIONS, isAllowedTodoS
 export { todoTemplate, rebuildStructure, dropRetiredSections, enforceBrainFormat, normalizeTodo, ensureStateMark, stateOfTaskLine, stripStateMark, checkTaskBox } from './todo/structure.js';
 export { checkFileShape, violationSignatures, assertNoStrayBlank, assertTodoContent } from './todo/validate.js';
 export { doneDateOf, doneKindOf, withDoneKind, collapseDone, archiveDoneInText, renderArchiveBody, upsertArchiveSection, groupDoneSection, insertDoneGrouped, archiveBrief } from './todo/archive.js';
-export { readTodo, ensureTodo, setStateMark, addTask, upsertTask, idOfTaskLine, findTaskLine, setBreakpoint, setBreakpointDone, setMemo, readMemo, boardText } from './todo/tasks.js';
+export { readTodo, ensureTodo, setStateMark, setChildStateMark, addTask, upsertTask, idOfTaskLine, findTaskLine, setBreakpoint, setBreakpointDone, setMemo, readMemo, boardText } from './todo/tasks.js';
 export { migrateLegacyChild, isTaskLine, isChildLine, CHILD_INDENT } from './todo/common.js';