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「⏭️ 本线下一项」四个候选；用户既有口径 = 不许自行决定放哪些判据）。

归档/接续历史/文档库/接续包_文档库治理_20260923.md

@@ -0,0 +1,84 @@
+# 接续包 · 文档库治理（2026-09-23）
+
+> **工作区**：`E:\ProgramData\AIProject\ai1net-dsh-server`　**线名**：插件投放与分库线（本轮为即席应答，非接续棒）
+> **触发来源**：用户连续三轮问「`dsh-server-docs` 归类 / `04-` 是什么 / 根级 01–09 是干啥的、文件夹要不要合并」
+> **性质**：**接续包（7 段）** —— 供下一棒直接开工，⛔ 不含平台代码改动。
+>
+> 🔴 **2026-09-23 23:5x 状态块（§八 部分撤销 · 以本块为准）**：§八 的 **E1（新建 `规范/`）** 与 **E2（`数据库/` 并入 `架构设计/`）** 经**实测引用面**否决，⛔ **不再执行**；执行口径改以 **`交付物/文档库整理方案-20260923.md`（定稿）** 为准，该文件取代本节 §八 的 E1/E2。§八 的 **E3/E4/E5/E6 保留**（其中 E5 拆为定稿 §5 的 D2/D3）。
+> **否决依据（实测）**：E1 需改 **21 档** —— 文档库内 4 档 ＋ **工具脚本 3 档（`docs-manifest.py` / `docs-consistency.py` / `docs-search.py`，功能性耦合非注释）** ＋ **同一技能两处副本 8 档** ＋ **在途别的线的交接单 4 档** ＋ **工作区 `CODEBUDDY.md`（机制层，改后需重启）** ＋ `DB-00` 1 档；收益仅"根目录少 7 个 `.md`" ⇒ 按 **R11 净变差即停**。E2 的 12 处引用含 **在途别的线的交接单 4 档**。原估"CODEBUDDY.md 约 10 处"偏低，实测翻倍。
+> ⚠️ **§四 第 2 条更正**：「整仓对 `ops/` 的路径引用 = **0**」**实测有误** —— `BRIEF.md` 1 处 ＋ `README.md` 2 处（E3 执行时须同步改这 3 处）。
+> 🔴 **执行状态（2026-09-24 00:2x 更新）：D1–D3 已执行完毕 ✓** —— 用户确认「重复分组修复」线锁释放后，本线 `--claim-exec "文档库治理" --domains …`（8 域）抢锁并全程持有，收口 `--release-exec` 已释放。结果：`ops/` **6 → 3 文件**（只留 `nginx/`＋`scripts/`）；`INDEX.md §二` 刷新为 **146 行**、**13 条重复行清零**、与真源一致；`调整方案/README.md` 的「当前 `01~28`」纠为 **146 篇**、单一来源改指 `INDEX.md §二`。悬空 `ops/` 引用 = **0** ✓ ｜ `docs-consistency.py` ✓ ｜ ⛔ 未 commit / 未 push。详情见 `交付物/文档库整理方案-20260923.md §7`。
+> ⚠️ **门禁盲区（本轮实测，未修）**：`preflight-lock.sh` 的【D】未归类清单把**文档库根级文件**（`INDEX.md`/`README.md`/`BRIEF.md`/`docs-manifest.json` 等）全判成未归类（其 `ok_files` 正则只覆盖 `^(src|poc|test|web|docs|scripts|交接单|skills)/`）⇒ 触及这些文件的任务**永远过不了门禁**，只能走 `--domains` 显式声明。属机制层，⛔ 未动。
+
+---
+
+## §一 目标
+
+把 `dsh-server-docs` 的**结构与命名**收敛成"能一眼看懂、能机械维护"的形态：① 根级常驻文档与收纳目录的**两层关系**讲清并有索引；② `调整方案/` 的**排序错乱**（两位/三位混排）有处置口径；③ 目录数**能合则合**（只合零代价的）。
+
+## §二 已完成（本轮 3 件，均有取证）
+
+1. **文档库归类 3 动作**（见 `交付物/文档库归类现状与方案-20260923.md`）：删 `.domains.tmp.1639` 残渣；`docs/IM插件SDK与扩展点契约.md` → 根级 **`规范/09-IM插件SDK与扩展点契约.md`**（`docs/` 空目录已撤销）；同步改指针 2 处（`交接单/IM群组-D-插件SDK与扩展点契约.md` 第 221/309 行）＋ `INDEX.md` 加 09 索引。
+2. **命名诊断 + 规范提案**（`交付物/文档库命名规范提案-20260923.md`）：147 档全 `.md`、`-` 分隔；真问题是**两位/三位混排 ⇒ 排序错乱**（实测 `10-` 后直接跟 `100-`…`109-`，`11-` 被挤后）＋ 5 个断层号（48/63/130/131/132）＋ 5 个无编号件。规范提案 = 三位零填充 / 主题一律 `-` / 编号只增不复用。
+3. **结构盘点**（`tmp/_docs_inventory.txt`）：顶层 10 目录 ＋ 根级 7 编号件 ＋ 5 入口件 ＋ 4 生成物/配置；引用面（整仓路径引用计数）= `scripts` 26 · `调整方案` 10 · `交接单` 8 · `CODEBUDDY.md` 4 · `数据库` 4 · 其余 ≤2。
+
+## §三 在途
+
+无未落盘的半成品 —— 本轮所有产物已落 `交付物/` 与文档库，且域锁已释放。
+
+## §四 未完成（下一棒的候选工作，按风险从低到高）
+
+1. **【可自决·零改名】** 在 `调整方案/README.md` 落一张**按主题分组的档案索引表**（编号 ＋ 一句话用途 ＋ 主题分组：插件投放 / 覆盖网络 / IM / UI / 部署 …）⇒ 解决"147 档找不到"与排序观感问题。⚠️ 先读该 `README.md` 现有内容，若已有索引则只补缺、⛔ 不重写。
+2. **【待拍板·低风险】** `ops/`（6 项）瘦身：`ops/域名迁移_20260919/` → `archive/`；两份 `覆盖网络接续件` → 该线或 `archive/`；`ops/nginx|scripts/` 保留。判据 = 整仓对 `ops/` 的**路径引用 = 0**。
+3. **【待拍板·中风险】** `数据库/`（DB-00~03）并入 `架构设计/`（同为"定稿规范"）⇒ 顶层目录 10 → 9；代价 = 4 处路径引用（含 `CODEBUDDY.md`、技能）＋ `docs-manifest.json` 重生成。
+4. **【待拍板·高风险】** 根级编号件建 `规范/` 目录（顶层 9 → 8）；⛔ 必须先改 `CODEBUDDY.md`（每会话自动加载，改错污染此后所有会话）并重启生效，另有 26/10/8 处引用待核。
+5. **【不建议】** `调整方案/`（过程）与 `架构设计/`（定稿）**不可合并** —— 文档分层机制的分水岭；`skills/`、`交接单/` **不可移动** —— 分别绑三处同步链路与域锁目录（`.locks` 就在其中）。
+
+## §五 下一步（下一棒的动作序列）
+
+① 跑 `state.py`，只读本线（插件投放与分库线）那段；② 读本接续包并**重算 md5 校验**；③ 抢域锁（`dsh-server-docs/调整方案` ＋ `aliyun-dsh-server/.workbuddy`）；④ **只做 §四-1**（零改名、可自决），产物落 `调整方案/README.md` 并在本线入口 §0 记一行；⑤ §四-2/3/4 **未获用户口令不得动**，只报告；⑥ 收尾释放锁。
+
+## §六 关键决定（⛔ 不得推翻重来）
+
+1. **两套编号体系是有意设计**：根级 `01/02/03/06/07/08/09` ＝ 常驻文档（每类一份）；`调整方案/NN-` ＝ 一次性改造档案（分区内流水号）。`05` **历史跳号、不补**。
+2. **⛔ 不批量重命名 `调整方案/`（147 档）**：B 方案（全量补零）会作废全部 `04-NN` 短号引用与人的记忆 ⇒ 只允许"新档照规范"。
+3. **⛔ 不合并 `调整方案/` 与 `架构设计/`**（过程 ≠ 成品的分水岭）；**⛔ 不动 `skills/`、`交接单/`**。
+4. **⛔ 未 commit / 未 push**（未获授权）；`docs-manifest.json` 未重生成（生成器 `dsh-server-docs/scripts/docs-manifest.py`）。
+
+## §七 回滚点
+
+| 对象 | 回滚方式 |
+|---|---|
+| `规范/09-IM插件SDK与扩展点契约.md` | 反向 `mv` 回 `docs/` ＋ 撤销 221/309 两处指针 ＋ 删 `INDEX.md` 那行 |
+| 被删的 `.domains.tmp.1639` | 副本在 `归档/dsh-server-docs-整理-20260923/` |
+| 上一轮仓库清理（26 tgz 等） | `归档/dsh_shenxian-清理-20260923/deleted-20260923.tar.gz` ＋ `MANIFEST.txt` |
+| 文档库 git | `git -C D:/github/dsh_shenxian checkout -- dsh-server-docs/`（⚠️ 会连带丢弃其他线的在途改动，慎用） |
+
+---
+
+## §八 🔴 最佳方案（**2026-09-23 23:2x 用户授权"按你判断的最佳方案优化" ⇒ 本节即执行令**）
+
+> 用户原话：「**分析清楚后按照你判断的最佳方案优化，优化后需要看到清晰、高效、整洁的项目目录**」。
+> ⇒ 本节为**已定稿口径**，下一棒照此执行；⛔ 不再上抛方案选择（只有"执行中撞到机制层"才停下报告）。
+
+**目标形态（`dsh-server-docs` 顶层 10 目录 → 9；根级散件 16 → 9）**
+
+| # | 动作 | 目标 |
+|---|---|---|
+| E1 | 新建 **`规范/`**，移入 7 个常驻编号件：`规范/01-规划与架构.md` `规范/02-运维手册.md` `规范/03-路线图与待办.md` `规范/06-工作台UI规范.md` `规范/07-实例UI分区登记表.md` `规范/08-插件开发与对接规范.md` `规范/09-IM插件SDK与扩展点契约.md` | 根级"书籍"归拢成一层 |
+| E2 | `数据库/`（DB-00~03）→ **`架构设计/数据库/`**（同为定稿类，保留 4 档在一起的语义）；撤销顶层 `数据库/` | 顶层 −1 |
+| E3 | `ops/域名迁移_ai1net_20260919/` ＋ `ops/接续入口_覆盖网络线_20260916.md` ＋ `ops/接续包_覆盖网络线_20260916.md` → **`archive/`**；`ops/nginx`、`ops/scripts` 留原地 | `ops/` 只剩现役物料 |
+| E4 | 根级保留 = `README.md`（总入口）· `INDEX.md`（场景索引）· `BRIEF.md`（现行事实）· `CODEBUDDY.md`（项目指令源）· `DEPLOY-本部署.md` · `docs-manifest.json` · `archive-summaries.json` · `.gitignore` · `.gitattributes` | 根 = 入口面 |
+| E5 | `调整方案/` **存量不重排**；在 `调整方案/README.md` 落**主题索引表**（编号 ＋ 一句话用途 ＋ 主题分组）；**新档一律三位编号** | 解决排序与可发现性 |
+| E6 | ⛔ **不动**：`交接单/`（域锁目录）· `skills/`（三处同步链路）· `scripts/` · `archive/`（收纳位）· `tmp/` | 机制约束 |
+
+**必改引用（执行时逐条核，改完 grep 复核零悬空）**
+1. **工作区 `E:\ProgramData\AIProject\ai1net-dsh-server\CODEBUDDY.md`** —— §2 表格里写死了 `dsh-server-docs\01-…`/`02-…`/`03-…`/`06-…`/`07-…` 等路径（约 10 处）。⚠️ **属机制层 ⇒ 必须独占锁；改后需重启会话才重载**；改前先备份。
+2. 文档库内：`INDEX.md`（场景表指向 01/02/03/06/07/08/09 的行）· `README.md` · `BRIEF.md` · `DEPLOY-本部署.md` · `交接单/插件投放与分库线-①…md` · 技能 `dsh-change-workflow`/`dsh-knowledge-upkeep` 等对编号件的引用。
+3. `docs-manifest.json` ⇒ 用 `dsh-server-docs/scripts/docs-manifest.py` **重生成**（⛔ 不手改）。
+
+**执行顺序（每批 ≤10 文件 ＋ 每批 `git status --short` 复核）**
+① 先改引用（可回滚，且改完仍能工作）→ ② 再 `git mv` 移动文件（保历史）→ ③ `grep -r` 复核零悬空 → ④ 重生成 manifest → ⑤ 在 `INDEX.md` 顶部补"目录地图"一行说明结构 → ⑥ 报告（含前后 `ls` 对比）。
+
+**禁忌**：⛔ 未获用户口令不得 `commit`/`push`；⛔ 不改 `调整方案/` 存量文件名；⛔ 不动 `交接单/`、`skills/`；⛔ 不碰 `CODEBUDDY.md` 以外的机制层文件（锁脚本、hook）。
+

归档/接续历史/文档库/接续包_文档库结构治理_20260924.md

