claude-codex-wechat 0.1.32 → 0.1.33

package/dist/mcp/mediaServer.js

@@ -182,10 +182,24 @@ ${stdout}` }] };
 }
 
 // src/mcp/mediaServer.ts
-var server = new McpServer({
-  name: "wechat-bridge",
-  version: "1.0.0"
-});
+var server = new McpServer(
+  {
+    name: "wechat-bridge",
+    version: "1.0.0"
+  },
+  {
+    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() {

package/dist/server/cli.js

@@ -3258,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()
@@ -3429,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) {
@@ -3555,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) => {
@@ -3663,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 }) })
   ];
 }
 
@@ -4986,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.32",
+  "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);
+}