WeChat Agent Bridge

一台电脑，多个微信用户，AI 任务同时运行。

多人分别扫码 · 任务并行执行 · 多项目与多会话管理
让你和家人、协作者，通过各自的微信使用本机 Codex / Claude Code。

快速开始 · 功能概览 · 多用户并行 · 微信命令 · 完整文档 · 下载 · 更新记录

多人共享一台电脑

**电脑端安装一次，每个人用自己的微信扫码，分别发起任务。**你可以处理代码，家人或协作者可以同时分析文档；不同用户并行运行，各自的任务按顺序执行。

完成下方基础安装后，添加一个用户，让对方用自己的微信扫码：

wx-agent user add teammate     # 创建独立工作区，扫码后自动启动
wx-agent user list             # 查看所有用户
wx-agent user status teammate  # 查看指定用户状态
wx-agent user stop teammate    # 只停止指定用户

原有用户为 default，不带 --user 的命令继续管理默认用户。工作区分离属于应用层管理，不是操作系统安全隔离；获批命令仍以本机用户权限执行。详见多用户使用指南。

功能概览

快速开始

准备 Node.js 22+、npm、系统 curl，以及至少一种已安装并完成认证配置的引擎：Codex CLI 或 Claude Code。

1. 安装并启动

macOS / Linux：

npm install -g https://github.com/zhouqise/wechat-agent-bridge/releases/download/v0.19.0/wx-codex-bridge-0.19.0.tgz --ignore-scripts
wx-agent setup
wx-agent start

Windows PowerShell：

npm.cmd install -g https://github.com/zhouqise/wechat-agent-bridge/releases/download/v0.19.0/wx-codex-bridge-0.19.0.tgz --ignore-scripts
wx-agent.cmd setup
wx-agent.cmd start

向导支持 codex、claude、both（两个都配置，也可输入 3）。选择 both 后，分别设置两套认证、模型和代理，再选择默认引擎；工作目录与微信扫码只设置一次。两个 CLI 需预先安装，向导不会自动安装它们。工作目录可直接回车，使用独立空白工作区，之后无需每条消息指定目录。

安装包通过 GitHub Releases 提供，尚未发布到 npm。全局目录权限、引擎安装及代理配置见完整安装指南。

2. 在微信验证连接

向已绑定的机器人发送：

不要调用工具，只回复：微信 AI 助手已连通。

收到回复后，就可以发任务、截图或文件。基础文字任务无需安装下方的媒体处理组件。

3. 试一次文件处理

发送：一份 PDF / Excel / Word / PPT
随后发送：总结重点，并把结果整理成 Word 文档。
发送：/开始

桥接将附件和说明合并，交给当前引擎；需要授权的操作会在微信请求单次确认。成功任务在 wx-agent-output 中新增或修改的受支持文件会自动回传，最多 5 份、每份 20 MB；也可发送 /文件 手动取回。

在微信管理任务与上下文

连续消息合并，不用一次写完

• 连续文字：等待最后一条消息后的 1.5 秒。
• 包含附件：等待最后一条消息后的 8 秒，方便补充说明或继续上传。
• 最长合并等待：从第一条消息起 20 秒；发送 /开始 可立即提交。
• 忙碌时：新任务进入当前用户的队列，最多 10 个等待任务；其他用户继续并行。

要开始另一项独立任务，可先发送 /开始，再发送新内容。/任务 查看队列，/取消 任务编号 移除指定等待任务，/清空队列 移除全部等待任务。

队列内容保存在内存中，停止或重启后不会自动重跑；恢复后会提示核对未确认任务。

会话可切换，命令直接复制

发送 /会话 或 /会话列表，每项显示名称、完整 ID 和可复制命令。例如：

2. 文档整理
ID：a1b2c3d4
/切换会话 a1b2c3d4
快捷：/切换会话 2
/删除会话 a1b2c3d4