@@ -0,0 +1,301 @@
+# 接续包 · 文档库结构治理（2026-09-24 06:2x）
+
+> **工作区**：`E:\ProgramData\AIProject\ai1net-dsh-server`　**线名**：插件投放与分库线 · 文档库治理（续）
+> **性质**：接续包（7 段）。⛔ 本包只涉及 `D:\github\dsh_shenxian\dsh-server-docs` 的**结构与命名**，不含平台代码改动。
+> **上棒已被用户纠正一次**（把「移动文件夹」误读为「摊平内容」），本包已把该纠偏写进 §六，⛔ 勿重犯。
+
+---
+
+## §1 目标
+
+把 `dsh-server-docs` 收成「**一眼看懂、机械可维护**」的形态：① 顶层全部带编号且序号一律阿拉伯数字；② 状态可机读（不靠目录位置）；③ 无效/重复件清出项目；④ 收尾把未闭环的引用、重号、残渣清干净。
+
+## §2 已完成（本棒 8 项，均有取证）
+
+1. **顶层全编号**：`01-规范` `02-架构设计` `03-数据库` `04-调整方案` `05-交接单` `06-ops` `07-scripts` `08-skills` `09-archive` `tmp`（`tmp` 按用户令**不带号**）。
+2. **机制层同批迁移**：宿主 `E:\ProgramData\.workbuddy\settings.json` 内 **5 条 hook 入口** → `07-scripts/`；锁根 `05-交接单/`（`.locks`/`.exec-lock`/`.doing-*`）在 `handoff-guard.sh`·`preflight-lock.sh`·`lock-guard-hook.py`·`op-lock.sh` 的硬编码全部同步。
+3. **7 个常驻编号件 → `01-规范/`**；引用改写累计 **112 + 52 + 164** 量级（含 `08-skills/`（库内 ＋ 本机 `~/.workbuddy/skills/`）、工作区 4 个接续入口）。
+4. **交接单摊平后又按用户本意恢复**：`05-交接单/交接单-已完成/`（**22 个** = T01–T07 原在 `09-archive/交接单-已完成/` ＋ T08–T21 原在 `05-交接单/archive/交接单-已完成/`）。
+5. **序号统一为阿拉伯数字**：`IM群组-A~F` → `01~06`；中文序号 ①②③④ → `01~04`；`覆盖网络-序NN` → `覆盖网络-NN`；`交接单_carbon插件-01M1a…` → `carbon插件-01-M1a…`（去冗余前缀 + 补分隔符，本棒最后一项）。
+6. **新增工具**：`07-scripts/handoff-status.py` —— 一条命令出「待执行/已完成/无状态」清单（递归扫子目录，状态取单子头部 `- 状态：` 行，回退取 `05-交接单/README.md` 台账表）。
+7. **清出项目**（移入工作区 `归档/`，可恢复）：`09-archive/_tmp_r6_s8.md`、`_自动接续简报_20260916.md`、`dsh-improvement-plan-20260909-full.md`、`工作区草案/`、`09-archive/接续包_覆盖网络线_20260916.md`、`09-archive/接续入口_覆盖网络线_20260916.md`（后两者中入口那份是工作区根权威版的过期副本）。
+8. **D1–D3 台账/索引**（上一棒）：`INDEX.md §二` 刷成 146 行、13 条重复行清零；`04-调整方案/README.md` 纠偏（`01~28` → 146 篇）。
+
+## §3 在途
+
+无未落盘半成品。所有脚本在 `E:\ProgramData\AIProject\ai1net-dsh-server\tmp\`（`_renumber.py` · `_fix_rel.py` · `_renumber2.py` · `_flatten.py` · `_flatten2.py` · `_handoff_no.py` · `_handoff_digit.py` · `_restore_sub.py` · `_carbon_fix.py`），**幂等、可重跑**。
+
+## §4 未完成（按风险低→高；⛔ 均未获授权）
+
+1. **【低】补状态字段**：`handoff-status.py` 实测 **待执行 16 / 已完成 9 / 无状态 15**。这 15 个（`T09`–`T19`、`T21`、carbon 01/03/04 等）**头部无 `- 状态：` 行** ⇒ 按其在 `交接单-已完成/` 的目录归属补写状态行。
+2. **【低】订正打架样本**：`T20-观测口径与在册缺陷` 头部写「待执行」，却在 `交接单-已完成/` 里 ⇒ 二选一（改字段或挪目录）。
+3. **【低】`T08` 重号**：`T08-执行标记-已释放.md` 与 `T08-集群化落地-兼容单例模式.md` 同号；前者是运行态标记、非单子 ⇒ 建议清出。
+4. **【低】残渣**：`05-交接单/.lock-插件投放-②` 陈旧占号锁（非有效锁；有效锁在 `.locks/` 内为 OWNER 文件）。
+5. **【中】`04-调整方案/` 存量编号混排**（146 篇：两位 95 ＋ 三位 47 ＋ 4 个字母后缀件 ＋ 5 个真断层 48/63/130/131/132）⇒ 现行口径 **存量不重排、新档三位零填充**（改口径需用户拍板）。
+6. **【待授权】** `commit` / `push` 全部未做（本轮 dsh-server-docs 未提交改动量 ≈ 100+ 项，**⛔ 禁 `git add -A`**：同仓还有别的线的在途改动）。
+
+## §5 下一步（动作序列）
+
+① 跑 `state.py`，只读**本线**那段；② 读本包并**重算 md5 校验**；③ `--claim-exec` 抢域锁（域：`dsh-server-docs/05-交接单` ＋ `dsh-server-docs/07-scripts`）；④ **只做 §4-1/2/3/4**（均为低风险、可自决）⇒ 完成后重跑 `handoff-status.py`，确认「无状态」显著下降至 0 或仅剩有据可查者；⑤ §4-5 只报告不动；⑥ `--release-exec` 收口。
+
+## §6 关键决定（⛔ 不得推翻重来）
+
+1. **`tmp/` 不带编号**（用户令）；`04-调整方案/` **号不动**（`04-NN` 短号 ＋ 4 处脚本常量硬编码）。
+2. **序号一律阿拉伯数字**：不用英文字母、不用中文数字。`T` 是族名（序号是数字）、`覆盖网络-`/`carbon插件-` 是族名。
+3. 🔴 **纠正上一棒的语义误读（用户原话：「我的意思也没有说要把文件夹删除 合并，不知道你咋理解的」）**：用户说「`<某文件夹>`，直接放在 `<父目录>` 下面」= **移动那个文件夹本身、去掉中间层**，⛔ **不是**把里面文件摊平。⇒ 同义指令再出现时，**先按"移动文件夹"理解**，不确定就问。
+4. 🔴 **批量改名的三条铁律**（本棒踩全了）：① 引用有三形态必全覆盖（限定路径 `dsh-server-docs/xxx/` · 相对路径 `<x>/xxx/` · 字符串字面量 `'xxx'`）—— 只做 ①＋裸名必漏功能性引用（锁/hook 脚本）；② ⛔ **不用 `IndexOf`+`Substring` 手工拼新名**（本棒因此把 5 个文件拼成 `覆盖网络-24-覆盖网络-序24-…` 双前缀），一律用正则整体替换或显式映射表；③ **改完必须 grep 功能性常量逐条验**（如 `^LOCKDIR=`），不能只看"改写 N 个文件"。
+5. 🔴 **hook 是会话启动时快照**：改宿主 `settings.json` 的 hook 路径后**本会话命令行整轮失效**（实测 `can't open file …dsh-server-docs\scripts\bash-output-guard.py`）；且 hook 失效时 **Python 子进程也起不来 `git`/`mv`**（实测 `WinError 2`）⇒ 该窗口内改用 **PowerShell 原生命令**；hook 重载后即恢复。
+6. **状态不靠目录位置表达**：主依据 = 单子头部 `- 状态：` 行 ＋ `05-交接单/README.md` 台账表；目录（`交接单-已完成/`）只作辅助分类。
+
+## §7 回滚点
+
+| 对象 | 回滚方式 |
+|---|---|
+| 顶层目录编号 | 反向重命名 ＋ 重跑 `_tidy.py`/`_renumber.py` 类脚本（幂等）；`git mv` 可反向 |
+| 宿主 hook 配置 ＋ 5 个机制脚本 | 备份在 `归档/dsh-server-docs-重编号-20260924/` 与 `归档/dsh-server-docs-微调-20260924/`（`*.bak`） |
+| 清出项目的档案件 | `归档/dsh-server-docs-清理-20260924/`（可原样搬回） |
+| 去重的旧副本 | `归档/dsh-server-docs-去重-20260924/` |
+| 文档库 git | `git -C D:/github/dsh_shenxian checkout -- dsh-server-docs/`（⚠️ 连带丢弃别的线在途改动，慎用） |
+
+---
+
+## §8 用户追加令（2026-09-24 06:2x ⇒ **§5 增补，优先级最高**）
+
+> 用户原话：「**接续会话处理完成后，全面检查一遍引用关系，固化规则不要再把项目文件弄得乱七八糟**」。
+
+1. **规则已固化**：`dsh-server-docs/CODEBUDDY.md` 新增「**文档库结构与命名规则**」章（顶层结构 / 命名 / 状态不靠目录 / 批量改名六铁律 / 锁与钩子 / 收口判据）；工作区 `.workbuddy/memory/MEMORY.md` 加一条指针。⛔ 后续任何结构改动**先读该章**。
+2. **§5 动作序列在 ④ 之后追加一步**（做完 §4-1/2/3/4 必做）：
+   **⑤ 全面引用体检** ——
+   - 三种形态各查一遍旧目录名/旧文件名残留：限定路径 `dsh-server-docs/`、相对路径、脚本内字符串字面量；
+   - **功能性常量逐条验**：`grep -n '^LOCKDIR=\|^LOCKEXEC=\|^LOCKSROOT=' 07-scripts/handoff-guard.sh`、宿主 `settings.json` 的 5 条 hook 路径、`.gitignore` 忽略规则；
+   - 重跑自检三件套：`07-scripts/docs-consistency.py`（rc=0）· `07-scripts/docs-archive-index.py`（只读，应报"一致"）· `07-scripts/handoff-status.py`；
+   - 结果写进本包"完成情况"，**有残留未清零即不得收口**。
+3. **收口判据**：顶层可见 ＋ 引用零悬空 ＋ 三件套自检全绿。
+
+---
+
+## §9 完成情况（本棒执行棒 · 2026-09-24 06:3x–07:0x · 会话 `文档库治理4`）
+
+**锁**：`--claim-exec "文档库治理4" --domains dsh-server-docs/05-交接单 dsh-server-docs/07-scripts` 抢到 → 收口已 `--release-exec`。口径校验：本包开工前 md5 = `6fd7679eb0888d3816b9d9f07c39d01a` ✅ 相符。
+
+### ① §4-1 状态字段补全（16 件）
+机读判据 = `handoff-status.py` 的 `HEAD_STATUS` 正则（内联 `- 日期：… ｜ 状态：` 写法**不匹配** ⇒ 必须拆行）。
+- **拆行/插入 13 件**：carbon插件-01、T09–T14、T16–T19、T21（各补 `- 状态：` 行，值 = 单内 §8/§9/§10 回报位置的指针）。
+- **改值 3 件（头部旧值与证据打架 ⇒ 按证据改，§4-2 口径）**：
+  - `T15-presence在线态`：写「待执行」→ **已完成**（证据 = 单内 `§8★ 回报（序⑲ 执行棒 · 已回填 · 2026-09-17 17:28–18:16）`）。
+  - `T20-观测口径与在册缺陷`（§4-2 指定件）：写「⏳ 待执行」→ **已完成**（证据 = §8/§9/§10 三次执行回报已就地回填）。
+  - `carbon插件-03`：写「⏳ 待执行」→ **已完成**（证据 = 同线 `carbon插件-04`「上游单」行：执行棒④ 照单收官、四件全绿）。
+  - `carbon插件-04`：**待执行**（规划单，D9/D10 待拍板，§八 回报格式未回填）。
+- **结果**：`handoff-status.py` ⇒ **无状态 15 → 0**；已完成 9 → **23**；待执行 16（不变）。
+
+### ② §4-3 T08 重号件清出
+`05-交接单/交接单-已完成/T08-执行标记-已释放.md`（运行态标记、非单子，与 `T08-集群化落地-兼容单例模式.md` 同号）⇒ 移入工作区 `归档/dsh-server-docs-清理-20260924/`（可原样搬回）。
+
+### ③ §4-4 残渣占号锁
+接续包点名的是 `.lock-插件投放-②`，**实测该文件名为 `①`**；同类空目录另有 3 个 ⇒ 四个均**经核实为空目录**（有效锁在 `.locks/`）后 `rmdir`：`.lock-插件投放-①`、`.lock-02`、`.lock-47`、`.lock-CA2`。现 `05-交接单/` 下 `.lock-*` = 0。
+
+### ④ §5⑤ 全面引用体检
+- **功能性常量（逐条验，全对）**：`handoff-guard.sh` `LOCKDIR/LOCKEXEC/LOCKSROOT` 全指 `05-交接单/**` ✅｜`preflight-lock.sh` ✅｜宿主 `settings.json` 5 条 hook 全指 `07-scripts/` ✅｜库 `.gitignore` 2 条指 `05-交接单/**` ✅。
+- 🔴 **新发现并已修（上一棒遗留的功能性残留，静默假绿）**：`07-scripts/` 5 个自检脚本 ＋ 库 `CODEBUDDY.md` ＋ 工作区 `.codebuddy/rules/archive-doc.md` 仍指**旧目录名** `调整方案/`（已不存在）⇒ 共修 **21 处**。最严重两处：
+  - `docs-manifest.py`（档案号/L5 前缀）：`startswith('调整方案/')` 恒假 ⇒ manifest 里 147 条 `04-调整方案` 路径**取不到档案号** ⇒ `docs-archive-index.py` 报「档案 0 篇」还判「与 INDEX.md 一致」（**假绿**）。
+  - `.codebuddy/rules/archive-doc.md` 的 `paths` 含 `dsh-server-docs/交接单/**`（旧名）⇒ 条件规则**静默不生效**。
+- **三件套（全绿）**：`docs-consistency.py` rc=0「承诺现行的文件与现行值一致 ✓」｜`docs-archive-index.py` rc=0「表内容与 INDEX.md 一致」｜`handoff-status.py` rc=0。
+  - 为使 consistency 达 rc=0：T02 单元格 `「下一号 = **20**」` → `「下一号」写死为 **20**（旧值，已作废）`（破 `下一号 = NN` 形态，旧值语义保留）。
+- **散文类旧前缀残留（清单，未改）**：`01-规范/07-实例UI分区登记表.md:52`｜`02-架构设计/README.md:5,7,15`｜`03-数据库/DB-00:34,41 · DB-01:5 · DB-03:4`｜`05-交接单/覆盖网络-25:6`｜`08-skills` 5 处（⚠️ 涉三处同步、单向推进，须整批动）。存量 `04-调整方案/` 146 篇内约 1605 行旧前缀（`过程档案不改正文`）⇒ 未动。
+
+### ⑤ 仍需处置（未动，均非本棒授权范围）
+1. **生成物待重建**：`docs-manifest.json` 是在旧前缀下生成的；重建后 146 篇才有档案号 ⇒ `python 07-scripts/docs-manifest.py` → `docs-archive-index.py --write`（后者会改 `INDEX.md`，跨线可见 ⇒ 需拍板）。
+2. **打架样本残留**：`T02` 台账表写「待执行」但其件在 `交接单-已完成/`（其 D1–D3 交付物已由上一棒落地）⇒ 需二选一（改台账 / 挪件）。
+3. **缓存**：工作区 `.workbuddy/cache/docs-lines.json` 仍记旧路径（可再生）。
+4. `commit` / `push` 全程未做（未授权）。
+
+### ⑥ 本棒改动清单（回滚点）
+16 个状态件（内容行级，见 `tmp/_status_fix.py` 映射表）｜`T08-执行标记-已释放.md`（mv，归档可搬回）｜4 个空锁目录（rmdir）｜7 个功能性件（`07-scripts/{docs-manifest,docs-audit,docs-archive-index,docs-search,docs-consistency}.py` · 库 `CODEBUDDY.md` · 工作区 `.codebuddy/rules/archive-doc.md`）｜`T02` 单元格 1 处。脚本 = `tmp/_status_fix.py`、`tmp/_rel_fix.py`、`tmp/_rel_fix2.py`（幂等）。
+
+
+---
+
+## §9 · 执行记录（接续棒 2 · 会话 `文档库治理5` · 2026-09-24 06:4x–07:0x · 已收口）
+
+> 用户拍板（2026-09-24 06:42）：「1、A 2、B 。都按照长期有利的方向处理」
+> ⇒ ① A = **只重建 manifest，不动 INDEX** ｜ ② B = **连 08-skills 一起改并三处同步**
+
+### 本棒做了什么
+
+| # | 动作 | 结果 |
+|---|---|---|
+| 1 | **重建 `docs-manifest.json`**（拍板 ①A） | 档案 **0 → 146 份**；items 251→242（T08 清出 + 目录改名后重新枚举）；**INDEX.md 未动**（mtime 仍 06:14，早于本棒） |
+| 2 | **散文类旧前缀残留修复**（拍板 ②） | **29 文件 / 74 处**：生效件 4 目录（01-规范 2 · 02-架构设计 3 · 03-数据库 4 · 05-交接单 30）＋ 08-skills 12 文件 37 处 ⇒ 精确正则复验**裸旧名 0 处** |
+| 3 | **技能三处同步**（拍板 ②） | 库 `08-skills` → 本机 `.workbuddy/skills`（**12/12 一致**）→ 服务器 `/opt/dsh/docs/skills`（**12/12 一致**，`chmod 600 root:root` 已保）⇒ **三处 md5 全同** |
+| 4 | **顺带修真悬挂引用** | 库内 `dsh-plugin-diagnose/SKILL.md` 的 `src/host/08-skills/plugin.ts` → `src/host/skills/plugin.ts`（**本机副本原本就是正确值** ⇒ 证明这是改名时的误替换，非真路径） |
+
+### 自检结果
+
+- `docs-consistency.py` **rc=0** ✅（承诺现行一致）
+- `handoff-status.py` **rc=0** ✅（无状态 **0** / 待执行 16 / 已完成 23）
+- `docs-archive-index.py` **rc=1** —— 报「档案 **146 篇**」+「表与 INDEX 不一致，加 `--write` 刷新」⇒ **这正是拍板 ①A 的预期中间态**（manifest 已重建、INDEX 按拍板未刷）。⚠️ 对比：上一棒是「档案 0 篇还判一致」的**假绿**，本棒起是真检查。
+- `docs-audit.py` **rc=1** —— **误报**：它把 `08-skills/**/07-并行调度详解.md` 这类编号开头的技能文档当成「档案 07」（报「编号 01 被 5 份档案占用」等）；同一份报告里 **`✓ 无悬空档案号引用`** ⇒ 接续包判据「引用零悬空」**成立**。
+
+### 遗留 / 下一棒待办（按优先级）
+
+1. 🔴 **`docs-archive-index.py --write` 刷 `INDEX.md`** —— 使 §二 表与 manifest 对齐、146 篇档案号入索引。**属跨线可见改动（改 `INDEX.md`）⇒ 需拍板**（本棒按 ①A 未做）。
+2. 🔴 **`docs-audit.py` 档案号扫描范围过宽** —— 应限定到 `04-调整方案/`（或排除 `08-skills/**`），否则编号冲突恒报。**这是上一棒「把前缀常量改成 `04-调整方案/`」后暴露出来的既有设计缺陷**（改前扫不到该目录 ⇒ 恒 0；改后扫到了 ⇒ 范围过宽）。
+3. ⚠️ **`INDEX.md` 被 git 判为 `Binary files differ`** —— 本棒未动它（mtime 06:14，属既有未提交改动），但该状态可疑（疑含 NUL 或行尾混杂），建议单独取证。
+4. ⚠️ **服务器 `/opt/dsh/docs/skills/` 下不在库内 `08-skills` 的技能**（`agent-operating-rules`、`dsh-auto-handoff-chain`、`dsh-feature-first` 等，本机 24 个技能目录 vs 库内 12 个）**未纳入本轮**；本棒只同步了库内 08-skills 的那 12 个文件所在技能。
+5. 📌 `05-交接单/交接单-已完成/**`（历史档案）与 `04-调整方案/` 存量约 1605 行**按政策不改**（过程档案不改正文）。
+6. 📌 **未 commit / 未 push**（未获授权）。
+
+### 本棒方法论要点（下一棒复用）
+
+- **判「旧名残留」必须用带负向后顾的正则**：`(?<![0-9A-Za-z_/\-])调整方案/` —— ⛔ 直接 `grep "调整方案/"` 会把**正确的新前缀** `04-调整方案/` 一并命中 ⇒ 假阳性（本棒实测：grep 报 14 个文件，精确正则报 0）。
+- **判「三处/两端一致」必须忽略行尾**：Windows `␍
+` vs Linux `
+` ⇒ `diff` 会整块报差异，但 md5 **逐行相同**。用值比较，别信 `diff` 退出码。
+- **同步前先做「归一化比较」定性差异**：把两端各自的前缀反向归一化（`04-调整方案/`→`调整方案/`、`07-scripts/`→`scripts/`、反斜杠形式也算），若归一化后相同 ⇒ 差异纯为改名 ⇒ 可安全整文件同步。
+- **库是权威源，本机与服务器是镜像**（本棒实测：本机副本停留在改名之前，库内已改）。
+
+
+## §10 · 执行记录（接续棒 3 · 会话 `文档库治理6` · 2026-09-24 06:54–07:1x · 已收口）
+
+> 用户令（2026-09-24 06:53）：「**都要执行一直到任务处理完毕**」⇒ §9「遗留」1–3 全部执行完毕。
+
+### 做了四件（全部机读通过）
+
+| # | 动作 | 结果 |
+|---|---|---|
+| 1 | `docs-archive-index.py --write` 刷 `INDEX.md` | **rc=0**「表内容与 INDEX.md 一致」；146 篇档案号入索引；备份 `tmp/INDEX.md.bak` |
+| 2 | 修 `docs-audit.py` 档案号提取范围 | 第 61 行改为 `if mf and ("/" not in f or f.startswith("04-调整方案/"))` ⇒ **rc=0「无 P0 级问题」**（改前：全库 md 用文件名前缀取号 ⇒ `08-skills/**/07-并行调度详解.md` 被当档案 07） |
+| 3 | **修 `INDEX.md` 内 2 处 NUL 损坏**（git 判 binary 根因） | 两处 `\x004-调整方案/`（`0` 被写成 NUL，行 44 / 214，同一句「2026-09-24 已清出项目」）⇒ 还原为 `04-调整方案/`；现 `NUL 0 / CR 0 / LF 284`，**git 恢复文本判定**（`numstat` 由 `- -` 变 `111 93`） |
+| 4 | 技能集合差集取证 | 服务器 **12** = 库内 `08-skills` **12**（§9 里"服务器有库外技能"是**假阳性 grep 的误判**，服务器实测只有 12 个技能目录）；本机多出的 12 个（`AI HOT` / `humanizer` / `agent-ui-kit` / `taste-skill` / `workbuddy-*` 等）是**跨项目个人技能**，不属文档库 `08-skills` 管辖 ⇒ **不在本线范围** |
+
+### 自检（**本线首次全绿**）
+
+`docs-consistency` rc=0 ｜ `docs-archive-index` rc=0 ｜ `handoff-status` rc=0（无状态 0 / 待执行 16 / 已完成 23）｜ `docs-audit` rc=0 ｜ `docs-manifest` rc=0（242 份 / 146 档案）
+
+### 🔴 §11 · 本棒新发现（**超出本棒范围，需拍板**）：服务器归档镜像整体仍是「改名前的旧结构」
+
+- **事实**：`/opt/dsh/docs/` 顶层 = `skills/` `交接单/` `scripts/` `archive/` `ops/` `数据库/` `04-调整方案/` ＋ 顶层散文件 `01-规划与架构.md` `02-运维手册.md` `03-路线图与待办.md` `06-工作台UI规范.md` `07-实例UI分区登记表.md`；**本机/库已是** `01-规范/`…`09-archive/`。
+- **症状**：`docs-sync-check.sh` 报「一致 146 ／ 内容不一致 13 ／ 仅本地 136 ／ 仅服务器 121」——其中 **「一致 146」全部来自两边同名的 `04-调整方案/`**；其余差异是**目录改名造成的路径不匹配**，非内容差异。
+- **已取证（决定风险等级）**：平台代码（`/opt/dshs/src`、`/opt/dshs/lib`、`/opt/dshs-cluster/src`）、`/etc/dshs.env`、systemd unit **均无 `docs/skills` / `DSHS_DOCS` 引用** ⇒ 该目录是**归档位，不是运行时依赖**（唯一命中在 `/opt/dsh/backups/docs-skills/*.bak` 的文档文本里）。
+- **但有一处自指耦合**：技能文档自身写死了「服务器归档位在 **`/opt/dsh/docs/skills/<name>/SKILL.md`（root 600）**」⇒ 若把服务器 `skills/` 改名，**必须同步改该约定文本**（涉及本机技能 24 份 + 库 `08-skills` 12 份）。
+- **为何需拍板**：① 涉及 **121 个旧名文件**（重命名/移动 + 删旧目录 ⇒ **不可逆**）② 会让三处（库 / 本机 / 服务器）的**技能归档约定**连锁改动 ③ 属「验收面变化」而非本棒既定范围。
+
+### 📌 本棒未做（授权/范围外）
+
+未 commit / 未 push（未获授权）｜ `04-调整方案/` 存量不动（政策）｜ 服务器镜像结构改造（见 §11，待拍板）。
+
+
+## §12 · 执行记录（接续棒 4 · 会话 `文档库治理7` · 2026-09-24 07:04–07:2x · 已收口）
+
+> 用户令（2026-09-24 07:0x）：「**A 方案**」= 采纳 §11 的 A（改造服务器归档镜像结构与本机对齐），并按先前口径「**都要执行一直到任务处理完毕**」执行到底。
+
+### 一、A 方案主体：服务器归档镜像结构改造
+
+| # | 动作 | 结果 |
+|---|---|---|
+| 1 | **全量备份** | `/opt/dsh/backups/docs-pre-restructure-20260924-071007.tar.gz`（1.9 MB / 326 条目） |
+| 2 | **打包库镜像** | 289 文件（排除 `.git/` `tmp/` `05-交接单/.locks/`） |
+| 3 | **新结构就位** | 解包到 `/opt/dsh/docs/` ⇒ 顶层 = `01-规范`…`09-archive` ＋ 7 个顶层文件，**与本机同形** |
+| 4 | **旧结构归档** | 12 项 / **121 文件** `mv` 到 `/opt/dsh/backups/docs-old-structure-20260924-071032/`（⛔ 不是 `rm`） |
+| 5 | **权限** | 目录 `700` / 脚本 `755` / 其余 `600`，`root:root` |
+| 6 | **双端对账** | `docs-sync-check.sh` ⇒ **双端一致 ✅**（一致 **289** / 内容不一致 **0** / 仅本地 **0** / 仅服务器 **0**） |
+
+**旧结构归档清单**（全在 `backups/docs-old-structure-20260924-071032/`）：`skills/` `交接单/` `scripts/` `archive/` `ops/` `数据库/` `.bak-seq17-20260917-164809/` ＋ 顶层散文件 `01-规划与架构.md` `02-运维手册.md` `03-路线图与待办.md` `06-工作台UI规范.md` `07-实例UI分区登记表.md`。
+
+### 二、三分表判定（决定「哪些文件不能丢」）
+
+| 归类 | 数量 | 处置 |
+|---|---|---|
+| 已一致 | 180 | 不动 |
+| 服务器旧版（路径在库、内容不同） | 78 | 解包覆盖为库版本 |
+| 改名 / 搬路径 | 0 | —（映射规则已覆盖全部旧路径形态） |
+| **真独有**（库内完全没有） | **22** | 其中 5 个 `.bak-seq17-*` 本地备份 ＋ **17 个历史旧档** ⇒ 随旧结构整体归档留档，**零信息丢失** |
+
+**17 个历史旧档**（库内已有新版或已改名的旧版）：`archive/工作区草案/*`（3）· `archive/_tmp_r6_s8.md` · `archive/_自动接续简报_20260916.md` · `archive/dsh-improvement-plan-20260909-full.md` · `ops/接续入口_覆盖网络线_20260916.md` · `ops/接续包_覆盖网络线_20260916.md` · `交接单/IM群组-A-房间内核与DB.md` · `交接单/IM群组-D-插件SDK与扩展点契约.md` · `交接单/覆盖网络-序24/25/26/45/46/47`（6）· `交接单/archive/交接单-已完成/T08-执行标记-已释放.md`。
+
+⚠️ **服务器 `交接单/` 下还藏着一层更早的旧结构** `交接单/archive/交接单-已完成/`（12 个 T09–T21）—— 这是改名**之前**的形态残留，随 `交接单/` 一并归档。
+
+### 三、🔴 纠正上一棒的误判（重要）
+
+§11 里写的「**技能文档自身写死了服务器归档位 `/opt/dsh/docs/skills/`**」—— **实测是错的**。逐处取证结果：
+
+- 库内 ＋ 本机技能的功能性引用**本来就用新段名**：`/opt/dsh/docs/08-skills/<name>/SKILL.md`（3 处）、`/opt/dsh/docs/05-交接单/`（1 处）⇒ **改造服务器是把这些引用从「悬挂」变回「正确」**，而不是「改了目录名才要改引用」。
+- 真正需要改的是**另一批**：库内 4 处 `/opt/dsh/docs/调整方案/`（`08-skills/dsh-change-workflow/` 2 文件）——已修。
+- **教训**：上一棒把「技能正文里的 `/opt/dsh/docs/08-skills/`」误读成「写死旧路径」，是因为**没有逐处打印原文**、只凭「技能文档提到 skills」推断。⇒ 判「自指悬挂」必须**逐处打印匹配上下文**，不能靠印象。
+
+### 四、库内旧名残留终扫与修复（上一棒遗留）
+
+上一棒修的 74 处**漏掉了顶层文件**（`README.md` / `INDEX.md` / `BRIEF.md`）与部分自检脚本。本棒补齐：
+
+| 批次 | 文件 | 处数 |
+|---|---|---|
+| 第一批 | `README.md`（14）· `INDEX.md`（5）· `BRIEF.md`（1）· `07-scripts/docs-dedupe.py`（1）· `07-scripts/handoff-status.py`（1）· `08-skills/dsh-change-workflow/`（2 文件 3 处） | **25** |
+| 第二批 | `01-规范/07-实例UI分区登记表.md` · `02-架构设计/覆盖网络-顶层架构全貌.md` · `05-交接单/覆盖网络-25-实例逐步拉起.md` · `08-skills/{dsh-decision-method,dsh-feature-first,dsh-opensource-release×2}` | **8** |
+| 订正 | `07-scripts/handoff-guard.sh:58` 注释里「已知根段」举例 `skills/` → `08-skills/` | 1 |
+
+- 顺带修掉一处**双前缀 bug**：`README.md` 的 `05-交接单/05-交接单/T09–T21` → `05-交接单/T09–T21`。
+- **终验**：全库裸旧名 `调整方案/` = **0 处** ✅
+- **甄别掉的 6 类假阳性**（记录在技能 §11.2）：relay 日志 `host=ops/w-106`｜git 仓路径 `HEAD:scripts/x.cjs`｜散文「交接单 / 接续包」｜`~/.workbuddy/skills/`｜`/api/skills/{shared,mine}`｜`src/host/skills/plugin.ts`。
+
+### 五、对账脚本修复（`07-scripts/docs-sync-check.sh`）
+
+改造前对账报「仅本地 6 个」，全是**运行态文件**（`tmp/` 4 ＋ `05-交接单/.locks/` 2）—— 属脚本排除清单缺陷。修 3 处（python 分支 `SKIPF/SKIPD`、bash 回退分支、服务器侧 `find`）补齐 `tmp/` 与 `.locks/` 排除 ⇒ 对账方可归零。
+
+### 六、改名后运行时依赖复查（本棒新增，**零引用**）
+
+`systemd` / `/etc/dshs.env` / `crontab` / `/root/.bashrc` / 平台代码（`/opt/dshs/src`、`/opt/dshs/lib`、`/opt/dshs-cluster/{src,lib}`）/ 实例侧 `/opt/dsh/users` —— **全 grep 旧路径，零引用**。唯一命中是 `/opt/dsh/docs-status/文档库状态备注.md` 里的**描述性文本**（非可执行依赖）。
+⇒ 结论：`/opt/dsh/docs` 是**纯归档位**，改名不影响运行时。
+
+### 七、技能沉淀（`dsh-knowledge-upkeep` 新增 §11）
+
+新增 **§11「归档镜像结构治理与双端对账」**（+52 行，LF 保持，三处 md5 = `376710effda7ce42ea3ba92038ffbbe8` → 修 audit 告警后更新）：三分表判定法 · 负向后顾正则 · 忽略行尾比对 · **改名后必查六项** · 改造安全姿势（全量备份 ＋ `mv` 归档）。
+⚠️ 期间踩到一个自造坑并已修：§11 里写的「manifest 报『档案 0 篇』」被 `docs-audit.py` 的【6】交叉引用检查**当成"引用档案号 0"** ⇒ 改写为「输出『0 篇档案』」后 rc 归 0。**教训：写进文档的示例文案会进 lint 扫描面。**
+
+### 八、自检（全绿）
+
+`docs-consistency` **rc=0** ｜ `docs-archive-index` **rc=0**（档案 146 篇）｜ `handoff-status` **rc=0**（无状态 **0** / 待执行 16 / 已完成 23）｜ `docs-audit` **rc=0**（无 P0）｜ `docs-manifest` **rc=0**（files 242）
+＋ 双端对账 **双端一致 ✅**
+
+### 九、回滚方式（两条，均已在服务器备齐）
+
+```bash
+# ① 只回滚结构（保留新结构产物）
+ssh [email protected] 'mv /opt/dsh/backups/docs-old-structure-20260924-071032/* /opt/dsh/docs/'
+
+# ② 全量回滚到改造前（原始样子）
+ssh [email protected] 'rm -rf /opt/dsh/docs && tar xzf /opt/dsh/backups/docs-pre-restructure-20260924-071007.tar.gz -C /opt/dsh'
+```
+
+### 十、未做 / 待办
+
+- **未 commit / 未 push**（未获授权）—— 库内本棒改动：`README.md` `INDEX.md` `BRIEF.md` `docs-manifest.json` `01-规范/07-…` `02-架构设计/覆盖网络-…` `05-交接单/覆盖网络-25-…` `07-scripts/{docs-sync-check.sh,docs-dedupe.py,handoff-status.py,handoff-guard.sh}` `08-skills/*`（7 文件）。
+- ⚠️ **`INDEX.md` 被 git 判 `M` 且历史遗留 180 项未提交改动**（含别的线的 `config/*`）—— 建议单独收口提交。
+- 📌 服务器 `/opt/dsh/docs-status/文档库状态备注.md` 里写「项目文档正文全部在服务器，本地不保留副本」—— **与现状不符**（本机有完整镜像且双端对账）。该文件属 `docs-status` 线，未动。
+
+
+## §13 · 执行记录（提交棒 · 会话 `文档库提交1` · 2026-09-24 07:2x · 已收口）
+
+> 用户令（2026-09-24 07:20）：「**全部优化完成后 提交到仓库以本地文件为准，提交后仓库要和本地完全一致，不允许有多出的文件夹或文件**」
+
+### 结果：commit `e6207aa` 已双推，仓库 == 本地（status 0 条）
+
+| 项 | 值 |
+|---|---|
+| commit | `e6207aa6914ff26bee7e999b72db153d00e2d096`（父 `3d8f50e`） |
+| 规模 | **239 文件**（M 47 ｜ R 45 ｜ A 107 ｜ D 40） |
+| 推送 | SSH 仓 `3d8f50e..e6207aa` ＋ CNB 仓 `3d8f50e..e6207aa`，两者 sha 均 `= e6207aa…` |
+| 一致性 | 提交后 `git status` **0 条**；HEAD 中磁盘不存在的文件 **0 个**（= 仓库无「多出」） |
+| 双端 | `/opt/dsh/docs` 对账 **289/289 一致** ✅ |
+| 自检 | consistency / archive-index（146 篇）/ handoff-status（无状态 0）/ audit 全 **rc=0** |
+
+### 提交前做的三道门禁（下次复用）
+
+1. **敏感扫描**：全量 dry-run 222 条 → 敏感名命中 4（全是 `*-token.ts` / `*credential*.ts` **代码文件**）＋ 内容级 2（`src/config.ts` 是**类型声明**、`test/im-gateway-access.test.mjs` 是 `'test-secret-not-a-real-key'` **占位符**）⇒ 逐个取证后判定**无真凭据**。
+2. **零丢失核对**：对全部 85 个「被删/改名源」文件，用 **HEAD 内容 md5（归一化行尾）在本地全盘反查** ⇒ 13 个「按文件名找不到」的逐个定性：5 个同内容（在 `tmp/散落临时文件/`、`待清理/中间产物-20260919/`）、1 个是**已更新版**（`ops/接续入口…` → 工作区根）、4 个是**改名+更新**（`交接单/覆盖网络-序24/25/26/45` → `05-交接单/覆盖网络-24/25/26/45`）、1 个已归档（`T08-执行标记`）⇒ **零信息丢失**。
+3. **政策边界**：`05-交接单/` 与 `dsh-server-docs/tmp/` 按**用户 2026-09-21 明令**不入库（`.gitignore` 已写「⛔ 别用 git status 判交接单要不要提交」）⇒ `git rm --cached` 清出误入的 `05-交接单/README.md`；给 `dsh-server-docs/.gitignore` 补 `tmp/`（根 `.gitignore` 的 `/tmp/` 只覆盖仓库根）。
+
+### 提醒项（非本棒范围，已报告未动）
+
+- ⚠️ 本次提交**包含别的线的代码落地**：`src/im/**`、`src/db/plugin-data/**`、`src/web/routes/{im,sessions,overlay-device}.ts`、`src/supervisor/plugin-assembly.ts`、`poc/im-*` 等（因用户要求「完全一致」⇒ 全量对齐）。相关线需知晓自己的改动已入库。
+- ⚠️ 仓库根的 `core.autocrlf=true` ⇒ add 时对非 `-text` 文件（根级 / `src/` / `config/` / `poc/`）会打印 `LF will be replaced by CRLF` 警告；`dsh-server-docs/**` 已由 `.gitattributes` 标 `-text`（纯 LF），**不受影响**。
+- ⚠️ `docs-audit` 报「状态缺失(❓) 15」为既有项，不计入 rc。

