dsh-distillation-director 4.6.6 → 4.9.15

package/README.md

@@ -1,4 +1,4 @@
-# distillation-director · 蒸馏主管（V4.6 · 三闸判态 ＋ §21 强制门禁 ＋ 防坑体系）
+# distillation-director · 蒸馏主管（V4.9.15 · 发行自足 ＋ 三闸判态 ＋ §21 强制门禁 ＋ 装机态三层律 ＋ 判据单一来源 ＋ 防坑体系）
 
 把一本书蒸馏成一组可执行的 Agent 技能——**判态制元技能**（权威执行标准）。
 
@@ -8,23 +8,38 @@
 
 ## 30 秒上手
 
-**① 安装**（四条路径任选其一；**前三条都验证过**）
+**① 安装**（四条路径任选其一）
+
+> ⚠️ **v4.9.3 起请勿用 npm 那条（路径 A）**：npm registry 上目前仍是 **4.6.6**，而 4.6.6 **不含 §21 三道闸
+> （`gate_start.py`／`gate_stage.py`／`gate_checklist.py`）与 4 个配套脚本**，装了跑不动。
+> **v4.9.8** 请用 **B / C / D / E** 任一条；npm 待发版后本提示会撤掉。
 
 ```bash
-# A. npm 一行直装（最省事；已在 npm registry 上架）
+# A. npm 一行直装（⚠️ 目前仍是 4.6.6，缺 §21 闸；4.9.x 未上架 npm 前请勿使用）
 dsh plugin add dsh-distillation-director
 
-# B. 固定链接直装（不需要 npm；永远指向最新版）
+# B. 固定链接直装（**推荐**；不需要 npm；别名资产永远指向最新版）
 dsh plugin add https://github.com/winsonpong98-cloud/dsh-distillation-director/releases/latest/download/dsh-distillation-director.tgz
 
-# C. 从仓库直装（需要能访问 GitHub；仓库已锁定行尾字节保真）
-dsh plugin --profile web add github:winsonpong98-cloud/dsh-distillation-director
+# B'. 指定版本直装（要固定字节时用这条）
+dsh plugin add https://github.com/winsonpong98-cloud/dsh-distillation-director/releases/download/v4.9.8/dsh-distillation-director-4.9.8.tgz
+
+# C. 从仓库直装（需要能访问 GitHub；仓库已锁定行尾字节保真；可指定 tag）
+dsh plugin --profile web add github:winsonpong98-cloud/dsh-distillation-director#v4.9.8
 
 # D. 从 Release 页面下载 tgz 后本地装（字节与作者双门校验过的发行件完全一致）
-dsh plugin add <你下载到的 dsh-distillation-director-vX.Y.Z.tgz 路径>
+dsh plugin add <你下载到的 dsh-distillation-director-4.9.8.tgz 路径>
+
+# E. 🆕 网络挡了 github.com 时的替代通道（走 api.github.com 直连，**无需令牌**）
+#    2026-09-19 实测：作者本机与 NAS 均**无法访问 github.com**（TCP 超时），而 api.github.com 正常 ⇒
+#    路径 B 在这类网络下整条失效。api.github.com 的资产直连**已验证可用**（见下方「网络与替代通道」）。
+curl -s https://api.github.com/repos/winsonpong98-cloud/dsh-distillation-director/releases/latest | grep '"id"'
+curl -L -H 'Accept: application/octet-stream' -o dsh-distillation-director.tgz \
+  https://api.github.com/repos/winsonpong98-cloud/dsh-distillation-director/releases/assets/<ASSET_ID>
+dsh plugin add ./dsh-distillation-director.tgz
 ```
 
-> 三条远程路径的关系：**A** 走 npm registry（最稳、最短）；**B** 走 GitHub Release 的别名资产（**npm 不可用时的备用通道**，链接永不随版本变化）；**C** 走 git 仓库（仓库已加 `.gitattributes` 锁定行尾字节，保证"直装字节＝发行字节"）。
+> 四条路径的关系：**B** 走 GitHub Release 的**别名资产**（`…/releases/latest/download/dsh-distillation-director.tgz`，链接永不随版本变化，本版已同时上传该别名件）；**B′** 是带版本号的固定链接；**C** 走 git 仓库（`.gitattributes` 锁定行尾字节，保证"直装字节＝发行字节"）；**D** 是最稳的离线路径；**A** 待 npm 发版后恢复为最短路径。
 
 **② 开一个新会话，说触发词**（任一）
 
@@ -43,22 +58,56 @@ python tools\gate_start.py --task <你的任务 slug>
 
 ## 战绩清单（实测背书）
 
-| 维度 | 数据 |
+> **本表每个数字都是"本机跑一条命令就能复算"的**（复算方式见下表末行）。
+> **不列具体书名**：插件是「蒸馏方法论文档」，只含流程/规则/判态标准/机器层脚本；具体书目属**使用者自己的台账**
+> （《避坑手册》`A-74`：通用件里不得有任何一本书的数据）。
+> **也不写"估算"冒充"实测"**：凡标注"实测"的，都能在场产物里逐项对出来（`A-135`）。
+
+| 维度 | 数据（2026-09-19 实测） |
 |---|---|
