开始用
试用之前必须付费吗？ 不用。登录、安装 App、连接仓库、准备工作环境，以及前 3 次合并的交付全部免费，不用绑卡。见付费。 必须配置模型或 API key 吗？ 不用。免费交付和两个付费套餐都包含模型用量，交付默认走平台通道。配置自己的 key 是可选项，见模型配置。 需要在本地装什么吗？ 不用。全程在浏览器和 GitHub 里完成。你不会拿到 runner 的 shell，本地也不跑任何东西。 可以用在私有仓库上吗？ 可以。GitHub App 在你授权的私有仓库上正常工作。 能连多个仓库吗？ Pro 套餐同时最多连五个，免费和 Solo 同一时间只能连一个真实项目。所有套餐都一样：连满之后先断开一个仓库，再连新的。见连接仓库。 支持哪些语言和框架？ 没有固定的支持清单：Orbi 不带针对某种语言或框架的专门规则，靠的是你仓库自己的测试和 CI。Orbi 在隔离的环境里使用你仓库的代码和测试。它运行这些测试，按你的测试和覆盖率要求评审，并在合并门禁读取仓库上报的 CI 检查。CI 能保证什么，取决于这些测试覆盖了什么。见第一张 Issue和你的 CI 保证什么。 第一张 Issue 该写什么？ 可以先看 Orbi 读仓库后给出的建议。新任务点「查看需求」，确认草稿后再交付；已有 Issue 的「让 Orbi 做这个」直接派发。也可自己「写需求」或在 GitHub 建票。第一次选范围小、验收清楚的任务。见第一张 Issue和写需求。 给它写权限安全吗？ App 只能访问你选中的仓库，一开始可以只选一个小仓库；每一处改动都以 PR 的形式到来，合并前经过评审。见安装 GitHub App和安全。 能用在组织的仓库上吗？ 可以。把 App 装在组织上，会为这个组织创建一个独立的租户，有自己的订阅和用量。跑交付
怎么把活交给 Orbi？ 可以选 Orbi 的建议，也可以自己定任务，最终都是给 Issue 打上ai-ready：新建议先看草稿再确认；已有 Issue 点交付按钮立即派发。下面这些入口也保留：
- 在状态页点「写需求」，用一两句话说要改什么。Orbi 读你的代码写出 Issue 草稿，你看过没问题就点「交给 Orbi 开始做」。见写需求。
- 在状态页点已有 Issue 旁边的「让 Orbi 做这个」（或「试试 →」）。
- 在 GitHub 上，在连接的仓库里建 Issue，自己打上
ai-ready标签。见派发第一张 Issue。
ai-ready 时，会唤醒这个仓库的 runner。这个信号丢了的话，每 5 分钟一次的定时器也会认领它。
一次交付要多久？
完全取决于任务大小。小而具体的改动很快，大而模糊的会慢，并且会走更多修复轮次。
交给 Orbi 后多久能合并？
环境就绪、额度可用，且没有更早的任务或版本范围限制挡住时，打上 ai-ready 后通常 1 分钟内开工，每 5 分钟一次的定时认领兜底。Orbi 自己三个仓库（orbi、orbi-cloud、orbi-website）的实测覆盖 239 次交付，2026-09-26 校准：从开票到合并的中位数，小于 100 行档约 23 分钟，100–500 行档约 60 分钟，500–2000 行档约 91 分钟（按新增与删除行数之和）。计时从开票开始，可能早于交给 Orbi 的时间。耗时较长的交付主要受排队和阻塞后等人处理影响，主要耗时不在写代码。这是 Orbi 自己仓库的实测，不是交付时间承诺。见交付生命周期和问题排查。
跑到一半我改主意了怎么办？
在 Issue 上评论或编辑正文，正在跑的会话会带着你的修正重启。它接受 3 次这样的重启，且只有仓库的可信角色能转向。见交付生命周期。
能中止一次交付吗？
关掉 Issue。如果那是未订阅状态下且未合并的交付，关闭会把免费名额退回来。
Orbi 是自己评审自己的代码吗？
评审跑在一个没有写过这份代码的会话里，它会先修掉发现的问题，之后才可能进入合并门禁。这不是同一个会话给自己判卷。但它仍然是 Orbi，所以真正让保证落地的是你自己的 CI。
它会不经我批准就合并吗？
会，前提是评审结论干净且合并门禁通过，这正是无人值守循环的意义。如果你希望每次交付都要人工批准，把分支保护设成要求 approving review；见安全。
主干本来就红着，Orbi 还能合并吗？
同一检查在已评审的 PR 和主干（PR 的目标分支）上都失败时，Orbi 会暂停交付。评论会说明 PR 已做好、正等目标分支的检查恢复，并逐项列出失败检查、运行链接和开头几行报错。有仓库写权限的人在原交付 Issue 上回复 /orbi fix-base，会为每个失败检查新建或复用开放的修复票，标上 ai-ready + p0（最高优先级）。在状态页上点「让 Orbi 开修复票」，会替你发这条命令。本次暂停时记录的目标分支检查全部变绿后，原 PR 可恢复交付，重新评审，通过合并门禁后再合并。见问题排查里「基础分支自己的检查没通过」一节，以及引擎的恢复流程。
ai-blocked 是什么意思？
是有意的停止，表示需要人来决定下一步，不是崩溃。修掉原因后，仍有开放 PR 就把 ai-blocked 换成 ai-fix-needed；没有 PR 就换成 ai-ready。见问题排查。
不一直开着页面，也能收到 Telegram 提醒吗？
可以。在「设置 → 通知」填好机器人和 Chat ID，一个账户下的仓库共用配置。「Orbi 消息语言」另选消息语言，不跟网页切换。见通知。
试官方示例会用掉免费次数吗？
不会。每个账户可连一个经核实的官方示例副本，不占仓库名额，也不占免费交付次数。见示例体验。
额度与价格
多少钱？ 3 次合并的交付免费，之后可选 Solo（每月 4 亿 tokens，一个仓库）或 Pro（每月 12 亿 tokens，最多五个仓库），按月或按年付费。没有按 token 的超额计费，额度用完时交付暂停。当前价格见价格页，订阅见付费。 失败的交付会消耗免费额度吗？ 不会。落到ai-blocked 或未合并就关闭的交付会把名额退回来；开工前被 Orbi 退回补充信息（ai-needs-detail）的需求也会退回。
额度够跑多少次交付？
取决于任务大小、代码库大小和 prompt caching。价格页上有各套餐当前的实测区间。
月额度用完会怎样？
Orbi 暂停认领新的 Issue，它们的标签保留，在途交付照常跑完。每月 1 日（UTC）会自动恢复交付；保存自己的模型 key 或升级套餐则立即恢复。见额度与限制。
额度掉得很快，为什么？
打开状态页的「用量与设置」，看「本月 AI 用量」那一行的「其中缓存」百分比。缓存读取和输入、输出一样计入额度，缓存占比不影响额度消耗的速度；额度用得快，说明任务本身用的 tokens 多。
发版
Orbi 会自动发版吗？ 版本和发布策略由你决定。在「版本」里点「创建 Release 任务」，或建带ai-ready 与 ai-release 的 Issue；启用的里程碑流程也可在确认版本后创建发布任务。见发版。
版本号是它决定的吗？
不是，由你来定。下一个版本发什么是产品决策，Orbi 不替你做。
发版为什么在确定交付范围时停下？
scope 来自标题与版本号完全一致的 milestone，而这个 milestone 不存在。用状态页上的「创建版本并继续」；或者以后用「新建并切换」来建版本，它会替你把 milestone 建好。
必须用版本吗？
不必。在你设定交付范围之前，每张 ai-ready 的 Issue 都会被认领。想分批发布时，版本才派上用场。见发版。