lunheng-article-pipeline 18.2.1 → 18.2.4

package/README.es.md

@@ -1,6 +1,6 @@
 # Lunheng (lunheng-article-pipeline) — pipeline multiagente para textos largos
 
-> 版本：v18.2.1（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.4（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.1 && git push origin v18.2.1   # un tag por push (GitHub: >3 tags en un push no dispara workflow)
+git tag v18.2.4 && git push origin v18.2.4   # 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.1（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.4（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.1 && git push origin v18.2.1   # एक बार में एक ही tag (GitHub: >3 tag एक push में कोई workflow नहीं चलाता)
+git tag v18.2.4 && git push origin v18.2.4   # एक बार में एक ही 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.1（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.4（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.1 && git push origin v18.2.1   # push one tag at a time (GitHub: >3 tags in one push triggers no workflow)
+git tag v18.2.4 && git push origin v18.2.4   # 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.1（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.4（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.1 && git push origin v18.2.1   # uma tag por push (GitHub: >3 tags em um push não dispara workflow)
+git tag v18.2.4 && git push origin v18.2.4   # 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.1（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
+> 版本：v18.2.4（DSH bundle：package.json + cordis.patch.yml + lib/index.js）
 
 > 一个 DeepSeek Harness（DSH）bundle 插件，注册一个按需加载的 agent 技能。它把深度长文的生产——学术论文、行业分析、商业评论、公众号深文——变成**带人在环节点的 9 角色流水线**。
 
@@ -108,7 +108,7 @@ patch 层做两件事：**插入一行本包自注册行**（`- id: lunheng-arti
 **只推 tag 发布，禁止本地 `npm publish`**（本地直发会绕过 CI 三道门与 OIDC 来源证明，且 npm 版本不可覆盖）。
 
 ```sh
-git tag v18.2.1 && git push origin v18.2.1   # 一次只推 1 个 tag（GitHub：单次 push >3 个 tag 不触发任何 workflow）
+git tag v18.2.4 && git push origin v18.2.4   # 一次只推 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.1（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`）、复现步骤、影响面判断、以及你期望的披露时限。
@@ -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.1）
+# lunheng-article-pipeline bundle patch（DSH 原生插件 v18.2.4）
 #
 # 本文件用 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.1**（DSH 独立版本）。
