session-mechanism/references/manifest.md

# manifest · 包内文件清单

> 生成方式：逐文件 `compile()` / `json.loads` ＋ md5 ｜ **最近一次全量重算：2026-10-04 17:4x （2026-10-04 单包权威：02 档改为「本档即权威」（⛔ 不再指向外部技能当权威），保留来路说明；SKILL.md 撤回『必需外部依赖』声明改为自包含）**
> ⛔ 本表**不含** `install.log`（运行日志）与 `references/manifest.md`（自引用，写完即失真）。
> ⚠️ **provenance 列里的 `skills/multi-session-collab/…`、`skills/workbuddy-session-forensics/…` 已是历史路径**
>    —— 那两个目录 2026-10-01 已移到 `<工作区>/归档/技能-退役-20261001/`（⛔ 不在技能根了）。

文件总数：**49** ｜ 语法 / 结构检查失败：**0**

## ✅ 已完成 · 2026-10-05 三代术语收敛（本节替代原「待办」）

- **已执行**：包内 + 两个工作区副本三方同步，md5 一致（`collabd.py`/`goalctl.py`/`board.py`/`board_ext.py`/
  `selftest.py`/`collabctl.py`/`guard.py`/`init_workspace.py`/`session-rules-check.py`/`board.html` 全部 OK）。
  `selftest.py` 基线 **PASS 97 / FAIL 0**（报告型 1 条不计入）；改名的 5 条 `@case` 均能按新名字 `-k` 找到。
- **⛔ 三类不动，是判据不是遗漏**（下一次改名前照抄）：
  ① **「」引述内容逐字不动**（含跨行引述块）—— 引用用户口径只写原话；
  ② **历史段整段不动** —— `SKILL.md` 19–27 行代际表、含 `旧称/旧词/一代/二代/第三代` 的行、`<hN> 历史…` 段落
     （要讲清三代分别叫什么，就必须留着旧名）；
  ③ **`.py` 里 `目标检查` 一律不动** —— 它是**检查会话类别名**（`_CHECK_TAGS`/`_CHECK_TOPICS`、
     `[检查]-[结果检查/目标检查]`），并散在字面断言里（`CHECK_KINDS["queue-empty"][1] == "目标检查"`、
     `rows.append(...)`、`【目标检查】` prompt 头）⇒ 改了直接断判据。
- ⚠️ **一处同改对**：`board.py::_ROLE_LABEL["worker"]` 与 `board.html` 的 `role==='…'` 是同一处判据的两侧。
- ⚠️ **本条暴露的存量缺陷（已一并修）**：`selftest.py` 的期望串原写 `才建立一轮任务会话`，而 `SKILL.md`
  引述里逐字是 `才建立一轮执行会话` ⇒ 该子项**改前就是红的**（被基线里的 97/0 掩盖）。
- 工具：`tmp/term-apply-v3-20261005.py`（dry-run/`--apply`，写盘前自动备份）＋ `tmp/term-sync-20261005.py`。


## 2026-10-04 新增文件（⛔ 由 manifest 重算登记）

- `references/01-文档索引.md` — 3604 B ｜md5 `825999a411e2a4f6b740063f81c01b03`
- `scripts/judge_audit.py` — 13562 B ｜md5 `8f14a973fa5709a3b9a60b065dc22d7d`
- `scripts/workspace_mirror.py` — 17263 B ｜md5 `60f104b37df3133785abb13f686eea4f`
- `assets/start-supervise.ps1.tpl` — 5360 B ｜md5 `3805f1a82a1747269212287e9dfde369`
- `assets/design-tokens.css` — 6364 B ｜md5 `0668feb3a4729f1022e579ac0c5d2569`

## 最近改动（⛔ 只记「什么时候改了什么」，不写流水账）