-| 已蒸馏书籍 | 10+ 本（投资 8+ 本 + 教育 2 本 + 技术标准 1 本） |
-| 产出技能 | 40+ 个（金融投资宿主 41 个 + 教育/技术技能） |
-| 质量 | 零🔴、A 档交付（三闸判态制门禁） |
-| 单本成本 | **¥20.5 实测**（L2.5 epub 文字版 ≈14 万字，35 次 flash 子代理 + 机器层 ¥0） |
-| 机器层 | 零成本先行（引文逐字核验 / 盲测词表 / 防线3 冒充扫描 / 9 维预检，全部本地脚本） |
+| 本机蒸馏册数 | **10 本**（投资/金融类书树 7 ＋ 教育·心理·行为类任务 3；**另有 1 本在 NAS 上跑**） |
+| 产出技能 | **77 个**（上述书树／任务产出的 slug 去重并集） |
+| 在役技能 | **71 个**（金融宿主 49 ＋ 教育宿主 23，跨宿主机重复 1 个）；另有 **25 个已封存**（archived） |
+| 三闸判态 | **零🔴**（防线3 忠实度／盲测路由／达尔文体检；**▲ 建议项如实登记**，不删不掩） |
+| 单本成本（L2.5） | **蒸馏主体 ¥13.45** ＋ **同项目后续回改/工装优化 ¥4.07** ＝ **全程 ¥17.52**（账户余额差口径；文字版≈14 万字）｜**开工前估算 ¥20.5** ⇒ 全程比估算低 **14.5%** |
+| 机器层成本 | **¥0**（引文逐字核验／盲测词表／防线3 冒充扫描／9 维预检，全部本地脚本，不花 API） |
+| **异机真机实测** | **NAS（Synology ＋ DSH Linux 容器）**：装机**三层读数**全通、整本 L2.5 **跑通交付**、六阶段门禁 **全 PASS**、候选池 **236 条引文 100% 回源命中** |
+| 工装自纠 | 上述真机跑动**逼出两处"尺子"缺陷**（波段 id 语法内联 17 处／源文件决议两套规则）**并已修复落闸** —— 见下方「这套门禁真的会抓东西吗」 |
+| 复算口径 | **册数**＝凡有 `skills/<slug>/SKILL.md` 产出的书树或任务目录记 1 册；**技能**＝目录内含 `SKILL.md` 才算，审计副本目录与封存件不计。按此口径在自己工作区数一遍即可复算（数字随你的产出变化，不必与上表相同） |
+
+**这套门禁真的会抓东西吗？**（不是"我声称它有用"，而是**它抓过我**）
+
+| 抓到的 | 症状 | 结局 |
+|---|---|---|
+| 波段条目 id 语法**内联 17 处、4 种残缺写法** | 同一份**合规**产出，一个仪器报 🔴、另一个报 ✔（**一手绿一手红**） | 收敛为 `_bandid.py` 单一真源 ＋ 新闸 `check_bandid_single_source.py`（内联即判红，10 样本自证） |
+| 「源文件决议」写了**两套规则** | 源被决议到**任务自己的产出文档**，6 波段 **236/236 条引文全报"回源未命中"**（会诱导你去改**合规的产出**） | 收敛为唯一函数 `resolve_src()` ＋ 兜底**内容闸**（必须真含页标记） |
+| 装机"装了两层只通一层" | 文件在、`plugin list` 列得出，**但技能永不注册且不报错** | 三层读数闸 `check_install_state.py`（挂 `postflight`） |
+| "改了却没进包"**三种形态** | 手写清单漏件／换了手册没同步／**重建了但没替换已发布资产** | 清单改**闭包推导**＋剪枝；补 SKILL.md 同步步；发版闸**对下载到的字节**复验 |
+
+<details>
+<summary><b>实测口径说明（点开）</b></summary>
+
+- **"册数"怎么数**：凡有 `skills/<slug>/SKILL.md` 产出的**书树或任务目录**记 1 册（不看书名、不看字数）。
+- **"技能"怎么数**：目录内含 `SKILL.md` 才算；审计用的**副本目录**（如 `<审计副本目录>`）与**封存件**（`archived/`）不计。
+- **成本口径**：官方主口径＝**账户余额差**（外部账本给出，与被测对象无关）。本机另有**会话级台账**与**按天台账**
+  两个参照口径，三者最大差 **约 7 倍**（计价模型不同），**如实并列、不择一、不平均**；
+  对外只引用主口径，分歧细节见工作区 `口径登记单`（`K-02`／`K-03`）。
+- **质量口径**：**判态制**，不打分。三闸＝防线3 忠实度／盲测路由／达尔文体检，判据是**零🔴**；
+  **▲ 类建议项不隐藏**——本项目曾有一整轮"停在 4 个 ▲、10 条已知边界"如实收口，而不是刷成 0。
+- 上表所有数字均为**本机实测**，可复核；**它们描述的是"方法在这类书上跑过"，不含任何书的内容**。
+
+</details>
 
 **差异化 vs 通用蒸馏框架（如 cangjie）：**
 
 | 维度 | 通用框架 | 本插件 |
 |---|---|---|
 | 定位 | 书/视频/播客/课程全科 | **专注书籍蒸馏专科** |
-| 验证 | 通用模板 | **三闸判态 + 逐字核验** |
-| 机器层 | 无 | **有（脚本 ¥0）** |
-| 公开战绩/成本 | 无 | **40+ 技能零🔴、¥20.5/本实测** |
+| 验证 | 通用模板 | **三闸判态 + 逐字回源核验** |
+| 机器层 | 无 | **有（本地脚本 ¥0）** |
+| 公开战绩/成本 | 无 | **10 册 → 77 个技能零🔴、全程 ¥17.52/册实测**（口径已写明，可自行复算） |
+| 门禁强度 | 约定式 | **命令级拦截**（§21：开工自证闸／阶段依赖链／执行单逐项闸，未过跑不动） |
+| 异机可用性 | 未声明 | **真机实测**（Windows ＋ Linux 容器；跨平台静态判据 ＋ 空假根仿真） |
 
 ---
 
@@ -70,6 +119,9 @@ python tools\gate_start.py --task <你的任务 slug>
 - **路径 B（GitHub Release 固定链接）**：别名资产链接**永远指向最新版**，**不需要 npm 也能装**——这是"npm 通道不可用"时的备用通道。
 - **路径 C（仓库直装）**：仓库已加 `.gitattributes`（`* -text`）**禁用 git 行尾转换**，因此克隆／直装得到的字节与发行 tgz 一致（这是被实测修过的坑，见下「发行纪律」）。
 - **路径 D（本地 tgz）**：适合离线／内网／要固定字节的场景。Release 页资产即**作者本机双门校验通过的那一份**。
