附录
E. 从 Grok Build 迁来
本产品是 **Matcha CLI**。Grok Build 名称只作兼容。xAI 是可选的第三方服务商，不是 MatchaCode 账号，也不是本产品。
相关：名称、路径与服务商；配置服务商（BYOK）。
哪些仍然兼容
| 界面 | Matcha 名称 | 兼容 |
|---|---|---|
| CLI | matcha | grok shim：同一二进制，弃用警告只打到 stderr。历史上的 agent argv0 仍可解析且不警告 |
| 主目录 | ~/.matcha（MATCHA_HOME） | 若存在 ~/.grok，首次启动会把可恢复文件复制迁移（有日志、幂等），并且不删除 ~/.grok |
| 项目目录 | .matcha/ | 会读取并迁移 .grok/；冲突文件不会静默合并 |
| 环境 | MATCHA_* | 已注册的 GROK_* 名称在 Matcha 名未设置时可用。两者都设置时 Matcha 优先，诊断会点出变量名，不打印值 |
| 主题 | MatchaNight / MatchaDay | groknight / grokday 仍可加载 |
| 策略窗口 | — | shim、已注册的 GROK_*，以及对 ~/.grok 的只读发现，至少保留两个 Matcha CLI 稳定版或 6 个月，以较长者为准 |
凭证
| 要做 | 不要做 |
|---|---|
matcha login --provider xai（或 openai、anthropic、openai_compatible、ollama） | 把旧的 xAI token 当成 MatchaCode 账号 |
| 旧的 xAI 密钥只当作 xAI 服务商凭证导入 | 运行 matcha login --oauth / --device-auth |
优先 MATCHA_*；把 GROK_* 留作只读回退 | 在配置里整批改写 grok / xai 字符串 |
冲突与弃用诊断从不打印密钥值。
matcha login --provider xai迁过来之后不要指望
- 首次启动没有 grok.com / SuperGrok / 设备码界面。
- 没有 MatchaCode 账号、OAuth、计费、遥测、插件市场或官方云。见附录 A。
- 卸载 Matcha CLI 不会删除
~/.grok。那个目录属于先前的产品。 matcha doctor对遗留的 Grok 主导进程套接字、锁和崩溃转储只作识别。
名称怎么工作
- 展示名是 Matcha CLI，命令是
matcha。新的写入进入MATCHA_*、~/.matcha、.matcha/。 - 兼容是新名优先、旧名只读。迁移幂等且可恢复；旧数据从不会自动删除。
- 只有你明确选择 xAI 服务商时，才会联系 xAI / Grok。
- 不要对
grok、xai、GROK_*、XAI_*或x.ai/*做未分类的全部替换。产品品牌、服务商 id、法律文本、旧夹具和协议字段不是一回事。