归档/接续历史/机制排查/S12_一次性排期停用_20261002.py

@@ -0,0 +1,54 @@
+import sqlite3, sys, json, datetime
+sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+
+DB = r"E:/ProgramData/.workbuddy/workbuddy.db"
+TARGET = ("deleted_at IS NULL AND status='ACTIVE' AND schedule_type='once' "
+          "AND next_run_at IS NULL")
+SELF = "45d4e2d4-a73d-4cdf-ac78-1047326f0f8d"
+
+c = sqlite3.connect(DB, timeout=20)
+c.execute("PRAGMA busy_timeout=10000")
+
+before = c.execute(f"select count(*) from automations where {TARGET}").fetchone()[0]
+print("BEFORE =", before)
+
+rows = c.execute(
+    f"select id, name from automations where {TARGET} order by name").fetchall()
+print("TARGET_ROWS =", len(rows))
+assert before == len(rows), "盘点与列表不一致，停手"
+
+# 只逐条 UPDATE（不批量），每条改完立刻回读核对
+now_ms = int(datetime.datetime.now().timestamp() * 1000)
+results = []
+for aid, name in rows:
+    assert aid != SELF, "拒改：本会话自己的排期"
+    cur = c.execute(
+        f"update automations set status='PAUSED', updated_at=? where id=? and {TARGET}",
+        (now_ms, aid))
+    # 立刻回读核对（不把「返回成功」当「已生效」）
+    chk = c.execute("select status, schedule_type, next_run_at, deleted_at "
+                    "from automations where id=?", (aid,)).fetchone()
+    ok = (cur.rowcount == 1 and chk[0] == 'PAUSED' and chk[1] == 'once'
+          and chk[2] is None and chk[3] is None)
+    results.append((aid, name, cur.rowcount, chk, ok))
+    print(f"  [{'OK ' if ok else 'FAIL'}] {name}  rowcount={cur.rowcount}  now={chk}")
+
+c.commit()
+
+after = c.execute(f"select count(*) from automations where {TARGET}").fetchone()[0]
+print("AFTER =", after)
+
+# 回归：周期排期一个没少、待跑的一次性排期没被动
+print("RECURRING_ACTIVE_AFTER =", c.execute(
+    "select count(*) from automations where deleted_at is null and status='ACTIVE' "
+    "and schedule_type='recurring'").fetchone()[0], "(before=3)")
+print("ONCE_PENDING_STILL_ACTIVE =", c.execute(
+    "select count(*) from automations where deleted_at is null and status='ACTIVE' "
+    "and schedule_type='once' and next_run_at is not null").fetchone()[0], "(before=2)")
+print("TOTAL_ROWS_AFTER =", c.execute("select count(*) from automations").fetchone()[0],
+      "(before=141  ⛔不删行)")
+print("INTEGRITY_AFTER =", c.execute("PRAGMA integrity_check").fetchone()[0])
+c.close()
+
+ok_all = after == 0 and all(r[4] for r in results)
+print("VERDICT =", "PASS" if ok_all else "FAIL")