+- **路径 E（API 直连替代通道）** 🆕：**网络挡了 `github.com` 时用**——走 `api.github.com` 的资产直连（无需令牌）。
+  2026-09-19 实测：作者本机与 NAS **都访问不了 `github.com`**（TCP 超时，偶发抖动），而 `api.github.com` 正常
+  ⇒ **路径 B 在这类网络下整条失效**；路径 E 已验证可用（HTTP 200／字节与本地一致）。详见下方「网络与替代通道」。
 - 所有路径最终都产生同一条挂载配置：
 
 ```yaml
@@ -78,34 +130,123 @@ python tools\gate_start.py --task <你的任务 slug>
       name: dsh-distillation-director
 ```
 
-**验证装上了**（可选，一条命令看引擎是否真加载）：
+**验证装上了**（**2026-09-18 重写：一条命令不够，要读三层读数**）：
+
+> **为什么重写**：2026-09-18 在一台 NAS 的 DSH 容器里实测到**"装了但不生效"**——
+> `node_modules\dsh-distillation-director` 目录在、`dsh plugin list` 也列得出它，
+> **但开会话时技能目录里根本没有 `distillation-director`**，而且**不报任何错**。
+> 逐层读数定位：`dependencies` 里有它、**`dsh.profile.bundles` 里没有它**
+> ⇒ 引擎按 `bundles` 组装 → 没组装就不会加载 → 没加载就不会 `apply()` → 技能从未注册。
+> **决定性读数**：`--dump-config` 组装树 566 行里 `distillation` 命中 **0**；补进 bundles ＋ 重启后 569 行、命中 **3**。
+
+**一条命令给三层读数**（推荐；`--self-test` 先用坏样本自证闸有效）：
 
 ```bash
-dsh web --dump-config | findstr /C:"distillation-director"
+python scripts/gates/check_install_state.py
+python scripts/gates/check_install_state.py --self-test     # 闸自证：4 类坏样本必须被拦
+python scripts/gates/check_install_state.py --json out.json  # 机器可读
 ```
 
+**手工读三层读数**（没有 python 时照这个顺序查，**不要跳层**）：
+
+```text
+① 落盘层（文件在不在、声明齐不齐）
+   · plugins/<pkg>/package.json 可解析、version 正确、**声明了 dsh.bundle.patch**
+   · SKILL.md 在场（frontmatter 有 name/description）· index.js 能真导入且导出 apply
+
+② 登记层（**今天断的就是这一层**）
+   · <profile>/package.json 的 dependencies **且** dsh.profile.bundles 都要有 dsh-distillation-director
+   · 装配实测（**看行数与命中数，别只看有没有报错**——这一层不会报错，只会静默少一行）：
+     dsh web --dump-config | findstr /C:"distillation-director"        # Windows
+     node <dsh>/lib/bin.js --profile web --dump-config | grep -n distillation   # Linux/容器
+
+③ 在役层（写进去了 ≠ 跑起来了）
+   · 服务可达（HTTP 状态）· 启动日志**带时间戳**确认是本次启动的记录
+   · 开一个新会话，看技能目录里是否出现 distillation-director（或按 SKILL.md §17.2 用引擎加载器实测）
+```
+
+**若 ② 缺失（最常见的失败）**，按顺序修：
+```bash
+cp <profile>/package.json <profile>/package.json.bak-$(date +%Y%m%d)
+dsh plugin --profile <profile> add <包名或插件目录或 tgz>   # 官方命令会按安装态 reconcile，自动写入 bundles
+# 复核 bundles 出现了该包名 → **重启服务**（配置在启动期组装，热改不生效）→ 回到 ② 看组装树
+```
+
+> **两条硬纪律**（《避坑手册》`A-119`／`A-120`／`A-123`）：
+> ① **`dependencies` 有 ≠ 已生效**——只有进了 `dsh.profile.bundles` 才会被组装、加载、注册；
+> `node_modules` 有目录、`plugin list` 列得出，**都不构成"已生效"的证据**。
+> ② **本插件确实声明了 `dsh.bundle.patch`**，所以用官方命令 `dsh plugin add` 安装时**应当自动进 bundles**；
+> 若没进，只有三种可能：(a) 不是用官方命令装的（手改 `package.json`／直接 `pnpm add`）；
+> (b) 那次命令没成功（pnpm 非零退出时引擎不做 reconcile）；(c) 装的是不声明 `dsh.bundle` 的旧版本。
+
 ---
 
 ## 目录结构
 
 ```
-SKILL.md          技能正文（V4.6 权威；§0–§16 基干 ＋ §17–§22 历次增补）
+SKILL.md          技能正文（**V4.9.15 权威**；§0–§16 基干 ＋ §17–§25 历次增补）
 index.js          插件壳（注册技能）
 cordis.patch.yml  挂载配置
 extractors/       提取器提示词模板
-scripts/          机器层脚本 4 件（machine_precheck_v2 / machine_layer_readycheck /
-                  defense3_impersonation_scan / blindtest_lexicon_mock_v1；全部本地运行、零 API 成本）
-manual-history/   历史版本手册存档（v2.0 / v3.0 / V4.0 / V4.1）
+scripts/          机器层脚本 **4 件**（machine_precheck_v2 ／ machine_layer_readycheck ／
+                  defense3_impersonation_scan ／ blindtest_lexicon_mock_v1；全部本地运行、零 API 成本）
+                  ＋ **WORK 配套脚本 4 件**（yaml_check_generic.cjs ／ skill_probe_generic.mjs ／
+                  w1b_extract.mjs ／ w1b_validate.mjs）
+scripts/gates/    **门禁与工具 38 件**：§21 三道强制门禁（gate_start ／ gate_stage ／ gate_checklist）
+                  ＋ gate_common ／ gate_bootstrap ／ init_workspace ／ preflight ／ postflight ／
+                  gate_selftest ／ pitfall_audit ＋ check_*（含**判据单源闸** check_bandid_single_source、
+                  **装机三层闸** check_install_state、**可移植性发版闸** check_plugin_portability…）
+                  ＋ 一致性仪器（`_bandid.py` 判据语法单一真源、**`_plugdir.py` 插件目录解析单一真源**、verify_candidates、stage15_merge_task、
+                  verify_layer_quotes、layer_quotes_gate、check_layer_sync…）
+                  ＋ 形态普查器 diag_hline_blockmatch.py
+                  ＋ 随带**通用要点版《防坑要点-TOP20》**与《V3.1全量执行单》
+                  ＋ **_pack-manifest.txt**：随包成员清单（打包时自动生成）——供安装侧做
+                    **缺件／陈旧件／内容不符**双向比对（A-137）
+```
+
+> **自 v4.9.9 起不再随包发行"完整内部手册"与历史手册存档**（2026-09-19 用户拍板**方案乙**）：
+> 完整手册含大量**具体任务与环境实测细节**（任务名、环境地址、逐笔费用），属**作者本地资料**，
+> 不适合放进公开发行件。随包改为**通用要点版《防坑要点-TOP20.md》**——**零书身份／零环境／零金额**，
+> 内容是把代价最高的 20 条教训压缩成"与任何书无关"的自检清单。
+> 发版闸已加**反向判据**：包内若出现内部手册或历史手册 ⇒ **判红**。
+
+**⚠ 升级须知（重要 · 覆盖安装不会删除"新版里没有"的文件）**
+
+`tar -xzf`（以及一切"解压覆盖"式安装）**只增改、不删除**。
+所以**从 4.9.8 及更早版本升级**时，旧版随包的文件会**留在你的插件目录里**——
+包括 4.9.9 起已移出的**完整内部手册**与 `manual-history/`。
+**包内成员清单**（`scripts/gates/_pack-manifest.txt`，打包时自动生成）就是为这件事准备的：
+
+```bash
+# 装完后做一次双向比对（缺件 ／ **陈旧件** ／ 内容不符）
+python scripts/gates/verify_pack_manifest.py --pkg-dir <你的插件目录>
+python scripts/gates/verify_pack_manifest.py --self-test     # 闸自证：4 类坏样本必须被拦
+
+# 若有"陈旧件"：先**移入归档**（留痕，不要直接删），再复核
+mkdir -p <插件目录>/_stale-旧版 && mv <陈旧件…> <插件目录>/_stale-旧版/ && \
+  python scripts/gates/verify_pack_manifest.py --pkg-dir <你的插件目录>
 ```
 
