11. 诊断

本地用量与发行说明

这份 Matcha CLI 把用量计数和崩溃文件留在**这台机器上**。没有 MatchaCode 账单，官方云上没有用量看板，也没有对外发布的发行说明源。

查看本地用量：`/usage`

在已打开的会话里：

/usage

别名：/cost。/usage show 与单独的 /usage 相同。

全屏时，Matcha CLI 会打开用量面板。有用的是 **session** 块：当前对话的 token 和估算费用。账号额度 / 余额行会空着，或写没有计费数据——这是预期的。没有 MatchaCode 账号可查询。

在 **极简** 模式（--minimal / /minimal）里，同一段会话摘要会打进回滚缓冲，而不是模态框。会话还没开始时，你会看到 **Session usage is unavailable until the session starts.**

没有活动助手时，/usage 什么也不做。

/usage manage

会打印 **Account billing is unavailable in this Matcha build (Mode A).**

这不是安装坏了。计费和订阅已关闭。你选择的服务商（xAI、OpenAI、Anthropic 等）那边仍可能向你收费；Matcha CLI 不展示、也不管理那张账单。

如果服务商返回用量上限错误，Matcha CLI 可以说服务商限额已到，并再次说明这里没有账号计费。

某些安装会完全隐藏 /usage（外部鉴权服务商）。这时输入 /usage 会显示 **/usage is not available.**

/release-notes

别名：/changelog。

这份 Matcha CLI **没有发布**远程发行说明。该命令失败即关闭，并让你用 /docs 看本地 How-to Guides。它不会拉取 CDN，也不会点名产品主机。

要看你正在运行的是**哪一个二进制**：

matcha --version

matcha version 是同一件事；脚本可加 --json。

在 TUI 里看任务帮助：/docs。应用内的第一小时引导是 /tutorial（别名 /tour、/onboarding）。

需要 Doctor 看不到的轨迹时，写一份文件日志：

MATCHA_LOG_FILE=/tmp/matcha.log RUST_LOG=debug matcha

MATCHA_LOG_FILE 按字面路径使用。相对值如 1 会在当前目录创建名为 1 的文件。不要把 API Key 放进你会分享的路径。

若未设置 MATCHA_LOG_FILE，仍会读取已登记的 GROK_LOG_FILE。

崩溃转储留在磁盘上。它们不会被上传。matcha doctor 可以**识别** ~/.grok 下残留的 Grok 崩溃目录，但不会打开或删除它们。卸载 Matcha CLI 从不删除 ~/.grok。

/privacy 打开本地编码数据设置行（值为 **Local**）。它不会打开远程政策页。额外参数如 opt-in 会被忽略。

这些名字存在于二进制里。在这份 Matcha CLI 中，它们**不是**用户流程：

你可能输入	实际结果
`/usage manage`	账号计费不可用
`/feedback`	提交反馈不可用
`/announcements`	不是已发布说明的路径；远程公告已关闭
`matcha update`	自动更新不可用。从源码重新构建。
`matcha trace`（上传）	trace 上传和遥测导出已关闭。不要指望设置 `[telemetry] trace_upload` 或 `MATCHA_TELEMETRY_*` 会连上采集器。

设置 MATCHA_TELEMETRY_*、MATCHA_EXTERNAL_OTEL 或 [telemetry] otel_*，不会把指标或事件发到 MatchaCode、xAI 或第三方采集器。