+> 适用：公众号深度长文、研究报告、学术论文、商业评论、行业分析——任何"要站得住脚"的长内容。当前版本 **v18.2.4**（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.1`
+- **npm**：`lunheng-article-pipeline@dsh`（dist-tag `dsh` = 最新 DSH 迭代版）；锁定具体版本可写 `@18.2.4`
 - **历史版本线（独立化前）**：https://github.com/zuoyunlai/lunheng-article-pipeline
 
 ---

package/docs/troubleshooting.md

@@ -1,6 +1,6 @@
 # 故障排查（troubleshooting）
 
-> 版本：v18.2.1（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.1
+# 锁定具体版本：dsh plugin --profile web add lunheng-article-pipeline@18.2.4
 
 # 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.1",
+  "version": "18.2.4",
   "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

@@ -4,7 +4,8 @@
 
 ## 启动时必读
 
-> **清单真源 = `SKILL.md` §启动清单**（v18.0.5 收敛：此前本处 4 项与 SKILL 3 项不一致——一方漏 §十二、一方漏 `MEMORY.md`）。要点复述（**以 SKILL.md 为准**）：① `references/pipeline-readme.md` 的「流水线全景 / 派发话术 / 模型配置」三节；② `references/glossary.md`（按需查节；**§十二 本技能自用术语与文档约定** 属改机制前必读）；③ `MEMORY.md` + `memory/YYYY-MM-DD.md`（主人偏好与最近关注）。
+> **清单真源 = `SKILL.md` §启动清单 与 §⚡ 启动速查表**——本处**不再复述**。
+> v18.2.2 收敛（主人授权修订；依据 2026-09-12 全量测试反哺）：旧版此处**复述**了 SKILL 的 3 项启动清单，构成**同一事实两处维护**——v18.0.5 已因「本处 4 项 vs SKILL 3 项」不一致修过一次，但只要还在复述，就会**再漂**（改启动清单时要记得同步两处 = 违反「一事实一处」）。**改启动清单只改 `SKILL.md`**。
 
 > **包形态（v18.0.0 起）**：**包根**含 `package.json`（`main` → `lib/index.js` + `dsh.bundle.patch` → `cordis.patch.yml`）、`lib/index.js`（**入口**：读随包 `skills/lunheng-article-pipeline/SKILL.md`，经 `ctx.skills.register()` 注册为 agent 技能，`inject=['skills']` + `resourceBase` 指向技能目录，注册即 effect、卸载自动清理）、`cordis.patch.yml`（**① 插入本包自注册行** `- id: lunheng-article-pipeline / name: lunheng-article-pipeline`——loader 靠这一行按包名 import 入口，**删了它技能就不注册**（v18.0.0 缺陷，v18.0.1 修复）+ ② 3 档 subagent 工具）。两种部署均受支持：① `dsh plugin add` 装 bundle（技能由入口注册）；② 把 **`skills/lunheng-article-pipeline/` 技能目录**复制到任一 skill 根（项目级 `.dsh/skills/` rank 100 / 用户级 `$DSH_HOME/skills/` rank 400）。**包面自检**：`dsh-plugin-dev check`（14 项：11 通过 / 3 跳过——**v18.0.0 起无豁免**，目标 0 fail / 0 warn）+ `node --test "tests/**/*.test.mjs"`。
 

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

@@ -1,6 +1,6 @@
-> 版本：v18.2.1（DSH bundle 插件）
+> 版本：v18.2.4（DSH bundle 插件）
 
-# 论衡快速开始指南（v18.2.1）
+# 论衡快速开始指南（v18.2.4）
 
 > **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.1）**：本仓库为 DSH bundle 技能包（`package.json` 的 `main` → `lib/index.js` 注册本技能 + `dsh.bundle.patch` → `cordis.patch.yml` 叠加三档 subagent 工具）；结构性差异见 `SKILL.md` 的「🔧 DSH 环境说明」章节。
+> **DSH 原生插件（v18.2.4）**：本仓库为 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.1"
+version: "18.2.4"
 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.1（DSH bundle 插件）
+> 版本：v18.2.4（DSH bundle 插件）
 > **v2.5.2-dsh.8 角色语义定案（主人指令）**：**9 个角色 T1-T9 各自独立、不可相互替代**——T8 终检不是「主控兼做的杂活」而是独立角色（有独立角色卡），只是执行者由主控担任（**主控 = T0 调度 + T8 终检执行双重身份**），不 spawn 子代理；**T9 审稿可选、默认选中、学术论文必选**。
 
 # 多 Agent 深度长文流水线（论文/深度文章生产）
@@ -94,8 +94,8 @@ whenToUse: "「何时该用」与「何时不该用」的完整判据已并入 d
 
 ## ⚡ 启动速查表
 
-- 版本：v18.2.1｜角色：T0 主控（= T8 终检执行者）＋ T1 文献 / T2 数据 / T3 案例 / T4 分析 / T5 写作 / T6 批判 / T7 审计 / T8 终检（主控亲执行）/ T9 审稿（默认选中，学术必选）
-- Phase：0 定题 → 1 检索(T1∥T2∥T3) → 2 分析 → 2.5 大纲(人) → 3 写作 → 3.5 洞察(人) → 3.6 批判 → 4 审计 → 4.5 审稿+G14 → 5 终检(人)
+- 版本：v18.2.4｜角色：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 轨）
 - 闸门留痕（v2.5.2-dsh.17）：两道闸门各落一份 `audits/闸门记录-T2.5.md` / `-T7.5.md`（模板 `templates/闸门记录-template.md`）——「实据」列必须是路径/exit code/命令，写「已检查」被判 P1（机检 **M-Exist-5**）
@@ -200,7 +200,7 @@ whenToUse: "「何时该用」与「何时不该用」的完整判据已并入 d
 ## 角色卡与模板
 
 - **9 个独立角色卡（T1-T9）**：`references/agents/01~09`（00-主控-coordinator.md = T0 调度 + T8 终检双重身份；**`00-主控-扩展职责.md` = T0 的实操手册（49 KB，全库第二大文档，含 §一–§二十三：编排循环防空转 / 闸门公共动作 / 主人侧产物…）——v18.0.5 补入本索引，此前只能从 coordinator 卡的指针到达**；T8 独立卡 08-终检-finalizer.md，主控亲执行不 spawn；T9 默认选中、学术必选；T3 任何量级必 spawn 含 0 条空卡协议）。
-- **模板**：`references/templates/`（**26 个**，v18.0.3 实测；按用途取用，别整目录读）：`任务简报 / status / 交接报告 / 文献卡 / 数据卡 / 案例卡` 各含 **full + lite**（实战用 lite，培训/字段详解用 full）+ 单文件模板 `先行者清单 / G14检测报告 / 主人确认 / AI-使用声明 / 修订说明 / 投稿就绪检查表 / 图表-SVG / 素材加载清单 / 闸门记录 / 交付说明 / 模型路由表 / 进展-主人版 / 主人投喂清单 / style-baseline`。
+- **模板**：`references/templates/`（**27 个**，v18.2.2 实测；按用途取用，别整目录读）：`任务简报 / status / 交接报告 / 文献卡 / 数据卡 / 案例卡` 各含 **full + lite**（实战用 lite，培训/字段详解用 full）+ 单文件模板 `先行者清单 / G14检测报告 / 主人确认（= 阶段确认单通用模板）/ AI-使用声明 / 修订说明 / 投稿就绪检查表 / 图表-SVG / 素材加载清单 / 闸门记录 / 交付说明 / **局限性（v18.2.2 新增）** / 模型路由表 / 进展-主人版 / 主人投喂清单 / style-baseline`。
   > v18.0.3：旧版此处只列 15 项（漏 7 个后加模板）；**改模板集合时同步本行**（`ls references/templates/` 为准）。另：`机检硬格式` 表已收口到 [`references/_shared/机检硬格式.md`](references/_shared/机检硬格式.md)。
 - **运行手册**：`references/pipeline-readme.md`（含 T1-T9/G14 派发话术 + M 门 + F 模式 + AI 披露）。
 - **新增文档索引**：字数判定表 / degraded-scenarios / 期刊数据库+匹配算法 / 中文数据源集成 / format-export / case-studies 均位于 `references/_shared/` 与 `references/`（路径见各节链接）。