claude-codex-wechat 0.1.31 → 0.1.33

package/dist/mcp/mediaServer.js

@@ -3,12 +3,11 @@ import { createRequire as __cjsCreateRequire } from 'node:module'; const require
 // src/mcp/mediaServer.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+
+// src/mcp/tools/sendMedia.ts
+import { basename } from "node:path";
 import { z } from "zod";
 var BRIDGE_API_URL = process.env.BRIDGE_API_URL || "http://localhost:8787";
-var server = new McpServer({
-  name: "wechat-media",
-  version: "1.0.0"
-});
 async function sendMedia(kind, filePath, fileName) {
   const response = await fetch(`${BRIDGE_API_URL}/api/channel/send-media`, {
     method: "POST",
@@ -25,67 +24,189 @@ async function sendMedia(kind, filePath, fileName) {
   }
   return "\u53D1\u9001\u6210\u529F";
 }
-server.tool(
-  "send_image",
-  "\u53D1\u9001\u56FE\u7247\u6587\u4EF6\u5230\u5F53\u524D\u5FAE\u4FE1\u5BF9\u8BDD\u3002\u4F20\u5165\u56FE\u7247\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002",
-  { filePath: z.string().describe("\u56FE\u7247\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/image.png") },
-  async ({ filePath }) => {
-    try {
-      const msg = await sendMedia("image", filePath);
-      return { content: [{ type: "text", text: msg }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: e.message }], isError: true };
+function registerSendMediaTools(server2) {
+  server2.registerTool(
+    "send_image",
+    {
+      description: '\u5C06\u56FE\u7247\u53D1\u9001\u5230\u7528\u6237\u5FAE\u4FE1\u3002\u7528\u6237\u8BF4"\u628A\u56FE\u7247\u53D1\u7ED9\u6211""\u628A\u622A\u56FE\u53D1\u51FA\u6765""\u53D1\u5230\u6211\u5FAE\u4FE1"\u65F6\u8C03\u7528\u3002\u4E5F\u9002\u7528\u4E8E\u4F60\u751F\u6210\u4E86\u56FE\u7247/\u56FE\u8868/\u622A\u56FE\u540E\u4E3B\u52A8\u53D1\u9001\u7ED9\u7528\u6237\u3002',
+      inputSchema: { filePath: z.string().describe("\u56FE\u7247\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/image.png") }
+    },
+    async ({ filePath }) => {
+      try {
+        const msg = await sendMedia("image", filePath);
+        return { content: [{ type: "text", text: msg }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: e.message }], isError: true };
+      }
     }
-  }
-);
-server.tool(
-  "send_video",
-  "\u53D1\u9001\u89C6\u9891\u6587\u4EF6\u5230\u5F53\u524D\u5FAE\u4FE1\u5BF9\u8BDD\u3002\u4F20\u5165\u89C6\u9891\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002",
-  { filePath: z.string().describe("\u89C6\u9891\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/video.mp4") },
-  async ({ filePath }) => {
-    try {
-      const msg = await sendMedia("video", filePath);
-      return { content: [{ type: "text", text: msg }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: e.message }], isError: true };
+  );
+  server2.registerTool(
+    "send_video",
+    {
+      description: '\u5C06\u89C6\u9891\u53D1\u9001\u5230\u7528\u6237\u5FAE\u4FE1\u3002\u7528\u6237\u8BF4"\u628A\u89C6\u9891\u53D1\u7ED9\u6211""\u89C6\u9891\u53D1\u51FA\u6765"\u65F6\u8C03\u7528\u3002\u4E0B\u8F7D\u5B8C\u89C6\u9891\u540E\u4E5F\u5E94\u4E3B\u52A8\u8C03\u7528\u6B64\u5DE5\u5177\u53D1\u9001\u3002',
+      inputSchema: { filePath: z.string().describe("\u89C6\u9891\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/video.mp4") }
+    },
+    async ({ filePath }) => {
+      try {
+        const msg = await sendMedia("video", filePath);
+        return { content: [{ type: "text", text: msg }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: e.message }], isError: true };
+      }
     }
-  }
-);
-server.tool(
-  "send_audio",
-  "\u53D1\u9001\u97F3\u9891\u6587\u4EF6\u5230\u5F53\u524D\u5FAE\u4FE1\u5BF9\u8BDD\u3002\u4F20\u5165\u97F3\u9891\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\u3002\u97F3\u9891\u6587\u4EF6\u4EE5\u6587\u4EF6\u9644\u4EF6\u5F62\u5F0F\u53D1\u9001\uFF0C\u7528\u6237\u53EF\u70B9\u51FB\u64AD\u653E\u3002",
-  { filePath: z.string().describe("\u97F3\u9891\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/audio.mp3") },
-  async ({ filePath }) => {
-    try {
-      const fileName = filePath.split("/").pop() || "audio.mp3";
-      const msg = await sendMedia("file", filePath, fileName);
-      return { content: [{ type: "text", text: msg }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: e.message }], isError: true };
+  );
+  server2.registerTool(
+    "send_audio",
+    {
+      description: '\u5C06\u97F3\u9891\u6587\u4EF6\u4EE5\u9644\u4EF6\u5F62\u5F0F\u53D1\u9001\u5230\u7528\u6237\u5FAE\u4FE1\uFF08\u7528\u6237\u53EF\u70B9\u51FB\u64AD\u653E\uFF09\u3002\u7528\u6237\u8BF4"\u628A\u97F3\u9891\u53D1\u7ED9\u6211""\u97F3\u4E50\u53D1\u51FA\u6765"\u65F6\u8C03\u7528\u3002',
+      inputSchema: { filePath: z.string().describe("\u97F3\u9891\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/audio.mp3") }
+    },
+    async ({ filePath }) => {
+      try {
+        const fileName = basename(filePath) || "audio.mp3";
+        const msg = await sendMedia("file", filePath, fileName);
+        return { content: [{ type: "text", text: msg }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: e.message }], isError: true };
+      }
     }
+  );
+  server2.registerTool(
+    "send_file",
+    {
+      description: '\u5C06\u6587\u4EF6\u53D1\u9001\u5230\u7528\u6237\u5FAE\u4FE1\u3002\u7528\u6237\u8BF4"\u628A\u6587\u4EF6\u53D1\u7ED9\u6211""\u6587\u6863\u53D1\u51FA\u6765""\u628AXX\u4F20\u7ED9\u6211"\u65F6\u8C03\u7528\u3002\u652F\u6301 PDF\u3001\u6587\u6863\u3001\u4EE3\u7801\u3001\u538B\u7F29\u5305\u7B49\u6240\u6709\u7C7B\u578B\u3002',
+      inputSchema: {
+        filePath: z.string().describe("\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/document.pdf"),
+        fileName: z.string().optional().describe("\u663E\u793A\u7ED9\u7528\u6237\u7684\u6587\u4EF6\u540D\uFF08\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u539F\u6587\u4EF6\u540D\uFF09")
+      }
+    },
+    async ({ filePath, fileName }) => {
+      try {
+        const msg = await sendMedia("file", filePath, fileName);
+        return { content: [{ type: "text", text: msg }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: e.message }], isError: true };
+      }
+    }
+  );
+}
+
+// src/mcp/tools/douyinDownload.ts
+import { execFile } from "node:child_process";
+import { existsSync } from "node:fs";
+import { resolve, dirname, join, basename as basename2 } from "node:path";
+import { homedir } from "node:os";
+import { fileURLToPath } from "node:url";
+import { z as z2 } from "zod";
+var BRIDGE_API_URL2 = process.env.BRIDGE_API_URL || "http://localhost:8787";
+function findDouyinScript() {
+  const here = dirname(fileURLToPath(import.meta.url));
+  const candidates = [
+    // Bundled with project (primary)
+    join(here, "..", "scripts", "douyin-download.mjs"),
+    // Built output
+    join(here, "..", "..", "mcp", "scripts", "douyin-download.mjs"),
+    // User skills locations (cross-platform)
+    join(homedir(), ".agents", "skills", "douyin-download", "scripts", "douyin-download.mjs"),
+    join(homedir(), ".claude", "skills", "douyin-download", "scripts", "douyin-download.mjs")
+  ];
+  for (const p of candidates) {
+    const resolved = resolve(p);
+    if (existsSync(resolved)) return resolved;
   }
-);
-server.tool(
-  "send_file",
-  "\u53D1\u9001\u6587\u4EF6\u5230\u5F53\u524D\u5FAE\u4FE1\u5BF9\u8BDD\u3002\u4F20\u5165\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\u548C\u53EF\u9009\u7684\u663E\u793A\u6587\u4EF6\u540D\u3002",
+  throw new Error("douyin-download \u811A\u672C\u672A\u627E\u5230");
+}
+function runScript(args) {
+  const script = findDouyinScript();
+  return new Promise((resolve2, reject) => {
+    execFile("node", [script, ...args], { timeout: 12e4 }, (err, stdout, stderr) => {
+      if (err) reject(new Error(stderr || err.message));
+      else resolve2({ stdout, stderr });
+    });
+  });
+}
+async function sendToWechat(filePath, kind) {
+  const fileName = basename2(filePath) || "video.mp4";
+  const response = await fetch(`${BRIDGE_API_URL2}/api/channel/send-media`, {
+    method: "POST",
+    headers: { "content-type": "application/json" },
+    body: JSON.stringify({ kind, filePath, fileName })
+  });
+  if (!response.ok) {
+    const text = await response.text();
+    throw new Error(`\u53D1\u9001\u5931\u8D25 (HTTP ${response.status}): ${text}`);
+  }
+  const result = await response.json();
+  if (!result.ok) throw new Error(`\u53D1\u9001\u5931\u8D25: ${result.error ?? "\u672A\u77E5\u9519\u8BEF"}`);
+  return "\u53D1\u9001\u6210\u529F";
+}
+function registerDouyinTools(server2) {
+  server2.registerTool(
+    "download_douyin",
+    {
+      description: "\u5F53\u7528\u6237\u53D1\u6765\u6296\u97F3\u94FE\u63A5\u3001\u5206\u4EAB\u6587\u6848\u6216\u63D0\u5230\u8981\u4E0B\u8F7D\u6296\u97F3\u89C6\u9891\u65F6\uFF0C\u7ACB\u5373\u8C03\u7528\u6B64\u5DE5\u5177\u3002\u81EA\u52A8\u4E0B\u8F7D\u65E0\u6C34\u5370\u9AD8\u6E05\u89C6\u9891\u5E76\u53D1\u9001\u5230\u7528\u6237\u5FAE\u4FE1\u3002\u652F\u6301\uFF1A\u77ED\u94FE(v.douyin.com)\u3001\u5B8C\u6574\u94FE\u63A5(douyin.com/video/xxx)\u3001\u5206\u4EAB\u6587\u6848\uFF08\u81EA\u52A8\u63D0\u53D6\u94FE\u63A5\uFF09\u3001\u7EAF aweme_id\u3002\u9ED8\u8BA4\u4E0B\u8F7D\u540E\u76F4\u63A5\u53D1\u9001\uFF0C\u65E0\u9700\u989D\u5916\u64CD\u4F5C\u3002",
+      inputSchema: {
+        url: z2.string().describe("\u6296\u97F3\u94FE\u63A5\u3001\u5206\u4EAB\u6587\u6848\u6216 aweme_id"),
+        outputDir: z2.string().optional().describe("\u4FDD\u5B58\u76EE\u5F55\uFF08\u53EF\u9009\uFF0C\u9ED8\u8BA4 ~/Downloads\uFF09"),
+        sendToWechat: z2.boolean().optional().describe("\u4E0B\u8F7D\u540E\u662F\u5426\u76F4\u63A5\u53D1\u9001\u5230\u5F53\u524D\u5FAE\u4FE1\u5BF9\u8BDD\uFF08\u9ED8\u8BA4 true\uFF09")
+      }
+    },
+    async ({ url, outputDir, sendToWechat: shouldSend }) => {
+      try {
+        const args = [url];
+        if (outputDir) args.push("--output", outputDir);
+        else args.push("--output", join(homedir(), "Downloads"));
+        const { stdout } = await runScript(args);
+        const pathMatch = stdout.match(/(?:已保存|保存到|saved to|文件路径)[：:]\s*(.+?\.mp4)/i) || stdout.match(/(\/[^\s]+\.mp4)/);
+        const filePath = pathMatch?.[1]?.trim();
+        if (!filePath || !existsSync(filePath)) {
+          return { content: [{ type: "text", text: `\u4E0B\u8F7D\u5B8C\u6210\u4F46\u672A\u627E\u5230\u6587\u4EF6\u8DEF\u5F84\u3002\u811A\u672C\u8F93\u51FA:
+${stdout}` }] };
+        }
+        if (shouldSend !== false) {
+          try {
+            await sendToWechat(filePath, "video");
+            return { content: [{ type: "text", text: `\u89C6\u9891\u5DF2\u4E0B\u8F7D\u5E76\u53D1\u9001\u5230\u5FAE\u4FE1\u3002
+\u6587\u4EF6\u8DEF\u5F84: ${filePath}` }] };
+          } catch (sendErr) {
+            return { content: [{ type: "text", text: `\u89C6\u9891\u5DF2\u4E0B\u8F7D\u5230 ${filePath}\uFF0C\u4F46\u53D1\u9001\u5230\u5FAE\u4FE1\u5931\u8D25: ${sendErr.message}` }] };
+          }
+        }
+        return { content: [{ type: "text", text: `\u89C6\u9891\u5DF2\u4E0B\u8F7D\u3002
+\u6587\u4EF6\u8DEF\u5F84: ${filePath}` }] };
+      } catch (e) {
+        return { content: [{ type: "text", text: `\u4E0B\u8F7D\u5931\u8D25: ${e.message}` }], isError: true };
+      }
+    }
+  );
+}
+
+// src/mcp/mediaServer.ts
+var server = new McpServer(
   {
-    filePath: z.string().describe("\u6587\u4EF6\u7684\u7EDD\u5BF9\u8DEF\u5F84\uFF0C\u5982 /path/to/document.pdf"),
-    fileName: z.string().optional().describe("\u663E\u793A\u7ED9\u7528\u6237\u7684\u6587\u4EF6\u540D\uFF08\u53EF\u9009\uFF0C\u9ED8\u8BA4\u4F7F\u7528\u539F\u6587\u4EF6\u540D\uFF09")
+    name: "wechat-bridge",
+    version: "1.0.0"
   },
-  async ({ filePath, fileName }) => {
-    try {
-      const msg = await sendMedia("file", filePath, fileName);
-      return { content: [{ type: "text", text: msg }] };
-    } catch (e) {
-      return { content: [{ type: "text", text: e.message }], isError: true };
-    }
+  {
+    instructions: [
+      "\u4F60\u6B63\u8FD0\u884C\u5728\u4E00\u4E2A\u5FAE\u4FE1\u6865\u63A5\u73AF\u5883\u4E2D\uFF0C\u7528\u6237\u901A\u8FC7\u5FAE\u4FE1\u4E0E\u4F60\u5BF9\u8BDD\u3002",
+      '\u7528\u6237\u8BF4\u7684"\u53D1\u7ED9\u6211""\u53D1\u5230\u5FAE\u4FE1""\u53D1\u51FA\u6765""\u4F20\u7ED9\u6211"\u90FD\u662F\u6307\u901A\u8FC7\u672C\u670D\u52A1\u5668\u7684\u5DE5\u5177\u53D1\u9001\u6587\u4EF6\u5230\u7528\u6237\u5FAE\u4FE1\u3002',
+      "",
+      "\u5173\u952E\u884C\u4E3A\uFF1A",
+      "- \u5F53\u7528\u6237\u53D1\u6765\u6296\u97F3\u94FE\u63A5\u6216\u5206\u4EAB\u6587\u6848\u65F6\uFF0C\u7ACB\u5373\u8C03\u7528 download_douyin \u4E0B\u8F7D\u5E76\u53D1\u9001\uFF0C\u65E0\u9700\u8BE2\u95EE\u3002",
+      '- \u5F53\u7528\u6237\u8BF4"\u628AXX\u53D1\u7ED9\u6211"\u65F6\uFF0C\u6839\u636E\u6587\u4EF6\u7C7B\u578B\u8C03\u7528 send_image/send_video/send_file\u3002',
+      '- \u751F\u6210\u4E86\u6587\u4EF6\u540E\u7528\u6237\u8BF4"\u53D1\u7ED9\u6211"\uFF0C\u76F4\u63A5\u8C03\u7528\u5BF9\u5E94\u5DE5\u5177\u53D1\u9001\u3002',
+      "- \u5B8C\u6210\u540E\u7B80\u77ED\u786E\u8BA4\u5373\u53EF\uFF0C\u4E0D\u9700\u8981\u5197\u957F\u89E3\u91CA\u3002"
+    ].join("\n")
   }
 );
+registerSendMediaTools(server);
+registerDouyinTools(server);
 async function main() {
   const transport = new StdioServerTransport();
   await server.connect(transport);
 }
 main().catch((err) => {
-  console.error("[wechat-media-mcp] fatal:", err);
+  console.error("[wechat-bridge-mcp] fatal:", err);
   process.exit(1);
 });

package/dist/server/cli.js

@@ -2916,10 +2916,37 @@ function mapChoiceReply(text, labels, multiSelect) {
 
 // src/providers/claude-code/bridgeSystemPrompt.ts
 var BRIDGE_APPEND_SYSTEM_PROMPT = [
-  "\u4F60\u6B63\u8FD0\u884C\u5728\u4E00\u4E2A\u5FAE\u4FE1\u7EAF\u6587\u672C\u6865\u63A5\u73AF\u5883\u4E2D,\u7528\u6237\u53EA\u80FD\u6536\u53D1\u6587\u672C\u6D88\u606F,\u6CA1\u6709\u4EFB\u4F55\u4EA4\u4E92\u5F0F\u5F39\u7A97\u6216\u6309\u94AE\u3002",
-  "\u5F53\u4F60\u9700\u8981\u7528\u6237\u505A\u9009\u62E9\u65F6,\u8BF7\u76F4\u63A5\u5728\u56DE\u590D\u91CC\u7528\u5E26\u5E8F\u53F7\u7684\u5217\u8868\u5217\u51FA\u9009\u9879(\u4F8B\u5982\u300C1. \u9009\u9879A\u300D\u300C2. \u9009\u9879B\u300D),",
-  "\u5E76\u544A\u8BC9\u7528\u6237\u56DE\u590D\u5E8F\u53F7\u6216\u9009\u9879\u6587\u5B57\u5373\u53EF;\u4E0D\u8981\u8C03\u7528 AskUserQuestion \u5DE5\u5177(\u5B83\u5728\u6B64\u73AF\u5883\u4E2D\u65E0\u6CD5\u4EA4\u4E92)\u3002"
-].join("");
+  "\u4F60\u6B63\u8FD0\u884C\u5728\u4E00\u4E2A\u5FAE\u4FE1\u6865\u63A5\u73AF\u5883\u4E2D\uFF0C\u7528\u6237\u901A\u8FC7\u5FAE\u4FE1\u4E0E\u4F60\u5BF9\u8BDD\u3002\u4F60\u5177\u5907\u5411\u7528\u6237\u5FAE\u4FE1\u76F4\u63A5\u53D1\u9001\u6587\u4EF6\u7684\u80FD\u529B\u3002",
+  "",
+  "## \u73AF\u5883\u8BF4\u660E",
+  "- \u4F60\u4E0E\u7528\u6237\u4E4B\u95F4\u901A\u8FC7\u5FAE\u4FE1\u8FDE\u63A5\uFF0C\u7528\u6237\u770B\u5230\u7684\u662F\u5FAE\u4FE1\u804A\u5929\u754C\u9762\u3002",
+  '- \u7528\u6237\u8BF4\u7684"\u53D1\u7ED9\u6211""\u53D1\u5230\u5FAE\u4FE1""\u53D1\u51FA\u6765""\u4F20\u7ED9\u6211"\u7B49\u90FD\u662F\u6307\uFF1A\u901A\u8FC7 MCP \u5DE5\u5177\u628A\u6587\u4EF6\u53D1\u9001\u5230\u7528\u6237\u7684\u5FAE\u4FE1\u3002',
+  "- \u6CA1\u6709\u4EA4\u4E92\u5F0F\u5F39\u7A97\u6216\u6309\u94AE\uFF0C\u9700\u8981\u7528\u6237\u505A\u9009\u62E9\u65F6\u7528\u5E8F\u53F7\u5217\u8868\u3002",
+  "- \u4E0D\u8981\u8C03\u7528 AskUserQuestion \u5DE5\u5177\uFF08\u6B64\u73AF\u5883\u65E0\u6CD5\u4EA4\u4E92\uFF09\u3002",
+  "",
+  "## \u6838\u5FC3\u80FD\u529B",
+  "",
+  "### 1. \u53D1\u9001\u6587\u4EF6\u5230\u7528\u6237\u5FAE\u4FE1",
+  '\u5F53\u7528\u6237\u8BF4"\u628AXX\u53D1\u7ED9\u6211""\u628A\u6587\u4EF6\u53D1\u51FA\u6765""\u53D1\u5230\u6211\u5FAE\u4FE1""\u751F\u6210\u4E00\u4E2AXX\u53D1\u7ED9\u6211"\u7B49\uFF0C',
+  "\u90FD\u662F\u8981\u4F60\u901A\u8FC7 MCP \u5DE5\u5177\u53D1\u9001\u5230\u4ED6\u7684\u5FAE\u4FE1\uFF1A",
+  "- \u56FE\u7247 \u2192 send_image",
+  "- \u89C6\u9891 \u2192 send_video",
+  "- \u97F3\u9891 \u2192 send_audio\uFF08\u4EE5\u6587\u4EF6\u9644\u4EF6\u5F62\u5F0F\u53D1\u9001\uFF09",
+  "- \u5176\u4ED6\u6587\u4EF6\uFF08PDF/\u6587\u6863/\u4EE3\u7801/\u538B\u7F29\u5305\u7B49\uFF09\u2192 send_file",
+  "",
+  "### 2. \u6296\u97F3\u89C6\u9891\u4E0B\u8F7D",
+  "\u5F53\u7528\u6237\u53D1\u6765\u5305\u542B\u6296\u97F3\u94FE\u63A5\uFF08v.douyin.com\u3001douyin.com\uFF09\u7684\u6D88\u606F\uFF0C\u6216\u8005\u5206\u4EAB\u6587\u6848\u4E2D\u542B\u6709\u6296\u97F3\u94FE\u63A5\u65F6\uFF1A",
+  "- \u7B2C\u4E00\u65F6\u95F4\u8C03\u7528 download_douyin \u4E0B\u8F7D\u65E0\u6C34\u5370\u89C6\u9891\u5E76\u81EA\u52A8\u53D1\u9001\u5230\u7528\u6237\u5FAE\u4FE1",
+  "- \u65E0\u9700\u8BE2\u95EE\u7528\u6237\u662F\u5426\u8981\u4E0B\u8F7D\uFF0C\u76F4\u63A5\u6267\u884C",
+  "- \u652F\u6301\u77ED\u94FE\u3001\u5B8C\u6574\u94FE\u63A5\u3001\u5206\u4EAB\u6587\u6848\u3001\u7EAF aweme_id",
+  "",
+  "## \u884C\u4E3A\u51C6\u5219",
+  '- \u7528\u6237\u7684"\u6211"\u5C31\u662F\u4ED6\u7684\u5FAE\u4FE1\uFF0C"\u53D1\u7ED9\u6211"\u5C31\u662F\u53D1\u5230\u5FAE\u4FE1\u3002',
+  "- \u8BC6\u522B\u5230\u6296\u97F3\u94FE\u63A5\u65F6\u7ACB\u5373\u4E0B\u8F7D\u5E76\u53D1\u9001\uFF0C\u4E0D\u8981\u8BE2\u95EE\u3002",
+  '- \u6267\u884C\u5B8C\u6210\u540E\u7B80\u77ED\u786E\u8BA4\uFF08\u5982"\u5DF2\u53D1\u9001"\uFF09\uFF0C\u4E0D\u9700\u8981\u5197\u957F\u89E3\u91CA\u3002',
+  "- \u5982\u679C\u53D1\u9001\u5931\u8D25\uFF0C\u544A\u77E5\u539F\u56E0\u5E76\u7ED9\u51FA\u6587\u4EF6\u672C\u5730\u8DEF\u5F84\uFF0C\u8BA9\u7528\u6237\u53EF\u624B\u52A8\u83B7\u53D6\u3002",
+  '- \u5F53\u4F60\u751F\u6210\u4E86\u6587\u4EF6\uFF08\u56FE\u8868\u3001\u4EE3\u7801\u6587\u4EF6\u3001\u6587\u6863\u7B49\uFF09\uFF0C\u7528\u6237\u8BF4"\u53D1\u7ED9\u6211"\u65F6\u76F4\u63A5\u8C03\u7528\u5BF9\u5E94\u5DE5\u5177\u53D1\u9001\u3002'
+].join("\n");
 
 // src/providers/claude-code/claudeCapabilities.ts
 import { spawn as spawn2 } from "node:child_process";
@@ -3231,7 +3258,7 @@ var CodexAppServerClient = class {
   buffer = "";
   constructor(input) {
     const command = input.command ?? "codex";
-    this.child = spawn4(command, ["app-server", "--listen", "stdio://", ...input.mcpServerConfigs ?? []], {
+    this.child = spawn4(command, ["app-server", "--listen", "stdio://"], {
       cwd: input.cwd,
       stdio: ["pipe", "pipe", "pipe"],
       shell: useShellForCli()
@@ -3402,10 +3429,8 @@ var CodexInteractiveRunner = class {
   sessions = /* @__PURE__ */ new Map();
   command;
   syncThreadForResume;
-  mcpServerConfigs;
   constructor(input = {}) {
     this.command = input.command;
-    this.mcpServerConfigs = input.mcpServerConfigs;
     this.syncThreadForResume = input.syncThreadForResume ?? syncCodexThreadForResume;
   }
   async startSession(input) {
@@ -3528,8 +3553,7 @@ var CodexInteractiveRunner = class {
     if (session.client) return session.client;
     const client = new CodexAppServerClient({
       command: this.command,
-      cwd: session.cwd,
-      ...this.mcpServerConfigs?.length ? { mcpServerConfigs: this.mcpServerConfigs } : {}
+      cwd: session.cwd
     });
     await client.initialize();
     client.onNotification("item/agentMessage/delta", (params) => {
@@ -3636,7 +3660,7 @@ var CodexProvider = class {
 function createDefaultProviders(input = {}) {
   return [
     new ClaudeCodeProvider({ runner: new ClaudeStreamingRunner({ command: input.claudeCommand, mcpConfigPath: input.mcpConfigPath }) }),
-    new CodexProvider({ runner: new CodexInteractiveRunner({ command: input.codexCommand, mcpServerConfigs: input.codexMcpServerConfigs }) })
+    new CodexProvider({ runner: new CodexInteractiveRunner({ command: input.codexCommand }) })
   ];
 }
 
@@ -4959,20 +4983,10 @@ function createDaemonServer(options = {}) {
       }
     }
   }, null, 2) + "\n");
-  const codexMcpScript = useTs ? mcpMediaServerTs : mcpMediaServerJs;
-  const codexMcpServerConfigs = [
-    "-c",
-    `mcp_servers.wechat-media.command="${mcpCommand}"`,
-    "-c",
-    `mcp_servers.wechat-media.args=["${codexMcpScript}"]`,
-    "-c",
-    `mcp_servers.wechat-media.env.BRIDGE_API_URL="http://localhost:${bridgePort}"`
-  ];
   const providerAdapters = options.providers ?? createDefaultProviders({
     claudeCommand: options.providerCommands?.claude?.command,
     codexCommand: options.providerCommands?.codex?.command,
-    mcpConfigPath,
-    codexMcpServerConfigs
+    mcpConfigPath
   });
   let currentConversation = conversation.getCurrent();
   if (currentConversation) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-codex-wechat",
-  "version": "0.1.31",
+  "version": "0.1.33",
   "private": false,
   "type": "module",
   "packageManager": "pnpm@11.5.0",
@@ -14,7 +14,8 @@
   "files": [
     "dist",
     "README.md",
-    "config.example.json"
+    "config.example.json",
+    "scripts/postinstall-codex-mcp.mjs"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org/",
@@ -35,7 +36,8 @@
     "relay:start": "pnpm --dir relay-server start",
     "relay:test": "pnpm --dir relay-server test",
     "prepublishOnly": "npm run build",
-    "postpublish": "node scripts/sync-mirror.mjs"
+    "postpublish": "node scripts/sync-mirror.mjs",
+    "postinstall": "node scripts/postinstall-codex-mcp.mjs"
   },
   "dependencies": {
     "@fastify/static": "^9.1.3",

package/scripts/README.md

@@ -0,0 +1,155 @@
+# Scripts Overview
+
+`scripts/` 里的脚本分成两类：**正式使用入口** 和 **诊断 / 验收工具**。
+
+## 正式使用入口
+
+### `recover-weixin-runtime.sh`
+
+最推荐的恢复入口。
+
+作用：
+
+- 拉微信扫码登录二维码
+- 等待扫码确认
+- 自动写出凭据文件
+- 直接拉起最新 bridge runtime
+
+适用场景：
+
+- 微信 token 失效后恢复使用
+- 个人日常重新授权
+
+注意：
+
+- 这个脚本会同时生成运行时凭据
+- 默认会写到 `/tmp/bridge-weixin-credentials.json` 和 `/tmp/bridge-weixin.env`
+- 扫码确认成功后，也会自动回写 `~/.claude-codex-wechat/config.json`
+
+### `weixin-login-helper.ts`
+
+微信扫码登录辅助工具。
+
+作用：
+
+- 生成并自动打开二维码 SVG
+- 轮询扫码状态
+- 自动续刷过期二维码
+- 写出：
+  - `/tmp/bridge-weixin-login-state.json`
+  - `/tmp/bridge-weixin-credentials.json`
+  - `/tmp/bridge-weixin.env`
+
+适用场景：
+
+- 只想先拿新 token，不想立刻起 runtime
+- 需要观察扫码状态
+
+### `start-runtime-check.sh`
+
+带快照输出的 runtime 启动脚本。
+
+作用：
+
+- 自动加载 helper 生成的微信凭据
+- 启动最新 runtime
+- 打印启动后的关键 API 状态
+
+适用场景：
+
+- 扫码确认后单独启动最新实例
+- 联调时确认新凭据是否真正生效
+
+## 诊断 / 验收工具
+
+### `check-runtime-readiness.sh`
+
+检查最新 runtime 是否真的就绪。
+
+重点输出：
+
+- `weixin_connected`
+- `weixin_status`
+- `weixin_last_error`
+- `claude_history_ready_count`
+- `codex_title_ready_count`
+
+### `check-runtime-recovery.sh`
+
+查看 bridge 会话的恢复字段。
+
+重点输出：
+
+- `resumeTitle`
+- `preferredResumeCommand`
+- `providerResumeTitleSynced`
+- `providerResumeHistorySynced`
+- `providerNativePath`
+
+### `check-weixin-updates.ts`
+
+直连微信官方 `getupdates` 的底层探针。
+
+作用：
+
+- 判断 token / session 是否健康
+- 区分“bridge 问题”和“微信上游问题”
+
+### `check-codex-wechat-flow.sh`
+
+Codex 专项闭环验收脚本。
+
+作用：
+
+- 等待新的 Codex bridge session 出现
+- 打印该会话的恢复字段
+- 自动试跑推荐的 Codex resume 命令
+
+## 建议用法
+
+### 日常恢复
+
+```bash
+bash ./scripts/recover-weixin-runtime.sh
+```
+
+如果你要直接做 Codex 专项恢复实验：
+
+```bash
+BRIDGE_DEFAULT_PROVIDER=codex bash ./scripts/recover-weixin-runtime.sh
+```
+
+### 手动分步恢复
+
+```bash
+pnpm tsx scripts/weixin-login-helper.ts
+bash ./scripts/start-runtime-check.sh
+```
+
+如果你只是想先让默认 `pnpm dev` 也读到正式配置，先准备配置文件：
+
+```bash
+mkdir -p ~/.claude-codex-wechat
+cp config.example.json ~/.claude-codex-wechat/config.json
+```
+
+同样也可以：
+
+```bash
+BRIDGE_DEFAULT_PROVIDER=codex bash ./scripts/start-runtime-check.sh
+```
+
+### 排障
+
+```bash
+BRIDGE_PORT=8788 bash ./scripts/check-runtime-readiness.sh
+BRIDGE_PORT=8788 bash ./scripts/check-runtime-recovery.sh
+BRIDGE_WECHAT_TOKEN='...' pnpm tsx scripts/check-weixin-updates.ts
+```
+
+### Codex 专项验收
+
+```bash
+BRIDGE_DEFAULT_PROVIDER=codex bash ./scripts/recover-weixin-runtime.sh
+BRIDGE_PORT=8788 WAIT_SECONDS=120 bash ./scripts/check-codex-wechat-flow.sh
+```

package/scripts/postinstall-codex-mcp.mjs

@@ -0,0 +1,39 @@
+#!/usr/bin/env node
+
+/**
+ * Postinstall script: register wechat-media MCP server to Codex globally.
+ * Runs after `npm install -g claude-codex-wechat`.
+ * Idempotent — safe to run multiple times.
+ * Silently skips if `codex` is not installed.
+ */
+
+import { execSync } from 'node:child_process';
+import { dirname, join } from 'node:path';
+import { fileURLToPath } from 'node:url';
+
+const here = dirname(fileURLToPath(import.meta.url));
+const mediaServerPath = join(here, '..', 'dist', 'mcp', 'mediaServer.js');
+
+try {
+  // Check if codex is available
+  execSync('codex --version', { stdio: 'ignore' });
+} catch {
+  // codex not installed, skip silently
+  process.exit(0);
+}
+
+try {
+  // Remove existing (idempotent)
+  execSync('codex mcp remove wechat-media', { stdio: 'ignore' });
+} catch {
+  // didn't exist, fine
+}
+
+try {
+  execSync(
+    `codex mcp add wechat-media --env "BRIDGE_API_URL=http://localhost:8787" -- node "${mediaServerPath}"`,
+    { stdio: 'inherit' },
+  );
+} catch (e) {
+  console.warn('[claude-codex-wechat] Failed to register Codex MCP server:', e.message);
+}