技能包：配置与代码分家 —— 每包自建 env/ 放本机专属配置，scripts/ 不再写死本机路径

用户 2026-10-11 原话：
· 19:22「这个环境都是针对一台机器的，同步到别的机器把环境都搞坏了」
· 19:28「不用挪出 用env文件夹区分就行，重点是 脚本是脚本 配置是配置」
· 19:29「每个技能 需要环境配置的 都有自己的 env文件夹」
· 19:30「修改完成后要仔细检查 避免调整后 各技能脚本运行失败」

改动：
1、session-mechanism 新增 env/（roots.env＝本机真身不入库 ＋ roots.env.example＝样例入库），
   install.py 的 ROOTS_ENV 改指 env/roots.env；全包脚本/hook 的配置定位统一为
   「向上 4 层 × env/roots.env 优先 → 包根 roots.env 兼容 → 技能库那份兜底」。
2、去硬编码：collabctl / keepalive / supervise-launch / board-launch 里的本机路径与本机工作区
   清单全清，改为 DSH_AIROOT（兜底 dirname(DSH_WS_ROOT)）＋ 扫 <AIROOT>/*/.workbuddy/collab/
   自动发现；保活任务名按 collabd-keepalive-<工作区名> 现推；启动器默认值改 ~/.workbuddy 形态。
3、browser-harness：bh_chrome_keepalive.py 默认值全部改 env 驱动，新增 env/bh.env.example。
4、.gitignore：env/ 下只放行 *.example（三行三种层级）＋ 兜住旧位置的包根 roots.env。
5、改包纪律.md 新增「四、包结构：脚本是脚本，配置是配置」，立为全仓通用规矩。
6、文档同步：SKILL.md / deploy.md（新增 §3b 配置层级、§6 换机器必查 6 件事）/ rules.md /
   pitfalls.md / supervise-persistence.md。

验收（本机）：py_compile 34 个 py 全过；selftest PASS 109 / FAIL 0；
逐文件实证 8 个 loader 命中 env/roots.env；preflight-lock.sh 同目录实测解出两个根；
install.py --manifest 77 份、语法失败 0。

异机验证（包拷成「新克隆」（只有 *.example）＋ 另造假工作区 ws-alpha/ws-beta）：
install.py --apply 自生成该机 env/roots.env；collabctl/keepalive 自动发现的确实是
ws-alpha/ws-beta、任务名现推（写死清单确已消除）；部署副本本地无 roots.env 时靠
CODEBUDDY_CONFIG_DIR 兜底读到技能库那份；整套 selftest 有宿主库时 PASS 108 / FAIL 1
（唯一 FAIL＝该区没有常驻心跳，环境所致；本机常驻在跑时同一套为 PASS 109 / FAIL 0）。

session-mechanism/scripts/workspace_mirror.py

@@ -5,7 +5,7 @@
 
 🔴 为什么必须有这个工具（不是"又写个脚本"）
   · 副本是**整目录拷贝**出去的 ⇒ 全局删掉/新增的文件，副本**不知道**，会静默留着
-  · 副本的 `roots.env` 是**工作区专属**的 ⇒ ⛔ 不能盲目整目录覆盖（会把工作区指向冲回别人）
+  · 副本的 `env/roots.env` 是**工作区专属**的 ⇒ ⛔ 不能盲目整目录覆盖（会把工作区指向冲回别人）
   · 于是每次同步都变成"人肉算差异＋人肉挑例外" ⇒ **迟早漏**（实测已漏过：mut_run.py 差点没补上）
   ⇒ 正确解法：**让"例外的例外"由工具自己知道**，并且**能自证没漂移**。
 
@@ -18,7 +18,7 @@
         python workspace_mirror.py --list-keep
 
 🔴 三条白名单（**有意保留副本自己的东西，不是残留**）
-   1. `roots.env`            —— 工作区专属键。被覆盖 ⇒ 副本会去读写**另一个仓库**
+   1. `env/roots.env`        —— 工作区专属键（2026-10-11 起落本包 `env/`）。被覆盖 ⇒ 副本会去读写**另一个仓库**
                               （`setdefault` 兜底：宿主 env 没设时注入本文件的值）
    2. `副本使用说明.md`      —— 副本独有的口径文档
    3. `install.log`          —— 副本自己的安装历史（追加式）
@@ -50,7 +50,7 @@ SELF_SUFFIX = (".pyc", ".pyo", ".tmp", ".swp", ".mirtmp")
 #    而 SKILL.md 应当**跟着全局走**（它是版本的一部分）⇒ 只需在残留判定里豁免。
 IDENT_MARK = "SKILL.md"
 NEVER_DELETE = (IDENT_MARK,)          # ⛔ 算残留时跳过 ⇒ 删了副本就废了
-KEEP = ("roots.env", "副本使用说明.md", "install.log")
+KEEP = ("env/roots.env", "副本使用说明.md", "install.log")
 # 备份目录名前缀（`_find_in_prior_backups` 靠它认出"这是历史备份" ⇒ ⛔ 改名要同步改那里）
 BK_PREFIX = "session-mechanism-副本备份-"
 
@@ -104,7 +104,7 @@ def _find_in_prior_backups(keep_lost, bk_root: Path):
        原实现把**本次刚建的备份**当兜底源 ⇒ 但 `copytree` 发生在**丢失之后**
        ⇒ 那份备份里**必然也没有**这个文件 ⇒ 兜底永远捞不到。
     ⇒ 正解＝翻**先前**留下的备份，按时间**从新到旧**找第一份命中的。
-    ⛔⛔ **绝不拿全局那份顶替** —— 全局 `roots.env` 指向**别的仓库**，
+    ⛔⛔ **绝不拿全局那份顶替** —— 全局 `env/roots.env` 指向**别的仓库**，
        填进去 = 把"副本悄悄指错仓库"变成"副本明确指错仓库"，⛔ 更坏。
     """
     found = {}
@@ -196,10 +196,10 @@ def do_sync(gpkg: Path, copy_dir: Path) -> int:
         print("⛔ %s 不像技能副本（没有 SKILL.md）⇒ 不动" % copy_dir)
         return 2
     # 🔴 2026-10-04 修：白名单**缺失**也算漂移。
-    #    `diff()` 刻意排除 KEEP（免得每次都报它们）⇒ 副本的 `roots.env` 没了
+    #    `diff()` 刻意排除 KEEP（免得每次都报它们）⇒ 副本的 `env/roots.env` 没了
     #    ⇒ 差异表里**一个字段都不动** ⇒ 早先直接走"无漂移，幂等返回"，
     #    白名单兜底层**永远没机会跑**。而这恰恰是最该救的场景：
-    #    `roots.env` 丢了 ⇒ 副本按位置推导 ⇒ 去读写**别的仓库**（静默指错）。
+    #    `env/roots.env` 丢了 ⇒ 副本按位置推导 ⇒ 去读写**别的仓库**（静默指错）。
     #    ⇒ 这里单独查一遍。
     # 🔴🔴 修第二版：「**全局侧有**」⛔ 不等于「副本**该**有」。
     #    实测踩到：全新副本本来就没有 `install.log`（从未安装过）⇒ 却被判成
@@ -217,8 +217,8 @@ def do_sync(gpkg: Path, copy_dir: Path) -> int:
     _, _, only_c, only_g, changed = diff(gpkg, copy_dir)
     if keep_lost:
         print("⛔ **白名单缺失**（副本历史里有过，现在没了）：%s" % "、".join(keep_lost)
-              + ("（⛔ `roots.env` 丢 ⇒ 副本会按位置推导去读写**别的仓库**）"
-                 if "roots.env" in keep_lost else ""))
+              + ("（⛔ `env/roots.env` 丢 ⇒ 副本会按位置推导去读写**别的仓库**）"
+                 if "env/roots.env" in keep_lost else ""))
     if not (only_c or only_g or changed or keep_lost):
         print("✅ 无漂移，⛔ 什么也不做（幂等）")
         return 0