WeChat MiMoCode Bridge
通过微信与 MiMoCode 对话，就像和朋友聊天一样
基于 wechat-claude-code 二次开发，将 Claude Code CLI 替换为 MiMoCode CLI。扫码绑定微信后，你的微信里会多出一个好友。给它发消息，消息会自动转发给你电脑上运行的 MiMoCode，回复也会实时推送到微信。支持文字、图片、语音和文件收发。
核心亮点
| 扫码即用 | 不用部署服务器。微信扫码绑定后即可使用，账号凭证、会话和日志默认保存在本地。 |
| MiMoCode 驱动 | 使用本地 MiMoCode CLI 处理请求，支持 MiMoCode 的模型、工具调用和本地工作区能力。 |
| 原生上下文压缩 | 调用 MiMoCode CLI 原生 /compact 命令，session ID 保持不变，token 大幅减少。 |
| 历史对话恢复 | 支持按编号、关键词搜索历史会话，一键恢复之前的对话。 |
| 消息不刷屏 | 流式回复会自动分段，只推送可读结果，避免工具调用和中间过程把微信刷屏。 |
| "对方正在输入中..." | MiMoCode 处理任务时，微信顶部会显示输入状态，长任务也能感知它仍在工作。 |
| 文件双向收发 | 可以把图片、PDF、文档等发给 MiMoCode 分析；生成的文件也可直接推送回微信。 |
| Skills 自动翻译 | /skills full 显示已安装的 Skill 列表，描述自动翻译为中文。 |
| 跨平台守护进程 | 使用 TypeScript 实现守护进程，支持 Windows、macOS 和 Linux。 |
快速安装
方式一：全局安装（推荐）
npm install -g wechat-mimocode安装后，任何目录下都可以直接使用 wechat-mimocode 命令。
方式二：从源码安装
git clone https://github.com/Mou-1205/wechat-mimocode.git
cd wechat-mimocode
npm install
npm install -g .验证安装
wechat-mimocode --version前置条件
- Node.js >= 18
- Windows / macOS / Linux
- 个人微信账号
- 已安装 MiMoCode CLI 并完成认证
快速开始
1. 扫码绑定
wechat-mimocode setup程序会显示或打开二维码，请用微信扫码完成绑定。
2. 启动服务
wechat-mimocode daemon start服务启动后会在后台通过长轮询监听微信消息，并转发给本地 MiMoCode CLI。
3. 开始聊天
打开微信，给新出现的那个"好友"发消息即可。
管理服务
wechat-mimocode daemon status # 查看运行状态
wechat-mimocode daemon stop # 停止服务
wechat-mimocode daemon restart # 重启服务（更新后使用）
wechat-mimocode daemon logs # 查看最近日志微信端命令
直接在微信聊天中发送即可：
会话管理
| 命令 | 说明 |
|---|---|
/help |
显示帮助 |
/new |
开启新话题，显示当前配置 |
/clear |
清除当前会话，开始新对话 |
/reset |
完全重置，包括工作目录等设置 |
/stop |
停止当前任务并清空排队消息 |
/compact |
压缩上下文（调用 MiMoCode 原生压缩） |
/resume |
列出最近 15 个历史会话 |
/resume <编号> |
按编号恢复历史会话 |
/resume <关键词> |
搜索并恢复历史会话 |
/goal <目标> |
设置持续性目标 |
/goal clear |
清除目标 |
/history [数量] |
查看最近对话记录（默认 20 条） |
/undo [数量] |
撤销最近几条对话（默认 1 条） |
配置
| 命令 | 说明 |
|---|---|
/model <provider/model> |
切换 MiMoCode 模型，如 xiaomi/mimo-v2.5 |
/prompt <内容> |
设置系统提示词，如"用中文回答" |
/prompt clear |
清除系统提示词 |
/cwd <路径> |
查看或切换工作目录 |
工具
| 命令 | 说明 |
|---|---|
/skills |
列出已安装的 Skill |
/skills full |
列出已安装的 Skill（中文描述） |
/status |
查看当前会话状态 |
/send <路径> |
发送本地文件 |
/<skill> [参数] |
触发任意已安装的 Skill |
工作原理
微信（手机） ←→ ilink Bot API ←→ Node.js 守护进程 ←→ MiMoCode CLI（本地）守护进程通过长轮询监听微信消息，转发给本地 MiMoCode CLI 处理，并将 MiMoCode 的回复实时推送回微信。整个流程运行在你自己的电脑上。
与上游差异
| 项目 | wechat-claude-code | wechat-mimocode |
|---|---|---|
| CLI 命令 | claude |
mimo |
| 输出格式 | --output-format stream-json |
--format json |
| 会话续接 | --resume <sessionId> |
--session <sessionId> |
| 模型格式 | claude-sonnet-4-6 |
provider/model，如 xiaomi/mimo-v2.5 |
| 系统提示 | --append-system-prompt |
拼接到 prompt 前部 |
| 图片传递 | 临时文件路径拼接到 prompt | 临时文件 + -f 参数 |
| Skill 目录 | ~/.claude/skills/ |
~/.agents/skills/ 与 ~/.local/share/mimocode/compose/*/skills/ |
| 数据目录 | ~/.wechat-claude-code/ |
~/.wechat-mimocode/ |
| 守护进程 | bash 脚本，偏 macOS/Linux | TypeScript 实现，支持 Windows/macOS/Linux |
数据目录
所有数据默认存储在 ~/.wechat-mimocode/：
~/.wechat-mimocode/
├── accounts/ # 微信账号凭证
├── config.json # 全局配置
├── sessions/ # 会话数据
└── logs/ # 运行日志也可以通过环境变量 WMC_DATA_DIR 指定数据目录，通过 WMC_MODEL 指定默认模型。
安全提醒
本项目会把微信消息转发给本地 MiMoCode CLI，并允许 MiMoCode 在指定工作目录内处理任务。请只绑定你信任的微信账号，避免把工作目录设置到敏感路径，并谨慎使用 /send 发送本地文件。
常见问题 (FAQ)
Q: 安装后命令找不到怎么办？
A: 确保 npm 全局安装路径在系统 PATH 中。运行 npm config get prefix 查看安装路径。
Q: 扫码后没有出现好友怎么办？
A: 请确保：
- 使用个人微信账号（不支持企业微信）
- 微信版本是最新的
- 等待几分钟，有时需要一些时间同步
Q: 消息发送失败怎么办？
A: 检查：
- MiMoCode CLI 是否已安装并认证
- 网络连接是否正常
- 查看日志：
wechat-mimocode daemon logs
Q: 如何切换工作目录？
A: 在微信中发送 /cwd <路径> 命令。
Q: 支持群聊吗？
A: 目前仅支持个人聊天，暂不支持群聊。
Q: 如何更新到最新版本？
A: 运行 npm update -g wechat-mimocode
Q: 数据安全吗？
A: 所有数据存储在本地，不会上传到任何服务器。微信消息通过官方 API 传输。
Q: 遇到奇怪的问题怎么办？
A: 如果遇到异常行为或错误（如"MiMoCode处理请求时出错，请稍后再试"）：
- 让 MiMoCode 自行修复 - 在 CLI 终端中描述问题，MiMoCode 会尝试诊断和修复
- 提交 Issue - 在 GitHub 上提交 Issue，详细描述问题和复现步骤
- 社区讨论 - 其他用户可能遇到过类似问题，可以一起讨论解决方案
- 查看日志 - 运行
wechat-mimocode daemon logs获取详细错误信息
致谢
本项目基于以下项目二次开发：
- wechat-claude-code - 原始项目
- wechat-claude-code-enhanced - 增强版项目，提供了许多功能灵感