v0.2.0-beta.6-rc.35.6-rc8.5 · 事件响应维护 · Apache-2.0 开源自托管

PR 事件自动审查,
每一步远端写入由维护者确认。

MergePilot 是自托管的多 Agent PR 审查与受控变更工作台。接入你的 GitHub App 与 Gitee 仓库,将静态规则、外部 LLM 第二阶段与可选本地 RAG 发现汇集到你自己的 Console;评论、机器人提交修复、确认合并三类远端写均经「预览 → 确认」且全程审计留痕。

$ docker pull ghcr.io/nghqqa/mergepilot-console@sha256:f8bc369f…afe9a 点击复制
源码 3879e390 Schema v29 SBOM 48 组件 · Trivy 0 漏洞 校验与发布范围
4
Agent 角色
Reviewer / Fixer / Verifier / Leader
5
非递增 RBAC 角色
平台管理与业务裁定物理分离
v29
Schema 版本
业务表按 tenant 复合外键隔离
0
发布时漏洞 / 密钥数
Trivy 全零 · 扫描档案
100%
开源自托管
非 SaaS · 数据与密钥完全自持
CONSOLE SHOWCASE

界面与受控闭环实测

从 PR 事件入队到维护者确认合并:点击任意截图可查看原始分辨率大图。

阅读完整使用流程 →
MergePilot Console · PR 总览、风险状态与审查进度 查看原图 ↗
MergePilot Console 总览界面:PR 列表、风险状态与审查进度
集中查看租户内全部绑定仓库的 PR 审查进度、待审批票据与阻断原因;结论与证据全部落在你自己的实例中。 总览图:rc.16 脱敏测试环境
多角色审查管线与发现落库实测截图
01

多角色审查管线与发现落库

规则引擎、外部模型与 AgentTeams(Fixer / Leader / Verifier)逐轮耗时、执行状态与结构化发现分列留痕,未执行项如实标注。

P0/P1 高危修复具名审批门实测截图
02

P0/P1 高危修复具名审批门

分支保护状态如实探测(未知即 fail-closed);高危发现逐条生成绑定当前 head 的具名审批票,全批准后才放行修复轮。

应用修复两阶段预览抽屉实测截图
03

应用修复两阶段预览

确认前强制核对远端当前 head 与补丁摘要一致,并在隔离副本实测 git apply --check 通过,由机器人身份提交修复 commit。

统一合并资格门全绿放行实测截图
04

统一合并资格门(双面 CI 核验)

新 commit 推送后旧 head 证据自动失效阻断;仅当前 head 审查完成 + 真实 CI 通过 + mergeable 已知时才开放合并确认。

说明:总览图为 rc.16 测试环境历史数据(账号与组织已打码);01–04 四宫格为隔离验收实仓 PR #12 端到端实测截图,不代表已产生外部用户真实业务流量。

PIPELINE & AGENTS

事件驱动审查管线与四角色协作

四个角色不代表四个 LLM,也不代表每个 PR 都执行全部环节;内部 Leader 决定管线状态,维护者决定是否应用与合并。

GitHub / Gitee PR 事件触发 Webhook 入口 HMAC + 预检 + 去重 状态机 + /sync PG CAS · Matrix 流式 Multi-Agent 规则 · LLM · RAG 维护者确认 评论 / 修复 / 合并 双面 CI 状态 Statuses + Check Runs 普通变更自动完成审查 · P0/P1 高危修复停下等具名审批票 · 远端写入全部需「预览 → 确认」 系统不自动改代码、不自动合并、不设 required check、不绕过平台分支保护
Reviewer审查

确定性静态规则 + 可选外部 LLM 第二阶段,产出结构化发现与建议。

Fixer建议修复

在隔离环境生成修复补丁与验证证据;此阶段零远端写入。

Verifier独立验证

独立核验补丁与测试证据,结构强制不读取 Fixer 自述推理。

Leader编排裁决

编排状态流转并由确定性策略保留管线终裁权;远端写归维护者。

ARCHITECTURE HIGHLIGHTS

