🚀 GitSense。AI：自主提交分析器和Webhook代理
GitSense。AI是一个自托管、离线、零成本的AI替代代理，它监听GitHub推送，使用高速NLP基于规则的引擎对代码更改进行分类，并主动确保开发团队永远不会丢失文档上下文。
如果后端或前端团队推动 主要特征 而无需随后更新存储库的 README.mdGitSense。AI会立即向团队的Discord服务器或电子邮件收件箱发出格式丰富的警报，总结确切的提交并ping团队以记录他们的更改。
______________________________________________________________________
✨ 核心功能
- ⚡ 零延迟分析：完全离线运行，无需昂贵的API调用（无需Claude、OpenAI或SaaS订阅）。
- 🧠 语义分类引擎：解析提交消息并立即将其放入6个主要DevOps模板的原生管道：
- 🚀 功能增强 - 🐛 错误修复 - 🔒 安全补丁 - ♻️ 重构和优化 - 📦 依赖关系更新 - 📝 文件调整
- 🚨 智能文档警报：将分类为“功能”的推送与Git差异进行交叉引用，以查看
README.md被修改了。如果错过，它会发出警报。 - 🔔 无摩擦集成：对Discord Webhooks（不需要机器人令牌）和Nodemailer（SMTP/Gmail）的开箱即用支持。
- 🌍 隧道准备就绪：旨在通过Cloudflare安全地暴露(
cloudflared)或本地隧道。
______________________________________________________________________
🛠️ 工作原理（生命周期）
- 触发器：开发人员运行
git push在您的存储库中。 - 拦截：GitHub通过互联网向Cloudflare隧道发送JSON Webhook有效负载。
- 验证：GitSense。AI拦截有效载荷，使用您的密钥验证SHA-256 HMAC签名。
- 发动机：丢弃分支/已删除的提交，并将原始提交消息管道到
analyzerService.js. - 裁决：代理决定类别。如果
Features > 0以及readmeModified旗是false，它会构建一个警报包。 - 调度:
notificationService.js将格式精美的markdown数据包路由到您配置的Discord频道和/或电子邮件。
______________________________________________________________________
💻 技术栈
- 运行时间： Node.js、Express.js、Python
- 网络与安全： 加密（用于Webhook签名验证的HMAC SHA-256）
- Git操作： GitHub Webhooks API，
@octokit/rest - 通知层： Discord REST Webhooks，
nodemailer（SMTP） - 隧道工程（开发）： Cloudflare(
cloudflared) - 模型上下文协议
______________________________________________________________________
🚀 快速入门指南
1.安装
克隆存储库并安装所需的软件包：
git clone https://github.com/YOUR_USERNAME/mcp-github-agent.git
cd mcp-github-agent
npm install2.配置
创建环境文件：
cp .env.example .env填充 .env 使用您的安全凭据：
GITHUB_WEBHOOK_SECRET：与您的GitHub配置匹配的安全短语。DISCORD_WEBHOOK_URL：（可选）您的Discord频道webhook。EMAIL_USER/EMAIL_PASS：（可选）Nodemailer/Gmail应用程序密码。
3.在本地运行代理
启动主Express服务器：
npm start4.创建Webhook隧道
在新的终端窗口中，安全地暴露您的localhost：
cloudflared tunnel --url http://localhost:3000复制生成的 https://*.trycloudflare.com URL。
5.连接到GitHub
- 导航到您的GitHub存储库-> 设置 -> 网络钩子 -> 添加Webhook.
- 有效载荷URL:
/api/webhook - 内容类型:
application/json - 秘密：您的
GITHUB_WEBHOOK_SECRET. - 事件：只是
push活动。
______________________________________________________________________
📋 Discord警报示例
🚨 Documentation Alert: New Features in DevWidSiddxx/frontend-app
A team member pushed to main without updating the README.
Here's what was merged (Auto-Categorized):
📊 **Commit Analysis Report** 📊
🚀 **Feature Enhancement**:
- feat: implement new secure login gateway
- add: stripe payment processing