- **2026-10-02 07:0x · 开工第 0 步改名：会话「规划」→ 会话「规则机制」（本轮）**：
  ① **用户纠正原话**：「**就应该是检查清楚 所有会话规则机制 是否配置完整且生效， 不是规划 是 规则**」
  ⇒ 首版体检脚本**只查排期那一面**，当天实测出的三类失效（钩子注入指向已退役技能名 / 常驻快照写进幽灵目录 /
  每轮注入的记忆指针悬空）**一条都没覆盖** ⇒ 名字还叫「规划」＝第二次「在册 ≠ 生效」。
  ② **收敛成一个入口**：新增 `scripts/session-rules-check.py`（查 **三类十二项**：A 钩子在册·路径存在·
  注入技能名存在·闸门日志新鲜 ｜ B 每轮注入记忆的技能指针·常驻快照不比权威旧 ｜ C 周期钟·模型可用性·
  `cwds` 同形·投递心跳·活会话·`once` 从未运行的死排期）；旧 `scripts/session-plan-check.py` **退役**
  到 `<WS>/归档/技能包-旧件-20261002/`，**能力不回退**。
  ③ **状态标记改名**：`session-plan.json` → **`session-rules.json`**（旧的属过期件，⛔ 别拿来对照）。
  ④ **判据收紧**：`cwds` 近失配原写成「同父目录 ＋ 字面不同」⇒ 在 `AIProject/` 这种**多业务线平级目录**下
  把**别的线**报成失配（实跑当场 2 条假红）⇒ 改为「同父目录 ＋ **名字去 `-`/`_` 后仍相同**」／「同名不同父目录」。
  ⑤ **判据自验**：⑨⑫ 抽成**纯函数** ＋ 合成样本夹具（`<WS>/tmp/rules-check-mutate.py`）—— 原版 10/0 绿、
  **四个变异体**逐一按预期报红。⚠️ 夹具**自己先红两次**（期望值写死：漏算样本 ＋ 有序列表比中文名）。
- **2026-10-01 18:5x · 外置根贯通 ＋ 两处真缺陷（本轮）**：
  ① `roots.env` 引导块从 9 份扩到 **16 份**（补齐 7 个非钩子脚本：`board` / `board_ext` / `collabd` /
  `deliver-gateway-token` / `goalctl` / `selftest` / `stop-collab`）；
  ② **盘符字面量清零**：配置目录兜底改 `~/.workbuddy`，工作区兜底改 `DSH_WS_ROOT`/cwd，
  覆盖网日志 glob 改 `DSH_OVERLAY_LOG_GLOB`（原为死路径 —— 本机 `E:/dsh-worker-dev` 不存在）；
  ③ 7 份加**输出编码兜底**；④ `roots.env` 增写 `CODEBUDDY_CONFIG_DIR`；
  ⑤ 🔴 **修「钩子把技能包当工作区」**：`wb-result-hook.py` 的 `_WS_ROOT` 原按 `3×dirname(__file__)` 推，
  包内这份推出来＝技能包自己 ⇒ 包里长出 `tmp/supervise-inbox/`；改为复用 `resolve_ws()`；
  ⑥ 🔴 **修「重定向 ＋ GBK ⇒ print 抛异常 ⇒ 顶层记 fatal、整轮失败」**（本机实测 4 次；
  这正是**常驻**跑不起来的拦路石 —— 常驻必须重定向 stdout）；
  ⑦ `install.py` 工作区模板路径纠错（原指 `scripts/collab/`，实际在 `scripts/`）；
  ⑧ `collabd.py` docstring ＋ 两处活注释改**常驻定案**（上一轮漏传导）；
  ⑨ `lock/preflight-lock.sh` ＋ `hooks/lock-guard-hook.py` 的盘符字面量清零；
  ⑩ 新增 `install.py --manifest`（见下条）；
  ⑪ 🔴 **`scripts/selftest.py` 去掉最后一处项目绝对路径**：`t_tick_wired` 原先写死
  `<某工作区>/.workbuddy/tools/wb-result-hook.py` ⇒ 两处都不对：既违反「技能里只用相对路径」，
  又因宿主接线已改指**包内**那份而**恒走"文件不在，跳过"** ⇒ 看着绿、其实什么都没验（静默假绿）。
  现改按包内相对路径取 `hooks/wb-result-hook.py`，该用例从"跳过"变**真检**（4 项实跑通过）。
