chore(工作区): 全量入库 + 补齐 .gitignore（以工作区为准）

- 变更规模：新增 514 / 修改 62 / 重命名 155 / 删除 4（归档重组与文档轮次）
- .gitignore 修：`归档/**/db-cwd归一-备份-*/` —— 原规则写绝对层级（归档/db-cwd归一-…），
  目录搬进 归档/配置与备份/ 后**静默失效**，43 MB 的 DB 备份又变成未跟踪
- .gitignore 补：嵌套 git 内部数据（归档/内嵌git-20261008/、归档/skills-git-旧线-20261007/dotgit-原样移出/）
- .gitignore 补：运行态与部署副本（.workbuddy/collab/、.workbuddy/tools/、.workbuddy/.load-pending、.workbuddy/tmp-*）
- .gitignore 补：备份件（*.bak-*）
- 未跟踪文件从 2190 降到 890（其余为 归档/ 归档件与 .workbuddy/memory/ 知识文件，按口径入库）

归档/接续历史/会话机制/接续包_会话机制合并技能包-任务234_20261001.md

@@ -0,0 +1,328 @@
+# 接续包 · 会话机制合并技能包（任务 2/3/4 ＋ 归档）— 2026-10-01
+
+> ## §0 状态（**最新行在最上**）
+> | 时间 | 会话 | 发生了什么 |
+> |---|---|---|
+> | 2026-10-01 20:0x–20:1x | `会话协作看板调整与自检-20261001`（**机制层 ⇒ 全局独占锁**） | ✅ **① 看板按最新架构调整（常驻口径回归）**：`assets/board.html`／`scripts/board.py`／`scripts/board_ext.py` 三处把 09-30 的「钩子按需唤起／跑完即退／不是常驻进程／没有启动-停止这回事」全部改回 **常驻投递** 口径（用户 10-01 定案「**协作与投递一直运行（常驻）**」＋「**定时任务的方案已经废弃了**」）；`prog_by` **不再猜调用方**（戳上分不出常驻还是钩子）⇒ 只报轮次名；帮助文本补 **四类会话 ＋ 接续＝形态**。⚠️ **易漏点**：看板扩展件**不是**从包里读的（`board.py` 按配置读 **`<工作区>/.workbuddy/collab/board_ext.py`**）⇒ 只改包内**不生效**，已 `cp` 同步、两份 md5 一致；`board.html` 相反、由包内提供即生效。<br>✅ **三步验证全绿**：语法 ／ 渲染桩 **FAIL 0/45**（双目标样本 0/48）／ 几何 **FAIL 0/7**。<br>✅ **② 用协作机制跑「检查会话协作是否运行正常」**（`goalctl declare` ⇒ `collabd --once` ⇒ `--tick`）：**结论＝机械部分可用、投递链不通**。可用：两轮 `rc=0`、目标/类别接线正确、digest/queue/TO-MAIN 都能生成、整包自测 **PASS 39/FAIL 0**。不通：**`--tick` 判 `deliver=target-deaf`**（登记主会话 `f8a792ab-…` 不响应；投递台账最后一条 **08:55** ⇒ 停了 ~11 小时）｜**常驻投递未拉起**（`--supervise` 没跑、`guard.stop` 挂着）｜**声明目标 ≠ 产生工作**（队列 0 件、digest「没有可派的任务」）｜**台账不随目标切换**（新目标下仍反馈旧类别的 M5/M6/M7，关键路径写「M5 → M6」）｜**验收判据不绑目标**（`declare` 换名时旧判据原样留着 ⇒ 新目标**一声明就被判"全过"**，实测 20:09）。<br>✅ **顺手修掉 4 个真缺陷**：① `preflight-lock.sh` **未登记技能包** ⇒ 改技能包一律误判【D】未归类、提示"先定域"（正解是"独占"）⇒ **改技能包开不了工**（本轮开工即撞）⇒ 补 `'\.workbuddy/skills/'`（**包内＋库内两处同源**，`bash -n` 均过、行尾各保持）；② `goalctl.py` 工作区按 `__file__` 推层级 ⇒ 不带环境变量**静默指向 `…/.workbuddy/skills`** ⇒ 改 `DSH_COLLAB_WS`→`DSH_WS_ROOT`→cwd，落空才回落并**醒目告警**；③ 同文件加**静默陷阱告警**（换目标名不给 `--kpi` ⇒ 提示旧判据会留下）；④ `state.py` 抢锁路径提示 `scripts/` **不存在**（实际 `07-scripts/`）。<br>🔴 **途中揪出并修掉 1 个真缺陷**：`tmp/render-check.mjs` 的 `BOARD` 还指向**已退役已归档**的 `skills/multi-session-collab/` ⇒ 唯一的看板回归工具一跑就崩。⚠️ **结构性遗留（未动）**：看板回归工具住在 `tmp/`（按规矩要清的草稿区）⇒ 清掉后"改完看板怎么验"这条路就断了。<br>⚠️ **一处自伤已修正**：`board_ext.py` 文案里嵌了 **ASCII 双引号** ⇒ 截断字符串 ⇒ `--manifest` 报**语法失败 1**（⚠️ 而 `--verify` 仍全绿 —— **覆盖面不同**，`--manifest` 才是语法闸）。<br>✅ **验收**：`--manifest` **34 文件 / 0 失败**｜`--verify` **全绿**｜`board_ext.py`／`goalctl.py` 包内与工作区副本 **md5 一致**｜项目配置 `_默认形态` 已同步四类口径。✅ **锁**：机制层 ⇒ 不带 `--domains` 独占，收尾走 `dsh.py close` 反序释放。⚠️ **仍未做**：常驻投递未拉起、主会话仍 `target-deaf`、8788 看板未起。 |
+> | 2026-10-01 19:5x | `会话类别口径修正-20261001`（**机制层 ⇒ 全局独占锁**） | 🔴 **用户订正会话类别口径（本轮唯一依据）**：「**接续会话 不是单独的一类会话，是这几类会话到达阈值时 创建的接续会话**，这里的第4类应该是 **队列上报的跟进会话**（之前考虑**只让主会话管目标和方向**，**队列上报的会话 让专门的 跟进会话处理**）」⇒ **订正了我上一轮（19:1x）的错答**（我答"四类＝主／协作／唤醒／**接续**"，**把"接续"当成第 4 类了**）。<br>🔴 **正确口径**：**四类 ＝ ① 主会话 ② 协作会话 ③ 唤醒会话 ④「队列上报的跟进会话」**；**「接续会话」是「形态」、⛔ 不是第 5 类** —— 任一类撞阈值时**由它自己**建出下一棒，**角色继承被接续的那条**（主会话的接续**仍是主会话候选**）。<br>✅ **一次改齐（⛔ 不许只改一半）**：`architecture.md`（结论表两行／§2.3 第1级角色改四类含 `[跟进]`／§2.3.0b ② 换标题＋定性块／🆕 **新增 §2.3.0c 第④类**／「需求内闭环」作废框／§9 补 ⑦）· `pitfalls.md`（🆕 **P0-11**）· `collab.md §4`（**三"角色"→四"类别"**）· `collab-detail.md`（三处：命名前缀／第四形态／**§12「主体」vs「会话类别」两轴消歧**）· `SKILL.md`（`description` ＋ §2 铁律两条 ＋ `last_change`）· 项目 `MEMORY.md` 对应行（⚠️ 原已 7,956 字符超上限 ⇒ **同步压缩三处、净 -4**，守住「只减不增」）。<br>🔴 **两处判据缺口只登记、⛔ 未擅自改**（触碰"用户定案"域，须先拍板）：① 解析器把「接续」**一律判 worker** ⇒ 主会话的接续被吞掉（⚠️ 当初这么做是为堵**自指死结** ⇒ 正解**不是**"改成未知"，那会**重新打开**死结）；② 第④类 `[跟进]` **全库零命中**（落地清单已写进 §2.3.0c）。<br>🔴 **实测（⛔ 别用假读数）**：**不带 `COLLABD_CONFIG` 直接 import ⇒ `cand=0` ＝"没配置"，⛔ 不是"逻辑坏了"**；带 `COLLABD_CONFIG=<工作区>/.workbuddy/collab/collabd.config.json` 复跑 ⇒ **8 条会话全 `role=worker`、`cand=0`**，`resolve_main → {"sid":"","source":"no-register"}` ⇒ **主会话候选 0**。⚠️ **「自测全绿 ⇒ 判据没问题」是错的**：那条用例只喂**合成样本**。<br>✅ **验收**：`--manifest` **34 文件 / 0 失败**｜`--verify` **全绿**（10 条接线 `rc=0` / `collabd --where` 指包内 / selftest **PASS 39 / FAIL 0**）｜`manifest.md` 行尾 **CRLF / 0 裸 LF**、表内 34 行、磁盘缺失 0。✅ **锁**：已 `--release-exec "会话类别口径修正-20261001"` 释放。 |
+> | 2026-10-01 19:0x | `常驻定案统一-20261001`（**同一会话续棒 · 收尾**） | ✅ **补完最后一处盘符清零**：`scripts/lock/preflight-lock.sh` ＋ `scripts/hooks/lock-guard-hook.py`（技能包与文档库 `07-scripts/` 各一份）。🔴 **结论：两份「有意不一致」，⛔ 别当 bug 修平** —— 判据是**位置**：包内那份住在技能包里、**推不出文档库根** ⇒ 走 `roots.env` ＋（`lock-guard-hook.py` 的）末位字面量兜底；库内那份住在 `<文档库>/07-scripts/` ⇒ **按 `__file__` 上溯两级即文档库根**（已改，库内自此零盘符）。已写进 `manifest.md` 做永久说明；规范化行尾后 `difflib` 比对确认**唯一差异就是引导块**，`py_compile` / `bash -n` 均过。<br>✅ **固化 `install.py --manifest`**（本轮为"重算逐文件表"**又**手搓了一次一次性脚本，上轮也是）—— 只重写**表 ＋ 计数行 ＋ 重算时间**，⛔ 不碰上方散文；**行尾随原文件**（本表是 CRLF，写成 LF 会造成无声的全文件 diff；实测保持 81 CRLF / 0 裸 LF）。<br>🔴 **顺手揪出并修掉一个「静默假绿」**：`scripts/selftest.py:617` 的 `t_tick_wired` 用例**写死了项目绝对路径**（`<某工作区>/.workbuddy/tools/wb-result-hook.py`）—— 既违反用户本轮规则，又因宿主接线已改指**包内**而**恒走"文件不在，跳过"** ⇒ 看着绿、其实什么都没验；已改按包内相对路径取 `hooks/wb-result-hook.py`，该用例从"跳过"变**真检**（4 项实跑通过）。<br>✅ **重算 ＋ 复验**：`--manifest` **34 文件 / 语法失败 0**｜`--verify` **全绿**（10 条接线 `rc=0` / `collabd --where` / selftest **PASS 39 / FAIL 0**）｜包内**无 `tmp/`、无 `__pycache__`**（证实缺陷 ① 的修法真生效）。<br>🔴 **两条如实登记的遗留**：① `<工作区>/.workbuddy/tools/wb-result-hook.py` 是**陈旧死件**（35,975 B vs 包内 37,837 B；宿主三条接线实测**全指包内**）——按"未经确认不删他人文件"留在原地，登记为 **P2 清理候选**；② 一把**陈旧域锁**属 `[协作]N9复测-2248`（09-29 22:48，域 `ai1net-dsh-anywhere`）—— `--release-exec` 回显「另有 1 把锁属他人，按 R9 未动」，**只能由持有者本人释放**。<br>✅ **锁**：因本轮属**机制层**故按规矩**不带 `--domains` 独占**（故无域锁目录）；已 `--release-exec "常驻定案统一-20261001"` 释放，回显「✓ 已释放全局执行锁」，`.exec-lock` 已消失。⚠️ **仍未起常驻投递**（`--supervise` 未拉），`guard` 自 09-29 23:59 停着，8788 看板未运行 —— 阻滞项是"四道闸门不全（无 `NEXT.md`）"，⛔ 非本轮改动引入。 |
+> | 2026-10-01 18:5x | `常驻定案统一-20261001` | ✅ **常驻定案已全量传导**（用户原话：「**协作与投递一直运行（常驻）** 因为可能不是所有 队列都是钩子产生的 ，而且定时任务的方案已经废弃了」）—— 改 `architecture.md`（结论表 ＋ §2⑤ ＋ §3 ＋ §4 抬头 ＋ §4.0/§4.1 作废框 ＋ §5-1 ＋ §8 ＋ §9 新增教训）、`collab.md` §3/§8、`deploy.md`（结论表 ＋ §0 ＋ §2 步骤 ③④⑤ ＋ 验收 6/7 ＋ §5 重写）、`rules.md` §6、`pitfalls.md` P0-3、`collab-detail.md` 头部作废横幅、`SKILL.md` 铁律、项目层 `CODEBUDDY.md §1.5 D/E` 与 `MEMORY.md`。<br>✅ **按用户新规则「技能中要用相对路径」审计整包** —— 查出自述与实现不符：`SKILL.md` 写「**各脚本**先读 `roots.env`」，实际只有 9 份装了引导块 ⇒ **补齐 7 个非钩子脚本（共 16 份）＋ 盘符字面量清零**（配置目录→`~/.workbuddy`；工作区→`DSH_WS_ROOT`/cwd；覆盖网 glob→`DSH_OVERLAY_LOG_GLOB`，⚠️ 原写死的 `E:/dsh-worker-dev` **本机不存在**＝假警报源）；`roots.env` 增写 `CODEBUDDY_CONFIG_DIR`。<br>🔴 **修掉 2 个真缺陷**：① `wb-result-hook.py` 的 `_WS_ROOT` 按 `3×dirname(__file__)` 推 ⇒ 包内这份**推出来就是技能包自己** ⇒ 钩子把包当工作区、包内长出 `tmp/`（同文件里本有正确的 `resolve_ws()` ⇒ 同一事实两套实现）⇒ 改为复用 `resolve_ws()` ＋ 未知工作区即停手；② **重定向 ＋ GBK ⇒ `print("⛔…")` 抛异常 ⇒ 顶层记 `fatal`、整轮失败**（实测连续 4 次）—— 🔴 **这正是常驻的拦路石**（常驻必须重定向 stdout）⇒ 7 份加**输出编码兜底** ＋ `log()` 在配置缺失时拒写。<br>✅ **验收**：`--apply` 真装（带备份）｜`--verify` **全绿**（10 条接线 `rc=0` / `collabd --where` / selftest **PASS 39 / FAIL 0**）｜清单 **34 文件 / 0 失败**｜复现原路径 **0 次 `fatal`**、包内干净｜工作区 4 份副本逐字节对齐。<br>⚠️ **行为变更（如实登记）**：钩子驱动的投递由"静默崩"变**真会跑**；当前无 `NEXT.md` ⇒ 四道闸门不全 ⇒ **实际不会投出消息**。 |
+> | 2026-10-01 18:2x | `技能整合检查与瘦身-20261001` | ✅ **整合独立复核全过**（`install.py --verify` 全绿：10 条钩子空载荷 `rc=0`、`collabd --where` 解析到包内、selftest **PASS 39 / FAIL 0**；两个原技能已在 `<工作区>/归档/技能-退役-20261001/`；活文件零旧技能名残留）＋ ✅ **包瘦身**（`collab-detail.md` 删**原件 YAML 变更流水 9.4 KB** ＋ 加**读法索引**；`manifest.md` 去流水账、修已过期的「未了①」；`taskgraph/pitfalls` 两处旧抬头改指；工作区 `goalctl.py` 旧文案对齐包内；清 `__pycache__`×2 ＋ `hooks/bak-*` ＋ 包内 `tmp/` ⇒ **包 1,098,918 → 1,000,604 B**）。<br>🔴 **途中修掉 1 个真缺陷**：`install.py --verify` 跑 `collabd --where` **未指定 cwd** ⇒ 按调用者 cwd 推导工作区 ⇒ **把技能包自己当工作区**、在包内写出 `tmp/supervise-inbox/`（这正是包内总冒出 `tmp/` 的根因）⇒ 已改为**在临时目录里跑 ②③ 并收尾清理**，复跑确认不再重生。<br>🔴 **上抛（⛔ 未擅自改）**：`architecture.md` 的「当前结论」表 ＋ §5-1 说「投递**必须常驻**／已回退 09-29 版」，而**同文件 §4 抬头**、`collab.md §3`、`deploy.md §7`、项目层 `MEMORY.md` 都说「**钩子事件驱动 ＋ 自动任务拨钟、⛔ 不常驻**」⇒ 同一文件内自相矛盾且与项目状态层相反；按该文件 §9 自己写的教训条款（**⛔ 不得擅自改"用户定案"**）**留待用户拍板**。 |
+> | 2026-10-01 16:5x | `会话机制合并包-收尾2-20261001` | ✅ **§9.3 解阻并做完**：包内 `board.py --serve 8788 --takeover` 接管（旧 PID 21084 停、新 PID 35068；`healthz ok:true`、`/board.json` 真实快照）⇒ **两个原技能目录已用 `os.rename` 移入 `归档/技能-退役-20261001/`**（`agent-operating-rules` 原样保留）⇒ 三项复测全过（钩子空载荷 `rc=0`；`goalctl._collabd()` 与 `wb-result-hook._collabd_ctx()` **运行时**都解析到 `<包>/scripts/collabd.py`；`install.py --verify` 全绿 **PASS 39 / FAIL 0**）。<br>🔴 **② 有界实验（会话日志自愈）＝ 可行**：真实会话里对本会话自己的 `<sid>.log` 做 `os.rename` **一次成功**，宿主**紧邻下一次读数即重建同名文件并继续写入** ⇒ 推翻当天早些时候「句柄常开、间隙不可改名」的结论（那条只证明"正在写的那一瞬"不可改名）⇒ 已把「硬档就地回收」接进 `session-log-guard.py`（包内 ＋ `07-scripts` 原件同语义同步；空载荷 `rc=0`、`--verify` 全绿、验收通道端到端跑出 `RECYCLE` 真记录）。<br>🔴 **③ 缺口（已写清、⛔ 未擅自改）**：哑掉检测**只覆盖"不许投＋不当主会话"，没有"重排"**；且哑会话仍被 `reconcile()` 计入"在跑" ⇒ **反而挡住**「执行者已消失 ⇒ 待重派」这条唯一的重排入口（详见 §9.7）。<br>⚠️ §9.5（`load_cfg` 报真实原因）**本轮未做**（留作独立小活）。 |
+> | 2026-10-01 16:0x | `会话机制合并包-收尾-20261001` | ✅ **§9.1 指针全改**（`CODEBUDDY.md`／工作区 `MEMORY.md`／用户级 `MEMORY.md`／`board_ext.py`／`协同监管棒-SOP.md`／`agent-operating-rules` ×4 处）＋ ✅ **§9.2 打包**（`归档/技能-退役-20261001.tar.gz` · **377,103 B** · 22 条目 · 含两份 `SKILL.md`）＋ ✅ **§9.4 清单重算**（**33 文件 / 0 失败**）＋ 🔴 **§9.3 阻塞，已按规矩回滚**（见下）。<br>🔴 **途中发现并修掉一个结构性缺陷**：原 `multi-session-collab/SKILL.md`（**96,723 B**）**根本没被并入包**，而包内 `architecture/deploy/pitfalls/taskgraph.md` 四份都写着「**主干判据在 `SKILL.md §x`**」⇒ **8 处悬空引用**（`§0.05/§0.5.2/§0.5.4/§0.5.5/§1.3/§1.4a/§3/§6` 实测只存在于原文件）。已**逐字带进** `references/collab-detail.md`（头部写明「以 `architecture.md` 为准」）＋ 8 处全改指 ＋ 清掉另 9 处旧名/旧路径活文本。（判定「看板卡住」≠ 本包坏了） |
+> | 2026-10-01 15:40 | `会话机制合并包-任务4-5-6` | ✅ **§3 第 5 条完成**（补齐 `references/{collab,rules,forensics}.md` 三份，从架构/坑/任务图 ＋ 两个原技能原文提炼，⛔ 非空壳） ＋ ✅ **§3 第 4a 条完成**（两处硬编码回落路径已改指新包：`goalctl.py:_collabd()` 与 `wb-result-hook.py:_collabd_ctx()` —— **新落点优先、旧落点留作过渡兜底**，并已 `cp` 同步包内副本 ＋ 重打 `roots.env` 补丁；实测两者都解析到 `<包>/scripts/collabd.py`、空载荷 `rc=0`）。🔴 **因会话诊断日志到 8.06 MiB（硬档）停手** ⇒ **第 4b/4c/4d、第 6 条留给下一棒**（见 §9）。 |
+> | 2026-10-01 15:1x | `会话机制合并包-任务234b` | ✅ **§3 第 1、2、3 条全部做完**：① `install.py` 两处缺陷已修并**沙箱验收全过**（含原先🔴的第 3、4 项）② **`--verify` 全绿**（钩子 10/10 `rc=0`、`collabd --where` 正常、selftest **PASS 39 / FAIL 0**）③ 🔴 **真机 `--apply` 已执行**：全局钩子已从 `07-scripts` 切到包内（0 条残留旧指向、`decision_bridge` 4 条原样保留），装后自检全绿、闸门日志实测在推进 ⇒ **本包现已是主技能**。<br>⚠️ **途中修掉 1 个真阻塞缺陷 ＋ 1 个生产回归**（见 §8）。⛔ **未做**：§3 第 4 条（归档原技能＋改 2 处回落路径）、第 5 条（3 份 references）、第 6 条收尾。 |
+> | 2026-10-01 14:59 | `会话机制合并包-任务234` | 🔴 **硬档停手**（日志 **8.02 MiB / 10 MiB**）。**包已可用、沙箱验收 5 项过了 4 项**；⛔ **未做**：真机 `--apply`、`--verify`、归档原技能、3 份 references。**install.py 有 2 处已定位未修的缺陷**（见 §3 第 1 条）。 |
+> | 2026-10-01 14:2x | `会话机制合并包-任务0` | ✅ 任务 0（方案落盘）＋ 任务 1（建包骨架 27 文件，全 `cp`）完成。 |
+>
+> 🔴 **本包 §1 = 已实测的现状（⛔ 不要重跑）；§2 = 已验/未验；§3 = 未做完的活（按序）；§4 = ⛔ 不要重做；§6 = 硬阻塞点（先读）。**
+
+---
+
+## §1 已实测的现状（直接引用，⛔ 不要再跑一遍）
+
+### 1.1 用户原话与目标（2026-10-01 两轮）
+> 第一轮：「整合 会话机制相关技能为一个skill包 ， 在将多会话协作机制 也整合到这个技能包，要求换一台电脑的 workbuddy 上运行也能自动完成配置，让所有会话遵循 会话机制，并且可独立使用 多会话协作」
+> 第二轮：「1、检查 和测试 整合技能所有功能是否正常，确认后将整合技能作为主技能 使用，原技能全部打包存放」
+
+### 1.2 包现状 `~/.workbuddy/skills/session-mechanism/`（**已建成**）
+- **30 个文件**：`SKILL.md`（新写 · 两段式：会话机制／多会话协作）＋ `install.py`（新写）＋ `references/`（architecture/deploy/pitfalls/taskgraph/manifest）＋ `scripts/hooks/`(6) ＋ `scripts/lock/`(4) ＋ `scripts/collab/`(10) ＋ `scripts/forensics/`(1) ＋ `assets/`(2)。
+- 机制脚本**一律 `cp` 拷入（⛔ 无 `mv`）**，源路径全部原样可用；md5 与源逐字节一致（清单 `references/manifest.md`）。
+- `references/manifest.md` 含**逐文件 provenance** ＋ **「暂未纳入」清单**（tools/ 监控成本类 16 项、collab/ 排期文件、全部 `*.bak-*`）——⛔ 不是遗漏，是**判定不纳入**。
+
+### 1.3 🔴 本轮最重要的技术发现（**推翻接续包 §3.4 第 4 条**）
+原设计「唯一实现放包内 ＋ `07-scripts/<同名>` 改**转发壳**」**在本机不可行**，两条硬事实：
+1. **9 个机制脚本里 8 个按自身位置推导根目录**（实测行号）：
+   `handoff-guard.sh:37` `ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"` ／
+   `preflight-lock.sh:25` 同型 ／ `handoff-status.py:14` `dirname(dirname(__file__))` ／
+   `session-log-guard.py:107` `stop-dialog-guard.py:74` `bash-output-guard.py:43` `skill-load-guard.py:139`（`WS_FALLBACK` 上溯）／
+   `lock-guard-hook.py:41`（env＋**硬编码默认**）。
+   ⇒ **改壳会改 `$0`、`mv` 会改 `__file__`** ⇒ 锁根从 `/d/github/.../dsh-server-docs` 直接挪到 `~/.workbuddy/skills` ⇒ 锁目录全错。
+   这正是 `wb-result-hook.py` docstring 记过的原事故：**「一次搬迁后指错 ⇒ 台账静默写到别处而测试全绿」**。
+2. 🔴 **`settings.json` 的 hook 条目没有 `env` 字段**（实测 schema：`{matcher, hooks:[{type,command,timeout}]}`）⇒ **无法靠钩子向脚本注入环境变量**。
+
+**解法（本轮已落地）**：**包内脚本根目录外置** —— 新增 `<包根>/roots.env`（`install.py` 生成），脚本**先读它、再回落按位置推导**。
+已打补丁 8 份（全部语法通过）：`handoff-guard.sh` `preflight-lock.sh` `handoff-status.py` `session-log-guard.py` `stop-dialog-guard.py` `bash-output-guard.py` `skill-load-guard.py` `lock-guard-hook.py` ＋ `wb-result-hook.py`（`WB_RESULT_HOOK_WS` 增加 `DSH_WS_ROOT` 回落）。
+补丁器（一次性脚本，⛔ 不入库）：`$WS/tmp/inv-20261001/patch-roots.py`（精确锚点替换，锚点必须唯一命中，幂等）。
+
+### 1.4 归档原技能的**真实依赖**（⛔ 直接归档会打碎协作机制）
+`grep` 实测：两个原技能被引用很多，但**只有 2 处是真实代码依赖**（其余是文档/记忆）：
+- `$WS/.workbuddy/collab/goalctl.py:460` → `base / "skills" / "multi-session-collab" / "scripts" / "collabd.py"`（**已支持 `COLLABD_SCRIPT` env 覆盖**）
+- `$WS/.workbuddy/tools/wb-result-hook.py:247` → `r"E:/ProgramData/.workbuddy/skills/multi-session-collab/scripts/collabd.py"`（**已支持 `COLLABD_PATH` env 覆盖**）
+⇒ **归档前必须**把这两处的回落路径加/改指到新包（`scripts/collab/collabd.py`），并**重新同步包内副本**。
+⚠️ `wb-result-hook.py` **是全局钩子**（`PreToolUse ^Bash$` ＋ `UserPromptSubmit` ＋ `SessionEnd` 三条接线都指向它，实测）⇒ 改它 = 改**所有会话每次工具调用**都会过的钩子；改完**必须立即用空载荷复测 `rc=0`**。
+
+### 1.5 `install.py` 现状（**核心交付物，已写但未定稿**）
+- 用法：`--dry-run` / `--apply` / `--verify` / `--uninstall`；`--workspace/--docs-root/--code-repo`。
+- 自解析：`sys.executable` ＋ `CODEBUDDY_CONFIG_DIR`（⛔ 无硬编码 python 路径、⛔ 无硬编码盘符）。
+- 声明表驱动 **10 条接线**（`HOOKS`），**⛔ 显式排除** `decision_bridge.py` 的 **4 条**（属 `ai1net-decision-laya` 另一条线）；`--dry-run` 会**打印被排除条数**供目视核对。
+- 幂等（先删自己的旧条目再插，**按脚本名认旧落点**）／写前备份／`--uninstall` 还原／写 `install.log`／写 `roots.env`／工作区初始化（由 example 生成，**已存在则不覆盖**）。
+- 判语：**「`--apply` 每次都备份 ⇒ 最新那份其实是已装状态」** —— `--uninstall` 必须挑**最早那份不含本包痕迹**的备份（本轮已就此改成 fail-closed：挑不到就**拒做**，⛔ 不拿已装状态糊弄）。
+
+---
+
+## §2 沙箱验收：**已过 4 项 / 未过 1 项**（⛔ 不要再重跑前 4 项）
+
+做法：把 `settings.json` **拷进沙箱目录**，用 `CODEBUDDY_CONFIG_DIR=<沙箱>` 跑 —— **现场全局配置零风险**。
+
+| # | 判据 | 结果 |
+|---|---|---|
+| 1 | `--dry-run` 不写盘 ＋ diff 与预期一致 | ✅ **过**：rc=0；删旧 **10** 条（07-scripts/tools）、增新 **10** 条；**沙箱 settings.json md5 装前=装后**（未写盘）；被排除 **4** 条 |
+| 1b | 幂等：连装两遍零改动 | ✅ **过**：第二遍 md5 与第一遍**完全相同**，diff 行数 **0** |
+| 1c | 结构核对 | ✅ **过**：总接线 **14** 条；**指向 07-scripts 的机制钩子 = 0**；`decision_bridge` **4** 条原样保留；无重复条目（按 `command` 计数出现的 4 个"重复"是**同一脚本挂在不同事件上**，正常） |
+| 2 | `--verify`（6 钩子空载荷 rc=0 ＋ `collabd --where` ＋ `selftest`） | ⬜ **未做** |
+| 3 | `--uninstall` 后与装前**逐字节**相同 | ✅ **过（15:15 复测）**：`-orig` 固定名备份 ＋ 微秒时间戳备份 ⇒ `--uninstall` 还原后 `cmp` 逐字节相同；改名/换目录场景同样通过。**修法已落地见 §3 第 1 条** |
+| 4 | 包拷到**另一个目录**再 `--apply` ⇒ 接线指向新路径 | ✅ **过（15:15 复测）**：改名包 `--apply` ⇒ 10 条全指向新路径、`07-scripts` 残留 **0**、`decision_bridge` **4** 条保留；`--uninstall` 逐字节还原。判据已按**包实际路径**（运行时从 `__file__` 推导）判"是否已接管" |
+
+**沙箱现成可复用**：`$WS/tmp/inv-20261001/sbx-settings/`（`settings.json` ＋ 日志），⛔ 不要删，接着用。
+
+---
+
+## §3 未做完的活（**按序做，一次只做一件**）
+
+> 🔴 **进度（2026-10-01 15:1x）**：第 **1、2、3** 条 ✅ **已完成**（明细见下）；**下一条从第 4 条开始**。
+
+**1、✅【已修 · 15:15】`install.py` 两处缺陷**
+   a. **备份唯一化 ＋ 原状备份单列**：首次安装（当前 `settings.json` 无本包痕迹）时写 `settings.json.bak-session-mechanism-orig`，**已存在则⛔不覆盖**；其后每次 `--apply` 写**带微秒**的时间戳备份。`--uninstall` **优先用 `-orig`**。
+   b. **"自己的痕迹"改按脚本名判**：本轮已往包内加了 `has_our_trace(text)`（按 `OWN_BASENAMES` 判）但**尚未接线** ⇒ 把 `--uninstall` 与其它判"痕迹"的地方从 `OWN_MARK`（路径片段）改成 `has_our_trace()`。
+
+**2、✅【已过 · 15:15】`--verify`**：包内 10 条钩子空载荷**全 `rc=0`**；`collabd.py --where` `rc=0` 且**正确报出配置来源**；`selftest.py` **PASS 39 / FAIL 0**。⚠️ 无 `COLLABD_CONFIG` 时 `--where` 仍 `rc=0`（回落 DEFAULTS 并明确标注）⇒ ⛔ 别把"没配置"读成"包坏了"。
+
+**3、✅【已执行 · 15:15】真机 `--apply`（= 用户要的「作为主技能使用」）**
+   `"$PY" "<包>/install.py" --apply --docs-root "D:/github/dsh_shenxian/dsh-server-docs"`
+   装完**立刻 `--verify`**；⚠️ 这一步会把全局钩子从 `07-scripts` 切到包内 ⇒ **影响所有正在跑的会话的每一次工具调用** ⇒ 动手前一句话说明、装完立刻复测、异常立刻 `--uninstall`。
+
+**4、归档原技能（用户明确要求）**
+   a. **先**按 §1.4 改那 2 处回落路径 → 指向新包，**并重新 `cp` 同步包内副本**；改完**空载荷复测 `rc=0`**。
+   b. 打包：`tar -czf "$WS/归档/技能-退役-20261001.tar.gz" -C ~/.workbuddy/skills multi-session-collab workbuddy-session-forensics`
+   c. **然后**才从 `~/.workbuddy/skills/` 移走那两个目录（⚠️ **移走前**确认 `agent-operating-rules` 仍在，它是**声明依赖，⛔ 不并、⛔ 不移**）。
+   d. 改指针：`$WS/CODEBUDDY.md` 头部「协作机制：唯一权威 ⇒ `multi-session-collab/references/architecture.md`」**改指新包**；`.workbuddy/memory/MEMORY.md` 内同型指针一并改。
+
+**5、补 3 份 references**（`SKILL.md` 已引用，**现在是指向空处**）：`references/{collab,rules,forensics}.md`。
+   ⚠️ ⛔ 不要写空壳（写空壳＝文档说谎）；从包内已有的 `architecture.md`/`pitfalls.md`/`taskgraph.md` 与 `multi-session-collab` 原文提炼。
+
+**6、收尾**：`references/manifest.md` 重算（改过补丁）→ 更新本接续包 §0 → 今日日志 → 三层沉淀 → **反序释放锁**。
+
+---
+
+## §4 ⛔ 不要重做 / 不要碰
+
+- ⛔ **不要重跑**：三源目录盘点（§1.2/1.3 已实测）、`install.py` 沙箱前 4 项验收（§2 已过）、`patch-roots.py`（幂等，已跑）。
+- ⛔ **不要 `mv` 机制脚本**；⛔ **不要做转发壳**（§1.3 已证不可行 —— 会挪走锁根）。
+- ⛔ **不要动** `decision_bridge.py` 所在线（`ai1net-decision-laya`）—— 它只是恰好出现在同一张钩子表里（4 条）。
+- ⛔ **不要动自动化排期**（用户明令）。⚠️ 唯一例外＝本包自己登记的接续会话。
+- ⛔ **不要在会话里起常驻后台任务**（会把日志推过 10 MiB ⇒ 界面静默哑掉）。
+- ⛔ **不许报未经实测的系数**；本包只写"实测到的计数/字节"。
+- ⛔ **不要在没有沙箱验证的情况下直接改现场 `settings.json`**。
+- ⛔ **不要删** `$WS/tmp/inv-20261001/`（含补丁器、构建清单脚本、沙箱）。
+
+---
+
+## §5 关键路径与命令
+
+```
+PY   = E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe
+WS   = E:/ProgramData/AIProject/ai1net-dsh-server
+DOC  = D:/github/dsh_shenxian/dsh-server-docs
+PKG  = E:/ProgramData/.workbuddy/skills/session-mechanism
+BASH = E:/ProgramData/.workbuddy/binaries/PortableGit/versions/1.2.0/usr/bin/bash.exe   # ⚠️ 裸 bash 会落到 WSL ⇒ 假阴性
+锁（机制层＝独占，⛔ 不带 --domains）：
+  bash "$DOC/07-scripts/handoff-guard.sh" --claim-exec "<会话名>"
+释放：--release → --release-exec "<会话名>"
+```
+
+---
+
+## §6 本机踩坑（已踩到，⛔ 别再踩）
+
+1. 🔴 **`subprocess.run(["bash", …])` 在本机落到 WSL 启动器** ⇒ 输出 UTF-8 乱码、路径里 `/` 被吃 ⇒ `bash -n` **假阴性**（脚本明明没错却报 FAIL）。必须显式用 `$BASH`。
+2. ⚠️ **`ls -1 目录A 目录B | sort` 把两个目录的输出合并排序**（无分组标题）⇒ 极易误读成"某目录是空的"。**多目录必须分开列**。
+3. ⚠️ 补丁器踩到过两次：把 **Python 引导块插进 `.sh`**；引导块插在 **`from __future__ import` 之前**（有的文件把 `__future__` 放在注释区之后，⛔ 不能只跳过文件开头）。两处都已修，规则：**引导块只插 `.py`，且插到"全文件最后一个 `__future__` 之后"**。
+4. ⚠️ 沙箱备份**同秒同名被覆盖** ⇒ 原状备份必须单列（§3 第 1.a 条）。
+5. ⚠️ `settings.json` 的 hook 条目**无 `env` 字段**（实测 schema）⇒ 别指望用 env 给钩子传参。
+
+---
+
+## §7 验收判据（全过才算交付）
+1. `install.py --dry-run` diff 与预期一致；真装后**再跑一遍零改动**。→ ✅ **已过（沙箱）**
+2. 装机后 `--verify`：包内钩子空载荷全 `rc=0`；`collabd --where` 正确；`selftest` 见 `FAIL 0`。→ ⬜ 未做
+3. `--uninstall` 后与**装前**备份**逐字节相同**（`cmp`）。→ 🔴 未过（修法 §3.1）
+4. 包拷到**另一目录**再装 ⇒ 接线指向新路径且 `--verify` 全绿。→ ⚠️ 部分（§2 #4）
+5. 原技能归档后：`goalctl.py` 与 `wb-result-hook.py` **仍能定位到 `collabd.py`**（改路径后复测 `rc=0`）；`CODEBUDDY.md` 指针已改指新包。
+
+---
+
+## §8 本轮（15:05–15:15）实测记录 —— ⛔ 别重做
+
+### 8.1 🔴 新发现①：**包内脚本目录层级放错 ⇒ `--verify` 恒红**（已修）
+
+- **现象**：`--verify` 的 selftest **PASS 32 / FAIL 7**，7 项全是 `FileNotFoundError`；
+  同一个 selftest 从**原件**（`multi-session-collab/scripts/selftest.py`）跑是 **PASS 39 / FAIL 0**。
+- **真因**：`board.py` 与 `selftest.py` 按 **`HERE.parent / "assets"`** 与 **`HERE.parent / "scripts"`** 定位
+  —— 它们假设自己在 `<技能>/scripts/` 这一层。包把它们放进了 `scripts/collab/` ⇒ 两个路径双双落空。
+- **修法（对机制脚本零改动）**：**把 11 个协作脚本拉平到 `<包>/scripts/` 顶层**，删掉 `collab/` 子目录
+  ⇒ 实测立刻 **PASS 39 / FAIL 0**。
+- 🔴 **教训（写进规矩）**：**拷脚本必须拷到 `scripts/` 顶层，⛔ 不要再建组子目录**
+  （`hooks/` `lock/` `forensics/` 可以留，因为它们靠 `roots.env` 定位、不依赖 `../assets`）。
+- 牵连改动：`install.py --verify` 两处路径、`SKILL.md` 一处路径、`references/manifest.md` 全表。
+
+### 8.2 🔴 新发现②：**工作区协作配置是坏 JSON ⇒ `collabd` 静默回落 DEFAULTS**（已修）
+
+- **现象**：`collabd.py --where` 报「未找到部署配置（…不存在）」，但**文件明明在**。
+- **真因**：`$WS/.workbuddy/collab/collabd.config.json` 第 53 行把 `"按工作区分线"` 写成了
+  **ASCII 双引号**（夹在 JSON 字符串里）⇒ `json.loads` 抛 `JSONDecodeError`；
+  而 `load_cfg()` 的 `except Exception: pass` **静默吞掉**，于是回落 DEFAULTS 并**谎报"不存在"**。
+- **影响面（实测对比）**：DEFAULTS 下 `LIVE`/`TG` 指向 `tmp/supervise-inbox/{realtime.md,taskgraph.json}`
+  —— **两个文件都不存在**；配置文件里指的才是真落点 `交付物/本机协作-实时状态.md`、
+  `交付物/任务图.json`（都在，13:48 还被写过）。⇒ 这是**当天 13:55 的一次编辑引入的回归**
+  （13:48 还在正常写 `交付物/本机协作-实时状态.md`）。
+- **修法**：改成中文引号 `「」`；已 `json.loads` 校验通过，`--where` 现已正确报出
+  `配置来源 = …collabd.config.json`。原坏件备份在 `<WS>/.workbuddy/collab/bak-collabd-config-20261001/`。
+- ⚠️ **遗留（⛔ 本轮未动，留给下一棒判）**：`collabd.load_cfg()` 对"文件存在但解析失败"
+  **既不区分也不告警**，还谎报"不存在"。建议改成**报出真实原因**（解析失败 ≠ 不存在），
+  否则下一次同样的手误还会静默降级。改它要**同时改两处**（`07-scripts` 原件 ＋ 包内副本）并保持同步。
+
+### 8.3 真机切换的实测读数（15:13:17 执行）
+
+- 切换前 `settings.json` md5 `7dca0aeb798e52728dc93dce2e7804b8`；`-orig` 原状备份已写
+  `~/.workbuddy/settings.json.bak-session-mechanism-orig`。
+- 切换后：总接线 **14**、指向 `07-scripts` **0**、指向包内 **10**、`decision_bridge` **4**（原样保留）。
+- ✅ **语义等价性已逐条核对**：事件 / matcher / 额外参数（含 `-S`）/ 超时 / **解释器** 全一致，只有脚本目录不同。
+- ✅ **端到端取证**：装后 `bash-guard.log` 由 15:13:16 → **15:13:39** 且新增 `event=PreToolUse`
+  行、`stop-dialog-guard.log` 同步推进、`state.py` 报「关键闸门在册」⇒ 包内钩子在**生产链路真跑**。
+- 回滚：`python <包>/install.py --uninstall`（`-orig` 已就位，逐字节还原已验收）。
+
+### 8.4 下一棒从哪开始
+
+1. **§3 第 4 条**（归档原技能）：⚠️ **必须先**改 `goalctl.py:460` 与 `wb-result-hook.py:247` 两处回落路径
+   → 指向 `<包>/scripts/collabd.py`，**并重新 `cp` 同步包内副本**，改完**空载荷复测 `rc=0`**；
+   再打包 `归档/技能-退役-20261001.tar.gz`；最后才移目录（⚠️ 确认 `agent-operating-rules` 仍在 ⇒ ⛔ 不并、不移）。
+2. **§3 第 5 条**：补 `references/{collab,rules,forensics}.md`（⛔ 不许写空壳）。
+3. **§3 第 6 条**收尾：本接续包 §0 / 日志 / 三层沉淀 / 反序释放锁。
+4. 可选：处理 8.2 的遗留（`load_cfg` 报真实原因）。
+
+
+
+---
+
+## §9 下一棒剩余步骤（**从 4b 开始 · 逐条做 · 一次一件**）
+
+> 🔴 **本轮（15:40）已完成**：§3 第 1、2、3、5 条 ＋ 第 4a 条（两处回落路径）。**日志硬档停手，剩余如下的机械动作。**
+> ⛔ 先读 §4「不要重做 / 不要碰」清单；⛔ 仍不要重跑盘点与沙箱验收。
+
+### 9.1 第 4d 条 · **先改指针**（★ 必须在 4c 之前 —— 否则目录一移走，指针就悬空）
+需要改指的**活文件**（其余命中都在 `traces/` / `changes-detail/` / `modify_backup/` / `归档/` / 历史日志里，⛔ **不要动**）：
+1. `$WS/CODEBUDDY.md` 头部「**协作机制：唯一权威 ⇒ `multi-session-collab/references/architecture.md`**」⇒ 改指 `~/.workbuddy/skills/session-mechanism/references/architecture.md`。
+2. `$WS/.workbuddy/memory/MEMORY.md` 里同型指针（`multi-session-collab §0.5.5／§1.4a` 那条）⇒ 改指新包同名位置（`references/collab.md` / `references/architecture.md`）。
+3. `~/.workbuddy/MEMORY.md`（跨项目长期记忆）里的 1 处引用。
+4. `$WS/.workbuddy/collab/board_ext.py` 里 1 处（`multi-session-collab/scripts/board.py` 契约注释）。
+5. `$WS/交付物/任务图.json` 与 `$WS/交付物/协同监管棒-SOP.md` 各 1 处。
+6. 检查 `~/.workbuddy/skills/agent-operating-rules/SKILL.md` 是否也有引用（本轮未确认）。
+⚠️ `交付物/` 下的**历史过程件**（`多会话协同*-20260929.md` 等）⇒ **⛔ 不改正文**，按其自身规矩只加头部状态块指向新包。
+
+### 9.2 第 4b 条 · 打包
+`tar -czf "$WS/归档/技能-退役-20261001.tar.gz" -C ~/.workbuddy/skills multi-session-collab workbuddy-session-forensics`
+（⚠️ 打包前确认 4d 已做完。）
+
+### 9.3 第 4c 条 · 移走两个原技能目录 —— ✅ **2026-10-01 16:5x 已做完**（正解＝先让包内看板 `--takeover` 接管，再移）
+
+> ✅ **实测结果（第 5 棒）**：把顺序改成「**① 包内 board 接管（＝一并完成"停旧＋起新"）→ ② `os.rename` 移目录 → ③ 复测**」
+> —— 比原计划的「先停 → 移 → 再启」更安全：**新代码先验证可用，失败还能立刻回退旧实例**（此时目录尚未动）。
+> - ① `"$PY" "<包>/scripts/board.py" --serve 8788 --takeover`（cwd＝`<包>/scripts`，env `COLLABD_CONFIG=<WS>/.workbuddy/collab/collabd.config.json`）
+>   ⇒ 输出 `✓ 接管：已停旧看板 PID 21084（成功）`；新 PID **35068**；`/healthz` `{"ok":true}`、`/` `HTTP 200 / 84,874 B`、`/board.json` 是**真实快照**（goal＋V1–V5 都在）⇒ 只有 1 个实例在听 8788。
+> - ② `os.rename` 两个目录 → `归档/技能-退役-20261001/`（⛔ 不用 `mv`）⇒ **一次成功**（旧实例句柄随停进程释放）。
+> - ③ 三项复测全过（读数见 §0 最新行）。
+> ⚠️ **启动方式**：本机唯一可行＝会话后台任务 ＋ stdout 全重定向（`> <WS>/tmp/board-serve.out.log 2>&1`）；旧实例（08:05 起的那个）也是同款血统、存活 9 小时 ⇒ 该模式在本机**实测 durable**。
+
+
+> 🔴 **2026-10-01 16:0x 实测**：`os.rename` 移 `multi-session-collab` **恒失败** `WinError 5/32`，
+> 而**每个文件单独改名都成功** ⇒ 定位到 **`multi-session-collab/scripts/` 被另一个进程占用**。
+> **占用者＝看板服务 PID 21084**：命令行 `python board.py --serve 8788 --takeover`（**相对路径** ⇒ cwd 就在该 `scripts/`），
+> 起于 **08:05:56**，端口 8788 实测在听、`HTTP 200 / 84,874 B`（＝`board.html`）⇒ **它是活的、是用户正在看的看板**。
+> ⛔ 不可强移（会打断看板）；按 §9.3 规矩**已回滚**：`workbuddy-session-forensics` 移回原地、`multi-session-collab` 未被改动。
+> ⇒ **正解（三步，按序）**：
+> ① 停看板（结束 PID 21084，或它自己的 stop 入口）；
+> ② `python os.rename` 把两个目录移到 `$WS/归档/技能-退役-20261001/`（tar 已在 §9.2 完成，⛔ 不必重打）；
+> ③ 用**包内**路径重启看板：`"$PY" "<包>/scripts/board.py" --serve 8788 --takeover`（cwd 设 `<包>/scripts`），
+>    起来后复测 `HTTP 200` ＋ 三个读数（钩子空载荷 `rc=0`、`goalctl` → `<包>/scripts/collabd.py`、`install.py --verify` 全绿）。
+> ⚠️ **教训（值得写进技能）**：归档一个「被服务依赖的技能目录」时，**先查有没有进程正跑在里面**
+> （判据＝相对路径启动的服务 ⇒ cwd 即句柄），否则会得出"移不动＝权限问题"的错误结论。
+
+- ⚠️ **移走前**确认 `agent-operating-rules` **仍在** `~/.workbuddy/skills/` —— 它是**声明依赖，⛔ 不并、⛔ 不移**。
+- 用 python `os.rename` 移，⛔ 不用 `mv`（见 §6 第 1 条）。
+- 移走后**立刻复测**：`wb-result-hook.py` 空载荷 `rc=0`、`goalctl.py` 能解析到 `<包>/scripts/collabd.py`、`install.py --verify` 全绿。
+  🔴 这两个脚本的回落路径**已在本轮改成新包优先**，所以移走原技能后仍应正常；**若异常 ⇒ 立刻把目录移回来报障**。
+
+### 9.4 第 6 条 · 收尾
+`references/manifest.md` 重算（本轮已重算过一次，4a 又改了 `goalctl.py`／`wb-result-hook.py` 两份 md5 ⇒ **必须再算**）→ 更新本接续包 §0 → 当日日志 → 三层沉淀 → **反序释放锁**（`--release` → `--release-exec "<会话名>"`）。
+
+### 9.5 可选（低优先）
+`collabd.load_cfg()` 对「配置存在但解析失败」不区分、还谎报"不存在" ⇒ 建议改成报真实原因；**要同时改 `07-scripts` 原件与包内副本并保持同步**。
+
+### 9.6 候选（本轮登记 · 由用户质疑引出）—— ✅ **2026-10-01 16:5x 已实测并落地，见 §9.7**
+
+用户问「工具日志不是已经拦截了吗」⇒ 核实结论：`session-log-guard.py` **只叫停、不降速**（零删改动作，只注入提醒）；10 MiB 上限真实（当日已有 6 个会话日志卡在 10,485,7xx B）。
+⇒ **候选**：把「**会话中途回收日志**」做成正式机制（重命名让宿主重建），使会话**不必因撞顶而停手**。
+⚠️ 上手前必须先实测两条：① 宿主**正在写**时改名是否安全（现有证据只覆盖**冻结**日志）；② 丢掉被拒写的那段诊断内容的代价是否可接受。
+⛔ 未实测前⛔ 不要写进机制、⛔ 不要报"已经解决"。
+
+---
+
+## §9.7 第 5 棒结果（2026-10-01 16:5x）—— ② 有界实验 ＋ ③ 缺口
+
+### A. ②「会话日志自愈」—— ✅ **可行，已接入机制**
+
+**实测（真实会话，非 scratch）**
+- 对本会话自己的 `logs/2026-10-01/sdk/conversations/63f5e790-….log` 做 **一次** `os.rename` ⇒ **成功**（无 `WinError 32/5`）。
+- 紧邻的下一次读数：**原文件名已回来**（宿主重建，50,073 B）且继续增长；旧件**冻结**在 1,728,992 B。
+- ⇒ 判语：宿主**不是"句柄常开"**，而是**每次日志批写开-写-关** ⇒ **工具调用的间隙里句柄是关着的**。
+  ⚠️ 当天更早那条"不可改名"的结论**只对"正在被写的那一瞬"成立**（scratch 复现里子进程一直在 append）。
+
+**落地（机制改动 · 只动了 1 份文件）**
+- 位置：`<包>/scripts/hooks/session-log-guard.py`（＋ 文档库原件 `07-scripts/session-log-guard.py` **同语义同步**）。
+- 规则：**到硬档（8 MiB）先试一次就地回收** —— 把 `<sid>.log` 改名为 `<sid>.log.recycled-<YYYYMMDD-HHMMSS>`
+  ⇒ 成功：**复位本会话档位**（不复位则后半程再也报不出来）＋ 注入 ♻️ 提示（"可继续、不必停手"），**直接结束**；
+  ⇒ 失败：**一个字都不改**，逐字退回原「停手＋建接续」口径（fail-safe）。
+- 收窄与防撞：⛔ 只动**本会话自己那一份**（`_log_path` 按 `session_id` 精确拼名）；⛔ **只试一次**（放在档位去重之后 ⇒ 每个档位天然只试一次），⛔ 不 sleep、不重试、不降级成删/截断。
+- 与清扫器不冲突：后缀**不以 `.log` 结尾** ⇒ `wb-logcap-sweep.py` 的 `*.log` 匹配**天然不重叠**（不会被二次搬运）。
+- 开关：`DSH_SLG_NO_RECYCLE=1` ⇒ 只关回收、**保留**软/硬档叫停。
+- **验收（都做过）**：空载荷 `rc=0` 零输出 ✅｜真实形状载荷（未达档）`rc=0` 零输出 ✅｜`install.py --verify` 全绿 **PASS 39 / FAIL 0** ✅｜
+  验收通道（`tmp/.session-log-guard.verify.json` 收窄到本会话 sid）**端到端跑出真记录** `RECYCLE｜size=279862 B｜…log -> …log.recycled-20261001-165257` ＋ ♻️ 注入 1,077 B ✅（跑完**立即删除**通道文件，已复核不存在）。
+- ⚠️ **途中修掉 1 个真缺陷**：`_recycle_note` 里字面量 `97.8%` 未转义 ⇒ 抛 `TypeError: not enough arguments for format string`
+  （回收仍生效、只是提示发不出；已在两副本改 `%%` 并加注释）。
+- ⚠️ 另一处已修：`_recycle` 的阈值**必须传实际生效的 `hard`**（⛔ 不写死模块常量），否则验收通道只能验"叫停"、**验不到"回收"**。
+
+**遗留（⛔ 本轮未做）**
+- 回收后**那一轮会话会不会自己继续**，仍**未验证**（本轮只证明了"写入不中断"，没证明"已失败的那轮会重跑"）。
+  ⇒ 仍必须靠 §B 的「哑掉 → 重排」兜底 —— 但**恢复写入**已把"沉默窗口"从"永久"压到"≤ 1 分钟（清扫器周期）"。
+- 回收阈值暂定＝硬档（8 MiB），⛔ **未验证"更低阈值（如 5 MiB）是否更优"**（更低＝更频繁改名、更高＝更逼近平台上限）。
+
+### B. ③「日志撞顶 ⇒ 哑掉」这一型的覆盖情况 —— 🔴 **部分覆盖，缺口已定位，⛔ 未改代码**
+
+**已有的覆盖（都在 `collabd.py`，均已实测在跑）**
+1. **检测**：`_deaf_sids()` —— 取每个会话**最新一天**的日志，`≥ 9.5 MiB` 判哑（只读，扫不到＝空集）。
+2. **不许投**：两条投递路径（`_deliver_str` ≈1016 行、另一条 ≈1133 行）命中哑 ⇒ `skipped="target-deaf"` ＋ `need_user(...)`
+   ⇒ **不记假绿**，并把"该点哪一下"落到 `NEED-USER.md`。
+3. **不当主会话**：`_pick_live()`（≈1902 行）把哑会话从"主会话候选"里剔除。
+
+**🔴 缺口（没有"重排"这一层）**
+- 处置动作**只有"喊用户换会话"**（`need_user` 原文：「请把主会话换到一条新会话（旧的那条只能弃用）」）⇒ **恢复链条要靠人**。
+- 🔴 **更糟的是它会反过来挡住唯一那条重排入口**：`reconcile()`（≈2190 行）的僵尸判据是
+  「台账 `running` **且除观察者外无人在跑**、且无 `IN_PROGRESS`」才标 `blocked`＋`待主会话重派`。
+  而哑会话若在宿主库里**仍记 `working`**（会话被冻在半途）⇒ 它**被当成"有人还在跑"** ⇒ 僵尸判据**永不触发** ⇒
+  形成死角：**既投不进去、又不判死、也没人重派**。
+  （注：若哑会话在库里已转成 `completed`，僵尸判据**可以**触发 —— 所以是"**条件性覆盖**"，不是全无。）
+- 且 `collabd.py` **自身设计上就不派活/不开新会话**（其 docstring 第 12 行明写），⛔ 不能指望它自动补一条接续。
+
+**最小修法（⛔ 本轮**未实施**，留给下一棒／用户点头）**
+- 在 `reconcile()` 里把 `_deaf_sids()` 命中者**从"在跑"集合里剔除**（即"哑会话不算执行者"）：
+  `allrun` 剔掉哑 ⇒ ① 它们不再被"启动对账收编"成 `running`（投不进去的会话本来就不该算执行者）；
+  ② 僵尸判据得以触发 ⇒ 标 `blocked` ＋ `block_reason="…待主会话重派"` ⇒ **队列里看得见**，主会话/监管棒才会重派。
+- 量级：**一处改动（约 1–2 行）**，复用现成的 `_deaf_sids()`，⛔ 不新增常驻、⛔ 不动排期、⛔ 不新增阈值。
+- ⚠️ 注意比较口径：`_deaf_sids()` 返回**完整 sid**，而 `reconcile` 里 `me` 用的是前 8 位 ⇒ 剔哑时要**按完整 sid 比**。
+- ⚠️ 前置：**先把 ② 的回收跑一段时间**（它把撞顶概率大幅压低）⇒ 再决定这条兜底要不要上（它只服务"已经哑了"的存量与漏网）。
+- ⛔ 另有一条**已排除**的做法：让 `collabd` 直接开接续会话 —— **违反它自己的设计约束**（不派活／不开新会话），且触"⛔ 不要动自动化排期"。
+
+### C. 本轮 ⛔ 未做（明确不碰）
+- §9.5 `collabd.load_cfg()` 对"配置存在但解析失败"不区分、还谎报"不存在"（要同时改 `07-scripts` 原件与包内副本）。
+- 自动化排期、`decision_bridge` 那条线、`wb-logcap-sweep.py` 与计划任务 `WorkBuddy-LogCapSweep`（⛔ 一个字没动）。