归档/接续历史/机制排查/S12_一次性排期盘点_20261002.py

@@ -0,0 +1,34 @@
+import sqlite3, sys, json
+sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+
+DB = r"E:/ProgramData/.workbuddy/workbuddy.db"
+c = sqlite3.connect(DB, timeout=15)
+c.execute("PRAGMA busy_timeout=8000")
+
+TARGET = ("deleted_at IS NULL AND status='ACTIVE' AND schedule_type='once' "
+          "AND next_run_at IS NULL")
+
+n = c.execute(f"select count(*) from automations where {TARGET}").fetchone()[0]
+print("BEFORE_ONCE_ACTIVE_NO_NEXT =", n)
+print("TOTAL_ROWS =", c.execute("select count(*) from automations").fetchone()[0])
+print("ACTIVE_ALL =", c.execute(
+    "select count(*) from automations where deleted_at is null and status='ACTIVE'"
+).fetchone()[0])
+print("RECURRING_ACTIVE =", c.execute(
+    "select count(*) from automations where deleted_at is null and status='ACTIVE' "
+    "and schedule_type='recurring'").fetchone()[0])
+print("--- group: schedule_type x status x next_run_is_null ---")
+for r in c.execute(
+    "select schedule_type, status, (next_run_at is null), count(*) from automations "
+    "where deleted_at is null group by 1,2,3 order by 1,2,3"):
+    print("  ", r)
+print("--- target rows (full) ---")
+cols = [d[1] for d in c.execute("PRAGMA table_info(automations)")]
+print("COLUMNS =", cols)
+for r in c.execute(f"select * from automations where {TARGET}"):
+    d = dict(zip(cols, r))
+    print("  ", json.dumps({k: d.get(k) for k in
+          ("id", "name", "status", "schedule_type", "next_run_at", "created_at",
+           "updated_at", "deleted_at")}, ensure_ascii=False))
+print("INTEGRITY_BEFORE =", c.execute("PRAGMA integrity_check").fetchone()[0])
+c.close()

归档/接续历史/机制排查/S12_收尾_台账与出队_20261002.py

@@ -0,0 +1,63 @@
+import json, sys, os, shutil, datetime
+sys.stdout.reconfigure(encoding="utf-8", errors="replace")
+
+WS = r"E:/ProgramData/AIProject/ai1net-dsh-server"
+TG = os.path.join(WS, "交付物/任务图-会话协作自检.json")
+INBOX = os.path.join(WS, "tmp/supervise-inbox")
+CLAIM = os.path.join(INBOX, "claims/S12")
+BAK = TG + ".bak-s12-clean-20261002-2215"
+
+EV = ("2026-10-02 22:0x–22:1x【本棒 · 走 SQL 直连通道，收尾完成】"
+      "改前只读盘点 = **9 条**（⛔ prompt 说的 29 条不成立：那是 09-18 点前旧读数，"
+      "那批多数已在 18:0x 那一棒被 deleted_at 软删，只剩这 9 条漏网）"
+      "⇒ 判据 deleted_at IS NULL ∧ status='ACTIVE' ∧ schedule_type='once' ∧ next_run_at IS NULL。"
+      "**9 条逐条单发 UPDATE（status→PAUSED，⛔不删行）＋逐条回读四元组 (PAUSED,once,None,None) "
+      "＋ rowcount=1 ⇒ 9/9 OK**；改后回读计数 **= 0** ✅。"
+      "总行数 141→141（未删行）；PRAGMA integrity_check = ok（改前也先跑基线）。"
+      "**误伤回归**：recurring ACTIVE 3→3、待跑 once（next_run_at 非空）2→2 ⇒ 周期排期与 follow/waker 时钟一条没少。"
+      "脚本内置 assert（盘点=列表、且拒改本会话排期 45d4e2d4）⇒ 不一致即停手。"
+      "⛔ 全程未用 automation_update（P0-26 属主边界会假成功），只走 sqlite3 SQL + busy_timeout=10000，"
+      "⛔ 未做任何文件级 cp/mv（避 WAL 三件套）。"
+      "⛔ **状态＝待核对（await-verify），不标 done**：产物只有「9→0」这一条读数，"
+      "需下一次 collabd.py --once 的体检报告确认这 9 条不再出现在 notes 段才可转 done；"
+      "⚠️ 本轮体检大概率仍 skipped（本自动化会话在跑 ⇒ health() busy 恒跳过，另有 300s 节流戳）。"
+      "产物：机制排查与修复/S12_清理报告_20261002.md ＋ 两个可复跑脚本（盘点/停用，幂等）。"
+      "⛔ queue.json/queue.md/NEXT.md 是 collabd 派生产物，未手改。")
+
+# 1) 任务图 S12 -> await-verify
+g = json.load(open(TG, encoding="utf-8"))
+shutil.copy2(TG, BAK)
+hit = 0
+for n in g.get("nodes", []):
+    if n.get("id") == "S12":
+        n["status"] = "await-verify"
+        n["evidence"] = EV
+        n["_待核对"] = ("计数判据已过（9→0）；状态判据待下一次体检报告确认这 9 条不出现在 notes 段。"
+                        "⚠️ 本轮体检 skipped（本会话在跑 ⇒ busy）。")
+        hit += 1
+assert hit == 1, f"S12 节点命中数异常：{hit}"
+g["updated"] = datetime.datetime.now().isoformat(timespec="seconds")
+tmp = TG + ".tmp-s12"
+json.dump(g, open(tmp, "w", encoding="utf-8"), ensure_ascii=False, indent=2)
+os.replace(tmp, TG)
+print("[1] 任务图 S12 -> await-verify  OK  (bak:", os.path.basename(BAK), ")")
+
+# 2) 出队：删 claims/S12
+if os.path.isdir(CLAIM):
+    holder = os.path.join(CLAIM, "holder")
+    who = open(holder, encoding="utf-8").read().strip() if os.path.exists(holder) else "(无 holder)"
+    shutil.rmtree(CLAIM)
+    print("[2] claims/S12 已删（出队）  holder =", who)
+else:
+    print("[2] claims/S12 不存在（本就未取件登记）⇒ 无需出队，未做任何删除动作")
+
+# 3) 落地一份可核对的出队/待核对记录（append）
+rec = os.path.join(INBOX, "advance.md")
+line = ("\n- **2026-10-02 22:1x · S12 出队 · 状态＝待核对（await-verify）** —— "
+        "机制排查与修复-S12-一次性排期清理 ｜ 一次性排期在册 **9 → 0**（逐条停用，⛔未删行，integrity ok）｜ "
+        "recurring 3→3、未跑 once 2→2（无误伤）｜ ⛔ 29 条为旧读数，现场 9 条 ｜ "
+        "产物 `机制排查与修复/S12_清理报告_20261002.md` ｜ 判据：等下次体检报告确认 notes 段已无这 9 条再转 done\n")
+with open(rec, "a", encoding="utf-8") as f:
+    f.write(line)
+print("[3] advance.md 已追加待核对记录  OK")
+print("DONE")