- **2026-10-01 19:0x · `install.py --manifest`**：把「重算本表」固化成子命令
  （包一改表就过期 ⇒ 以前每轮临时手搓脚本、跑完即删，已因此误判两次）。
  只重写**表 ＋ 计数行 ＋ 重算时间**，⛔ 不碰上方散文；**行尾随原文件**（本表是 CRLF，写成 LF 会造成一次无声全文件 diff）。
- **🔴 两份同源脚本「有意不一致」（⛔ 别当 bug 去修平）**：`preflight-lock.sh` 与 `lock-guard-hook.py` 在
  **技能包**与**文档库 `07-scripts/`** 各有一份。包内那份住在技能包里、**推不出文档库根** ⇒ 只能走
  `roots.env` ＋（`lock-guard-hook.py` 的）末位字面量兜底；库内那份住在 `<文档库>/07-scripts/` ⇒
  **按 `__file__` 往上两级即文档库根**。⇒ 包内有引导块、库内没有，是**位置决定的**，不是漏改。
- **2026-10-01 18:2x · 瘦身（本轮）**：`references/collab-detail.md` 删去**原件 YAML 变更流水**（约 9.4 KB）＋ 加**读法索引**＋ 压缩 §12；
  `references/{manifest,taskgraph,pitfalls}.md` 去掉过期条目与旧抬头；包内 `__pycache__/`、`hooks/bak-*/`、`tmp/` 已清。
  **⛔ 本轮无机制代码改动。**
- **2026-10-01 16:5x**：`scripts/hooks/session-log-guard.py` 新增「**硬档就地回收**」—— 到 8 MiB 先试**一次**把本会话
  `logs/<日期>/sdk/conversations/<sid>.log` 改名（后缀 `.recycled-<时间戳>`，⛔ 不删、⛔ 不以 `.log` 结尾故与清扫器不重叠）
  ⇒ 宿主立刻重建并继续写 ⇒ **会话不必再因撞 10 MiB 而停手**；失败则**逐字退回**原「停手＋建接续」口径。
  开关 `DSH_SLG_NO_RECYCLE=1`（只关回收、保留叫停）。⚠️ 文档库原件 `07-scripts/session-log-guard.py` **已同语义同步**。
- **2026-10-01 16:0x**：原 `multi-session-collab` 的 `SKILL.md` 全文并入 `references/collab-detail.md`（治 8 处悬空引用：
  `§0.05` `§0.5.2` `§0.5.4` `§0.5.5` `§1.3` `§1.4a` `§3` `§6`）；清掉 9 处旧技能路径/名的活文本；
  两个原技能目录移入 `<工作区>/归档/技能-退役-20261001/`。

## 逐文件清单

