初始化设置
安装只是把程序放到设备上。要开始对话，还需要为所选 Profile 配置模型连接。建议先配置一个模型，验证普通对话，再加其他能力。
选对要修改的环境
默认环境：
anyy setup
已有多个 Profile 或自定义 Home 时：
anyy --profile work setup
anyy setup --home /path/to/anyy-home
全局 --profile 放在命令前；子命令的 --home 放在后面。运行 anyy config 可核对当前解析到哪一个 Home。
第一次配置模型
在交互式终端运行向导，选择 Quick setup，完成：
- 选择服务商和它实际提供的认证方式；
- 输入所需的地址、凭据，或完成浏览器／设备登录；
- 选择模型，兼容服务可能需要填写准确的模型 ID；
- 按需跳过备用模型和消息平台；
- 查看 Review Changes，确认后写入。
没有确认 Write these changes? 时，收集的设置不会作为本轮配置写入；确认后的渠道操作会通过 Gateway 直接执行，结果和连接诊断分别报告。
如果主动发起扫码或其他登录，认证过程会在配置提交前联系对应服务。这和最后保存整份配置是不同的操作。
API Key、ChatGPT／Claude Code 订阅登录、本地 Ollama／LM Studio、兼容接口，都以当前版本向导实际列出的组合为准。完整的协议与模型接口说明可以避免把服务商名称误当成原生协议支持。
只改一个部分
| 这次要改什么 | 命令 |
|---|---|
| 服务商、认证和主模型 | anyy setup model |
| 备用模型顺序 | anyy setup model fallback |
| 消息渠道交互配置 | anyy setup channel |
| 全套设置 | anyy setup，选择 Full setup |
备用模型要求已有主模型。它是按顺序尝试的路由链，不会修复错误凭据；重试与 fallback 的边界见服务商协议。
如果 Gateway 已可连接，确认写入模型配置后会请求重载；否则下次启动时读取保存的配置。
消息渠道不是所有界面都能改全部字段
anyy setup channel 是交互入口。带上具体 CHANNEL 后，使用的是非交互动作接口，并不表示预选平台的向导：
anyy setup channel CHANNEL [--home PATH] [--set INPUT=VALUE] [--sensitive-fd INPUT=FD] [--external-locator-fd INPUT=FD]
只使用该平台实际发布的输入字段；敏感值通过文件描述符传入，避免放到命令历史或进程参数。不能凭其他平台教程猜一个字段。
不同平台的访问策略、配对和连接方式以对应平台手册为准。Webhook 平台还需要 Gateway 的独立监听配置和可达的 HTTPS 路径，不是保存账号后执行 reload 就会自动开放监听。
Full setup 中的可选能力
完整向导还可配置图像／视频理解、图片生成、语音识别与合成、网页搜索以及 MCP。每一项都可以跳过，稍后在 Dashboard 或对应工具设置中单独完成。
这些后端的输入和认证各有条件。配置了视频理解不代表任意界面上传的文件都会自动作为视频输入；具体见多媒体。MCP 的保存、认证、连接和实际工具调用也要分别核对。
确认写入后怎样验收？
anyy config
anyy status
anyy dashboard
先检查 Home、模型、地址和凭据引用，再发送一个小问题。不要只看“保存成功”。设置外部服务会使用它的网络、账号额度和数据处理规则。
主要数据位置：
| 内容 | 位置 |
|---|---|
| 模型、路由及能力配置 | <PROFILE_HOME>/config.yaml |
| 由 Anyy 管理的 Provider／MCP 凭据文件 | <PROFILE_HOME>/secrets/ |
| 渠道账号、加密凭据、会话与运行状态 | <PROFILE_HOME>/state.db |
凭据文件与配置正文分开，文件权限为 0600。anyy config 报告凭据引用是否有效，不输出密钥原文。
无法完成时
- 提示需要交互终端：在真实终端运行向导，或改用明确支持的非交互渠道动作。
- API Key 首次输入留空：这表示取消，重新运行模型设置或选择其他认证方式。
- 本地模型列表为空：先启动本地模型服务并确认地址。
- 浏览器登录没有完成：完成服务商流程；会话过期后重新发起。
- 设置看不到变化：对照 Profile 和 Home，再检查重载或重新启动是否成功。
- 渠道不通：先看对应平台的状态和 Doctor，区分凭据、监听、访问策略与平台订阅。