workbuddy_skills/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