workbuddy 可通过四种方式对接 git 提交记录生成日报：一、webhook 实时推送；二、定时拉取 git log 解析；三、导入本地导出的 json/csv 日志文件；四、集成 ci/cd 构建上下文交叉验证。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望 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 统计，映射为日报中的“完成事项”与“修改文件数”条目。
使用 draw.io（.drawio 格式）和 SVG 生成兼容 Microsoft Visio 的架构图。当用户需要以下任一场景时触发： - 用于 Visio 或技术文档的架构/系统/网络图 - 带连接标注的分层控制系统图 - 将 draw.io XML 转换为稳定、可嵌入的 SVG - 修复 Visio 或 draw.io 无法打开的故障排查类图表 - 任何需专业级布局且文本可编辑的图表
三、导入本地 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、日报最终呈现时，“已构建验证”条目右侧显示绿色对勾图标，增强可信度标识。
