IM Claude Bridge — Communication skill for Claude Code

IM Claude Bridge

将 Discord/微信消息桥接到本地 Claude Code CLI 的双向通信系统。

A two-way communication system that bridges Discord/WeChat messages to your local Claude Code CLI.

[English](README_EN.md) | [简体中文](README.md)

---

✨ 核心功能

**💬 消息交互**

• @Bot调用本地 Claude Code CLI（支持 Discord 和微信）
• 持续对话支持（会话管理）
• 实时状态反馈（接收 → 处理 → 响应）
• 消息追踪系统（避免重复处理）
• 使用消息队列机制统一处理响应（保证消息顺序正确）
• 工具调用通知（在 Discord 中以 Embed 卡片形式发送）
• 图片表情包（自动检测 <:文件名.扩展名> 格式并发送图片）

**📁 文件传输**

• 支持所有文件类型（图片、文档、压缩包等）
• 在 Discord 中发送消息时附带文件（自动下载并传入文件信息）
• 在 Discord 中右键上下文菜单下载文件
• 引用文件信息（自动提取文件信息发送给 Claude Code）
• 自动从 Discord/微信下载文件到本地配置的目录
• 自动处理文件名冲突（自动重命名）
• 语音消息直接触发（微信语音消息 + Discord 语音条：下载后自动以文件路径描述文本触发 AI 处理，用户可自行给 AI 配置转文字工具，bridge 本身不依赖任何音频库）
• 微信语音自动转写（微信语音自带服务端转写，转写文本自动注入提示词，无需额外配置 AI 即可理解语音内容）
• 通过 MCP 发送文件到 Discord/微信
• 批量文件传输支持

**⏰ 定时任务**

• 创建和管理定时任务（支持 cron 表达式）
• 支持私聊和频道消息推送
• 任务启用/禁用/更新/删除
• 执行历史记录查询

**🎛️ Web 控制界面**

• 实时监控各组件运行状态（Discord Bot / Weixin Bot / Bridge / Manager / MCP Server）
• 实时查看日志输出（5 个组件独立日志面板）
• 深色/浅色主题切换
• 一键重启/停止所有服务
• 自动重连 WebSocket 连接

**🎯 服务管理**

• Windows 守护进程（自动监控重启）
• Discord 斜杠命令控制（/new、/status、/restart、/stop、/abort、/mention、/split）
• 上下文菜单（右键消息下载附件）
• 消息队列系统（SQLite 持久化）
• 并行 Bot 架构（Discord Bot 和微信 Bot 独立运行）

🚀 快速开始

0. 推荐工作区结构

**强烈建议**将本项目放在 Claude Code 的工作区根目录下，方便管理多个项目。

**示例结构**：

D:/AgentWorkspace/                    # 工作区根目录
├── IM-claude-bridge/                 # IM 桥接项目（本仓库）
├── my-project-1/                     # 你的其他项目
├── downloads/                        # 默认文件下载目录
└── .claude/                          # Claude Code 配置

1. 前置要求

• Windows 系统
• Python 3.8+
• Discord Bot Token
• Claude Code CLI

2. 安装

# 克隆项目
git clone https://github.com/OstrichHermit/IM-claude-bridge.git
cd IM-claude-bridge

# 安装依赖
pip install -r requirements.txt

# 配置 Discord Bot Token
cp config/config.example.yaml config.yaml
# 编辑 config.yaml，填入你的 Discord Bot Token

3. 创建 Discord 应用

访问 [Discord Developer Portal](https://discord.