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.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）：
- 脏包：打包器曾把
scripts/__pycache__/*.pyc 打进 tgz（4.6.2／4.6.3／4.6.4 内测件受影响）。修法＝打包器目录级＋后缀级双排除，并给校验器补「包内无多余产物」的黑名单 ＋ 逐件反查双向判据。
- 字节保真：
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 修掉的两个发行缺陷"同性质：都不是功能问题，而是"在我这台机器上永远测不出来"的发行问题。
- §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 的输出为准。）
- 4 个配套脚本不随包：
yaml_check_generic.cjs（YAML 实解析）／skill_probe_generic.mjs（引擎加载器实测）／
w1b_*.mjs 原先只住在作者工作目录 ⇒ 新机器的 YAML 闸与引擎探针直接失效。本版入包（scripts/）。
- 发版闸判据只覆盖"最常见的一类依赖"：原 D 判据只验"引用的
.py 在不在包里"，
对配套脚本／运行时目录／外部库（node／js-yaml）全无覆盖 ⇒ 判据升级为
A/B/C/D/D-配套/E/F：新增D-配套（包内门禁引用的 WORK 文件必须在包内）与
F 跨平台静态判据（Windows 专有 API／硬写 node.exe 且无平台兜底）。
- 同步清单手写必然漏：包内与权威源实测漂移 7 个文件（改了
tools\ 却从没进包）。
⚠️ 诚实更正（2026-09-19 补）：本版当时写的"修法＝同步清单改为按包内实际发行文件自动生成"
并没有真的做到——清单一直是手写的。直到 v4.9.7 才真正改成从种子求闭包
（ast import ＋ 与发版闸 D 判据逐字同源的引号点名正则 ＋ 读 optional-tools.json 排除可选依赖）
＋ 剪枝清单外残留。这条更正本身就是 A-135 的案例：页面上的"已修"必须与代码事实同代，
否则读者拿到的是一句安慰话。
- 初始化在发行包布局下算错包根：原实现按固定跳数求插件根 ⇒ 发行包里算错两级、一个文件都装不上。
修法＝上溯找包根＋两种布局取件源；同时补齐
.dsh\gate-kit 配置目录。
- 平台写死与缺目录崩栈：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。