| 包内路径 | 字节 | md5 | 语法检查 |
|---|---|---|---|
| `SKILL.md` | 52451 | `c304346227e3d2b217e442a471b6c10d` | ok |
| `assets/board.html` | 136715 | `bf0e560a0420c833e94f329958e64a3c` | ok |
| `assets/design-tokens.css` | 6364 | `0668feb3a4729f1022e579ac0c5d2569` | ok |
| `install.py` | 26132 | `9522ec34773385a638efdeb3df0090d2` | ok |
| `references/00-动手前必过.md` | 3923 | `33bc86e442ccd4fcbb930c79c4ad0641` | ok |
| `references/02-功能优先协作协议.md` | 30502 | `eeeab3dcad47ad01380c8b05fee6fb3f` | ok |
| `references/03-回复排版-核心块.md` | 2187 | `201e7f112ee432b89e38f82f49301966` | ok |
| `references/99-速查清单.md` | 9832 | `17cc8717649164fa3b9e26da3be9405b` | ok |
| `references/architecture.md` | 119291 | `c78f5cba060efc79db5d160f7df0cca6` | ok |
| `references/collab-detail.md` | 98760 | `6bd9cc7e28596789d55dcd3da22548fe` | ok |
| `references/collab.md` | 16560 | `e7024a823d14c5aa808c7be3a7b00eda` | ok |
| `references/deploy.md` | 16754 | `66342ae0e32ecb499b4c72e4ccfabb9b` | ok |
| `references/forensics.md` | 6067 | `1fb6deca9bb05bebe950d4f4e3adf043` | ok |
| `references/pitfalls.md` | 132523 | `9bd6509df320833a41313848009aeb9a` | ok |
| `references/rules.md` | 6931 | `d654e9dac68a6f44b93898ba98e49221` | ok |
| `references/supervise-persistence.md` | 19245 | `1d4bbb08f02a661124886578cb700af5` | ok |
| `references/taskgraph.md` | 3521 | `be6c6540be86475bb3430688c2987afc` | ok |
| `roots.env` | 624 | `ec38f15f9a4101d69c815aa2cdd7b477` | ok |
| `scripts/board.py` | 123843 | `339d38fd579c602c20ce59f4aa106408` | ok |
| `scripts/board_ext.py` | 45655 | `f138d944145b276e65f6aa86bd8baa07` | ok |
| `scripts/collabd.config.example.json` | 1158 | `6655c15c411a84e3ca12fd136dbe2c60` | ok |
| `scripts/collabd.py` | 355568 | `58ffc3e52a52445e5b0e782fc99d9323` | ok |
| `scripts/deliver-gateway-token.py` | 5685 | `cbba9648d404ecd2683061e19dbdb24a` | ok |
| `scripts/deploy_code.py` | 4391 | `c22969124dd937ddaa66db09738df4a4` | ok |
| `scripts/forensics/proc-parent.py` | 2347 | `8cdfff2dbb88303298752c3777da7b20` | ok |
| `scripts/goalctl.py` | 39314 | `b3c4428b3aa7e4e3093e96105d1bc4dd` | ok |
| `scripts/guard.py` | 13653 | `378e2a388aa14bc55f83e17b5ea61053` | ok |
| `scripts/hooks/_env.py` | 11082 | `d3a557f22286bffb62ff29ee85c71799` | ok |
| `scripts/hooks/bash-output-guard.py` | 17741 | `3f2fdfa17f66f7fcac42e06853433a26` | ok |
| `scripts/hooks/lock-guard-hook.py` | 20363 | `641457de0297ee7a812ccde57f67dc2b` | ok |
| `scripts/hooks/reply-style-guard.py` | 10779 | `a05ca0d6ebef2be55a3d6f96a4c712da` | ok |
| `scripts/hooks/session-log-guard.py` | 24636 | `0bd6865e1a3ab97315c64631f37963a3` | ok |
| `scripts/hooks/skill-load-guard.py` | 19380 | `682019c18af80991b14c3f3505ecab26` | ok |
| `scripts/hooks/stop-dialog-guard.py` | 40247 | `4e5f9889717d4ed37a6384c643b4d05e` | ok |
| `scripts/hooks/wb-result-hook.py` | 65810 | `94bc3c781b43be6c2a4da645fe008639` | ok |
| `scripts/init_workspace.py` | 8840 | `0581b3864d35461f2fd8f76ea4c66d4d` | ok |
| `scripts/lock/handoff-guard.sh` | 34616 | `f38b2ec92fdc1dab9abdaca0e0bb001a` | ok |
| `scripts/lock/handoff-status.py` | 3923 | `3edb20f9c4021ebe2323478860bf8f6f` | ok |
| `scripts/lock/op-lock.sh` | 4690 | `1a31eda3642e23693a65e1519860c744` | ok |
| `scripts/lock/preflight-lock.sh` | 8673 | `e985ec1cb853fae4c351cd03b171355d` | ok |
| `scripts/selftest.py` | 281959 | `f68dcb48173f2321527d54bc30703bc5` | ok |
| `scripts/session-rules-check.py` | 28650 | `484b4e7370ff7f8377e725471bdfd88a` | ok |
| `scripts/stop-collab.py` | 10462 | `d8043bedd23b52b6642aaf7ec8b8c980` | ok |
| `scripts/wake-session.py` | 11011 | `32c6038b541249730f322f933ee287c1` | ok |