归档/接续历史/机制排查/S12_清理报告_20261002.md

@@ -0,0 +1,84 @@
+# S12 清理跑完仍在册的一次性排期 — 执行报告
+
+- **执行会话**：机制排查与修复（协作会话·任务类别「机制排查与修复」）｜接手**队首 S12**
+- **执行时间**：2026-10-02 22:0x–22:1x
+- **域锁**：`ai1net-dsh-server/机制排查与修复`（独占执行锁已抢到，收尾已释放）
+- **改动通道**：**直连 SQL**（⛔ 未用 `automation_update` 工具 —— 见 §4）
+
+## 1. 一句话结论
+
+✅ **改前在册 9 条 → 改后在册 0 条**，9 条全部由 `ACTIVE` 改为 `PAUSED`，⛔ **一行未删**（总行数 141 → 141），
+`PRAGMA integrity_check` = **ok**。周期排期 3 条、待跑的一次性排期 2 条读数**前后完全一致**（未误伤）。
+
+## 2. 改前 / 改后计数（只读盘点 + 改后回读）
+
+1. **改前只读盘点**：`BEFORE_ONCE_ACTIVE_NO_NEXT = 9`
+   （判据：`deleted_at IS NULL AND status='ACTIVE' AND schedule_type='once' AND next_run_at IS NULL`）
+2. **改后回读**：`AFTER_ONCE_ACTIVE_NO_NEXT = 0` ⇒ 验收通过（判据：应为 0）
+3. 🔴 **prompt 里说的「29 条」不成立** —— 现场数是 **9 条**。此前 S11 记的 29／30 条是 **09-18 点前的旧读数**；
+   那批里的绝大多数在 18:0x–18:2x 那一棒已被 `deleted_at` 软删（总行数已从 141 之前的更高值降到 141），
+   只剩这 9 条「跑完但仍在册」的漏网。**本轮以现场盘点为准，不按任何转述数字下手。**
+
+## 3. 逐条改动明细（每条改完立即回读核对，⛔ 不把「返回成功」当「已生效」）
+
+1. 全部 9 条走 `UPDATE automations SET status='PAUSED', updated_at=? WHERE id=? AND <判据>`
+   —— **逐条单发 + 逐条回读**，⛔ 不是一条批量 UPDATE 了事。
+2. 每条回读四元组 `(status, schedule_type, next_run_at, deleted_at)` 全部 = `('PAUSED','once',None,None)`，
+   且 `cursor.rowcount == 1` ⇒ **9/9 全 OK**（明细见下表）。
+
+| # | 排期名 | id | 改后读数 | 判定 |
+|---|---|---|---|---|
+| 1 | `[协作]-[会话协作自检]-S6 建齐三类会话` | `a50a1791…` | PAUSED/once/next=NULL | OK |
+| 2 | `[协作]-[机制排查与修复]-S5 修主会话可响应` | `3872e203…` | PAUSED/once/next=NULL | OK |
+| 3 | `[协作]-[机制排查与修复]-S8 常驻投递载体（重派·锁已清）` | `73f138ce…` | PAUSED/once/next=NULL | OK |
+| 4 | `[协作]-[机制排查与修复]-S9 投递目标忙判据复核与放行验证` | `5c77eedc…` | PAUSED/once/next=NULL | OK |
+| 5 | `[协作]-[机制排查与修复]-S9 投递目标忙判据（含 S8 常驻复核）` | `9ec39dac…` | PAUSED/once/next=NULL | OK |
+| 6 | `[协作]-[机制排查与修复]-哑火判据与排期清理` | `5e335e01…` | PAUSED/once/next=NULL | OK |
+| 7 | `[协作]-[机制排查与修复]-投递链路真因接续` | `4e7b8401…` | PAUSED/once/next=NULL | OK |
+| 8 | `[协作]-[机制排查与修复]-清理跑完的一次性排期` | `a2982f2e…` | PAUSED/once/next=NULL | OK |
+| 9 | `[跟进]-机制排查与修复-队列跟进` | `9a06e9b8…` | PAUSED/once/next=NULL | OK |
+
+## 4. 三条硬纪律的执行方式
+
+1. ✅ **数字自盘自核**：先只读盘点（`BEFORE=9`），再取目标行列表（`TARGET_ROWS=9`），
+   脚本内 `assert before == len(rows)` —— 不一致直接停手。**未采信任何转述数字。**
+2. ✅ **⛔ 不用 `automation_update` 工具**：全程直连 `sqlite3` + SQL。
+   （上一棒的 P0-26 实测：工具按 `owner_user_id` 属主过滤，越界时返回 `success:true` 但 `deleted_at` 恒为 NULL
+   ⇒ **报成功、实则零动作**。直连 SQL 是本轮唯一有效通道。）
+3. ✅ **每条改完立刻回读**：见 §3，9/9 逐条核对 `rowcount` + 四元组。
+
+## 5. 活库铁律遵守情况
+
+1. ✅ **只走 SQL**（`UPDATE`），⛔ 未做任何文件级 `cp` / `mv` —— 避开 WAL 三件套错位。
+2. ✅ **必带 `busy_timeout`**：`connect(timeout=20)` + `PRAGMA busy_timeout=10000`。
+3. ✅ **改完跑 `integrity_check`**：`PRAGMA integrity_check` = `ok`（改前也先跑了一次做基线）。
+4. ✅ **⛔ 不删行**：只用 `status='PAUSED'` 停用；`TOTAL_ROWS` 141 → 141。
+
+## 6. 误伤回归检查（⛔ 明确不许碰的东西，读数前后一致）
+
+1. **周期排期（recurring）**：`RECURRING_ACTIVE` 改前 **3** → 改后 **3** ⇒ **一条没少**。
+   （这 3 条是唤醒/跟进线与日报的时钟，⛔ 不能动。）
+2. **待跑的一次性排期（`next_run_at` 非空）**：改前 **2** → 改后 **2** ⇒ 未被误伤。
+3. **一次性排期整体**：`PAUSED` 组 17 条（改前）保持不变，**未新增未预期变更**。
+4. **本会话自己的排期**：脚本内 `assert aid != SELF`（`45d4e2d4…`）—— 本会话排期不在目标集合内，**拒改保护已生效**。
+5. **⛔ 未碰 `follow` / `waker` 两条周期排期**（它们在 recurring 3 条内，读数未变即证）。
+
+## 7. 遗留 / 待核对
+
+1. 🔴 **「待核对状态」已写进队列与任务图**（S12 节点 `status` = `await-verify`，⛔ 不标 done）。
+   标 done 的判据是**有可核对产物**，而本轮产物是「计数 9→0」这一条读数，
+   需**下一次 `collabd.py --once` 的体检报告**确认这 9 条不再出现在 notes 段 ⇒ 才可转 done。
+2. ⚠️ **体检报告本轮大概率仍不刷新**：`health()` 开头有 `skipped=V["busy"]`
+   —— **本自动化会话正在跑** ⇒ 恒 skipped；且 `health_every=300s` 有节流戳。⇒ 下一棒若仍自判，需等窗口。
+3. ⚠️ **`queue.json` / `queue.md` / `NEXT.md` 是 `collabd.py` 的派生产物**，⛔ 不手改（会被下个 tick 覆写）。
+   本轮按规矩**删 claim 出队**即可让程序自己重算队首。
+4. ⚠️ **prompt 的「29 条」与现场「9 条」不一致**这件事已在上报里写明，**未擅自按 29 条操作**。
+
+## 8. 脚本落点（本域目录内，可复跑核验）
+
+- `S12_一次性排期盘点_20261002.py` —— 只读盘点（改前读数 + 目标行全字段 + integrity 基线）
+- `S12_一次性排期停用_20261002.py` —— 逐条停用 + 逐条回读 + 回归检查 + `integrity_check`（含 `assert` 自保护）
+
+⚠️ 两个脚本**都可重复执行**：第二次跑 `S12_一次性排期停用` 会因 `BEFORE=0` 且 `TARGET_ROWS=0` 而空转通过（幂等）。
+
+（报告完 · 域锁已释放）

归档/接续历史/机制排查/S14_整体改造方案_20261002.md

@@ -0,0 +1,55 @@
+# 整体改造方案 · 会话只留两类（主会话 + 协作会话）
+
+> 🔴 **用户 2026-10-02 23:36 指令逐字**：「按照新的逻辑整体修改」
+> 前一条逐字：「按照之前的讨论 唤醒会话  跟进会话  和 上报程序 都去掉才对」
+> 再前一条逐字：「上报机制也不需要了」
+> 口径已落在 `collabd.py:2293`（早于本轮）：「创建检查会话的为 协作程序
+> （**现在不需要上报机制了、之前已经去掉 唤醒会话和跟进会话机制**）」
+
+## 一句话目标
+
+**会话类别从四类收敛为两类**：① 主会话 ② 协作会话。
+唤醒会话、跟进会话、队列上报链路**整套退役**；检查会话由**协作程序**按四道闸建。
+
+## 一、要改哪些（按依赖顺序，⛔ 一处一处改、每处改完即验）
+
+1. **`scripts/collabd.py` 角色表** —— `parse_session_name()` 去掉 `waker` / `follow` 两类
+   ＋ 主会话候选排除元组 `("worker","waker","follow")` 收到 `("worker",)`
+   ＋ `_scan_follows()` / `follow_for_topic()` / `_deliver_str()` 的收件人路由**整段退役**
+2. **`scripts/board.py` + `assets/board.html`** —— 架构图从「主／唤醒／跟进／协作」四格
+   改成**主会话 + 协作会话两格**；`board_ext.py` 的 `triggers`（唤醒节点）退役
+3. **`scripts/hooks/wb-result-hook.py`** —— 🔴 **只拆「上报」这一动作**
+   （`maybe_run_supervisor` / `maybe_run_collabd_once` / `maybe_run_supervisor_tick` / 投递调用），
+   ⛔ **保留** `_authorized_now()`（授权闸，`collabd.py:4420` 指名依赖）、
+   ⛔ **保留** `maybe_sweep_logcap()`（日志闸）、`maybe_inject_session_gap()`（缺口注入）
+4. **`scripts/session-rules-check.py`** —— 自检项 ⑦⑪⑫ 按新口径重写
+   （⛔ 原「唤醒/跟进两台周期钟」判据作废，改为「**这两台不该存在**」＝反向判据）
+5. **`SKILL.md` / `references/architecture.md` / `references/collab.md` / `references/collab-detail.md`**
+   —— 四类 → 两类；⛔ 逐处改，不留「四类」残影（含 frontmatter description）
+6. **`scripts/selftest.py`** —— 角色对账用例按新表重写（⛔ 断言不许写死期望值）
+7. **`references/pitfalls.md`** —— 新增本次改造的坑（⛔ 不改旧条，只增）
+
+## 二、⛔ 三条硬约束（本次改造特有）
+
+1. **⛔ 不删文件，只退役** —— 全部改法＝`status=PAUSED` ＋ 代码标「已退役」＋ 路径改名指向。
+   可逆、零丢失。
+2. **⛔ 不整删 `wb-result-hook.py`** —— 它兼授权闸。删了并发锁授权面失控。
+3. **⛔ 不在 S13 还在改 `session-rules-check.py` 时动第 4 项** —— 同一文件两个会话必互相覆盖。
+   ⇒ **顺序：等 S13 跑完 → 再整体改。**
+
+## 三、验收判据（⛔ 全是机读，⛔ 不看页面像不像）
+
+1. `sessions` 表里 `[唤醒]` / `[跟进]` **新会话数 = 0**（旧记录可留，`status` 为 completed）
+2. `automations` 表里 `[唤醒]` / `[跟进]` 命名 ⇒ `status='PAUSED'`
+3. `/board.json` 的 `front._missing` 或 `front` **无 20090 链路**（直读 JSON，⛔ 不看页面）
+4. `selftest.py` **PASS 数 ≥ 改前**，且新加的「两类」断言**非恒真**
+   （⚠️ 变异法：把角色表改回四类，新断言必须报红）
+5. `py_compile` 全过；`PRAGMA integrity_check=ok`
+6. 🔴 **重启看板**才生效（P0-17：**改了配置也必须重启**，`C` 是模块级加载一次）
+
+## 四、需要用户拍板的点（⛔ 不自决）
+
+**看板要「唤醒」那两格完全消失，还是保留灰格标注「已退役」？**
+- 候选 A：**完全消失**，架构图只两格。优点：干净。缺点：丢失「为什么没有」的线索。
+- 候选 B：**保留灰格 + 标「已退役 · 2026-10-02」**。优点：可追溯。
+- **倾向 B** —— 与本项目一贯「过期会话收起但不删除」的口径一致。

归档/接续历史/运行治理/接续包_投递链路真因_20261002.md