+> **为什么必须双向**：只查"该有的在不在"**永远查不出**"多出来的东西"——
+> 而"多出来的"恰恰是旧版遗留（实测：把 434 KB 内部手册移出包后，装过旧版的机器上它照样在）。
+> 症状是"**我明明删了**"这种最容易被相信的假象（避坑手册 `A-137`）。
+
+> **关于正文里的 `A-xx`／`P-xx` 引用**：它们指向**作者工作区的内部避坑手册**（`蒸馏工程避坑手册.md`），
+> **该手册不随包发行**（4.9.9 起移出，只留作者本地）；**相关结论在 README 与 SKILL.md 正文均已写明**，
+> 外部读者**只需看结论、可忽略编号**。因它是"同一事实两个来源"的典型现场，本批已把
+> 「提及该手册时必须同时注明不随包」写成闸（`check_public_numbers.py` 第 ⑧ 项）。
+
+> **计数口径**：`scripts/gates/` 的文件数＝**发版闸解包级校验**读到的件数（`python scripts/gates/verify_plugin_pack.py`）；
+> 本段数字若与包内不符，以该命令输出为准（`A-135`：对外数字必须可复算）。
+
 ---
 
 ## 版本
 
 | 版本 | 日期 | 关键内容 |
 |---|---|---|
-| V4.1 | 2026-09-12 | 红线词分级 + LLM 终裁 / desc 让位分离 / 分段落盘 + 超时判据 / 成本基准 ¥20.5 |
-| v4.2.0 | 2026-09-13 | §17 工程纪律与装机/上架 9 条；补 manual-V4.1；同步 v4.3 机器口径脚本 |
+| v4.1 | 2026-09-12 | 红线词分级 + LLM 终裁 / desc 让位分离 / 分段落盘 + 超时判据 / 成本基准 ¥20.5 |
+| v4.2.0 | 2026-09-13 | §17 工程纪律与装机/上架 9 条；补 manual-V4.1；同步机器层脚本口径（提交信息里写作"v4.3"，**指脚本口径，非插件版本号**） |
 | v4.2.1 | 2026-09-13 | §18 防坑体系与门禁（33 条避坑手册 + preflight／postflight／gate_selftest + 写入型自检禁令） |
 | v4.2.2 | 2026-09-13 | 收口轮：避坑手册 37 条 ＋ §九 发行类 ＋ §十 交付与台账纪律；`postflight` 增 ②-b 余量告警与 ④-b 打包新鲜度 |
 | v4.4.0 | 2026-09-13 | §19 判官工作流 v2 与副本治理（desc 路由工程铁律六条；四层副本模型） |
@@ -113,11 +254,64 @@ manual-history/   历史版本手册存档（v2.0 / v3.0 / V4.0 / V4.1）
 | v4.6.0–4.6.2 | 2026-09-13 | §21 **强制门禁**：`gate_start` 开工自证闸 ＋ `gate_stage` 阶段依赖链 ＋ `gate_checklist` 执行单逐项闸；`preflight ⑤` 自动纳入活跃蒸馏任务 |
 | v4.6.3–4.6.4 | 2026-09-14 | §22 判官要求固化：「引文型附属文件」零问题检查表（R1–R8 断言） |
 | v4.6.5 | 2026-09-15 | README 与发行件同步到当前版本；补齐 v4.4.0–v4.6.4 的版本表与安装路径；**发行保真两处修复**（打包器剔除 `__pycache__` 编译产物；新增 `.gitattributes` 锁定行尾字节） |
