跳到主要内容

FAQ 与故障排查

大多数问题先运行这一组最短诊断：

anyy --version
anyy config
anyy status
anyy doctor
anyy gateway status

它们可以确认当前 Profile、解析后的 Home、配置健康、常驻 Runtime 与修复建议，同时不会打印 Secret Value。

常见概念​

Anyy 是本地模型吗？​

不是。Anyy 是常驻个人助理 Runtime，可以连接远程或 Compatible/Local Model Endpoint。模型是 Provider Route，不是 Anyy 产品本身。

所有数据都不会离开本机吗？​

Profile 的 Canonical 数据在本地；但使用模型服务商、Web、MCP、Browser 和消息平台时，完成任务需要的内容可能发送到相应服务。详见数据与隐私。

Profile、Role 和 Session 有什么区别？​

  • Profile 隔离数据、凭据、配置和运行时；
  • Role 在同一 Profile 中改变长期助理身份；
  • Session 是一次对话及其历史。

账号或信任域不能混用时，建立不同 Profile。

Anyy 会记住一切吗？​

不会。对话历史按 Session 存储；长期事实与偏好才放入 Profile Memory。需要时可以搜索过去 Session，但临时任务信息不应自动升级为长期记忆。

能删除单个 Session 吗？​

当前公开 CLI、TUI 与 Dashboard 没有通用的 Session Delete 操作。删除整个 Profile 会移除其中所有数据，是另一种破坏性行为。

使用费用如何计算？​

模型请求、Reasoning、Context、Media Route、Web Service 和外部集成都可能产生费用。查看服务商定价，并使用 /usage 或 Dashboard 中当前支持的 Usage 信息。

安装与更新​

找不到 anyy 命令​

打开新 Shell，检查安装 Home 与 PATH。标准 Native Install 会把 Binary 放在 Anyy Home 的 bin/ 下，并在权限允许时建立用户入口。

安装提示空间不足​

Temporary Directory 与 Anyy Home 都要释放空间。只有接受减少 Rollback History 时才使用 ANYY_INSTALL_COMPACT=1。

更新后 Dashboard 还是旧版本​

对照 anyy --version、anyy gateway status 与 Dashboard → About。可能仍有手动启动的旧进程；按 Update Remediation 处理，不要直接删除 Releases。

模型与 Provider​

Setup 无法 Verify 模型​

依次检查 Endpoint、Protocol、Model ID、Credential、Network 与 Provider Quota。以当前安装版本的 Catalog 为准，同一个 Model ID 不能随意用于不同 Endpoint。

Dashboard Chat 不能发送​

在 Dashboard → Models 确认 Main Route 存在且通过测试，再运行 anyy status；Gateway 也必须可达。

Chat 正常，但图片/语音功能不工作​

Image/Video Understanding、Image Generation、STT 与 TTS 是独立 Route。应单独配置并测试；Text Model 可用不代表 Speech/Image Endpoint 可用。

切换 Reasoning 后费用升高​

Effort Change 可能使 Prompt Cache 失效。需要可预测 Context/费用时，在大改 Model/Effort 后新建 Session。

Dashboard 与 Profile​

Dashboard URL 打不开​

运行 anyy dashboard --status 与 anyy status。也可用 anyy dashboard --no-open 重新打印 URL。本机使用 This machine；LAN URL 还要求 Listener 可达且网络可信。

Dashboard 与 CLI 的会话不同​

把 Dashboard → About 与 anyy config 对照，并检查 --profile、--profile-root、--home、ANYY_HOME、ANYY_DEFAULT_HOME 与 Active Profile。

Profile 无法删除​

目标必须不是 default、不是当前/Sticky Profile，而且已停止。CLI 还必须带 --force；Secrets 非空时需要显式 --purge-secrets。

切换后会话“消失”​

Profile Handoff 不迁移数据。切回原 Profile，并在 About/config 核对 Home。

Tools、Skills 与 MCP​

已配置 Tool，但模型看不到​

检查 Dashboard → Tools、Session Toolsets、Optional Backend Health，以及是否需要新建 Session。Visible 不会绕过 Credential 或 Approval。

文件/命令等待 Approval​

打开 Chat 内联请求或 Dashboard → Approvals，检查 Target、Effect、Validation 与 Rollback。不要为了清空队列而开启 yolo。

Skill 没有出现​

确认当前 Profile/Surface 中已经 Enabled，运行 anyy skills reload，再新建 Session。System Skills 不能像 User Installed Skills 一样移除或 Toggle。

MCP 已连接但没有 Tools​

查看 Server、Probe Catalog、检查 Include List、Enable 并激活 mcp-NAME Toolset；配置变化后 Reload。

@ 引用被阻止​

凭据路径、二进制、Private/Internal URL、Path Escape、过大内容和包含敏感路径的 Git 变化都会被拒绝。改用安全的较小行段或公开来源。

Browser 与 Web​

找不到托管 Browser​

安装支持的 Browser，或在 Anyy 主机设置 ANYY_CHROME_BIN/ANYY_EDGE_BIN，然后运行 anyy browser doctor。

Browser Enabled 但不能操作​

检查 anyy browser status、Backend Health、Tabs 与 Approval。Action 使用最近 Observe 返回的 Ref；页面变化后可能要重新 Observe。

Web Search 失败​

打开 Dashboard → Tools 或运行 anyy tools websearch，检查 Provider/Credential 并执行 Test。Public URL Fetch 还会阻止 Private Network Target。

消息平台​

Channel 收不到消息​

运行对应平台 Doctor，确认 Account Enabled/Connected，再检查 DM/Group Policy 与 Pairing Grants。某些平台还要求 Webhook 可达或平台侧 Event Subscription。

Outbound Delivery 失败​

核对 Destination Binding、Account Health、Adapter Capability 与 Receipt。Tool Call Success 不一定等于平台已经确认送达。

陌生用户可以访问 Anyy​

Disable Account 或收紧 Policy，Revoke 异常 Pairing Grant，轮换可能泄露的 Channel Credential，并检查近期 Activity。

自动化与后台工作​

Cron 没有执行​

检查 Enabled、Schedule 在 Profile Timezone 下是否有效、Gateway 是否常驻，以及 Role/Toolsets 是否仍存在。先 Run now，再看 History。

Schedule 卡在 Approval​

Approval-mode Job 可以暂停等待决定。审查请求，或把任务重新设计为更窄的无人值守效果；只有充分测试并接受权限时才使用 yolo。

找不到后台工作​

检查 Dashboard 的 Background Sessions 和来源 Profile。Background/Delegation 状态属于发起 Session 的 Scope；切换 Profile 会改变可见范围。

备份与恢复​

Restore 提示 Target 已存在​

恢复强制要求全新的不存在目录，不能覆盖 Live Profile。换一个路径。

恢复后 Provider 无法认证​

普通备份排除 Secrets。重新连接 Provider/Channel/MCP Credential；或使用已经按凭据安全保护、并明确包含 Secrets 的备份。

Doctor 仍然报错​

按失败 Probe 给出的 Remediation 操作，再运行对应功能的 Status/Doctor。保存 Logs 或 Debug Bundle 前，先检查其中是否有敏感内容。

仍需帮助时​

只收集最小可复现证据：Version/Commit、脱敏后的 Profile 信息、Exact Command、安全的 Error Text、Probe 名称，以及故障前最后一项变更。

不能公开 Dashboard Token URL、API Key、OAuth Code、Channel Secrets、完整 Environment、私人消息或未经检查的备份。