@@ -0,0 +1,87 @@
+# 接续包 · 投递链路真因定位与「跟进会话长活」口径更正
+
+> **线名**：多会话协作机制 · 投递链路（「投不进跟进会话」）
+> **建档**：2026-10-02 10:00 ｜ **上一棒**：本会话（上下文 187,506 token 触发 §G 阈值而交接）
+> **上游依据**：`.workbuddy/memory/2026-10-02.md`（09:45–10:00 两节 ＝ 完整证据链）＋ `交付物/投递链路-真因定位-20261002.md`（复核单）
+> ⛔ **不要重做**：六层判读链实测｜`goal.json` 还原｜`limit 50`／cwd／角色解析／空库／`custom_title`／零宽字符 —— **六项已逐个排除**，别再重查
+
+---
+
+## §0 开工第 0 步（固定）
+
+1. 跑 `"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" "E:/ProgramData/AIProject/ai1net-dsh-server/state.py"`
+2. 判可锁定范围：`bash "E:/ProgramData/.workbuddy/skills/session-mechanism/scripts/lock/preflight-lock.sh" "<会话名>" <目标文件...>`
+3. 抢锁：要改 `collabd.py`／`architecture.md` ⇒ **属机制层 ⇒ 走独占**（抢不到即停手报告）
+4. 读本包 → 读 `CODEBUDDY.md §1.5 / §G` → 按 §2 动手
+5. 🔴 **本棒设工具调用上限 60 次**（成本机制：历史每轮全量重发，多跑一轮线性放大）
+
+---
+
+## §1 要解决的问题（一句话）
+
+🔴 **「投不进跟进会话」的真因不是「没有跟进会话」，而是「名册里的跟进会话都没在跑」** —— 而
+`_deliver_str` **丢弃了 `follow_for_topic()` 已经算准的 `why`**，把「有 6 条、只是都不活」记成
+`no-follow-session`（**字面意思与事实相反**）⇒ **这个错名把两天的排查引向了"再多建一条"，而多建不管用。**
+
+**六层判读链（实测，同路径插桩 `tmp/_tick_instrument.py`）**
+
+| # | 环节 | 实测 | 判读 |
+|---|---|---|---|
+| 1 | 目标类别表 | `_goal_topics()` = `['会话协作自检','机制排查与修复']` | 通过 |
+| 2 | 跟进名册 | `_scan_follows()` = 6 条，`by_topic` 两类齐 | 通过 |
+| 3 | 候选解析 | `cand=['57f58ecf']` | 通过 |
+| 4 | **活会话** | 只有主会话 `3f43ce71`（1 条），**候选不在其中** | 🔴 **卡这里** |
+| 5 | 判读 | `why='follow-not-live'` | 准确 |
+| 6 | 落库 | `skipped='no-follow-session'` | 🔴 **错名** |
+
+**错名源码**：`collabd.py:1545-1558` —— `_deliver_str` 只按 `_want==""` 分档，把
+**(a) 真·无候选** 与 **(b) 有候选但都不活** 合并成同一个 `no-follow-session`。
+
+---
+
+## §2 待办（按优先级）
+
+### P1 ① 修 `_deliver_str` 分档（⛔ 只改可读性、不改行为）
+把 `follow_for_topic()` 的 `why` 透传进 `skipped`，让 `follow-not-live` 与 `no-follow-session` **分开记档**，
+并让 `need_user()` 文本与之一致。**改前先查** `board.py` / `selftest.py` / 各判读脚本对这两个字符串的依赖。
+
+### P1 ② 🔴🔴 按**用户 2026-10-02 09:59 的新口径**复核并落地「跟进会话长活」
+**用户原话**（逐字）：
+> 「那是因为之前跟进就是跑在主会话的，用户发消息和跟进一起处理会卡，所以才把跟进独立成一个会话专门处理」
+
+**⇒ 口径更正（本棒最重要的一条）**：`architecture.md:142` 那条「⛔ 禁止把长跑服务放进会话后台任务」
+**其真实背景是「跟进跑在主会话上、与用户发消息抢占」⇒ 会卡**；**解决办法本来就是把它独立成一条会话**。
+**⇒ 跟进独立成会话之后，"它自己挂着长活载体"不再影响用户在主会话的操作 ⇒ 上一棒"不能挂"的结论作废。**
+
+**本棒要做的**：
+1. 复核 `architecture.md:142` 的**表述是否过度泛化**（把"别占主会话"写成了"任何会话都别挂后台任务"）⇒ 若确需修订，按锁流程改 **文档库** `02-架构设计/` 定稿（⛔ 过程档案只加头部状态块、不改正文）；
+2. 把「跟进会话**长期活着**」作为**默认形态**落地（载体优先级：常驻程序 > 会话后台任务；⚠️ 会话后台任务仍有**两个已知代价**，须在文档里写明：① 该会话自己的 idle 钩子被静默压制（实测有被僵尸任务压 6h20m、零日志的记录）② 会话结束即被宿主回收）；
+3. 与现有常驻 `--supervise` 的分工写清楚（谁负责把跟进会话带回来）。
+
+### P2 ③ 追踪 `goal.json` 被批量清空的来源
+09:45–09:49，`tmp/supervise-inbox/` 下 `goal.json`／`queue.json`／`NEXT.md`／`ledger.jsonl`／`status.md` 等**全被清空**，
+`NEED-USER.md` 16473 B → 419 B；🔴 **`_collabd.log` 零清理记录 ⇒ 不是常驻程序所为**，是外部动作。
+⇒ 建议给该目录的删除动作**加一道留痕**。
+
+### P2 ④ `S6` 排期 prompt 旧口径
+其验收标准仍写「每条都有**周期性自动化**作时钟」＝旧口径（今天已改为常驻程序承担）。
+
+### P2 ⑤ 会话堆积（用户 10-02 已抱怨）
+`automations` **只新建不复用** ⇒「需要跟进就排期」＝「每轮堆一条」。两条方向曾列（取消独立跟进会话角色／允许协作程序直插 `automations` 行——后者是双红线）。⚠️ **待用户拍板，⛔ 不擅自改。**
+
+---
+
+## §3 关键决定与已落地动作
+
+| 动作 | 状态 | 证据 |
+|---|---|---|
+| 还原 `goal.json` | ✅ 已做 | 源 `bak-goalctl-20261001/goal.json`，`md5 459bd66138b9069870a34acfc0e3208f` 两侧一致；还原前证据留 `tmp/_goal_restore_20261002/` |
+| 常驻自愈验证 | ✅ 通过 | 停掉 pid 48000 ⇒ 09:54:07 自动起 pid 10448（`--tick` 内 `ensure_supervise()`） |
+| ⛔ 未改任何机制代码 | — | 本轮全程只读 ＋ 一个文件还原；`collabd.py` **一行未动** |
+
+**§4 回滚点**
+- `tmp/_goal_restore_20261002/`（还原前目录快照 ＋ `_collabd.log` 副本）
+- `.workbuddy/collab/bak-goalctl-20261001/goal.json`（还原源，勿删）
+
+**§5 只读取证脚本**（都在 `tmp/`，⛔ 不入库）
+`_tick_instrument.py`（同路径插桩，**最有价值**）｜`_tick_trace.py`（全链路中间量）｜`_gt_probe.py`（`goal.json` 与类别表）

归档/接续历史/运行治理/接续包_日志事前叫停_20261001.md

@@ -0,0 +1,194 @@
+# 接续包 · 会话日志「事前叫停」机制落地
+
+> **线名**：多会话协作机制 · 会话哑掉 / 日志根因
+> **建档**：2026-10-01 10:24 ｜ **上一棒**：`98f1fd43`（本包作者，因**上下文 120,576 token** 触发 §G 阈值而交接）
+> **上游依据**：`.workbuddy/memory/2026-10-01.md` **§二十三 / §二十四 / §二十五**（三节＝完整证据链，本包只给结论与动作）
+> ⛔ **不要重做**：`04-调整方案/151`（已入库）｜`_deaf_sids()` 缺陷（已修完，PASS 38 / FAIL 0）
+
+---
+
+## §0 开工第 0 步（固定）
+
+1. 跑 `"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" "E:/ProgramData/AIProject/ai1net-dsh-server/state.py"`
+2. 判可锁定范围：`bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/preflight-lock.sh" "<会话名>" <目标文件...>`
+3. 抢锁：`bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" --claim-exec "<会话名>" --domains ai1net-dsh-server/`
+   🔴 **本棒要改钩子 ⇒ 属机制层 ⇒ 走独占**（⛔ 不带 `--domains`；抢不到即停手报告）
+4. 读本包 → 读 `CODEBUDDY.md §1.5 / §G` → 按 §2 动手
+
+---
+
+## §1 要解决的问题（一句话）
+
+🔴 **单次工具调用被宿主写成 ≈37 KB 诊断日志（152 行 × 244 B，零去重零节流）**
+⇒ **≈283 次工具调用写满 10 MiB ⇒ 宿主 `diagnostic-log:dropped` 丢行 ⇒ 会话静默哑掉（用户零感知）**；
+而**全平台没有任何机制在「快哑了」时叫停** —— §G 的阈值①钩子侧自动检测**至今未实现**，`_deaf_sids()` 只管「哑了以后不许再投」。
+⇒ **只做了事后拦截，没做事前叫停。**
+
+**关键实测（本轮新增，勿再重测）**
+
+| 读数 | 值 |
+|---|---|
+| 单次调用日志成本 | **152 行 × 244 B ≈ 37 KB** ⇒ `10 MiB ÷ 37 KB ≈ **283 次调用**` = 一个会话的寿命 |
+| 日志行型 | `tool_call_update` 占 **96.8%**（40,107 / 41,448 条 dispatch） |
+| 两个时钟 | 日志 **375 KB/分**（28 分钟撞顶） ↔ 上下文 **6,100 tok/分**（300K 要 47 分钟）⇒ 日志早 19 分钟 |
+| 换算基准 | **1 tok ≈ 63 B 日志**（1 MiB ≈ 16,000 tok） |
+| 本包作者自证（10:16→10:23） | 7 分钟写 **2,647,624 B**（≈379 KB/分）⇒ 与上表吻合 |
+
+---
+
+## §1.5 🔴 补充实测（10:27 补 · 决定「杠杆归属」，本棒必读）
+
+**结论先行：日志量与挂钟时间无关，只与「工具调用」成正比 ⇒ 唯一直接杠杆＝压调用次数。**
+
+| 读数（`5f607d3e` 实测） | 值 | 说明 |
+|---|---|---|
+| 帧总数 | 40,107 | 全部是 `tool_call_update` |
+| **有帧的秒数** | **336 秒** | ⚠️ 日志跨度却是 **1,694 秒** ⇒ **80% 的时间一个字节都不写**（等模型／等用户不产帧） |
+| 每秒峰值 | **437 帧** | 帧是**突发**的，不是稳态轮询 |
+| 帧／调用 | **135**（40,107 ÷ 297 次 `tool_call`） | 每次调用爆发约 1 秒的帧瀑布 |
+| 有帧秒数 ÷ 调用数 | 336 ÷ 297 ≈ **1.13 秒／次** | 一次调用 ≈ 1 秒写盘窗口 |
+
+⇒ **日志量 = 调用次数 × 135 帧 × 244 B（≈33 KB／次）**；⛔ **不是**「挂钟时间 × 速率」（已证伪：80% 的秒无帧）。
+⇒ **杠杆排序**：① **压次数**（唯一直接）② **压单次帧数 135**（⚠️ 待验证：同一条命令「输出 1 行 vs 输出 1000 行」的帧数差；若成立 ⇒ 大输出先落盘只读关键行能直接降日志）。
+
+**🔴 新线索（⛔ 未结论 · 留给本棒或后续）：丢行 ↔ 轮转失败强相关**
+
+| 会话 | 文件 | 轮转件 | 丢行 |
+|---|---|---|---|
+| `5f607d3e` | 10,485,717 B | **0 个** | 3,309 行 |
+| `f8a792ab` | 10,485,715 B | **0 个** | 153 行 |
+| `ac8de40d` | **3,739,688 B** | **0 个** | **677 行** |
+| `a202550c` | 4.35 MB ＋ `.log.1/.2/.3` 各 10 MiB | **3 个** | **今日无** |
+
+⇒ ① **有轮转的没丢行**（`a202550c` 写满 34 MB 仍活着）；
+⇒ ② `ac8de40d` **仅 3.74 MB 就丢 677 行** ⇒ 丢行**不止发生在 10 MiB**，内存队列（`PER_FILE_MAX_LINES=4,000` / `PER_FILE_MAX_BYTES=2 MiB`）**先于磁盘上限丢**；
+⇒ ③ ⇒「**让轮转可靠发生**」是一条**真正直接**的路（轮转一次＝日志回到 0，会话寿命翻倍）。
+⚠️ **假设（⛔ 未证）**：Windows 上 rename 需 `FILE_SHARE_DELETE`；若轮转瞬间该文件正被别的进程打开 ⇒ `ROTATE_UNAVAILABLE` ⇒ 退避＋积压＋丢行。**验证法**：在会话写满前用 `handle.exe` / `openfiles` 抓占用者。
+
+**⇒ 件 2 据此升级**：不只「合命令」，还要**给每棒定调用预算** —— 软 **200 次**⇒开始收尾／硬 **250 次**⇒停手建接续（物理上限 ≈283 次）。它比 token 阈值**更直接**：直接对应日志字节。
+
+---
+
+## §1.6 🔴 第四次追问的答案：264 次调用**都在干什么**（10:3x 补 · 本棒必读）
+
+> 取证＝转录 `providerData.argumentsDisplayText`（**每次调用的真实命令文本**，⛔ 不是聚合猜测）
+
+| 在重复的事 | 次数 | 机制原因 |
+|---|---|---|
+| 跑 python（绝大多数是 `state.py`） | **27** | 状态只能靠"跑一次"得到 |
+| 同一条 `export PATH=…` 修 PATH | **18** | 🔴 **工具调用间不共享 shell 状态** ⇒ 每条命令都要重新前置 |
+| `cd …/skills/multi-session-collab` | 15 | 协作脚本每次先 cd |
+| 读**同一份** `memory/2026-10-01.md` | **12** | 唯一台账 ⇒ 反复读 |
+| 读技能/规则（三个技能目录各 ~6） | ~25 | **新会话无上下文** ⇒ 每棒重读 |
+| 临时探针 `probe-*.py`（**29 个**） | 29 写＋29 跑＋7 清 | 🔴 一次结论一个新脚本 |
+
+⇒ **可见重复开销 ≥ 110 次（≈4 成）**；⛔ 别用正文出现次数（`state.py` 152 / `export PATH` 133 含引用）当执行次数。
+⇒ **12 次模型请求承载 264 次调用 ⇒ 平均 22 次/轮，最大轮 ≈90 次**。⇒ 不是"人问得多"，是**一轮里 agent 自己串了几十次**。
+⇒ 🔴 **"项目文件乱"占比很小**：全程 `Grep` 仅 11 次、几乎无全库搜索；`tmp/` 1618 个文件是**探针残留（结果）**不是原因。
+
+**⇒ 三条工程改造（"直接解决上涨过快"的正解，与件 1/件 3 并列，⛔ 本轮不做、登记待排）**
+1. **无状态环境** ⇒ 做一个**统一入口**（一条命令带子命令：查状态／跑探针／取读数），把 **27＋18＋15＝60 次压到个位数**；
+2. **单点台账** ⇒ `state.py` 加 `--json` 落盘，**只在开工／收尾／交接三个节点跑**；
+3. **一次性探针** ⇒ 预置**参数化通用探针**并允许复用（本机"tmp 用完即清"逼出重写）。
+⇒ 目标：**264 次 → 100 次以内**（会话寿命从 ~28 分钟拉回 1 小时以上）。
+
+---
+
+## §2 解决方案（四件，按优先级）
+
+### 件 1 🔴 【治本 · 补机制缺口】**事前叫停钩子**（本棒主线）
+
+- **载体**：新增一个钩子脚本，放文档库 `07-scripts/`（与既有 hook 同目录），注册进钩子配置（先查 `.codebuddy/` 与 `.workbuddy/` 下现有钩子配置，⛔ 别自造新体系）。
+- **挂点**：`PostToolUse`（每次工具调用后）＋ `UserPromptSubmit`（每次注入消息到达时）。
+- **判据（只读日志文件大小，⛔ 绝不改/删生产日志）**：
+  - 路径：`<configDir>/logs/<YYYY-MM-DD>/sdk/conversations/<session_id>.log`（`configDir` 实测 `E:/ProgramData/.workbuddy`；`session_id` 从 hook stdin JSON 取）
+  - `os.path.getsize()` 即可（⛔ 不 grep 整个日志文件 ⇒ 否则钩子自己拖慢会话）
+  - ≥ **5 MiB** ⇒ emit「🟡 日志已 50%：开始写交接材料」
+  - ≥ **8 MiB** ⇒ emit「🔴 日志已 80%：立刻停手 ＋ 按 §G 建接续会话」
+  - 次数档（可选，同源）：软 **200** / 硬 **250** 次工具调用
+- **硬纪律**：
+  - 必须 `sys.stdout.buffer.write(bytes)`（⛔ 否则文案含 `⛔` ⇒ `UnicodeEncodeError` ⇒ stdout 空 ⇒ **静默放行**）
+  - **去抖**：同一会话、同一档位**只报一次**（状态落 `tmp/`，原子替换写法，⛔ 别用文件锁 —— 本机实测会 `rc=124` 卡死）
+  - 钩子**开不了新会话** ⇒ 它只负责「叫」，交接四步由会话自己做（§G 步骤 2–4）
+- **验收判据**：
+  1. 造一个 > 5 MiB 的会话日志（或临时替身文件 + 环境变量指向），确认 emit **出现且只出现一次**；
+  2. 未达阈值时**零输出**（⛔ 不许刷屏）；
+  3. 钩子单次耗时 **< 50 ms**。
+
+### 件 2 【治本 · 降密度】把「压工具调用次数」落成**可执行手法**
+
+⛔ 不新建规则文件 —— 补进 `CODEBUDDY.md` 成本律／§G 那一节即可。手法：合并命令一次取多个读数｜大输出 `> tmp/x.txt` 后 `sed -n`／`grep -c`｜⛔ 不 `cat` 大文件｜⛔ 不 `ls -laR`｜同一文件一次读完。
+⚠️ **未验证**：帧数是否随单次输出量线性增长 ⇒ 所以「合并」必须**同时减少输出量**，⛔ 不是把大输出塞进一条命令。
+
+### 件 3 【口径统一】阈值改成**按日志定**，写进 `CODEBUDDY.md §G`
+
+| 档 | 日志 | ↔ 上下文 | ↔ 时间 | 动作 |
+|---|---|---|---|---|
+| 🟡 软 | **5 MiB** | ≈ 80,000 tok | ≈ 14 分钟 | 开始写交接材料 |
+| 🔴 硬 | **8 MiB** | ≈ 128,000 tok | ≈ 22 分钟 | 立刻停手 ＋ 建接续会话 |
+| （新增档） | 工具调用 **200 / 250 次** | — | — | 同上两档动作 |
+
+现值 36 K **建议废弃**（36K ÷ 6,100 ≈ **5.9 分钟**一换，28 分钟内要换 ~5 次 ⇒ 成本 ×5、收益 0）。
+**待用户拍板**才替换（见 §4）。
+
+### 件 4 【上报宿主】（⛔ 不改官方主程序）
+
+整理一份可提交宿主的缺陷报告落 `交付物/`：
+① `tool_call_update` 不在 verbosity 过滤名单（`main/conversations.js::shouldLogEventMachineDispatch()`）；
+② 会话诊断日志零去重零节流，而宿主**自家 daemon 日志**有「scope+level+首参」指纹限流（同指纹 1 秒最多 5 条）；
+③ 达 `PER_FILE_DISK_MAX_BYTES` 后**丢行而非轮转**（`5f607d3e` 零轮转文件 vs `a202550c` 有完整轮转且没哑）。
+
+---
+
+## §3 本棒交付门禁
+
+改的是**钩子（机制层）** ⇒ 生效链路＝「钩子配置 → 下一次工具调用即生效（钩子无需重启宿主）」。
+⛔ 四条自我安慰不算交付：改完了／build 过了／本地打包了／commit 了。**必须在真实会话里看到 emit 出现。**
+收尾：反序释放锁（`--release` → `--release-exec "<会话名>"`）＋ 三层沉淀 ＋ 提交边界（未明确要求不 commit/push）。
+
+---
+
+## §4 待用户拍板（⛔ 未拍板前按「倾向」实施，勿扩大）
+
+1. **上下文阈值取哪个**：36 K（最省 token、6 分钟一换）／**80 K（倾向，＝日志软 5 MiB）**／128 K（重启最省，但交接余量只剩 2 MiB，实测交接烧 ~1.9 MiB ⇒ 风险高）。
+2. **是否把「日志两档」写成主阈值**（软 5 MiB / 硬 8 MiB），并**新增第三档按工具调用次数**（软 200 / 硬 250，上限 ≈283）——理由：它比 token 更准，直接对应日志行数。
+
+---
+
+## §6 🔴 口径修正（2026-10-01 13:2x 补 · 本会话自证 · **改优先级排序，务必先读**）
+
+> 触发：用户追问「**就一轮对话 日志就到 4.68 说明 调用工具和日志异常增长的问题还在**」⇒ 用本会话 `ee3c2d82` 实测。
+
+| 读数 | 值 | 与 §1.5 的关系 |
+|---|---|---|
+| 文件字节 ÷ `tool_call` 次数 | 6,225,488 B / **166 次** = **37,502 B/次** | ✅ **与 §1.5 的 "37 KB/次" 独立复核吻合** |
+| `tool_call_update` 帧 ÷ 次数 | 24,047 / 166 = **144 帧/次** | ✅ 与 §1.5 的 "135 帧/次" 吻合 |
+| 活跃 8 分钟（12:35–12:43） | 20,220 行 ≈ 5.0 MB ⇒ **≈630 KB/分**；**调用频率 ≈20 次/分** | §1.5 的会话约 10.5 次/分 ⇒ 频率翻倍 |
+| 其后空闲 34 分钟（12:43–13:17） | **0 行** | ✅ **坐实"只与工具在跑有关、与挂钟无关"** |
+| `event-machine:dispatch` 行占比 | **97.8%**（20,464 / 20,925） | 🆕 **新发现** |
+| 单行字节 | **249 B** | 与 "244 B/帧" 吻合 |
+| 真正有内容的行 | **仅 461 行（2.2%）** | 🆕 只记真事件 ⇒ 这份日志 ≈115 KB |
+
+🔴 **结论修正（🟢 修正的是我自己，⛔ 不是推翻 §1.5）**
+1. ✅ **§1.5 的系数成立**：≈145 帧 = **≈37 KB/次**。
+   ⛔ **本 §6 早先一版曾写"≈400 行 / 100 KB 每次" —— 那是拿错误的调用次数（我估 50 次，实为 166 次）算出来的，已作废。**
+2. 🔴 **病根是"调用次数多"，不是"每次调用贵"**：本会话 8 分钟跑 **166 次（≈20 次/分）** ⇒ 5.9 MB；
+   而 §1.5 的会话 10.5 次/分。**调用频率翻倍 ⇒ 日志速率翻倍**。
+   ⇒ **唯一直接杠杆仍是"压调用次数"** —— §1.6 的三条工程改造正是冲这个去的，**优先级应再上调**。
+3. ⛔ **撤回我自己的一条推断**：我一度写"单次命令跑得越久、帧越多" ⇒ **无实测支撑，撤回**
+   （§5 已撤回同源的「agent 连续跑长命令」，我差点把已撤回的结论重新写回来）。
+4. 🔴 **97.8% 零信息心跳是独立新发现**（成立）：只有 `requestId` ＋ 四个恒为 `false` 的布尔位在变。
+   ⇒ **件 4（上报宿主）份量应上调** —— 这不是调阈值能解决的，是**日志本身 95% 是噪音**。
+
+🔴 **件 1 的性质（⛔ 别误读）**：`session-log-guard.py` **只叫停、不降速**（已上线并验收，见日志 §三十九）。
+用户追问的那句 —— **完全成立**。真正降速的三条（件 2 压次数／件 4 上报噪音／修轮转可靠发生）**仍全未做**。
+
+---
+
+## §5 ⛔ 不要重做 / 撤回清单
+
+- ⛔ 不再做方案单（`04-调整方案/151` 已入库，09:49）
+- ⛔ 不再查 `_deaf_sids()`（已修完）
+- ⛔ 不改官方主程序 / `app.asar`；⛔ 不动生产日志一字节
+- **已撤回的三处结论**：⛔「agent 连续跑长命令」｜⛔「压缩导致」｜⛔「91 种载荷 ⇒ 重复 330 次」
+- ⚠️ 附带观察（⛔ 不结论）：`5f607d3e` 零轮转而 `a202550c` 有轮转 ⇒ 轮转失效原因未查

