跳到正文
Code Review
文档中心 / 从项目到检查报告

文档中心 · 使用指南

从项目到检查报告

登记项目和代码版本,选择扫描或评审,预览后开始检查并查看报告。

使用指南更新于 2026-11-18正文约 3 分钟

先看结论

  1. 01

    在项目内管理版本

    首次新建项目,后续更新代码进入原项目,保留历史版本与结果。

  2. 02

    先选择检查范围

    完整代码使用 scan,代码改动使用 review,预览范围后再执行。

  3. 03

    失败记录保留

    续跑在同一检查下新增执行;修复代码后新建检查,报告导出失败可单独重试。

第一步:登记项目与版本

打开工作台,点击「添加项目」,选择「连接 GitLab」或「上传 ZIP」。GitLab 已连接时,搜索仓库并选择分支;尚未连接时,由管理员通过「配置连接」填写团队 GitLab 地址和令牌。模型与执行器的准备见安装与 AI 配置。

选好代码后点击「继续,设置检查」。后续代码更新从已有项目点击「更新代码」,登记新版本;GitLab 版本固定到所选分支的具体提交。项目页默认显示检查记录,展开「版本与操作记录」可查看全部版本与结果、失败记录和结果对比。

ZIP 版本没有原始 Git 历史,仅支持完整代码扫描;提交或分支评审使用具有对应历史的 GitLab 版本。未提交改动的工作区评审由独立 CLI 执行,见CLI 手册。

流程图一次网页检查
  1. 01选择项目与版本连接 GitLab 或上传 ZIP
  2. 02设置检查选择 scan 或 review 及范围
  3. 03预览并开始核对待查文件和覆盖缺口
  4. 04查看结果阅读执行记录并保存报告

第二步:新建检查并预览

代码导入后进入检查设置,也可从项目页点击「开始检查」。选择代码版本及要检查的内容:

目的选择
检查整个项目或指定文件、目录scan:项目扫描或局部扫描
检查一次提交review:提交评审
检查分支、PR / MR 的提交区间review:分支评审

点击「下一步:确认范围」,核对实际版本、基线、待查文件、排除原因和无规则文件。预览不调用模型;无待查文件不表示检查通过。

网站使用规则库中有来源依据的生效条款,缺少规则时保留覆盖缺口。代码、规则或配置变化后重新预览,不能沿用过期的输入。

默认并发 8、每任务时限 30 分钟、Token 预算 0(不限)。模型请求、无输出等待和阶段时限分别生效,详见扫描进度与用量和使用手册中的扫描设置。确认范围后点击「开始检查」。

第三步:查看执行和报告

「全部版本与结果」按代码版本归集检查。打开检查记录可查看进度与报告,执行历史、参数和日志在详情中展开。关闭浏览器不会取消后台执行。

官方检查完成后,网站导入保存的结果并生成 HTML。报告保留官方描述、原始分级、引用代码和规则;报告导出不调用模型。

先确认覆盖,再看问题。计划内 80/80 完成只说明计划内文件已处理,排除或缺少规则的文件仍未覆盖。 中断时缺失的用量和覆盖记录不能当作零。

可在报告中搜索、筛选并下载独立 HTML;具体操作见报告阅读与导出。

第四步:恢复失败或验证修复

情况下一步
没有待查文件检查版本、改动范围、排除原因和已有规则
执行失败、中断或部分完成查看原执行,输入兼容且会话可用时选择「继续未完成」
代码已经修复或检查范围改变更新版本并新建检查,重新分析目标范围
检查结果已保存,报告生成失败重新生成报告,无需重扫代码

续跑保留原输入,在同一检查下新增执行记录;原失败记录继续保留。修复后重新检查会创建新的检查,对比结果只覆盖实际完成且可比的文件,不能仅凭问题未匹配到就判定修复完成。

网页操作和适用条件见使用手册中的失败恢复。

继续阅读

管理员看安装与 AI 配置,终端用户看CLI 手册,规则使用见规则开关,完整网页操作见使用手册。