設定檔與設定入口

排查「設定了卻沒生效」時，先執行 anyy config 核對目前 Profile，再到對應功能入口修改。模型、通訊管道、工具、定時任務、認證資料、Workspace 和狀態都按 Profile 儲存。

找到負責這項設定的入口

修改內容	推薦入口
第一次設定	anyy setup
模型與認證資料	Dashboard → Models 或 anyy setup model
訊息通訊管道	Dashboard → Channels 或 anyy setup channel
圖片、影片與語音路由	Dashboard → Models 或對應 Tools 頁面
連網搜尋	Dashboard → Tools → Web Search
Role、Skill、MCP、Cron	Dashboard 中各自的欄目
檢視最終生效設定	anyy config

anyy config 是唯讀指令。它會顯示目前 Profile、路徑、provider/model 選擇以及認證資料引用是否可解析，但不會輸出金鑰明文。

修改時優先使用產品入口

Dashboard 和設定精靈會做欄位校驗、認證資料保護，並在支援時重新整理正在執行的服務。直接改 YAML 更適合高階排障，因為它不會經過這些引導檢查。

手動修改前先確認目錄

一個 Profile 目錄儲存該 Profile 的規範資料，常見路徑包括：

路徑	內容
config.yaml	設定與認證資料引用；MCP 設定值保留輸入字串
secrets/	由 Anyy 管理的 Secret
state.db	工作階段、訊息、任務、稽核等持久狀態
memory/USER.md	長期使用者事實與偏好
memory/MEMORY.md	助理的長期記憶
objects/	由規範狀態引用的按內容定址的持久內容
workspace/	上下文檔案和使用者工作檔案
skills/	安裝在這個 Profile 的 Skills
roles/	這個 Profile 的 Role 定義

workspace/ 是上下文和檔案空間，不是權限邊界。工具仍然遵守作業系統權限和執行限制。

檢查另一個 Profile

anyy status
anyy config

檢視另一個命名 Profile：

anyy --profile work config

部分指令還支援 --home PATH，可直接指定一個 Profile 目錄。除非是在排查路徑解析，否則不要混用 --profile、--profile-root 和臨時 --home。

推理設定與遷移

Profile 的全域推理偏好儲存在 main_model.inference，可選的精確模型覆蓋儲存在根級 model_thinking_levels：

main_model:
  provider_id: your-provider
  model: your-model
  inference:
    enabled: true
    # 省略 level，让全局等级保持未设置。
model_thinking_levels:
  "your-provider/your-model": high

請換成實際設定的 provider/model ID。鍵按第一個 / 分隔；去除兩側空白後都須非空，但校驗不會改寫鍵，查詢要求精確匹配。尚未註冊的模型鍵也可儲存備用。值為 Pi 命名等級 off、minimal、low、medium、high、xhigh、max；執行環境讀取會去除值兩端空白，空值無效。

全域 enabled 預設 true；為 true 或省略時，省略 level 表示未設定。enabled: false 即使沒有 level 也明確請求 off，命名值 off 本身同樣有效。請求會按所選模型的支援範圍調整；inference.effective_level 唯讀，不是 YAML 設定項。優先順序見推理預設值。

從舊設定升級到 v0.1.107 時：

• 刪除 prompt_program.inference_level，空值、null 和其他型別也會被拒絕。全域偏好遷移到 main_model.inference，精確模型偏好遷移到 model_thinking_levels。
• 刪除 prompt_program.render_profile，空值或 null 也不能保留；沒有替代選擇器，也沒有必須使用 high 的限制。
• 把產品設定中的 provider_default 換成 Pi 命名等級。全域等級也可直接刪除 level 以保持未設定；Map 條目須選擇命名值或刪除條目。

JSON/YAML 和產品模型 API 會明確拒絕舊輸入，不提供別名，也不會在未提示的情況下轉換為 medium。prompt_program 的公開設定只保留 resource_class。Anyy 不會靜默改寫這些舊值；請先手動遷移。底層呼叫合法的省略推理語義繼續保留。

重試與模型介面

