modusensus · Nov 11, 2026 · Nov 12, 2026 · Nov 13, 2026 · Nov 13, 2026 · coderabbitai
diff --git a/dsh-mneme/CHANGELOG.md b/dsh-mneme/CHANGELOG.md
@@ -2,6 +2,9 @@
 
 ## [Unreleased]
 
+- **wiki 面板三处「给人看」的口径修正：机器标记不再露、文件 status 与库同步、树的缩进看真父子（#582）**：chorography 的价值主要在「人看」，但面板把三件「给程序看的东西」也摆了出来。**① `<!-- CHORO:T1:START/END -->` 等机器标记原样显示**——`renderWikiMarkdown` 没有 HTML 注释分支，t0/t1 用来剥段与回填的段落边界成了一行行裸文本；现在渲染层跳过「整行以 `<!--` 开头」的行，且**挂在代码围栏分支之后**（``` 块里的 HTML 注释是内容不是标记，先剥了它示例就缺行）；`choro_read_page` 的工具回执与磁盘文件原样不动——真源纪律只约束数据面，渲染层另有一层口径。**② frontmatter 的 `status` 在 T1 之后不回写**——T1 成功只改库（`markChoroPageEnriched`），文件里那行永远停在 T0 写的 `skeleton`：11 个已富化模块页的文件与数据库状态全部不一致，看文件的人会以为从没富化过。现在 T1 成功路径（`enrichPageFile` → `markChoroPageEnriched` 同一条）把 `status: enriched` 一起写进 frontmatter（键名进 `render.js` 的 `FM_STATUS`，与 verified 两键同住——frontmatter 的形状属于页面格式）；失败路径不写，文件停在 skeleton 与「首次失败不标 failed（骨架仍是有效产物）」的库侧口径一致；重富化幂等覆写、不重复插行。**存量已富化页的文件不做批量回填**（那些文件有用户手写的 HUMAN 保留区，机器批量改写内容文件不可逆），重跑一次 T1 即自然对齐。**③ 左侧模块树的缩进按 slug 连字符数算**——slugify 把路径分隔与一切非字母数字都变成 `-`，目录名自带的连字符与去重序号（`-2`）都会冒充层级，`packages-computer-use-src` 被画成三层深而 `docs`/`root` 顶格；现在用 `moduleMap` 本来就返回的 `id`/`parent_id` 建真父子序：根（无父或父不在表里）按 slug 序先出、孩子紧跟父后，环成员防御性归入根层兜底（宁可用根层平铺也不能静默丢行——树少一页等于入口没了）。回归测试 5 条：T1 成功把文件 status 推进到 enriched / 重富化幂等且 status 只有一行 / 失败路径不动文件 / 渲染器跳过分支必须挂在围栏分支之后 / 树构建必须用 parent_id 且连字符计数彻底退场。变异自证 4 例（删标记跳过 → 红；树退回连字符 → 红；撤 status 回写 → 红；回写错值 skeleton → 红），恢复后全绿。
+
+## [0.14.0-beta.3] - 2026-11-12
 - **品牌视觉换新：README 头图与插件列表图标**。三处 README（根、`dsh-mneme/`、`mcp/`）顶部改用 `images/mneme-banner-hero.webp`（1672×941，282 KiB）——原图 2.1 MiB 的 PNG 会让 `images/` 目录体积翻倍。根目录用相对路径，两个子目录用 raw 绝对地址：npm 详情页不解析相对图片路径，`../images/...` 在 npmjs.com 上必然裂图。
 - **插件列表图标从手绘 SVG 换成位图**：`package.json` 的 `icon` 改为 `assets/icon.png`（256×256 RGBA、圆角透明、120 KiB，仍在宿主 `iconOf()` 的 256 KiB 上限内）；`assets/icon.svg` 删除。列表图标不再要求与客户端内联 mark（`MNEME_MARK_D`）同形，`test/client.test.js` 的图标用例改验 PNG 魔数、IHDR 边长、位深与 RGBA 通道——宿主对坏文件是静默回落成通用插画，不报错。
 