归档/接续历史/运行治理/接续包_日志增长治理_20261001.md

@@ -0,0 +1,161 @@
+# 接续包 · 会话日志「异常增长」治理
+
+> **线名**：多会话协作机制 · 会话哑掉 / 日志根因
+> **建档**：2026-10-01 13:40 ｜ **上一棒**：`ee3c2d82`（**因日志达硬档 8.04 MiB 交接** —— 即件 1 钩子首次真实触发）
+> **上游依据**：`.workbuddy/memory/2026-10-01.md` **§三十九（件 1 落地）／§四十（增长实测 + 自我更正）**
+> **任务来源**：用户原话 **「那就解决这几个问题」**（承接「就一轮对话 日志就到 4.68 说明 调用工具和日志异常增长的问题还在」）
+
+---
+
+## §0 开工第 0 步（固定 · ⛔ 顺序不许换）
+
+1. 跑状态：`"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" "E:/ProgramData/AIProject/ai1net-dsh-server/state.py"`
+2. 读本包 → 读 `CODEBUDDY.md §G`（含新增的 **§G·1 压日志增长四条硬纪律**）
+3. 抢锁：本棒**要改钩子 / 规则 / 技能 ⇒ 机制层 ⇒ 走独占**（⛔ 不带 `--domains`）：
+   `bash "D:/github/dsh_shenxian/dsh-server-docs/07-scripts/handoff-guard.sh" --claim-exec "<会话名>"`
+   **抢不到 ⇒ 停手 + 报告**（R9）｜完工 `--release` → `--release-exec "<会话名>"`（反序）
+
+---
+
+## §1 上一棒已完成（⛔ 不要重做）
+
+1. ✅ **件 1 事前叫停钩子已上线并验收** —— `07-scripts/session-log-guard.py`，挂 `PostToolUse` ＋ `UserPromptSubmit`，
+   已在**真实会话**里看到注入（🟡 与 🔴 两档都真触发过）。详见 `memory §三十九`。
+2. ✅ **`07-scripts/` 定域** —— `preflight-lock.sh` 的 `MECHANISM_RE` 补了 `session-log-guard.py`、
+   一直缺登的 `bash-output-guard.py`、以及 `preflight-lock.sh` 自身。【D】归零。
+3. ✅ **件 2（压次数纪律）已落 `CODEBUDDY.md §G·1`** —— 四条硬纪律（含"分母不许估"）。
+4. ✅ **件 4（宿主缺陷报告）已落** `交付物/宿主缺陷报告-会话诊断日志-20261001.md` —— 三条缺陷 ＋ 复现命令 ＋ 量化基线。
+
+---
+
+## §1.5 🔴 决定性发现（2026-10-01 13:4x · 已写进缺陷报告 · **本线最高优先**）
+
+**宿主源码级定位（只读取证，⛔ 未改任何宿主文件）：`app.asar`（主进程包，偏移 ≈117,230,304）里**
+
+```js
+function shouldLogEventMachineDispatch(sessionUpdate, replayingHistory, completeAssistantStream) {
+    if (shouldLogContent()) return true;              // env WB_CONVERSATION_LOG_CONTENT === "1" ⇒ 全开
+    if (replayingHistory) return false;               // 历史回放帧 ⇒ 丢
+    if (completeAssistantStream) return true;         // turn 收口帧 ⇒ 必写
+    return !STREAM_CHUNK_UPDATES.has(sessionUpdate ?? "");
+}
+var STREAM_CHUNK_UPDATES = new Set(["agent_message_chunk", "agent_thought_chunk"]);
+```
+
+🔴 **读法**：宿主**本来就有**"高频流式帧不落盘"的机制（主动丢掉正文 chunk），
+**但 `tool_call_update` 漏在这个集合外** ⇒ 而它正是占 **97.8%** 的那一类。
+⇒ **一行改动即可让日志量降 ≈98%**（37 KB/次 → 约 0.7 KB/次；撞顶调用数 280 → 约 14,000）。
+
+⇒ **对任务的影响**：
+- **任务 B（轮转）降级** —— 只要"日志不再涨得离谱"，轮转是否可靠就不再是瓶颈。
+  ⇒ 修正为：**先不动它**，把它并入缺陷报告即可（已并入）。
+- **任务 D（新）＝ 把这份一行补丁送到宿主** —— 报告已备好：`交付物/宿主缺陷报告-会话诊断日志-20261001.md`。
+  ⛔ 我方**不改 `app.asar`**（红线 + 升级即覆盖）⇒ 这一项**只能提交**，本地做不到。
+- ⚠️ **本地无"静默档"可用**：唯一相关 env 是 `WB_CONVERSATION_LOG_CONTENT=1`，且它是**反方向**（全落盘）。
+  ⇒ ⛔ 不要浪费时间找本地开关（已穷尽）。
+
+---
+
+## §2 🔴 本棒真正要做的（按优先级 · 一次只做一件，做完即停）
+
+### 任务 0 🔴【先做 · 最省】**把宿主缺陷报告提交出去**
+
+> 报告已就绪并**已含一行补丁**（`交付物/宿主缺陷报告-会话诊断日志-20261001.md`）。
+
+- **做什么**：把该报告交给宿主研发（或按平台既有渠道上报）。⛔ 不需要再写一份。
+- **验收**：报告已被送出／已进交付渠道（产出证据，⛔ 不是"我写完了"）。
+
+### 任务 A 🔴【唯一本地直接杠杆】**把"压调用次数"落成可执行的东西**
+
+> 依据：日志 ≈ **调用次数 × 37 KB**（实测 144 帧/次）。**压次数是唯一能自己动的杠杆**。
+> 参考 §1.6 已算过：一轮里**可见重复开销 ≥110 次（≈4 成）**。
+
+- **做什么**：扩建**统一入口** `$WS/scripts/dsh.py`（已有 `open` / `close`），给它加**只读子命令**，
+  把 `state.py` 反复跑（实测 27 次）、`export PATH=…` 重复前置（18 次）、`cd`（15 次）**压到个位数**。
+  建议子命令：`stat`（合并取状态/锁/git/日志水位）｜`probe <名>`（参数化通用探针，⛔ 别再一次结论一个脚本）｜`size`（本会话日志水位）。
+- ⚠️ **先跑 `preflight-lock.sh`** 确认 `scripts/dsh.py` 的归类；**属全平台共用 ⇒ 独占锁**。
+- **验收**：跑一次入口即可拿到原先要 3~4 条命令才有的读数；并在 `CODEBUDDY.md §1.5 A` 把入口写成**首选**（已部分如此）。
+
+### 任务 B 【治本 · 需先取证】**轮转为何不可靠**
+
+> 🔴 新证据（2026-10-01 实测，⛔ 别重测）：同日同目录下
+> `cb60cb60` / `5f607d3e` / `f8a792ab` **精确停在 10,485,7xx B 且零轮转件**；
+> 而 `a202550c` **有 `.log.1/.2/.3` 各 ≈10 MB**（轮转时刻 00:56 / 01:14 / 01:39）⇒ **轮转能力存在，但非必然**。
+- **做什么**：① 在宿主 bundle 里找轮转实现（⛔ **只读，绝不改 `app.asar`**；
+  ⚠️ 注意 `cli/dist/codebuddy-lite-wb.mjs` 里**没有**这些常量 ⇒ 大概率在**主进程包**，先用 `asar-peek` 类手法定位）；
+  ② 判定"轮转失败 ⇒ 静默丢行"是否成立；③ 若找到**可控开关**（如配置项）⇒ **这就是最省的治本**，落地它。
+- ⛔ **不许**为了试轮转而重命名/删除生产日志（Windows 占用 + 宿主持有 ⇒ 必失败且可能有副作用）。
+
+### 任务 C 【口径统一】§G 档 3（工具调用 200 / 250 次）**仍未接线**
+
+- `stop-dialog-guard.py` 现为 `BUDGET_TOOLS=80` / token `12万/20万/30万`，与 §G 的 **200/250** 和 **220K** 不一致。
+- **做什么**：把该脚本的常量与 §G 对齐（⚠️ 同属机制层 ⇒ 独占锁；改完**必须**在真实会话验一次注入）。
+
+---
+
+## §3 🔴 关键读数（⛔ 别重测 · 2026-10-01 实测）
+
+| 指标 | 值 |
+|---|---|
+| 每次工具调用日志量 | **144 帧 = 37,502 B（≈37 KB）** |
+| 单帧字节 | **249 B**（与"244 B/帧"口径吻合） |
+| `event-machine:dispatch` 占比 | **97.8%**（20,464 / 20,925）—— **零信息**（只有 `requestId` ＋ 四个恒 `false` 布尔位） |
+| 真正有内容的行 | **461 行（2.2%）** ⇒ 只记真事件该文件 ≈115 KB |
+| 活跃速率 | **≈630 KB/分**（8 分钟 166 次调用 ⇒ 5.9 MB，≈20 次/分） |
+| 空闲速率 | **0 行 / 34 分钟** ⇒ 🔴 **与挂钟无关，只与"工具在跑"有关** |
+| 撞 10 MiB 的调用数 | `10 MiB ÷ 37 KB ≈ 280 次`（实测撞顶会话 264~297 次 ⇒ 吻合） |
+
+---
+
+## §4 ⛔ 不要重做 / 撤回清单
+
+- ⛔ 不再做 `04-调整方案/151`（已入库）｜⛔ 不再查 `_deaf_sids()`（已修完）
+- ⛔ 不改官方主程序 / `app.asar`；⛔ **不动生产日志一字节**
+- ⛔ 不重做件 1（钩子已上线验收）｜⛔ 不重做定域｜⛔ 不重写 §G·1 四条纪律
+- 🔴 **本棒自己撤回的两条（⛔ 别再写回来）**：
+  1. ⛔「每次调用 ≈400 行 / 100 KB」—— **错**，成因＝**拿估的调用次数当分母**（实为 166 次，我估 50 次）。
+  2. ⛔「单次命令跑得越久、帧越多」—— **无实测支撑**，且与 §5 已撤回的「agent 连续跑长命令」同源。
+- ⛔ **不许动自动化排期**（心跳与唤醒轮 A·B 维持 PAUSED ＝ 正确态；要重启协作须用户下「执行 XXX 目标」）
+
+---
+
+## §5 🔴 工具调用预算（本线硬约束 · 与 §G 同源）
+
+- 本会话寿命实测 ≈ **280 次**工具调用（37 KB/次）⇒ **软 200 次开始收尾、硬 250 次停手**。
+- 🔴 **每轮开工先看日志水位**（`stat -c%s "$CODEBUDDY_CONFIG_DIR/logs/$(date +%F)/sdk/conversations/<sid>.log"`）。
+- 手法：合并命令一次取多个读数｜大输出落盘只读关键行｜同一文件一次读完｜⛔ 不 `cat` 大文件。
+
+---
+
+## §6 交付门禁
+
+改的是**钩子 / 规则 / 脚本**（机制层）⇒ 生效链路＝「改完即生效（钩子无需重启宿主）」。
+⛔ **四条自我安慰不算交付**：改完了 / build 过了 / 本地跑通了 / commit 了。
+⇒ **任务 A/C 必须在真实会话里看到效果**；任务 B 必须有**源码或实测**证据，⛔ 不许给推断。
+收尾：反序释放锁 ＋ 三层沉淀（skill / 教训 / 记忆）＋ 提交边界（未明确要求不 commit/push）。
+
+---
+
+## §7 进度追加（只增不改 · 后续棒开工先读这里）
+
+- ✅ **任务 0 已完成**（2026-10-01 13:4x · 会话 `334140d1`）—— 报告已投递用户交付渠道。
+  🔴 **口径修正**：本机**无**程序化上报宿主的通道（已穷尽检索：全文关键词零命中 / 无上报先例 / 无宿主收件地址 /
+  内置 Agent Mail 需用户当场确认）⇒ 实际"送出"＝**交到用户手上，由用户转投官方反馈**。⛔ **别再重复检索这条路**。
+  ⇒ ⛔ **后续棒不要再做任务 0**；直接从 **任务 A** 开始。
+  ⇒ 细节见 `.workbuddy/memory/2026-10-01.md §四十一`。
+- ✅ **任务 C 已完成**（2026-10-01 13:5x · 会话 `334140d1`）—— `07-scripts/stop-dialog-guard.py` 常量已与 §G 对齐：
+  `BUDGET_TOOLS` **80 → 200**（档 3 软档）＋ **新增 `BUDGET_TOOLS_HARD = 250`**（档 3 硬档 ⇒ 进三级）｜
+  `BUDGET_STRONG` **200000 → 220000**（档 1 交接触发点）｜`BUDGET_TOKENS = 120000` **保留**（＝§G 原话的「120K 中途提示」）｜
+  `BUDGET_FORCE = 300000` **保留**为兜底（§G 未定义，已在常量注释里显式标注「⛔ 别拿它当 §G 档位」）。
+  另顺手修掉一条**真错**：`LV_PREFIX[3]` 硬写「已过 30 万」⇒ 由**调用次数**触发三级时会报错数，已改成泛化表述。
+  ⇒ 验收：**边界矩阵 8/8 ＋ 端到端注入 3/3 全绿**（跑**真脚本 ＋ 真 payload**：250 次⇒三级强制收口；22 万⇒二级且文案已写 22 万；199 次/5 万⇒不注入）。
+  ⇒ ⛔ **后续棒不要重做任务 C**；剩余 **任务 A**（入口扩建）与 **任务 B**（轮转取证）。
+  ⚠️ **未推服务器**（`/opt/dsh/docs`）—— 按 `CODEBUDDY.md §4` 提交边界（未明确要求不 commit/push），留给下一棒或用户。
+  ⇒ 细节见 `.workbuddy/memory/2026-10-01.md §四十二`。
+- 🔵 **任务 A 的定位已复核**（用户 2026-10-01 问「挡住工具调用日志写入后 这个还有必要做吗」）⇒ **结论：保留，不撤**。
+  · **修复落地前**：日志仍是主约束（≈280 次调用撞 10 MiB）⇒ 压次数**仍是唯一的本地保命杠杆**。
+  · **修复落地后**：日志约 **825 B/次**（由实测 `37,502 B/次` × `2.2% 有内容行占比` **推算**，⛔ 非新实测）⇒ ≈**1.3 万次**才撞顶；
+    但压次数**仍有两个与日志无关的收益**：① §G 档 1 的 220K 上下文阈值独立存在，调用次数是其直接来源；② 成本 ≈ 单价 × 一轮调用次数。
+  ⇒ **停掉它 ＝ 把会话寿命押在宿主的排期上** ⇒ ⛔ 不撤，只是从「保命」变「保命＋省钱」。
+  ⛔ **另加一条禁令**：⛔ 不许为了"挡住写入"去给生产日志**改权限／设只读／改名** —— 会同时毁掉唯一的取证载体（会话日志是排查"会话哑掉"的唯一证据），
+    且违反 `§G·1` 第 4 条「⛔ 不许动生产日志一字节」。

