docs(ack): add Codex model routing

2026-07-12 14:53:50 +08:00
parent af823e867f
commit ae05845ee7
2 changed files with 34 additions and 2 deletions
@@ -31,6 +31,8 @@ orca orchestration inbox --limit 20 --json

 **编排层不设模型。** `task-create` / `dispatch` 都没有 `--model`；`dispatch --to <handle>` 只是把任务投给一个已存在的终端，用的是那个终端里 agent 会话启动时的模型。要固定模型，就在 **创建 worker 终端** 时用 agent CLI 的模型参数：

+默认沿用 Coordinator 当前所在的 Agent CLI：Cursor Coordinator 创建 Cursor worker，Codex Coordinator 创建 Codex worker。不要通过询问模型来猜运行环境；以当前 CLI / 终端环境为准。除非项目 overlay 或用户明确指定，否则不跨 Agent CLI 创建 worker。
+
 ```bash
 # Cursor：Test / Developer worker 用 auto 模型（自动选型）
 orca terminal create --worktree path:<dev_worktree> \
@@ -39,6 +41,21 @@ orca terminal create --worktree path:<dev_worktree> \
 # 需要更强模型时改成具体模型
 orca terminal create --worktree path:<dev_worktree> \
  --command "cursor-agent --model claude-opus-4-8-thinking-high" --title "DEV" --json
+
+# Codex：Developer worker
+orca terminal create --worktree path:<dev_worktree> \
+  --command "codex -m gpt-5.6-terra -c model_reasoning_effort=medium" \
+  --title "DEV" --json
+
+# Codex：Test worker
+orca terminal create --worktree path:<test_worktree> \
+  --command "codex -m gpt-5.6-luna -c model_reasoning_effort=low" \
+  --title "TEST" --json
+
+# Codex：复杂 Developer 任务升级
+orca terminal create --worktree path:<dev_worktree> \
+  --command "codex -m gpt-5.6-sol -c model_reasoning_effort=high" \
+  --title "DEV-STRONG" --json
 ```

 拿到返回的 handle 后再 `task-create` + `dispatch --to <handle>`。模型档位与选型策略见 `model-routing.md`。
@@ -51,7 +68,8 @@ orca terminal create --worktree path:<new_worktree> --command "cursor-agent --mo
 ```

 - `cursor-agent --list-models` 可列出合法模型；`auto` 表示由 Cursor 自动选型。
- 其它 CLI（codex / opencode 等）用各自的模型参数或配置，`--command` 相应替换。
+- Codex 用 `-m / --model` 指定模型，用 `-c model_reasoning_effort=<effort>` 固定推理档位；不要把省略 `-m` 当作 Cursor `auto` 的等价物。
+- 其它 CLI（opencode 等）用各自的模型参数或配置，`--command` 相应替换。
 - 若 worker 是已在跑的会话（用 `--inject` 投递），模型已由该会话启动时决定，无法在 dispatch 时改；要换模型需新建终端。

 ---