Git Analytics — 用户手册 | YoBench

「Git Analytics」模块的用途

模块为您的 GitLab 项目收集和呈现分析数据 — 流水线、合并请求、提交以及团队指标 — 无需打开 GitLab 网页界面。所有数据按计划同步到本地数据库,因此您可以离线工作,并在一个屏幕中获得多个项目/团队的统一视图。

仅支持 GitLab(云版 gitlab.com 与自托管)。代码中将 GitHub 预留为提供商类型,但适配器尚未实现。

您将获得:

• 统一的 CI/CD 视图 — 所选项目的全部流水线汇总在一张表中,可按状态过滤、按分支搜索。
• 代码评审指标 — Lead Time、Cycle Time、MR 平均生存时长;流水线成功率。
• 按开发者统计 — 每位贡献者的提交、增删行数、MR 数量与评论数,以及衍生指标(velocity、impact、collaboration、delivery rate、cycle efficiency、work-life balance)。
• 新 MR 的 AI 评审 — 可配置的 AI 评审者,各自带提示词与 AI 提供商,可自动或按需运行,结果保存在 MR 旁。
• 本地缓存 — 数据保存在 YoBench 加密数据库中,可离线筛选与分析。

项目连接参数

新增项目时需要指定:

• 提供商类型 —— gitlab(目前唯一可用)。
• 显示名称 —— 项目在筛选器和表格中的呈现。
• Base URL —— API 地址:https://gitlab.com(云版)或您的自托管 URL。
• 项目路径 —— 例如 group/subgroup/project。
• Private Token —— GitLab API 的访问令牌,需要对仓库、MR 和流水线的读取权限。
• Git URL —— 克隆地址(HTTPS 或 SSH);用于本地部分处理(例如读取 diff)。
• SSH Key (可选) —— 当 Git URL 使用 SSH 时需要。
• 已启用 —— 项目是否参与同步。
• 新 MR 自动评审 —— 启用后,新出现的 MR 将自动触发已分配的 AI 评审者。

模块全局设置

在 设置 → Git Analytics 中配置:

• 启用 Git 分析(gitAnalyticsEnabled)—— 调度器主开关。默认关闭 —— 未开启时项目不自动同步。
• 同步间隔(分钟)(gitAnalyticsPollMinutes)—— 调度器轮询 API 的频率。默认 60 分钟。

其余项 —— 令牌、AI 评审者、自动评审 —— 在项目或评审者层面配置。

AI 评审者

AI 评审建立在「评审者」实体之上。每个评审者具有:

• 名称 —— 显示在 MR 旁的 评审 下拉菜单中。
• AI 提供商 —— 使用 AI 聊天 注册表中的哪个提供商。
• 提示词 —— 分析 diff 的指令(评审风格、关注点、输出格式)。

评审者在设置中绑定到项目。开启 自动评审 后,新 MR 第一次同步时:

1. 模块从 GitLab API 拉取 diff。
2. MR 元数据 + diff 依次发送给指派的评审者。
3. 每条评审结果保存到数据库,可在 MR 旁的 评审 面板查看。

也可以为任意 MR 手动触发评审 —— 点击 评审 按钮会打开包含评审者选择和结果的面板。

UI 功能

主屏幕分为四个 分析 子标签页。

Pipelines(流水线)

所选项目在所选周期内的流水线表。

列:ID、分支、状态(success / failed / running / canceled)、来源(push / merge / api)、创建时间、耗时。

顶部摘要:流水线总数、成功、失败、成功率、平均耗时。

筛选:按状态、按分支搜索。点击行打开包含 jobs 与 trace 的面板。

Merge Requests(合并请求)

带生命周期指标的 MR 表。

列:#、标题、作者、分支、状态、创建时间、合并时间、Lead Time、Cycle Time、评论数。

摘要:已创建 MR、已合并、平均生存时长、合并率。

筛选:按状态(opened / merged / closed)、按标题或分支搜索。评审 按钮运行或显示某个 MR 的 AI 评审。

Project Stats(项目统计)

所选项目在周期内的指标:提交、增删行数、MR 数量、流水线、分支、贡献者。按天的活动图。

People Stats(人员统计)

按贡献者的表:提交、增、删、创建的 MR、合并的 MR、评论数。任意列可排序。扩展指标:velocity、impact、collaboration、delivery rate、cycle efficiency、work-life balance。

周期与项目筛选

页面顶部工具栏:

• 周期 —— 周 / 月 / 季度 / 年 / 全部。默认:月。
• 项目选择器 —— 一个或多个;为空表示「所有已启用项目」。

使用流程

1. 添加项目

1. 在左侧菜单打开 Git Analytics 模块。
2. 切换到 设置 标签页。
3. 点击 添加项目。
4. 填写 Base URL、路径、Token、显示名称、Git URL。
5. 可选启用 新 MR 自动评审。
6. 保存。

2. 启用自动同步

在 设置 → Git Analytics 打开主开关并设置间隔(分钟)。否则只有点击 同步 才会刷新。

3. 同步数据

页面顶部有 同步 按钮,会查询所有已启用项目:拉取流水线、MR、提交与分支。进度可在 日志 中查看。

4. 查看分析

在 流水线 / 合并请求 / 项目统计 / 人员统计 子标签页之间切换。应用周期与项目筛选。

5. 配置 AI 评审

1. 创建 AI 评审者:名称、AI 提供商、提示词。
2. 将评审者绑定到项目。
3. 启用 新 MR 自动评审 —— 后续 MR 将自动分析。
4. 已有 MR 通过列表中的 评审 按钮触发。

下一步

• 配置 AI 提供商 —— 没有它们 AI 评审无法工作。
• 使用 任务跟踪 与代码分析并行管理任务。
• 大型团队可叠加 可用性监控 单独监控 GitLab 实例的 uptime。

帮助与反馈

发现 Bug 或希望增加 GitHub/Bitbucket 适配器?通过反馈表单联系我们。