JSPM

  • ESM via JSPM
  • ES Module Entrypoint
  • Export Map
  • Keywords
  • License
  • Repository URL
  • TypeScript Types
  • README
  • Created
  • Published
  • Downloads 1933
  • Score
    100M100P100Q107202F
  • License MIT

Bridge WeChat to OpenCode

Package Exports

  • wechat-bridge-opencode

Readme

WeChat OpenCode

中文 | English

将微信私聊消息桥接到 OpenCode Server（HTTP API），支持文本、图片、文件、音视频的双向传输。

发送 接收

功能

  • 文本消息 — 微信与 OpenCode 之间的双向文本传输
  • 图片传输 — 支持发送/接收图片，支持微信 CDN 下载
  • 文件传输 — 支持任意类型文件收发
  • 音视频传输 — 完整的音频和视频消息支持
  • 二维码登录 — 终端渲染二维码，扫码登录微信
  • OpenCode Server — 基于 HTTP API，不再需要 ACP 子进程
  • 后台模式 — 使用 --daemon 参数后台运行
  • send-wechat 工具 — Agent 可直接发送文字、文件、图片到微信

安装

方式一：一键运行（推荐）

无需安装，npx 会自动下载并运行：

npx wechat-bridge-opencode

方式二：全局安装

npm install -g wechat-bridge-opencode

安装完成后，可使用简写命令：

wbo

使用

cd /path/to/your/project
wbo
# 或直接使用 npx：
# npx wechat-bridge-opencode

首次运行会：

  1. 自动启动 opencode serve（HTTP Server）
  2. 终端显示二维码
  3. 扫码登录微信
  4. 保存登录令牌到 ~/.wechat-bridge-opencode
  5. 开始轮询微信私信

选项

参数 说明
--cwd <目录> 工作目录
--server-url <url> 连接外部 OpenCode Server，跳过自动启动
--server-username <user> 外部 Server 的 HTTP Basic 用户名（与 --server-password 配合）
--server-password <pwd> 外部 Server 的 HTTP Basic 密码
--server-token <token> 外部 Server 的 Bearer Token（优先级高于 Basic）
--login 强制重新登录
--daemon 后台运行
--config <文件> JSON 配置文件
--idle-timeout <分钟> 会话空闲超时（默认 0 = 无限）

外部 Server 认证

当 --server-url 指向需要认证的 server 时，bridge 会自动注入 Authorization 头。支持两种方式（独立配置，Bearer 优先）：

  • Basic 认证：--server-username + --server-password 同时使用，常见于 nginx/caddy 反向代理内置认证
  • Bearer Token：--server-token <token>，常见于 API key / 自定义认证中间件

为避免敏感信息落入 shell history 或 JSON 配置文件，也可通过环境变量设置（优先级：CLI > 环境变量 > 配置文件）：

export WECHAT_OPENCODE_SERVER_TOKEN=xxx
export WECHAT_OPENCODE_SERVER_USERNAME=admin
export WECHAT_OPENCODE_SERVER_PASSWORD=secret

Basic 认证要求用户名和密码同时配置；只设一个会启动失败并报错。Bearer Token 与 Basic 同时配置时，Token 生效。password / token 视为敏感字段，永远不会写入日志或 /status 命令的输出。

微信命令

工作区（/workspace 或 /ws）

命令 说明
/workspace list 列出所有工作区，按最近活跃度排序，带序号
/workspace status 显示当前工作区
/workspace switch <路径|编号> 切换到指定目录（/workspace list 中的编号也可）
/workspace add <路径> 添加并切换到目录

会话（/session 或 /s）

命令 说明
/session list 列出最近 20 个会话，显示工作路径
/session list current 列出当前工作区的最近 20 个会话
/session switch <n> 按编号切换到指定会话（自动切换到对应工作区）
/session new 新会话（清除上下文）
/session status 显示当前会话信息

Agent（/agent 或 /a）

命令 说明
/agent list 列出可用 Agent 模式，带序号和当前标记（仅显示 primary 非内置 agent）
/agent switch <名称|n> 按名称或序号切换 Agent 模式
/agent status 显示当前 Agent 模式

Model（/model）

命令 说明
/model list 列出模型提供商及其数量
/model list <provider> 列出指定提供商下的所有模型
/model switch <provider/model> 切换模型（如 anthropic/claude-sonnet-4-5）
/model status 显示当前模型

Reasoning（/reasoning）

命令 说明
/reasoning list 列出当前模型支持的实际推理等级（从模型 variants 获取）
/reasoning switch <level> 切换推理级别
/reasoning status 显示当前推理级别

状态（/status）

命令 说明
/status 显示当前会话（含标题）、工作区、Agent、Model、推理级别、上下文用量，以及当前工作区配置的 MCP servers 状态（含失败原因）。Agent/Model/Reasoning/MCP 从当前工作区获取，无历史消息时取配置默认值

停止（/stop）

命令 说明
/stop 停止正在运行的 Agent
/restart 新会话（清除上下文）

思考（/thought）

命令 说明
/thought on 开启思考与工具显示
/thought off 关闭思考与工具显示
/thought status 查看当前显示设置

系统（/version、/upgrade）

命令 说明
/version 查询 Bridge、OpenCode Server 与 npm 上最新版本；如有新版会提示 /upgrade
/upgrade 运行 opencode upgrade 升级 OpenCode 并自动重启 server（外部 server 模式不可用，npx 模式下重启即升级）

消息计数（/next）

命令 说明
/next 微信限制连续发送 10 条消息，超出后需用户回复才能继续。发送 /next 重置计数，不转发给 Agent

环境要求

  • Node.js 20+
  • 微信 iLink 机器人 API 访问权限
  • OpenCode（需支持 opencode serve 命令）
  • Bridge 会自动启动 opencode serve；通过 --server-url <url> 可改连外部实例

数据存储

运行时数据存储在 ~/.wechat-bridge-opencode：

  • 登录令牌
  • 认证令牌
  • 临时文件（下载的媒体）
  • 守护进程 PID / 日志
  • 桥接状态（.wechat-bridge-state.json）

注意事项

  • 仅支持私信（群聊会被忽略）
  • 权限请求自动批准
  • send-wechat 工具自动安装到 ~/.config/opencode/tools/send-wechat.ts

致谢

本项目基于 wechat-acp（作者 formulahendry）二次开发，感谢原作者的贡献！

许可证

MIT