CLI 指令參考

按目標選擇入口：想持續聊天直接執行 anyy，腳本傳送一回合請求用 chat，健康檢查用 status／doctor，改變環境前用 profile／role 核對邊界。下面的語法來自各指令解析器；不熟悉的入口仍可執行對應的完整子指令的 --help。

參數先放對位置

anyy [--profile NAME] [--profile-root PATH] [--role ROLE]
anyy [--profile NAME] [--profile-root PATH] [--role ROLE] COMMAND
anyy --version
anyy --resume SESSION_ID

--profile、--profile-root、--role 和 --no-color 等呼叫選擇器放在子指令前；預設 TUI 的 --home、--socket、--resume 直接放在 anyy 後；使用子指令時，其支援的 --home／--socket 必須放在該子指令後，放在前面會被拒絕。

參數	用途
--profile NAME	選擇命名 Profile
--profile-root PATH	指定 Profile 管理器的基礎目錄
--role ROLE	為新工作階段選擇初始 Role
--resume ID	在 TUI 中直接復原指定工作階段
--home PATH	選擇 TUI Home；或放在支援它的子指令後
--socket PATH	選擇 TUI Socket；或放在支援它的子指令後
--no-color	關閉終端機顏色
--version	輸出版本資訊

每個指令的精確參數以本機 anyy COMMAND --help 為準。

傳送一回合與排查環境

anyy / --resume

anyy
anyy --resume SESSION_ID

開啟終端機互動介面，可選復原一個工作階段。

anyy chat

anyy chat [--home PATH] [--socket PATH] [--role ROLE] \
  [--session ID] [--json] PROMPT

透過已經執行的常駐 Gateway 傳送一則新訊息。--session 選擇接收訊息的已有工作階段；該工作階段忙碌時，輸入會進入 follow-up 佇列。--json 輸出結構化結果，已啟用工具直接執行。使用 anyy --resume ID 在 TUI 中開啟已有工作階段；佇列操作見工作階段。

成功時的 JSON 結果包含：

欄位	含義
session_id	接收輸入的工作階段
submission_id	本次等待的原始已接受輸入
execution_id	可被後續呼叫重複使用的 Session lane
agent_run_id	提供本次回答的實際呼叫
execution_state	觀察到的 lane 狀態，完成後通常為 idle
outcome	該次呼叫的結果，succeeded 才表示成功
stop_reason	完成或失敗分類
assistant_text	該次呼叫所記錄結果訊息中的可見回答

lane 為 idle 本身不代表成功。澄清暫停（suspended）、失敗、終止、輸入清除和逾時均回傳非零結束碼，不顯示中間回答。逾時或呼叫方取消只終止觀察。指令保持原 submission 身分，不用 Session 最新訊息代替結果。詳見指令列介面。

對話工具選擇

CLI 在預設 TUI 和 chat 入口接受以下參數。選擇只屬於目標 Session，不修改 Gateway 或 Profile 預設值。

參數	含義
--tools LIST、-t LIST	逗號分隔的名稱/模式，或對預設選擇使用完整的精確 +name/-name 修飾清單
--exclude-tools LIST、-xt LIST	逗號分隔的排除名稱/模式
--no-tools、-nt	預設不啟用任何工具
--no-builtin-tools、-nbt	預設不啟用內建工具，仍保留擴充套件的預設啟用

anyy --tools '+codemode,+tool_search'
anyy chat --tools 'read,bash' --exclude-tools 'bash' "检查这个项目"
anyy chat --session SESSION_ID --tools '' "不使用工具回答"

一般模式支援 *。修飾清單不能混用一般名稱，也不能包含萬用字元修飾項。--tools '' 表示明確的空 allowlist，--exclude-tools '' 清空對應排除覆蓋。參數須放在提示詞前；可以放在 chat 前或後，指令內的清單替換對應全域清單。管理類子指令不接受這些對話參數。

兩個停用參數是獨立的 Go 布林 flags。內建工具情形使用 --no-builtin-tools，不支援 Pi 的 --no-tools builtin 寫法；同時傳入時 --no-tools 優先。Codemode 的 on/only 模式來自 Profile 設定，沒有 --codemode-mode 參數。

新 Session 透過 session.new 接收 tool_selection。已有 Session 帶顯式參數時，先呼叫 session.tools.configure；活動工作、排隊輸入、接受準備或摘要工作會導致 conflict，chat 不再提交新輸入。不帶覆蓋參數連線熱 Session 時，保留目前活動名稱。原始冷啟動復原與分支導覽使用所選分支的 canonical 宣告，與 SDK 風格的顯式初始選擇不同。

