feat(ack): worker 模型固定与 worktree 决策说明 (v0.6.2)

2026-07-07 01:45:55 +08:00
parent f33992a0aa
commit d11f90fd66
5 changed files with 90 additions and 3 deletions
@@ -27,6 +27,35 @@ orca orchestration inbox --limit 20 --json

 ---

+## 给 worker 终端固定模型
+
+**编排层不设模型。** `task-create` / `dispatch` 都没有 `--model`；`dispatch --to <handle>` 只是把任务投给一个已存在的终端，用的是那个终端里 agent 会话启动时的模型。要固定模型，就在 **创建 worker 终端** 时用 agent CLI 的模型参数：
+
+```bash
+# Cursor：Test / Developer worker 用 auto 模型（自动选型）
+orca terminal create --worktree path:<dev_worktree> \
+  --command "cursor-agent --model auto" --title "DEV" --json
+
+# 需要更强模型时改成具体模型
+orca terminal create --worktree path:<dev_worktree> \
+  --command "cursor-agent --model claude-opus-4-8-thinking-high" --title "DEV" --json
+```
+
+拿到返回的 handle 后再 `task-create` + `dispatch --to <handle>`。模型档位与选型策略见 `model-routing.md`。
+
+需要隔离/并行时，先建新 worktree 再在其中起 worker（是否新建见 `closed-loop.md` §「子任务放哪」）：
+
+```bash
+orca worktree create --name <feature> --base-branch <base> --json
+orca terminal create --worktree path:<new_worktree> --command "cursor-agent --model auto" --json
+```
+
+- `cursor-agent --list-models` 可列出合法模型；`auto` 表示由 Cursor 自动选型。
+- 其它 CLI（codex / opencode 等）用各自的模型参数或配置，`--command` 相应替换。
+- 若 worker 是已在跑的会话（用 `--inject` 投递），模型已由该会话启动时决定，无法在 dispatch 时改；要换模型需新建终端。
+
+---
+
 ## 创建父任务

 ```bash