复制完整命令即可切换，也可直接输入 /切换会话 2。**短序号固定，不随排序变化，删除后不复用。**上面的 ID 仅为示例，请使用自己的列表。

• /新会话 名称：创建新上下文，保留旧会话；不填名称时自动取第一条任务作为标题。
• /会话 2：翻到第 2 页，每页 10 个会话。
• /结果：获取当前会话的最近结果。
• /清空会话（或 /清空所有会话）：清空当前用户、项目和引擎的会话列表，同时创建并切换到新会话。
• /删除会话 ID：移除桥接会话记录，保留项目文件和引擎本机历史。

会话按用户 → 项目 → 引擎分别管理，每组最多 100 个。运行、排队或回传期间可以查看列表，变更会话需先结束当前任务并清空等待队列。列表只包含本桥接登记的会话，不导入桌面应用或 CLI 的全部历史。

一条微信切换项目

先在电脑上登记允许使用的目录：

wx-agent stop
wx-agent project add demo /absolute/path/to/project
wx-agent start

Windows 路径示例：wx-agent project add demo "C:\Projects\demo"。目录需已存在。

之后在微信发送 /项目 查看列表，发送 /项目 demo 切换。各项目分别恢复对应引擎的会话；同一项目下的多个会话共用工作目录，切换会话不会回滚文件。为指定用户登记项目见项目管理文档。

按需开启媒体与文档能力

wx-agent office-setup   # 安装 PDF / Office 环境
wx-agent office-check   # 检查文档组件
wx-agent ocr-setup      # 已安装 Tesseract 后，安装 OCR 组件及中英文语言包
wx-agent ocr-check      # 检查 OCR 环境
wx-agent media-check    # 检查视频组件及转写模型

OCR、视频转写可能存在错漏，视频画面是抽样；Office 复杂版式和 Excel 公式计算需复核。登录页面、JavaScript 动态网页可能无法完整读取。支持格式、安装步骤与详细限制见媒体与文件指南。

微信操作速查

运行与升级

无需进入安装目录，在终端直接执行：

wx-agent status         # 查看当前服务状态
wx-agent stop           # 停止默认用户
wx-agent start          # 后台启动默认用户
wx-agent logs           # 查看最近日志
wx-agent update --check # 只检查新版本
wx-agent update         # 升级到最新稳定版

升级保留配置、微信绑定和会话记录。执行、排队或回传中会拒绝升级；多用户使用时，先停止新增用户，升级后分别启动。重新绑定、停用用户与恢复说明见运维指南。

它如何工作

flowchart LR
    W1[用户 A 微信] <--> B1[独立队列与审批 A]
    W2[用户 B 微信] <--> B2[独立队列与审批 B]
    subgraph H[同一台电脑 · 不同用户并行]
      B1 <--> E1[Codex / Claude Code 进程 A]
      B2 <--> E2[Codex / Claude Code 进程 B]
      E1 --> P1[用户 A 的项目与会话]
      E2 --> P2[用户 B 的项目与会话]
    end

每个用户有独立 Bridge 进程，连接自己当前选择的引擎。原始资料或提取内容会提交给所选模型服务；本机运行桥接、OCR 和视频预处理，不代表模型推理离线。

文档导航

使用前了解

• 电脑需保持唤醒和联网；后台运行不等于开机自启，重启电脑后需再次启动。
• 支持绑定用户的私聊，不支持群聊；能否扫码绑定取决于微信服务端。
• macOS 已有真实连接验证；Windows / Linux 有跨平台自动测试，完整微信与模型链路仍需实机确认。
• 独立开源项目，非腾讯、OpenAI 或 Anthropic 官方产品。请勿在 Issues 中上传二维码、密钥或会话文件。

开源与反馈

采用 MIT 许可证。欢迎提交 Issue 或 Pull Request，请附平台、版本、复现步骤和脱敏日志。

_{WeChat Agent Bridge · Your coding agents. One conversation away.}