WorkBuddy如何自动生成Git日报？

WorkBuddy 提供了灵活、可靠且多场景适配的 Git 提交对接方案，支持通过 Webhook 实时推送、定时拉取 git log、导入本地导出文件以及集成 CI/CD 构建上下文四种方式，自动将代码提交记录精准转化为结构化日报——无论你使用 GitHub/GitLab、身处离线环境，还是追求构建验证的可信闭环，都能找到即开即用的自动化路径，让每日工作成果“写完即报”，真正实现研发行为与工作汇报的无缝联动。

如果您希望 WorkBuddy 自动基于 Git 提交记录生成日报，则需将其与代码仓库的提交历史建立可靠的数据对接路径。以下是实现该功能的多种可行方式：

一、通过 Webhook 实时推送提交事件

该方法利用 Git 服务商（如 GitHub、GitLab）提供的 Webhook 功能，在每次 push 后主动将提交元数据（作者、时间、消息、变更文件等）以 HTTP 请求形式发送至 WorkBuddy 指定接收端点，触发日报内容生成。

1、登录代码托管平台（例如 GitHub），进入目标仓库的 Settings → Webhooks → Add webhook。

2、在 Payload URL 字段中填入 WorkBuddy 提供的 Webhook 接收地址，例如 https://workbuddy.example.com/api/v1/git-webhook。

3、将 Content type 设置为 application/json，并勾选“Just the push event”或根据需要选择“Send me everything”。

4、点击 Add webhook 完成配置，后续每次 push 将自动触发 WorkBuddy 解析提交信息并生成当日日报草稿。

二、定时拉取 Git 日志并解析

该方法不依赖外部服务回调，而是由 WorkBuddy 主动连接仓库（支持 HTTPS 或 SSH 协议），定期执行 git log 命令获取指定时间范围内的提交记录，并结构化提取关键字段用于日报组装。

1、在 WorkBuddy 系统设置中启用“Git 日志同步”模块，并填写仓库远程地址，例如 https://gitlab.com/team/project.git。

2、配置访问凭证：若为私有仓库，需提供 Personal Access Token 或部署密钥，并确保其具备 read_repository 权限。

3、设定同步周期为每日凌晨 2:00，时间范围限定为 --since="yesterday 00:00" --until="today 00:00"，确保仅处理前一日提交。

4、保存配置后，WorkBuddy 将在指定时间调用 git 命令，解析每条 commit 的 author、date、subject 及 diff 统计，映射为日报中的“完成事项”与“修改文件数”条目。

三、导入本地 Git 日志导出文件

该方法适用于离线环境或权限受限场景，用户可手动导出 Git 提交历史为结构化文本（如 JSON 或 CSV），再上传至 WorkBuddy 进行解析和日报渲染。

1、在项目根目录执行命令：git log --pretty=format:'{"hash":"%H","author":"%an","date":"%ad","message":"%s"}' --date=iso --since=yesterday > commits.json。

2、打开 WorkBuddy 日报管理页，点击“从文件导入”按钮，选择刚生成的 commits.json 文件。

3、系统校验 JSON 格式合法性后，自动映射字段：author 映射为“责任人”，message 映射为“工作内容”，date 用于归入对应日期日报。

4、确认导入无误后，点击“生成日报”，WorkBuddy 将按提交时间倒序排列条目，并合并同一作者的多条记录为简洁摘要。

四、集成 CI/CD 构建日志作为补充源

该方法将构建流水线中的 Git 上下文（如 Git SHA、Branch、CI 触发时间）作为辅助依据，与提交记录交叉验证，提升日报中“完成状态”判断的准确性。

1、在 CI 配置文件（如 .gitlab-ci.yml 或 .github/workflows/daily.yml）中添加 post-job 步骤，调用 WorkBuddy API。

2、使用 curl 发送请求，携带环境变量：GIT_COMMIT, GIT_BRANCH, CI_PIPELINE_CREATED_AT，示例 URL：POST /api/v1/report/ci-context。

3、WorkBuddy 接收后检索该 commit 是否已存在于当日提交列表；若存在，则标记对应条目为“已构建验证”；若不存在，则记录为“待同步提交”并发出提醒。

4、日报最终呈现时，“已构建验证”条目右侧显示绿色对勾图标，增强可信度标识。

到这里，我们也就讲完了《WorkBuddy如何自动生成Git日报？》的内容了。个人认为，基础知识的学习和巩固，是为了更好的将其运用到项目中，欢迎关注golang学习网公众号，带你了解更多关于的知识点！