distillation-director · 蒸馏主管（V4.9.17 · 发行自足 ＋ 三闸判态 ＋ §21 强制门禁 ＋ 装机态三层律 ＋ 判据单一来源 ＋ 防坑体系）

把一本书蒸馏成一组可执行的 Agent 技能——判态制元技能（权威执行标准）。

不是通用蒸馏框架，而是专注书籍蒸馏的专科方案：三闸判态制（防线3 忠实度 / 盲测路由 / 达尔文体检），只判态不打分，门禁 = 零🔴；外加一套可运行的工程防坑体系（避坑手册 ＋ 四件门禁 ＋ 发行纪律）。

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 待发版后本提示会撤掉。

# A. npm 一行直装（⚠️ 目前仍是 4.6.6，缺 §21 闸；4.9.x 未上架 npm 前请勿使用）
dsh plugin add dsh-distillation-director

# B. 固定链接直装（**推荐**；不需要 npm；别名资产永远指向最新版）
dsh plugin add https://github.com/winsonpong98-cloud/dsh-distillation-director/releases/latest/download/dsh-distillation-director.tgz

# 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-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

四条路径的关系：B 走 GitHub Release 的别名资产（…/releases/latest/download/dsh-distillation-director.tgz，链接永不随版本变化，本版已同时上传该别名件）；B′ 是带版本号的固定链接；C 走 git 仓库（.gitattributes 锁定行尾字节，保证"直装字节＝发行字节"）；D 是最稳的离线路径；A 待 npm 发版后恢复为最短路径。

② 开一个新会话，说触发词（任一）

• 「拆书《XXX》」
• 「蒸馏这本书」
• 「把 XX 书做成 skill」
• 「按手册蒸这本书」

③ 蒸馏任务的第一条命令必须是开工自证闸（§21 强制门禁，未过不得调用任何子代理／不得 OCR／不得写产物）

python tools\gate_start.py --task <你的任务 slug>

战绩清单（实测背书）

本表每个数字都是"本机跑一条命令就能复算"的（复算方式见下表末行）。 不列具体书名：插件是「蒸馏方法论文档」，只含流程/规则/判态标准/机器层脚本；具体书目属使用者自己的台账 （《避坑手册》A-74：通用件里不得有任何一本书的数据）。 也不写"估算"冒充"实测"：凡标注"实测"的，都能在场产物里逐项对出来（A-135）。

| 维度 | 数据（2026-09-19 实测） | |---|---| | 本机蒸馏册数 | 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 同步步；发版闸对下载到的字节复验 |

• "册数"怎么数：凡有 skills/<slug>/SKILL.md 产出的书树或任务目录记 1 册（不看书名、不看字数）。
• "技能"怎么数：目录内含 SKILL.md 才算；审计用的副本目录（如 <审计副本目录>）与封存件（archived/）不计。
• 成本口径：官方主口径＝账户余额差（外部账本给出，与被测对象无关）。本机另有会话级台账与按天台账 两个参照口径，三者最大差 约 7 倍（计价模型不同），如实并列、不择一、不平均； 对外只引用主口径，分歧细节见工作区 口径登记单（K-02／K-03）。
• 质量口径：判态制，不打分。三闸＝防线3 忠实度／盲测路由／达尔文体检，判据是零🔴； ▲ 类建议项不隐藏——本项目曾有一整轮"停在 4 个 ▲、10 条已知边界"如实收口，而不是刷成 0。
• 上表所有数字均为本机实测，可复核；它们描述的是"方法在这类书上跑过"，不含任何书的内容。

差异化 vs 通用蒸馏框架（如 cangjie）：

| 维度 | 通用框架 | 本插件 | |---|---|---| | 定位 | 书/视频/播客/课程全科 | 专注书籍蒸馏专科 | | 验证 | 通用模板 | 三闸判态 + 逐字回源核验 | | 机器层 | 无 | 有（本地脚本 ¥0） | | 公开战绩/成本 | 无 | 10 册 → 77 个技能零🔴、全程 ¥17.52/册实测（口径已写明，可自行复算） | | 门禁强度 | 约定式 | 命令级拦截（§21：开工自证闸／阶段依赖链／执行单逐项闸，未过跑不动） | | 异机可用性 | 未声明 | 真机实测（Windows ＋ Linux 容器；跨平台静态判据 ＋ 空假根仿真） |

安装细节

底层 = pnpm 安装 npm 包 + cordis.patch.yml 的 insert 条目挂载，DSH 启动时扫描 bundle 自动 apply。

• 路径 A（npm 包名）：dsh plugin add dsh-distillation-director。底层同样走 pnpm，但从 npm registry 取包（本包已上架，latest 即最新版）。
• 路径 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／字节与本地一致）。详见下方「网络与替代通道」。
• 所有路径最终都产生同一条挂载配置：

- insert:
    - id: distillation-director
      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 先用坏样本自证闸有效）：

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 时照这个顺序查，不要跳层）：

