> ## Documentation Index
> Fetch the complete documentation index at: https://cloud-docs.orbi.build/llms.txt
> Use this file to discover all available pages before exploring further.

# 问题排查

> 交付没动静，我怎么查原因并修好它?

从状态页开始：**①需要你处理**的横幅会写明问题是什么，并给出修它的按钮。

Orbi Cloud 里几乎每个失败状态都会自己说明自己。这一页按用户实际碰到的顺序，讲每个状态的含义和处置。

## 打了 `ai-ready` 但什么都没发生

按顺序查：

1. **是连接的那个仓库吗？** Orbi 只读你连接的那一个仓库里的 Issue。看**绑定的仓库**卡片。
2. **开通完成了吗？** **开通状态**必须是**开通成功**。在那之前没有环境可以跑交付。
3. **过了 5 分钟吗？** 认领走定时器，不是即时的。
4. **标签是不是被摘掉了？** 如果 `ai-ready` 不见了并且多了一条评论，那是额度守卫摘的 —— 见[额度与限制](/zh/limits-and-quotas)。订阅或等下个月，然后重新打标签。
5. **这张 Issue 是不是已经带了别的 `ai-*` 标签？** 已经是 `ai-in-progress` 或 `ai-merged` 的 Issue，再打一次 `ai-ready` 不会重新派发。

如果状态页的**进行中**是空的，并且写着运行环境还没准备好，答案在**绑定的仓库**卡片里。

## `ai-blocked`

`ai-blocked` 是**有意的停止**，不是崩溃。它的含义是：自动恢复不安全，需要一个人来决定下一步。

**先读 Orbi 留在 Issue 上的那条评论**，它写了为什么进行不下去。常见原因：

* 修复循环跑完了允许的轮次，仍然没拿到干净的评审结论。
* 缺少一个外部前置条件 —— 某个交付自己无法安全判断或修复的东西。
* Issue 要求的事情，交付环境做不到（见下）。

**怎么恢复：** 先修掉根因，然后重新打上 `ai-ready`。修根因经常意味着改 Issue 本身 —— 把验收标准写清楚、删掉做不到的要求，或者拆成更小的 Issue。

<Note>
  只摘掉 `ai-blocked` 标签不会重启任何东西，只留一条评论也不会。修掉原因，然后重新打 `ai-ready` —— 这才是把 Issue 放回队列的动作。
</Note>

Issue 被 block 时，PR、分支和工作区都会完整保留，你的东西不会丢。

### 环境满足不了的验收标准

Issue 被 block 的一个高频原因，是要求了交付环境里不可能存在的证据。那个环境有你的仓库和你的测试 —— **没有**你的生产凭据、第三方账号、对着线上站点的真实浏览器，也没有你的部署流水线。

写着「部署到生产并确认」「登录线上后台截图」「用真实失效的 token 复现」这类验收标准的 Issue，会空转然后 block。把它改写成仓库内可验证的东西 —— 断言渲染出的文案、断言错误分类、断言不该出现的内容 —— 生产侧的证据由你自己去取。

## PR 写得不对

在 Issue 上评论说明要改什么，或者直接编辑 Issue 正文。下一次运行会带着你的修正重启 —— 不需要关掉什么，也不需要取消。

如果这个工作干脆不要了，关掉 Issue。如果那是一次未订阅状态下的交付，关闭且未合并会把免费名额退回来。

## 开通失败

**绑定的仓库**卡片会给出原因、发生时间、request id 和下一步。一共四类，完整说明在[开通环境](/zh/provisioning)：

| 原因                  | 怎么办                                             |
| ------------------- | ----------------------------------------------- |
| GitHub App 安装或授权已失效 | 重新安装或授权 App，然后重试                                |
| 模型凭据未被接受            | 在[模型配置](/zh/model-configuration)里改正 key；保存后自动重试 |
| 模型服务无法连接            | 检查 baseUrl 和 key；同样，保存后自动重试                     |
| 平台侧失败               | 什么都不用做，平台会自动恢复。过一两分钟回来看                         |

联系支持时把 **request id** 一起发过去。

## 连不上仓库

| 提示                   | 怎么修                                        |
| -------------------- | ------------------------------------------ |
| 未授权给 Orbi GitHub App | 在 GitHub 的 App 设置里把这个仓库加进安装范围，然后刷新         |
| Issues 已关闭           | 在仓库 **Settings → Features** 勾选 Issues，然后重试 |
| 当前交付仍在进行中            | 等它走到 `ai-merged` 或 `ai-blocked`，再换仓库       |
| 暂时无法读取仓库列表           | 重试；持续失败就用**手动填写**                          |
| 仓库格式无效               | 按 `所有者/仓库名` 填写                             |

## GitHub App 被卸载了

状态页会检测到并提示 **GitHub App 已被卸载**，给出重新安装的入口。在同一个账号下重新安装会接回你原来的租户 —— 历史和配置都还在。之后可能需要重新连接一次仓库，状态页会告诉你。

## 仓库的 Issues 被关掉了

如果连接之后 Issues 功能被关了，状态页会说明并链到你的仓库设置。重新勾上 **Settings → Features → Issues** —— Orbi 的整个输入通道就是 Issues，关掉之后什么都跑不了。

## 额度掉得比预期快

看状态页的**本月缓存命中率**。缓存未命中的 token 单价大约是命中的 **50 倍**，所以低于 90% 会明显更快烧额度。命中率偏低时页面会明确标出来，每条工作的用量明细能让你看出哪次交付特别贵。

大而模糊的 Issue 比小而具体的 Issue 贵得多 —— tokens 和修复轮次都是。

## 用量显示 `—`

那条工作没有上报用量统计。这是采集上的缺口，不代表交付失败。如果整体采集都异常，额度守卫会失败即拒、暂停新派发，而不是基于不可信的数字去花钱 —— 这个状态会自行恢复。

## 登录过期了

重新登录。什么都不会丢：仓库连接、模型配置和交付历史属于你的租户，不属于浏览器会话。

## 页面语言不对

用右上角的 🇬🇧 / 🇨🇳 切换。选择会在这个浏览器上保存一年。

## 怎么找人

状态页底部的**技术支持**卡片里有 Telegram 群链接和二维码，那就是支持渠道。

报问题时请带上：

* 你做了什么、预期是什么。
* Issue 或 PR 的链接。
* 如果涉及开通失败，带上 **request id**。
* 状态页的原话 —— 横幅上的准确措辞。

**永远不要**把 API key、token 或任何凭据贴进支持消息、Issue 或 PR。