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

@@ -4,7 +4,7 @@ session-mechanism · 一键配置（换机器只需跑这一个）
 
 用法
   python install.py --dry-run     # 只打印将改什么（settings.json 的 diff），⛔ 不写盘
-  python install.py --apply       # 真装：写 roots.env → 按声明表接线全局钩子 → 初始化工作区
+  python install.py --apply       # 真装：写 env/roots.env → 按声明表接线全局钩子 → 初始化工作区
   python install.py --verify      # 装完自检：每个钩子空载荷 rc=0 ＋ collabd --where ＋ selftest
   python install.py --uninstall   # 还原 settings.json（与装前备份逐字节相同）
   python install.py --manifest    # 重算 references/manifest.md 的逐文件表（改完包**必跑**）
@@ -24,8 +24,11 @@ session-mechanism · 一键配置（换机器只需跑这一个）
   4. **可逆**：首次安装先留**原状**备份 `settings.json.bak-session-mechanism-orig`（⛔ 已存在不覆盖），
      其后每次 `--apply` 另写**带微秒**的时间戳备份（防同秒同名互相覆盖）；
      `--uninstall` **优先**用 `-orig`，还原后做**逐字节**比对，不符即报错。
-  5. **外置根目录**：写 `<包根>/roots.env` —— 因为 `settings.json` 的 hook 条目**没有 env 字段**，
+  5. **外置根目录**：写 `<包根>/env/roots.env` —— 因为 `settings.json` 的 hook 条目**没有 env 字段**，
      包内脚本搬一次就会静默指错（历史事故：台账写到别处、测试却全绿）。
+     🔴 2026-10-11 用户令（「脚本是脚本 配置是配置」⇒「每个技能 需要环境配置的 都有自己的 env文件夹」）：
+     **每台机器各不同**的配置一律放本包 `env/`；`scripts/` 只留通用代码。
+     样例 `env/roots.env.example` 入库，真文件 `env/roots.env` 不入库（见仓根 `.gitignore`）。
   6. **清单自算**：`--manifest` 只重写 `references/manifest.md` 的**表 ＋ 计数行 ＋ 重算时间**，
      ⛔ 不碰上面的「最近改动」散文 —— 那是人写的结论，脚本代笔会把它冲成流水账。
      包一改就得跑一次，否则表里的字节/md5 立刻过期（本项目已因此误判过两次）。
@@ -47,7 +50,8 @@ import time
 from pathlib import Path
 
 PKG = Path(__file__).resolve().parent
-ROOTS_ENV = PKG / "roots.env"
+# 🔴 2026-10-11：环境专属配置统一落本包 `env/`（⛔ 不再放包根）—— 「脚本是脚本 配置是配置」。
+ROOTS_ENV = PKG / "env" / "roots.env"
 LOG = PKG / "install.log"
 # 🔴 原状备份的**固定名**（首次安装、且当前 settings.json 无本包痕迹时才写；⛔ 已存在不覆盖）。
 #    有了它，`--uninstall` 不需要"从一堆时间戳备份里猜哪份是原状"。
@@ -332,10 +336,15 @@ def merge(settings: dict) -> dict:
 
 def write_roots(ws: Path, docs: Path | None, code: str | None, dry: bool) -> None:
     lines = [
-        "# session-mechanism · 根目录（由 install.py 生成，⛔ 请勿手改）",
+        "# session-mechanism · 环境专属配置（由 install.py 生成，⛔ 请勿手改）",
+        "# 位置：本包 `env/roots.env`（2026-10-11 起 —— 「脚本是脚本 配置是配置」）。",
         "# 说明：settings.json 的 hook 条目没有 env 字段 ⇒ 包内脚本靠本文件定位根目录。",
         "# 读取：各脚本头部 `_sm_load_roots()` 以 setdefault 注入 ⇒ **宿主 env 优先，本文件兜底**。",
         f"DSH_WS_ROOT={ws.as_posix()}",
+        # 🔴 2026-10-11 新键：工作区根（`DSH_WS_ROOT`）的**父目录**，例 `E:/ProgramData/AIProject`。
+        #    常驻管理脚本（collabctl/keepalive）靠它**自动发现**兄弟工作区（扫 `<AIROOT>/*/.workbuddy/collab/`），
+        #    ⛔ 不再把工作区清单写死在入库代码里（写死 ⇒ 同步到别的机器会建一批空路径计划任务）。
+        f"DSH_AIROOT={ws.parent.as_posix()}",
         f"WB_RESULT_HOOK_WS={ws.as_posix()}",
         # 🔴 2026-10-04 换机演练实测后加：`selftest.py` 的「生产工作区」判据要定位
         #    **使用方的部署配置**（它验的是生产数据）。⛔ 不可拿 `DSH_WS_ROOT` 拼 ——
@@ -356,6 +365,7 @@ def write_roots(ws: Path, docs: Path | None, code: str | None, dry: bool) -> Non
     if dry:
         log(f"[dry-run] 将写 {ROOTS_ENV}:\n{text}")
         return
+    ROOTS_ENV.parent.mkdir(parents=True, exist_ok=True)   # 🔴 env/ 可能还不存在
     ROOTS_ENV.write_text(text, encoding="utf-8")
     log(f"已写 {ROOTS_ENV}")
 
@@ -579,8 +589,10 @@ def cmd_uninstall(args) -> int:
 # 🔴 为什么固化进 install.py：包一改，表里的字节/md5 立刻过期 ⇒ **每轮都得重算**。
 #    以前每轮临时手搓一个脚本、跑完即删 —— 既浪费又会漏（本项目已因此误判过两次）。
 MANIFEST = PKG / "references" / "manifest.md"
-# ⛔ 不入表：运行日志 ＋ 表自身（写完即失真）
-MANIFEST_SKIP = {"install.log", "references/manifest.md"}
+# ⛔ 不入表：运行日志 ＋ 表自身（写完即失真）＋ **本机生成的配置**（2026-10-11 加：
+#   `env/roots.env` 每台机器一份 ⇒ 入表会让**入库的 manifest.md 随机器变**，
+#   别的电脑取仓即出现无意义 diff —— 与"配置不入库"同一条口径）
+MANIFEST_SKIP = {"install.log", "references/manifest.md", "env/roots.env"}
 
 
 def _manifest_syntax(p: Path) -> str: