Hazel Chat集成清单:如何一键接入GitHub、Linear、RSS等开发工具(完整指南)

原创2026-11-01 13:50:271,964 阅读

Hazel Chat集成清单:如何一键接入GitHub、Linear、RSS等开发工具(完整指南)

Hazel Chat 是一款实时协作聊天平台,它的集成(Integrations)中心支持一键接入 GitHub、Linear、RSS 等开发工具:PR 动态、工单变更、部署告警和资讯订阅,都会自动以富文本卡片的形式流进你的团队频道,让信息"找人"而不是人找信息。本文带你快速过一遍 Hazel Chat 的完整集成清单、三步 Webhook 配置方法和后续扩展路径。

30 秒认识 Hazel Chat 集成中心 🎯

打开 设置 → 集成(Settings > Integrations),你会看到一个按类别组织的集成卡片列表:每个卡片标注了连接状态(Connected / Not connected / Coming soon),点击即可开始授权连接。

Hazel Chat 集成中心界面,展示 GitHub、Linear、RSS 等开发工具的一键接入卡片

所有官方集成说明都维护在 apps/landing/src/content/integrations/ 目录下,每个工具一个文件,方便你按需查阅。

已上线集成清单一览

集成 类别 状态 核心能力
GitHub DevOps ✅ 已上线 PR 富预览、CI/部署实时通知、仓库关联
Linear 项目管理 ✅ 已上线 /issue 命令建单、工单自动链接与状态提醒
OpenStatus DevOps ✅ 已上线 服务宕机/恢复/延迟告警
Railway DevOps ✅ 已上线 部署成功/失败、构建与崩溃告警
RSS 订阅 ✅ 已上线 定时轮询 Feed,新文章推送到频道
Webhooks 开发者 ✅ 已上线 任意外部服务通过 HTTP 发消息到频道
Bot SDK 开发者 ✅ 已上线 用代码编写自己的机器人和自动化

💡 各集成的前端卡片与状态页面对应源码见 apps/landing/src/pages/integrations/index.astro,集成客户端代码统一放在 packages/integrations/src/(含 GitHub、Linear、RSS、OpenStatus、Railway 等模块)。

GitHub 集成:把 Pull Request 变成团队通知

接入后,Hazel Chat 能自动识别消息里的 GitHub PR 链接,直接渲染出状态、评审人、CI 检查等富文本预览;PR 被打开、合并,或 CI 检查通过/失败时,团队成员会第一时间收到通知,不用反复刷新页面。

典型的用法场景:

  • 代码评审流:PR 就绪后丢到团队频道,评审人在上下文里直接讨论,合并后自动同步;
  • 故障响应:CI 红了立刻推送到值班频道,附上失败的 PR 链接;
  • 连接流程由 OAuth 授权 + 后台工作流完成,安装事件处理见 apps/cluster/src/workflows/github-installation-handler.ts。

Linear 集成:聊天里一句话建单

  • 在输入框执行 /issue 命令 + 标题,即可从聊天直接创建 Linear 工单,上下文热乎的时候先记下票;
  • 消息中粘贴 Linear 工单链接时,自动展示状态、优先级、负责人的富预览;
  • 关联工单状态变更时会推送提醒,团队进度一目了然。

OpenStatus 与 Railway:DevOps 告警直达频道 🚀

Hazel Chat 频道自动推送的 Railway 部署通知,集成开发工具后团队消息实时同步

(上图为频道内自动推送的 Railway 部署卡片:Deploying / Deployed 状态、环境、分支与提交信息一屏可见)

  • OpenStatus:HTTP / TCP / DNS 监控的宕机、恢复、延迟超阈值告警,全部推送到值班频道,天然沉淀出事故时间线;
  • Railway:部署开始/成功/失败、构建进度、服务崩溃等事件即时提醒,每个项目可以绑定不同频道;
  • 两者都走 Webhook 接收,不同监控源可路由到不同频道,团队互不干扰。

RSS 集成:把资讯订阅变成频道更新

在频道内订阅 RSS Feed 后,Hazel Chat 会每 5 分钟轮询一次到期订阅,解析出新条目并以卡片形式发布到频道(轮询任务见 apps/cluster/src/cron/rss-poll-cron.ts,处理流程见 apps/cluster/src/workflows/rss-feed-poll-handler.ts)。还内置了熔断机制:连续出错 10 次会自动停止该订阅,避免坏掉的 Feed 刷屏。

Hazel Chat 团队协作聊天界面:成员在工程频道讨论 PR 审查与部署,展示与 GitHub 集成后的沟通场景

(上图为接入开发工具后的典型团队频道:PR 讨论、部署提醒与日常对话混排在一起)

Webhook 三步配置法:任意工具都能接入 ⚡

没有现成集成的服务?Webhook 是万能入口。官方文档在 apps/docs/content/docs/webhooks/getting-started.mdx:

  1. 进入目标频道 → 频道设置 → Webhooks 标签页;
  2. 点击 Create Webhook,填写名称(如 "GitHub Actions"),复制生成的 Webhook URL(Token 只显示一次,务必保存);
  3. 在外部服务里配置该 URL,POST 一段 JSON 即可。最小示例:
curl -X POST "YOUR_WEBHOOK_URL" \
  -H "Content-Type: application/json" \
  -d '{"content": "构建完成 ✅"}'

服务端支持最多 10 条富文本 Embed(标题、描述、字段、颜色、时间戳等),接收端实现见 apps/backend/src/routes/incoming-webhooks.http.ts。

🔒 安全建议:把 Token 存到环境变量而不是硬编码;Token 泄露后立即在设置里重新生成。

进阶:用 Bot SDK 写自己的集成 🤖

如果 Webhook 不够用,Hazel Chat 提供了 Bot SDK(libs/bot-sdk/),可以用 TypeScript 编写能收发消息、执行斜杠命令、做 AI 流式回复的机器人,内置重试、日志与流式输出支持,教程入口在 apps/docs/content/docs/bot-sdk/getting-started.mdx,示例见 libs/bot-sdk/examples/simple-echo-bot/。

即将上线:Figma、Notion 等 📅

当前卡片上标注 Coming soon 的集成包括 Figma(设计稿预览嵌入)、Notion(文档嵌入)、Stripe、Netlify、Vercel 等,规划说明同样在 apps/landing/src/content/integrations/ 中。

常见问题 FAQ

Q:如何把 GitHub 连接到 Hazel Chat? A:进入 设置 → 集成,选择 GitHub 并用你的 GitHub 账号授权,然后选择要关联的仓库即可,支持多仓库、通知分流到不同频道。

Q:一个频道能接多个工具吗? A:可以。每个频道可独立创建 Webhook 和集成,建议按"值班频道接告警、工程频道接 PR"的思路做路由。

Q:需要付费计划才能用集成吗? A:Railway 等工具的 Webhook 在其免费套餐即可使用,Hazel Chat 侧按频道能力开放,具体以设置页展示为准。

写在最后

Hazel Chat 的集成清单覆盖了研发协作最核心的四类场景:代码(GitHub)、工单(Linear)、稳定性(OpenStatus / Railway)、资讯(RSS),再配合 Webhook 与 Bot SDK 两个"万能通道",几乎任何工具都能接进团队频道。建议从 GitHub + RSS 开始,10 分钟内就能看到第一条自动推送,然后按团队节奏逐步补齐其余集成。项目整体架构与快速上手可参考 README.md。

登录后查看全文
hazel