配置文件与设置入口
Anyy 的配置以 Profile 为单位。模型、渠道、工具、定时任务、凭据、Workspace 和运行状态都属于各自的 Profile。
应该在哪里修改
| 修改内容 | 推荐入口 |
|---|---|
| 第一次设置 | anyy setup |
| 模型与凭据 | Dashboard → Models 或 anyy setup model |
| 消息渠道 | Dashboard → Channels 或 anyy setup channel |
| Web、浏览器、图像与语音能力 | Dashboard → Tools |
| Role、Skill、MCP、Cron | Dashboard 中各自的栏目 |
| 查看最终生效配置 | anyy config |
anyy config 是只读命令。它会显示当前 Profile、路径、provider/model 选择以及凭据引用是否可解析，但不会输出 Secret 明文。
Dashboard 和设置向导会做字段校验、凭据保护，并在支持时刷新正在运行的服务。直接改 YAML 更适合高级排障，因为它不会经过这些引导检查。
Profile 里有哪些数据
一个 Profile 目录保存该 Profile 的规范数据，常见路径包括：
| 路径 | 内容 |
|---|---|
config.yaml | 非敏感设置和凭据引用 |
secrets/ | 由 Anyy 管理的 Secret |
state.db | 会话、消息、任务、审计等持久状态 |
memory/USER.md | 长期用户事实与偏好 |
memory/MEMORY.md | 助理的长期记忆 |
objects/ | 由 Canonical State 引用的 Content-addressed 持久内容 |
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。
凭据怎样保存
配置文件保存的是凭据引用，不是 Key 本身。Dashboard 和设置命令会把支持的凭据写入 Profile 的 secrets/，并限制文件权限。
替换、清除、连接或断开凭据时，应回到创建它的 Models、Tools 或 Channels 页面。不要把 Secret 放入聊天内容、截图、Shell 历史或诊断材料。
让修改生效
大多数 Dashboard 和设置操作在成功写入后会刷新对应运行时。渠道也可以明确重新加载：
anyy channel reload
配置已经保存、行为却没有变化时，依次检查：
anyy status
anyy doctor
anyy gateway status
只有功能给出的修复建议要求重启，或 Live Reload 无法完成时，才重启 Gateway。
手动修改前先备份
anyy backup create
默认备份不含 Secret。只有归档能够按照凭据库级别保护时，才使用 --include-secrets。完整流程见 备份与恢复。
常见问题
| 现象 | 检查项 |
|---|---|
| 设置看起来没有变化 | 核对当前 Profile，并查看 anyy config |
| Gateway 仍使用旧值 | 执行对应 Reload，再查看 anyy status |
| 配置校验失败 | 回到 Dashboard 表单或设置向导定位具体字段 |
| 已配置凭据但无法解析 | 从所属的 Models、Tools 或 Channels 页面重新保存 |
| 手改 YAML 后无法启动 | 恢复上一份有效文件，或把备份恢复到新的 Profile |