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

@@ -30,7 +30,7 @@
       **已在 ⇒ 新起的立刻让位退出**（幂等，⛔ 不会"叠加成两条"）。
 
 **一键关掉（新增能力）**：本脚本支持 `off` ⇒ 一个动作做完四件事：
-   ① 关两区开关 ② 禁用所有相关计划任务 ③ 杀掉所有相关进程 ④ 打印复核结果
+   ① 关各区开关 ② 禁用所有相关计划任务 ③ 杀掉所有相关进程 ④ 打印复核结果
    ⇒ ⛔ 不再需要"禁用任务 ＋ 杀进程"分开记（10-05 就是因为只禁任务没杀进程，以为停了其实没停）。
 
 用法：
@@ -43,16 +43,78 @@ import os
 import subprocess
 import sys
 
-PYW = r"E:\ProgramData\.workbuddy\binaries\python\versions\3.13.12\pythonw.exe"
-AIROOT = r"E:\ProgramData\AIProject"
 
-# 🔴 登记制：工作区 → 保活任务名（⛔ 只在这里写一份）
-WS = {
-    "ai1net-dsh-server": "collabd-keepalive-ai1net-dsh-server",
-    "vibe-product": "collabd-keepalive-vibe-product",
-}
-# 看板：全局只一条
-BOARD_PY = r"E:\ProgramData\.workbuddy\skills\session-mechanism\scripts\board.py"
+# 🔴 2026-10-11：环境配置外置（「脚本是脚本 配置是配置」）⇒ 本包 `env/roots.env`。
+#    ⛔ 本文件**不写死**任何本机路径 / 本机工作区清单。
+def _sm_load_roots():
+    import os as _os
+    _here = _os.path.dirname(_os.path.abspath(__file__))
+    _cands = []
+    for _up in range(4):
+        _base = _os.path.normpath(_os.path.join(_here, *([".."] * _up)))
+        for _rel in (("env", "roots.env"), ("roots.env",)):
+            _cands.append(_os.path.join(_base, *_rel))
+    # 🔴 本机技能库那份兜底：工作区副本（`<ws>/.workbuddy/collab/`）靠它拿到「这台机器」的配置
+    #   ⇒ 全机单一真源（副本目录里⛔ 不放第二份，避免各区分叉）。
+    _conf = _os.environ.get("CODEBUDDY_CONFIG_DIR") or _os.path.expanduser("~/.workbuddy")
+    _cands.append(_os.path.join(_conf, "skills", "session-mechanism", "env", "roots.env"))
+    for _p in _cands:
+        if _os.path.isfile(_p):
+            try:
+                with open(_p, encoding="utf-8") as _f:
+                    for _ln in _f:
+                        _ln = _ln.strip()
+                        if _ln and not _ln.startswith("#") and "=" in _ln:
+                            _k, _v = _ln.split("=", 1)
+                            _os.environ.setdefault(_k.strip(), _v.strip())
+            except Exception:
+                pass
+            return
+_sm_load_roots()
+
+
+def _resolve_airoot() -> str:
+    """工作区根所在的**父目录**。**DSH_AIROOT 优先**（`env/roots.env` 注入）；
+    兜底 ＝ `DSH_WS_ROOT` 的父目录。⛔ 不在代码里写死盘符/目录。"""
+    cand = (os.environ.get("DSH_AIROOT") or "").strip()
+    if not cand:
+        ws = (os.environ.get("DSH_WS_ROOT") or "").strip()
+        if ws:
+            cand = os.path.dirname(ws.rstrip("/\\"))
+    return os.path.normpath(cand) if cand else ""
+
+
+def _discover_workspace_names(airoot: str) -> list:
+    """**自动发现**要管的工作区名：扫 `AIROOT` 下装了 `.workbuddy/collab/` 的目录。"""
+    if not airoot or not os.path.isdir(airoot):
+        return []
+    return sorted(n for n in os.listdir(airoot)
+                  if os.path.isdir(os.path.join(airoot, n, ".workbuddy", "collab")))
+
+
+def _resolve_pyw() -> str:
+    """`pythonw.exe`：优先**当前解释器**（`sys.executable`）；其次宿主 env；
+    兜底才在同目录**探测**兄弟 `pythonw.exe`。⛔ 不写死版本目录。"""
+    exe = os.path.abspath(sys.executable or "")
+    if exe and exe.lower().endswith("pythonw.exe") and os.path.isfile(exe):
+        return exe
+    for _k in ("DSH_PYTHONW", "PYTHONW", "DSH_PYTHON"):
+        _v = (os.environ.get(_k) or "").strip()
+        if _v and os.path.isfile(_v):
+            return _v
+    _sib = os.path.join(os.path.dirname(exe), "pythonw.exe") if exe else ""
+    if _sib and os.path.isfile(_sib):
+        return _sib
+    return exe or "pythonw.exe"
+
+
+AIROOT = _resolve_airoot()
+PYW = _resolve_pyw()
+
+# 🔴 工作区名 → 保活任务名：**由目录名推导**（`collabd-keepalive-<名>`）—— 原为写死字典 ⇒ 换机器/改名即失效。
+WS = {n: "collabd-keepalive-" + n for n in _discover_workspace_names(AIROOT)}
+# 看板：全局只一条；**技能包内相对定位**（⛔ 不写死绝对路径）
+BOARD_PY = os.path.join(os.path.dirname(os.path.abspath(__file__)), "board.py")
 BOARD_TASK = "dsh-board-keepalive"
 BOARD_PORT = 20099
 
@@ -245,13 +307,13 @@ def main():
     if not APPLY and CMD in ("on", "off"):
         print("（干跑）将要执行：%s —— 加 --apply 真做" % CMD)
         if CMD == "off":
-            print("  ① 关两区开关 ② 禁用 %d 个计划任务 ③ 杀相关进程 ④ 复核"
+            print("  ① 关各区开关 ② 禁用 %d 个计划任务 ③ 杀相关进程 ④ 复核"
                   % (len(WS) + 1 + len(OLD_TASKS)))
         else:
             for ws, t in WS.items():
                 print("  建任务 %s → 每 %d 分钟 pythonw collabd.py --supervise" % (t, INTERVAL_MIN))
             print("  建任务 %s → pythonw board.py --serve %d" % (BOARD_TASK, BOARD_PORT))
-            print("  禁用旧任务 %d 个；两区开关置 on" % len(OLD_TASKS))
+            print("  禁用旧任务 %d 个；已发现区的开关置 on" % len(OLD_TASKS))
         return 0
     if CMD == "status":
         cmd_status()