Files
workbuddy_skills/session-mechanism/env/roots.env.example
T
admin d81f75f173 技能包:配置与代码分家 —— 每包自建 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)。
2026-10-11 21:49:28 +08:00

32 lines
1.8 KiB
Bash
Raw Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# session-mechanism · 环境专属配置(样例 · ⛔ 请勿当成真文件用)
#
# 🔴 位置约定(2026-10-11 用户令:「脚本是脚本 配置是配置」⇒「每个技能 需要环境配置的 都有自己的 env文件夹」):
# 本包**每台机器各不同**的配置一律放 **本包 `env/`**;`scripts/` 只留通用代码。
# 本文件=入库的**样例**(只示范有哪些键、各填什么,值一律占位符)。
# 真文件=`env/roots.env`,由本机跑一次 `python install.py --apply` 生成,⛔ **不入库**
# (入库 ⇒ 别的电脑取仓时被本机路径覆盖 ⇒ 那台机器的机制会去找不存在的目录)。
# 仓根 `.gitignore` 的规则:`env/` 下只放行 `*.example`。
#
# 读取机制:各脚本头部 `_sm_load_roots()` 以 setdefault 注入
# ⇒ **宿主 env 优先,本文件兜底**。
# ① 工作区根(`state.py`、台账、心跳都在它下面)
DSH_WS_ROOT=<工作区根>,例:E:/AIProject/<工作区别名>
# ①b 工作区根的**父目录**(常驻管理脚本靠它自动发现兄弟工作区:
# 扫 `<DSH_AIROOT>/*/.workbuddy/collab/` ⇒ ⛔ 不把工作区清单写死在代码里)
# 不填 ⇒ 兜底 = ① 的父目录
DSH_AIROOT=<工作区根的父目录>,例:E:/AIProject
# ② 结果钩子认的工作区(一般与 ① 同值)
WB_RESULT_HOOK_WS=<同上>
# ③ 本工作区的协作机制部署配置(`COLLABD_CONFIG` 指向它;每个工作区一份)
COLLABD_PROD_CONFIG=<工作区根>/.workbuddy/collab/collabd.config.json
# ④ WorkBuddy 的配置目录(宿主库 workbuddy.db 在它下面)
CODEBUDDY_CONFIG_DIR=<WorkBuddy 配置目录>,例:<用户目录>/.workbuddy
# ⑤ 文档库根(锁目录 `05-交接单/.locks` 在它下面)
DSH_DOCS_ROOT=<文档库根>