归档/接续历史/会话机制/接续包_会话机制合并技能包_20261001.md

@@ -0,0 +1,151 @@
+# 接续包 · 会话机制 → 合并为一个技能包（2026-10-01）
+
+> ## §0 状态（**最新行在最上**）
+> | 时间 | 会话 | 发生了什么 |
+> |---|---|---|
+> | 2026-10-01 14:59 | `会话机制合并包-任务234` | 🔴 **本包已续期 ⇒ 后续一律看 `接续包_会话机制合并技能包-任务234_20261001.md`**（任务 2/3/4 ＋ 归档）。硬档停手（日志 8.02 MiB）。🔴 **推翻本包 §3.4 第 4 条**：转发壳**不可行**（8/9 脚本按自身位置推根 ＋ `settings.json` 钩子条目无 `env` 字段）⇒ 改用**包内 `roots.env` 外置根目录**（已落地 8+1 份补丁，语法全过）。沙箱验收 **5 项过 4 项**。 |
+> | 2026-10-01 14:2x | `会话机制合并包-任务0` | ✅ **任务 1 完成**：新包 `~/.workbuddy/skills/session-mechanism/` 已建成 —— **27 个文件全部 `cp` 拷入（⛔ 零 `mv`）**，`py_compile` / **Git-Bash** `bash -n` / `json.loads` 全通过（失败 **0**），且与源**逐字节 md5 一致**；清单见包内 `references/manifest.md`。**旧路径全部原样可用**。 |
+> | 2026-10-01 14:2x | `会话机制合并包-任务0` | ✅ **任务 0 完成**：正式方案落盘 `$WS/交付物/会话机制合并技能包-方案-20261001.md` —— 方案对比 **A（单一实现＋转发壳，建议）/ B（mv 全改引用，淘汰）/ C（只做配置器，需求未达淘汰）/ D（硬链接，淘汰）**＋ **红线 R1–R11 逐条自查**（含 R5 权限影响评估、R11 十维自查、R7 拷贝清单）＋ 执行顺序与验收 ＋ 风险回滚。 |
+> | 2026-10-01 14:2x | `会话机制合并包-任务0` | 🔴 **更正一处错数**：`$WS/.workbuddy/collab/` **非空**（实测 9 文件 ＋ 4 子目录）⇒ 运行态**源在 `collab/` 而非 `tools/`**；误判成因＝`ls -1 目录A 目录B \| sort` 把两目录输出**合并排序**。已在方案 §2.5 回填 + 踩坑记录。 |
+> | 2026-10-01 14:2x | `会话机制合并包-任务0` | 🔴 **下一棒 = 任务 2（写 `install.py`）**；⛔ 开工前**先只读取证**「WorkBuddy 是否读 `~/.workbuddy/AGENTS.md`」。⚠️ 本会话已反序释放锁 ⇒ 接续会话须自己重抢（机制层＝独占，⛔ 不带 `--domains`）。 |
+> | 2026-10-01 13:59 | `334140d1` | ⛔ **硬档停手**：本会话诊断日志 **8.03 MiB / 10 MiB**（≈53 次调用余额）⇒ 按 §G 硬档只做到「盘点」就落包停手。**本轮未改任何机制文件**（零改动、零风险）。 |
+> | 2026-10-01 13:59 | `334140d1` | 已持**全局独占锁**；本包写完即反序释放 ⇒ **接续会话须自己重新抢**（机制层，走独占，⛔ 不带 `--domains`）。 |
+>
+> **本包 §3 = 已取证的现状（省掉重跑盘点）；§4 = ⛔ 不要重做清单；§2 = 任务，一次只做一件。**
+> 🔴 **任务 0 / 1 已由 `会话机制合并包-任务0` 完成** ⇒ 接续会话**直接从 §2 任务 2 开始**，⛔ 不要重做 0 / 1。
+
+---
+
+## §1 用户原话与目标（2026-10-01 13:5x）
+
+> 「整合 会话机制相关技能为一个skill包 ， 在将多会话协作机制 也整合到这个技能包，要求换一台电脑的 workbuddy 上运行也能自动完成配置，让所有会话遵循 会话机制，并且可独立使用 多会话协作」
+
+拆成四条硬要求：
+1. **一个技能包**装下「会话机制」相关技能；
+2. **多会话协作机制**也并进同一个包；
+3. **换一台电脑** ⇒ 跑起来能**自动完成配置**（不是手抄 14 处钩子、不是手改绝对路径）；
+4. **所有会话遵循会话机制**（全局生效）＋ **多会话协作可独立使用**（不装也行、装了不依赖旁件）。
+
+---
+
+## §2 待做任务（🔴 一次只做一件，做完即停）
+
+### 任务 0 · 定界与设计落盘（**本任务已完成一半 ⇒ 见 §3.4 已定项；剩下是把方案写成正式文档**）
+1、把 §3.4 的「已定项」写成 `$WS/交付物/会话机制合并技能包-方案-20261001.md`（方案对比表 ≥2 项 ＋ 利弊 ＋ 建议，按 §1.5 B 阶段 2）。
+2、红线 R1–R11 逐条自查，尤其 R5（权限影响）与 R9（锁）。
+
+### 任务 1 · 建包骨架（先读 §3.4 已定项，⛔ 不要另起设计）
+1、建 `~/.workbuddy/skills/session-mechanism/`，按 §3.4 的目录表放文件。
+2、机制脚本用 **`cp` 从现址拷入**（⛔ 不 `mv`）—— 保证任何时刻旧路径都还能用。
+3、拷完逐个 `py_compile` / `bash -n`，并算 md5 记进包的 `references/manifest.md`。
+
+### 任务 2 · 写 `install.py`（本包的核心交付物 = 「自动完成配置」）
+1、按 §3.4 第 5 条实现：钩子接线（幂等 ＋ 备份 ＋ `--dry-run` ＋ `--uninstall`）＋ 工作区初始化 ＋ `--verify`。
+2、⛔ 不许硬编码 Python 路径（一律 `sys.executable`）、⛔ 不许硬编码盘符（配置目录按 `CODEBUDDY_CONFIG_DIR` 推导）。
+
+### 任务 3 · 本机实测（⛔ 不许只测 happy path）
+1、`--dry-run` 先看 diff；再真装；再 `--verify`。
+2、**必测**：跑两遍（幂等 ⇒ 第二遍零改动）／`--uninstall` 后 settings.json 与备份**逐字节同**／钩子仍能 rc=0。
+
+### 任务 4 · 文档与收口
+1、写包内 `SKILL.md`（两段可分别加载：会话机制 / 多会话协作）、`references/deploy.md`（换机器）。
+2、`07-scripts/` 转发壳（见 §3.4 第 4 条）—— 这一件**有 blast radius，放最后做**。
+3、三层沉淀（技能／教训／记忆）＋ 反序释放锁。
+
+---
+
+## §3 已取证的现状（🆕 2026-10-01 13:5x 实测，⛔ 不要再重跑盘点）
+
+### 3.1 「会话机制」的家当散在**三个互不相干的地方**
+
+| 落点 | 装了什么 | 规模 |
+|---|---|---|
+| `~/.workbuddy/skills/multi-session-collab/` | 协作机制本体：`collabd.py` 177 KB / `board.py` 67 KB / `guard.py` / `selftest.py` ＋ `references/{architecture 64 KB, deploy, pitfalls, taskgraph}` ＋ `assets/` | 14 文件 |
+| `D:/github/dsh_shenxian/dsh-server-docs/07-scripts/` | **宿主钩子 ＋ 锁**：`handoff-guard.sh` 34 KB、`preflight-lock.sh`、`handoff-status.py`、`op-lock.sh`、`lock-guard-hook.py`、`session-log-guard.py`、`stop-dialog-guard.py`、`skill-load-guard.py`、`bash-output-guard.py`（＋与机制无关的 docs-* 共 29 文件） | 9 个属机制 |
+| `$WS/.workbuddy/collab/`＋`.workbuddy/tools/` | 运行态：`collabd.config.json`、`goalctl.py`、`wake-session.py`、`board_ext.py`、`wb-result-hook.py`、`stop-collab.py` | 26 文件 |
+
+⚠️ **这就是合并要解决的第一性问题**：机制本体在 skill、钩子与锁在文档库、运行态在工作区 —— 换机器要同时搬三处。
+
+### 3.2 宿主钩子接线现状（`settings.json` 实测 · 共 **14 处** · 指向 **3 个不同目录**）
+
+| 事件 | matcher | 指向 |
+|---|---|---|
+| PostToolUse | （空） | `07-scripts/session-log-guard.py`（`-S` 调用） |
+| PreToolUse | `^AskUserQuestion$` | `ai1net-decision-laya/bridge/decision_bridge.py` |
+| PreToolUse | `^Bash$` | `$WS/.workbuddy/tools/wb-result-hook.py` |
+| PreToolUse | `Write\|Edit` | `07-scripts/lock-guard-hook.py` |
+| PreToolUse | `Bash\|Read` | `07-scripts/bash-output-guard.py` |
+| SessionEnd | （空）×2 | `decision_bridge.py` ／ `wb-result-hook.py` |
+| SessionStart | `startup\|resume` | `07-scripts/lock-guard-hook.py` |
+| SessionStart | （空） | `decision_bridge.py` |
+| UserPromptSubmit | （空）×5 | `decision_bridge.py`／`wb-result-hook.py`／`stop-dialog-guard.py`／`skill-load-guard.py`／`session-log-guard.py`（`-S`） |
+
+⚠️ **全部硬编码 python 绝对路径**（`E:\ProgramData\.workbuddy\binaries\python\versions\3.13.12\python.exe`）⇒ 换机器必碎。
+⚠️ `decision_bridge.py` 属**另一条线**（`ai1net-decision-laya`），⛔ **不并入本包**。
+
+### 3.3 引用面（搬动前的 blast radius 实测）
+
+`handoff-guard` 被引用：文档库 **5** 处 ／ 工作区 **2** 处；`preflight-lock` 2／1；`op-lock` 3／0；`lock-guard-hook` 3／0；`session-log-guard` 3／0；`stop-dialog-guard` 6／0；`skill-load-guard` 4／0；`bash-output-guard` 5／1。
+⇒ **不能直接 `mv` 走**（会静默弄坏文档库的锁与文档检查链）。
+
+### 3.4 🔴 已定项（本轮已拍板 · 接续会话照此执行，⛔ 不要重新设计）
+
+1. **包名与落点**：`session-mechanism`（=`~/.workbuddy/skills/session-mechanism/`）。理由：用户原话就是「会话机制」，不与既有 `multi-session-collab` 抢名。
+2. **包内目录（草案）**：
+   ```
+   SKILL.md                  # 总入口；两段可分别加载：「会话机制」/「多会话协作」
+   install.py                # 🔴 自动配置（本包核心）
+   references/{architecture,deploy,pitfalls,taskgraph,collab,rules,forensics,manifest}.md
+   scripts/hooks/            # 宿主钩子 6 份（自包含，⛔ 不再依赖 07-scripts）
+   scripts/lock/             # handoff-guard.sh / preflight-lock.sh / handoff-status.py
+   scripts/collab/           # collabd.py / board.py / board_ext.py / goalctl.py / wake-session.py / guard.py / selftest.py
+   scripts/forensics/        # proc-parent.py
+   assets/                   # board.html / design-tokens.css
+   ```
+3. **哪两个技能并入**：`multi-session-collab`（机制本体）＋ `workbuddy-session-forensics`（会话取证）。
+   ⚠️ **`agent-operating-rules` 判为「不并」**（它是跨项目「作业总规矩／说话方式」层，被大量模板引用）⇒ 只在包内 SKILL.md 里**声明依赖**。
+   🔴 **这一条是**有取舍的判断 ⇒ **留给用户在任务 0 时一句话推翻**（推翻成本低：多拷 4 个 references）。
+4. **单一实现源 ＋ 转发壳**（解法 = 唯一实现 ＋ 零 blast radius）：机制脚本的**唯一实现放包内**；文档库 `07-scripts/<同名>` 改成 **3 行转发壳**（`exec` 包内那份），⛔ **不删原件**、⛔ 不动物流。
+   ⚠️ 理由：`pitfalls` 明写「同名的两份实现是最难查的故障」（实测两份同时跑给出互相矛盾读数）。
+5. **`install.py` 五项职责**：① 自解析（`sys.executable` ＋ `CODEBUDDY_CONFIG_DIR`）② 钩子接线：**声明表驱动**（14 处 → 一张表，`decision_bridge` 那条排除在外）、**先删自己旧条目再插**、写前备份、`--dry-run`、`--uninstall` 逐字节还原 ③ 工作区初始化：`--workspace <path>` ⇒ 由 `collabd.config.example.json` 生成 `collabd.config.json`（路径按本机推导）＋ 写工作区规则锚 ④ `--verify`：每个钩子跑空载荷须 rc=0 ＋ `collabd.py --where` ＋ `selftest.py` ⑤ 全部写操作写 `install.log`。
+6. **「所有会话遵循」的注入面**：已确认可用的是 ① 全局钩子（`settings.json` 全局生效）② 技能全局可见 ③ `~/.workbuddy/MEMORY.md`（用户级记忆，跨会话注入）。
+   ⚠️ **未取证**：WorkBuddy 是否读 `~/.workbuddy/AGENTS.md` —— `app.asar.unpacked/cli/dist/codebuddy-headless.js` 与 `codebuddy-lite-wb.mjs` 里出现 `AGENTS.md` 字样 ⇒ **任务 2 开工前先只读取证**（⛔ 别猜）。
+
+### 3.5 本轮**没有**改任何文件
+只新增：本包（`$WS/接续包_会话机制合并技能包_20261001.md`）＋ `tmp/inv-20261001/`（两个只读盘点脚本）＋ 今日日志一段。⛔ 机制文件零改动 ⇒ 无回滚负担。
+
+---
+
+## §4 ⛔ 不要重做 / 撤回清单
+
+- ⛔ **不要重跑全库盘点**：§3.1–3.3 就是实测结果（文件数 / 字节 / 钩子 14 处 / 引用面），直接引用。
+- ⛔ **不要 `mv` 机制脚本**，一律 `cp` 后再改接线；移除只在「转发壳验完」之后。
+- ⛔ **不要动 `decision_bridge.py` 所在的线**（`ai1net-decision-laya`）—— 它只是恰好出现同一张钩子表里。
+- ⛔ **不要改 `settings.json` 而不备份**：本目录已有 6 份 `.bak-*` 先例，命名沿用 `settings.json.bak-<用途>-<日期>`。
+- ⛔ **不许报未经实测的系数**（延续上一包 §4）：本包只允许写「本轮实测到的字节数 / 计数」。
+- ⛔ **不要动自动化排期**（用户明令；唯一例外＝本包自己登记的那条接续会话，已完成）。
+- ⛔ **不要在会话里起常驻后台任务**（会把会话日志推过 10 MiB ⇒ 界面静默哑掉）。
+- ⛔ **不要为验收烧调用次数**：本会话就是因为跑到 8.03 MiB 才停的手，接续会话预算 ≈ 53 次调用 ⇒ **盘点类动作一律复用 §3**。
+
+---
+
+## §5 验收判据（任务 3 逐条打钩，⛔ 不许「本机改完了」当交付）
+
+1. `install.py --dry-run` 打印的 settings.json diff 与预期一致；真装后**再跑一遍 ⇒ 零改动**（幂等）。
+2. 装机后立刻 `--verify`：6 个钩子空载荷全 rc=0；`collabd.py --where` 路径正确；`selftest.py` **PASS / FAIL 0**。
+3. `--uninstall` 后 `settings.json` 与装前备份**逐字节相同**（`cmp` 通过）。
+4. 转出路径验一次：把包拷到**另一个目录**再跑 `install.py` ⇒ 钩子指向新路径且 `--verify` 全绿（＝「换电脑」的最小可复现）。
+5. 文档库 `07-scripts/` 转发壳：手动调 `handoff-guard.sh --status` ⇒ 行为与原型一致。
+
+## §6 关键路径与命令
+
+```
+PY  = E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe
+WS  = E:/ProgramData/AIProject/ai1net-dsh-server
+DOC = D:/github/dsh_shenxian/dsh-server-docs
+技能目标目录 = E:/ProgramData/.workbuddy/skills/session-mechanism/
+锁：bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" --claim-exec "<会话名>"    # 机制层=独占，⛔ 不带 --domains
+释放：--release → --release-exec "<会话名>"
+```
+
+收尾：反序释放锁 ＋ 三层沉淀（技能 / 教训 / 记忆）＋ 提交边界（未明确要求 ⇒ 不 commit/push）。