-| **v4.6.6** | **2026-09-15** | **本版**：**上架 npm registry**（`dsh plugin add dsh-distillation-director` 一行直装）；README 安装路径更新为**四条**并标注各自适用场景；新增"GitHub Release 固定链接"作为**不依赖 npm 的备用通道** |
+| v4.6.6 | 2026-09-15 | **上架 npm registry**（`dsh plugin add dsh-distillation-director` 一行直装）；README 安装路径更新为**四条**并标注各自适用场景；新增"GitHub Release 固定链接"作为**不依赖 npm 的备用通道** |
+| v4.6.7–4.9.2 | 2026-09-17 | 逐处回改批／继承项纳管批／落地审计批／可移植性专项批：**工具随包发行**（发版闸 A–E、`layer_quotes_gate`／`check_layer_sync`／`check_instrument_coverage`＋配套脚本）、`init_workspace.py` 一键初始化；手册升到 v3.2（A-01…A-105） |
+| **v4.9.15** | **2026-09-19** | **本版**：**发 npm 前的元数据自检批**——准备上 npm 时先自检 `package.json`，抓到 **`description` 里还写着「V4.9.12：…」而 `version` 已是 4.9.14**：**同一份文件里两个版本声明位不同代**，而且漂的位置是 **npm 页面最显眼的那一行**（`A-139` 家族）。修法两条：① **description 改为能力描述、不再内嵌版本号**（从根上不再漂）；② `check_public_numbers.py` 增第 **⑨** 项——**desc 若内嵌 `V<数字>` 必须等于 `version`**（坏样本 5 → **6 类**）。同批为 npm 通道做准备：确认包内 53 件、`package/` 前缀齐、无 `link:` 依赖、`files` 声明＝实际打包集 |
+| **v4.9.14** | **2026-09-19** | **上一版**：**真机收口批**——NAS 装机复验把"检查方式照不到"再推一步：① **写入型步骤「假成功」**：宿主侧工具目录归 uid 1026／0700、容器内是 uid 10001 ⇒ 逐件 `cp` **全部失败**，而调用侧抑制了 stderr，脚本照样打印"同步 19 件／新增 12 件"（**备份目录实际是空的**）；改用 `docker exec -u 0` 重做并**回读验证**后：同步 19 件、**0 不一致**、单源闸 **79 文件 0 命中**；② 解包级校验在"本机一个发行件都没有"时改为**判不适用 ＋ rc=2**（旧版对"没有工作台布局的机器"报 🔴，诚实但误导）；新增避坑 **`A-146`**（169 条）＋ 技能 **§26.9 / R46**（写入型必须回读验证、不得抑制 stderr） |
+| **v4.9.13** | **2026-09-19** | **上一版**：**真机反证批**——一切来自 **NAS 装机复验**，三个都是"检查方式照不到"而非"算错"：① **发版闸 E 判据一直是「空转」的**（拷贝夹具假设了 npm 包根前缀 ⇒ **一支门禁都没跑**，却打印"✔ 0 裸栈"，而它正是我引证"异机可跑"的证据）；② **随包闸把"本机一定有该目录"当前提** ⇒ 真机 `FileNotFoundError` **裸栈**、本机永远绿；③ **宿主侧工具副本陈旧** ⇒ 真机判红而**随包件干净**，并暴露单源闸**射程没盖随包副本**、"唯一真源"一行硬写反斜杠且张冠李戴。修法：E 判据改**两轮**（E-1 无宿主环境／**E-2 配置指向全不存在的目录**，各 **33 支实跑**，**0 支即判红**）、随包闸所有基准件读取改为**判"不适用"＋rc=2 不裸栈**、单源闸扫描根扩到**随包副本**且报告改印真实真源路径、错误打印 70→**200** 字符 |
+| **v4.9.12** | **2026-09-19** | **上一版**：**对抗式体检批**——不再只跑"自己的闸"，另写检查器专查**从未查过的 9 个面**（npm 文件集 vs 我们的 tgz／仓库树 vs 包（逐件字节）／清单 **51 项 md5 逐项核验**／扁平版 vs npm 版 tgz 同内容／死引用／**SKILL.md 里的声明数**／随包文本占位符／四类公开面），抓到并修掉 **3 处实质文档错误**：① SKILL.md 声明「34 件」≠ 实物 **37 件**；② §0.0 误称"门禁脚本不在本插件载荷内"（**4.9.3 起一直随包**）；③ §18.3 把**不随包**的内部手册当作读者手里的文档（且条数早已过时）；并把「SKILL.md 声明数」与「内部手册声明位／路径位必须注明不随包」加进 `check_public_numbers.py`（7 → **9 项**）；**独立运行再抓两条自伤**——① `verify_pack_manifest.py` 从 `tools\` 跑时把 `tools\` 自己当插件目录，报「找不到清单 ⇒ 重装 4.9.10+」**（路径解析错却说成"你的包太旧"）**；② `_paths.py` 顶部有一段**自导入死代码**（永远 ImportError 被吞掉、且给出 cwd 版 ROOT 又被真值覆盖）。根治＝**新增 `_plugdir.py`（插件目录解析唯一来源**：只用标准库／永不退出／找不到就返回 None 并列出试过的位置**）**，两个闸共用；挂 **`postflight ⑯`**（35 → **36 项**） |
+| **v4.9.11** | **2026-09-19** | **上一版**：**对外数字与实物同代（全面体检批）**——新增闸 **`check_public_numbers.py`**：README 的「门禁与工具 N 件」／SKILL 权威版本／版本表"本版"行／承诺随带的通用要点版，**逐项与发行件实物比对**（含 **3 类坏样本自证**），挂 **`postflight ⑮`**（33 → **35 项**）；修掉体检抓到的三处**不同代**（件数 34→36、目录结构版本号漏升、版本表**两行都标"本版"**）；并修 **`check_script_sync` 的权威路径**（原指向已不存在的目录 ⇒ 恒报"缺失 4 个"**假红**）、两个未发行一次性件登记进 `ONETIME` 授权表、`init_workspace` 注释去掉书名号（避免被通用件巡检判为书目引用） |
+| **v4.9.10** | **2026-09-19** | **上一版**：**随包清单 ＋ 安装侧双向比对（A-137 根治）**——覆盖解包**只增改、不删除** ⇒「把文件移出包」在**装过旧版的机器上不生效**（真机实测：434 KB 内部手册与历史手册 4 件仍在）⇒ ① 包内新增**自动生成的成员清单** scripts/gates/_pack-manifest.txt；② 新闸 **erify_pack_manifest.py** 做**双向比对**（缺件／**陈旧件**／内容不符，含 **4 类坏样本自证**＋忽略项不误报），挂 **postflight ⑭**；③ 构建侧断言**「清单 ≡ 包内成员（清单自身除外）」**；④ README 增**升级须知**（含清理命令）；⑤ 补掉 extractors 模板里**最后一处真书身份**、并更正 SKILL.md 里「把估算当实测」的成本口径 |
+| **v4.9.9** | **2026-09-19** | **上一版（现由 v4.9.10 取代）**：**发布面瘦身（用户拍板方案乙）**——完整内部手册与历史手册存档**不再随包发行**（只留作者本地），随包改发**通用要点版《防坑要点-TOP20》**（零书身份／环境／金额，20 条可执行自检）；清除随包文件里的**书目身份痕迹**（内部任务名 **155 处 ⇒ 0**、书名 98 处 ⇒ 0 中随包部分）；把四处「册别默认值」改为**配置驱动或强制参数**（`--task` 必填；被检目录/文件名从当册配置读；`postflight ⑧-b` 改**自动发现**；`pitfall_audit` 的配套脚本目录改 `cfg` 驱动）；发版闸新增**反向判据**（包内不得出现内部手册/历史手册 ＋ 通用要点版必须在场）；README 成本口径改为**分段如实**（蒸馏主体 ¥13.45 ＋ 后改/工装 ¥4.07 ＝ 全程 ¥17.52）；避坑手册 **v3.10**（`A-136` 发布面审查四类） |
+| v4.9.8 | 2026-09-19 | **分发通道的可用性假设 ＋ 对外数字必须可复算**——① 真机实测发现**作者本机与 NAS 都访问不了 `github.com`**（TCP 超时）而 `api.github.com` 正常 ⇒ README 原本主推的**固定链接（路径 B）在这类网络下整条失效**；新增**路径 E（API 直连，无需令牌；已实测 HTTP 200／字节与本地一致）**＋ 新增「网络与替代通道」一节；② 「战绩清单」**全部改为可复算口径**（旧数字过时：技能数仍写 `43／22`，实测 **`49／23`**）＋ 把**"估算 ¥20.5"冒充实测**改为**"实测"**口径 ＋ 新增**异机真机实测**与**"门禁抓过我"**两张表；③ 目录结构纠错（门禁件数 **27 → 34**、删掉重复的 `scripts/` 条目）；④ 避坑手册 **v3.9**（`A-134`／`A-135`）＋ SKILL.md **§24.6**（分发通道可用性） |
+| v4.9.7 | 2026-09-19 | **判据语法单一来源 ＋ 源文件决议单一来源**（NAS 异机真机两轮实测固化）——① 建唯一真源 `scripts/gates/_bandid.py`（波段条目 id 语法 `[A-Za-z][A-Za-z0-9]*-\d{3}`）并**回改 17 处内联**（旧代码 4 种残缺写法 ⇒ **同一份合规产出在不同仪器下时红时绿**：`verify_candidates` 报 `🔴 切块为空`、`gate_stage` 却 ✔）；② 新增闸 **`check_bandid_single_source.py`**（内联即判红，含 10 个正负样本自证）挂 **`postflight ⑬`**（29→**31 项**）；③ `verify_candidates` 抽出**唯一决议函数 `resolve_src()`**（探测与校验共用；兜底**必须过内容闸**＝真含页标记，避免把**任务自己的产出文档**当源）＋ 空集/全数未命中报错改为**自证型**（打印期望语法／实测标题行／实际使用的源＋三步处置）＋ 新增 **▲ 一条目多引文** 可见性；④ `gate_selftest` 由六坏扩为 **九组**（新增 `E1` 成对差分／单源闸自证／**源决议陷阱**）；⑤ `diag_hline_blockmatch.py` 重写为**形态普查器**（5 把尺子 × 6 形态 ＋ `--census` 真实册并排）；⑥ 发行侧修掉三处"改了却没进包"（手写清单 → **闭包推导**＋剪枝、补 **SKILL.md 同步步**、`optional-tools.json` 与事实对齐）；手册 **§25**（R33–R37）＋避坑手册 **v3.8**（`A-132`／`A-133`，155→156 条） |
+| v4.9.5–4.9.6 | 2026-09-19 | 换书实测批（**未发布**）：候选校验的**源基准**判据放宽到 `.md`、候选条目标签**容错**（`锚`／`页锚`／`出处`、半角冒号、`逐字原文`）；`gate_selftest` 增执行单例外登记成对样本 |
+| **v4.9.4** | **2026-09-18** | **装机态三层律**（NAS 容器真机实测固化）——把"装了但不生效"的判据做成随包仪器 **`scripts/gates/check_install_state.py`**（落盘①／登记②／在役③ 三层逐层读数 ＋ 逐层修法 ＋ `--self-test` 四类坏样本自证）、挂 **`postflight ⑧-g`**（27→29 项）；**§6 打包流程由一行散文改写为「三步带读数」**；新增 **§17.10 装机态三层律**；README「验证装上了」由一条命令扩为**三层读数**（含最常见的失败＝`bundles` 缺项及修法）；避坑手册 **v3.5**（`A-119`…`A-124` 六条） |
+| v4.9.3 | 2026-09-18 | **发行自足与跨平台**——`scripts/gates/` **27 件首次随包发行**（含 §21 三道闸 `gate_start.py`／`gate_stage.py`／`gate_checklist.py`）＋ **4 个配套脚本**（`yaml_check_generic.cjs`／`skill_probe_generic.mjs`／`w1b_*.mjs`）；发版闸由 A–E 升为 **A/B/C/D/D-配套/E/F**（新增"配套脚本必须随包"与"跨平台静态判据"）；node/js-yaml 解析链跨平台；`init_workspace` 上溯找包根＋两种布局取件；缺目录不再崩栈；手册 **v3.4**（A-106…A-118 共 13 条） |
+
+> **从哪装最省事（v4.9.8 现状）**：正常网络用固定链接那条 `dsh plugin add https://github.com/winsonpong98-cloud/dsh-distillation-director/releases/latest/download/dsh-distillation-director.tgz`（路径 B）；
+> **若那条取不到（本机 2026-09-19 实测就取不到）**，用**路径 E**（`api.github.com` 直连）或**路径 D**（本地 tgz），见下一节。
+> **npm 通道目前仍是 4.6.6（缺 §21 闸），4.9.x 上架 npm 后本段会改回"一行直装"。**
+> 装完**务必按「安装细节 → 验证装上了」读三层读数**（2026-09-18 实测最凶的失败模式就是"装上了但 `bundles` 里没有它"）。
+
+> **版本编号说明（v4.3 未独立发布）**：**`v4.3` 是跳过的编号，未独立发版**。v4.2.0 提交信息里的"v4.3"指**机器层脚本口径**、v4.6.4 提交信息里的"V4.3"指**防坑体系批次**，二者均非插件版本号；「防坑体系 37 条 ＋ 三件门禁」实际随 **v4.2.2** 收口轮交付。故编号自 v4.2.2 直接进入 v4.4.0。
+
+完整手册演进见 `manual-history/` 与技能正文 `SKILL.md` §16–§25。
+
+---
+
+## 网络与替代通道（`github.com` 取不到时）
+
+**先说清楚这不是"我们没发"**：发行件本身经**从公网回读验签**（下载回来比字节 ＋ 对下载到的字节重跑发版闸）。
 