归档/接续历史/运行治理/接续包_钩子超时治理与SessionEnd真相_20261002.md

@@ -0,0 +1,85 @@
+# 接续包 · 钩子超时事故治理 ＋ SessionEnd 真相（2026-10-02 17:13 更新）
+
+> 读之前先跑：`"E:/ProgramData/.workbuddy/binaries/python/versions/3.13.12/python.exe" "E:/ProgramData/AIProject/ai1net-dsh-server/state.py"`
+> 本包 md5 见文末。**开工前重算校验**，不符即停并报告「口径已更新，需重新接续」。
+
+## 0. 目标
+
+用户报障：`UserPromptSubmit operation blocked by hook: wb-result-hook.py: Hook timed out after 20000ms`
+⇒ **工作区所有会话无法执行**（发话被拦、跑命令被拖）。
+要求：**彻底解决**，并且回答「会话干完活为什么没法通知到队列」。
+
+## 1. 已完成（每项都有实测读数，⛔ 不是"改完了"）
+
+1. **钩子超载修复**（文件 `E:/ProgramData/.workbuddy/skills/session-mechanism/scripts/hooks/wb-result-hook.py`）
+   - 三处改后台：`maybe_inject_session_gap` 删 `_sync` 同步兜底 ⇒ 一律 `_bg`；`maybe_run_collabd_once` 改 `_bg`；`maybe_deliver_gateway_token` 改 `_bg`。
+   - 备份：`wb-result-hook.py.bak-fulltimeout-20261002-1620.py`（更早一版 `.bak-hooktimeout-20261002-1520.py`）。
+2. **自身硬闸**（根治复发）：`set_budget()` 内起 `threading.Timer(daemon=True)` 守 `预算-0.5s`，到点 `log()` 后 `os._exit(0)`。
+   - 实测：注入 30s 同步慢活的副本 ⇒ **17.85s 自行退出**，距 20s 上限余 2.2s。
+3. **空事件名留痕**：`event` 为空时落 payload 全文（见第 6 条，已升级为全量留痕）。
+4. **稳态复检**：8/8 钩子 0.05~0.29s 全绿（`_probe_all_hooks.py`，17:13 复跑）；`hook.log` 尾部除修复前那次 12819ms 外全部 1~27ms。
+5. **协作回路未受损**：常驻投递存活、心跳新鲜；python 进程无堆积。
+6. 🔴 **SessionEnd 接线完成（17:13 · 本轮核心产物）** —— 「空事件名」不再是死路：
+   - 新增 `_recover_event(payload)`：**按 payload 形态反推**事件名（含 `prompt`⇒UserPromptSubmit／含 `tool_name`⇒PreToolUse／只有 `session_id`+`transcript_path`⇒SessionEnd，**推不出就返回空、退回丢弃**）。
+   - 新增 `_dump_unknown_event()`：空事件名时把 **payload 原文 ＋ 相关 env ＋ argv** 落到 `tmp/supervise-inbox/_unknown-event-<sid>.json`（同 session 只留一份，⛔ 不刷屏）。
+   - 实测三档（`tmp/_verify_sessionend_wire.out`）：
+     | 用例 | 反推结果 | 产物 |
+     |---|---|---|
+     | A 只有 session_id/cwd/transcript_path | `SessionEnd` | ledger ＋1、**`gate-done.stamp` 被创建**（此前"至今不存在"）、0.44s |
+     | B 带 prompt | `UserPromptSubmit` | 走注入分支 1900B stdout，**未误写放行**、0.31s |
+     | C 空 payload | `''` | 丢弃但留痕，**未误放行**、0.11s |
+   - 测试污染已清：`_cleanup_sessionend_test.py` 回读核对 —— 留痕 0 份、ledger 归零、`gate-done.stamp` 已删（⛔ 不留假放行信号）。
+   - 备份：`wb-result-hook.py.bak-sessionend-20261002-1710.py`。
+
+## 2. 在途
+
+- **反推正确性待真实样本复核**：`_recover_event` 的判据是按形态推的（⛔ 没有真样本硬证）。下次真实空事件出现时会自动落 `_unknown-event-<sid>.json` ⇒ 拿它核对一次即可定论。
+  ⚠️ 15:34:19/20/21 那三次空事件发生在留痕代码之前 ⇒ **没有留下原文**，别拿它们当判据。
+- 沉淀已完成：`references/pitfalls.md` 新增 **P0-23**（四条硬规则）；本轮结论建议并入 **P0-24**（空事件名 ⇒ 形态反推 ＋ 全量留痕，⛔ 不猜、⛔ 不等）。
+
+## 3. 未完成 / 未处置
+
+1. **钩子装在全局** `~/.workbuddy/settings.json` ⇒ 跑在**所有工作区全部会话**上；其自身 docstring 明写「⛔ 不要装全局」。止血后（0.29s）全局无害 ⇒ **未挪动**（属影响面变更，待用户点头）。
+2. **S11**（体检哑火判据 + 清理跑完不回收的一次性排期）仍在队列 `tmp/supervise-inbox/NEXT.md` 里 `todo`。
+3. **技能改动未推服务器**、未做 md5 双端一致。
+4. **队列仍缺活会话**：`NEED-USER.md`（16:58）记着「跟进会话不活 ⇒ 不投」；本轮接线只解决"信号能发出"，**接的人还得是活会话**。
+
+## 4. 下一步（按优先级）
+
+1. 等下一次真实空事件 ⇒ 读 `tmp/supervise-inbox/_unknown-event-<sid>.json` ⇒ 核对 `_recover_event` 反推是否与宿主本意一致（**唯一未闭环的一项**）。
+2. **不依赖事件的方案**（接续包上一版 §4.2，仍有效、可作为兜底）：常驻进程直接**读宿主库**判完成 —— `sessions(id, cwd, title, status, updated_at)`、`automation_runs(status, updated_at)`。证据：`tmp/_probe_sessionend.py` C 段。⇒ 本轮接线后这条路不再紧急。
+3. 处置第 3 节四项（S11 优先）。
+
+## 5. 关键决定
+
+- **秒级预算的钩子里，「兜底同步」是伪需求**：注入物是建议不是判据，本轮拿不到就少注入一段，⛔ 不为此等待。
+- **⛔ 别信"实测均值"，要信"硬超时"**（`--once` 均值 0.5s、超时却是 12s）。
+- **脚本必须自带硬闸**，否则任何后来者加一个同步活就原样复发。
+- 🔴 **推翻旧结论**：「SessionEnd 从不投递」**是错的**。真相是「**来了但没被认出来**」（payload 事件名为空）。旧结论来自把 `ledger.jsonl` 不存在当判据 —— 那个判据本身不成立。
+- 🔴 **空事件名不许"等"也不许"猜"**：被动等下一次留痕 = 无限期；直接猜成 SessionEnd = 有误放行风险。
+  ⇒ 正确解：**按形态反推 ＋ 全量留痕**，推不出就退回丢弃 —— 三条路都有留痕，⛔ 不静默。
+- ⚠️ **测完必须清污染**：放行信号（`gate-done.stamp`）与 ledger 都是队列判据，测试写入 = 假放行 ⇒ 必须回读核对清零。
+
+## 6. 回滚点
+
+- 回滚本次接线：`cp <hooks>/wb-result-hook.py.bak-sessionend-20261002-1710.py <hooks>/wb-result-hook.py`
+- 回滚整轮钩子改动：`cp <hooks>/wb-result-hook.py.bak-fulltimeout-20261002-1620.py <hooks>/wb-result-hook.py`
+- 技能文档：`git -C <仓库> checkout -- <...>/references/pitfalls.md`（若已入库）
+- ⛔ 回滚后**钩子超载会立刻复发**（20s 被掐 ⇒ 所有会话无法发话）⇒ 回滚前必须有替代止血手段。
+
+## 7. 取证脚本（都在 `E:/ProgramData/AIProject/ai1net-dsh-server/tmp/`，可重复运行）
+
+| 脚本 | 用途 |
+|---|---|
+| `_verify_hook_timing.py` | 含"缓存已删"最坏路径的钩子耗时实测 |
+| `_probe_all_hooks.py` | 同事件**每一个**钩子全量计时（17:13 ⇒ 8/8 绿） |
+| `_health_after_hookfix.py` | 止血后五点体检（常驻/堆积/稳态/功能/台账） |
+| `_verify_hard_gate.py` | 硬闸实测（注入 30s 慢活的副本） |
+| `_probe_sessionend.py` | SessionEnd 投递取证 ＋ 宿主库字段盘点 |
+| `_probe_hookpayload.py` / `_probe_hookpayload2.py` | 扫宿主 `app.asar` 找 payload 字段名（结论：`hook_event_name` 字面量 **0 命中**） |
+| `_verify_sessionend_wire.py` | **本轮**：空事件名三形态反推验收（A/B/C） |
+| `_cleanup_sessionend_test.py` | **本轮**：测试污染清理 ＋ 回读核对 |
+
+## 8. 本包 md5
+
+见下方（登记 automation 时写入）。