归档/接续历史/会话机制/接续包_唤醒机制探索_20260930.md

@@ -0,0 +1,107 @@
+# 接续包 · 唤醒机制探索（2026-09-30 18:55 立）
+
+> 🔴 **状态块（2026-09-30 19:5x 加 · 由接续棒 `a202550c` 回填）**：
+> **§1 第 3 棒（worker 退出后能否被外部叫起）已作答 ⇒ 判定：🔴 不能（叫醒旧会话）／能（无人值守地新起一个会话）。**
+> **定稿 ⇒ `交付物/唤醒-无人值守可行性-20260930.md`（判定＋泳道图＋事故链图）＋ 同名 `-图.html`；冲突以定稿为准。**
+> 三条硬结论（一句话各一）：① 网关口长在 worker 进程里 ⇒ worker 退出端口就消失；② `POST /api/v1/runs` **不选会话**（`id` 只当消息 id，路由先取宿主自己的 `primarySession`）⇒ 对别的活网关投递只会落到**投递方自己**的会话；③ 宿主不自愈（activated 条目意外退出**只写 warn**），唯一有效的复活动因在桌面端 **pipe** 上 ⇒ 外部接不上。
+> 🔴 连带影响：**§3 的"三选项"要重读** —— 方案 **③（idle 钩子→runs）不具备无人值守所需稳定性**（worker 典型寿命仅 30 s–6 min，实测），已降级为可选兜底；主干改为 **A 自动化派棒**。
+> ⛔ **§2 #3c 要更新**：worker 自行退出**不是偶发**，是常态（三天计数 40 / 55 / 28）。
+> ⚠️ 唯一能改判定的未知量：`code=1` 静默退出是"回合结束被主动回收"还是"崩溃"（未做，留下一棒）。
+
+>
+> **工作线**：机制线 · 唤醒机制探索
+> **上一棒**：会话 `6ecf6d98`（标题 `[主控]-[机制线]-接续：查「唤醒」为什么断`）
+> **✅ 上一棒已完成**：一次性自动化 `8d046fb3-be7e-410c-8ae6-239113e780a9`（19:00 起，会话 `706d2476`）
+> 　　⇒ **结论：idle 钩子"成立"**，全天唯一一次真触发 `18:55:00.210`；并**修正**了本包 §2 #2 的旧结论。产出 `交付物/唤醒-idle钩子坐实-20260930.md`。
+> **🔴 下一棒已登记**：一次性自动化 **`b68e2b24-0964-400c-b7d8-be097211d23d`**
+> 　　名称：`主控 · 唤醒机制线 · 棒：worker 退出后能否被外部叫起（无人值守决定性一问）`｜排期：**2026-09-30 19:33**｜cwd：`E:/ProgramData/AIProject/ai1net-dsh-server`
+> 　　（id 取自工具返回值，⛔ 手写 id 一律无效）
+> **本包位置**：`E:/ProgramData/AIProject/ai1net-dsh-server/接续包_唤醒机制探索_20260930.md`
+
+---
+
+## ⚠️ 状态块（2026-09-30 19:1x 加 · 由接续棒 `706d2476` 回填）
+
+**本包 §1 目标已达成 ✅ —— 结论：idle 钩子「成立」，已端到端坐实（18:55:00.210 宿主真实 spawn）。**
+**定稿 ⇒ `交付物/唤醒-idle钩子坐实-20260930.md`（含泳道图＋事故链图）。冲突以定稿为准。**
+
+⛔ **本包 §2 有两行已被推翻，别再沿用**：
+
+| §2 条目 | 处置 |
+|---|---|
+| **#1**「idle 钩子至今 0 次真实触发」 | **更新**：17:51–18:54 期间仍成立；**18:55:00 起 = 1 次真实触发** |
+| **#2**「项目级配置对已运行会话不生效」 | **⛔ 判错，撤销**。真因＝**`hasLiveBackgroundTask()` 被一个 12:17:45 起、18:38:13 才死的后台任务压了 6h20m**（闸门不过只重装表、**零日志**）。项目级钩子对已跑会话**确实生效**（本会话 12:00 起跑、钩子 17:51 才挂，仍触发成功） |
+| **#2 附带的两个"空闲窗"**（17:52→17:55 / 18:50→18:52） | **⛔ 都不成立**：前者该会话全程在跑工具；后者到期时刻状态＝`tool_executing` |
+
+🔑 **"空闲"的正确判据**（⛔ 不是"没收到用户消息 60 s"）：**状态机 `idle` ＋ 该会话无 pending/running 后台任务**，且计时器**每次 `addHistory` 都重置**（回合进行中永不计时）。
+
+🔴 **#2 的这条错如果没被拦下，会让后续棒去改全局配置**（一个既非必要、又属"改全局"的动作）—— 这正是本状态块存在的意义。
+
+🔴 **下一棒已换**：一次性自动化 **`98fb060b-81e2-4daf-ba1f-d0e522246e80`**（`主控 · 唤醒机制线 · 复现验证棒`，排期 **2026-09-30 19:15**，cwds 正斜杠）。
+其唯一目标＝验证 §9 那条可复现预测（`session_id=706d2476` 的探针行是否在"+60 秒"出现）。**§3 的"唤醒落地三选项"仍待用户拍板。**
+
+## §1 本包唯一目标的演进（两棒已了，第三棒在跑）
+
+### ✅ 第 2 棒（已完成，19:00）：idle 钩子**成立**
+全天唯一一次**宿主真触发**在 `18:55:00.210`（宿主日志 `[HookExecutor] spawn`，可复核）。**两道隐形闸门**：
+① 状态机必须 `idle`（每次 `addHistory` 都重置 60 s 计时器）② 该会话**无 pending/running 后台任务**（`hasLiveBackgroundTask()`）。
+闸门不过 ⇒ **只重装表、零日志** —— 这就是它之前"看起来从没工作过"的真因（被一个 12:17 起的僵尸后台任务压了 6h20m）。
+判据只认端到端：探针 `tmp/_idle_hook_probe.jsonl` 出现**宿主新增**行（⛔ 手工自测那行不算），且落在真实 >60 s 空闲窗内。
+
+### 🔴 第 3 棒（已登记，19:33）：**worker 退出后能否被外部叫起**（无人值守决定性一问）
+- 要答：worker 退出（今天实测到 `activated prewarm entry exited unexpectedly (code=1)` 一波 3 个）后 —— 网关口还在不在？`POST /api/v1/runs` 是排队、报错、还是**真把它拉起来跑一轮**？若拉不起来，是否只剩"每次唤醒都新起会话"？
+- 为什么决定性：idle 钩子路线的前提是"**会话活着且空闲**"；外部定时器→`runs` 路线若拉不活，则"无人值守"的成本前提被推翻。
+
+## §2 已经定死的结论（⛔ 别再重做取证）
+
+| # | 结论 | 级别 |
+|---|---|---|
+| 1 | ✅ **idle 钩子成立**（已坐实，含唯一一次真触发 `18:55:00.210`）—— ~~"至今 0 次真实触发"~~ **已作废** | 实测（第 2 棒） |
+| 2 | 🔴 ~~**项目级配置对已运行会话不生效**~~ **判错，已推翻**：配置生效正常，是被**两道隐形闸门**压的（状态机非 idle／有活的后台任务）。真因＝一个 12:17 起的僵尸后台任务压了 **6h20m** | 实测（第 2 棒修正） |
+| 3 | **钩子热生效**（改完 `settings.json` 不重启宿主，下一次调用就生效） | 实测 |
+| 3b | **idle 钩子的两道闸门**：① 状态机 = `idle`（每次 `addHistory` 重置 60 s）② **无 pending/running 后台任务**；不过闸 ⇒ 只重装表、**零日志** | 源码 ＋ 实测 |
+| 3c | ⚠️ **宿主 worker 会自行退出**：19:09–19:11 一波 3 个会话 `activated prewarm entry exited unexpectedly (code=1)` ⇒ **计时器随之消失** | 实测（第 2 棒附带） |
+| 3d | **取证四件套**（判"机制为何不触发"必须齐）：`[addHistory] COMPLETED`｜`[SessionRunStateMachine] transition`｜`[BashTool] background task …`｜`[HookExecutor] spawn`，再加**会话进程存活**；缺一件都⛔ 不许下"机制不成立" | 实测 |
+| 4 | **5 分钟级自动化做不到**（源码级：`parseRRule` 的 `FREQ` 是硬白名单 HOURLY/DAILY/WEEKLY/MONTHLY/YEARLY） | 源码级 |
+| 5 | **网关 `scheduled-tasks` 在桌面端是死能力**（宿主硬编码 `CODEBUDDY_DISABLE_CRON=1`） | 源码级 |
+| 6 | **`POST /api/v1/runs` 投递成立**：会话忙时排队、空闲即交付 ⇒ **外部程序可以叫醒会话，不需人切窗口** | 实测（17:49 投、17:55 真到） |
+| 7 | `POST /sessions/{id}/reply` **只认 live**；非 live ⇒ `parkInQueue`（4.5 h 无反应） | 实测判负 |
+| 8 | `/jobs/{id}/reply` 写 inbox，**worker 从不 drain** | 实测判负 |
+| 9 | `stop→reply(pending)→respawn`：pending/respawn/unshift 都成，**worker 卡 `resuming…`** | 实测判负 |
+| 10 | **唤醒 ＝「任务完成」事件，与 stdout 无关**；后台任务**静默安全**、300 s 不被回收 | 实测 |
+| 11 | ⛔ **常驻循环 ＋ 周期 echo 当不了脉冲**（永不完成 ⇒ 永不唤醒） | 实测 |
+| 12 | 交接唯一触发条件 ＝ **「登记为 main 的那条在不在活会话集合里」**；在 ⇒ 钉死，不在 ⇒ 换 | 实测 |
+
+## §3 未决 / 待用户拍板
+
+1. **🔴 唤醒落地三选项**（上一棒已问，用户未答）：
+   - ① 只留探针（上一棒的倾向）
+   - ② **外部定时器 → 网关 `runs`**（唯一能 5 分钟且 0 新会话，需单独评审）
+   - ③ idle 钩子 → `runs` 自己（闭环但最坏 1440 轮/天，且要先解决"装哪里"）
+2. **idle 探针装哪里**：项目级不生效 ⇒ 候选是改挂**全局** `E:\ProgramData\.workbuddy\settings.json` 的 `Notification`。
+   ⚠️ **属"改全局配置"，动手前必须先问用户**（本棒边界已写死）。
+3. `resolve_main` 的前缀判据缺陷 A/B（机制层，须独占锁、单独一棒）：
+   - A｜前缀判据不认方括号（代码 `startswith("主控")` 而实际标题常是 `[主控]-…`）
+   - B｜「登记还活着」短路**压过**显式前缀（正确优先级应为 显式前缀 > 登记 > 最近活动）
+4. `stop-collab.py::_gw_port()` 会把 `20090`（设备接入垫片）误认成网关（真网关 56975）。
+
+## §4 当前状态与命令
+
+- **协作机制现指向休眠中的主会话 `67dfd365`** ⇒ 投递会「拒投（loud）」。⛔ 别动它、别改它标题。
+  本棒新会话标题以 `主控` 开头 ⇒ 它一跑起来 `resolve_main()` 会自动切到它（走 `prefix:主控`）。
+  ⚠️ 一次性自动化起的会话**跑完即 `completed`**：它作为 main 只在运行期间有效；要长期接管须在桌面上打开它。
+- **四条闸门已全部补回且当天有真实调用**（收口 / 技能 / 限流 / 锁）。`state.py` 的 `[闸门]` 段一行看全。
+- 开工三件套：
+  ```
+  python E:\ProgramData\AIProject\ai1net-dsh-server\state.py
+  bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" --claim-exec "<会话名>"
+  bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" --release-exec "<会话名>"
+  ```
+
+## §5 出处（按需读，别整读）
+
+- `交付物/查唤醒为什么断-结论-20260930.md` ｜ `交付物/唤醒的解决方式-官方文档核对与方案分析-20260930.md`（**§11**＝"5 分钟做不到"的源码依据）
+- `交付物/唤醒-本机网关直连测试-20260930.md` ｜ `交付物/唤醒-会话自建后台任务方案评估-20260930.md`
+- `交付物/唤醒-idle钩子破解-20260930.md` ｜ `交付物/唤醒交接-机制能否跟着换主会话-20260930.md` ｜ `交付物/补回三个闸门-20260930.md`
+- 历史全文：`.workbuddy/memory/2026-09-30.md`（同日多棒都在里面，按小节标题找）｜自动化记忆：`.workbuddy/memory/automations/fb113c35-2cbe-45f0-afb3-4dbf0b1b4ea6/memory.md`
+- 探针脚本：`.workbuddy/tools/idle-hook-probe.py`｜探针数据：`tmp/_idle_hook_probe.jsonl`｜项目级配置：`.codebuddy/settings.json`