工作階段重試、服務商 SDK 重試、fallback 和虛擬模型回呼分別控制；retry.enabled 不是關閉所有重試的總切換開關。providers[].models[] 的具型別模型、取樣欄位，以及 retry、httpIdleTimeoutMs 的準確設定見服務商協定與模型介面。

MCP 設定

Profile 全域 MCP 定義仍儲存在 config.yaml 的 mcp.client.servers 中。該 Profile 的規範 Workspace 還可以包含 .anyy/mcp.json，目前路徑為 <ProfileHome>/workspace/.anyy/mcp.json。完整專案定義替換同名 Profile 定義；部分條目只覆蓋啟用狀態、暴露方式及整份有序工具規則。檔案格式和表示式見 Profile 與專案設定。

啟用狀態與預設暴露方式儲存到所選定義檔案或已有專案覆蓋，只影響該服務。透過 Profile 指令修改 description、工具覆蓋、連線定義或認證資料，仍然編輯原始 Profile 設定；CLI 設定參數與 Profile 定義參數必須分開提交。enable／disable --project 只為尚無覆蓋的 Profile 服務建立啟用狀態覆蓋；add／remove --local 則只編輯專案定義，保留 Profile 定義和獨立認證資料，檔案改動要到下次啟動或空閒工作階段重新載入後才生效。

anyy mcp reload 使用已載入的值重新連線，不重新讀取檔案。啟動時或呼叫既有的空閒 session.reload RPC 時，會重新讀取 Profile／專案設定。設定檔中的值表示式、暴露規則及 OAuth 認證詳見 MCP 文件。

認證資料怎樣儲存

Anyy 代管認證資料透過引用進入設定，不直接儲存金鑰本身。Dashboard 和設定指令中的顯式認證資料操作會把支援的金鑰寫入 Profile 的 secrets/，並限制檔案權限。一般 MCP 設定值寫入會保留輸入的字串和表示式，不自動建立代管金鑰；詳見 MCP 設定值。

替換、清除、連線或斷開認證資料時，應回到建立它的 Models、Tools 或 Channels 頁面。不要把 Secret 放入聊天內容、截圖、Shell 歷史或診斷材料。

已儲存，但執行環境還沒變化

大多數 Dashboard 和設定操作在成功寫入後會重新整理對應執行環境。通訊管道也可以明確重新載入：

anyy channel reload

設定已經儲存、行為卻沒有變化時，依次檢查：

anyy status
anyy doctor
anyy gateway status

只有功能給出的修復建議要求重啟，或即時重新載入無法完成時，才重啟 Gateway。

v0.1.107 會拒絕以下舊 MCP 設定，手動維護設定時應刪除或遷移：

• mcp.client.enabled：改用各服務自己的 enabled；
• mcp.client.session_idle_ttl_ms：已退休，工具目錄按通知和顯式操作重新整理；
• 服務級 connect_timeout_ms：改用既有 call_timeout_ms，分別限制初始化、發現和工具請求；
• tools.include、tools.exclude、tools.trusted：改用 exposure 和 toolExposure；tools.resources 與 tools.prompts 也已退休。

沒有新增 request_timeout_ms 設定鍵。完整格式與遷移見 MCP Servers。

手動修改前先備份

anyy backup create

備份會儲存設定和 Workspace 檔案，其中已經寫入的內聯認證資料仍可能原樣包含在壓縮檔中，不能認定一般備份壓縮檔已完整遮蔽敏感資訊。預設排除的是代管 secrets/ 目錄和受支援的 mcp/oauth/ 儲存；--include-secrets 會額外加入這些內容。所有封存都應作為私密資料保護，包含代管秘密時更須按認證資料庫級別保管。完整流程見 備份與復原。

常見問題

現象	檢查項
設定看起來沒有變化	核對目前 Profile，並檢視 anyy config
Gateway 仍使用舊值	執行對應 Reload，再檢視 anyy status
設定校驗失敗	回到 Dashboard 表單或設定精靈定位實際欄位
已設定認證資料但無法解析	從所屬的 Models、Tools 或 Channels 頁面重新儲存
手改 YAML 後無法啟動	復原上一份有效檔案，或把備份還原到新的 Profile