工具復原、資源重新載入和目前 Session 設定見工作階段。

本機 Prompt 診斷

anyy prompt eval local --authorize-live

在隔離的臨時工作階段中真實呼叫目前 Profile 的模型，可能產生費用。指令顯示 模型回答、實際用量和耗時，並儲存私有報告；--home PATH 選擇 Profile， --output PATH 指定只寫一次的報告路徑。終端機輸出和報告都應保持私有。該診斷不啟動通訊管道或 Cron，也不為模型 品質評分或證明 Pi 對齊完成。

anyy status

anyy status [--home PATH] [--socket PATH] [--json]

檢視 Profile、預設 Role、Home、時區、Gateway 監聽與子系統摘要；模型／認證資料設定用 anyy config，不要把狀態摘要當線上模型測試。

anyy doctor

anyy doctor [--home PATH] [--config PATH] [--json]

輸出 Home／Profile、設定、時區、Gateway 監聽、Cron、Heartbeat、MCP 和儲存等檢查。部分 MCP 項會探測連線；不會自動修復設定。

anyy config

anyy config [--home PATH] [--config PATH]

在終端機中顯示設定概況：路徑、provider/model、Endpoint 及認證資料引用狀態。它不修改設定，也不顯示金鑰明文。

先完成模型與功能設定

anyy setup

anyy setup [--home PATH]
anyy setup model [--home PATH]
anyy setup model fallback [--home PATH]
anyy setup channel [--home PATH]
anyy setup channel CHANNEL [--home PATH] \
  [--set INPUT=VALUE] [--sensitive-fd INPUT=FD] \
  [--external-locator-fd INPUT=FD]

執行完整/快速設定，或只設定模型、fallback、訊息通訊管道。詳見初始化設定。

anyy tools

anyy tools [--home PATH] [--probe]
anyy tools list [--home PATH]
anyy tools websearch [--home PATH]
anyy tools image [--home PATH] [--probe]
anyy tools image understanding [--home PATH] [--probe]
anyy tools image generation [--home PATH] [--probe]
anyy tools video [understanding] [--home PATH] [--probe]
anyy tools voice [--home PATH] [--probe]
anyy tools voice tts [--home PATH] [--probe]
anyy tools voice stt [--home PATH] [--probe]

設定網頁搜尋、影像、影片和語音功能後端；--probe 在支援的流程中驗證連線。

分開管理常駐助理和網頁

anyy gateway

anyy gateway start [--home PATH]
anyy gateway restart [--home PATH]
anyy gateway status [--home PATH]
anyy gateway stop [--home PATH]

管理 resident Gateway 背景服務。

anyy dashboard

anyy dashboard [--home PATH] [--socket PATH] [--listen ADDR] [--no-open]
anyy dashboard --status
anyy dashboard --stop

啟動、檢視或停止按需執行的 Dashboard sidecar。詳見 Dashboard 概覽。

通訊管道與配對

anyy channel

anyy channel doctor CHANNEL [--home PATH] [--socket PATH] [--json]
anyy channel pairing list [--channel CHANNEL] [--account ACCOUNT] [--all] [--json]
anyy channel pairing approve --request REQUEST
anyy channel pairing approve --prompt-code --channel CHANNEL --account ACCOUNT
anyy channel pairing approve --code-stdin --channel CHANNEL --account ACCOUNT
anyy channel pairing reject --request REQUEST
anyy channel pairing revoke --grant GRANT [--reason TEXT]
anyy channel reload [--home PATH] [--socket PATH] [--json]

診斷 Channel、處理 pairing request、撤銷 grant，並讓 Gateway 重新載入通訊管道設定。詳見訊息平台。

擴充工作流程和外部服務

anyy skills

anyy skills list [--home PATH] [--json]
anyy skills view [--home PATH] [--json] NAME [FILE_PATH]
anyy skills install [--home PATH] [--socket PATH] [--name NAME] [--force] [--now] [--json] ZIP_PATH
anyy skills uninstall [--home PATH] [--socket PATH] [--now] [--json] NAME
anyy skills rollback [--home PATH] [--socket PATH] [--revision REVISION_ID] [--now] [--json] NAME
anyy skills reload [--home PATH] [--socket PATH] [--json]

