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

@@ -42,6 +42,34 @@ import sys
 import time
 from ctypes import wintypes
 
+# 🔴 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()
+
 # ---------------------------------------------------------------- 常量
 # 🔴🔴 2026-10-05 **两条旧结论被实测推翻**（都在本机跑出来的，见 skill 的 pitfalls P0-71）：
 #   ① **`CREATE_BREAKAWAY_FROM_JOB` 在本机被拒** —— 带上它 `subprocess` 直接
@@ -60,18 +88,51 @@ HIDE = (0x08000000      # CREATE_NO_WINDOW（⛔ 没有它 ⇒ 闪黑窗）
 #    ⇒ **起进程直接失败**（2026-10-05 实测）。⇒ 起法＝**先试带、被拒退回不带**；
 #    **只读查询（`_ps`）一律直接用它**，⛔ 别试 breakaway（试了就是白失败一次）。
 HIDE_NO_BREAK = 0x08000000 | 0x00000008 | 0x00000200
-AIROOT = "E:/ProgramData/AIProject"
 HB_FRESH_S = 90          # 🔴 心跳新鲜阈值（与 `collabd.supervise_alive()` 同口径）
 
-# 🔴 **登记制**：要管哪些工作区，只在**这一处**登记（⛔ 别在各处各写一份路径清单）。
-WORKSPACES = [
-    "E:/ProgramData/AIProject/ai1net-dsh-server",
-    "E:/ProgramData/AIProject/vibe-product",
-    "E:/ProgramData/AIProject/contentm_agent",
-]
 
-# 看板：全局只一条（⛔ 不是每区一条）
-BOARD_PY = "E:/ProgramData/.workbuddy/skills/session-mechanism/scripts/board.py"
+def _resolve_airoot() -> str:
+    """工作区根所在的**父目录**。**DSH_AIROOT 优先**（`env/roots.env` 注入）；
+    兜底 ＝ `DSH_WS_ROOT` 的父目录。⛔ 不在代码里写死盘符/目录。
+
+    🔴 2026-10-11 用户报（原话）：「这个环境都是针对一台机器的，同步到别的机器把环境都搞坏了」
+       —— 旧版这里写死 `E:/ProgramData/AIProject`，同步到别的机器 ⇒ 路径不存在
+       ⇒ `on|ensure` 会**建出一批指向空路径的计划任务**。
+    """
+    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 cand.replace("\\", "/") if cand else ""
+
+
+def _discover_workspaces(airoot: str) -> list:
+    """**自动发现**要管的工作区：扫 `AIROOT` 下装了 `.workbuddy/collab/` 的目录。
+
+    ⛔ 不维护登记清单（登记＝写死 ⇒ 别的机器上要么漏、要么指向空路径；本机也踩过
+      「本区不在名单里 ⇒ 改名残留的旧任务谁都没扫到」的判断盲区）。
+    """
+    if not airoot or not os.path.isdir(airoot):
+        return []
+    out = []
+    for name in sorted(os.listdir(airoot)):
+        d = os.path.join(airoot, name)
+        if os.path.isdir(os.path.join(d, ".workbuddy", "collab")):
+            out.append(d.replace("\\", "/"))
+    return out
+
+
+def _keepalive_tasks(workspaces: list) -> dict:
+    """工作区 → 保活任务名。**由目录名推导**：`collabd-keepalive-<basename>`（⛔ 不写死字典）。"""
+    return {w: "collabd-keepalive-" + os.path.basename(w.rstrip("/\\")) for w in workspaces}
+
+
+AIROOT = _resolve_airoot()
+WORKSPACES = _discover_workspaces(AIROOT)
+
+# 看板：全局只一条（⛔ 不是每区一条）；**技能包内相对定位** ⇒ 换机器不用改。
+BOARD_PY = os.path.join(os.path.dirname(os.path.abspath(__file__)), "board.py")
 BOARD_PORT = 20099
 
 # 🔴🔴 2026-10-05 改（用户定案：「**常驻崩了，拉起来这个事儿，你不能也用计划任务起个程序吗？**」）：
@@ -81,11 +142,9 @@ BOARD_PORT = 20099
 #   ✅ 唯一合格载体＝**计划任务**（父链根与会话树无关 —— 实测：父进程已退出、链断在自己身上）。
 #   ✅ 动作＝**`pythonw.exe`**（GUI 子系统 ⇒ 不弹窗；⛔ 不是 `powershell.exe`，那是控制台程序）。
 #   ⇒ 所以本入口的 `on`/`ensure` 现在**建/启用这两组任务**，`off` **禁用它们＋杀进程**。
-KEEPALIVE_TASKS = {                      # 新形态：计划任务 → pythonw collabd.py --supervise
-    "E:/ProgramData/AIProject/ai1net-dsh-server": "collabd-keepalive-ai1net-dsh-server",
-    "E:/ProgramData/AIProject/vibe-product": "collabd-keepalive-vibe-product",
-    "E:/ProgramData/AIProject/contentm_agent": "collabd-keepalive-contentm_agent",
-}
+# 新形态：计划任务 → pythonw collabd.py --supervise。🔴 2026-10-11：**由工作区名推导**
+#   （`collabd-keepalive-<basename>`）—— 原为写死字典 ⇒ 换机器/改名即失效。
+KEEPALIVE_TASKS = _keepalive_tasks(WORKSPACES)
 BOARD_TASK = "dsh-board-keepalive"
 
 # 旧任务：一律**禁用**（⛔ 不删除，可逆）。它们是弹窗事故的来源（动作＝powershell.exe）。
@@ -551,7 +610,7 @@ def cmd_ensure():
     _p("── ensure：按开关收敛（on⇒补齐缺失的，off⇒全停）──")
     on_ws = [w for w in WORKSPACES if switch_of(w) == "on"]
     if not on_ws:
-        _p("  两区开关都 off ⇒ 走全停")
+        _p("  各区开关都 off ⇒ 走全停")
         cmd_off()
         return
     disable_tasks()          # 旧形态任务：见一次禁一次（新形态由 start_all 重建）
@@ -634,6 +693,13 @@ def main():
         except Exception as e:
             print("⛔ 打不开 --out %s：%r" % (out, e))
             return 1
+    # 🔴 2026-10-11 自适配：解析不到工作区根 ⇒ **优雅报错**，⛔ 不猜路径、
+    #   ⛔ 不去建指向空路径的计划任务（那就是用户说的"把环境搞坏了"）。
+    if not AIROOT:
+        _p("⚠️ 未解析到工作区根 ⇒ 本入口**不猜路径**。")
+        _p("   要什么：设 `DSH_AIROOT`（或 `DSH_WS_ROOT`），或先跑 `install.py --apply` 生成 `env/roots.env`。")
+        if a in ("on", "ensure"):
+            return 1
     try:
         if a == "status":
             cmd_status()