wechat-opencode

name	wechat-opencode
description	微信消息桥接 - 在微信中与 OpenCode 对话。支持文字对话、权限审批、斜杠命令与守护进程管理。

WeChat OpenCode Bridge

通过个人微信与本地 OpenCode 进行对话。

前置条件

• Node.js >= 18
• macOS 或 Linux
• 个人微信账号（需扫码绑定）
• 本机已安装 OpenCode，且终端中可正常使用

安装

npm install -g wechat-opencode

本地开发时：

cd ~/wechat-opencode
npm install

postinstall 会自动执行 npm run build 编译 TypeScript。

触发场景

用户提到“微信桥接”、“微信聊天”、“wechat bridge”、“连接微信”、“微信状态”、“停止微信服务”、“OpenCode 微信”等相关话题时触发。

触发后的执行流程

被触发时，不要直接执行任何操作，先探查当前状态再给出可用操作。

按顺序检查以下状态：

第 1 步：检查是否已安装

command -v wechat-opencode >/dev/null 2>&1 && echo "installed" || echo "not_installed"

• 如果 not_installed：提示用户运行 npm install -g wechat-opencode 安装，然后停止。

第 2 步：检查是否已绑定微信账号

ls ~/.config/opencode/wechat/accounts/*.json 2>/dev/null | head -1

• 如果没有账号文件：提示用户先执行 setup 扫码绑定，询问是否现在执行。
• 如果有账号文件：继续下一步。

第 3 步：检查 daemon 运行状态

wechat-opencode status

第 4 步：根据状态展示信息

如果 daemon 未运行：

微信桥接已绑定但未运行。

可用操作：
  setup    重新扫码绑定（换号或过期时使用）
  start    启动服务
  logs     查看上次运行日志

如果 daemon 正在运行：

微信桥接正在运行（PID: xxx）。

可用操作：
  stop     停止服务
  restart  重启服务（代码更新后使用）
  logs     查看运行日志

微信端命令（直接在微信中发送）：
  /help      显示帮助
  /clear     清除当前会话
  /status    查看当前会话状态
  /model     切换模型
  /models    查看推荐模型
  /cwd       切换工作目录
  /permission 切换权限模式

如果用户已经明确指定了操作（如“启动微信”、“停止微信服务”、“看看日志”），跳过状态展示，直接执行对应命令。

子命令参考

全局安装后可直接使用 wechat-opencode。

命令	执行	说明
setup	wechat-opencode setup	首次安装向导：生成二维码 → 微信扫码 → 配置工作目录
start	wechat-opencode start	启动守护进程
stop	wechat-opencode stop	停止守护进程
restart	wechat-opencode restart	重启守护进程
status	wechat-opencode status	查看运行状态
logs	wechat-opencode logs	查看最近日志

权限审批

当 OpenCode 请求执行工具时，微信会收到权限请求消息：

• 回复 y 或 yes 允许
• 回复 n 或 no 拒绝
• 超时未回复会自动拒绝

数据目录

所有数据存储在 ~/.config/opencode/wechat/：

~/.config/opencode/wechat/
├── accounts/       # 绑定的微信账号数据
├── config.env      # 全局配置
├── sessions/       # 会话数据
├── get_updates_buf # 消息轮询同步缓冲
└── logs/           # 运行日志