首页 / 文档 / 首次使用
首次使用
管理员已部署实例并邀请你?从下面的登录步骤开始。要搭建自己的实例,先读 部署快速开始。官网是静态文档站;实际登录和操作都在管理员提供的 Console 地址完成。
版本范围:以下说明 rc.35.6-rc8.5(事件投递+入口预检版,源码
3879e390)的受控审修流程;
该版本已随官方镜像与 Release 发布,完整校验与制品说明见
发布与源码范围。页面措辞请结合实例 /api/health 版本核对。1. 登录,确认身份与仓库
- 打开管理员提供的邀请链接,在该实例的登录页选择与邀请一致的 GitHub 或 Gitee 身份。
邀请按平台数字用户 id、租户、角色与有效期绑定;没有公共注册。出现
not_invited、过期或账号不符时,请管理员核对邀请。 - 查看顶栏身份、组织与角色。审批修复、发布评论、应用补丁和合并 PR 需要
maintainer。platform_admin管成员与配置,无法代替维护者审批或合并。 完整能力见角色与权限。 - 从「仓库」选择目标仓库与 PR。仓库为空时,先请维护者确认该租户的仓库绑定为
active;OAuth 登录、App 安装、仓库绑定是三个独立步骤,见 多租户与邀请。
本机地址只能由运行实例的那台机器访问。异地成员应使用管理员提供的受控访问地址。 试用身份登录只适用于明确标注的隔离演示环境,不能替代真实 OAuth 接入验收。
2. 先阅读结果,再决定是否操作
- 确认对象:核对平台、仓库、PR 编号与 head。审批票绑定的是批准时的 head, 不一定是 PR 现在的版本;终态票不能重新批准。
- 阅读发现:在 PR 详情查看来源、规则、文件位置、严重度、摘要与修复建议。 静态规则发现和模型发现分开看;建议缺失或模型未执行都不表示「没有问题」。 演示数据与预置证据只能用于练习,不能当作真实模型产出。
- 核对证据:结构检查、可应用性、实际修复测试和模型判断分别回答不同问题, 见下表。未执行、环境不可用与通过应分别记录。
- 查看资格:维护者可打开合并预览阅读阻塞原因。 远端读取失败时可能无法展示完整资格条件;此时只能记录「未验证」,不能推断其余条件通过。 打开预览不会执行远端提交或合并。
- 区分历史:在 PR 的「运行历史」切换不同 run,核对各自 head。 总览或详情最近记录的 head 不能证明远端最新版本;旧 head 的审查、批准与验证不能替代新 head 的证据。
| 证据 | 能说明什么 | 不能据此推断 |
|---|---|---|
| 格式与路径检查 | diff 格式与涉及路径符合结构要求 | 补丁能应用、修复正确 |
| 可应用性检查 | 对准确 head 的 git apply --check 结果 | 行为正确、实际测试通过 |
| 实际修复测试 | 已配置命令在隔离环境中的执行与前后对比结果 | 未执行时也算通过、远端 CI 已通过 |
| 模型判断 | 模型对问题与修复的评估 | 替代可执行测试或远端 CI |
| 远端 CI | 平台上对应 head 的真实检查结果 | 其他 head 或历史运行同样合格 |
只读试用可以到此结束。可复用首次使用任务卡的 R1–R6 记录独立完成、卡点与求助;其中的维护者历史执行记录不是新用户的完成结果。
3. 维护者逐项确认受控操作
批准修复票、应用补丁、合并 PR 是独立动作。批准修复仅授权生成建议与验证, 不会把补丁自动提交到远端。评论、应用、合并三类远端写各需一次「预览 → 确认」,由配置的机器人身份执行。
- 批准修复:核对 P0/P1 发现与票据绑定 head,逐票决定批准或拒绝。 run 级所需票全部批准后才放行修复轮;生成补丁与验证仍取决于执行器及测试配置。
- 查看补丁:检查改动与各项验证的实际状态。需要发布审查评论时,单独预览目标 PR、 head、机器人身份与评论全文,再确认发布。
- 应用修复:在「应用修复与合并」区打开应用预览,核对远端 head 与补丁版本, 再确认由机器人向 PR 分支新增修复提交。预览后 head 或补丁发生变化时需重新预览。
- 等待新 head 重审与 CI:应用后会入队重审;若提示入队失败,按提示发起新 head 审查, 不要重复应用。CI 由仓库平台执行,MergePilot 读取结果。
- 确认合并:当前 head 审查合格、无未处理 P0/P1、真实 CI 通过、PR 开放且可合并时, 才可预览并确认合并。确认时服务端重新检查;平台分支保护照常生效。
- 核对结果:到远端 PR 核对机器人提交或合并结果;审计元数据由 auditor 或 platform_admin 查询。本地操作记录不能单独证明远端已写入。
没有真实 CI 的仓库会被
ci_not_configured 阻塞合并。
CI 待完成、失败、未知或读取不支持时也不放行。Gitee 当前连接器不支持读取 CI 状态,
因此其合并资格被阻塞;这不是对 Gitee 平台整体能力的判断。4. 被阻塞时,按实际状态恢复
- 远端 head 读取失败或无法核实
- 不能据此认定 head 已变化或一致。请管理员检查机器人凭据、安装权限与连接状态后重新预览。 rc.35.6-rc8 已区分「匹配 / 已变化 / 无法核实」;旧版界面若误显示「已变化」,应结合预览错误原因核对。
BLOCKED且no_repair_pending- 先看审批票和执行记录的实际原因;已拒绝、过期或失效的票不能重批。 需要重新进入修复流程时,修正代码并推送新 commit,产生新 head 后重新审查。 同 head 重复触发会复用既有 run;新 head 也只有再次产生 P0/P1 时才会生成相应审批票。 rc.35.6-rc8 已补充按状态与实际记录区分的恢复提示。
- 「待审批票」为空,但总览仍有已阻断 PR
- 待审批票只统计 PENDING 票,不能覆盖所有失败或卡住的执行;到总览查看已阻断记录。 rc.35.6-rc8 已统一相关计数与空态口径;旧版可能仍使用「待处理」措辞。
result_uncertain:远端写入结果不明- 在历史操作中先点「读回对账」。有证据时才定案;证据不足会保持不确定。 不要盲目重复提交或合并,刷新、重启也不会代替对账。 容器回滚不能撤销已发生的远端提交或合并。
- 无权限或仓库绑定失效
- 核对角色与 active 绑定,请管理员或维护者处理。按钮置灰不代表服务异常; 后端仍对每次动作校验权限。