支持的平台

已出证与 Best Effort

Best Effort 表示源码也许能编译、能跑，也有人会反馈所见，但 Matcha CLI 并不声称这些平台已获支持。不要把它们当成已出证平台来规划上线。Windows 不是主要支持平台。

你运行的是本地 matcha 二进制。本地源码构建是开发构建，不是已出证的发行产物。

读产品版本

两种等价的人类可读入口：

matcha --version
matcha -v
matcha version

-v 和 -V 是 --version 参数。version（可见别名 v）是子命令。两者打印的都是 Matcha CLI 产品 SemVer，不是内部包版本。

典型的 stdout 看起来像：

matcha 0.0.1-alpha.1 (<short-sha>) [alpha]

括号里的 commit 是该构建的 version-with-commit。[alpha] / [stable] 后缀是缓存的渠道标签（若有）；也可以为空。

机器可读输出只在子命令上：

matcha version --json

它打印含 currentVersion 和 channel 的 JSON 对象。matcha --version --json 不是同一条解析路径；请用 matcha version --json。

「没有安装器」在实际里意味着什么

• 你自己把 matcha 放到 PATH 上（或按路径运行它）。
• 卸载就是反过来：删掉那些二进制。除非你特意删除，~/.matcha 会保留。卸载 Matcha CLI 时不要去删 ~/.grok。
• matcha update、--no-auto-update 和 MATCHA_DISABLE_AUTOUPDATER 不会联系更新器。残留参数是兼容性空操作。

如果 PATH 上已有另一个 matcha（常见情况是无关的 Homebrew formula），不要覆盖它。在核对之前，请用路径调用此构建：

command -v matcha
matcha --version

终端

TUI 需要现代终端。已出证的日常使用是 macOS Apple Silicon。tmux、SSH、truecolor 和剪贴板怪癖，请用 /docs Terminal Support and Troubleshooting 以及 matcha doctor（或会话里的 /doctor）。那些页面不会把 Best Effort 操作系统升级成已支持。

试一试

1. uname -m — 在已出证的 Mac 上应看到 arm64。
2. 若二进制已在 PATH 上，运行 matcha --version 和 matcha version --json。
3. 确认打印的名称是 matcha，SemVer 是产品版本，而不是内部包版本。

如果你在 Intel Mac、Linux 或 Windows 上，仍可以构建和试用。把你看到的一切当成 Best Effort 证据，而不是支持承诺。