① 落盘层（文件在不在、声明齐不齐）
   · 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 用引擎加载器实测）

若 ② 缺失（最常见的失败），按顺序修：

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.9.17 权威**；§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 成本）
                  ＋ **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，打包时自动生成）就是为这件事准备的：

# 装完后做一次双向比对（缺件 ／ **陈旧件** ／ 内容不符）
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.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 路由工程铁律六条；四层副本模型） | | v4.5.0 | 2026-09-13 | §20 底账同代、判官输入工程与闸的升格秩序 | | 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.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.17 | 2026-09-19 | 本版：改用真 npm CLI 发布（readme 回归）——实测：手写 HTTP 发布文档这条路，README 进不去 registry（两次都被清空：根 readme 键在场但长度 0、readmeFilename 被改写成空串），而"整文档 PUT 事后补回"被 registry 拒绝（422） ⇒ 只能由新版本带回。本版改用 真 npm CLI（pnpm dlx npm@11，不装全局）并以 npm publish <tgz> 发布，同时保住"README 进 registry"与"上传字节＝GitHub 资产"两个目标 | | v4.9.16 | 2026-09-19 | 上一版：npm 通道实发批（含三处实测修正）——① registry 的成功响应是 HTTP 202 ＋ {"success":true}，我的首版判据只认 200/201 ⇒ 把成功读成失败（判据错了，结论就错）；② 发布的索引是异步的：版本端点前 4 次 404、第 5 次（≈53 秒）才 200，dist-tags 更慢（≈2 分钟）⇒ 回读必须带重试；③ readme 必须随发布文档带上——首版 PUT 没带 ⇒ registry 根 readme 由 5063 字节变 0（对照同作者的其它插件：5060／5460），npm 页面 README 会空；事后"整文档 PUT 补回来"被 registry 拒绝（422） ⇒ 只能由新版本带回。本版把发布器永久修好（readme＋readmeFilename＋根元数据 ／ 202 判成功 ／ 带重试回读 ／ --verify-only），并以本版恢复 npm 页面 README | | 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 取不到时）

先说清楚这不是"我们没发"：发行件本身经从公网回读验签（下载回来比字节 ＋ 对下载到的字节重跑发版闸）。

2026-09-19 真机实测（同一时刻、两台机器、三个主机）：

| 主机 | 作者本机（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 的资产直连（公开仓库无需令牌，实测可用）。

# 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："发得出去" ≠ "下得回来"——单一分发通道的可用性是一种假设，必须验证并准备替代。

发行纪律（本插件自己的纪律，也是可复用的参考）

本插件的每次发行都要过以下闸，且这些闸自身被坏样本验证过"确实会红"：

| 闸 | 作用 | |---|---| | preflight / postflight | 开工前／改后各一组门禁（YAML、desc 长度、表格、脚本同步、打包产物新鲜度、机器层零新增 fail、可编译……） | | gate_selftest | 用已知坏样本证明门禁有效（"不可能失败的门"不算门） | | pitfall_audit --check | 避坑手册与工具对账 ＋ 只读命令深跑（防手册腐烂） | | 解包级校验 | 两个 tgz 与权威源逐字节一致 ＋ 包内无多余产物（双向判据） | | 端到端可加载 | 对打包产物真 import ＋ 模拟注册，确认真能装上（不是"文件都在"） | | 三层字节一致 | 工作区 / git 索引 / tgz 三层逐字节相同（防 core.autocrlf 静默改写） | | 远端回读验签 🆕 | 把已发布的资产从公网下载回来：① 比字节（md5）；② 对下载到的字节重跑发版闸（A/B/C/D/D-配套/D-import/E/C 全过）。防"本地是好的、远端是坏的"（A-131 第三形态） |

v4.6.5 修掉的两个发行缺陷（都出自真实事故，已进避坑手册 §9.5）：

1. 脏包：打包器曾把 scripts/__pycache__/*.pyc 打进 tgz（4.6.2／4.6.3／4.6.4 内测件受影响）。修法＝打包器目录级＋后缀级双排除，并给校验器补「包内无多余产物」的黑名单 ＋ 逐件反查双向判据。
2. 字节保真：core.autocrlf=true 曾把脚本在 git 索引里 LF 化，导致仓库直装的字节 ≠ 发行 tgz 的字节。修法＝.gitattributes（* -text）＋ git add --renormalize .。

纪律两条：① 所有"该有的在不在"型判据都拦不住"多带了什么"；② 发布完成后必须从公网回读资产、比对 sha256 三方一致，才算发行完成。

版权边界（重要）

本插件是「蒸馏方法论文档」，只含流程、规则、判态标准、机器层脚本——不含任何书籍原文或逐字引文。

• 手册中出现的书名（如「某投资类书」「某书」）仅作实测对象的书名引用，不构成内容复制。
• 你用本插件蒸馏任何书时，蒸馏产物（技能 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。