im-hub

在 AI 编程助手（如 Claude Code、Copilot）日益强大的今天，我们却往往被困在终端窗口或特定的 IDE 中。如果能在常用的即时通讯软件（微信、飞书、Telegram）里直接指挥 AI 写代码、查 Bug、做分析，那该多方便？

im-hub 是一个通用消息应用转智能体桥接器，能够无缝连接主流 IM 平台与顶级 AI 编码智能体。无需复杂的 Docker 容器，无需 Go 语言环境，仅需一个 TypeScript 实例，即可让你的日常聊天窗口变身强大的 AI 编程指挥中心。

核心亮点：极简架构，无限扩展

1. 通用多路复用器

• 一对多连接：一个 im-hub 实例可同时连接多个消息应用（如同时监听微信和飞书）。
• 多智能体支持：可灵活对接 Claude Code、OpenAI Codex、GitHub Copilot、OpenCode 等多种后端智能体。
• 统一入口：无论你在哪个 IM 软件上，都能获得一致的 AI 交互体验。

2. 插件化架构

• 易于扩展：采用模块化设计，开发者可轻松编写插件以支持新的 IM 平台或新的 AI 模型。
• 社区驱动：未来将有更多社区贡献的适配器加入，覆盖更多小众但实用的工具。

3. TypeScript 原生，零依赖负担

• 轻量级：纯 Node.js 实现，无需安装沉重的 Docker 或编译 Go 二进制文件。
• 跨平台：只要运行 Node.js 的地方（Windows, macOS, Linux），就能运行 im-hub。
• 易调试：源码即逻辑，开发者可直接阅读和修改 TypeScript 代码进行定制。

4. JSONL 流式传输

• 实时响应：支持 Server-Sent Events (SSE) 或 WebSocket 流式输出，AI 生成的代码逐字显示在聊天窗口中，拒绝长时间等待。
• 完整上下文：完美保留代码块格式、Markdown 渲染和多轮对话历史。

快速上手：三步开启 AI 聊天编程

安装与配置过程极其简单，全程通过命令行交互完成：

第一步：全局安装

npm install -g im-hub

第二步：配置消息应用（三选一或多选）

🟢 微信 (WeChat)

im-hub config wechat
# 终端将显示二维码，用手机微信扫码登录即可
# 基于协议模拟，无需公网 IP，个人号可用

🔵 飞书 (Feishu/Lark)

im-hub config feishu
# 输入飞书开放平台的 App ID 和 App Secret
# 特色：使用 WebSocket 长轮询，无需配置 Webhook，无需公网 IP，本地 localhost 即可运行！

✈️ Telegram

im-hub config telegram
# 输入从 @BotFather 获取的 Bot Token
# 全球通用，部署最简单

第三步：配置 AI 智能体并启动

# 配置你的首选 AI（如 Claude Code）
im-hub config claude
# 按提示输入 API Key 或选择本地模型路径

# 启动桥接服务
im-hub start

启动后，直接在对应的 IM 应用中发送消息，即可看到 AI 的实时回复！

为什么 im-hub 是革命性的？

1. 飞书用户的福音：无需内网穿透

大多数机器人框架需要公网 IP 或 ngrok 来接收 Webhook 回调。im-hub 针对飞书采用了 WebSocket 长轮询 机制：

• ✅ 无需公网 IP
• ✅ 无需域名备案
• ✅ 无需 ngrok/frp
• ✅ 本地开发直连
  这让在企业内网或家庭网络下部署飞书 AI 助手变得前所未有的简单。

2. 微信生态的深度集成

对于中国开发者而言，微信是最高频的沟通工具。im-hub 支持个人微信号接入（通过扫码协议），意味着你可以：

• 在微信群里直接@机器人询问技术问题。
• 将代码片段转发给机器人进行审查。
• 随时随地通过手机语音输入需求，让 AI 生成代码。

3. 真正的“随身”AI 程序员

不再需要打开沉重的 VS Code 或终端。在通勤路上、会议间隙，只需掏出手机打开微信或飞书，就能让 AI 帮你：

• 解释一段复杂的正则表达式。
• 生成一个 Python 数据清洗脚本。
• 审查刚刚提交的 Git Diff。
• 规划下一个 Sprint 的技术任务。

应用场景

• 团队技术问答：在飞书群部署 im-hub，让它成为团队的“活文档”和“代码顾问”。
• 个人随身助手：在微信上绑定 Claude Code，随时随地记录灵感并转化为代码原型。
• 自动化运维通知：结合 CI/CD webhook，让 AI 自动分析报错日志并在群里给出修复建议。
• 低代码/无代码增强：让非技术人员通过自然语言在 IM 中生成简单的脚本或 SQL 查询。