六大核心工程设计

面向企业与研发团队引入 AI 参与代码变更时的四个真实难题:状态一致性、防越权控制面、零信任出站治理与不可抵赖审计。

安全加固清单 →
防 TOCTOU · 幂等对账

两阶段远端写与未知态对账

评论、机器人提交修复、确认合并均经 preview → confirm 两步确认,强绑定 expected_remote_head 与补丁摘要;写前持久化候选状态并 DB 原子认领防并发覆盖,超时进入 result_uncertain 经读回对账定案。

fix-apply.mjs · remote-write.mjs
零信任出站 · 防注入

LLM 出站治理与凭据掩码

租户级出站授权门控(未授权零网络请求);统一经 Context Builder 实施正则族 + Shannon 熵(>3.5)双通道凭据掩码并 fail-closed;固定指令与不可信数据信封物理隔离,审计仅落哈希清单、零源码副本留存。

context-builder.mjs · egress-audit.mjs
rc8.5 新增 · 流式结算

Matrix /sync 流式结算与入口预检

GitHub / Gitee Webhook 入队前执行契约预检与 delivery 幂等去重;PostgreSQL CAS 推进与死信队列兜底;Worker→Console 经 Matrix /sync 游标持久化事件流秒级推送结算,支持断线续传与多房间隔离。

matrix-sync-listener.mjs · review-service.mjs
RBAC · 租户隔离

非递增五角色与权限物理分离

Schema v29 核心业务表按 tenant_id 复合外键收窄,撤权后同会话下一请求即 403;平台管理与业务裁定分离——platform_admin 无源码读取及审批/应用/合并权,邀请三层拦截防提权。

authz.mjs · schema.mjs · 角色矩阵
GitHub + Gitee · Fail-Closed

多平台契约与双面 CI 资格门

抽象规范事件 v1 与上下文完整性三态冻结;合并资格门同时分页核验 GitHub Commit Statuses 与 Check Runs 双面状态——任一读取失败或无 CI 运行均 fail-closed 阻断,绝不降级放行。

forge/index.mjs · patch-applicability.mjs
OCI Digest · SBOM

可验证供应链与原子换版

官方 Console、pgvector 与 bge-m3 sidecar 全量钉死不可变 OCI Digest;随附 CycloneDX SBOM(48 组件)、SHA256SUMS 与 Trivy 零漏洞/零密钥扫描记录,支持离线 tar 部署与一级回滚。

GET STARTED

双路径快速开始

标准命令行部署或直接交给 AI 编码助手逐步执行;若你已被管理员邀请加入现有实例,直接阅读首次使用。

路径 A · 标准 Docker Compose 部署

使用官方钉死不可变 digest 的 deploy/selfhost 模板;首次启动自动建库并经 MU_BOOTSTRAP_ADMIN_SUBJECT 初始化首任管理员。

git clone https://github.com/nghqqa/MergePilot.git
cd MergePilot && git checkout v0.2.0-beta.6-rc.35.6-rc8.5
cd deploy/selfhost
cp .env.example .env && chmod 600 .env
node preflight.mjs                # 一键只读预检
docker compose --env-file .env up -d
curl -s http://127.0.0.1:48500/api/health

路径 B · AI 编码助手安装卡

觉得环境变量、OAuth 与反代步骤繁琐?把仓库内置的 INSTALL-WITH-AI.md 指令卡整段发给你的 AI 编码助手(Claude Code / Codex / Cursor 等):

  • 每一步都附带可校验的成功判据,跳过健康门即停止;
  • 明确硬性安全边界(不直曝 48500、不提交 .env);
  • 卡点时把报错与日志贴回即可定位排障。

项目维护状态与自托管边界

MergePilot 自 2026-10-26 起处于事件响应维护(2026-11-11 解冻轮发布 rc.35.6-rc8.5 后已恢复冻结):main 仅接受安全补丁与文档事实同步,现有 CI 门不变。本站为纯静态文档,不提供托管 Console 或登录入口;请先了解已知限制与支持矩阵再投入团队使用。