diff --git a/dsh-mneme/lib/client.js b/dsh-mneme/lib/client.js
@@ -11586,6 +11586,11 @@ window.__ModuleLoader__.load({
       };
       let listItems = [];
       let inCode = false;
+      // 围栏要记「开启用的字符与长度」（PR #678 评审）：只认三反引号会把
+      // `~~~html` 整块当正文，于是一条 `<!-- -->` 注释行会被下面的隐藏规则
+      // 删掉；四反引号块内部出现三反引号时旧写法也会提前退出代码态。
+      // CommonMark：结束围栏必须与开启同字符、长度不小于开启、其后只有空白。
+      let fence = null;
       let codeLines = [];
       // --- 表格（v0.11.1 美化）：连续 `|` 行解析成真 table，不再按等宽行画竖线 ---
       const splitRow = (line) => String(line).trim().replace(/^\|/, "").replace(/\|$/, "")
@@ -11627,14 +11632,31 @@ window.__ModuleLoader__.load({
       };
       for (; i < lines.length; i++) {
         const line = lines[i];
-        if (line.trim().startsWith("```")) {
-          if (inCode) {
+        const fenceOpen = /^(`{3,}|~{3,})(.*)$/.exec(line.trim());
+        if (!inCode && fenceOpen) {
+          flushList(); flushTable();
+          inCode = true;
+          fence = { ch: fenceOpen[1][0], len: fenceOpen[1].length };
+          codeLines = [];
+          continue;
+        }
+        if (inCode) {
+          if (fenceOpen && fenceOpen[1][0] === fence.ch && fenceOpen[1].length >= fence.len
+            && fenceOpen[2].trim() === "") {
             out.push(h("pre", { key: out.length, className: "mneme-wikipre" }, codeLines.join("\n")));
-            codeLines = []; inCode = false;
-          } else { flushList(); flushTable(); inCode = true; }
+            codeLines = []; inCode = false; fence = null;
+          } else {
+            codeLines.push(line);
+          }
           continue;
         }
-        if (inCode) { codeLines.push(line); continue; }
+        // 机器标记行不进正文（#582）：`<!-- CHORO:T1:START/END -->` 与
+        // `<!-- CHORO:HUMAN:START/END -->` 是 t0/t1 剥段与回填用的段落边界，
+        // 给程序看的；排版里它们是一行裸文本噪音。只隐藏「整行以 <!-- 开头」
+        // 的情况；代码围栏里的注释原样保留（上面 inCode 分支已经 continue），
+        // choro_read_page 的工具回执与磁盘文件同样原样——真源纪律只约束数据
+        // 面，渲染层另有一层口径。
+        if (/^\s*<!--/.test(line)) continue;
         const heading = line.match(/^(#{1,6})\s+(.*)$/);
         if (heading) {
           flushList(); flushTable();
@@ -13576,9 +13598,40 @@ window.__ModuleLoader__.load({
           if (c.reason === "unverifiable") return t("wiki.drift.unverifiable");
           return String(c.reason ?? "");
         };
+        // 树的层级看 parent_id 真父子（#582），不看 slug 里的连字符数——
+        // slugify 把路径分隔与一切非字母数字都变成 `-`，目录名自带的连字符与
+        // 去重序号（-2）都会冒充层级，`packages-computer-use-src` 会被画成
+        // 三层深。moduleMap 本来就回了 id/parent_id，拿它建序：根（无父或父
+        // 不在表里）按 slug 序先出、孩子紧跟父后；环成员防御性归入兜底。
+        const depthById = new Map();
+        const order = [];
+        {
+          const ids = new Set(state.modules.map((m) => m.id));
+          const byParent = new Map();
+          for (const mod of state.modules) {
+            const pid = mod.parent_id != null && ids.has(mod.parent_id) ? mod.parent_id : null;
+            if (!byParent.has(pid)) byParent.set(pid, []);
+            byParent.get(pid).push(mod);
+          }
+          const bySlug = (a, b) => (a.slug < b.slug ? -1 : a.slug > b.slug ? 1 : 0);
+          for (const list of byParent.values()) list.sort(bySlug);
+          const walk = (pid, depth) => {
+            for (const mod of byParent.get(pid) || []) {
+              if (depthById.has(mod.id)) continue; // 环防御：同一模块只进一次
+              depthById.set(mod.id, depth);
+              order.push(mod);
+              walk(mod.id, depth + 1);
+            }
+          };
+          walk(null, 0);
+          // 兜底：上面走不到的（不该存在的环）按 slug 序补在根层，不静默丢行。
+          for (const mod of state.modules.slice().sort(bySlug)) {
+            if (!depthById.has(mod.id)) { depthById.set(mod.id, 0); order.push(mod); }
+          }
+        }
         const tree = [];
-        for (const mod of state.modules) {
-          const depth = (mod.slug.match(/-/g) || []).length;
+        for (const mod of order) {
+          const depth = depthById.get(mod.id) ?? 0;
           // 树里直接挂「这页有几条要复核」：用户不用先点开才知道哪页被改动碰到。
           const dp = driftBySlug.get(mod.slug);
           const riskN = dp && dp.atRisk ? dp.atRisk.length : 0;

diff --git a/dsh-mneme/lib/wiki/render.js b/dsh-mneme/lib/wiki/render.js
@@ -30,6 +30,11 @@ export const T1_SECTION_END = "<!-- CHORO:T1:END -->";
 export const FM_VERIFIED_BASELINE = "verifiedBaseline";
 export const FM_VERIFIED_AT = "verifiedAt";
 
+// 页面生命周期档（#582）：status 也是 frontmatter 键，但它 T0 / T1 都写——T0
+// 起骨架时写 skeleton，T1 成功时随 verified 两键一起推进 enriched。定义在这
+// 与另两个键同住：frontmatter 的形状属于页面格式。
+export const FM_STATUS = "status";
+
 /** frontmatter 边界：首行 --- 与下一个 --- 的行号；不存在返回 null。 */
 function frontmatterBounds(lines) {
   if (String(lines[0] ?? "").trim() !== "---") return null;

diff --git a/dsh-mneme/lib/wiki/t1.js b/dsh-mneme/lib/wiki/t1.js
@@ -25,7 +25,7 @@ import { tmpdir } from "node:os";
 import { realpathSync } from "node:fs";
 import {
   extractHumanBlocks, injectHumanBlocks, T1_SECTION_START, T1_SECTION_END,
-  FM_VERIFIED_AT, FM_VERIFIED_BASELINE, setFrontmatterKeys,
+  FM_VERIFIED_AT, FM_VERIFIED_BASELINE, FM_STATUS, setFrontmatterKeys,
 } from "./render.js";
 import { gitHead } from "./t0.js";
 // issue #607：拒绝文案里的 CLI 命令要给绝对路径入口（profile 装的插件没有全局
@@ -566,6 +566,13 @@ function enrichPageFile(pageFile, sections, { verifiedBaseline = null, verifiedA
   const finalContent = setFrontmatterKeys(withHuman, [
     [FM_VERIFIED_BASELINE, verifiedBaseline],
     [FM_VERIFIED_AT, verifiedAt],
+    // 文件里的 status 与库里的 choro_pages.status 同步推进（#582）：此前 T1
+    // 成功只改库（markChoroPageEnriched），文件那行永远停在 T0 写的 skeleton
+    // ——页面文件自身与数据库状态不一致，看文件的人会以为这页从没富化过。
+    // 失败路径不写它：文件停在 skeleton 与「首次失败不标 failed」的口径一致
+    // （recordChoroPageFailure 改的是库）。T0 重跑整页重写、status 回 skeleton，
+    // 与「T0 丢弃语义段」同一件事。
+    [FM_STATUS, "enriched"],
   ]);
   writeFileSync(pageFile, finalContent, "utf8");
 }

diff --git a/dsh-mneme/src/wiki/render.js b/dsh-mneme/src/wiki/render.js
@@ -30,6 +30,11 @@ export const T1_SECTION_END = "<!-- CHORO:T1:END -->";
 export const FM_VERIFIED_BASELINE = "verifiedBaseline";
 export const FM_VERIFIED_AT = "verifiedAt";
 
+// 页面生命周期档（#582）：status 也是 frontmatter 键，但它 T0 / T1 都写——T0
+// 起骨架时写 skeleton，T1 成功时随 verified 两键一起推进 enriched。定义在这
+// 与另两个键同住：frontmatter 的形状属于页面格式。
+export const FM_STATUS = "status";
+
 /** frontmatter 边界：首行 --- 与下一个 --- 的行号；不存在返回 null。 */
 function frontmatterBounds(lines) {
   if (String(lines[0] ?? "").trim() !== "---") return null;

diff --git a/dsh-mneme/src/wiki/t1.js b/dsh-mneme/src/wiki/t1.js
@@ -25,7 +25,7 @@ import { tmpdir } from "node:os";
 import { realpathSync } from "node:fs";
 import {
   extractHumanBlocks, injectHumanBlocks, T1_SECTION_START, T1_SECTION_END,
-  FM_VERIFIED_AT, FM_VERIFIED_BASELINE, setFrontmatterKeys,
+  FM_VERIFIED_AT, FM_VERIFIED_BASELINE, FM_STATUS, setFrontmatterKeys,
 } from "./render.js";
 import { gitHead } from "./t0.js";
 // issue #607：拒绝文案里的 CLI 命令要给绝对路径入口（profile 装的插件没有全局
@@ -566,6 +566,13 @@ function enrichPageFile(pageFile, sections, { verifiedBaseline = null, verifiedA
   const finalContent = setFrontmatterKeys(withHuman, [
     [FM_VERIFIED_BASELINE, verifiedBaseline],
     [FM_VERIFIED_AT, verifiedAt],
+    // 文件里的 status 与库里的 choro_pages.status 同步推进（#582）：此前 T1
+    // 成功只改库（markChoroPageEnriched），文件那行永远停在 T0 写的 skeleton
+    // ——页面文件自身与数据库状态不一致，看文件的人会以为这页从没富化过。
+    // 失败路径不写它：文件停在 skeleton 与「首次失败不标 failed」的口径一致
+    // （recordChoroPageFailure 改的是库）。T0 重跑整页重写、status 回 skeleton，
+    // 与「T0 丢弃语义段」同一件事。
+    [FM_STATUS, "enriched"],
   ]);
   writeFileSync(pageFile, finalContent, "utf8");
 }

diff --git a/dsh-mneme/test/client.test.js b/dsh-mneme/test/client.test.js
@@ -4681,3 +4681,44 @@ test("conflict ledger mode warns when freeze overrides the chosen tier (#661)",
   assert.match(joined, /\u77db\u76fe\u51bb\u7ed3|conflict freeze/i,
     "the notice must name the freeze switch so the user knows what to turn off");
 });
+
+// ---- #582 wiki 渲染三处 ----
+
+// 机器标记行（CHORO:T1 / CHORO:HUMAN 的 HTML 注释包装）是 t0/t1 剥段与回填用
+// 的段落边界，给人看的排版里是裸文本噪音。跳过判定必须挂在围栏分支**之后**：
+// 代码块里的 `<!--` 是内容不是标记，先剥了它 ``` 示例就缺行。
+test("wiki renderer hides machine marker lines but keeps them inside code fences (#582)", () => {
+  const start = clientSource.indexOf("function renderWikiMarkdown(");
+  const end = clientSource.indexOf("function renderDiaryBody(", start);
+  assert.ok(start > 0 && end > start, "renderWikiMarkdown must exist before renderDiaryBody");
+  const body = clientSource.slice(start, end);
+  // 围栏要记字符与长度（PR #678 评审）：只认三反引号时 `~~~html` 里的注释会被
+  // 当成正文删掉，四反引号块里的 ``` 也会提前结束代码态。锁三件事：识别两种
+  // 围栏字符、记录开启长度、结束必须同字符且不短于开启。
+  const fenceAt = body.indexOf("const fenceOpen = /^(`{3,}|~{3,})(.*)$/.exec(line.trim());");
+  assert.ok(fenceAt > 0, "the renderer must recognize both ``` and ~~~ fences");
+  assert.ok(body.includes("fence = { ch: fenceOpen[1][0], len: fenceOpen[1].length };"),
+    "the opening fence must record its character and length");
+  assert.ok(body.includes("fenceOpen[1][0] === fence.ch && fenceOpen[1].length >= fence.len"),
+    "a closing fence must use the same character and be at least as long as the opener");
+  // 注意 \\s 要写成双反斜杠：JS 字符串里的 \s 会塌成 s，indexOf 就永远找不到。
+  const skipAt = body.indexOf("if (/^\\s*<!--/.test(line)) continue;");
+  assert.ok(skipAt > fenceAt, "the marker-skip must come after the fence branch so fenced comments survive");
+  // 日记与 wiki 共用这个渲染器：日记正文没有 CHORO 标记，跳过规则对它是空转
+  // 的——但如果将来日记里出现「整行 HTML 注释」，同样按注释隐藏（预期行为）。
+});
+
+// 树缩进必须看 parent_id 真父子：slugify 把路径分隔与一切非字母数字都变成
+// `-`，连字符计数会把目录名自带的连字符与去重序号（-2）当成层级——
+// `packages-computer-use-src` 会被画成三层深（#582 的原始截图）。
+test("wiki tree indents by parent_id, not by hyphen count (#582)", () => {
+  const start = clientSource.indexOf("树的层级看 parent_id 真父子");
+  assert.ok(start > 0, "the parent_id tree builder must exist");
+  const region = clientSource.slice(start, start + 2400);
+  assert.ok(region.includes("mod.parent_id"), "tree depth must derive from parent_id");
+  assert.ok(!region.includes("slug.match(/-/g)"), "hyphen counting must be gone from the tree builder");
+  assert.ok(region.includes("walk(null, 0)"), "roots (no parent) must seed the walk");
+  assert.ok(region.includes("depthById.has(mod.id)"), "cycle defense must guard the walk");
+  // 兜底要接住走不到的模块：宁可用根层平铺也不能静默丢行（树少一页 = 入口没了）。
+  assert.ok(region.includes("!depthById.has(mod.id)"), "unreached modules must fall back instead of vanishing");
+});
diff --git a/dsh-mneme/test/wiki-t1.test.js b/dsh-mneme/test/wiki-t1.test.js
@@ -115,6 +115,9 @@ test("快乐路径：富化 + claims 双落 + 保留区照旧页尾回填", asyn
     ).get();
     assert.equal(status.status, "enriched");
     assert.equal(status.generated_at, FIXED_NOW());
+    // #582：文件 frontmatter 的 status 与库同步推进——T1 成功后文件不再停在
+    // T0 写的 skeleton，看文件的人不会再把已富化的页当成骨架。
+    assert.ok(/^status: enriched$/m.test(page), "T1 成功要把文件 frontmatter 的 status 推进到 enriched");
 
     // 富化后的页再跑一次 T1：人写入保留区块后必须照旧存活（复用 M0 语义）
     const withHuman = page + "\n<!-- CHORO:HUMAN:START -->\n人写的批注\n<!-- CHORO:HUMAN:END -->\n";
@@ -124,6 +127,9 @@ test("快乐路径：富化 + claims 双落 + 保留区照旧页尾回填", asyn
     assert.ok(rePage.includes("人写的批注"), "重富化不抹保留区");
     assert.ok(rePage.trimEnd().endsWith("<!-- CHORO:HUMAN:END -->"), "保留区照旧页尾回填");
     assert.equal(rePage.match(new RegExp(T1_SECTION_START.replace(/[/*]/g, (c) => "\\" + c), "g")).length, 1, "旧 T1 段被剥掉、只有一份新段");
+    // #582：重富化走同一写入口，status 幂等覆写——不能重复插行，也不能退回。
+    assert.ok(/^status: enriched$/m.test(rePage), "重富化后 status 仍是 enriched");
+    assert.equal((rePage.match(/^status: /gm) || []).length, 1, "frontmatter 里 status 只有一行");
   } finally {
     store.close();
     rmTempBestEffort(root);
@@ -142,6 +148,10 @@ test("输出契约：坏 JSON → 失败计数；连续两次 → status=failed
     assert.equal(r2.failed[0].marked, true, "连续两次到阈值");
     const st = store.db.prepare("SELECT p.status FROM choro_pages p JOIN choro_modules m ON p.module_id=m.id WHERE m.slug='src'").get();
     assert.equal(st.status, "failed");
+    // #582 的另一面：失败路径不动文件——status 停在 T0 写的 skeleton，与
+    // 「首次失败不标 failed（骨架仍是有效产物）」的库侧口径一致。
+    assert.ok(!/^status: enriched/m.test(readFileSync(join(root, ".chorography", "modules", "src.md"), "utf8")),
+      "失败路径不能把文件 frontmatter 的 status 推到 enriched");
 
     respond = GOOD_OUTPUT;
     const r3 = await t1.runT1({ repoRoot: root, moduleSlug: "src", retryFailed: true });