Files
workbuddy_skills/session-mechanism/scripts/board-launch.py
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

99 lines
4.6 KiB
Python
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.
# -*- coding: utf-8 -*-
"""看板启动器(无控制台)—— 🔴 计划任务的**看板载体**只许指向本文件,⛔ 不许直接指 `board.py`。
🔴🔴 2026-10-05 **为什么必须要有这个启动器**(本轮实测踩到的坑,P0-72):
我一度把看板任务的动作写成 **`pythonw.exe board.py --serve 20099`**(直起)——
结果看板**崩溃重启循环、20099 从没绑上**。抓现场输出看到真因:
`⚠️ collabd:未找到部署配置(COLLABD_CONFIG 未设,且 <scripts>\\.workbuddy\\collab\\collabd.config.json 不存在)`
` ⇒ 已拒跑`
`board.py` 顶层用 `COLLABD_CONFIG` 定位配置(它要 `import collabd.py`,而 collabd 要配置);
计划任务的**动作里没有 env 字段** ⇒ 这个变量必须由**启动器在进程内设好**。
⇒ 正解=启动器(本文件):`pythonw.exe board-launch.py`,env 在 Python 进程内设。
⚠️ **看板是全局共用一份**(用户拍板)⇒ 它的配置**固定指向主工作区**(`DSH_WS_ROOT`)那份,
⛔ 不随工作区变。主工作区根由**宿主 env → 本包 `env/roots.env`** 决定(2026-10-11 起)。
"""
import os
import sys
import time
HERE = os.path.dirname(os.path.abspath(__file__))
# 🔴 2026-10-11:配置从本包 `env/roots.env` 读(「脚本是脚本 配置是配置」)——
# ⛔ 本文件**不写死**本机工作区 / 盘符;旧版兜底写死 ai1net-dsh-server ⇒ 换机器即错。
def _sm_load_roots():
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", "roots.env"), ("roots.env",)):
_p = _os.path.join(_base, *_rel)
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 _fail(msg: str, code: int = 2):
"""⛔ 不静默退出:`pythonw` 下 `stderr` 可能是 `None` ⇒ 先写包内 `logs/`(不入库)留痕,再退出。"""
try:
_d = os.path.join(os.path.dirname(HERE), "logs")
os.makedirs(_d, exist_ok=True)
with open(os.path.join(_d, "board-launch.err.log"), "a", encoding="utf-8", errors="replace") as _f:
_f.write("%s %s\n" % (time.strftime("%Y-%m-%d %H:%M:%S"), msg))
except Exception:
pass
try:
if sys.stderr is not None:
sys.stderr.write(msg + "\n")
except Exception:
pass
raise SystemExit(code)
# 🔴 主工作区根 —— 看板配置的真源(宿主 env → `env/roots.env` 的 `DSH_WS_ROOT`)。
WS = (os.environ.get("DSH_WS_ROOT") or "").strip()
if not WS:
_fail("[board-launch] 未解析到 DSH_WS_ROOT ⇒ 不猜路径、不起看板。"
"要什么:设宿主 env,或在包内 `env/roots.env` 里给出主工作区根。")
WS = WS.replace("/", "\\")
BOARD = os.path.join(HERE, "board.py")
PORT = os.environ.get("DSH_BOARD_PORT") or "20099"
CFG = os.path.join(WS, ".workbuddy", "collab", "collabd.config.json")
os.environ["COLLABD_CONFIG"] = CFG
os.environ.setdefault("CODEBUDDY_CONFIG_DIR", os.path.expanduser("~/.workbuddy"))
os.environ["PYTHONIOENCODING"] = "utf-8"
os.environ["PYTHONUNBUFFERED"] = "1"
# 🔴 `pythonw.exe` 下 `sys.stdout/stderr` 可能是 `None` ⇒ 任何 `print` 都会 `AttributeError` 秒退。
# ⇒ 先把两个流兜到日志文件,再看板自己去跑(它内部也有 reconfigure 兜底)。
LOG = os.path.join(WS, "tmp", "board-serve.err.log")
try:
_f = open(LOG, "a", encoding="utf-8", errors="replace")
except Exception:
_f = None
if _f is not None:
if sys.stdout is None:
sys.stdout = _f
if sys.stderr is None:
sys.stderr = _f
# 🔴 用 `runpy.run_path`(⛔ 不用 `exec`):`runpy` 会把 `__name__`/`__file__`/`sys.path[0]` 都
# 按"真在跑那个脚本"设好 ⇒ `board.py` 顶部的 `_sm_load_roots()`(靠 `__file__` 找 `roots.env`)与
# 命令行分发(它自己读 `sys.argv`)全对。(旧故障记录:`exec` 版从 `System32` 起 rc=1 零输出。)
import runpy
sys.argv = [BOARD, "--serve", str(PORT)]
runpy.run_path(BOARD, run_name="__main__")