-> **从哪装最省事**：一条命令 `dsh plugin add dsh-distillation-director`（npm）。**如果你的网络访问 npm 不畅**，用固定链接那条（路径 B），效果完全一样。
+**2026-09-19 真机实测**（同一时刻、两台机器、三个主机）：
 
-完整手册演进见 `manual-history/` 与技能正文 `SKILL.md` §16–§22。
+| 主机 | 作者本机（Windows） | NAS（Synology） |
+|---|---|---|
+| `github.com:443` | ❌ TCP 超时（偶发一次 200 ⇒ **抖动**） | ❌ `curl` 超时（HTTP 000） |
+| `api.github.com:443` | ✔ 通 | — |
+| `objects.githubusercontent.com:443` | ✔ 通 | — |
+
+⇒ **路径 B／B′（都在 `github.com` 上）在这类网络下整条失效**，而**路径 A（npm）又落后版本、路径 C（git）同样要 `github.com`**。
+故本插件提供**路径 E**：走 `api.github.com` 的资产直连（**公开仓库无需令牌**，实测可用）。
+
+```bash
+# 1) 取资产 id（latest 即最新版）
+curl -s https://api.github.com/repos/winsonpong98-cloud/dsh-distillation-director/releases/latest \
+  | grep -B2 -A8 'dsh-distillation-director' | grep '"id"'
+
+# 2) 直连下载（**必须带 Accept: application/octet-stream**，否则返回的是 JSON 元数据而不是文件）
+curl -L -H 'Accept: application/octet-stream' -o dsh-distillation-director.tgz \
+  https://api.github.com/repos/winsonpong98-cloud/dsh-distillation-director/releases/assets/<ASSET_ID>
+
+# 3) 本地装
+dsh plugin add ./dsh-distillation-director.tgz
+```
+
+**实测读数**：HTTP 200 ｜ 字节数与发行件一致 ｜ **md5 与本地一致** ✔。
+
+> **给内网/离线用户的建议**：把 tgz 一次下好留档（路径 D），后续装机都用它——**比任何在线通道都稳**。
+> 这条纪律来自 `A-134`：**"发得出去" ≠ "下得回来"**——**单一分发通道的可用性是一种假设，必须验证并准备替代**。
 
 ---
 
