常见问题与排查
先确认版本和环境，再改设置：
anyy --version
anyy config
anyy status
anyy doctor
anyy gateway status
config 用于核对模型、凭据引用和路径；status 报告运行环境状态。Doctor 只执行其实际检查项，不等于替你验证所有模型账号或每一种渠道。
概念没分清时
Anyy 就是本地模型吗？ 不是。Anyy 是常驻个人助理，可以连接远程服务，也可以使用兼容的本地模型服务。
本地保存是否意味着不联网？ 不是。模型、网页、MCP 和消息平台可能收到任务所需内容，见数据与隐私。
Profile、Role、Session 怎么选？ 独立数据与凭据用 Profile；同一环境内不同助理身份用 Role；一个持续话题用 Session。Codemode 不通过 Role 开关。
会话历史就是长期记忆吗？ 不是。稳定事实和偏好有单独的记忆规则；临时工作进度不应自动变成个人资料。
能删除一段对话吗？ 底层 session.delete RPC 可以删除符合空闲条件的会话，但 v0.1.107 的常用 CLI、TUI、Dashboard 还没有通用的删除入口。不要为删除一段聊天而删除整个 Profile，详见会话。
装好了，却用不了
| 现象 | 先检查什么 |
|---|---|
找不到 anyy | 按安装器的 Binary: 完整路径验版本，再修 PATH |
| 空间不足 | 看错误指向临时目录还是 Home；紧凑模式会减少回滚历史 |
| 更新后界面仍是旧版 | 分别核对当前命令、Gateway、Dashboard 的版本和进程 |
| Dashboard 打不开 | anyy dashboard --status；确认本次地址、监听范围和 Gateway 状态 |
| 旧令牌链接无法再次登录 | 领取登录状态的令牌不是可永久复用链接；在同一已登录浏览器继续，或获取当前有效入口 |
模型或媒体不工作
先在 模型（Models） 页面检查服务商、协议、地址、模型 ID 和凭据引用。不要假设同一个模型名在所有接口都可用。
Test connection 只检查模型目录连通性和模型是否在目录中，不执行聊天生成。保存设置后，在新会话中选择目标并发送一个简短问题；若配置了备用模型，应确认回复没有回退到别的目标，再把它当作这个模型的实际验收。
图片／视频理解、图片生成、STT 和 TTS 不是同一条路由。聊天正常不代表语音或图像后端正常；文件上传成功也不代表它被识别为后端需要的媒体类型。入口和限制见多媒体及语音。
切换模型或思考强度可能影响上下文和缓存；不要仅凭一次调用的费用判断设置未生效。路由、重试和虚拟模型的边界见服务商协议。
对话、队列或历史看起来不对
- 看不到旧会话：先对照 Dashboard 与
anyy config的 Profile、Home，切换环境不会迁移数据。 - 运行中发送后没有立即回复：查看输入框上方队列；若要引导当前任务，使用该项的 提前执行（Steer）。
- 希望中断：按对话或 TUI的实际控制操作，不要把取消观察当作撤回已接纳输入。
- 对话很长或想换历史分支：看压缩与分支，区分界面入口与仅 RPC 的操作。
- 系统通知重开后找不到：先核对会话和 Profile，再看通知；普通消息和独立通知有不同的存储职责。
工具、Skills 和 MCP
工具找不到： 核对当前会话激活的名称、Profile 默认选择、后端状态与 MCP exposure。已注册不等于当前已启用；Codemode和工具搜索也有自己的发现规则。
命令或文件工具报错： 查看路径、操作系统权限、工具输出和运行限制。工具直接执行，不存在旧审批模式或 ChangePlan 等待链路；真正缺少信息时仍可能提出澄清问题。
Skill 不显示： 核对当前环境、启用状态和适用界面，运行 anyy skills reload 后在下一次提问重试，查看目录警告。托管安装只支持本地 ZIP，不接受 GitHub 地址或目录安装。系统 Skill 的移除／开关规则与用户 Skill 不同。
MCP 连接成功却没有工具： 分别核对服务器是否启用、是否确实提供工具、direct／codemode／deferred／hidden 暴露方式及当前发现能力。不要把 Probe、配置保存或 OAuth 登录成功当作实际调用成功。
上下文引用被拒绝： 查看上下文引用允许的来源、范围和限制，缩小到必要内容；不要把凭据、私有内部地址或未经检查的敏感变化放进请求。
消息平台和自动化
| 现象 | 处理顺序 |
|---|---|
| 收不到消息 | 账号状态／连接 → 平台订阅或 Webhook 监听 → 实际访问策略与配对 |
| 已发送但回执未知 | 区分本地交付、平台接受和逐条确认；不是所有适配器都支持 Ack |
| 陌生人可访问 | 停用账号或收紧实际提供的策略、撤销不需要的配对授权，再排查凭据 |
| 定时任务没有触发 | 检查启用状态、时区、计划及 Gateway，再在创建任务的聊天中要求立即运行指定任务，核对最终历史和投递 |
| 任务一直等待 | 区分待执行、模型／工具运行、澄清和投递阶段，不要只看一个 Pending 标签 |
| 后台工作不见了 | 核对来源环境和会话，按后台工作的对应接口查询 |
每个平台的实际设置入口和限制以平台手册为准。
备份和恢复
恢复目标必须是新的、不存在的目录，不能覆盖正在使用的 Profile。普通备份默认不额外收集托管的 secrets/ 和 mcp/oauth/ 目录，遗漏的认证材料需要重新连接或从明确包含它们的受保护归档恢复。配置和工作文件中原有的内联密钥仍可能进入普通备份，不能据此认为归档没有敏感内容。详见备份与恢复。
仍无法定位时，只收集版本、脱敏后的环境信息、准确操作、安全的错误文本和故障前的变更。不要公开访问令牌、API Key、OAuth Code、平台 Secrets、完整环境变量、私聊内容或未经检查的备份。