技能包：配置与代码分家 —— 每包自建 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）。

browser-harness/agent-workspace/bh_chrome_keepalive.py

@@ -33,9 +33,13 @@
 - **只用独立实例**：⛔ 不附着用户日常 Chrome（那是 9222，会弹「允许远程调试？」动到用户浏览器）。
 
 用法：
-    pythonw bh_chrome_keepalive.py --log "E:/ProgramData/.workbuddy/tmp/_bh_chrome.log"
+    pythonw bh_chrome_keepalive.py
     （整条命令见 SKILL.md「调 AI 工具」§1；本脚本要放在**会话的后台任务**里跑）
-可选：`--port` `--chrome` `--profile` `--proxy` `--log`（都有默认值，见下）
+可选：`--port` `--chrome` `--profile` `--proxy` `--log`
+
+🔴 **默认值从哪来（2026-10-11 起）**：先读本包 `env/bh.env`（每台机器一份，不入库），
+  其次宿主 env 的 `BH_*`；再兜底到「WorkBuddy 配置目录（`CODEBUDDY_CONFIG_DIR`，否则 `~/.workbuddy`）
+  ＋ tmp/…」。⛔ 代码里不写死本机路径 —— 要改就往 `env/bh.env` 里写（样例 `env/bh.env.example`）。
 """
 from __future__ import annotations
 
@@ -52,9 +56,39 @@ for _k in ("HTTP_PROXY", "HTTPS_PROXY", "http_proxy", "https_proxy"):
     os.environ.pop(_k, None)
 os.environ.setdefault("NO_PROXY", "127.0.0.1,localhost")
 
-DEFAULT_CHROME = r"C:\Program Files\Google\Chrome\Application\chrome.exe"
-DEFAULT_PROFILE = r"E:/ProgramData/.workbuddy/tmp/bu-chatgpt-profile"
-DEFAULT_PORT = 9223
+# [browser-harness] 环境专属配置外置（🔴 2026-10-11 用户令「脚本是脚本 配置是配置」⇒「每个技能
+#   需要环境配置的 都有自己的 env文件夹」）：**每台机器各不同**的值写本包 `env/bh.env`
+#   （本机生成、不入库；样例 `env/bh.env.example` 入库）。⛔ 代码里不写死本机路径。
+def _bh_load_env():
+    import os as _os
+    _here = _os.path.dirname(_os.path.abspath(__file__))
+    for _up in range(4):
+        _base = _os.path.normpath(_os.path.join(_here, *([".."] * _up)))
+        for _rel in (("env", "bh.env"), ("bh.env",)):
+            _p = _os.path.join(_base, *_rel)
+            if _os.path.isfile(_p):
+                try:
+                    with io.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
+_bh_load_env()
+
+# WorkBuddy 配置目录：宿主 env 优先，其次 `~/.workbuddy`（⛔ 不写死本机盘符/盘）
+_CB_CONF = os.environ.get("CODEBUDDY_CONFIG_DIR") or os.path.expanduser("~/.workbuddy")
+
+DEFAULT_CHROME = (os.environ.get("BH_CHROME")
+                  or r"C:\Program Files\Google\Chrome\Application\chrome.exe")
+DEFAULT_PROFILE = (os.environ.get("BH_PROFILE")
+                   or os.path.join(_CB_CONF, "tmp", "bu-chatgpt-profile"))
+DEFAULT_LOG = (os.environ.get("BH_LOG")
+               or os.path.join(_CB_CONF, "tmp", "_bh_chrome.log"))
+DEFAULT_PORT = int(os.environ.get("BH_PORT") or 9223)
 
 
 def _log(path, msg):
@@ -95,9 +129,9 @@ def _launch(chrome: str, profile: str, port: int, proxy: str = ""):
 def main() -> int:
     ap = argparse.ArgumentParser(add_help=True)
     ap.add_argument("--port", type=int, default=DEFAULT_PORT)
-    ap.add_argument("--chrome", default=os.environ.get("BH_CHROME") or DEFAULT_CHROME)
-    ap.add_argument("--profile", default=os.environ.get("BH_PROFILE") or DEFAULT_PROFILE)
-    ap.add_argument("--log", default=os.environ.get("BH_LOG") or "")
+    ap.add_argument("--chrome", default=DEFAULT_CHROME)
+    ap.add_argument("--profile", default=DEFAULT_PROFILE)
+    ap.add_argument("--log", default=DEFAULT_LOG)
     ap.add_argument("--proxy", default=os.environ.get("BH_PROXY") or "",
                     help='目标站点要走代理时才给，例 --proxy socks5://127.0.0.1:10800')
     a = ap.parse_args()