Hermes Agent 可通过四种方式自动检查 GitHub 代码库更新：一、定时轮询 GitHub API；二、监听 GitHub Webhook；三、本地 reflog 与远程分支差异检测；四、集成 GitHub Actions 状态反馈。
☞☞☞AI 智能聊天, 问答助手, AI 智能搜索, 多模态理解力帮你轻松跨越从0到1的创作门槛☜☜☜
如果您希望实时掌握 GitHub 代码库的变更动态，但手动刷新或频繁 git pull 效率低下，则可能是由于缺乏自动化更新感知机制。以下是实现 Hermes Agent 自动检查代码库更新的多种方法：
一、配置定时轮询 GitHub API 检查最新 commit
该方法通过定期调用 GitHub REST API 查询仓库默认分支的最新提交哈希，与本地记录比对，从而判断是否有新更新。适用于无 webhook 权限或私有部署环境。
1、在 Hermes Agent 工作目录中创建 scripts/check-updates.sh 脚本，内容包含 curl 请求 /repos/{owner}/{repo}/commits/main 并提取 sha 字段。
2、将本地最新 commit 哈希保存至 .hermes/cache/latest-remote-sha 文件中，首次运行时可设为空值。
3、使用 hermes schedule add --cron "*/30 * * * *" --command "bash scripts/check-updates.sh" 添加每30分钟执行一次的定时任务。
4、脚本内检测到 sha 变更后，自动触发 git fetch origin && git log -1 --oneline origin/main 并推送通知至 Telegram 或 CLI。
二、监听 GitHub Webhook 实时捕获 push 事件
该方法依赖 GitHub 仓库设置中的 Webhook 配置，由 GitHub 主动向 Hermes Agent 提供的 HTTP 端点推送 JSON 事件数据，响应延迟低且资源消耗小。
1、启动 Hermes Agent 的内置 Webhook 服务：运行 hermes webhook serve --port 8080，确保端口对外可访问或经反向代理暴露。
2、进入目标 GitHub 仓库 Settings → Webhooks → Add webhook，Payload URL 填写为 https://your-domain.com/webhook（需配置 HTTPS 或使用 ngrok 临时隧道）。
3、Content type 选择 application/json，Secret 填入与 HERMES_WEBHOOK_SECRET 环境变量一致的字符串。
4、在 skills/github/webhook-handlers/push.py 中编写逻辑，解析 push 事件的 after 字段并与本地 HEAD 比较，差异存在则执行 git pull origin main。
三、基于本地 git reflog 与远程分支差异检测
该方法不依赖外部服务或网络请求，完全在本地执行，通过对比 origin/main 和 main 的 reflog 记录判断是否落后，适合离线或高安全要求场景。
1、在 Hermes Agent 技能目录中新建 skills/github/local-update-check/SKILL.md，声明其为本地同步检查技能。
2、运行 git ls-remote origin main | cut -f1 获取远程最新 commit ID，并与 git rev-parse main 输出比对。
3、若两者不一致，调用 git status -uno --porcelain=v1 确认工作区干净，再执行 git merge --ff-only origin/main。
4、合并成功后，触发 hermes notify --title "代码库已更新" --body "$(git log -1 --format='%s (%an)')" 向用户发送摘要。
四、集成 GitHub Actions 工作流状态反馈检查
该方法聚焦于代码库更新后的构建与测试结果，不仅检测代码变更，还同步感知 CI/CD 流水线是否通过，确保更新内容具备可部署性。
1、在 Hermes Agent 配置中启用 github-ci-monitor 插件，通过 gh run list --limit 1 --json databaseId,status,conclusion 查询最近一次 workflow 运行状态。
2、将结果缓存至 .hermes/state/ci-last-run.json，并设置定时任务每5分钟刷新一次。
3、当检测到 status == "completed" 且 conclusion == "success"，同时本地分支尚未更新时，自动标记该 commit 为“可安全拉取”。
4、执行 hermes action trigger update-sync --commit $(jq -r '.[0].databaseId' .hermes/state/ci-last-run.json) 启动同步流程。