归档/接续历史/会话机制/接续包_域锁释放缺陷修复_20260925.md

@@ -0,0 +1,76 @@
+# 接续包 · 域锁释放缺陷修复 · 2026-09-25
+
+> 🔄 **本包已于 2026-09-25 22:2x 更新（第 35 棒执行后）** —— 新 md5 记在 `dsh-server-docs/04-调整方案/150-…md` §八（未写入本包，避免自指矛盾；下一条接续 prompt 必须用新值，否则会被 ①b 门禁拦下）。
+> **一句话结论**：修复与自证 **全部验证通过（26/26）**，规则载体 **已同步 6 处**，档案 **已建（`04-调整方案/150-…`）**；**唯一开口 = 提交/推送**，用户已拍板**「等别线归位再提交」**⇒ **本线暂无可自决动作、不再排接续棒**。
+> ⛔ 读本包请以「二、在途」标题下的**状态速览**为准；其下的四条原文是 09-25 20:55 的原始记录，**已被速览覆盖**。
+
+## 接续点 · 域锁释放线 · 2026-09-25 20:55
+- 来源会话: aliyun-dsh-server（本条已完成核心修复）  |  结束原因: 水位 32.9 万 token 强制收口
+- 原目标: 用户原话「**需要把这个问题解决掉，看看怎么优化合适。**」（"这个问题" = 我在上一轮报的缺陷：`handoff-guard.sh --release-exec` 不带会话名时会把**所有人**的域锁一起删掉，实测已误删他会话 `p33-exec-plugin-dataline` 的锁）
+- 基线: HEAD=e6207aa（D:/github/dsh_shenxian，本轮未 commit）  |  远端 master=未推送  |  域锁=**无**（本会话已等效释放）  |  服务器侧操作锁=无
+- 产物（新会话必须逐一确认存在）:
+  - `D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh`（**已修**，三条释放路径都加了归属校验）
+  - `E:/ProgramData/AIProject/ai1net-dsh-server/tmp/selftest-release-exec.sh`（**自证脚本**）
+- 校验命令: `bash -n "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" && bash "E:/ProgramData/AIProject/ai1net-dsh-server/tmp/selftest-release-exec.sh" | tail -5`
+  → 期望输出: `bash -n OK` ＋ `自证结论：✅ 全部通过`（若出现 1 项失败＝**已知项**，见下「未完成」③，先读再判）
+
+## 一、已完成（⛔ 不要重做）
+1. **缺陷定位**：`--release-exec` 的判据 `[ -z "$_who" ] || [ "$o" = "$_who" ]` —— ME 未设时前半**恒真** ⇒ 遍历 `.locks/*` 删掉**所有会话**的域锁。另有不对称：`--claim-exec` 用 `$2` 传会话名，而 release 只认 `ME` ⇒ 照 claim 姿势写会被**静默忽略**。
+2. **修法（fail-closed）**：会话名取 `ME` 或 `$2`（与 claim 对称）；都取不到 ⇒ **拒绝释放 + 打印正确用法 + 退出码 1**（⛔ 不再"静默成功"也不默认清空）；释放只删 OWNER 与本人相符的锁，并在有他人锁时明示「按 R9 未动」。
+3. **同类缺陷一并修**（同一份文件、同一类"release 成了绕过 R9 的后门"）：
+   - `--release-skeleton <资源名>`：原先按名字直接 `rm -rf`，任何会话知道资源名即可删他人骨架锁 ⇒ 现加归属校验。
+   - `--release-publish`：同上 ⇒ 现加归属校验。
+   - 两条都保留**防卡死例外**：`OWNER == 本机 whoami`（＝claim 时没记会话名的历史锁）允许清理，否则锁永久无人可放。
+4. **自证已跑**：`tmp/selftest-release-exec.sh` 覆盖 A–G 七组共 21 项断言（域锁/骨架锁/发布锁 × 不带名·名不匹配·持有者本人；含 `ME=` 老姿势兼容与 whoami 例外）⇒ **可验证的 20 项全绿**。第 21 项（发布锁"持有者本人⇒已释放"）在**本会话无法完成**，原因见「未完成」③。
+5. 记忆已落：`.workbuddy/memory/2026-09-25.md`（两段：浮层动画上线 + 本缺陷）。
+
+## 二、在途 / 未完成（用户要的优先于 AI 自加的收尾）
+
+### ✅ 状态速览（2026-09-25 22:2x · 第 35 棒执行后 —— **以此为准**）
+
+| # | 原事项 | 现状 |
+|---|---|---|
+| ① | 规则载体未同步 | ✅ **已完成** —— 实改 **6 处**：库 `CODEBUDDY.md`｜工作区 `CODEBUDDY.md` §6 两处（**快照之源**）｜`08-skills/dsh-env-bootstrap/references/常驻规则-快照.md`（**由源重生成** 6251 字符，⛔ 未手改）｜`08-skills/agent-operating-rules/references/02-工作区纪律.md`（＋**新增**「护栏耗尽 ⇒ `mv` 等效释放」条目）｜`03-多棒接力编排.md`｜`dsh-change-workflow/references/07-并行调度详解.md`｜`dsh-auto-handoff-chain/SKILL.md`。统一改法 = `--release-exec "<会话名>"`（与 claim 侧对称） |
+| | | ⛔ **刻意未改 2 处（引文保真）**：`02-工作区纪律.md`／`常驻规则-快照.md` 里各一处 `--release-exec` 出现在**对 guard 输出文案的引用**中（改了会与工具实际输出不一致）；`handoff-guard.sh` 自身提示文案（误用时已在 L268–269 打印正确用法）⇒ **不做级联改动** |
+| | | ✅ 三处一致性：**本机 = 库 5 文件 md5 全同**（`1a679fde…`／`fcfbcc90…`／`ea371632…`／`d50b7eb3…`／`c33ad986…`）｜⚠️ **服务器镜像整体滞后**（报 21 不一致 / 3 仅本地，本棒仅占 6）⇒ **未单独回推**，属**独立待办**｜⚠️ `dsh-change-workflow/SKILL.md` 有 1 处**逆向**差异（本机比库多 2 条 09-25 教训）⇒ 非本 lane，只报告 |
+| ② | 档案未写 | ✅ **已完成** —— `dsh-server-docs/04-调整方案/150-域锁释放归属校验修复与载体同步.md`（号位 149→**150**，三位零填充）。⚠️ 派生件 `docs-manifest.json`／`INDEX.md §二` 待**随提交**重生成（该表含 commit 列） |
+| ③ | 自证第 21 项跑不完（护栏耗尽） | ✅ **已跑通，环境限制消除** —— 新会话护栏额度是满的 ⇒ `tmp/selftest-release-exec.sh` **通过 26 / 失败 0**（「自证结论：✅ 全部通过」）。**真因确认 = 护栏按会话计数，⛔ 非代码缺陷**。结论已写进档案 §三 与技能 |
+| ④ | 未 commit / 未 push | 🔴 **仍未提交 —— 用户 2026-09-25 22:2x 拍板「等别线归位再提交」**（在「现在存」与「等别线归位」两案中选后者）⇒ **本棒不提交**。两条阻塞均非本棒可自消：ⓐ `PUSH=1` 硬判定 **rc=1「不可放行」**（3 个「仅本地」幽灵文件全属**插件投放与分库线**的会话交接单）；ⓑ 6 个载体里 2 个**混有「规则载体压缩 09-24」线已完成未提交的改动**（`dsh-auto-handoff-chain/SKILL.md` ≈46 行、`常驻规则-快照.md` 132 行）⇒ 单独提交会裹入别线成果（§4 只 add 自己改的） |
+
+📌 **本线不再排接续棒** —— 唯一开口（提交）受别线阻塞，**非本棒可自决**；待条件满足（别线幽灵文件归位 ＋ 「规则载体压缩线」未提交改动明确入库口径）后再一次性提交，届时清单一并处理：本棒 6 载体 ＋ 档案 150 ＋ 上一棒遗留的 `07-scripts/handoff-guard.sh`、`assets/inject/recovery.js`、`web/wake.html`。
+
+---
+
+### 原始记录（2026-09-25 20:55 · 已被上方速览覆盖，留档）
+① 🔴 **规则载体未同步**（**必做**，否则新会话照旧载体执行会被新逻辑拒绝）：活载体里写「完工 → `--release-exec`」的处（实测命中：`CODEBUDDY.md` L61；`08-skills/agent-operating-rules/references/02-工作区纪律.md` L51、L55；`03-多棒接力编排.md` L65、L94；`dsh-change-workflow/references/07-并行调度详解.md`；`dsh-auto-handoff-chain/SKILL.md` L183、L213、L331；`08-skills/dsh-env-bootstrap/references/常驻规则-快照.md` L96、L105）**都要补齐"带会话名"**（最小改法：把 `--release-exec` 写成 `--release-exec "<会话名>"`，与 claim 侧写法对称）。⚠️ **`常驻规则-快照.md` 是生成物** ⇒ 改完源（CODEBUDDY.md）后跑 `dsh-env-bootstrap` 的 `resident-rules.py --snapshot` 重新生成，⛔ 不要手改。改前先按域锁规矩抢锁（`CODEBUDDY.md` / `07-scripts` 属机制层）。
+② 🔴 **档案未写**：本轮只落到接续包 + 日志，**未在 `dsh-server-docs/04-调整方案/` 建档案**（收口预算不够，且建档案要**原子占号**）。补一档记「缺陷→改法→自证→跨载体扫描结果」。
+③ ⚠️ **自证第 21 项无法在本机验证（环境限制，非代码缺陷）**：本会话的 **safe-delete 批量护栏额度已耗尽** ⇒ 任何 `rm -rf` 都会被 `safe-bin/rm` 拦住并**挂起至超时**。后果有二：
+   - 最后一项断言（发布锁归属匹配时真删除）跑不完；但**同构的骨架锁成功路径已在 E 组验证通过**（两条分支代码同形）。若要拿到该断言的真读数 ⇒ **在新会话里跑**（护栏按会话计数，新会话额度是满的）。护栏阈值变量真名 = **`CODEBUDDY_SAFE_DELETE_BULK_GUARD`**（⛔ 我上一轮设的 `_BULK_THRESHOLD` 是**错的**，实测无效）。
+   - 🔴 **顺带查实一条会咬人的运维事实**：**护栏耗尽后，`--release-exec` 连"自己的锁"也放不掉**（本轮实测两次 rc=124 超时）。本项目既定处置 = **`mv` 把锁目录改名移走**（走 ENOENT 快路径、零删除）——本轮就是这么等效释放的。⚠️ 这条**该写进技能**（`dsh-change-workflow` 或 `agent-operating-rules`），否则下一个跑完一轮的会话会在收尾时卡死。
+④ 仓库**未 commit / 未 push**：改动落在 `D:/github/dsh_shenxian`（`07-scripts/handoff-guard.sh`），另有本轮早前的浮层动画 2 文件（`assets/inject/recovery.js`、`web/wake.html`）与本条一起在 `git status` 里等提交。⚠️ 提交前先 `git status` **只 add 自己改的**。
+
+## 三、下一步
+> 🔴 **本线已无待执行动作**（①②③ 已完成，④ 已按用户拍板「等」）⇒ **以下为历史步骤，勿照做**，仅保留供"回头提交"时参考。
+1. ~~先跑「校验命令」确认修复与自证都在位~~ ✅ 已跑：`bash -n OK` ＋ **26/26 全绿**。
+2. ~~抢锁~~ ✅ 已持并**反序释放**（域锁 ＋ 骨架锁 `handoff-guard-release-exec`，会话名 `p35-exec-lockfix`；两次 rc=0，**未触发 124 ⇒ 未用 `mv` 等效释放**）。
+3. ~~做「在途」①②，再补跑第 21 项断言~~ ✅ 已完成。
+4. ⏸️ **提交/推送（唯一未做项，待条件）**：等别线归位后 → `git status` → 只 add 清单内文件 →（推送前抢 `--claim-publish`）→ commit → 推送前对账。
+5. ✅ 释放锁一律带会话名：`ME="<本会话名>" bash 07-scripts/handoff-guard.sh --release-exec`；被护栏拦住（rc=124）⇒ 用 `mv` 等效释放并在回报写明。
+
+
+## 四、关键决定（已定项，⛔ 别推翻重来）
+1. **取 fail-closed，不取"安静降级"**：取不到会话名一律拒绝释放。理由：域锁的全部意义是防并发写，而"静默清空"会在两个会话间开出同时写入的窗口（本轮已实际发生）。
+2. **不关护栏、不 self-approve**：本轮全程未禁用 safe-delete、未改护栏状态文件；被拦时改用 `mv`（项目既定处置）。
+3. **`$2` 与 `ME` 同时接受**（对称性修复），而不是只保留 `ME` ⇒ 让既有姿势与 claim 侧一致，降低误用面。
+4. **whoami 例外必须保留**：否则"claim 时没记会话名"的锁将永久无法释放（比误删更糟）。
+5. **档案留到接续棒**：强制收口下优先保"代码已修 + 自证在 + 状态落盘"，档案与载体同步交下一棒（已在「在途」写明）。
+
+## 五、回滚点
+- `git -C D:/github/dsh_shenxian checkout -- dsh-server-docs/07-scripts/handoff-guard.sh`（回到改动前；⛔ 会连带丢掉本轮修复）
+- 备份目录（本轮早前上线用的）：`/opt/dsh/backups/anim-dot-20260925_200211/`（那是**浮层**那笔的回滚点，与本条无关）
+- 等效释放时被 `mv` 到 `/tmp/quarantine-locks/` 的锁目录（含本会话自己的域锁与骨架锁）—— 已验证不是他人锁，可留可清。
+
+## 六、⛔ 不要重做
+- 不要再"重新定位"这个缺陷（它已修好，且修法见「已完成」2/3）。
+- 不要把 `CODEBUDDY_SAFE_DELETE_BULK_THRESHOLD` 当护栏阈值变量（**名字是错的**，真名见「未完成」③）。
+- 不要动 `p34-exec-plugin-dataline` 等**他会话**的锁（R9）。

