技能包：配置与代码分家 —— 每包自建 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/references/supervise-persistence.md

@@ -136,16 +136,21 @@
 **`supervise-launch.py` 的四条实现要点**（见该文件头注，⛔ 别自己另写一份）：
 
 1. **它所在目录即本区 `.workbuddy/collab`** —— `collabd.py`／`collabd.config.json` 都在同目录，**用相对自身定位**（⛔ 别写死 `E:\`）；
-2. `CODEBUDDY_CONFIG_DIR` 用 `setdefault`（宿主 env 优先，兜底才写死）；`COLLABD_CONFIG` **必须指向本区**那份配置；
+2. `CODEBUDDY_CONFIG_DIR` 用 `setdefault`（宿主 env 优先，兜底值取 `os.path.expanduser("~/.workbuddy")` 形态，
+   🔴 2026-10-11 起不再写死本机盘符）；`COLLABD_CONFIG` **必须指向本区**那份配置；
 3. `pythonw.exe` 下 `sys.stdout/stderr` 可能是 `None` ⇒ **任何 `print` 都会 `AttributeError` 秒退** ⇒ 启动器自己兜到 `logs/_supervise-launch.log`；
 4. 用 `runpy.run_path(CB, run_name="__main__")`（⛔ **不用 `exec`**）—— `runpy` 会把 `__name__`/`__file__`/`sys.path[0]` 按"真在跑那个脚本"设好；
    且 `sys.argv` **由启动器自己补 `--supervise`** ⇒ **任务参数里 ⛔ 不要再写**。
 
 > 🔴 **重构"起法"时，旧起法里的 env 必须逐条搬**（P0-73 就是改成两层形态时**丢了 `CODEBUDDY_CONFIG_DIR` 这一句**）。
-> 🔴 **启动器里写死最稳**（⛔ 别指望 `roots.env` 兜住各区 —— 它只在技能目录，而各区副本在
-> `<ws>/.workbuddy/collab/`，`_sm_load_roots()` 向上 4 层**找不到**）。
-> ⚠️ **变量名坑**：`roots.env` 给的是 **`COLLABD_PROD_CONFIG`**，而 `board.py`／`collabd.py` 读的是
-> **`COLLABD_CONFIG`** ⇒ 名字对不上 ⇒ `roots.env` **兜不住**。
+> 🔴 **启动器把该设的 env 在进程内设好**（2026-10-11 起配置住本包 **`env/roots.env`**）——
+> ⛔ 别指望 `env/roots.env` 兜住各区副本：它只在技能包目录，而各区副本在
+> `<ws>/.workbuddy/collab/`，`_sm_load_roots()` 向上 4 层**找不到**。
+> ✅ 各区那一路的正确供法 ＝ **启动器设 env**（`COLLABD_CONFIG` 指本区那
+> 份）＋ 该区 `collabd.config.json` 兜底（`host_db` 可直接写本机绝对路径 —— 那**属于"每台机器各不同"的配置**，
+> 本就该落在本区配置里，⛔ 不是写进入库代码）。
+> ⚠️ **变量名坑**：`env/roots.env` 给的是 **`COLLABD_PROD_CONFIG`**，而 `board.py`／`collabd.py` 读的是
+> **`COLLABD_CONFIG`** ⇒ 名字对不上 ⇒ `env/roots.env` **兜不住**。
 
 
 ## 二、装法（⛔ 别自己写 `Register-ScheduledTask`）