用途：排查 gps 与 gps-mcp 的失败情况，适用于 Google Play 相关命令报错或返回异常时。
鉴权优先：先运行 gps whoami。报“No credentials found”时设置 GOOGLE_APPLICATION_CREDENTIALS 或使用 --credentials；返回 401 时重新生成服务账号密钥并确认 API 已启用；返回 403 时在 Play Console 中邀请该服务账号并授予应用访问权限。
包名问题：必须使用精确的 application id（如 com.example.app）。若某包名的 listings/tracks 成功、另一个失败，通常是权限按应用维度限定所致。
reviews 为空：reviews list 返回 {"reviews": []} 往往属正常，Publisher API 只返回近期可回复评论的一部分。可用 tracks list 或 listings list 验证鉴权是否正常。
只读模式：--read-only 或 MCP 的 --read-only 会阻止写入（deploy、reply、refund 等），tracks/listings 读取仍可用（临时 edit，不会提交）。提示“Cannot perform write operation … in read-only mode”时，去掉 --read-only，或在用户批准后使用可写会话。
写入确认：CLI 写命令未加 --confirm 会失败，仅在用户明确要求执行变更后再添加。
发现命令：可用 gps ops <keyword> 或 gps search <keyword> 查找子命令；若子命令缺失，改用 gps call 或 MCP 搭配注册表名称。
限制：资料未提供价格、平台支持范围、性能指标及更详细的权限配置步骤；部分说明只覆盖错误现象与对应处理方向，未给出完整排查顺序或全部错误码含义。