已知限制与支持矩阵
本页列出 MergePilot 0.2.0-beta.6 自托管 prerelease 的已知限制、支持范围与安全边界。 Beta 通道接口与配置项可能随版本调整;生产使用建议钉住 digest 并在升级窗口验证。
已知限制
| 限制 | 现状 | 状态 | 规避 / 计划 |
|---|---|---|---|
| 无租户切换端点/UI | 多租户成员需以对应租户的邀请分别登录 | 当前限制 | 租户切换端点已立项(独立需求) |
| 私有 GitHub App 仅所有者账号可安装 | 多租户 webhook 接入需公开化 App 或每租户独立 App | 当前限制 | 安装页引导文案已具备;公开化属 App 所有者操作 |
| webhook-ingress 仅放行 webhook 与 health 路径 | 管理面仅绑定本机回环地址或由用户自建 HTTPS 反向代理暴露 | 安全设计 | 属安全设计而非缺陷 |
| schema 只前进不降级 | 回滚镜像不回滚 schema | 安全设计 | 升级前 pg_dump;破坏性变更前会有公告 |
| RAG 为可选组件 | 未接入时相关面如实显示 NOT_WIRED | 当前限制 | 按 .env 模板接入 bge-m3 即可 |
| Gitee 连接器不支持读取 CI 状态 | 实测当前连接器访问 status 端点返回 404 → Gitee 仓库的合并被资格门恒阻塞(连接器能力结论,不判断 Gitee 平台整体) | 当前限制 | Gitee 仓库可用审查/评论/应用修复;合并需等连接器补 CI 读取 |
| 机器人远端写入不可由容器回滚撤销 | 机器人已推送的修复提交与已发生的合并不随镜像回滚消失 | 如实边界 | 远端回退只能在 GitHub/Gitee 手动 revert |
| 已发布镜像不含后续源码修正 | 官方 rc.35.6-rc8.5 制品对应 3879e390;其发布之后合入 main 的源码修正不含在该镜像 | 版本范围 | 按发布范围选择制品;不要把候选验证视作已正式发布 |
支持矩阵
| 项 | 支持范围 |
|---|---|
| 平台 | linux/amd64(镜像);Windows/macOS 经 Docker Desktop 运行 |
| Docker | Docker Engine ≥ 24 / Docker Desktop(含 Compose v2) |
| 数据库 | PostgreSQL 16 + pgvector(镜像钉死) |
| LLM 端点 | openai_compatible 协议(自选供应商) |
| 浏览器 | 现代 Chrome/Edge/Firefox(管理面) |
| 架构 | 仅 amd64(arm64 待支持) |
验证范围
截至 2026-11-12,rc.35.6-rc8.5 已发布;维护者生产实例于 2026-11-11 完成 rc.35.6-rc8.5
受控换版与 T+1h 连续观察通过(22/22 样本全绿、零重启、零错误日志;含 rc8.4.1 的 CVE-2026-111497 brotli 双面闭合与本轮
Matrix /sync 事件投递 + Webhook 入口预检两项改进),并于 2026-11-12 按冻结协议执行计划内停机保数。
角色登录验收覆盖四角色——platform_admin(GitHub)/ maintainer(Gitee)/ contributor(GitHub,含越权拒绝实证)/
auditor(Gitee,邀请认领+只读边界实证,验收后账号按授权撤销);首位未参与开发的真实用户独立首装与非空业务流量仍待验。
演示夹具登录不等于 OAuth 接入验收,预置发现与补丁证据不等于真实模型产出或测试执行结果。
知识库引用(RAG)能力边界:run 页按需检索知识库(RAG V1)与执行期自动参考采集及快照持久化(RAG V2,rc.35.6-rc4 起)均已实现;
检索结果仅作为参考,不自动成为审查结论。生产语义检索已通过隔离+机器通道端到端验证,使用前需按部署指南为 bge-m3 备齐模型文件(未配置时如实显示 NOT_WIRED)。
真实手机、200% 真缩放与读屏器尚未验证;候选环境中远端读取失败时,完整合并资格展示仍受限。 失败提示与禁用行为已检查,不能据此认定该环境具备真实提交或合并资格。 使用者可先按首次使用的只读路径核对理解与导航。
安全边界
- 写入全部受控:机器人提交修复与合并 PR 都需维护者逐次「预览 → 确认」;不存在自动批准、自动合并或 required check 设置。
- CI 状态为只读读取,作为合并资格输入;CI 未配置、未通过、读取不完整时合并一律不放行。
- LLM 供应商由使用者自选自配,key 只存使用者自己的环境。
- 所有审查结论与证据落在使用者自己的数据库与证据卷中。
platform_admin不可经邀请授予——API 403、claim 拒绝、DB 约束三层拦截;平台管理员同样无审批/应用/合并权(平台管理与审查裁定分离)。