@@ -133,6 +327,7 @@ manual-history/   历史版本手册存档（v2.0 / v3.0 / V4.0 / V4.1）
 | 解包级校验 | 两个 tgz 与权威源逐字节一致 ＋ **包内无多余产物**（双向判据） |
 | 端到端可加载 | 对打包产物真 `import` ＋ 模拟注册，确认真能装上（不是"文件都在"） |
 | 三层字节一致 | 工作区 / git 索引 / tgz 三层逐字节相同（防 `core.autocrlf` 静默改写） |
+| **远端回读验签** 🆕 | **把已发布的资产从公网下载回来**：① 比字节（md5）；② **对下载到的字节重跑发版闸**（A/B/C/D/D-配套/D-import/E/C 全过）。防"本地是好的、远端是坏的"（`A-131` 第三形态） |
 
 **v4.6.5 修掉的两个发行缺陷**（都出自真实事故，已进避坑手册 `§9.5`）：
 
@@ -147,9 +342,54 @@ manual-history/   历史版本手册存档（v2.0 / v3.0 / V4.0 / V4.1）
 
 **本插件是「蒸馏方法论文档」，只含流程、规则、判态标准、机器层脚本——不含任何书籍原文或逐字引文。**
 
-- 手册中出现的书名（如《周期、估值与人性》《原则》）仅作实测对象的**书名引用**，不构成内容复制。
+- 手册中出现的书名（如「某投资类书」「某书」）仅作实测对象的**书名引用**，不构成内容复制。
 - 你用本插件蒸馏任何书时，**蒸馏产物（技能 SKILL.md）里的原文引文版权归原书作者**，请自行遵守版权法规；本插件与作者不对你的蒸馏产物承担版权责任。
 
 ## 许可证
 
 AGPL-3.0-or-later（因 index.js 结构参考了同许可证的 dsh-cangjie-skill）。完整文本见 `LICENSE` 或 <https://www.gnu.org/licenses/agpl-3.0.html>。
