
open-code-review Bitbucket Pipelines与GitFlic CI集成完整教程5步实现自动代码评审【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-reviewopen-code-reviewOCR是源自阿里巴巴的开源 AI 代码评审工具采用「确定性流水线 LLM Agent」混合架构能对 Git 差异做行级精准评论并内置 NPE、线程安全、XSS、SQL 注入等多语言审查规则。本教程带你把 OCR 接入 Bitbucket Pipelines 与 GitFlic CI 两条流水线PR/MR 一旦创建或更新自动运行代码评审并把结果以行内评论 汇总的形式回填到代码评审页面全程无需人工介入。集成原理一条自动代码评审流水线两个示例的核心流程完全一致差异只在「发布胶水层」PR/MR 创建或更新 → CI 触发 ocr review → JSON 结果 → 平台脚本回填评论触发Bitbucket 用pullrequest-push触发器GitFlic 用 Merge Request Pipeline。评审在node:20镜像中通过 npm 安装 OCR对比目标分支与源提交--from origin/目标分支 --to 提交输出结构化 JSON。回填平台专属脚本Bitbucket 用内置 Node.jsGitFlic 用零依赖 post_review.py把每条发现发回 PR/MR——能锚定行号就发行内评论锚定失败自动降级为普通评论最后统一追加一条OpenCodeReview summary汇总。关键文件一览平台流水线文件回填脚本说明文档Bitbucketbitbucket-pipelines.yml内联 Node.jsbitbucket_pipelines/README.mdGitFlicgitflic-ci.yamlpost_review.pygitflic_ci/README.mdBitbucket Pipelines 集成3 步配置第 1 步放置流水线文件将 bitbucket-pipelines.yml 复制到被评审仓库根目录。若仓库已有流水线文件合并其中的definitions、pipelines.custom与triggers.pullrequest-push三段即可。注意clone: depth: full配置必须保留它保证长生命周期分支也能找到 merge base。第 2 步配置仓库变量在Repository settings → Pipelines → Repository variables中添加变量必填加密说明OCR_LLM_URL✅否LLM API 端点OpenAI 兼容格式OCR_LLM_AUTH_TOKEN✅是LLM 鉴权令牌OCR_LLM_MODEL✅否模型名未设置时 OCR 直接报错BITBUCKET_ACCESS_TOKEN推荐是仓库访问令牌Bearer 认证推荐OCR_LLM_USE_ANTHROPIC否否使用 Anthropic 接口格式时设为true⚠️ 安全提示令牌类变量务必勾选 Secured且绝不写进 yml 文件。仓库变量对任何有写权限的人可用请收紧仓库写权限。第 3 步创建访问令牌并启用流水线推荐Repository settings → Security → Access tokens创建令牌并授予Pull requests: Write填入BITBUCKET_ACCESS_TOKEN。备选Atlassian 账户的带范围 API TokenBITBUCKET_API_TOKENBITBUCKET_API_TOKEN_EMAIL。注意Bitbucket 已于 2025 年 9 月停用新建 App Password请优先使用仓库访问令牌。确认Repository settings → Pipelines已启用并把 yml 提交到默认分支。pullrequest-push触发器会覆盖「PR 创建」和「源分支更新」两种事件。评论行为说明有有效路径与行号的发现 →行内评论Bitbucket 返回 HTTP 400 时自动降级为带文件与行号标题的普通评论。建议替换代码会以 Markdown 代码块附在评论中。每次运行即使零发现都会追加一条OpenCodeReview summary汇总。认证/限流/服务端错误会直接让步骤失败而不是静默丢评论。GitFlic CI 集成3 步配置第 1 步启用 Merge Request Pipeline进入Project Settings → CI/CD Settings开启Merge Request Pipeline此后新建 MR 自动触发。第 2 步复制流水线文件把 gitflic-ci.yaml 与 post_review.py两个文件都提交到仓库文件名需固定为gitflic-ci.yaml脚本若放别处需同步修改 yaml 中的调用路径。第 3 步配置 CI/CD 变量在Settings → CI/CD → Variables中添加变量必填说明OCR_LLM_URL✅LLM API 端点OCR_LLM_AUTH_TOKEN✅LLM 鉴权令牌OCR_LLM_MODEL✅模型名如gpt-4oGITFLIC_TOKEN✅用于发布讨论的 GitFlic 访问令牌GITFLIC_API_URL可选自建实例的 REST API 地址默认云端MR 上下文命名空间、项目、MR ID、目标分支、提交号全部来自 GitFlic 预定义变量post_review.py在 CI 中无需任何参数。 GitFlic 的特殊点行内评论必须同时提供newLine/oldLine/newPath/oldPath四项缺一项就静默变成普通评论。post_review.py会用与评审相同的 merge-base diff 自行反算旧侧行号保证行内定位准确。实测效果为什么选 OCR 跑 CI 评审在 50 个开源仓库、200 个真实 PR、10 种语言构成的 AACR-Bench 基准中OCR 相比通用 Agent 方案精度与 F1 显著更高Token 消耗仅为 1/9 左右——这对 CI 场景意味着更少的误报需要人工分拣和更低的 API 成本常见问题速查HTTP 401/403Bitbucket检查令牌是否完整配置API Token 必须同时提供邮箱且是 Atlassian 账户邮箱。评审无输出流水线会先打印 OCR 的 stderr按提示核对OCR_LLM_URL、OCR_LLM_MODEL与目标分支是否拉取成功。找不到 merge base保留clone: depth: fullBitbucket或git fetch --unshallowGitFlic。评论重复Bitbucket Cloud 对单个 PR 有 200 条评论上限高频更新的 PR 建议加幂等策略GitFlic 侧可在运行前检查已有讨论中的OpenCodeReview标记来跳过已评审 MR。Fork 来源的 PRBitbucket Cloud 不会为 fork PR 触发流水线这是平台限制而非配置问题。延伸阅读更多 CI 集成示例GitHub Actions、GitLab、Gerrit、Codeupexamples/评审规则说明internal/config/rules/system_rules.go 与各语言规则文档 rule_docs/官方文档安装、配置、CLI 参考pages/src/content/docs/zh/按以上步骤配置完成后你的 Bitbucket 与 GitFlic 仓库就能拥有 7×24 小时的 AI 代码评审员——提交即评审行级反馈直达 PR/MR 页面。【免费下载链接】open-code-reviewFast, efficient, battle-tested at Alibabas scale. Hybrid architecture code review tool: deterministic pipelines LLM Agent, precise line-level comments, built-in multi-language ruleset (NPE, thread-safety, XSS, SQL injection), OpenAI Anthropic compatible.项目地址: https://gitcode.com/GitHub_Trending/op/open-code-review创作声明:本文部分内容由AI辅助生成(AIGC),仅供参考