用途：用于 CodexBar 的实时提供商测试、发布冒烟测试、菜单验证，以及排查“某提供商可用/失败”的报告。需在 CodexBar 仓库检出目录中操作。
主要能力与用法：优先使用打包 CLI：CodexBar.app/Contents/Helpers/CodexBarCLI，不要用 CodexBar.app/Contents/MacOS/codexbar（应用二进制，作为 CLI 可能看似挂起）。运行捆绑脚本 .agents/skills/qa-test/scripts/live_provider_matrix.sh --enabled；可用模式包括 --provider all、--providers openai,zai,deepseek、--default。--enabled 按配置查询已启用提供商；--default 运行面向应用的默认命令；--provider all 强制所有已注册提供商，缺少会话/密钥时预期失败。绿色应用配置需 --enabled 与 --default 均干净。
配置 QA：用 CodexBarCLI config validate 校验配置，用 stat 检查权限，用 jq 对 apiKey、secretKey、cookieHeader、region、tokenAccounts 等做脱敏；编辑前先备份 config.json 并 chmod 600。
实时菜单 QA：CLI 检查后用 Peekaboo 执行 menu list-all、menu click-extra，配合 screencapture 与 sips 裁剪截图，再用 view_image 目视确认提供商标签/行与已启用配置一致。
Browser Use：仅在需要登录态仪表盘、API 密钥页或提供商文档时使用；不可用时说明并改用公开官方文档搜索，不要用隔离 Playwright 替代依赖登录/配置文件的页面。
限制与注意：不要运行宽泛的 env、set 或密钥正则转储；密钥使用 $one-password，所有 op 命令放在一个持久 tmux 会话中，优先服务账号，不输出原始密钥。浏览器 cookie/钥匙串流程有提示风险，除非用户明确要求实时 UI，否则优先 CLI/API 令牌检查与 KeychainNoUIQuery 安全测试。API 行为只查阅官方提供商文档。修复分诊：缺少认证/会话则配置或报告阻塞；API/规格错误则查官方文档后修补；密钥存在但被拒则视情况禁用提供商；面向用户的行为变更需更新 CHANGELOG.md；代码修复需聚焦测试、make check、$autoreview 与实时 CLI 证明。已知注意：OpenAI Admin API 密钥才是可用的用量密钥；Deepgram 用量需 Management API 权限；Groq 用量走 Prometheus 指标 API；MiniMax 按量付费密钥与 Token/Coding Plan 密钥不同。