需通过ci/cd钩子、api集成或插件方式打通gitlab与codebuddy：一、gitlab ci调用codebuddy cli实现mr自动分析；二、webhook对接review service回写评论；三、自定义审批规则集成api强制codebuddy批准；四、mr widget嵌入实时分析面板。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您在GitLab中已建立代码审查流程，但希望将CodeBuddy的智能分析能力嵌入其中以增强评审深度与自动化水平，则需通过CI/CD钩子、API集成或插件方式打通二者。以下是实现该集成的多种可行路径：
一、通过GitLab CI/CD Pipeline调用CodeBuddy CLI
该方法利用GitLab Runner执行CodeBuddy命令行工具，在MR触发时自动运行静态分析、测试覆盖率检查及AI辅助评审，结果直接输出至流水线日志并可配置为失败阈值拦截合并。
1、在项目根目录创建.gitlab-ci.yml文件，添加codebuddy分析作业。
2、在作业中安装CodeBuddy CLI依赖，例如执行curl -sSL https://get.codebuddy.dev | sh。
3、配置环境变量CODEBUDDY_API_KEY，确保其具备项目级访问权限。
4、添加分析步骤：codebuddy analyze --target src/ --format=gitlab，启用GitLab兼容输出格式。
5、设置allow_failure: false并配置rules仅对merge_requests事件触发，例如：if: $CI_PIPELINE_SOURCE == "merge_request_event"。
二、使用GitLab Webhook对接CodeBuddy Review Service
该方法通过GitLab推送MR创建/更新事件至CodeBuddy托管服务端，由后者拉取变更差异、执行多维度扫描，并将结构化评审意见以Comment形式回写至MR对话区，实现无侵入式协同。
1、进入GitLab项目设置中的Webhooks页面，添加新Webhook地址为https://api.codebuddy.dev/v1/webhook/gitlab。
2、勾选Merge request events事件类型，并启用Enable SSL verification。
3、在Webhook Secret Token字段填入预先在CodeBuddy控制台生成的webhook_secret。
4、在CodeBuddy平台对应项目中绑定GitLab OAuth应用，授权读取MR元数据与源码差异权限。
5、于CodeBuddy项目设置中启用Auto-post comments on new MR开关，并选择要激活的检测模块（如安全漏洞、重复代码、测试缺口）。
三、部署GitLab自定义审批规则集成CodeBuddy API
该方法将CodeBuddy的评审结论作为GitLab合并前的强制审批条件之一，要求MR必须获得CodeBuddy服务签发的“approval token”方可进入最终合并阶段，强化流程合规性。
1、在GitLab项目Settings > General > Merge requests中启用Require approval from specific users or groups。
2、创建专用审批组codebuddy-approver，并将CodeBuddy服务账户添加为成员。
3、在CodeBuddy平台配置GitLab Approval Gateway，输入GitLab API Base URL与Personal Access Token（需api scope）。
4、设置审批策略：当codebuddy analyze返回Critical问题数为0且High问题数≤2时，自动向对应MR发起Approve请求。
5、验证GitLab MR界面是否显示Approved by CodeBuddy徽章，且合并按钮仅在所有审批项满足后激活。
四、在GitLab Merge Request Widget中嵌入CodeBuddy实时分析面板
该方法通过GitLab CE/EE支持的Customizable MR Widgets机制，在MR详情页右侧边栏动态加载CodeBuddy分析摘要卡片，包括风险热力图、关键问题列表与一键跳转修复链接，提升评审信息触达效率。
1、确认GitLab实例版本≥16.0且启用了custom_project_widget功能标志。
2、在GitLab项目Settings > Integrations > Custom widgets中新增Widget。
3、填写名称CodeBuddy Insights，URL设置为https://widgets.codebuddy.dev/gitlab/mr?project_id=${CI_PROJECT_ID}&mr_iid=${CI_MERGE_REQUEST_IID}。
4、勾选Display in merge request widget area，并设置最小宽度为400px。
5、在CodeBuddy侧配置OAuth 2.0回调地址为GitLab项目Webhook endpoint，确保JWT签名验证通过。
