配置與上下文

本參考區分專案上下文、新會話預設值和已有會話配置。對應介面步驟見專案或模型接入。

上下文和配置歸屬

任務執行器逐欄位解析配置。下列優先順序適用於 Task API 新會話，不會追溯應用到所有已有桌面對話。

欄位	從高到低的取值順序
權限模式	請求顯式值 → 專案會話預設值 → 應用預設值 → `ask`
Auto-review	請求顯式值 → 專案預設值 → `false`
啟用 Memory	請求顯式值 → 專案預設值 → `true`
委派策略	請求顯式值 → 專案預設值 → `allow`
Specialist	請求顯式值 → 已設定的專案預設值
提供方／模型／推理強度	將顯式配置補丁應用到專案配置，或有效的應用／提供方配置
選中的 Compute Hosts	請求顯式 ID → 專案選中 ID

新會話準備階段會把選中 ID 加入已啟用主機集合。顯式空的 enabled 列表先清除繼承的啟用列表，再納入選中主機。更新已有會話配置時，每個選中 ID 必須包含在已啟用集合中。

實際讀取和更新命令見 CLI 或 Task SDK/API。專案會話預設值屬於配置介面約定，不代表專案 Name/Description 對話方塊提供全部這些欄位。

欄位	接受的值
`agentConfiguration.providerId`	非空、已配置的提供方 ID
`agentConfiguration.model`	可選模型 ID；更新補丁可用 `null` 恢復提供方預設
`agentConfiguration.reasoningEffort`	`default`、`low`、`medium`、`high`、`xhigh`、`max`；實際可選值取決於提供方／模型
`permissionProfile`	`ask`、`auto`、`full`
`autoReviewEnabled`	布林值
`memoryEnabled`	布林值
`delegationPolicy`	`allow`、`deny`
專案預設值的 `specialistId`	非空 ID；普通會話配置補丁沒有此欄位
`computeHosts.enabled`、`.selected`	非空主機 ID 陣列；selected 必須是 enabled 的子集

Schema 會拒絕未知欄位。模型出現在列表中，不代表當前框架或憑據可以使用它，應檢視已配置目錄和可用狀態。

訂閱提供方未指定模型時，保留賬號／CLI 管理的預設模型，不會固定為目錄中的第一項。如果已儲存會話配置不可選，介面解析器可以回退到應用當前可選配置；兩者都不可用時報告 unavailable。更換提供方後重新開啟舊任務，應檢查實際選擇的模型。

修改已有會話前先讀取當前配置。更新時攜帶 expectedRevision，它是非負整數。版本過期會得到 session_revision_conflict。存在活動任務，或會話不處於 idle/error 狀態時，服務也會拒絕配置更新。

切換提供方時必須明確指定模型，或用 model: null 選擇新提供方預設。只改提供方而省略模型，不會默默繼承舊提供方的模型。恢復預設與填寫空字串不同。

恢復已有 Task API 會話前，如果要修改提供方、模型、推理強度、Memory 或啟用主機，應先呼叫會話配置更新。在 resume 請求直接提供這些建立時欄位會返回 invalid_request。工作目錄仍必須與該會話的規範化目錄一致。

更新專案預設值使用從當前專案讀取的正整數時間戳 expectedUpdatedAt，並提供 patch。專案預設欄位為 null 時移除覆蓋，省略欄位則保留。修改預設值影響後續新會話，不會改寫已有產物的證據。

已儲存 Compute 主機說明與探測資源分別管理。已儲存說明為空與資源探測成功是不同狀態。Agent 協助替換說明時，以當前儲存文字作為校驗條件。見主機詳情，該內部約定不同於公共 Task API。

憑據儲存是啟動選項，不是專案/會話偏好。適用範圍、預設 OS 儲存與遷移限制見 Linux 檔案模式，不要把 credential-store 引數寫入會話配置 JSON。