wechat-to-anything 0.5.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Kellyxiaowei
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,144 @@
+# wechat-to-anything
+
+> 把微信变成任何 AI Agent 的前端。零依赖，一条命令。
+>
+> ⭐ 如果这个项目对你有帮助，请给个 Star！本项目仅用于技术学习和交流，开源不易。
+
+微信双向支持 Agent 多种模态消息发送和接收，支持文本、图片、语音、文件。
+
+<p align="center">
+  <img src="docs/wechat-image-send.png" width="250" alt="发送图片给 Agent 识别" />
+  <img src="docs/wechat-image-receive.png" width="250" alt="Agent 发送图片到微信" />
+  <a href="https://github.com/kellyvv/wechat-to-anything/raw/main/docs/wechat-voice-demo.mp4">
+    <img src="docs/wechat-voice-demo.gif" width="250" alt="语音发送演示（点击播放有声版）" />
+  </a>
+</p>
+
+## 原理
+
+```
+微信 ←→ ilinkai API (腾讯) ←→ wechat-to-anything ←→ 你的 Agent (HTTP)
+```
+
+直接调用腾讯 ilinkai 接口收发微信消息，无中间层。你的 Agent 只需暴露一个 OpenAI 兼容的 HTTP 接口（`POST /v1/chat/completions`），任何语言都行。
+
+### 多种模态支持
+
+| 方向 | 图片 | 语音 | 文件 |
+|---|---|---|---|
+| **微信 → Agent** | ✅ 自动识别 | ✅ 语音转文字 | ✅ 提取文本 |
+| **Agent → 微信** | ✅ 自动发图 | ✅ 语音消息 | 文本回复 |
+
+## 前置条件
+
+- Node.js >= 22（`nvm install 22`）
+
+## 快速开始
+
+```bash
+# 一条命令，选你喜欢的 Agent：
+npx wechat-to-anything --codex     # OpenAI Codex
+npx wechat-to-anything --gemini    # Google Gemini
+npx wechat-to-anything --claude    # Claude Code
+npx wechat-to-anything --openclaw  # OpenClaw
+
+# 多 Agent 同时用：
+npx wechat-to-anything --codex --gemini
+```
+
+> 需要先安装对应 CLI：`npm i -g @openai/codex` / `@google/gemini-cli` / `@anthropic-ai/claude-code` / `openclaw`
+>
+> 也支持直接传 URL：`npx wechat-to-anything http://your-agent:8000/v1`
+
+### 接入 OpenClaw
+
+```bash
+# 1. 安装并配置 OpenClaw
+npm i -g openclaw
+openclaw configure         # 设置模型（如 Gemini / OpenAI）
+
+# 2. 启动 Gateway
+openclaw gateway
+
+# 3. 启动桥（另一个终端）
+npx wechat-to-anything --openclaw
+```
+
+> OpenClaw 的 Gateway 需要先配好模型 provider（运行 `openclaw configure`）。
+> 如果 OpenClaw 已有 `openclaw-weixin` 插件，需先禁用以避免消息冲突。
+
+### 首次使用
+
+终端会弹出二维码 → 微信扫码 → 完成。之后自动复用登录凭证。
+
+## 接入你自己的 Agent
+
+暴露 `POST /v1/chat/completions` 即可，任何语言：
+
+```python
+@app.post("/v1/chat/completions")
+def chat(request):
+    message = request.json["messages"][-1]["content"]
+    reply = your_agent(message)
+    return {"choices": [{"message": {"role": "assistant", "content": reply}}]}
+```
+
+然后 `npx wechat-to-anything http://your-agent:8000/v1`。
+
+## 多 Agent 模式
+
+同时接入多个 Agent，通过 `@` 前缀路由消息。支持 OpenAI 兼容格式和 [ACP (Agent Communication Protocol)](https://agentcommunicationprotocol.dev/) 两种协议：
+
+```bash
+npx wechat-to-anything \
+  --agent codex=http://localhost:3001/v1 \
+  --agent gemini=http://localhost:3002/v1 \
+  --agent bee=acp://localhost:8000/chat \
+  --default codex
+```
+
+> `http://` → OpenAI 格式，`acp://` → ACP 协议，自动识别。
+
+微信里使用：
+
+| 消息 | 效果 |
+|---|---|
+| `你好` | 发给默认 Agent |
+| `@codex 写个排序` | 路由到 Codex |
+| `@gemini 审查代码` | 路由到 Gemini |
+| `@bee 分析数据` | 路由到 ACP Agent |
+| `@list` | 查看已注册的 Agent |
+| `@切换 gemini` | 切换默认 Agent |
+
+多 Agent 模式下回复自动带 `[agentName]` 前缀标识来源。每个用户独立维护默认 Agent。
+
+**图片支持**：消息格式遵循 [OpenAI Vision API](https://platform.openai.com/docs/guides/vision)，`content` 为数组：
+
+```json
+{
+  "messages": [{
+    "role": "user",
+    "content": [
+      { "type": "text", "text": "这是什么？" },
+      { "type": "image_url", "image_url": { "url": "data:image/jpeg;base64,..." } }
+    ]
+  }]
+}
+```
+
+**图片回复**：Agent 回复中包含 markdown 图片 `![desc](https://...)` 会自动作为图片消息发到微信。
+
+
+## 凭证
+
+登录凭证保存在 `~/.wechat-to-anything/credentials.json`，删除即可重新登录。
+
+
+
+## Star History
+
+如果这个项目帮到了你，请给个 ⭐ Star，这是对我们最大的支持！
+
+## License
+
+[MIT](LICENSE)

package/bin/cli.mjs

@@ -0,0 +1,120 @@
+#!/usr/bin/env node
+
+import pc from "picocolors";
+
+// 解析命令行参数
+const args = process.argv.slice(2);
+const agents = new Map();
+let defaultAgent = null;
+
+if (args.length === 0 || args[0] === "--help" || args[0] === "-h") {
+  console.log(`
+${pc.cyan("🌉 wechat-to-anything")}
+
+${pc.dim("一条命令，把微信变成任何 AI Agent 的入口")}
+
+${pc.bold("用法:")}
+  ${pc.green("最简单:")}
+  npx wechat-to-anything ${pc.green("--codex")}
+  npx wechat-to-anything ${pc.green("--gemini")}
+  npx wechat-to-anything ${pc.green("--claude")}
+  npx wechat-to-anything ${pc.green("--openclaw")}
+  npx wechat-to-anything ${pc.green("--codex --gemini --claude")}    ${pc.dim("多 Agent")}
+
+  ${pc.green("自定义 Agent:")}
+  npx wechat-to-anything ${pc.green("<agent-url>")}
+  npx wechat-to-anything ${pc.green("--agent name=url --agent name2=url2")}
+
+${pc.bold("参数:")}
+  --codex               ${pc.dim("内置 Codex CLI（需先 npm i -g @openai/codex）")}
+  --gemini              ${pc.dim("内置 Gemini CLI（需先 npm i -g @google/gemini-cli）")}
+  --claude              ${pc.dim("内置 Claude Code CLI（需先 npm i -g @anthropic-ai/claude-code）")}
+  --openclaw            ${pc.dim("内置 OpenClaw（需先 npm i -g openclaw）")}
+  --agent ${pc.dim("name=url")}    ${pc.dim("注册自定义 Agent")}
+  --default ${pc.dim("name")}      ${pc.dim("设置默认 Agent")}
+
+${pc.dim("Docs: https://github.com/kellyvv/wechat-to-anything")}
+`);
+  process.exit(args.length > 0 ? 0 : 1);
+}
+
+// 解析参数
+let i = 0;
+while (i < args.length) {
+  if (args[i] === "--codex") {
+    agents.set("codex", "cli://codex");
+    i++;
+  } else if (args[i] === "--gemini") {
+    agents.set("gemini", "cli://gemini");
+    i++;
+  } else if (args[i] === "--claude") {
+    agents.set("claude", "cli://claude");
+    i++;
+  } else if (args[i] === "--openclaw") {
+    agents.set("openclaw", "cli://openclaw");
+    i++;
+  } else if (args[i] === "--agent" && args[i + 1]) {
+    const [name, ...urlParts] = args[i + 1].split("=");
+    const url = urlParts.join("=");
+    if (!name || !url) {
+      console.error(pc.red(`无效的 --agent 参数: ${args[i + 1]}，格式: name=url`));
+      process.exit(1);
+    }
+    if (!url.startsWith("acp://") && !url.startsWith("cli://")) {
+      try { new URL(url); } catch {
+        console.error(pc.red(`无效的 Agent URL: ${url}`));
+        process.exit(1);
+      }
+    }
+    agents.set(name.toLowerCase(), url);
+    i += 2;
+  } else if (args[i] === "--default" && args[i + 1]) {
+    defaultAgent = args[i + 1].toLowerCase();
+    i += 2;
+  } else if (!args[i].startsWith("--")) {
+    if (!args[i].startsWith("acp://")) {
+      try { new URL(args[i]); } catch {
+        console.error(pc.red(`无效的 URL: ${args[i]}`));
+        process.exit(1);
+      }
+    }
+    agents.set("default", args[i]);
+    defaultAgent = "default";
+    i++;
+  } else {
+    console.error(pc.red(`未知参数: ${args[i]}`));
+    process.exit(1);
+  }
+}
+
+if (agents.size === 0) {
+  console.error(pc.red("至少需要一个 Agent，用 --agent name=url 或直接传 URL"));
+  process.exit(1);
+}
+
+// 默认用第一个注册的 Agent
+if (!defaultAgent) {
+  defaultAgent = agents.keys().next().value;
+}
+
+if (!agents.has(defaultAgent)) {
+  console.error(pc.red(`默认 Agent "${defaultAgent}" 未注册`));
+  process.exit(1);
+}
+
+console.log();
+console.log(pc.cyan("🌉 wechat-to-anything"));
+if (agents.size === 1 && agents.has("default")) {
+  console.log(pc.dim(`   Agent: ${agents.get("default")}`));
+} else {
+  for (const [name, url] of agents) {
+    const isDefault = name === defaultAgent;
+    console.log(pc.dim(`   ${isDefault ? "★" : " "} ${name}: ${url}`));
+  }
+}
+console.log();
+
+import("../cli/bridge.mjs").then((mod) => mod.start(agents, defaultAgent)).catch((err) => {
+  console.error(pc.red(err.message));
+  process.exit(1);
+});

package/cli/agent-adapter.mjs

@@ -0,0 +1,250 @@
+/**
+ * Agent 调用适配器
+ * 
+ * 根据 URL scheme 自动选择协议：
+ * - http:// / https:// → OpenAI 兼容格式
+ * - acp://             → ACP (Agent Communication Protocol)
+ * - cli://codex        → 内置 Codex CLI 适配器
+ * - cli://gemini       → 内置 Gemini CLI 适配器
+ */
+
+import { execFile, spawn } from "node:child_process";
+import { writeFile, readFile, unlink, mkdir } from "node:fs/promises";
+import { join } from "node:path";
+import { tmpdir } from "node:os";
+import { randomBytes } from "node:crypto";
+
+/**
+ * 统一调用接口 — 根据 URL 自动选择适配器
+ */
+export async function callAgentAuto(url, messages) {
+  if (url.startsWith("acp://")) return callACP(url, messages);
+  if (url.startsWith("cli://")) return callCLI(url, messages);
+  return callOpenAI(url, messages);
+}
+
+/**
+ * 验证 Agent 是否可达
+ */
+export async function checkAgent(url) {
+  if (url.startsWith("acp://")) {
+    const { httpUrl } = parseACPUrl(url);
+    const res = await fetch(`${httpUrl}/agents`, { signal: AbortSignal.timeout(5000) });
+    if (!res.ok) throw new Error(`ACP server 不可达: ${res.status}`);
+    return;
+  }
+  if (url.startsWith("cli://")) {
+    const name = url.replace("cli://", "");
+    const cmd = { codex: "codex", gemini: "gemini", claude: "claude", openclaw: "openclaw" }[name] || name;
+    return new Promise((resolve, reject) => {
+      execFile(cmd, ["--version"], { timeout: 5000 }, (err) => {
+        if (err) reject(new Error(`${cmd} CLI 未安装（npm install -g ${{
+          codex: "@openai/codex", gemini: "@google/gemini-cli", claude: "@anthropic-ai/claude-code", openclaw: "openclaw"
+        }[name] || cmd}）`));
+        else resolve();
+      });
+    });
+  }
+  await fetch(url, { signal: AbortSignal.timeout(5000) });
+}
+
+// ========== OpenAI 适配器 ==========
+
+async function callOpenAI(agentUrl, messages) {
+  const res = await fetch(`${agentUrl}/chat/completions`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ messages }),
+    signal: AbortSignal.timeout(300_000),
+  });
+  if (!res.ok) {
+    const text = await res.text();
+    throw new Error(`${res.status}: ${text.slice(0, 200)}`);
+  }
+  const data = await res.json();
+  return data.choices?.[0]?.message?.content || "(empty response)";
+}
+
+// ========== ACP 适配器 ==========
+
+function parseACPUrl(acpUrl) {
+  const withoutScheme = acpUrl.replace(/^acp:\/\//, "");
+  const slashIdx = withoutScheme.indexOf("/");
+  if (slashIdx === -1) throw new Error(`无效的 ACP URL: ${acpUrl}`);
+  return { httpUrl: `http://${withoutScheme.slice(0, slashIdx)}`, agentName: withoutScheme.slice(slashIdx + 1) };
+}
+
+async function callACP(acpUrl, messages) {
+  const { httpUrl, agentName } = parseACPUrl(acpUrl);
+  const input = messages.map((msg) => {
+    if (typeof msg.content === "string") {
+      return { parts: [{ content: msg.content, content_type: "text/plain" }] };
+    }
+    const parts = [];
+    for (const item of msg.content) {
+      if (item.type === "text") parts.push({ content: item.text, content_type: "text/plain" });
+      else if (item.type === "image_url") parts.push({ content: item.image_url.url, content_type: "image/jpeg" });
+    }
+    return { parts };
+  });
+
+  const res = await fetch(`${httpUrl}/agents/${agentName}/run`, {
+    method: "POST",
+    headers: { "Content-Type": "application/json" },
+    body: JSON.stringify({ input }),
+    signal: AbortSignal.timeout(300_000),
+  });
+  if (!res.ok) { const t = await res.text(); throw new Error(`ACP ${res.status}: ${t.slice(0, 200)}`); }
+  const data = await res.json();
+  const texts = [];
+  for (const msg of data.output || []) {
+    for (const part of msg.parts || []) {
+      if (part.content_type === "text/plain" || !part.content_type) texts.push(part.content);
+    }
+  }
+  return texts.join("\n") || "(empty response)";
+}
+
+// ========== 内置 CLI 适配器 ==========
+
+const TMP_DIR = join(tmpdir(), "wechat-cli-agents");
+
+async function callCLI(cliUrl, messages) {
+  const name = cliUrl.replace("cli://", "");
+  const lastMsg = messages[messages.length - 1];
+
+  // 提取文本和图片
+  let prompt = "";
+  const imagePaths = [];
+  const tmpFiles = [];
+
+  if (typeof lastMsg.content === "string") {
+    prompt = lastMsg.content;
+  } else if (Array.isArray(lastMsg.content)) {
+    await mkdir(TMP_DIR, { recursive: true });
+    for (const part of lastMsg.content) {
+      if (part.type === "text") prompt += (prompt ? "\n" : "") + part.text;
+      else if (part.type === "image_url" && part.image_url?.url) {
+        const tmpPath = join(TMP_DIR, `img-${randomBytes(4).toString("hex")}.jpg`);
+        const url = part.image_url.url;
+        if (url.startsWith("data:")) {
+          await writeFile(tmpPath, Buffer.from(url.replace(/^data:[^;]+;base64,/, ""), "base64"));
+        } else {
+          const r = await fetch(url);
+          if (r.ok) await writeFile(tmpPath, Buffer.from(await r.arrayBuffer()));
+        }
+        imagePaths.push(tmpPath);
+        tmpFiles.push(tmpPath);
+      }
+    }
+  }
+
+  if (!prompt && imagePaths.length > 0) prompt = "请描述这张图片";
+  if (!prompt) throw new Error("empty prompt");
+
+  try {
+    if (name === "codex") return await runCodex(prompt, imagePaths);
+    if (name === "gemini") return await runGemini(prompt);
+    if (name === "claude") return await runClaude(prompt);
+    if (name === "openclaw") return await runOpenClaw(prompt);
+    throw new Error(`未知的内置 CLI Agent: ${name}`);
+  } finally {
+    for (const f of tmpFiles) unlink(f).catch(() => {});
+  }
+}
+
+function runCodex(prompt, imagePaths = []) {
+  return new Promise(async (resolve, reject) => {
+    await mkdir(TMP_DIR, { recursive: true });
+    const outFile = join(TMP_DIR, `out-${randomBytes(4).toString("hex")}.txt`);
+    const args = ["exec", "--skip-git-repo-check", "--ephemeral", "-o", outFile];
+    for (const img of imagePaths) args.push("-i", img);
+    args.push("--", prompt);
+
+    execFile("codex", args, { timeout: 300_000, maxBuffer: 2 * 1024 * 1024, cwd: tmpdir() },
+      async (err, stdout, stderr) => {
+        try {
+          const reply = await readFile(outFile, "utf-8").catch(() => "");
+          await unlink(outFile).catch(() => {});
+          if (reply.trim()) resolve(reply.trim());
+          else if (stdout.trim()) resolve(stdout.trim());
+          else if (err) reject(new Error((stderr || err.message).trim().slice(0, 300)));
+          else resolve("(empty response)");
+        } catch (e) { reject(e); }
+      });
+  });
+}
+
+function runGemini(prompt) {
+  return new Promise((resolve, reject) => {
+    const child = spawn("gemini", [], { cwd: tmpdir(), stdio: ["pipe", "pipe", "pipe"], timeout: 300_000 });
+    let stdout = "", stderr = "";
+    child.stdout.on("data", (d) => (stdout += d));
+    child.stderr.on("data", (d) => (stderr += d));
+    child.stdin.write(prompt);
+    child.stdin.end();
+    child.on("close", (code) => {
+      if (stdout.trim()) resolve(stdout.trim());
+      else if (code !== 0) reject(new Error((stderr || `exit code ${code}`).trim().slice(0, 300)));
+      else resolve("(empty response)");
+    });
+    child.on("error", (err) => reject(new Error(`gemini CLI 未安装: ${err.message}`)));
+  });
+}
+
+function runClaude(prompt) {
+  return new Promise((resolve, reject) => {
+    const child = spawn("claude", ["--print", prompt], {
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 300_000,
+    });
+    let stdout = "", stderr = "";
+    child.stdout.on("data", (d) => (stdout += d));
+    child.stderr.on("data", (d) => (stderr += d));
+    child.on("close", (code) => {
+      if (code !== 0) reject(new Error((stderr + stdout).trim().slice(0, 300) || `exit code ${code}`));
+      else resolve(stdout.trim() || "(empty response)");
+    });
+    child.on("error", (err) => reject(new Error(`claude CLI 未安装: ${err.message}`)));
+  });
+}
+
+function runOpenClaw(prompt) {
+  return new Promise((resolve, reject) => {
+    const child = spawn("openclaw", [
+      "agent", "--agent", "main",
+      "--message", prompt, "--json",
+    ], {
+      cwd: tmpdir(),
+      stdio: ["ignore", "pipe", "pipe"],
+      timeout: 300_000,
+    });
+    let stdout = "", stderr = "";
+    child.stdout.on("data", (d) => (stdout += d));
+    child.stderr.on("data", (d) => (stderr += d));
+    child.on("close", (code) => {
+      if (code !== 0) {
+        reject(new Error((stderr + stdout).trim().slice(0, 300) || `exit code ${code}`));
+        return;
+      }
+      try {
+        // OpenClaw stdout 可能含有 [plugins] 日志行在 JSON 之前，跳过
+        const jsonStart = stdout.indexOf("\n{");
+        const raw = jsonStart >= 0 ? stdout.slice(jsonStart + 1) : stdout;
+        const data = JSON.parse(raw);
+        // OpenClaw JSON: { result: { payloads: [{ text: "...", mediaUrl: null }] } }
+        const payloads = data?.result?.payloads;
+        if (Array.isArray(payloads)) {
+          const texts = payloads.map(p => p.text).filter(Boolean);
+          if (texts.length) { resolve(texts.join("\n")); return; }
+        }
+        resolve((data?.summary || data?.reply || data?.text || "").trim() || "(empty response)");
+      } catch {
+        // JSON 解析仍然失败，过滤掉日志行返回纯文本
+        const lines = stdout.split("\n").filter(l => !l.match(/^\d{2}:\d{2}:\d{2} \[/));
+        resolve(lines.join("\n").trim() || "(empty response)");
+      }
+    });
+    child.on("error", (err) => reject(new Error(`openclaw CLI 未安装: ${err.message}`)));
+  });
+}