模型路由
Fallback 優先序、tier 與 dispatcher 模型如何決定由哪個模型回應。
模型優先序與 tier
已註冊模型以有序清單存於 config.json 的 models。此順序即 fallback 優先序：被選中的模型失敗後，其餘項目由上而下依序嘗試——排除 pass 模型——最後一筆非 pass 項目是最後防線。Fallback 會略過與失敗模型同一供應商的模型、以及 context window 容納不下輸入的模型，整份清單最多重試三輪；session 綁定特定模型時不做 fallback。v1.0.20 之前 pass 模型一律被移到最後；v1.0.20 至 v1.0.27 間 fallback 仍會依它在清單中的位置嘗試。POST /v1/model/priority 會把列出的名稱依序移到最前面，其餘保持在後。
每個模型可在 model_tag（{"<provider>@<model>": "<tier>"}）帶一個 tier：
| Tier | 意義 |
|---|---|
S |
最強——需要深度或精確度的程式與工作 |
A |
多數工作的預設，比旗艦低一級 |
B |
主流中階 |
C |
快速便宜；能依指示穩定呼叫工具 |
pass |
自動路由、subagent 與 fallback 永不挑選，即使請求指名也一樣（v1.1.0 起）；僅在 session 指定時使用 |
未設定 tier 的模型依內建命名規則判斷：S = claude-fable、claude-opus、gpt-*-astra；A = gpt-*-sol、grok-4.5+、claude-sonnet、gpt-*-terra、gemini-*-pro、deepseek-pro、glm、kimi；B = claude-haiku、gpt-*-luna、gemini-*-flash、4.5 以下的 grok、deepseek；C = *-mini、*-nano、gemini-*-flash-lite 與 open-weight 模型（gemma*、gpt-oss、qwen*、llama*）。v1.0.19 將 gpt-*-sol 與 grok-4.5+ 由 S 調降為 A。Tier 每次請求即時讀取，變更不需重啟。
Dispatcher 模型
Dispatcher LLM 決定由哪個 worker 模型處理任務。它在 exec.Start 中經 ResolveAgent → SelectAgentNames 執行，早於 Execute() 進入迭代迴圈，輸入為已註冊模型清單、依解析後 tier 分組的所有模型（先看使用者設定，再套命名規則）、下方的工作類別表、使用者訊息，以及命中 skill 的提示。其路由呼叫以 ReasoningNone 發出，timeout 為 30 秒。
無意義時會略過路由：呼叫端明確指定的模型直接使用（未註冊則失敗）；session 綁定 auto 以外的模型時使用該模型；registry 只有一個模型時直接回傳。
Dispatcher 第一行回傳工作類別、第二行回傳以逗號分隔的模型名稱（v1.1.0 起），因此 reasoning 為 auto 的 session 也能由工作類別決定等級，不需 TypeSafe。第一個已註冊、非 pass 且未在冷卻中的名稱成為主要模型。自 v1.0.20 起，清單其餘部分不再決定 fallback——fallback 依上述優先序進行。它把請求歸入下方 TypeSafe 一節表格中的五種工作類別之一，再依該類別的 tier 順序挑選。自 v1.0.21 起，LLM dispatcher、TypeSafe 分類器與 subagent planner 讀取同一張工作類別表（internal/session/config/tier.go）與同一套命名規則，排序結果一致；在此之前 LLM dispatcher 不區分 research / work，code、chat、fetch 以外的請求一律走 S > A > B > C。Dispatcher 被告知永不回傳 pass 模型，仍回傳的 pass 名稱會被丟棄（v1.1.0 之前請求仍可指名）。同 tier 內，訂閱制供應商 claude-code、其次 codex 的模型排在所有其他供應商之前。同一基礎模型註冊於多個供應商時，優先 claude-code，其次 codex / grok-oauth，再來 copilot、直接 API，最後 openrouter。Subagent planner 讀同一張表但降一級（S→A、A→B、B→C），因此 code 工作的 leg 依 A > B > C > S 嘗試。Dispatcher 呼叫失敗時，下一個 dispatcher 候選依固定的供應商排名挑選；全部無回應時僅依優先序決定。
在 TUI 以 /model → dispatch，或以帶 dispatcher 欄位的 POST /v1/model 設定。