# 唤醒通道（transports）

每个成员在被 `aig wake` 调用时，用的都是**它自己的 CLI 的无头模式**。本机实测过的路径如下（2026-09-18）。

## dsh — DeepSeek Harness

```bash
node <node> "%APPDATA%\npm\node_modules\@deepseek-ai\dsh\lib\bin.js" --profile headless "<prompt>"
```

- 走 `lib/bin.js` 而不是 `dsh.cmd`：**直接 node + argv，绕开 cmd 的引号地狱**（提示词里有中文、引号、换行）。
- `--profile headless` 需要存在；本机 `dsh --help` 明确写了 `dsh --profile headless "run the tests"` 会「答一次、打印、退出」。
- 覆盖入口：`AIGROUP_DSH_BIN`（指向别处的 bin.js）；`AIGROUP_DSH_NODE`（换 node）。
- 注意：headless 启动会写 `$DSH_HOME`（profile 目录、日志），在受限沙箱里会 `EPERM`。

## opencode

```bash
"%APPDATA%\npm\node_modules\opencode-ai\bin\opencode.exe" run -m <model> [-c] [--dir <dir>] "<prompt>"
```

- 直接调 `bin/opencode.exe`（真 EXE，不需要 shell）。
- `-c/--continue` 会接上该项目目录下**最近一次会话**。默认**不加**：免得和用户自己开着的 TUI 会话串味。要连续对话再 `aig join opencode --note "..."` 后手工加 `continue: true`。
- 模型（**全免费档**）：默认 `opencode/big-pickle`，备选 `opencode/nemotron-3.5-lightning-free`
  （`members.json` 里的 `fallback_model`：主模型不可用时自动换备选再试一次，并把换模型的事实写进消息 `meta`）。
  其它可用免费档（`opencode models` 实测）：`ling-3.0-flash-fin-free`、`mimo-v2.5-free`、`nemotron-3-ultra-free`、
  `muse-spark-1.2/1.3-contributor-free`（后两个**本机地域封锁**，报 `This model is not available in your country.`）。

### 免费档排名（同题实测，2026-09-18）

第一轮基础题（5 题，`tools/model-shootout.mjs`，判分修正后）：五个可用免费档**全部满分**，
耗时差得很明显——`big-pickle` 6.3s · `ling-3.0-flash` 6.6s · `nemotron-3.5-lightning` 16.5s ·
`mimo-v2.5` 19.6s · `nemotron-3-ultra` 57.7s。muse-spark 两个地域封锁直接出局。

决赛轮难题（7 分制，`tools/model-shootout2.mjs`，含一题**真的把模型输出的函数跑断言**）：

| 模型 | 得分 | 耗时 | 备注 |
|---|---|---|---|
| `big-pickle` | **6/7** | **16.5s** | 与两个 nemotron 同分，但快 5–6 倍 |
| `nemotron-3-ultra-free` | 6/7 | 94.4s | 上下文 1M，长上下文场景的备选 |
| `nemotron-3.5-lightning-free` | 6/7 | 103.2s | 开源权重，262k |
| `ling-3.0-flash-fin-free` | 5/7 | 19.1s | 快，但「1..100 里数字 1 出现几次」答 20（正确 21） |
| `mimo-v2.5-free` | 5/7 | 26.8s | 同上 |

- **H5（改 bug 后跑断言）五个模型全部 0 分**：都用了 `arr.slice(-n)`，而 JS 里 `slice(-0)` 等于 `slice(0)`，
  n=0 的边界全错。这是所有免费档共同的坑，不是哪一家的问题。
- 结论：选 `big-pickle` 作默认（同分最快）；它是 Zen 的**隐身模型**，可能某天下线——
  所以配了 `fallback_model`。要换回来一条命令：`aig join opencode --model opencode/nemotron-3.5-lightning-free`。
- **免费档不需要 API key**：实测 `opencode run -m opencode/nemotron-3-ultra-free "…"` 直接返回内容。
  这条很关键——意味着群聊里 opencode 这一侧零成本。
- 覆盖入口：`AIGROUP_OPENCODE_BIN`。

## workbuddy — WorkBuddy 桌面端（走它随附的 CodeBuddy CLI）

```bash
"<~>\.workbuddy\binaries\node\versions\22.22.2-3\node.exe" "H:\workbuddy\resources\app.asar.unpacked\cli\bin\codebuddy" -p "<prompt>" --model <model>
```

- WorkBuddy 桌面端本体（`H:\workbuddy\WorkBuddy.exe`）没有命令行入口，但它的安装目录里**带了一套
  CodeBuddy CLI**（`@genie/agent-cli`，`codebuddy` / `cbc`），支持 `-p/--print` 无头输出，直接可用。
- 用 WorkBuddy **自带的 node**（`~/.workbuddy/binaries/node/versions/*/node.exe`），避免宿主 node 版本差异。
- 模型：`hy4-preview-f`（Hy4 preview 免费档）。WorkBuddy 的模型分档在
  `~/.workbuddy/cache/*acc-product-config-v3.json` 里写着：`Hy4 preview` → 免费 `hy4-preview-f` / 付费 `hy4-preview`；
  `Hy3` → 免费 `hy3` / 付费 `hy3-x`。桌面端两个现存会话本来就在用 `hy4-preview-f`。
- 登录态：CLI 复用桌面端的凭据（实测 `-p` 直接有回答，无需额外登录）。它会写 `~/.codebuddy/`，
  受限沙箱里会 `EPERM: mkdir '~/.codebuddy/local_storage'`。
- 覆盖入口：`AIGROUP_CODEBUDDY_BIN`、`AIGROUP_CODEBUDDY_NODE`。

## 免费档怎么挑的（有实测，不是感觉）

`tools/model-shootout.mjs` + `tools/model-shootout2.mjs` 用同一套题跑遍 opencode 的免费档，
题是**客观可判分**的（数值、枚举、以及真的把模型输出的函数跑断言）。结论与原始数据见同目录
`shootout-result.json` / `shootout2-result.json`，切换模型：

```bash
node aig.mjs join opencode --model opencode/ling-3.0-flash-fin-free   # 单个成员改
node aig.mjs wake opencode --model opencode/big-pickle --dry-run      # 只这一次改
```

## 加一个新成员

```bash
node aig.mjs join reviewer --kind custom --model whatever
```

然后在 `rooms/<room>/members.json` 里给它加通道画像（`transport` 必须是 `aig.mjs` 里 `resolveTransport`
认识的类型，或者你自己在 `resolveTransport` 加一个分支）：

```json
{
  "reviewer": {
    "kind": "custom",
    "transport": "opencode",
    "model": "opencode/big-pickle",
    "dir": "E:/proj",
    "note": "只做代码审查"
  }
}
```

## 身份识别顺序

`aig` 判断「我是谁」的顺序：

1. `--as <member>`（最优先）
2. `AIGROUP_MEMBER` 环境变量
3. 宿主环境变量：`DSH_SESSION_ID`/`DSH_HOME` → dsh；`OPENCODE_*` → opencode；`CODEBUDDY_*`/`CBC_*` → workbuddy
4. 安装目录里的 `.aig-host.json`（由 `install.mjs` 写入）
5. 父进程链（向上找 `opencode.exe` / `WorkBuddy.exe` / `dsh`，需要 `detect` 或深度识别时才算）
6. 兜底 `anon`

`aig detect` 会把这三类证据全打出来，认错身份时先看它。