CLI 命令参考

直接运行 anyy 会打开 TUI；其余公开子命令用于配置和操作当前 Profile 与常驻 Gateway。

全局入口

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 等调用选择器放在子命令前；--home、--socket 是具体命令参数，应放在支持它们的子命令后。

参数	用途
--profile NAME	选择命名 Profile
--profile-root PATH	指定 Profile 管理器的基础目录
--role ROLE	为本次调用选择 Role
--resume ID	在 TUI 中直接恢复指定会话
--home PATH	放在支持它的子命令后，指定 Anyy Home
--socket PATH	放在支持它的子命令后，连接明确的 Gateway 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] [--yes] PROMPT

通过已经运行的 resident Gateway 发送一次提示词。--session 继续已有会话；--json 输出结构化结果；--yes 会批准支持的待处理审批，只应用于你已经确认任务及副作用的场景。

anyy status

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

查看所选 Profile、Gateway 和运行时状态。

anyy doctor

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

执行配置与运行时诊断。

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 在支持的流程中验证连接。

Gateway 与 Dashboard

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 重载渠道配置。详见消息平台。

Browser

anyy browser

anyy browser status [--home PATH] [--socket PATH] [--json]
anyy browser doctor [--home PATH] [--socket PATH] [--json]
anyy browser connect [--browser NAME] [--headless] [--yes] [--home PATH] [--socket PATH]
anyy browser connect --url URL
anyy browser connect --backend agent-browser [--args ARG[,ARG...]]
anyy browser disconnect [--home PATH] [--socket PATH]
anyy browser enable [--browser NAME] [--headless] [--yes] [--home PATH] [--socket PATH]
anyy browser enable --backend playwright-mcp --url URL
anyy browser enable --backend agent-browser [--args ARG[,ARG...]]
anyy browser disable [--home PATH] [--socket PATH]

连接或配置浏览器后端。创建本地隔离浏览器连接需要明确确认；高级兼容参数见 anyy browser --help。

Skills 与 MCP

anyy skills

anyy skills list [--home PATH] [--json]
anyy skills view [--home PATH] [--json] NAME [FILE_PATH]
anyy skills install [--home PATH] [--name NAME] [--force] [--all] [--now] [--json] SOURCE
anyy skills uninstall [--home PATH] [--now] [--json] NAME
anyy skills rollback [--home 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 [--env KEY=VALUE] [--no-discover] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --command CMD --enable --include a,b [--activate-toolset] [--args ARG...]
anyy mcp add SERVER_ID [--home PATH] --url URL [--transport http] [--auth oauth|header|none] [--header KEY=VALUE] [--enable --include a,b]
anyy mcp add SERVER_ID [--home PATH] --preset filesystem [-- ARG...]
anyy mcp configure SERVER_ID [--home PATH] [--socket PATH] [--include a,b] [--enable] [--activate-toolset]
anyy mcp login SERVER_ID [--home PATH] [--json]
anyy mcp remove SERVER_ID [--home PATH] [--force]
anyy mcp enable SERVER_ID [--home PATH]
anyy mcp disable SERVER_ID [--home PATH]
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。

自动化

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 [--execution-mode approval|yolo] [--json]
anyy cron update [--home PATH] --id ID [--enable|--disable] [--schedule SCHEDULE] [--prompt TEXT] \
  [--execution-mode approval|yolo] [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]
anyy cron delete [--home PATH] --id ID [--role ROLE] [--workspace WORKSPACE] [--all-scopes] [--json]

管理定时提示词。yolo 任务可能在没有交互审批时执行，创建前应特别核对范围和影响。

anyy heartbeat

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

查看常驻 Heartbeat 状态。

Profiles 与 Roles

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 Home。删除是破坏性操作，必须带 --force；--purge-secrets 进一步清理凭据。

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 与 Soul 内容。

高级 Prompt 评估

anyy prompt eval

anyy prompt eval [--output PATH] [--json]
anyy prompt eval local --authorize-live [--home PATH] [--output PATH]
anyy prompt eval live --manifest PATH --authorize-live --credential-env NAME
anyy prompt eval tui [--mode collect|finalize-grades|finalize-report] ...

默认命令只在本地运行 Prompt Program Gate，并写出不可覆盖的 Report。local 使用当前 Profile 选择的 Provider/Model 发起真实调用，把结果保存为私有对比报告；不带 --authorize-live 时会拒绝运行。

live 只验证精确 Target Manifest 与 Credential Environment，再交给经过授权的外部 Runner，本身不执行远程评估。tui 用于收集和最终整理固定输入的资格测试产物；不同 Mode 的必填文件不同，应以 anyy prompt eval tui --help 为准，不要拼接不完整参数。

评估可能产生真实费用

local 与 TUI collect 会调用实际模型。添加 --authorize-live 前，先核对 Profile、Target Files、Credential Environment 和 Output Path。

备份、维护和版本生命周期

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 才会打包。

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]

执行状态库和 Token 估算缓存维护。任何会替换状态库的操作，之前都应有验证过的备份。

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

卸载原生 resident 安装。--full 会同时删除范围内全部 Anyy 数据，执行前先备份。