+
+## 运行环境要求（2026-09-17 补 · 来自外部机器实测）
+
+- **Node**：DSH 自带（插件本体只需 DSH 引擎的 Node）。随包的 4 个机器层脚本 +
+  4 个配套脚本（`yaml_check_generic.cjs`／`skill_probe_generic.mjs`／`w1b_*.mjs`）在包内 `scripts/` 下。
+- **Python 3.10+**：门禁套件（`scripts/gates/*.py`）需要 Python。**若你的环境（如裸 Debian 容器）没有 Python**，
+  装一个免 root 的便携版即可（实测可行）：解压到 `/data/tools/python` 并在 PATH 目录建 `python3`／`python` 软链 ⇒
+  `python tools/gate_start.py --task <slug>` 可原样执行；不想要时删目录 + 两条软链，零副作用。
+- **安装后第一步**：在**你的工作区**跑
+  `python "<插件目录>/scripts/gates/init_workspace.py" "<你的工作区根>"`
+  —— 它会把整套门禁（含 `gate_start.py`／`gate_stage.py`／`gate_checklist.py`）与配套脚本装到 `<工作区>\tools\`，
+  之后手册里的 `python tools\gate_start.py …` 等命令才能按原样执行。
+- **读全文再抄录**：`skill` 工具返回的正文可能被裁剪（实测省略 13,491 字节）。
+  §21 的哈希核对与"逐字抄录 ≥12 条"**必须先读全文**（插件里的 `SKILL.md`），否则中部条款缺失、逐字对不上。
+
+---
+
+## v4.9.3 修掉的发行缺陷（发行自足，全部来自异机实测）
+
+本节与"v4.6.5 修掉的两个发行缺陷"同性质：**都不是功能问题，而是"在我这台机器上永远测不出来"的发行问题**。
+
+1. **§21 三道闸与整套门禁不随包发行**：`scripts/gates/` 此前 4.1.0–4.9.2 **一律缺失** ⇒ 手册 §21 写的
+   `python tools\gate_start.py --task <slug>` 在别人的机器上跑不起来（"未过不许调子代理"只能靠自觉）。
+   本版把 **27 件**随包发行，并在包内提供 `init_workspace.py` 一键装到你的工作区。
+   （件数随版本增长：**4.9.8 起为 34 件**，以 `verify_plugin_pack.py` 的输出为准。）
+2. **4 个配套脚本不随包**：`yaml_check_generic.cjs`（YAML 实解析）／`skill_probe_generic.mjs`（引擎加载器实测）／
+   `w1b_*.mjs` 原先只住在作者工作目录 ⇒ 新机器的 YAML 闸与引擎探针直接失效。本版入包（`scripts/`）。
+3. **发版闸判据只覆盖"最常见的一类依赖"**：原 D 判据只验"引用的 `.py` 在不在包里"，
+   对配套脚本／运行时目录／外部库（node／js-yaml）**全无覆盖** ⇒ 判据升级为
+   **A/B/C/D/D-配套/E/F**：新增**D-配套**（包内门禁引用的 WORK 文件必须在包内）与
+   **F 跨平台静态判据**（Windows 专有 API／硬写 `node.exe` 且无平台兜底）。
+4. **同步清单手写必然漏**：包内与权威源实测**漂移 7 个文件**（改了 `tools\` 却从没进包）。
+   > ⚠️ **诚实更正（2026-09-19 补）**：本版当时写的"修法＝同步清单**改为按包内实际发行文件自动生成**"
+   > **并没有真的做到——清单一直是手写的**。直到 **v4.9.7** 才真正改成**从种子求闭包**
+   > （`ast` import ＋ 与发版闸 D 判据**逐字同源**的引号点名正则 ＋ 读 `optional-tools.json` 排除可选依赖）
+   > ＋ **剪枝**清单外残留。**这条更正本身就是 `A-135` 的案例**：页面上的"已修"必须与代码事实同代，
+   > 否则读者拿到的是一句安慰话。
+5. **初始化在发行包布局下算错包根**：原实现按固定跳数求插件根 ⇒ 发行包里算错两级、**一个文件都装不上**。
+   修法＝**上溯找包根**＋两种布局取件源；同时补齐 `.dsh\gate-kit` 配置目录。
+6. **平台写死与缺目录崩栈**：node 只认 `node.exe`（Linux／NAS 上引擎二进制叫 `node`）；
+   `os.listdir`／`cwd=` 在目录不存在时直接抛异常（新用户机器上必现）。两者均已修（解析链＋`_safe_listdir`）。
+
+**本版复验**：`repack` rc=0 ｜ 发版闸 rc=0（六判据全过）｜ `postflight` rc=0（连跑两次）｜
+`pitfall_audit --check` rc=0 ｜ `gate_selftest` rc=0 ｜ **异机安装实测 rc=0**（46 文件解到 `<DSH_HOME>/packages/`，
+引擎 `node` 加载 `index.js` → 注册技能 `distillation-director`）｜ **异机门禁模拟 11 项致命 0**。