workbuddy_skills/session-mechanism/scripts/board-launch.py

# -*- 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__")