WeChat OpenCode Bridge

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

# WeChat OpenCode Bridge

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

## 前置条件

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

## 安装

```bash
npm install -g wechat-opencode
```

本地开发时：

```bash
cd ~/wechat-opencode
npm install
```

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

## 触发场景

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

## 触发后的执行流程

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

按顺序检查以下状态：

### 第 1 步：检查是否已安装

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

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

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

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

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

### 第 3 步：检查 daemon 运行状态

```bash
wechat-opencode status
```

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

**如果 daemon 未运行：**

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

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

**如果 daemon 正在运行：**

```text
微信桥接正在运行（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/`：

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