技术支持

使用 Usagy 时遇到问题,先看这里的故障排除和常见问题;还没解决,用下面的模板写信给我。

联系

邮箱tyx22000044 [at] gmail.com
回复通常在 3 个工作日内回复

反馈渠道:GitHub Issues

反馈时请附上这些信息

Usagy 版本:
macOS 版本与芯片:
相关工具与版本:例如 Codex CLI x.y
问题描述与复现步骤:
诊断报告:设置 → 导出匿名诊断报告(不含凭证和内容)

常见问题

Usagy 支持哪些工具?

Claude Code、Codex、Qoder CLI 可用;Qoder IDE、WorkBuddy、CodeBuddy 为 Beta。千问办公和 Qoder Work 尚未开始。

为什么大多数工具不显示「剩余百分比」?

因为本地只能拿到消耗量,拿不到账户余额。Usagy 不会编造一个剩余百分比。目前只有 Codex 能从本地读到账户额度。

为什么某个工具显示「不可用」?

可能是工具未安装、版本不支持、缺少文件访问权限,或数据格式发生了变化。在连接器中心查看该工具的诊断信息。

数字和官网不一致怎么办?

点击数字查看解释视图:来源、采集时间、口径、可信程度和已知限制。

Usagy 会读取我的提示词或代码吗?

不会。只读取用量数值,不读取、不保存提示词、回复正文、代码、diff、工具参数和附件。

全部问题

故障排除

某工具一直「不可用」

  1. 连接器中心查看分类(未安装 / 需要授权 / 版本不支持)
  2. 按提示授权文件访问
  3. 导出诊断报告

数字停住不动、显示「已过期」

工具升级可能改变了数据格式;Usagy 保留最后的好值,请提交诊断报告

收不到通知

检查系统设置中的通知权限;检查该平台是否被静音

桌面便签找不到

按 ⌘⇧U;检查是否在全屏 App 的 Space 里

已知问题

  • 尚未发布签名版本
  • Beta 连接器样本量不足或来源格式没有稳定性承诺,数值需要逐次确认
  • 界面只有简体中文
ESC

输入关键词,例如「账单导入」「API Key」「iCloud」。