wechat-to-anything 0.6.13 → 0.6.15

package/README.en.md

@@ -34,7 +34,7 @@
 ## Features
 
 - 🔌 **Zero-config setup** — One `npx` command, no cloning, no configuration
-- 🧠 **Agent-agnostic** — Works with any OpenAI-compatible API (Codex / Gemini / Claude / custom)
+- 🧠 **Agent-agnostic** — Works with any OpenAI-compatible API (Codex / Gemini / Claude / OpenCode / custom)
 - 📡 **Full multimodal** — Text, images, voice, video, files — bidirectional
 - 🤖 **Multi-Agent** — Connect multiple Agents simultaneously, route with `@` prefix
 - ⌨️ **Typing indicator** — Shows "typing..." while Agent is thinking
@@ -50,6 +50,18 @@
 | 🎬 Video | ✅ Auto-receive | ✅ With thumbnail |
 | 📄 File | ✅ Content extraction | ✅ Downloadable |
 
+### Supported Agents / Tools
+
+| Agent | Integration | Install |
+|-------|------------|---------|
+| ⌬ [OpenCode](https://opencode.ai) | `examples/opencode/` template | `npm i -g opencode-ai` |
+| 🤖 [OpenAI Codex](https://github.com/openai/codex) | `--codex` | `npm i -g @openai/codex` |
+| 💎 [Google Gemini](https://github.com/google/gemini-cli) | `--gemini` | `npm i -g @google/gemini-cli` |
+| 🧬 [Claude Code](https://github.com/anthropic-ai/claude-code) | `--claude` | `npm i -g @anthropic-ai/claude-code` |
+| 🐾 [OpenClaw](https://github.com/nicepkg/openclaw) | `--openclaw` | `npm i -g openclaw` |
+| 🔗 Any OpenAI-compatible API | Pass URL directly | — |
+| 📡 [ACP](https://agentcommunicationprotocol.dev/) Agent | `--agent name=acp://...` | — |
+
 ## Quick Start
 
 ```bash
@@ -59,6 +71,9 @@ npx wechat-to-anything --gemini    # Google Gemini
 npx wechat-to-anything --claude    # Claude Code
 npx wechat-to-anything --openclaw  # OpenClaw
 
+# Or use example templates for more Agents:
+cd examples/opencode && node server.mjs  # OpenCode (free models included)
+
 # Or pass a URL directly:
 npx wechat-to-anything http://your-agent:8000/v1
 ```
@@ -132,6 +147,8 @@ Include specific formats in Agent responses to automatically send media:
 ```
 
 > Examples: [image-test.mjs](examples/image-test.mjs) · [voice-test.mjs](examples/voice-test.mjs) · [video-test-local.mjs](examples/video-test-local.mjs) · [file-test.mjs](examples/file-test.mjs)
+>
+> Agent templates: [claude-code](examples/claude-code/) · [opencode](examples/opencode/) · [openai](examples/openai/)
 
 ## Multi-Agent Mode
 

package/README.md

@@ -34,7 +34,7 @@
 ## 特性
 
 - 🔌 **零依赖接入** — `npx` 一条命令，无需 clone、无需配置
-- 🧠 **Agent 无关** — 支持任何 OpenAI 兼容 API（Codex / Gemini / Claude / 自建）
+- 🧠 **Agent 无关** — 支持任何 OpenAI 兼容 API（Codex / Gemini / Claude / OpenCode / 自建）
 - 📡 **全模态** — 文本、图片、语音、视频、文件，双向全覆盖
 - 🤖 **多 Agent** — 同时接入多个 Agent，`@` 路由切换
 - ⌨️ **打字指示器** — Agent 思考时显示"对方正在输入"
@@ -50,6 +50,18 @@
 | 🎬 视频 | ✅ 自动接收 | ✅ 带缩略图 |
 | 📄 文件 | ✅ 提取内容 | ✅ 可下载 |
 
+### 已支持的 Agent / 工具
+
+| Agent | 接入方式 | 安装 |
+|-------|---------|------|
+| ⌬ [OpenCode](https://opencode.ai) | `examples/opencode/` 模板 | `npm i -g opencode-ai` |
+| 🤖 [OpenAI Codex](https://github.com/openai/codex) | `--codex` | `npm i -g @openai/codex` |
+| 💎 [Google Gemini](https://github.com/google/gemini-cli) | `--gemini` | `npm i -g @google/gemini-cli` |
+| 🧬 [Claude Code](https://github.com/anthropic-ai/claude-code) | `--claude` | `npm i -g @anthropic-ai/claude-code` |
+| 🐾 [OpenClaw](https://github.com/nicepkg/openclaw) | `--openclaw` | `npm i -g openclaw` |
+| 🔗 任何 OpenAI 兼容 API | 直接传 URL | — |
+| 📡 [ACP 协议](https://agentcommunicationprotocol.dev/) Agent | `--agent name=acp://...` | — |
+
 ## 快速开始
 
 ```bash
@@ -59,6 +71,9 @@ npx wechat-to-anything --gemini    # Google Gemini
 npx wechat-to-anything --claude    # Claude Code
 npx wechat-to-anything --openclaw  # OpenClaw
 
+# 或用 examples 模板接入更多 Agent：
+cd examples/opencode && node server.mjs  # OpenCode（含免费模型）
+
 # 或直接传 URL：
 npx wechat-to-anything http://your-agent:8000/v1
 ```
@@ -132,6 +147,8 @@ Agent 回复中包含特定格式即可自动发送多媒体：
 ```
 
 > 示例：[image-test.mjs](examples/image-test.mjs) · [voice-test.mjs](examples/voice-test.mjs) · [video-test-local.mjs](examples/video-test-local.mjs) · [file-test.mjs](examples/file-test.mjs)
+>
+> Agent 模板：[claude-code](examples/claude-code/) · [opencode](examples/opencode/) · [openai](examples/openai/)
 
 ## 多 Agent 模式
 

package/cli/bridge.mjs

@@ -307,8 +307,8 @@ export async function start(agents, defaultAgent, { port = 9099 } = {}) {
           // 构建发给 Agent 的消息
           let agentMessages;
 
-          if (media?.type === "image") {
-            // 图片：下载解密，缓存 base64，等待用户发文字
+          if (media?.type === "image" && !media.fromRef) {
+            // 直接发送的图片：下载解密，缓存 base64，等待用户发文字
             console.log(pc.cyan(`← [微信] ${from}: [图片] (等待文字问题...)`));
             try {
               const buf = await downloadAndDecrypt(media.encryptQueryParam, media.aesKey);
@@ -322,6 +322,23 @@ export async function start(agents, defaultAgent, { port = 9099 } = {}) {
             }
             continue; // 不发给 Agent，等文字
 
+          } else if (media?.type === "image" && media.fromRef && text) {
+            // 引用图片 + 文字：立即合并发送（不缓存）
+            console.log(pc.cyan(`← [微信] ${from}: [引用图片+文字] ${text.slice(0, 80)}`));
+            try {
+              const buf = await downloadAndDecrypt(media.encryptQueryParam, media.aesKey);
+              agentMessages = [{
+                role: "user",
+                content: [
+                  { type: "text", text },
+                  { type: "image_url", image_url: { url: `data:image/jpeg;base64,${buf.toString("base64")}` } },
+                ],
+              }];
+            } catch (err) {
+              console.error(pc.red(`   引用图片下载失败: ${err.message}`));
+              agentMessages = [{ role: "user", content: text }];
+            }
+
           } else if (text) {
             // === 管理命令 ===
             if (multiMode && text.trim() === "@list") {
@@ -376,26 +393,32 @@ export async function start(agents, defaultAgent, { port = 9099 } = {}) {
               continue;
             }
           } else if (media?.type === "file") {
-            console.log(pc.cyan(`← [微信] ${from}: [文件] ${media.fileName}`));
+            const label = media.fromRef ? "引用文件" : "文件";
+            console.log(pc.cyan(`← [微信] ${from}: [${label}] ${media.fileName}`));
             try {
               const { buffer } = await downloadMediaToFile(media.encryptQueryParam, media.aesKey, media.fileName.split(".").pop());
               if (buffer.length < 100_000) {
                 const content = buffer.toString("utf-8");
                 if (!content.includes("\x00")) {
-                  agentMessages = [{ role: "user", content: `用户发送了文件 "${media.fileName}"，内容如下：\n\n${content}` }];
+                  const prefix = (media.fromRef && text) ? `${text}\n\n` : "";
+                  agentMessages = [{ role: "user", content: `${prefix}用户发送了文件 "${media.fileName}"，内容如下：\n\n${content}` }];
                 } else {
-                  agentMessages = [{ role: "user", content: `用户发送了文件 "${media.fileName}"（${(buffer.length / 1024).toFixed(1)} KB，二进制文件）` }];
+                  const prefix = (media.fromRef && text) ? `${text}\n\n` : "";
+                  agentMessages = [{ role: "user", content: `${prefix}用户发送了文件 "${media.fileName}"（${(buffer.length / 1024).toFixed(1)} KB，二进制文件）` }];
                 }
               } else {
-                agentMessages = [{ role: "user", content: `用户发送了文件 "${media.fileName}"（${(buffer.length / 1024).toFixed(1)} KB）` }];
+                const prefix = (media.fromRef && text) ? `${text}\n\n` : "";
+                agentMessages = [{ role: "user", content: `${prefix}用户发送了文件 "${media.fileName}"（${(buffer.length / 1024).toFixed(1)} KB）` }];
               }
             } catch (err) {
               console.error(pc.red(`   文件下载失败: ${err.message}`));
               continue;
             }
           } else if (media?.type === "video") {
-            console.log(pc.cyan(`← [微信] ${from}: [视频]`));
-            agentMessages = [{ role: "user", content: "用户发送了一段视频" }];
+            const label = media.fromRef ? "引用视频" : "视频";
+            console.log(pc.cyan(`← [微信] ${from}: [${label}]`));
+            const prefix = (media.fromRef && text) ? `${text}\n\n` : "";
+            agentMessages = [{ role: "user", content: `${prefix}用户发送了一段视频` }];
           } else {
             continue;
           }

package/cli/weixin.mjs

@@ -391,24 +391,77 @@ export async function sendTyping(token, userId, typingTicket, status = 1) {
 }
 
 /**
- * 提取消息文本（支持语音转文字）
+ * 提取消息文本（支持语音转文字 + 引用消息）
+ *
+ * 引用消息结构 (ref_msg):
+ *   item.ref_msg.title       — 引用摘要
+ *   item.ref_msg.message_item — 引用的原始 item（可能是文字/图片/文件等）
+ *
+ * 参考: openclaw-weixin inbound.ts#L86-98
  */
 export function extractText(msg) {
   const items = msg.item_list || [];
   for (const item of items) {
-    if (item.type === 1 && item.text_item?.text) return item.text_item.text;
+    if (item.type === 1 && item.text_item?.text) {
+      const text = item.text_item.text;
+      const ref = item.ref_msg;
+      if (!ref) return text;
+
+      // 引用的是媒体（图片/文件/视频） → 只返回用户文字，媒体由 extractMedia 处理
+      if (ref.message_item && isMediaItem(ref.message_item)) return text;
+
+      // 引用的是文字 → 拼接引用上下文
+      const parts = [];
+      if (ref.title) parts.push(ref.title);
+      if (ref.message_item?.text_item?.text) parts.push(ref.message_item.text_item.text);
+      if (!parts.length) return text;
+      return `[引用: ${parts.join(" | ")}]\n${text}`;
+    }
     // 语音转文字（微信自带）
     if (item.type === 3 && item.voice_item?.text) return item.voice_item.text;
   }
   return "";
 }
 
+/** 判断 item 是否为媒体类型 (image=2, voice=3, file=4, video=5) */
+function isMediaItem(item) {
+  return item.type === 2 || item.type === 3 || item.type === 4 || item.type === 5;
+}
+
 /**
- * 提取多媒体信息
- * @returns {{ type: 'image'|'voice'|'file'|'video', encryptQueryParam, aesKey, fileName?, voiceText? } | null}
+ * 提取多媒体信息（含引用消息中的媒体）
+ *
+ * 优先级：主消息中的媒体 > 引用消息中的媒体
+ * 参考: openclaw-weixin process-message.ts#L112-138
+ *
+ * @returns {{ type: 'image'|'voice'|'file'|'video', encryptQueryParam, aesKey, fileName?, voiceText?, fromRef? } | null}
  */
 export function extractMedia(msg) {
   const items = msg.item_list || [];
+
+  // 1. 先扫描主消息中的媒体
+  const mainMedia = extractMediaFromItem(items);
+  if (mainMedia) return mainMedia;
+
+  // 2. 无主媒体时，检查引用消息中的媒体 (ref_msg)
+  for (const item of items) {
+    if (item.type === 1 && item.ref_msg?.message_item && isMediaItem(item.ref_msg.message_item)) {
+      const refMedia = extractMediaFromItem([item.ref_msg.message_item]);
+      if (refMedia) {
+        refMedia.fromRef = true; // 标记来自引用
+        return refMedia;
+      }
+    }
+  }
+
+  return null;
+}
+
+/**
+ * 从 item 列表中提取第一个媒体
+ * @private
+ */
+function extractMediaFromItem(items) {
   for (const item of items) {
     // 图片
     if (item.type === 2 && item.image_item?.media?.encrypt_query_param) {
@@ -434,7 +487,6 @@ export function extractMedia(msg) {
     }
     // 文件
     if (item.type === 4 && item.file_item?.media?.encrypt_query_param) {
-
       return {
         type: "file",
         encryptQueryParam: item.file_item.media.encrypt_query_param,
@@ -444,7 +496,6 @@ export function extractMedia(msg) {
     }
     // 视频
     if (item.type === 5 && item.video_item?.media?.encrypt_query_param) {
-
       return {
         type: "video",
         encryptQueryParam: item.video_item.media.encrypt_query_param,

package/examples/opencode/README.md

@@ -0,0 +1,24 @@
+# OpenCode + wechat-to-anything
+
+## 前置条件
+
+```bash
+# 安装 OpenCode (任选一种)
+brew install anomalyco/tap/opencode
+# 或
+npm i -g opencode-ai
+```
+
+然后配置 AI provider，参考 [opencode.ai/docs](https://opencode.ai/docs)。
+
+## 启动
+
+```bash
+# 终端 1: 启动 OpenCode HTTP 服务
+node server.mjs
+
+# 终端 2: 启动微信桥
+npx wechat-to-anything http://localhost:3000/v1
+```
+
+完成！微信消息会自动转发给 OpenCode，回复会发回微信。

package/examples/opencode/server.mjs

@@ -0,0 +1,107 @@
+/**
+ * OpenCode → OpenAI 兼容 HTTP 服务
+ *
+ * 通过 `opencode run "prompt"` 子进程调用 OpenCode，
+ * 包装成标准 HTTP 接口供 wechat-to-anything 连接。
+ *
+ * 前置条件:
+ *   npm i -g opencode-ai    (或 brew install anomalyco/tap/opencode)
+ *   配置好 AI provider:  opencode providers login
+ *
+ * 用法:
+ *   node server.mjs
+ *   # 然后另一个终端:
+ *   npx wechat-to-anything http://localhost:3000/v1
+ *
+ * 可选环境变量:
+ *   PORT=3000              HTTP 端口
+ *   OPENCODE_MODEL=xxx     指定模型 (格式: provider/model)
+ */
+
+import { createServer } from "node:http";
+import { spawn } from "node:child_process";
+
+const PORT = process.env.PORT || 3000;
+const MODEL = process.env.OPENCODE_MODEL || "";
+
+const server = createServer(async (req, res) => {
+  if (req.method !== "POST" || !req.url.startsWith("/v1/chat/completions")) {
+    res.writeHead(404);
+    res.end("Not Found");
+    return;
+  }
+
+  const body = await readBody(req);
+  const { messages } = JSON.parse(body);
+  const userMessage =
+    messages?.findLast((m) => m.role === "user")?.content || "";
+
+  try {
+    const result = await runOpenCode(userMessage);
+
+    res.writeHead(200, { "Content-Type": "application/json" });
+    res.end(
+      JSON.stringify({
+        choices: [
+          {
+            message: { role: "assistant", content: result },
+          },
+        ],
+      })
+    );
+  } catch (err) {
+    console.error(`  ✗ ${err.message.slice(0, 120)}`);
+    res.writeHead(500, { "Content-Type": "application/json" });
+    res.end(JSON.stringify({ error: err.message }));
+  }
+});
+
+server.listen(PORT, () => {
+  console.log(`⌬ OpenCode Agent 运行在 http://localhost:${PORT}/v1`);
+  if (MODEL) console.log(`  模型: ${MODEL}`);
+  console.log(
+    `  然后运行: npx wechat-to-anything http://localhost:${PORT}/v1`
+  );
+});
+
+/**
+ * 通过 opencode run "prompt" 非交互模式调用
+ */
+function runOpenCode(prompt) {
+  return new Promise((resolve, reject) => {
+    const args = ["run", prompt];
+    if (MODEL) args.push("-m", MODEL);
+
+    const child = spawn("opencode", args, {
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 300_000,
+    });
+
+    let stdout = "";
+    let stderr = "";
+
+    child.stdout.on("data", (d) => (stdout += d));
+    child.stderr.on("data", (d) => (stderr += d));
+
+    child.on("close", (code) => {
+      // opencode run 输出可能包含 ANSI 颜色码，清理掉
+      const clean = (s) => s.replace(/\x1b\[[0-9;]*m/g, "").trim();
+      if (code !== 0) {
+        const errMsg = clean(stderr + stdout) || `exit code ${code}`;
+        reject(new Error(errMsg.slice(0, 300)));
+      } else {
+        resolve(clean(stdout) || "(empty response)");
+      }
+    });
+
+    child.on("error", (err) => reject(err));
+  });
+}
+
+function readBody(req) {
+  return new Promise((resolve) => {
+    let data = "";
+    req.on("data", (chunk) => (data += chunk));
+    req.on("end", () => resolve(data));
+  });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "wechat-to-anything",
-  "version": "0.6.13",
+  "version": "0.6.15",
   "description": "一条命令，把微信变成任何 AI Agent 的入口",
   "type": "module",
   "bin": {
@@ -20,7 +20,8 @@
     "claude-code",
     "openai",
     "codex",
-    "anthropic"
+    "anthropic",
+    "opencode"
   ],
   "author": "kellyvv",
   "license": "MIT",