GitLab Orbit 正式可用后怎样连接代码与交付上下文

GitLab 在 2026 年 10 月 29 日宣布 GitLab Orbit 正式可用（GA）。我理解它最值得关注的地方，不是又增加了一个代码搜索入口，而是把代码、合并请求、工作项、流水线、漏洞和负责人放到同一张可查询的生命周期图里，让代理先拿到交付上下文，再回答“这次改动会影响什么”。

官方地址：https://docs.gitlab.com/orbit/

如果团队的问题经常跨仓库、跨流水线和跨安全记录，Orbit 的价值在于减少代理反复翻文件和调用接口的次数；如果只需要当前文件的补全，它就不是必须新增的基础设施。

先看懂 Orbit 连接了哪些上下文

官方把 Orbit 定义为 GitLab 数据与代码的只读属性图。软件生命周期层包含组、项目、合并请求、流水线和工作项，代码层包含文件、目录、定义与导入关系。两层连接起来后，代理可以从一个合并请求继续追到调用方、部署环境、漏洞记录和负责团队。

这里有两个容易误读的边界。第一，Orbit 是只读图，创建问题、修改代码或启动代理会话仍由 GitLab CLI、Duo 或其他工具完成。第二，查询结果会按 GitLab 权限过滤，不应把代理看见的结果理解为绕过访问控制后的全量数据。

按官方路径完成第一次接入

官方文档列出的接入前提是 Premium 或 Ultimate；GitLab.com、GitLab Self-Managed 和 GitLab Dedicated 都有对应说明。使用 GitLab CLI 时，需要 glab 1.126 或更高版本，并先完成登录。然后在任意 Git 仓库目录运行安装和索引配置：

# 先确认 GitLab CLI 版本和当前登录状态
glab version
glab auth status

# 安装 Orbit CLI，并按提示为本机代理写入接入配置
glab orbit --yes setup --yes

# 查看当前仓库的 Orbit 工作区索引状态
glab orbit workspace list

这一步安装的是代理所需的 Orbit 能力，并开始索引仓库。服务端代码主要来自项目默认分支，不能把尚未合并的任意分支当作云端图的同等数据；需要分析本地未合并代码时，应使用文档提到的 local graph。首次索引可能需要几分钟，大型代码库可能更久，后续生命周期变更则按索引周期更新。

让不同代理共享同一张图

GitLab Duo Agent Platform 原生使用 Orbit；Claude Code、Codex、Cursor 等兼容代理可以通过 Orbit CLI 或 MCP 连接，自建工具则可以使用 REST。入口不同，但查询对象仍是同一张图，这对团队很重要：不用为每个代理重复维护一套代码连接器、权限映射和上下文拼接逻辑。

我会把第一轮问题限制在能返回关系证据的范围内，例如“这个合并请求改动的定义有哪些外部调用方”“某个漏洞影响哪些项目、哪些修复已部署到生产”“一个持续失败的 CI 任务还在哪些项目出现”。这类问题的共同点是答案不只来自当前 diff，而是要把代码关系和交付记录放在一起。

GA 后最适合先验证的三类场景

1. 变更影响：在合并前查询受影响的服务、任务、环境和负责人，把“看起来可以合并”变成有图结果支撑的判断。
2. 漏洞修复：从漏洞找到受影响项目、修复合并请求和生产部署，优先处理仍未到达生产的项目。
3. 流水线故障：观察同一个 CI 任务在多个项目中的失败频率、共享配置漂移和负责团队，避免只在单仓库里反复重跑。

这些是适合做试点的原因：问题边界清楚，也能直接对照 GitLab 中的合并请求、部署或漏洞对象。试点时不要只看代理回答是否流畅，要记录它是否给出对应关系、是否受当前账号权限约束，以及索引时间是否满足团队的排障时效。

费用、权限和上线范围怎么判断

公告给出的商业方式是组织共享查询池：每个查询包按每用户每月 30 个 GitLab Credits 提供 1000 次查询，超出部分按每个 GitLab Credit 33 次查询计费，具体套餐与试用仍应以账户团队和当前合同为准。因为人和代理共用池，评估时要把人工查询、Duo、MCP 代理和自建工具的总量放在一起估算。

权限也要作为上线条件，而不是事后补丁。Orbit 每次查询都会按 GitLab 权限过滤；同一个问题由不同角色发起时，结果可能不同。对漏洞和生产部署这类问题，应先用最小必要角色做试点，再明确哪些人可以查看哪些对象，最后记录索引延迟和查询成本。

常见问题

Orbit 是代码写入工具吗？不是。官方文档将其描述为只读属性图，写入动作仍要通过 GitLab 原有工具或代理工作流执行。

为什么本地新改的代码还查不到？云端图以默认分支索引为主，尚未合并的改动不一定进入服务端图；需要查看本地变化时，按官方文档使用 local graph。

所有代理都要单独做连接器吗？不一定。Duo 可原生接入，其他兼容代理可走 CLI 或 MCP，自建工具可走 REST；它们共享同一图和权限边界。

什么团队值得优先试用？跨仓库依赖多、合并请求需要影响分析、漏洞修复要追踪到生产，或 CI 故障经常需要多团队协作的团队更容易得到直接收益。