归档/接续历史/会话机制/接续包_引用与技能纠偏_20260924.md

@@ -0,0 +1,212 @@
+# 接续包 · 引用与技能纠偏
+
+> **工作区**：`E:\ProgramData\AIProject\ai1net-dsh-server`
+> **线名**：引用与技能纠偏线（承接「文档库结构治理」线的收官成果）
+> **建包**：2026-09-24 08:2x　**建包会话**：`整理收官1`
+> **本包地位**：本线**唯一依据**。开工先读 §5（动作序列），§4 只读不动。
+
+---
+
+## §0 一页速览
+
+| 项 | 内容 |
+|---|---|
+| **目标** | 把「引用 / 技能 / 规则」三类面修到**全部正常**；规则已绿，本棒只修**引用**与**技能**两类 |
+| **病根 1** | 工作区 09-23 20:12 由 `AI技能\` 改名 `AIProject\` ⇒ **153 文件**仍写旧路径 |
+| **病根 2** | 09-24 06:0x「文档库目录加序号前缀」批量改名**在 `08-skills/**` 内过度替换** ⇒ 库 ↔ 本机 **8 技能 / 16 文件**不一致 |
+| **本棒范围** | 只改「必改」档（工作区 15 件 ＋ 文档库 15 件）；历史件一律不动 |
+| **验收** | 文档库自检四件套 rc=0 ＋ 双端对账 289/289 ＋ 技能三处归一化 md5 **12/12 全同** ＋ 「必改」档旧路径残留 **0** |
+| **体检报告** | `交付物/引用技能规则-体检报告-20260924.md`（本包的证据来源，冲突以本包为准） |
+
+---
+
+## §1 开工四步（顺序不可换）
+
+1. **跑状态**：`"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" "E:/ProgramData/AIProject/ai1net-dsh-server/state.py"`
+   ⇒ 只读**本线**那段；跑完之前 ⛔ 不许 Glob/Grep 全库摸底。
+2. **校验本包口径**：`md5sum 接续包_引用与技能纠偏_20260924.md` 必须 = **automation prompt 里给出的那个值**（本包**不自述 md5** —— 自述即自指，写进去就变；校验值一律放 prompt 与 automation 记忆）。
+   不符 ⇒ 停手报告「口径已更新，需重新接续」。
+3. **抢锁**（先判定再抢）：
+   ```
+   bash D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh --claim-exec "<你的会话名>" \
+     --domains "dsh-server-docs/08-skills" "dsh-server-docs/01-规范" "dsh-server-docs/07-scripts" "dsh-server-docs/INDEX.md"
+   ```
+   ⚠️ 动文档库**与走哪个工具无关** —— 即使只用 Edit / Write 也要先抢到锁。
+   💡 若判定当日已有会话在同域开工而抢不到 ⇒ **先做 §5-A（工作区侧，不占文档库锁）**，把不冲突的部分做完，最后一次性报告。
+4. **读库内 `CODEBUDDY.md` 的「文档库结构与命名规则」章**（违反即返工）。
+
+---
+
+## §2 病根与判据（两条，必须分清）
+
+### 判据 A —— 旧的**工作区根**路径
+
+**旧**：`E:\ProgramData\AIProject\ai1net-dsh-server`（及兄弟 `_tools` / `dsh-ai1net-github` / `dsh-ai1net-capability` / `_skill_归档_去AI味_20260920`）
+**新**：`E:\ProgramData\AIProject\…`（同名同级，仅顶层目录名变）
+**实测**：`E:\ProgramData\AI技能` **GONE**；`E:\ProgramData\AIProject` **EXIST**（mtime 09-23 20:12）。
+
+### 判据 B —— **过度替换**（本条最易误判）
+
+09-24 06:0x 的批量改名是 **纯子串替换**，把**不属于文档库**的通用目录名也加了序号前缀：
+
+| 目标属谁 | 正确写法 | 被误改成 |
+|---|---|---|
+| 文档库自己 | `07-scripts/` `08-skills/` `01-规范/` `05-交接单/` | ✅ 正确 |
+| **平台代码仓** `D:\github\dsh_shenxian\` | `scripts/` | ❌ `07-scripts/` |
+| **用户级技能目录** `E:\ProgramData\.workbuddy\` | `skills/` | ❌ `08-skills/` |
+| **技能自身**（如 `短视频工作台/scripts/…`，第三方技能库） | `scripts/` | ❌ `07-scripts/` |
+| **API / URL 路径** | `/api/skills/shared` | ❌ `/api/08-skills/shared` |
+| 别的项目的约定目录名 | `规范/` `交接单/` | ❌ `01-规范/` `05-交接单/` |
+
+**决定性证据（存档，勿重做）**：
+
+| 库侧（错） | 本机侧（对） | 探针结果 |
+|---|---|---|
+| `bash 07-scripts/install-egress-guard.sh` | `bash scripts/install-egress-guard.sh` | 脚本实体在 `D:\github\dsh_shenxian\scripts\install-egress-guard.sh`；文档库 `07-scripts/` 下**无此文件** ⇒ 本机对 |
+| `~/.workbuddy/08-skills/` | `~/.workbuddy/skills/` | 实测真实目录 = `E:\ProgramData\.workbuddy\skills\` ⇒ 本机对 |
+| `/api/08-skills/shared` | `/api/skills/shared` | 09-24 06:4x 已修过同类 1 处（`src/host/skills/plugin.ts`）⇒ 同一 bug 的漏网 |
+
+🔴 **判据 = 「这条路径的目标到底属谁」** —— **不是**看哪边"更新"。
+
+---
+
+## §3 现成证据（⛔ 别重做，直接用）
+
+### 3.1 旧路径影响面（`grep -rl "AI技能"`）
+
+| 位置 | 件数 | 处置 |
+|---|---|---|
+| 工作区 `.workbuddy/tools/**` | 4 | 🔴 改（脚本常量） |
+| 工作区 `.workbuddy/待落地/**` | 2 | 🔴 改 |
+| 工作区根 `CODEBUDDY.md` `README.md` 3 接续入口 1 接续包 | 6 | 🔴 改 |
+| 工作区 `交付物/**` | 7 | 2 件改（`插件建库权限-一次性执行.sh` 等可执行件）／5 件档案不改 |
+| 工作区 `docs/覆盖网络/**` | 2 | 🔴 改（活参数表 ＋ 活跃方案） |
+| 工作区 `docs/会话与接续|插件与平台|调研与审计/**` | 5 | ⛔ 不改（09-16/09-10 证据件，改了等于伪造证据） |
+| 工作区 `.workbuddy/memory/**` | 45 | ⛔ 不改（append-only） |
+| 工作区 `归档/**` `.workbuddy/session-sync/**` `*.log` `backups/*.db` | 34 | ⛔ 不改 |
+| 文档库 `08-skills/**` | 8 | 🔴 改（命令模板 ＋ 脚本常量） |
+| 文档库 `01-规范/**` | 3 | 🔴 改（规范正文） |
+| 文档库 `07-scripts/**` | 4 | 🔴 改（docstring / 注释，应对齐） |
+| 文档库 `INDEX.md` `BRIEF.md` | 2 | 🔴 改 |
+| 文档库 `05-交接单/**` | 21 | ⛔ 不改（正文不回改） |
+| 文档库 `04-调整方案/**` | 8 | ⛔ 不改（过程档案不回改） |
+| 本包 ＋ `交付物/引用技能规则-体检报告-20260924.md` | 2 | ⛔ 不改（正文里 `AI技能` 是**旧名的叙述**，不是待执行路径） |
+
+> 🔎 **验收口径**：§5-C 第 1 条「必改档残留 0」**不含**上表 ⛔ 档，也不含本包与体检报告这份「叙述旧名」的两件 —— 统计时请用 §3.1 的逐条清单，⛔ 别用 `grep -rl` 的全量计数（全量必然不是 0）。
+
+### 3.2 技能库 ↔ 本机 差异（8 技能 / 16 文件，**库侧全部较新 = 09-24 06:0x**）
+
+```
+agent-operating-rules/SKILL.md, references/02-工作区纪律.md, references/03-多棒接力编排.md
+dsh-auto-handoff-chain/SKILL.md
+dsh-change-workflow/references/03-沙箱与技能机制.md, 05-插件与数据源口径.md,
+                              06-实例可见面与共享边界.md, 08-浏览器验证栈详解.md
+dsh-decision-method/references/素材库-A-AI推理.md, 素材库-U-用户决策.md
+dsh-desktop-dev-shell/SKILL.md
+dsh-env-bootstrap/SKILL.md, scripts/resident-rules.py
+dsh-knowledge-upkeep/references/10-技能重组-千行技能拆分.md
+dsh-opensource-release/references/01-保留移除与脱敏口径.md, 03-实测坑.md
+```
+✅ 全同（不动）：`dsh-architecture-lifecycle` `dsh-feature-first` `dsh-instance-diagnose` `dsh-plugin-diagnose`
+
+**复算命令**（一行，勿手写替代）：
+```bash
+"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" - <<'PY'
+import os,hashlib
+L=r"D:/github/dsh_shenxian/dsh-server-docs/08-skills"; H=r"E:/ProgramData/.workbuddy/skills"
+def t(r):
+    d={}
+    for dp,_,fs in os.walk(r):
+        for f in fs:
+            p=os.path.join(dp,f); d[os.path.relpath(p,r).replace('\\','/')]=hashlib.md5(open(p,'rb').read().replace(b'\r\n',b'\n')).hexdigest()
+    return d
+for n in sorted(x for x in os.listdir(L) if os.path.isdir(os.path.join(L,x))):
+    a,b=t(os.path.join(L,n)),t(os.path.join(H,n))
+    bad=[k for k in set(a)&set(b) if a[k]!=b[k]]
+    print(("✅" if not bad and set(a)==set(b) else "⚠️"),n,len(bad))
+PY
+```
+
+### 3.3 技能内容本身也过时 2 条（与改名无关，顺手一起收敛）
+
+| 位置 | 现写 | 应为（判据 = 实测 `sessions.cwd`） |
+|---|---|---|
+| `dsh-auto-handoff-chain/SKILL.md` §⑤ | 「⛔ 只写**反斜杠＋大写盘符**」 | 09-24 代码级实测：去重键 = `path.trim().toLowerCase()`（**只小写、不统一斜杠**）⇒ 正解 = `E:/ProgramData/AIProject/ai1net-dsh-server`（**正斜杠**） |
+| 同文件 §⑤ 判据行 | `python "E:/ProgramData/AIProject/ai1net-dsh-server/state.py"` | 旧路径，且与本文件上一行「反斜杠」自相矛盾 ⇒ 一并改 |
+
+⚠️ 本条与工作区 `MEMORY.md` 状态层已一致（MEMORY 已是新口径）⇒ **要改的是技能，不是 MEMORY**。
+
+---
+
+## §4 只报告不动（本棒不改）
+
+- 工作区根 4 条接续入口 ＋ 2 份接续包的**内容质量**（是否有过时结论）—— 只登记，不改。
+- `05-交接单/**` `04-调整方案/**` 内旧路径 —— 按「正文不回改」纪律，只统计不回改。
+- 服务器 `/opt/dsh/docs` 侧：本棒**不动服务器**（双端对账保持 289/289 即可）；若 §5-B 改了库而需要推镜像，**只报不改**，另排一棒。
+
+---
+
+## §5 动作序列（本棒唯一要做的）
+
+### A. 工作区侧（不占文档库锁，可先做）
+
+1. **A1 旧路径** —— 对 §3.1 表中标 🔴 的**工作区**条目（约 15 件）做 `AI技能` → `AIProject`：
+   ⚠️ 只替换**路径字面**；同文件里若出现「AI技能」是**目录名连字符化示例**（如 `extract-user-voice.py` 注释里的 `e-ProgramData-AI技能-…`）要**一并对齐**到新名（转录目录名会随工作区改名而变）。
+   ⚠️ **逐文件落盘后立刻回读**（`grep -c "AI技能"` 应为 0）。
+2. **A2 单点验证再推广** —— 先取 **1 个**对象（建议 `README.md`）改完 → 回读 → 确认无副作用，再批量。
+3. **A3 收口回读** —— `grep -rl "AI技能" <工作区>` 应只剩 §3.1 标 ⛔ 的位置。
+
+### B. 文档库侧（**先抢到锁**）
+
+1. **B1 引用纠偏（必改档 15 件）** —— 用 §3.1 清单，同 A1 的替换与回读纪律。
+   ⚠️ 改 `08-skills/dsh-opensource-release/**` 时注意：其工作根 `E:\ProgramData\AIProject\dsh-ai1net-github\` 被 **5 个工具脚本常量**引用（`_build_export.py:13` `OUT` / `_verify_tsc.mjs:5` `EX` / `_sop_check.mjs:5` `_upload_audit.mjs:5` `_verify_all.mjs:5` `W`）⇒ 改文档前**先核实这 5 处常量现状**，若它们仍指旧路径则一并对齐（那属于别的线，**只报不动**）。
+2. **B2 过度替换回改（§2 判据 B）** —— 对 §3.2 的 16 个文件，**逐条**判定：
+   - 目标属文档库 ⇒ **库侧正确** ⇒ 记入「需同步到本机」清单
+   - 目标属平台仓 / 用户级技能目录 / 技能自身 / API ⇒ **库侧错** ⇒ **回改成原字面**
+   取证方式 = **存在性探针**（`ls` 目标路径）＋ `git log -p` 看 09-24 06:0x 那次改动的原文：
+   ```bash
+   cd D:/github/dsh_shenxian/dsh-server-docs && git log --oneline -8 -- 08-skills
+   ```
+3. **B3 技能三处同步** —— B2 定完方向后：库 → 本机（`E:\ProgramData\.workbuddy\skills`）→ 服务器（`/opt/dsh/docs/08-skills`）。
+   ⚠️ 服务器侧**本棒只报不改**（见 §4）；若要同步，先确认是否已有他线在推。
+4. **B4 技能内容过时 2 条** —— 按 §3.3 改 `dsh-auto-handoff-chain/SKILL.md`。
+
+### C. 收口（必做）
+
+1. `grep -rc "AI技能"` 复核 → 必改档残留 **0**。
+2. 技能复算（§3.2 命令）→ **12/12 且 0 差异**。
+3. 文档库自检四件套 ＋ 对账：
+   ```bash
+   cd D:/github/dsh_shenxian/dsh-server-docs
+   for s in docs-consistency.py docs-audit.py docs-archive-index.py handoff-status.py; do
+     "E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" "07-scripts/$s" >/dev/null 2>&1; echo "$s rc=$?"; done
+   bash 07-scripts/docs-sync-check.sh | tail -6
+   ```
+   期望：四个 rc=0 ＋ 双端 289/289。
+4. **释放锁**：`handoff-guard.sh --release-exec`
+5. 追加本包 §6 执行记录；工作区侧改动可 commit（**文档库侧 ⛔ 未获授权不 commit / 不 push**）。
+
+---
+
+## §6 执行记录（各棒追加）
+
+- **2026-09-24 08:2x｜建包棒（会话 `整理收官1`）** —— 只做体检与建包，不落修复。产出：`交付物/引用技能规则-体检报告-20260924.md` 本包。规则已绿（四件套 rc=0 ＋ 对账 289/289）；引用与技能各 1 类缺陷已定位到判据与逐文件清单。
+- **2026-09-24 08:1x–08:5x｜执行棒（会话 `引用纠偏1`）** —— §5 全做完，锁已释放。
+  **① 开工四步**：`state.py` ✅｜本包 md5 = `ab17bde7bb65782d10be7d122546a8c5` **相符** ✅｜抢锁成功（4 域：`08-skills` / `01-规范` / `07-scripts` / `INDEX.md`）✅｜库内 `CODEBUDDY.md` 「文档库结构与命名规则」章已读 ✅。
+  **② A 工作区侧（16 件，逐文件）**：`CODEBUDDY.md`｜`README.md`｜`接续入口_IM线` (12 处)｜`接续入口_技能重组线` (2)｜`接续入口_插件投放与分库线` (1)｜`接续包_文档库治理_20260923.md` (2)｜`.workbuddy/tools/{find-session-by-title,guard-replay,sess-credit-report}.py ＋ relay-transfer.sh` (含连字符化转录目录名 `e-ProgramData-AI技能-…` 一并对齐)｜`.workbuddy/待落地/{verify-stop-hook.py,重启后待办.md}`｜`docs/覆盖网络/{参数表,设备登录接入方案}`｜`交付物/{插件建库权限-一次性执行.sh, DB修复-workbuddy.db损坏诊断与方案}.md` ⇒ **该 16 件 `grep -c "AI技能"` 全 = 0**；单点验证先做 `README.md` 再推广。
+  ⚠️ **口径与 §3.1 的两处差异（以实测为准）**：ⓐ 工作区「必改档」实测 **16 件**（§3.1 写 12 件，未含 `docs/覆盖网络` 2 ＋ `交付物` 2）；ⓑ `交付物/**` 实测 9 件含旧路径（非 7），按「含可执行命令者改」判 **2 件改 / 7 件不改**（不改的含体检报告本身）。
+  **③ B 文档库侧**：
+  - **B1 引用纠偏**：`08-skills` 8 ＋ `07-scripts` 4 ＋ `01-规范` 2（`01-规划与架构.md` 改到现真源 `D:/github/dsh_shenxian/dsh-server-docs/`；`06-工作台UI规范.md` 3 处）＋ `INDEX.md` ＋ `BRIEF.md` = **16 件落地**。
+  - **B2 过度替换回改**：逐条按「目标属谁」判 ＋ 存在性探针。**库侧错 ⇒ 回改 12 件**：`/api/skills/{shared,mine}`、`~/.workbuddy/08-skills/`、`DSH_HOME` 的 `skills/`、`presets/<p>/skills/`、技能自身 `scripts/`（`短视频工作台`/`split_skill.py`/`chain_report.py`/`resident-rules.py`）、官方仓 `native/system/scripts/`＋`apps/desktop/scripts/`、**平台仓** `scripts/`（探针：`install-egress-guard.sh`/`install-python-runtime.sh`/`install-shared-tools.sh`/`runtime-baseline.cjs`/`verify-inject.cjs`/`verify-dsh-install.mjs` **全部只在 `D:\github\dsh_shenxian\scripts\`**）。**库侧对 ⇒ 补到本机 4 件**：`05-交接单/`、`01-规范/06-工作台UI规范`、`bash 07-scripts/handoff-guard.sh`、`07-scripts/extract-user-voice.py`（探针：`handoff-guard.sh` 只在文档库 `07-scripts/`）。
+  - **B3 三处同步**：本机 `~/.workbuddy/skills` ↔ 库 `08-skills` **12/12 md5 全同 · 0 差异**（方向 = 本机为工作副本 ⇒ 推库，符合库内 README 的「单向推进 本机 → 此处」口径；库侧 06:0x 那批改动内容上仅「改名」一处，未丢内容；`dsh-auto-handoff-chain` 库侧为 09-21 旧版 ⇒ 以本机 09-23 新版为准）。**服务器 `/opt/dsh/docs/08-skills` 按 §4 只报不改**。
+  - **B4 技能内容 2 条**：`dsh-auto-handoff-chain/SKILL.md` 律⑤ 改为「**只写与手动开会话 cwd 逐字同形；判据 = 实测 `sessions.cwd`；当前正解 = `E:/ProgramData/AIProject/ai1net-dsh-server`（正斜杠）**」＋ 标题行/判据行/自查行 ＋ 🔴 **frontmatter `description` 同步改**（依据该文件自身「教训二：改路径字面必须枚举全部复制面，漏 `description` ⇒ 曝光度最高」）；§⑤ 判据行命令路径同步 `AI技能`→`AIProject`。`version` 未动（仍 1.7.2）。
+  **④ C 收口**：四件套 **rc=0 ×4** ✅｜技能复算 **12/12 · 0 差异** ✅｜旧路径「活路径」残留 **0**；**保留 12 处历史叙述**（`dsh-auto-handoff-chain` 6：污染源/迁移对照/连字符化示例｜`dsh-opensource-release/SKILL.md` 2：frontmatter 版本历史 ＋ 用户原话引用｜`dsh-change-workflow/references/00-平台速查.md` 1：勘误引述旧文｜`01-规范/03-路线图与待办.md` 3：历史迁移条目）—— 判据 = 「照着做会失败的活路径」改、「记录当时事实」不改。🔴 **对账 = 文件数 289/289 一致，但内容 263/289**（**26 件不一致 = 本次改库而按 §4 未推服务器的必然结果**）。锁已 `--release-exec` 释放。
+  ⚠️ **本棒不改、只报（§4）**：ⓐ 推镜像 26 件到 `/opt/dsh/docs`（清单见对账输出）ⓑ **`E:\ProgramData\AIProject\dsh-ai1net-github\` 5 常量 ＋ 1 命令模板仍指旧根**（`_build_export.py:14,763`｜`_verify_tsc.mjs:5`｜`_sop_check.mjs:5`｜`_upload_audit.mjs:5`｜`_verify_all.mjs:5`）⇒ 旧根已 GONE、**这些脚本现已失效**，属别的线 ⓒ 服务器 `08-skills` 落后本机一版。
+  🔧 **工具教训（可复用）**：改同一文件的多处字符串时，**必须先把所有替换聚合到内存再一次写盘** —— 逐条 `open(...,"wb")` 会让后一条覆盖前一条（本轮首跑即踩，52 项写入只生效每文件最后一项，靠 `12/12` 复算才发现）。配套：命中数断言 ＋ 幂等（`count==0 且新串已在` ⇒ 跳过重跑）。
+- **2026-09-24 08:35–08:5x｜执行棒补修（同会话 `引用纠偏1`；用户令「需要修改的地方都修改」⇒ 上一轮标「只报不改」的两项解禁）**
+  - **① 推镜像到服务器**（原 §4「服务器只报不改」）：26 件（`08-skills` 20 ＋ `07-scripts` 4 ＋ `01-规范` 2 ＋ `INDEX.md`/`BRIEF.md`）用 **`ssh bt-server "cat > <目标>"`**（不动服务器侧属性）推送 ⇒ **对账 289/289 · 双端一致 ✅**（原 263/289、26 件不一致）；**服务器侧权限经实证保持 `root:root 600`**（`ls -l` = `-rw------- 1 root root`）。
+  - **② `dsh-ai1net-github` 开源工作根旧根常量**（原标「属别的线，只报不动」）：`AI技能`→`AIProject`，**范围判据 = 可执行脚本 ＋ json 配置**（`.py/.mjs/.js/.cjs/.sh/.json`）⇒ 落地 **54 文件 / 57 处**，含 5 个工作根常量（`_build_export.py:14` `OUT`｜`_verify_tsc.mjs:5` `EX`｜`_sop_check.mjs:5` / `_upload_audit.mjs:5` / `_verify_all.mjs:5` `W`）＋ `_build_export.py` 命令模板；`.md`（台账 / 评估 / README）与该根 `.workbuddy/memory/**` **按叙述件纪律不动**。复核：该根脚本/json 内 `AI技能` 残留 **0**，六个关键常量全部指向 `E:\ProgramData\AIProject\dsh-ai1net-github`。
+  - ⚠️ **副作用披露**：上述扫描覆盖到该根 `_中间产物_待清理/**`（临时脚本）与 `_archify/evidence/*.visual-check.json`（取证 json，属待清理件）—— 已一并改；该根 `.md` 里仍有旧根字面（未动），留该线自理。
+  - **三处同步闭合**：本机 `~/.workbuddy/skills` → 库 `08-skills` → 服务器 `/opt/dsh/docs/08-skills` 逐字一致（服务器残留复核 = 与库同 9 处历史叙述）。
+
+

归档/接续历史/会话机制/接续包_规则载体压缩_20260924.md

@@ -0,0 +1,128 @@
+# 接续包 · 规则载体压缩（2026-09-24 16:5x）
+
+> **工作区**：`E:/ProgramData/AIProject/ai1net-dsh-server`
+> **线名**：规则与载体线（承接「提问规则加固」＋「A 案落地」两段）
+> **建包会话**：本轮（收口时建，上下文 32 万触发强制收口）
+> **本包地位**：本线**唯一依据**。开工先读 §4（关键决定），再按 §5 第 1 条开工；§2 只读不动。
+> ⚠️ **本包不自述 md5**（自述即自指）⇒ 校验值放 automation prompt。
+
+---
+
+## §0 一页速览
+
+| 项 | 内容 |
+|---|---|
+| **目标** | 把各工作区**规则载体**压进 host 的 **8000 字符注入窗口**：必要内容留**实体**，其余转**引用**（= `MEMORY.md` 的分层法） |
+| **为什么** | host 只加载**第一个存在**的规则文件，且**单文件封顶 8000 字符**；实测本工作区 12 个章节仅 4 个进模型（红线表 / 提交边界 / 环境要点 / 事故事实**从未注入**） |
+| **本棒范围** | 先做**本工作区**（`CODEBUDDY.md` 23,756 字符 → 目标 ≤ 8,000）；desktop 同类问题**另列**（别的工作区，需先取得口径） |
+| **红线口径** | 用户问「红线能否精简」⇒ **能**：判据表（约 1,000 字符）留实体，解释段/历史/案例（约 2,270 字符）转引用。⛔ **不得把红线整表降级为纯指针**（项目既有硬口径） |
+| **验收** | 压缩后 `CODEBUDDY.md` ≤ 8,000 字符 ＋ 11 条红线**逐条可寻址** ＋ 原有判据一条不丢（逐节对照） |
+
+---
+
+## §1 目标（用户原话，⛔ 不得改写）
+
+> 「应该参考 memory 的方式，保留必要内容，其余用引用的方式，红线内容能否精简」
+
+拆成三条硬口径：
+
+- **M1**：**参考 `MEMORY.md` 的分层法** —— 判据 =「不看会不会违规/事故？会 ⇒ 写实体；只"更慢更绕" ⇒ 给指针」。
+- **M2**：**其余用引用**（指针必须给**绝对路径 + 章节号**，⛔ 不复制对方正文）。
+- **M3**：**红线可精简** —— 但见 §4-1（实体/引用的分界）。
+
+---
+
+## §2 已完成（本线前两段，全部有实测取证 · ⛔ 不要重做）
+
+1. **提问规则已落地 5 处**（复核值 = 规则在主文件内的**字符偏移**，< 8000 才算真生效）：
+   `aliyun-dsh-server` 3,087 ｜ `dsh-ai1net-desktop` 1,765 ｜ `dsh-decision-laya` 1,555 ｜ `dsh-plugin-carbon` 2,747 ｜ `dsh-plugin-forge` 3,156 —— **5 处全部在线内 ✓**。
+   落法：carbon / forge 追加；decision-laya 升级主文件内已有子节；desktop 合并进 §1。
+2. **载体机制实测三条**（`app.asar` · `project-context-section.ts` 现读，原文已在今日日志）：
+   ① 只认**工作区根**下 `CODEBUDDY.md` / `.codebuddy/CODEBUDDY.md` / `AGENTS.md`（`path.join(cwd,…)`，**无 home 级**）；
+   ② 🔴 **取第一个存在者**（`return` 在循环内）⇒ 主文件在时 `.codebuddy/CODEBUDDY.md` **永不加载**；
+   ③ **单文件封顶 8000 字符**（按字符、非字节），超出即截断。
+3. **两个死载体已撤**（我按错误假设建的 `.codebuddy/CODEBUDDY.md`）⇒ 移入 `归档/规则A-备份-20260924/DEAD-CARRIER__*`，可原样搬回。
+4. **旧路径修正**：`AI技能` → `AIProject`，desktop 3 处 / carbon 2 处 / forge 3 处，残留 **0**。
+5. **红线表可压缩性已量化**（§3 共 3,271 字符）：
+
+| 部分 | 字符 | 主张 |
+|---|---|---|
+| R1–R6 + R7 + R8/R9/R10/R11 的**判据行** | ≈ 1,000 | **留实体**（每条一行：禁令 ＋ 判据） |
+| R7-边界 解释段 | 698 | 转引用 |
+| R10 解释段 | 737 | 转引用 |
+| R9 解释段 | 433 | 转引用 |
+| R11 解释段 | 368 ＋ 69 | 转引用 |
+| R8 解释段 | 258 | 转引用（⚠️ 内含用户 09-13 口径修正，须逐句判） |
+
+---
+
+## §3 在途 / 未完成
+
+- **§3-1 本工作区 `CODEBUDDY.md` 压缩式清理** —— 23,756 → **7,905 字符**（**−67%**）✅ **目标 ≤8,000 达标**｜**章节 11/11 全在注入窗口内**（§10 已并入 §9）｜红线 **11/11** ＋ R7-边界行 · 指针无悬空 · 完好性全过。
+  **三段处置**：① 第一棒 = 分层探路 ＋ 建引用件；② 第二棒 = 零风险去重复表述（−283；11/18/24 三档阈值 ＋ 跨文件全扫已做尽）；③ 第三棒 = **用户拍板「A ＋ B」**（§7 §8 转分层引用）＋ 该精简的一并处理（§2 / §6 / §9 表述收紧 · §10 并入 §9 · 头部 meta 去重 · §7 §8 压成速查行）。
+  ⚠️ **未丢判据**：§7 / §8 正文原样存于引用件 **§D / §E**，§9 / §10 存于 **§G ＋ §H**（压缩前全文）。
+- **§3-2** desktop 压缩（13,938 → 14,526 字符，§9–§11 线外）—— **别的工作区**，动手前先确认口径（用户「按 A 处理」授权的是**加规则**；压缩改写其规则正文是另一档）。
+- **§3-3** 红线引用件落点：建议 `docs/` 或 `dsh-server-docs`，须给**绝对路径 ＋ 章节号**（M2）。
+- **§3-4** 与 `docs/规范/`（文档库 01-规范）是否重复 ⇒ 动手前先查，⛔ 不造第二份正文。
+
+---
+
+## §4 关键决定（已定项，⛔ 别推翻重来）
+
+1. **红线实体/引用分界（本轮自决，可推翻）**：**判据行留实体**（禁令 ＋ 触发条件 ＋ 最易误用的一句边界），**解释段 / 历史 / 实证过程 / 案例**转引用。⛔ 依据 = 项目既有硬口径「§3 红线 R1–R11 **全表**以实体形式常驻，不得降级为指针」—— 本决定**不违反**它，只压缩表述。
+2. **分层判据一律照抄 `MEMORY.md` 那条**：不看会不会违规/事故？会 ⇒ 实体；只更慢更绕 ⇒ 指针。
+3. **载体只能用第一个存在的那个文件**：⛔ 不得新建 `.codebuddy/CODEBUDDY.md` 当"第二块额度"（已实证为死文件）。要加规则 ⇒ **必须落在前 8000 字符内**。
+4. **压缩属"改写规则正文"** ⇒ 必须逐节对照，判据 = **每条既有判据在压缩后可寻址**（逐节点名核对）。
+
+---
+
+## §5 下一步（第 1 条＝本轮动作，写死）
+
+**第 1 条 · 压缩本工作区 `CODEBUDDY.md` 的第一段**（先做最能立刻见效的一段，不追求一次到位）：
+
+```bash
+# 0) 开工四步（state.py / 本包 md5 / preflight 抢锁 / 读 §4）
+ME="<会话名>" bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" --claim-exec "<会话名>" --domains "CODEBUDDY.md" ".workbuddy/memory/2026-09-24.md"
+# 1) 备份（唯一回滚点，⛔ 不许省）
+cp "E:/ProgramData/AIProject/ai1net-dsh-server/CODEBUDDY.md" "E:/ProgramData/AIProject/ai1net-dsh-server/归档/规则A-备份-20260924/CODEBUDDY.md.before-compress"
+# 2) 量化现状（复用现成脚本）
+"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" tmp/_guidance_scan.py
+```
+
+**本棒建议动作顺序**（⛔ 一次只动一段，每段后复跑量化脚本确认线内章节数上升）：
+① §3 红线：解释段转引用 ⇒ 省 ≈ 2,270 字符；② §7 环境要点（2,353）与 §8 事故事实（3,403）去重复表述；③ §1 提问判据（4,846）与已落地规则合并去重；④ §2 指针表按「只留触发词 ＋ 路径」重排。
+**验收判据**：压缩后 `CODEBUDDY.md` ≤ 8,000 字符；`tmp/_guidance_scan.py` 显示**线内标题 = 总标题**（12/12）；11 条红线逐条可寻址。
+**现状（第二棒收官 2026-09-24 17:2x）**：10,001 字符 ｜ 线内 9/12 ｜ 红线 **11/11 ＋ R7-边界行全在** ｜ `docs/规则与载体/验收_规则载体压缩_20260924.py` 五段全过（除体积）。
+
+**⏭️ 本线状态：§3-1 已收官（2026-09-24 17:4x · 用户拍板「A ＋ B」）** —— 7,905 字符（−67%）· 章节 11/11 全进窗 · 红线 11/11 · 指针无悬空 · `验收_规则载体压缩_20260924.py` 五段全绿。**本线在 §3-1 上无待办**。
+⚠️ **§7 / §8 / §9 的实测细节只在引用件**（主文件仅存速查 ＋ 指针）⇒ 要细节读 `docs/规则与载体/规则详解_红线与实证_20260924.md` 的 §D / §E / §G ＋ §H。
+📌 可选（非必须、未做）：把 §8 的「6 条后果」恢复成半行速查（需再从别处等量收紧 200 字符）。
+
+（以下 A–D 为当时留档的决策依据，**已采纳 A ＋ B**）：
+
+**A 案 · 把 §7 环境要点 7 条降级为指针**（实体只留一行「本机环境坑 ⇒ 【详】§D」，约省 1,100）：优点 = 一次到位，§2 与 §9 一起进窗；缺点 = 环境坑是**高频踩**项（PATH / Node 22 / LF / 全角冒号），降指针后新会话要先读详件才不踩。
+
+**B 案 · 把 §8 事故事实 6 行降级为指针**（约省 900）：优点 = §8 本就是「知道就避开」型知识，天然适合引用；缺点 = §8 现被文件自身标为「**常驻，不许只给指针**」⇒ 须用户明确改这条口径，否则与文件原文冲突。
+
+**C 案 · 只砍 §2 触发词表**（把 8 条触发词合成 4 条，约省 400）：优点 = 不动任何「必须实体」章，风险最低；缺点 = 省得最少，**仍到不了 8,000**（§2 仍进不了窗），等于白做一轮。
+
+**D 案 · 接受当前形态，改目标**（不再追求「12/12 全进窗」）：优点 = 现状已达成「危险项全部常驻」（§1 §3–§8 全在窗内，含 11 条红线），工程质量已达标；缺点 = §2/§9/§10 永不被注入 ⇒ 「该查哪篇」只能靠会话自己想起来。
+
+---
+
+## §6 回滚点
+
+1. **文件级**：`归档/规则A-备份-20260924/CODEBUDDY.md.before-compress` = **23,756 字符（压缩前原文）** ⇒ 覆盖两棒全部改动，⛔ 不要覆盖它；要再备份另起名。
+2. **别的工作区**：desktop / decision-laya / carbon / forge 的改动**未 commit**，用备份目录可逐字还原。
+3. ⛔ 工作区与文档库**均未 commit / 未 push**（无授权）⇒ 本线改动只存在于工作树 ＋ 备份目录。
+
+---
+
+## §7 ⛔ 不要重做
+
+- **提问规则的 5 处落地**（§2-1）已生效，⛔ 不要重加、不要重复追加同一段。
+- **载体机制三条**已实测（§2-2），⛔ 不要再去试 `.codebuddy/CODEBUDDY.md` / `~/.codebuddy/` / `AGENTS.md`。
+- **旧路径修正**已闭合（残留 0），⛔ 不要重扫。
+- ⛔ 不要把红线整表降级为纯指针（违反既有硬口径）；⛔ 不要在压缩时丢判据。
+- ✅ **零风险去重复表述已做尽**（2026-09-24 第二棒，−280 字符：头部 / 分层判定 / §1 / §3 尾注 / §6 / §2 / §9 共 10 处合并）⇒ ⛔ **不要重扫重复**（11 / 18 / 24 字符三档阈值 ＋ 主文件 × 详件跨文件都已扫过，无剩余）。
+- ⛔ **不要在未拍板前砍判据本体**（见 §5「⏭️ 本线下一项」四个候选；用户既有口径 = 不许自行决定放哪些判据）。