lunheng-article-pipeline 18.2.3 → 18.2.5

package/README.es.md

@@ -1,6 +1,6 @@
 # Lunheng (lunheng-article-pipeline) — pipeline multiagente para textos largos
 
-> 版本：v18.2.3（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.5（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
 
 > 🌐 [English](README.md) ｜ [中文](README.zh.md) ｜ **Español**（este archivo）｜ [Português](README.pt.md) ｜ [हिन्दी](README.hi.md)
 
@@ -108,7 +108,7 @@ La capa patch hace dos cosas: **inserta una fila para este paquete** (`- id: lun
 Las versiones se publican **solo por tag**; `npm publish` local está prohibido (evita las puertas de CI y la procedencia OIDC, y una versión npm nunca se puede sobrescribir).
 
 ```sh
-git tag v18.2.3 && git push origin v18.2.3   # un tag por push (GitHub: >3 tags en un push no dispara workflow)
+git tag v18.2.5 && git push origin v18.2.5   # un tag por push (GitHub: >3 tags en un push no dispara workflow)
 # publish.yml ejecuta: puerta 1 consistencia → puerta 2 empaquetado → puerta 3 higiene → puerta 4 humo del paquete → tests
 #   → tag/versión iguales → guarda de idempotencia → OIDC publish --provenance --tag dsh → auditoría posterior
 ```
@@ -124,7 +124,7 @@ dsh --profile web --dump-config   # muestra una capa "# == lunheng-article-pipel
 
 Un `dsh` moderno añade la dependencia a `dsh.profile.bundles` en cuanto ve la declaración `dsh.bundle`: instale y reinicie `dsh web`. Solo las instalaciones npm/pnpm puras o las versiones antiguas necesitan la entrada manual.
 
-**Como directorio de skill simple** (sin instalación, recarga en caliente):
+**Como directorio de skill simple** (sin instalación; el host vigila la raíz de skills y la refresca al cambiar — el `SKILL.md` del modo uno es una instantánea leída en el `apply` del entry, así que editar el contenido requiere recargar el plugin o abrir una sesión nueva):
 
 ```sh
 # Copie el DIRECTORIO DE LA SKILL (no la raíz del repositorio) en cualquier raíz de skills:

package/README.hi.md

@@ -1,6 +1,6 @@
 # लुन्हेंग (lunheng-article-pipeline) — बहु-एजेंट दीर्घ-लेख पाइपलाइन
 
-> 版本：v18.2.3（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.5（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
 
 > 🌐 [English](README.md) ｜ [中文](README.zh.md) ｜ [Español](README.es.md) ｜ [Português](README.pt.md) ｜ **हिन्दी**（यह फ़ाइल）
 
@@ -108,7 +108,7 @@ patch परत दो काम करती है: **इस पैकेज
 संस्करण **केवल tag से** प्रकाशित होते हैं; स्थानीय `npm publish` वर्जित है (यह CI द्वारों और OIDC provenance को दरकिनार करता है, और npm संस्करण कभी अधिलेखित नहीं हो सकता)।
 
 ```sh
-git tag v18.2.3 && git push origin v18.2.3   # एक बार में एक ही tag (GitHub: >3 tag एक push में कोई workflow नहीं चलाता)
+git tag v18.2.5 && git push origin v18.2.5   # एक बार में एक ही tag (GitHub: >3 tag एक push में कोई workflow नहीं चलाता)
 # publish.yml क्रम: द्वार 1 सुसंगति → द्वार 2 पैकेजिंग → द्वार 3 स्वच्छता → द्वार 4 पैकेज स्मोक → स्क्रिप्ट परीक्षण
 #   → tag/संस्करण समानता → idempotency गार्ड → OIDC publish --provenance --tag dsh → प्रकाशन-पश्चात लेखा-परीक्षा
 ```
@@ -124,7 +124,7 @@ dsh --profile web --dump-config   # "# == lunheng-article-pipeline" परत
 
 नया `dsh` `dsh.bundle` घोषणा देखते ही निर्भरता को `dsh.profile.bundles` में जोड़ देता है — स्थापित करें और `dsh web` पुनः आरंभ करें। केवल शुद्ध npm/pnpm स्थापना या पुराने संस्करणों में मैनुअल प्रविष्टि चाहिए।
 
-**सादे स्किल निर्देशिका के रूप में** (स्थापना नहीं, तत्काल पुनःलोड):
+**सादे स्किल निर्देशिका के रूप में** (स्थापना नहीं; होस्ट स्किल-मूल की निगरानी करता है और बदलाव पर तुरंत ताज़ा करता है — मोड एक का `SKILL.md` entry के `apply` समय पढ़ा गया स्नैपशॉट है, इसलिए सामग्री बदलने पर प्लगइन पुनःलोड या नया सत्र आवश्यक है):
 
 ```sh
 # स्किल निर्देशिका (रिपॉज़िटरी रूट नहीं) को किसी भी DSH स्किल-मूल में प्रतिलिपि करें:

package/README.md

@@ -2,7 +2,7 @@
 
 > 🌐 **English** (this file) ｜ [中文](README.zh.md) ｜ [Español](README.es.md) ｜ [Português](README.pt.md) ｜ [हिन्दी](README.hi.md)
 
-> 版本：v18.2.3（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.5（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
 
 > A DeepSeek Harness (DSH) bundle that registers one on-demand agent skill. The skill turns long-form production — academic papers, industry analysis, business commentary, and long-form articles — into a **9-role pipeline with a human in the loop**.
 
@@ -108,7 +108,7 @@ The patch layer does two things: it **inserts one row for this package** (`- id:
 Releases are **tag-only**; a local `npm publish` is forbidden (it would bypass the CI gates and OIDC provenance, and a published npm version can never be overwritten).
 
 ```sh
-git tag v18.2.3 && git push origin v18.2.3   # push one tag at a time (GitHub: >3 tags in one push triggers no workflow)
+git tag v18.2.5 && git push origin v18.2.5   # push one tag at a time (GitHub: >3 tags in one push triggers no workflow)
 # publish.yml then runs gate 1 consistency → gate 2 packaging surface → gate 3 hygiene → gate 4 pack smoke → script tests
 #   → tag/version equality → idempotency guard → OIDC publish --provenance --tag dsh → post-publish audit
 ```
@@ -124,7 +124,7 @@ dsh --profile web --dump-config   # shows the "# == lunheng-article-pipeline" la
 
 A modern `dsh` adds the dependency to `dsh.profile.bundles` automatically once it sees the `dsh.bundle` declaration — install and restart `dsh web`. Only plain npm/pnpm installs or older builds need the manual `dsh.profile.bundles` entry.
 
-**As a plain skill directory** (no install, hot-reloaded):
+**As a plain skill directory** (no install; the host watches the skill root and refreshes it on change — mode one's `SKILL.md` is a snapshot read at entry `apply` time, so content edits need a plugin reload or a new session):
 
 ```sh
 # Copy the SKILL directory (not the repository root) into any DSH skill root:

package/README.pt.md

@@ -1,6 +1,6 @@
 # Lunheng (lunheng-article-pipeline) — pipeline multiagente para textos longos
 
-> 版本：v18.2.3（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.5（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
 
 > 🌐 [English](README.md) ｜ [中文](README.zh.md) ｜ [Español](README.es.md) ｜ **Português**（este arquivo）｜ [हिन्दी](README.hi.md)
 
@@ -108,7 +108,7 @@ A camada patch faz duas coisas: **insere uma linha para este pacote** (`- id: lu
 As versões são publicadas **apenas por tag**; `npm publish` local é proibido (contorna os portões de CI e a proveniência OIDC, e uma versão npm nunca pode ser sobrescrita).
 
 ```sh
-git tag v18.2.3 && git push origin v18.2.3   # uma tag por push (GitHub: >3 tags em um push não dispara workflow)
+git tag v18.2.5 && git push origin v18.2.5   # uma tag por push (GitHub: >3 tags em um push não dispara workflow)
 # publish.yml executa: portão 1 consistência → portão 2 empacotamento → portão 3 higiene → portão 4 teste de fumaça do pacote → testes
 #   → tag/versão iguais → guarda de idempotência → OIDC publish --provenance --tag dsh → auditoria posterior
 ```
@@ -124,7 +124,7 @@ dsh --profile web --dump-config   # mostra uma camada "# == lunheng-article-pipe
 
 Um `dsh` moderno adiciona a dependência a `dsh.profile.bundles` assim que vê a declaração `dsh.bundle`: instale e reinicie o `dsh web`. Somente instalações npm/pnpm puras ou versões antigas precisam da entrada manual.
 
-**Como diretório de skill simples** (sem instalação, recarga a quente):
+**Como diretório de skill simples** (sem instalação; o host vigia a raiz de skills e a atualiza a cada mudança — o `SKILL.md` do modo um é um instantâneo lido no `apply` do entry, então editar o conteúdo exige recarregar o plugin ou abrir uma sessão nova):
 
 ```sh
 # Copie o DIRETÓRIO DA SKILL (não a raiz do repositório) para qualquer raiz de skills:

package/README.zh.md

@@ -2,7 +2,7 @@
 
 > 🌐 [English](README.md) ｜ **中文**（本文件）｜ [Español](README.es.md) ｜ [Português](README.pt.md) ｜ [हिन्दी](README.hi.md)
 
-> 版本：v18.2.3（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.5（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
 
 > 一个 DeepSeek Harness（DSH）bundle 插件，注册一个按需加载的 agent 技能。它把深度长文的生产——学术论文、行业分析、商业评论、公众号深文——变成**带人在环节点的 9 角色流水线**。
 
@@ -75,7 +75,7 @@ lunheng-article-pipeline/                 # 包即仓库
 │   ├── QUICKSTART.md         # 5 分钟快速开始
 │   ├── README.md             # 技能级说明（中文）
 │   ├── references/           # 9 张角色卡、模板、共享闸门算法、期刊数据库
-│   └── scripts/              # 11 个零依赖 .mjs 机械校验脚本
+│   └── scripts/              # 12 个零依赖 .mjs 机械校验脚本
 ├── scripts/                  # 仓库门：打包面 + 机械卫生
 ├── tests/                    # node --test 回归（脚本 + 插件入口冒烟）
 ├── docs/                     # 安装 / 使用 / 架构 / FAQ / 排障
@@ -108,7 +108,7 @@ patch 层做两件事：**插入一行本包自注册行**（`- id: lunheng-arti
 **只推 tag 发布，禁止本地 `npm publish`**（本地直发会绕过 CI 三道门与 OIDC 来源证明，且 npm 版本不可覆盖）。
 
 ```sh
-git tag v18.2.3 && git push origin v18.2.3   # 一次只推 1 个 tag（GitHub：单次 push >3 个 tag 不触发任何 workflow）
+git tag v18.2.5 && git push origin v18.2.5   # 一次只推 1 个 tag（GitHub：单次 push >3 个 tag 不触发任何 workflow）
 # publish.yml 依次跑：门 1 一致性 → 门 2 打包面 → 门 3 机械卫生 → 门 4 打包产物冒烟 → 脚本回归测试
 #   → tag/版本一致校验 → 幂等守卫 → OIDC 发布 --provenance --tag dsh → 发布后审计
 ```
@@ -124,7 +124,7 @@ dsh --profile web --dump-config   # 应出现 "# == lunheng-article-pipeline"
 
 新版 dsh 看到 `dsh.bundle` 声明后会自动把依赖加进 `dsh.profile.bundles`——装完重启 `dsh web` 即可。仅当用纯 npm/pnpm 安装或旧版 dsh 时，才需手工在 profile 的 `package.json` 里加 `dsh.profile.bundles` 条目。
 
-**方式二：作为纯技能目录**（免安装，热加载）
+**方式二：作为纯技能目录**（免安装；宿主监听技能根、文件改动即刷新目录——方式一的 `SKILL.md` 是入口 `apply` 期读的快照，改内容需重载插件或重开会话）
 
 ```sh
 # 复制**技能目录**（不是仓库根）到任一 DSH 技能根：

package/SECURITY.md

@@ -1,12 +1,13 @@
 # 安全策略（SECURITY）
 
-> 版本：v18.2.3（DSH 原生插件，发布于 2026-09-12）
+> 版本：v18.2.4（DSH 原生插件，发布于 2026-09-13）
 
 ## 上报漏洞
 
 发现安全问题时**请勿开公开 issue**。请通过以下任一私密渠道上报：
 
-- GitHub **Private vulnerability reporting**（仓库 → Security → Report a vulnerability）
+- GitHub **Private vulnerability reporting**（推荐）：<https://github.com/zuoyunlai/lunheng-article-pipeline-dsh/security/advisories/new>
+  > **v18.2.4 复核（第三方审计 D.2）**：该开关此前**没开**——`GET /repos/…/private-vulnerability-reporting` 返回 `{"enabled":false}`，即本节旧文写的「仓库 → Security → Report a vulnerability」**当时是个死链**（公开仓库上尤其糟：报告者照文档走却找不到入口，只剩开公开 issue 一途）。现已开启并核验为 `{"enabled":true}`。
 - 邮件：`zuoyunlai@outlook.com`（标题加 `[SECURITY] lunheng-article-pipeline`）
 
 请在报告中给出：受影响版本（`package.json` 的 `version`）、复现步骤、影响面判断、以及你期望的披露时限。
@@ -21,7 +22,7 @@
 | 加载期执行 | `cordis.patch.yml` 含 **3 处 `!!js` 表达式**（3 处分档 agentOptions，各自读取 `LUNHENG_*_PROVIDER/MODEL`；未设则返回 `undefined`）。它们由 DSH 宿主进程在**加载期以完整 Node 权限**求值，**发生在 agent 沙箱与审批关卡之前** —— 安装本包即等于允许这些表达式在每次启动时执行。 |
 | 允许的表达式内容 | 仅 `process.env.*` 与全局 `Object.assign`。（v18.0.0 起技能目录不再由 patch 求值挂载，故 `baseUrl` / `URL` / `decodeURIComponent` / `process.platform` 已不再需要——表达式面比 v17.0.0 **更窄**。） |
 | 禁止的表达式内容（CI 红线，`consistency-check.mjs` 规则 ⑭） | `getBuiltinModule` / `child_process` / `require(` / `import(` / `eval(` / `new Function` / `node:` / `fs.` |
-| 随包脚本 | 11 个 `.mjs`：**零第三方依赖、零网络请求**；唯一子进程调用在 `final-check.mjs`（`spawnSync` 固定脚本路径 + 参数数组 + `shell:false`）。其中 `normalize-trust-level.mjs` / `md2html.mjs` / `final-check.mjs` 可写文件——技能已要求其目标路径限于项目目录，且默认 dry-run（`normalize-trust-level`）。 |
+| 随包脚本 | 12 个 `.mjs`：**零第三方依赖、零网络请求**；唯一子进程调用在 `final-check.mjs`（`spawnSync` 固定脚本路径 + 参数数组 + `shell:false`）。其中 `normalize-trust-level.mjs` / `md2html.mjs` / `final-check.mjs` 可写文件——技能已要求其目标路径限于项目目录，且默认 dry-run（`normalize-trust-level`）。 |
 | 技能机制 | 技能会让 agent 读写工作区文件、派发子代理、并经外部检索服务外发检索关键词/目标 URL（Phase 0 有「4 选 1」明示同意关卡）。 |
 | 已知边界 | 同名技能存在**按 rank 就近静默覆盖**的平台行为：项目根 `.dsh/skills/<同名>` 会顶替本包提供的技能副本（无告警）。技能已加入启动自检条款（核对版本头，不符即停机报告）。 |
 
@@ -32,6 +33,8 @@
 - **幂等守卫**：目标版本已存在于 npm 时跳过发布。
 - **发布后审计**：断言 `npm view <pkg>@<ver> gitHead` == 本次提交 SHA，且 `dist-tags.dsh` 指向该版本。
 - 历史版本 `2.5.2-dsh.8`–`.12` 为**本地手工发布、无 provenance**（已在 `CHANGELOG.md` 记录）；自 `2.5.2-dsh.13` 起恢复 tag + OIDC 流程。
+- **`NPM_TOKEN` 的用途与治理（v18.2.4 增补，第三方审计 G.1）**：发布本身走 OIDC、**不需要** token；该 secret **只**用于发布后 `npm dist-tag add … latest` 这一步——OIDC 覆盖的是 `npm publish`，而 `npm dist-tag` 仍需写鉴权（工作流注释已记实测：无 token 时该命令因无鉴权 exit 1；故工作流写成「无 token 只告警、不失败」，latest 由维护者手工补打）。
+  > **治理要求**：① 用**细粒度 token**、只授本包写权限、设最短有效期；② 定期轮换；③ **一旦出现在聊天记录 / 日志 / 截图 / CI 输出中即视为已泄露**，立即 revoke 并重发；④ 该 token 永远不得打印（`publish.yml` 只经 `env:` 传递，不 `echo`）。
 
 ## 支持的版本
 

package/cordis.patch.yml

@@ -1,4 +1,4 @@
-# lunheng-article-pipeline bundle patch（DSH 原生插件 v18.2.3）
+# lunheng-article-pipeline bundle patch（DSH 原生插件 v18.2.5）
 #
 # 本文件用 DSH cordis-plugin-include 的 `- insert:` 列表语法在 standard 组合树之上叠加 4 行：
 #   1. **本包入口（自注册行）**：`name: lunheng-article-pipeline` → loader 按包名解析到
@@ -56,14 +56,34 @@
       name: '@deepseek-ai/dsh-tool-subagent'
       # v18.0.5（第三方审计 P2-12）：`LUNHENG_TIERING=off` 此前只让 agentOptions 变 undefined，
       #   **三行仍挂在组合树里**（实测每个会话的工具数恒为 29）——用户以为关了，其实只是"不分档但仍多 3 个工具"。
-      #   官方支持**行级**门控（`disabled` 在挂载决策期按 loader 上下文插值，宿主自用先例：
-      #   `app.asar.unpacked/cordis.patch.yml` 的 `disabled: !!js process.platform === 'linux'`），故加这一行。
-      #   ⚠️ **未验证**（v18.0.5 如实标注）：本机 `--dump-config` **只打印声明行**（判定实验：把三行 disabled
-      #   改成恒真后 dump 里三行依旧在），因此「off 是否真的摘掉三行」无法在本机证实；DSH Desktop 的
-      #   dsh shim 又硬编码 DSH_HOME、无法用干净 profile 做组合树实测。**退化行为是安全的**：若宿主忽略该键，
-      #   行为与 v18.0.4 完全一致（三行仍在、模型继承）。要坐实请在能起 headless 的环境看真实工具清单。
+      #   官方支持**行级**门控，故加这一行。
+      #   ✅ **v18.2.4 已由宿主源码证实**（此前 v18.0.5 只能标注「未验证」——因 `--dump-config` 只打印
+      #   声明行，判定实验「改成恒真后 dump 里三行依旧在」证明的是 dump 不反映裁剪，不是键无效）：
+      #     · `disabled` 是 loader 的**一等选项**：`@deepseek-ai/cordis-plugin-loader` 的
+      #       `src/config/entry.ts:19` 声明 `disabled?: boolean | null`；
+      #     · `disabledOf()`（同文件 :104-107）对 `!!js` 形求值——
+      #       `isJsExpr(options.disabled) ? Boolean(this.evaluate(options.disabled.__jsExpr)) : Boolean(options.disabled)`，
+      #       即「表达式求值为假 = 该行禁用」，判定只取决于表达式取值本身；
+      #     · `refresh()`（:124-128）首行即 `if (this.disabled) return` → **不进 init，行不装载**；
+      #     · `update()`（:181-189）在 `_disabled(candidate)` 为真时 `_dispose(previous)` → 热更新该键
+      #       会**主动卸载**已装载的 fiber（不是只对新会话生效）。
+      #   宿主自用先例（同键同形）：DSH Desktop 随包的 `cordis.patch.yml`
+      #   —— `disabled: !!js process.platform === 'linux'`。
+      #   ⚠️ **残留不确定（如实保留）**：以上证明的是「loader 按该键裁剪行」；**本机 `--dump-config` 仍只
+      #   打印声明行**，且 DSH Desktop 的 dsh shim 硬编码 DSH_HOME、无法用干净 profile 实测组合树，
+      #   故「off 时工具数是否真的少 3」仍需在能起 headless 的环境核对真实工具清单。
+      #   退化行为安全：即便某版本忽略该键，行为与 v18.0.4 一致（三行仍在、模型继承）——不产生错误语义。
       disabled: !!js "process.env.LUNHENG_TIERING === 'off'"
       config:
+        # ✅ v18.2.4：`provider: spawn` 的**合法性已证实**（v18.0.5 起列为「待问 DSH 官方」的开放问题，现已结案）：
+        #   ① 官方 `config-catalog`（生成自 `packages/subagent/tool-subagent/src/index.ts:48`）的
+        #      `@deepseek-ai/dsh-tool-subagent` Config 注释原文即「The `ctx.subagents` provider name
+        #      to start runs on (e.g. `spawn`, `acp`)」——`spawn` 是被点名的合法取值；
+        #   ② 该名来自 `@deepseek-ai/dsh-subagent-spawn-in-process`：注册名默认 `spawn`
+        #      （`Config = z.object({ providerName: z.string().default('spawn') })`，其 lib/index.js:13 + :42）；
+        #   ③ 本包同时用的 `backgroundMode: continuable` **要求** provider 具备 `prepareContinuable` 能力
+        #      （官方 `subsystems/subagent.zh.md`：缺该方法的 provider 上发起可继续 start 会被拒），
+        #      而该 provider **确有** `prepareContinuable()`（其 lib/index.js:37）→ 能力配对成立。
         provider: spawn
         toolName: subagent_retrieval
         backgroundMode: continuable

package/docs/faq.md

@@ -1,8 +1,10 @@
 # FAQ
 
-## 为什么 dshmarket 里显示「安装完成但校验失败 / 入口产物缺失」？
+## 为什么第三方插件市场（如 dshmarket）里显示「安装完成但校验失败 / 入口产物缺失」？
 
-> **v18.0.0 起已不适用**：本包现在带 JS 包入口（`main` → `lib/index.js`，注册技能并经 `ctx.effect` 可逆注册），dshmarket 一类「只认 JS 入口」的校验器不再误报。若仍看到该校验失败，请确认安装的是 v18.0.0 及以上。
+> **v18.0.0 起已不适用**：本包现在带 JS 包入口（`main` → `lib/index.js`，注册技能并经 `ctx.effect` 可逆注册），「只认 JS 入口」一类校验器不再误报。若仍看到该校验失败，请确认安装的是 v18.0.0 及以上。
+>
+> **先分清归属（v18.2.4 补注）**：`dshmarket` 与各类插件市场都是**第三方社区项目**，不是 DSH 官方组件，也不在本包的依赖或支持范围内——本包只依赖 DSH 宿主本身（且 `@deepseek-ai/dsh` 是 optional peer）。故「市场里的显示」与「本包能否装载」是两件事：前者出问题找市场，后者出问题看本文件与 [`troubleshooting.md`](troubleshooting.md)。
 
 ## 本包「零可执行内容」吗？
 
@@ -14,16 +16,18 @@
 
 实测技能可正常加载：`dsh --profile <profile> --dump-config` 可见本包层与三档 `tool-subagent-*` 行，新会话的技能目录能列出 `lunheng-article-pipeline`。
 
-## 版本号为什么是 18.2.1 这种形态？
+## 版本号为什么是纯语义化三段式？
 
 DSH 版独立维护、独立版本线，版本号不与任何外部版本线共享。**v17.0.0 起版本号 = 纯语义化版本，迭代号进 major**：
 
 | 场景 | 版本 |
 |---|---|
-| 本轮迭代 | `18.2.1` |
-| 上一轮迭代（未单独发布，内容随本版首发） | `17.0.0` |
-| 同一轮内修补 | `18.2.1` |
-| 同一轮内小步改进 | `18.2.1` |
+| 本轮迭代 | 抬 minor（`18.2.0` 形态） |
+| 上一轮迭代（未单独发布，内容随本版首发） | 抬 major（`17.0.0` 形态） |
+| 同一轮内修补 | 抬 patch（`18.2.4` 形态） |
+| 同一轮内小步改进 | 抬 patch（同上） |
+
+> **表中数字只是示例**（v18.2.4 更正）：旧版此处写死成当时的版本 `18.2.1`，此后每次 bump 都不同步、静默滞留了三个版本——**「当前版本」的唯一真源是 `package.json` 的 `version`**（也可 `npm view lunheng-article-pipeline version`）。本文件刻意不再复述具体当前版本号。
 
 **为什么不能写成 `dsh.17.0`**：npm 强制 [semver](https://semver.org)，`major.minor.patch` 三段必须是数字，`dsh` 只能出现在 `-`（prerelease）或 `+`（build metadata）之后——实测 `npm publish` 会直接以 `Invalid version` 拒绝。
 

package/docs/introduction.md

@@ -2,7 +2,7 @@
 
 > **论衡（lunheng-article-pipeline）** 是一个多 Agent 深度长文生产流水线，DeepSeek Harness（dsh）bundle 插件。它不是让一个 AI 直接写文章，而是让一支 **9 个 AI 角色组成的"论文生产小队"** 按既定协议协作：定题 → 三线并行检索 → 分析 → 写作 → 批判 → 审计 → 审稿 → 终检。每一步都有明确产出物、交接报告与质量闸门，最终交付**有证据底座、有反方论证、有独立审计、有人工核验节点**的文章。
 
-> 适用：公众号深度长文、研究报告、学术论文、商业评论、行业分析——任何"要站得住脚"的长内容。当前版本 **v18.2.3**（DSH 独立版本）。
+> 适用：公众号深度长文、研究报告、学术论文、商业评论、行业分析——任何"要站得住脚"的长内容。当前版本 **v18.2.5**（DSH 独立版本）。
 
 ---
 
@@ -170,7 +170,7 @@ dsh plugin --profile web add lunheng-article-pipeline
 ## 获取方式
 
 - **GitHub（DSH bundle）**：https://github.com/zuoyunlai/lunheng-article-pipeline-dsh
-- **npm**：`lunheng-article-pipeline@dsh`（dist-tag `dsh` = 最新 DSH 迭代版）；锁定具体版本可写 `@18.2.3`
+- **npm**：`lunheng-article-pipeline@dsh`（dist-tag `dsh` = 最新 DSH 迭代版）；锁定具体版本可写 `@18.2.5`
 - **历史版本线（独立化前）**：https://github.com/zuoyunlai/lunheng-article-pipeline
 
 ---

package/docs/troubleshooting.md

@@ -1,6 +1,6 @@
 # 故障排查（troubleshooting）
 
-> 版本：v18.2.3（DSH 原生插件，发布于 2026-09-12）
+> 版本：v18.2.4（DSH 原生插件，发布于 2026-09-13）
 
 安装/验证失败时按「症状 → 原因 → 处置」对照。
 

package/examples/preset/README.md

@@ -12,7 +12,7 @@
 ```sh
 # 1. 在 profile 里声明 bundle 依赖（DSH 读 dsh.bundle.patch 找到 cordis.patch.yml 加载）
 dsh plugin --profile web add lunheng-article-pipeline@dsh   # 推荐：跟随最新 DSH 迭代版
-# 锁定具体版本：dsh plugin --profile web add lunheng-article-pipeline@18.2.3
+# 锁定具体版本：dsh plugin --profile web add lunheng-article-pipeline@18.2.5
 
 # 2. （可选）设三档 subagent 工具的 provider/model 环境变量
 #    不设任何变量 = 三档全部继承会话模型（安全默认，单模型用户无需本步）

package/lib/index.js

@@ -35,15 +35,24 @@ const skillDir = join(packageRoot, 'skills', 'lunheng-article-pipeline')
  * Split the YAML frontmatter block from SKILL.md into routing fields and body.
  * A malformed or missing block falls back to the full text as the body and an
  * empty field map, so the registration still succeeds with its fallback copy.
+ *
+ * v18.2.4（审计 C.1）：行尾与 BOM 归一后再解析。此前用 `text.startsWith('---\n')`
+ * 判定，而 `readFileSync(p, 'utf8')` **不做行尾归一**——SKILL.md 一旦是 CRLF 行尾
+ * （Windows `core.autocrlf=true` 检出、或编辑器另存为 CRLF），首行是 `---\r\n`，
+ * 判定为假 → frontmatter 整块**静默**退化成内置兜底描述，而 description/whenToUse
+ * 恰是模型侧路由的唯一依据（`whenToUse` 丢失后连注册字段都会消失），静态门全绿也照样漏过。
  * @param text - raw SKILL.md content.
- * @returns parsed routing fields (present keys only) and the instruction body.
+ * @returns parsed routing fields (present keys only), the instruction body, and
+ *   whether the frontmatter block was actually recognized.
  */
 function splitFrontmatter(text) {
-  if (!text.startsWith('---\n')) return { fields: {}, body: text }
-  const end = text.indexOf('\n---', 4)
-  if (end < 0) return { fields: {}, body: text }
-  const meta = text.slice(4, end)
-  const body = text.slice(end + 4).replace(/^\n+/, '')
+  // 行尾归一（CRLF / 孤立 CR → LF）+ 去 BOM：两者都只影响解析，不影响正文语义。
+  const norm = text.replace(/^\uFEFF/, '').replace(/\r\n?/g, '\n')
+  // 首行必须是 `---`，且必须有**成行**的闭合 `---`（缺闭合 = 未解析，不猜）。
+  const match = /^---[ \t]*\n([\s\S]*?)\n---[ \t]*(?:\n|$)/.exec(norm)
+  if (!match) return { fields: {}, body: norm, parsed: false }
+  const meta = match[1]
+  const body = norm.slice(match[0].length).replace(/^\n+/, '')
   const read = (key) => {
     const match = new RegExp(`^${key}:\\s*(.+)$`, 'm').exec(meta)
     return match?.[1]?.trim().replace(/^["']|["']$/g, '')
@@ -51,29 +60,73 @@ function splitFrontmatter(text) {
   return {
     fields: { description: read('description'), whenToUse: read('whenToUse') },
     body,
+    parsed: true,
+  }
+}
+
+/**
+ * Build the entry's status reporter (v18.2.4，审计 C.3).
+ *
+ * 宿主带 Cordis `logger` 时走正规日志面，否则退回 `console.error`。此前 3 条
+ * 「已注册 / 已启用」状态行**无条件**写 stderr，宿主每次启动都刷屏，而这些信息本就
+ * 只对宿主日志有用。口径：`info`（成功）可被 `LUNHENG_QUIET=1` 静音；`warn`（降级 / 失败）
+ * **不静音**——「静默降级」正是 v18.0.0 事故的形态，必须始终可见。
+ * @param ctx - the plugin context (minimal hosts may carry no logger).
+ * @returns a `(level, message) => void` reporter bound to this context.
+ */
+function makeReporter(ctx) {
+  const logger = ctx?.logger
+  const quiet = process.env.LUNHENG_QUIET === '1' || process.env.LUNHENG_QUIET === 'true'
+  return (level, message) => {
+    if (level === 'info' && quiet) return
+    if (logger && typeof logger[level] === 'function') logger[level](message)
+    else console.error(message) // 宿主无日志面时不丢信息（宁可见勿静默）
   }
 }
 
 /**
  * Register the pipeline skill. Registration is an effect: the disposer
  * returned by `ctx.skills.register()` removes the contribution on unload.
- * @param ctx - Cordis context with the injected `skills` service.
+ * @param ctx - Cordis context; the injected `skills` service is the hard
+ *   dependency (its absence is a host-contract violation: it is reported and
+ *   skipped, never a TypeError), while the C-group services stay optional.
  */
 export function apply(ctx) {
+  const say = makeReporter(ctx)
   const skillPath = join(skillDir, 'SKILL.md')
-  const { fields, body } = splitFrontmatter(readFileSync(skillPath, 'utf8'))
-  ctx.effect(() =>
-    ctx.skills.register({
-      name: 'lunheng-article-pipeline',
-      source: 'bundled',
-      description:
-        fields.description ??
-        '论衡：多 Agent 深度长文流水线（学术论文 / 商业评论 / 行业分析 / 公众号）。',
-      ...(fields.whenToUse ? { whenToUse: fields.whenToUse } : {}),
-      content: body,
-      resourceBase: { kind: 'directory', path: skillDir },
-    }),
-  )
+  const { fields, body, parsed } = splitFrontmatter(readFileSync(skillPath, 'utf8'))
+  // 审计 C.2：解析失败此前**静默**退回兜底 description——模型侧路由字段丢了却没有任何信号。
+  if (!parsed) {
+    say(
+      'warn',
+      `· 论衡技能 frontmatter 未解析（SKILL.md 首行不是成行 \`---\` 或缺闭合行）：${skillPath}` +
+        ' —— 已退回内置兜底 description，whenToUse 未注册；请检查该文件是否被 CRLF / 前置空行 / BOM 破坏。',
+    )
+  }
+  // 审计 E.2（v18.2.4）：`skills` 是 `inject` 声明的**硬依赖**——合规宿主在 apply 前就已就绪，
+  //   故这条不是「降级」分支而是「宿主违约」分支：响亮点名后**跳过注册**，但 C 组可选能力照常安装
+  //   （入口不因缺一个服务就整体崩掉）。此前缺失时抛的是
+  //   `Cannot read properties of undefined (reading 'register')`——一句话能说清的事不该以 TypeError 出现。
+  if (ctx?.skills?.register) {
+    ctx.effect(() =>
+      ctx.skills.register({
+        name: 'lunheng-article-pipeline',
+        source: 'bundled',
+        description:
+          fields.description ??
+          '论衡：多 Agent 深度长文流水线（学术论文 / 商业评论 / 行业分析 / 公众号）。',
+        ...(fields.whenToUse ? { whenToUse: fields.whenToUse } : {}),
+        content: body,
+        resourceBase: { kind: 'directory', path: skillDir },
+      }),
+    )
+  } else {
+    say(
+      'warn',
+      '· 论衡技能未注册：宿主 ctx 缺 `skills` 服务（inject 声明的硬依赖未满足）——' +
+        '原生工具 / 机制写保护 / 人类命令仍会尝试安装。',
+    )
+  }
 
   // ── C 组（v18.1.0）：原生工具 / 机制写保护 / 人类命令 ──────────────────────
   // 设计要点（官方依据见各模块头注释）：
@@ -88,12 +141,12 @@ export function apply(ctx) {
     ;(async () => {
       try {
         const { installLunhengTools } = await import('./tools.js')
-        const d = await installLunhengTools(ctx, { skillRoot: skillDir })
+        const d = await installLunhengTools(ctx, { skillRoot: skillDir, report: say })
         if (!alive) { for (const x of d) try { x?.() } catch { /* 已卸载 */ } return }
         disposers.push(...d)
-        if (d.length) console.error(`· 论衡原生工具已注册：${d.length} 个（lunheng_m_gate / lunheng_char_count，均只读）`)
+        if (d.length) say('info', `· 论衡原生工具已注册：${d.length} 个（lunheng_m_gate / lunheng_char_count，均只读）`)
       } catch (e) {
-        console.error(`· 论衡原生工具安装失败（不影响技能与流水线）：${String(e?.message || e).slice(0, 120)}`)
+        say('warn', `· 论衡原生工具安装失败（不影响技能与流水线）：${String(e?.message || e).slice(0, 120)}`)
       }
       try {
         const { installMechanismGuard } = await import('./guard.js')
@@ -107,12 +160,13 @@ export function apply(ctx) {
         if (!alive) { try { d?.() } catch { /* 已卸载 */ } return }
         if (d) {
           disposers.push(d)
-          console.error(
+          say(
+            'info',
             '· 论衡机制文件写保护已启用（write/edit 类工具对技能包内路径一律否决；主人授权时设 LUNHENG_ALLOW_MECH_EDIT=1）',
           )
         }
       } catch (e) {
-        console.error(`· 论衡机制写保护安装失败（不影响技能）：${String(e?.message || e).slice(0, 120)}`)
+        say('warn', `· 论衡机制写保护安装失败（不影响技能）：${String(e?.message || e).slice(0, 120)}`)
       }
       try {
         const { installStatusCommand } = await import('./commands.js')
@@ -120,10 +174,10 @@ export function apply(ctx) {
         if (!alive) { try { d?.() } catch { /* 已卸载 */ } return }
         if (d) {
           disposers.push(d)
-          console.error('· 论衡人类命令已注册：/lunheng-status（不产生模型消息）')
+          say('info', '· 论衡人类命令已注册：/lunheng-status（不产生模型消息）')
         }
       } catch (e) {
-        console.error(`· 论衡人类命令安装失败（不影响技能）：${String(e?.message || e).slice(0, 120)}`)
+        say('warn', `· 论衡人类命令安装失败（不影响技能）：${String(e?.message || e).slice(0, 120)}`)
       }
     })()
     return () => {

package/lib/tools.js

@@ -54,8 +54,12 @@ const clip = (s, n = 500) => String(s ?? '').slice(0, n)
  * @param opts.defineToolFactory - 可选：自定义 `defineTool` 来源（默认 `() => import('@deepseek-ai/dsh-tools')`）。
  *   存在的意义：① 测试环境（裸仓库 / CI）没有宿主包，可注入契约等价的替身，从而**照常覆盖工具行为**；
  *   ② 宿主换包名时只改这一处。
+ * @param opts.report - 可选：状态输出回调 `(level, message) => void`（默认 `console.error`）。
+ *   v18.2.4（审计 C.3）：宿主有 Cordis `logger` 时入口会传入按 logger 分流的 reporter，
+ *   避免每次启动无条件刷 stderr。
  */
-export async function installLunhengTools(ctx, { skillRoot, defineToolFactory } = {}) {
+export async function installLunhengTools(ctx, { skillRoot, defineToolFactory, report } = {}) {
+  const say = typeof report === 'function' ? report : (level, message) => console.error(message)
   const tools = ctx.get('tools')
   if (!tools?.register) return []
   let defineTool
@@ -64,7 +68,7 @@ export async function installLunhengTools(ctx, { skillRoot, defineToolFactory }
     ;({ defineTool } = await factory())
     if (typeof defineTool !== 'function') throw new Error('defineTool 不是函数')
   } catch (e) {
-    console.error(`· 论衡原生工具未启用（无法取得 defineTool：${String(e?.code || e?.message).slice(0, 80)}）——技能与流水线不受影响，仍可用 pwsh 调脚本`)
+    say('warn', `· 论衡原生工具未启用（无法取得 defineTool：${String(e?.code || e?.message).slice(0, 80)}）——技能与流水线不受影响，仍可用 pwsh 调脚本`)
     return []
   }
   const disposers = []

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lunheng-article-pipeline",
-  "version": "18.2.3",
+  "version": "18.2.5",
   "description": "论衡（lunheng-article-pipeline）— 多 Agent 深度长文流水线技能包（DeepSeek Harness 原生插件）：定题→并行检索（文献/数据/案例）→分析→大纲人在环确认→写作→批判→审计→审稿→修订→配图→终检交付，9 个独立角色 T1-T9 互不可替代（文献/数据/案例/分析/写作/批判/审计/终检/审稿），主控 = T0 调度 + T8 终检亲执行（T8 独立角色，执行者主控担任，不 spawn），T9 审稿可选默认选中学术必选，三角验证 + M 机械化硬门 + F 失败模式防御 + G14 中文 AI 痕迹闸 + 期刊匹配助手，用 dsh subagent 子代理编排。",
   "type": "module",
   "main": "lib/index.js",

package/skills/lunheng-article-pipeline/AGENTS.md

@@ -78,6 +78,9 @@ Phase 5 终检     → T8 终检（独立角色，主控 T0 以 T8 身份亲完
    > **文档涨了先看词预算门**（v18.1.0）：`repo-hygiene-check` 规则⑨ 对技能目录内 ≥12 KB 的 .md 逐文件设**棘轮上限**（SKILL.md 30→31 KB 是本轮显式抬升）。**任何文档增长必须在同一次提交里抬升上限并写明理由**；`skills/lunheng-article-pipeline/scripts/` 外的仓库脚本改动不受此门约束。规则① 同时扩面到 `.js` 与**未跟踪文件**（`npm pack` 会打包未 `git add` 的新脚本）。
    **仓库级打包面检查**（`cordis.patch.yml` 合法性 / 行 id 唯一 / `dsh.bundle.patch` 指向 / `package.json` 元数据（`main` + `files` 含 `lib` + `packageManager`）/ 五语 README 一致性 / 工程红线；**v18.0.0 起无豁免**，11 通过 / 3 跳过）由 CI 的 `plugin-surface` job 承担，本地复现命令见 `.github/workflows/ci.yml` 与 CHANGELOG 同名条目；**包入口的执行路径**由 `tests/entry.test.mjs` 用最小 ctx 真跑 `apply` 覆盖、**「patch 必须插入本包自注册行」由 `tests/bundle-contract.test.mjs` 覆盖**（静态门不执行入口、也不验 patch 是否引用本包，故这两条不可省——教训 #152 / #154）
 
+7. **读中文文件一律显式 `-Encoding UTF8`（v18.2.5 新增）**：`Get-Content` 等文本读取必带该参数。
+   > **判据：看到中文乱码，先怀疑读取端编码，不要先怀疑文件**（实测：合法 UTF-8 文案在 pwsh 默认解码下显示乱码，曾被误判为「子代理产物编码坏了」，险些错误重派）。
+
 ## 开发参考资料（v18.0.0 新增，主人指示：官方资料为以后开发的重要参考）
 
 > **判据（主人 2026-09-11 指示）**：凡涉及**包形态、插件契约、服务/事件、工具注册、打包发布、官方文档规范**的改动，**先查官方资料再动手**——不得凭记忆、也不得凭本包既有写法推断（既有写法本身可能与官方漂移）。

package/skills/lunheng-article-pipeline/QUICKSTART.md

@@ -1,6 +1,6 @@
-> 版本：v18.2.3（DSH bundle 插件）
+> 版本：v18.2.5（DSH bundle 插件）
 
-# 论衡快速开始指南（v18.2.3）
+# 论衡快速开始指南（v18.2.5）
 
 > **v2.3.0 升级（2026-08-21）**：角色编号重构（教训 #116）—— T6 案例检索 → T3 案例检索（三方并行检索员连贯 T1∥T2∥T3），T3-T8 顺延 + T7/T8 交换位置（终检 → T8 主控亲完成、批判 → T6 独立早期攻击、审计 → T7 形式审查）。新增 Phase 3.6 批判（T6 攻击 v2 含主人洞察）。
 >

package/skills/lunheng-article-pipeline/README.md

@@ -1,6 +1,6 @@
 # 论衡（lunheng-article-pipeline）— 多 Agent 深度长文流水线
 
-> **DSH 原生插件（v18.2.3）**：本仓库为 DSH bundle 技能包（`package.json` 的 `main` → `lib/index.js` 注册本技能 + `dsh.bundle.patch` → `cordis.patch.yml` 叠加三档 subagent 工具）；结构性差异见 `SKILL.md` 的「🔧 DSH 环境说明」章节。
+> **DSH 原生插件（v18.2.5）**：本仓库为 DSH bundle 技能包（`package.json` 的 `main` → `lib/index.js` 注册本技能 + `dsh.bundle.patch` → `cordis.patch.yml` 叠加三档 subagent 工具）；结构性差异见 `SKILL.md` 的「🔧 DSH 环境说明」章节。
 
 把一篇深度文章 / 论文的生产拆成 **9 个独立角色 T1-T9 + 6 个阶段**（v2.5.2-dsh.8 语义定案：T1-T9 互不可替代；Phase 1 为 T1 文献 ∥ T2 数据 ∥ T3 案例 三检索员三方真并行互不干涉，T3 任何量级必 spawn 含 0 条空卡协议；T6 批判伙伴 + T7 审计 + **T8 终检独立角色由主控 T0 亲执行** + T9 同行评审可选默认选中学术必选，v2.3.0 角色编号重构 + v2.4.0 加 T9），用 DSH 的 `subagent` 子代理编排，产出有**证据底座、反方论证、独立审计、人工核验节点**的交付物。
 

package/skills/lunheng-article-pipeline/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: "lunheng-article-pipeline"
-version: "18.2.3"
+version: "18.2.5"
 description: "论衡：DSH 原生多 Agent 深度长文流水线（学术论文 / 商业评论 / 行业分析 / 公众号）。9 个独立角色 T1-T9 + 主控（T0 调度 + T8 终检）；三角验证 + M 门 + G 审计 + 修订回环 ≤2 轮 + 期刊匹配。适用：≥2000 字、证据须可追溯的长文（含 4 个人在环节点、1-3 小时流水线时长）。**不适用**：<2000 字短文与即时问答；文学创作（小说/诗歌/剧本）；需数学推导或实验设计的理工科论文；营销软文；需要一手数据（问卷/访谈/田野/实验）而尚未投喂素材。"
 whenToUse: "「何时该用」与「何时不该用」的完整判据已并入 description（v18.0.5：官方目录只渲染 name + description，本字段对模型不可见，保留仅供工具链与维护者阅读）。"
 ---
 
-> 版本：v18.2.3（DSH bundle 插件）
+> 版本：v18.2.5（DSH bundle 插件）
 > **v2.5.2-dsh.8 角色语义定案（主人指令）**：**9 个角色 T1-T9 各自独立、不可相互替代**——T8 终检不是「主控兼做的杂活」而是独立角色（有独立角色卡），只是执行者由主控担任（**主控 = T0 调度 + T8 终检执行双重身份**），不 spawn 子代理；**T9 审稿可选、默认选中、学术论文必选**。
 
 # 多 Agent 深度长文流水线（论文/深度文章生产）
@@ -40,7 +40,8 @@ whenToUse: "「何时该用」与「何时不该用」的完整判据已并入 d
 
 **论衡技能的工具边界（DSH）**：
 - ✅ **可调用**：当前会话预设提供的工具（本机 standard 预设实测含 read / write / edit / web_search / web_fetch / todo_write / subagent / list_agents / pwsh 等）——DSH 无技能级白名单，工具集由 Agent 预设决定。**调用任何工具前先确认它在当前会话工具清单里**（教训：`read_page`/`bash` 并不存在于本预设，曾被本文档误声明为可用）。
-- ✅ **随包脚本白名单（v2.5.2-dsh.17 复核为 11 个）**：`scripts/*.mjs` = consistency-check / m-gate-check / md2html / pdfcheck / token-cost / count-chars / build-evidence-bundle / final-check / normalize-trust-level / model-routing / token-budget + 有限验证命令（ls/stat/wc/cp/diff/Get-FileHash 等）——**受限 shell 使用**（另：`_lib` 子目录为共享库，非入口、不单独调用），非「零 exec」；其余命令须经主人同意。
+- ✅ **随包脚本白名单（v18.2.5 复核为 12 个）**：`scripts/*.mjs` = consistency-check / m-gate-check / md2html / pdfcheck / token-cost / count-chars / build-evidence-bundle / final-check / normalize-trust-level / model-routing / token-budget / apply-diff + 有限验证命令（ls/stat/wc/cp/diff/Get-FileHash 等）——**受限 shell 使用**（另：`_lib` 子目录为共享库，非入口、不单独调用），非「零 exec」；其余命令须经主人同意。
+  > **`apply-diff.mjs`（v18.2.5 新增）**：段级 diff 清单机械应用器，用法与清单格式约定见 [`references/pipeline-readme.md`](references/pipeline-readme.md) §修订轮默认段级 diff。
 - ❌ **不做**：凭据访问 / 浏览器自动化 / 定时任务（除白名单脚本与验证命令外，主控默认不执行任意 shell，LLM 推理判定）。
 - 🔒 **机制文件写保护（v2.5.2-dsh.13；v18.1.0 部分机械化）**：`SKILL.md` / `AGENTS.md` / `references/**` / `scripts/**` / `cordis.patch.yml` 属**机制文件**——任何角色（含主控与子代理）**不得**用 write/edit 改动；改进动议只写 `audits/反哺报告-vN.md`，由主人在 host shell apply。**改机制文件 = P0 违规，本次交付作废**。v18.1.0 起 bundle 部署下这条由 prompt 升级为**机制否决**（入口注册全局 `ctx.tools.guard()`，命中即拒绝；主人授权走 `LUNHENG_ALLOW_MECH_EDIT=1`）；**残余缺口**：guard 只看工具调用，`pwsh` 不经此门——「比 prompt 强、比机制强制弱」。详见 `references/_shared/DSH-集成方案.md` §6。
 - 🧾 **闸门必须留机械证据（v2.5.2-dsh.13 新增；v18.0.2 统一退出码；v18.0.5 补异常路径）**：T2.5/T7.5 与 M 门**不得只凭自述**——交接报告须附**脚本 exit code + 产物路径**（如 `m-gate-check.mjs … --report <项目>/final/M-Gate-Report.json` 的 exit 与报告路径）。exit 语义：`0` 通过 / `1` P1 失败 / `2` P0 失败 / `3` 仅 P2·soft·SKIP（需 LLM 复核，**不得**当通过）/ `10` **参数或路径错误**（含**异常路径**：v18.0.5 起所有随包脚本装 `_lib/exit-guard.mjs`，fs 类异常统一映射为 10，不再让未捕获异常退化成 1）/ `70` **内部错误（EX_SOFTWARE，脚本缺陷）**——与任何内容判定无关。**路径错一律 10，不得与 P1 混用**（`m-gate-check` 曾把「定稿/证据包不存在」判 1，`final-check` 会误渲染成「有 P1 残留、可触发 T5 修订」）。另：`model-routing.mjs` 用自有码 **`4`**＝需人工决定（旧版 `3` 与 M 门 `3` 撞码）；非闸门工具（`token-budget`/`md2html`/`pdfcheck`/`token-cost`）不共用本语义，见各自头注释与 `docs/troubleshooting.md §8`。
@@ -94,7 +95,7 @@ whenToUse: "「何时该用」与「何时不该用」的完整判据已并入 d
 
 ## ⚡ 启动速查表
 
-- 版本：v18.2.3｜角色：T0 主控（= T8 终检执行者）＋ T1 文献 / T2 数据 / T3 案例 / T4 分析 / T5 写作 / T6 批判 / T7 审计 / T8 终检（主控亲执行）/ T9 审稿（默认选中，学术必选）
+- 版本：v18.2.5｜角色：T0 主控（= T8 终检执行者）＋ T1 文献 / T2 数据 / T3 案例 / T4 分析 / T5 写作 / T6 批判 / T7 审计 / T8 终检（主控亲执行）/ T9 审稿（默认选中，学术必选）
 - Phase：0 定题 → 1 检索(T1∥T2∥T3) → 2 分析 → 2.5 大纲(人) → 3 写作 → **[3.1 G14 早闸]** → 3.5 洞察(人) → 3.6 批判 → 4 审计 → 4.5 审稿+G14 → 5 终检(人)
 - 工具：subagent=派发（分档预设按角色选 subagent_retrieval/strong/audit）｜list_agents=查看｜todo_write=计划｜web_search/web_fetch=检索｜pwsh=命令｜edit/write=文件
 - 闸门：T2.5（检索→分析）/ T7.5（审计→终检）；M 门 exit 0；修订回环双轨 ≤2 轮（A 轨）

package/skills/lunheng-article-pipeline/references/_shared/DSH-/351/233/206/346/210/220/346/226/271/346/241/210.md

@@ -1,7 +1,7 @@
 # 论衡 × DSH 能力面集成方案
 
-> **版本**：v18.2.3（C 组落地；§一–§六 为 v18.0.2 原文，§七–§八 为 v18.2.1 新增，**§九 为 v18.2.2 新增**）
-> **用途**：把论衡的既有机制（11 个门禁脚本 / 并行阶段 / 状态机 / 人在环闸门）**对齐 DSH 已有能力面**，替代平行自建。§一–§六 是**实施方案**，§七 是**落地状态表**，§八 是**可选配方**。
+> **版本**：v18.2.5（C 组落地；§一–§六 为 v18.0.2 原文，§七–§八 为 v18.2.1 新增，**§九 为 v18.2.2 新增**）
+> **用途**：把论衡的既有机制（12 个门禁脚本 / 并行阶段 / 状态机 / 人在环闸门）**对齐 DSH 已有能力面**，替代平行自建。§一–§六 是**实施方案**，§七 是**落地状态表**，§八 是**可选配方**。
 > **依据**：DSH 官方文档 `docs/cookbook/adding-a-tool.md`、`docs/tool-execution-pipeline.md`、`docs/subsystems/*.md`、`docs/capability-seams.md`（知识库副本见 `dsh-plugin-guide/references/official-docs/`；行号对快照 commit `d347e703…`）。
 > **当前状态**：**C 组四项已启用**（原生只读工具 / `ctx.tools.guard()` 写保护 / `/lunheng-status` / 词预算门）、一项给配方（分档工具行→agent preset）、一项仍未接线（Phase 内并行→`workflow`，依官方用法限定「仅在用户明确要求 workflow 或大规模编排时」用，故**降级为按需**）。
 
@@ -25,7 +25,7 @@
 
 ### 2.1 适用与收益
 
-把 11 个 `scripts/*.mjs` 中**可机械判定**的（`m-gate-check` / `count-chars` / `consistency-check` / `build-evidence-bundle`）注册为模型工具，收益：
+把 12 个 `scripts/*.mjs` 中**可机械判定**的（`m-gate-check` / `count-chars` / `consistency-check` / `build-evidence-bundle`）注册为模型工具，收益：
 
 - 模型直接调用，不必绕 shell（省一轮 `pwsh` + stdout 解析）
 - 获得工具执行管线的策略钩子（`tools/pre-execute` 可挂审批，如「M 门 exit ≠ 0 时要求人工确认」）

package/skills/lunheng-article-pipeline/references/_shared/M-Gate-Algorithm.md

@@ -1,4 +1,4 @@
-> 版本：v18.2.3（DSH bundle 插件）
+> 版本：v18.2.5（DSH bundle 插件）
 
 > **v2.5.2-dsh.5 重大修订**（测试轮反哺 14 项问题落地）：
 > - **P0** #1 M-Form-2 与 M-Form-7 白名单统一（含 AI 使用声明）