技能包：配置与代码分家 —— 每包自建 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）。
This commit is contained in:
admin committed
1 parent
90cc4315d5
commit
d81f75f173
37 files changed
+763
-291
No files matched your search
@@ -100,6 +100,40 @@
|
||||
|
||||
---
|
||||
|
||||
## 3b 🔴 配置层级：技能包级 `env/` vs 工作区级 `collabd.config.json`（2026-10-11 立）
|
||||
|
||||
> 用户令（2026-10-11）：19:28「不用挪出 用env文件夹区分就行，重点是 **脚本是脚本 配置是配置**」／
|
||||
> 19:29「**每个技能 需要环境配置的 都有自己的 env文件夹**」。
|
||||
|
||||
**两层，一层一份，各自单一真源**：
|
||||
|
||||
| 层 | 文件 | 装什么 | 谁读 |
|
||||
|---|---|---|---|
|
||||
| **L0 技能包级**（每台机器一份） | `<技能包>/env/roots.env`（真文件不入库；样例 `*.example` 入库） | 这台机器的根：`DSH_WS_ROOT`、`DSH_AIROOT`、`WB_RESULT_HOOK_WS`、`COLLABD_PROD_CONFIG`、`CODEBUDDY_CONFIG_DIR`、`DSH_DOCS_ROOT` | **包内脚本**：钩子（`scripts/hooks/*`）、`board.py`、`goalctl.py`、`collabctl.py`、`keepalive.py` |
|
||||
| **L1 工作区级**（每工作区一份） | `<工作区>/.workbuddy/collab/collabd.config.json` | 这个工作区自己的东西：`workspace`／`inbox`／`live`／`taskgraph`／`host_db`（可写本机绝对路径）／`peer_workspaces` | **部署副本**：`<ws>/.workbuddy/collab/` 下的 `collabd.py`、`goalctl.py` |
|
||||
|
||||
**桥接（谁把两层接起来）**：`scripts/supervise-launch.py`（常驻）与 `scripts/board-launch.py`（看板）。
|
||||
计划任务的动作里**没有 env 字段**，所以这两个启动器在**进程内**设
|
||||
`COLLABD_CONFIG=<本区>/collabd.config.json` ＋ `CODEBUDDY_CONFIG_DIR`，再 `runpy` 起本体。
|
||||
|
||||
- **常驻**：启动器装在 `<ws>/.workbuddy/collab/`（由 `deploy_code.py` 分发）⇒ `HERE` 就是本区 ⇒ 配置恒指本区。
|
||||
- **看板**：启动器在技能包内，主工作区根从 L0 的 `DSH_WS_ROOT` 读；读到就用，读不到就**写日志 ＋ 退出码 2**（⛔ 不猜路径）。
|
||||
|
||||
**部署副本怎么拿 L0 的配置**：从 `<ws>/.workbuddy/collab/` 跑**管理入口**（`collabctl.py`／`keepalive.py`）时，
|
||||
`_sm_load_roots()` 向上找不到 `env/roots.env` ⇒ 回落到**本机技能库**那份
|
||||
（`<CODEBUDDY_CONFIG_DIR>/skills/session-mechanism/env/roots.env`；`CODEBUDDY_CONFIG_DIR` 由宿主给）
|
||||
⇒ 全机**只有一份** L0 配置，副本目录里**不放第二份**（避免各区分叉）。
|
||||
🔴 而 `collabd.py` 的副本**不读 L0 的 `DSH_WS_ROOT`**（那会把别的区认成自己 —— P0-85 静默错归属族）：
|
||||
它靠**启动器设的 `COLLABD_CONFIG`** 定位自己。
|
||||
|
||||
**日常该改哪一层**：
|
||||
|
||||
- 换机器 / 换工作区根 / 换文档库 ⇒ 改 **L0**（重跑 `install.py --apply`，或手改 `env/roots.env`）
|
||||
- 换本区配置（inbox 名、端口、`host_db`、peer 列表）⇒ 改 **L1**
|
||||
- 两层都**不把**「别台机器才成立的值」写进入库代码（依据：用户 19:22「这个环境都是针对一台机器的，同步到别的机器把环境都搞坏了」）
|
||||
|
||||
---
|
||||
|
||||
## 4 旧副本退役（⛔ 否则"代码在 A、钩子在 B"）
|
||||
|
||||
症状：改了 skill 里的程序却没生效；或 `advance.md` 等产物由**另一个副本**写出（内容与你预期不同）。
|
||||
@@ -167,13 +201,21 @@ curl -s --noproxy '*' -o /dev/null -w "%{http_code}\n" http://127.0.0.1:20090/
|
||||
**⚠️ 遗留单点（如实登记）**：这两条后台任务**挂在"起它的那个会话"名下** ⇒ **起它的会话被回收 / WorkBuddy 退出 ⇒ 链路断**。
|
||||
⇒ 起它们的会话**在那段时间内不要关**；断了就按上面"② 不在才起"重起一次。
|
||||
|
||||
## 6 换机器后必查的 5 件事
|
||||
## 6 换机器后必查的 6 件事
|
||||
|
||||
1. `--where` 的三个路径是否都对；
|
||||
2. 钩子接线是否指向 skill（§4）；
|
||||
3. 宿主库能否只读打开（`sessions` / `automation_runs` / `automations` 三张表读得到）；
|
||||
4. 有没有**别的实现**在抢同一个 inbox（§4）；
|
||||
5. `guard.py` 是否真的起来了（`--status`）＋ 它是否会随开机自启。
|
||||
5. `guard.py` 是否真的起来了（`--status`）＋ 它是否会随开机自启；
|
||||
6. 🔴 **计划任务里有没有指向不存在路径的项**（2026-10-11 加）。判据：逐条取出动作里的脚本路径
|
||||
`Test-Path` 一遍；指向已删目录的（例：老工作区改名、`tmp/selftest/…` 这类一次性沙箱）＝**静默死任务**。
|
||||
处置：`Disable-ScheduledTask`（`collabctl.py` 的旧任务清单已含本机这几条）——
|
||||
**禁用不删**，可逆。
|
||||
```
|
||||
Get-ScheduledTask | ForEach-Object { $t=$_; $t.Actions | ForEach-Object { "$($t.TaskName)|$($t.State)|$($_.Execute)|$($_.Arguments)" } }
|
||||
```
|
||||
⚠️ 判存在性时先**展开 `%windir%`／`%SystemRoot%`**，否则系统自带任务会被误报成缺失。
|
||||
|
||||
|
||||
---
|
||||
|
||||
@@ -2405,8 +2405,8 @@ INBOX = '…\ai1net-dsh-server\tmp\supervise-inbox'
|
||||
| `E://ProgramData//.workbuddy//workbuddy.db`（**活动库**） | 34.9 MB | ✅ 247 行 |
|
||||
| `C://Users//Administrator//.workbuddy//workbuddy.db`（旧库） | **0 字节** | ❌ 无 |
|
||||
|
||||
- 🔴 **为什么只有 ai1net 炸**：vibe 的 config 里 `host_db` **写死绝对路径**；ai1net 的 `host_db` **一直是空字符串**。⇒ **同一份代码，两区行为不同，差别只在 config 这一格**。
|
||||
- 🔴 **"计划任务的『动作』里没有 env 字段"**（P0-72 §二 同一条硬约束）⇒ `CODEBUDDY_CONFIG_DIR` **只能由启动器在进程内设**。
|
||||
- 🔴 **为什么只有 ai1net 炸**：vibe 的 config 里 `host_db` **写死绝对路径**；ai1net 的 `host_db` **一直空**。⇒ 差别只在 config 这一格。
|
||||
- 🔴 **计划任务的动作里没有 env 字段**（P0-72 §二）⇒ 该变量**只能由启动器进程内设**。
|
||||
- 🔴 **怎么弄丢的（诚实记录）**：旧看守 `start-supervise.ps1` 本有 `$env:CODEBUDDY_CONFIG_DIR = ...`；P0-72 改成"两层形态"时**只保了 `COLLABD_CONFIG`，丢了这一句**。⇒ **重构"起法"时，旧起法里的 env 必须逐条搬**（⛔ 不许凭记忆只搬"我记得的那个"）。
|
||||
|
||||
### 四、✅ 修法：新增常驻启动器（与 `board-launch.py` 对称）
|
||||
@@ -2414,7 +2414,8 @@ INBOX = '…\ai1net-dsh-server\tmp\supervise-inbox'
|
||||
- 新增 **`scripts/supervise-launch.py`**：进程内 `os.environ.setdefault("CODEBUDDY_CONFIG_DIR", ...)` ＋ 设 `COLLABD_CONFIG=<本区>/collabd.config.json` ＋ 兜住 `sys.stdout/stderr`（pythonw 下可能是 `None`）＋ `runpy.run_path(collabd.py, run_name="__main__")`。
|
||||
- 常驻任务动作改指 `pythonw.exe "<区>/.workbuddy/collab/supervise-launch.py"`（⛔ **不再自带 `--supervise`**），`-WorkingDirectory` 仍是**工作区根**，`-ExecutionTimeLimit` 恒 `0`。
|
||||
- `deploy_code.py` 的 `DEFAULT_FILES` **补入该启动器**（否则各区吃不到，P0-57 同族）。
|
||||
- ⚠️ **`roots.env` 位置缺口（连带发现）**：`_sm_load_roots()` 从 `__file__` **向上**找 `roots.env`；工作区副本在 `<ws>/.workbuddy/collab/collabd.py` ⇒ 工作区里没有该文件 ⇒ **找不到** ⇒ **启动器里写死最稳**，⛔ 别指望 `roots.env` 兜住各区。
|
||||
- ⚠️ **`env/roots.env` 位置缺口（连带发现）**：`_sm_load_roots()` 从 `__file__` **向上**找 `env/roots.env`；工作区副本在 `<ws>/.workbuddy/collab/` ⇒ 找不到 ⇒ 那一路靠**启动器进程内设 env**。
|
||||
（原文「启动器里写死最稳」—— 2026-10-11 改为「值放本包 `env/`，启动器照读」。）
|
||||
|
||||
### 五、✅ 验收（2026-10-05 12:15 实测）
|
||||
|
||||
@@ -2426,7 +2427,7 @@ INBOX = '…\ai1net-dsh-server\tmp\supervise-inbox'
|
||||
```
|
||||
⇒ **`pid=58860` 之后 `no such table` 计数 = 0**（`awk` 分界**实测**），从 fail-safe 的"恒判有会话"变成**真实读库判定**。
|
||||
|
||||
**② 那条 `working（a80f300d）` 是真的**（直查活动库）：就是**当前这条会话本身** ⇒ 闸②「本区有会话在跑 ⇒ 不建检查会话」是**正确的合法拦截**（⛔ 不是 bug）。
|
||||
**② 那条 `working（a80f300d）` 是真的**（直查活动库）：就是**当前这条会话本身** ⇒ 闸②「本区有会话在跑 ⇒ 不建」是**正确的合法拦截**。
|
||||
|
||||
**③ 变异对照证明判据非恒绿**（两档）：
|
||||
|
||||
@@ -2438,7 +2439,7 @@ INBOX = '…\ai1net-dsh-server\tmp\supervise-inbox'
|
||||
⇒ **A 必 FAIL、B 必 OK** ⇒ 路径来源**真实决定成败**（⛔ 不是"应该绿"）。
|
||||
|
||||
**④ 运行时**（恒 3 进程、父链断 ⇒ 真常驻）：两台**启动器**（各指本区）＋ 一个**看板**。
|
||||
**⑤ 三处 md5 一致**；看板 `curl --noproxy '*' :20099/` ⇒ **HTTP 200**、`netstat` 实测 **LISTENING**。
|
||||
**⑤ 三处 md5 一致**；`curl --noproxy '*' :20099/` ⇒ **HTTP 200**、`netstat` 实测 **LISTENING**。
|
||||
|
||||
### 六、⛔ 教训（一句话）
|
||||
|
||||
|
||||
@@ -53,7 +53,8 @@
|
||||
## 5 钩子与脚本的写法约束
|
||||
|
||||
- 🔴 **hook 脚本必须走 `sys.stdout.buffer.write(bytes)`** 输出 —— 否则文案含非 ASCII 符号时抛 `UnicodeEncodeError` ⇒ stdout 为空 ⇒ **静默放行**。
|
||||
- 🔴 **不要按位置推导根目录**：钩子脚本被搬一次就会**静默指错**（历史事故：台账写到别处、测试却全绿）⇒ 用外置的 `roots.env`（本包由 `install.py` 生成）。
|
||||
- 🔴 **不按位置推导根目录**：钩子脚本被搬一次就会**静默指错**（历史事故：台账写到别处、测试却全绿）⇒ 用外置的 **`env/roots.env`**（本包由 `install.py` 生成，每台机器各一份）。
|
||||
- 🔴 **配置与代码分家**（2026-10-11 用户令：「脚本是脚本 配置是配置」）：「每台机器各不同」的值 → 本包 **`env/`**（入库的只有 `*.example`）；`scripts/` 只放通用代码，读 `env/` 里的值、⛔ 不写死本机路径与本机清单。
|
||||
- ⚠️ `settings.json` 的 hook 条目**没有 `env` 字段** ⇒ ⛔ 别指望用 env 给钩子传参。
|
||||
- 🔴 **作用域⛔ 不许静默排除**：被跳过必须**留下痕迹**（写跳过清单 ＋ stderr），否则"没动作"与"坏了"长得一模一样。
|
||||
- ⚠️ **钩子脚本内容改动即时生效**；但 `settings.json` 的 hooks 条目是**应用启动时快照** ⇒ 改条目要**完全重启**（关窗 ≠ 退出）。
|
||||
|
||||
@@ -136,16 +136,21 @@
|
||||
**`supervise-launch.py` 的四条实现要点**（见该文件头注，⛔ 别自己另写一份）：
|
||||
|
||||
1. **它所在目录即本区 `.workbuddy/collab`** —— `collabd.py`／`collabd.config.json` 都在同目录，**用相对自身定位**（⛔ 别写死 `E:\`）；
|
||||
2. `CODEBUDDY_CONFIG_DIR` 用 `setdefault`（宿主 env 优先，兜底才写死）；`COLLABD_CONFIG` **必须指向本区**那份配置；
|
||||
2. `CODEBUDDY_CONFIG_DIR` 用 `setdefault`（宿主 env 优先，兜底值取 `os.path.expanduser("~/.workbuddy")` 形态，
|
||||
🔴 2026-10-11 起不再写死本机盘符）；`COLLABD_CONFIG` **必须指向本区**那份配置；
|
||||
3. `pythonw.exe` 下 `sys.stdout/stderr` 可能是 `None` ⇒ **任何 `print` 都会 `AttributeError` 秒退** ⇒ 启动器自己兜到 `logs/_supervise-launch.log`；
|
||||
4. 用 `runpy.run_path(CB, run_name="__main__")`（⛔ **不用 `exec`**）—— `runpy` 会把 `__name__`/`__file__`/`sys.path[0]` 按"真在跑那个脚本"设好；
|
||||
且 `sys.argv` **由启动器自己补 `--supervise`** ⇒ **任务参数里 ⛔ 不要再写**。
|
||||
|
||||
> 🔴 **重构"起法"时，旧起法里的 env 必须逐条搬**（P0-73 就是改成两层形态时**丢了 `CODEBUDDY_CONFIG_DIR` 这一句**）。
|
||||
> 🔴 **启动器里写死最稳**（⛔ 别指望 `roots.env` 兜住各区 —— 它只在技能目录，而各区副本在
|
||||
> `<ws>/.workbuddy/collab/`，`_sm_load_roots()` 向上 4 层**找不到**）。
|
||||
> ⚠️ **变量名坑**：`roots.env` 给的是 **`COLLABD_PROD_CONFIG`**，而 `board.py`／`collabd.py` 读的是
|
||||
> **`COLLABD_CONFIG`** ⇒ 名字对不上 ⇒ `roots.env` **兜不住**。
|
||||
> 🔴 **启动器把该设的 env 在进程内设好**（2026-10-11 起配置住本包 **`env/roots.env`**）——
|
||||
> ⛔ 别指望 `env/roots.env` 兜住各区副本：它只在技能包目录，而各区副本在
|
||||
> `<ws>/.workbuddy/collab/`，`_sm_load_roots()` 向上 4 层**找不到**。
|
||||
> ✅ 各区那一路的正确供法 ＝ **启动器设 env**（`COLLABD_CONFIG` 指本区那
|
||||
> 份）＋ 该区 `collabd.config.json` 兜底（`host_db` 可直接写本机绝对路径 —— 那**属于"每台机器各不同"的配置**，
|
||||
> 本就该落在本区配置里，⛔ 不是写进入库代码）。
|
||||
> ⚠️ **变量名坑**：`env/roots.env` 给的是 **`COLLABD_PROD_CONFIG`**，而 `board.py`／`collabd.py` 读的是
|
||||
> **`COLLABD_CONFIG`** ⇒ 名字对不上 ⇒ `env/roots.env` **兜不住**。
|
||||
|
||||
|
||||
## 二、装法（⛔ 别自己写 `Register-ScheduledTask`）
|
||||
|
||||
Reference in new issue
Block a user