檢視、安裝、解除安裝、還原和重新載入 Skills。

anyy mcp

anyy mcp add SERVER_ID [--home PATH] --transport stdio --command CMD [--cwd DIR] [--env KEY=VALUE] [--disable] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --command CMD [--cwd DIR] [--exposure codemode|deferred|direct|hidden] [--tool-exposure JSON] [--description TEXT] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --url URL [--transport http] [--auth JSON] [--oauth JSON] [--header KEY=VALUE] [--exposure codemode|deferred|direct|hidden]
anyy mcp add SERVER_ID [--home PATH] --preset filesystem [-- ARG...]
anyy mcp add SERVER_ID [--home PATH] --local --url URL [--oauth JSON] [--header KEY=VALUE]
anyy mcp add SERVER_ID [--home PATH] --local --command CMD [--cwd DIR] [--env KEY=VALUE] [--args ARG...]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--exposure codemode|deferred|direct|hidden] [--enable]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--tool-exposure JSON] [--description TEXT]
anyy mcp login SERVER_ID [--home PATH] [--socket PATH] [--timeout SECONDS] [--json]
anyy mcp logout SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp remove SERVER_ID [--home PATH] [--force]
anyy mcp remove SERVER_ID [--home PATH] --local
anyy mcp enable SERVER_ID [--home PATH] [--project]
anyy mcp disable SERVER_ID [--home PATH] [--project]
anyy mcp set SERVER_ID KEY VALUE [--home PATH]
anyy mcp unset SERVER_ID KEY [--home PATH]
anyy mcp status [--home PATH] [--socket PATH] [--json]
anyy mcp list [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER.TOOL [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp call SERVER_ID TOOL_NAME [--args JSON] [--home PATH] [--socket PATH] [--json]
anyy mcp show SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp probe SERVER_ID [--home PATH] [--socket PATH] [--json]
anyy mcp test SERVER_ID [--home PATH] [--socket PATH]
anyy mcp reload [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp logs [SERVER_ID] [--home PATH] [--socket PATH] [--json]
anyy mcp serve [--home PATH] [--socket PATH]

管理 stdio/HTTP MCP Server、認證、可用工具、執行狀態和直接呼叫。Transport 參數差異較大，新增前先執行 anyy mcp --help。

add 預設儲存啟用的 lazy Server，--disable 可停用。設定使用工具暴露與有序覆蓋，不需要工具選擇或成功 Probe。RPC tool_exposure 使用有序 JSON 物件字串；Probe 回傳單一 tools 工具清單及 exposure/offered 事實。

configure --exposure／--enable 把設定儲存到目前定義來源或已有專案覆蓋；configure --description／--tool-exposure 及通用 set／unset 則編輯原始 Profile 定義。一次 configure 混用兩類參數會被拒絕，應分開執行；編輯前可用 show 檢視來源。

add --cwd DIR 只用於 stdio 服務。新增和通用 set SERVER_ID cwd VALUE 保留輸入的相對路徑、絕對路徑或開頭的使用者目錄寫法；cwd 的相對基準是常駐 Profile 的規範 Workspace。

一般 MCP 設定值寫入會保留輸入字串及其表示式，不按敏感欄位名自動儲存為 Secret。Profile 中明確填寫的 env:、secret:、file: 引用仍使用各自的解析規則。

--project 只用於啟用／停用尚無覆蓋的 Profile 服務，寫入僅含啟用狀態的專案覆蓋。--local（也可寫作 -l）只用於新增／移除，目標為 Profile 規範 Workspace 的 .anyy/mcp.json。本機新增會替換同名條目，無須 --force；本機移除保留 Profile 設定和已儲存授權。兩者都不立即重新載入執行條目；在 Profile 設定中新增／移除 MCP 伺服器定義，保留既有確認和認證資料處理。

reload 按已載入設定重新連線，不重新讀取檔案；啟動或空閒工作階段的 session.reload RPC 會重新讀取 Profile 和專案檔案。登入的 --timeout 預設 300 秒，只限制授權階段。詳見 MCP 設定。

logout 清除該服務選中的本機 OAuth 授權及支援的用戶端材料，保留服務定義；線上走常駐執行環境，離線須取得 Profile 獨佔所有權。

anyy mcp serve 可以將 Anyy 接入其他 MCP 用戶端。messages_send 的結果始終屬於原 submission；它可以報告澄清暫停，但不把暫停當成最終答案。欄位與等待介面見 MCP 對話結果/API 參考。

安排定時工作

anyy cron

anyy cron list [--home PATH] [--include-disabled] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --prompt TEXT \
  [--kind agent|skill|notify] [--skills LIST] [--role ROLE] [--workspace WORKSPACE] \
  [--delivery-target TARGET] [--delivery-channel CHANNEL] [--toolsets LIST] [--json]
anyy cron create [--home PATH] --name NAME --schedule SCHEDULE --kind script --script NAME \
  [--workdir PATH] [--role ROLE] [--workspace WORKSPACE] [--delivery-target TARGET] [--json]
anyy cron update [--home PATH] --id ID [--enable|--disable] [--schedule SCHEDULE] [--prompt TEXT] \
  [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron delete [--home PATH] --id ID [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]

create 支援 agent、skill、script、notify。未寫 kind 時，有 script 參數就選腳本，否則預設 agent；agent、skill、notify 任務需要 prompt，腳本任務需要 script。delivery-target 可選 gateway、origin、current_user_default、none，能否使用還取決於投遞條件。執行沿用儲存的 Role、Workspace、任務內容與路由。

anyy heartbeat

anyy heartbeat status [--home PATH] [--json]

檢視常駐 Heartbeat 狀態。

操作哪套資料、使用哪個身分

anyy profile

anyy profile list [--json]
anyy profile get NAME [--json]
anyy profile create NAME [--display-name NAME] [--json]
anyy profile use NAME [--json]
anyy profile delete NAME --force [--purge-secrets] [--json]

profile use 會變更後續指令使用的已記住 Profile，不搬移正在執行的 Dashboard。刪除須帶 force；包含 Secrets 還須 purge-secrets。目標必須非 default、非活動選擇並停止執行，操作清除整個 Home。

anyy role

anyy role list [--home PATH] [--include-archived] [--json]
anyy role get [--home PATH] ROLE_ID [--json]
anyy role create [--home PATH] ROLE_ID [--display-name NAME] [--json]
anyy role update [--home PATH] ROLE_ID [--display-name NAME] [--soul-file PATH] [--json]
anyy role use [--home PATH] ROLE_ID [--json]
anyy role delete [--home PATH] ROLE_ID [--json]

Role 只管理 Profile 內的身分與 Soul；不切換工具或 Codemode。刪除實際封存記錄、保留 Soul，include-archived 可查封存。default 和仍有引用的 Role 受限制。

保護資料及更新程式

anyy backup

anyy backup create [--home PATH] [--output PATH] [--include-secrets] [--json]
anyy backup restore --archive PATH --target-home PATH [--json]
anyy backup list [--home PATH] [--json]

備份一次針對所選 Profile。--include-secrets 只負責額外納入代管的 secrets/、mcp/oauth/ 目錄，不會掃描所有檔案或遮蔽其中的敏感資訊；即使不加參數，設定和 Workspace 檔案中的內聯認證資料仍可能進入封存。每份封存都應保持私密、按敏感資料保護，邊界見備份與復原。restore 的 target-home 必須不存在；沒有覆蓋復原或任意目錄註冊指令。復原後先 status／doctor 驗證，再選擇使用。

anyy maintenance

anyy maintenance compact-state [--home PATH] (--output PATH | --replace) [--temp-dir PATH] [--json]
anyy maintenance checkpoint-state [--home PATH] [--json]
anyy maintenance cache-token-estimates [--home PATH] [--limit N] [--execute] [--json]

這些操作維護資料庫，不是上下文摘要。compact-state 必須二選一 output 或 replace；替換、checkpoint 和 execute 估算補全要求離線所有權。估算預設預覽，只補缺失正數；操作前保留有效備份。

anyy update

anyy update [--home PATH] [--version VERSION] [--base-url URL]
anyy update --compact [--home PATH] [--version VERSION] [--base-url URL]
anyy update --check [--home PATH] [--version VERSION] [--base-url URL]

檢查或更新原生 resident 安裝。詳見更新與解除安裝。

anyy uninstall

anyy uninstall
anyy uninstall --keep-data --yes
anyy uninstall --full --yes
anyy uninstall --home PATH --keep-data --yes

解除安裝原生 resident 安裝。使用 --yes（-y）前必須選擇 --keep-data 或 --full，兩者不能同用。--home PATH 選擇安裝 Home；--full 同時刪除範圍內全部 Anyy 資料，執行前先備份。