@vrs-soft/wecom-aibot-mcp 2.3.2 → 2.4.0

package/README.md

@@ -4,34 +4,62 @@
 
 企业微信智能机器人 MCP 服务 - 让 Claude Code 通过微信远程审批和交互。
 
-## 功能
-
+**核心功能**：
 - 远程审批敏感操作（Bash/Write/Edit），微信卡片一键通过/拒绝
 - 离开电脑后通过微信下达任务，实时接收进度通知
-- 支持 Channel 模式（SSE 推送唤醒）和 HTTP 模式（心跳轮询）
-- 支持群聊 @机器人，自动回复到对应会话
-- 支持多机器人、多用户
+- 支持群聊 @机器人，多机器人、多用户并发
+- 代理企业微信文档 MCP，支持文档和智能表格操作
+
+---
+
+## 前置条件
+
+企业微信管理后台创建智能机器人，连接方式选「使用长连接」，记录 **Bot ID** 和 **Secret**。
+
+---
 
 ## 安装
 
 ```bash
-npx @vrs-soft/wecom-aibot-mcp
+npx @vrs-soft/wecom-aibot-mcp --setup
 ```
 
-首次运行进入配置向导，完成后自动启动服务并写入 Claude Code MCP 配置。
+根据部署角色选择参数：
 
-**前置条件**：企业微信管理后台创建智能机器人，连接方式选「使用长连接」，记录 Bot ID 和 Secret。
+| 命令 | 角色 | 说明 |
+|------|------|------|
+| `--setup` | 交互式 | 询问本地 / 远程，自动引导 |
+| `--setup --server` | 服务器端 | 配置机器人 + Token，不写本机 MCP 配置 |
+| `--setup --channel` | Channel 客户端 | 连接远程 Server，写入 Channel MCP |
+| `--setup --server --channel` | 本地完整 | HTTP + Channel 全安装 |
 
-## 启动服务
+**Server 端安装后启动**：
 
 ```bash
-# 后台启动（常用）
-npx @vrs-soft/wecom-aibot-mcp --start
+npx @vrs-soft/wecom-aibot-mcp --http-only --start
+```
+
+**后台启动 / 停止（本地或 Server 端）**：
 
-# Channel 模式（需 claude.ai 直连账号）
-claude --dangerously-load-development-channels server:wecom-aibot-channel
+```bash
+npx @vrs-soft/wecom-aibot-mcp --start   # 后台启动
+npx @vrs-soft/wecom-aibot-mcp --stop    # 停止
 ```
 
+---
+
+## 运行模式对比
+
+| | Channel 模式 | HTTP 模式 |
+|-|-------------|----------|
+| 消息接收 | SSE 自动推送唤醒 | `/loop` 心跳轮询 |
+| 响应延迟 | 即时 | ≤1 分钟 |
+| 账号要求 | claude.ai 直连 | 任意（含 API 中转）|
+
+使用微信模式时告诉 Claude「**现在开始通过微信联系**」，会自动触发 `headless-mode` skill。
+
+---
+
 ## 常用命令
 
 | 命令 | 说明 |
@@ -40,60 +68,37 @@ claude --dangerously-load-development-channels server:wecom-aibot-channel
 | `--status` | 查看服务状态和机器人列表 |
 | `--config` | 修改默认机器人配置 |
 | `--add / --delete` | 添加/删除机器人 |
+| `--set-token [token]` | 设置 Auth Token（远程部署用） |
+| `--set-token --clear` | 清除 Auth Token |
 | `--debug` | 前台启动，输出调试日志 |
+| `--http-only` | 仅启动 HTTP MCP Server（服务器端用） |
+| `--channel-only` | 仅配置 Channel MCP（需 `MCP_URL` 环境变量） |
 | `--clean-cache` | 清空 CC 注册表缓存 |
 | `--upgrade` | 强制升级全局配置 |
 | `--uninstall` | 完全卸载 |
 
-## 运行模式
-
-| | Channel 模式 | HTTP 模式 |
-|-|-------------|----------|
-| 消息接收 | SSE 自动推送唤醒 | `/loop` 心跳轮询 |
-| 响应延迟 | 即时 | ≤1 分钟 |
-| 账号要求 | claude.ai 直连 | 任意（含 API 中转）|
-
-使用微信模式时告诉 Claude「现在开始通过微信联系」，会自动触发 `headless-mode` skill。
-
-## 配置说明
-
-机器人配置保存在 `~/.wecom-aibot-mcp/`，支持多个机器人并发：
-
-```bash
-npx @vrs-soft/wecom-aibot-mcp --add   # 添加机器人
-npx @vrs-soft/wecom-aibot-mcp --status # 查看占用情况
-```
-
 超时自动审批（默认 10 分钟）：在机器人配置中设置 `"autoApproveTimeout": 600`。
 
+---
+
 ## 故障排查
 
 ```bash
-# 检查服务
+# 检查服务是否运行
 curl http://127.0.0.1:18963/health
 
 # Channel 不可用（"Channels are not currently available"）
 # → 使用 API Key 或中转服务，改用 HTTP 模式
 
 # 端口占用
-lsof -i :18963 | grep LISTEN   # 找到 PID
+lsof -i :18963 | grep LISTEN
 kill <PID>
 
-# 清理断线残留
+# 清理断线残留的 ccId 注册
 npx @vrs-soft/wecom-aibot-mcp --clean-cache
 ```
 
-## 拆分部署
-
-HTTP MCP 跑在远程服务器，Channel 代理跑在本地：
-
-```bash
-# 远程服务器
-npx @vrs-soft/wecom-aibot-mcp --http-only --start
-
-# 本地
-MCP_URL=http://远程IP:18963 npx @vrs-soft/wecom-aibot-mcp --channel-only
-```
+---
 
 ## License
 

package/dist/bin.js

@@ -13,7 +13,7 @@ import { spawn } from 'child_process';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
-import { runConfigWizard, loadConfig, saveConfig, deleteRobotConfigInteractive, uninstall, addMcpConfig, detectUserIdFromMessage, ensureHookInstalled, listAllRobots, ensureGlobalConfigs, } from './config-wizard.js';
+import { runConfigWizard, loadConfig, saveConfig, deleteRobotConfigInteractive, uninstall, addMcpConfig, detectUserIdFromMessage, ensureHookInstalled, listAllRobots, ensureGlobalConfigs, getAuthToken, setAuthToken, updateMcpAuthHeaders, runRemoteInstallWizard, VERSION, } from './config-wizard.js';
 import { initClient } from './client.js';
 import { registerTools } from './tools/index.js';
 import { startHttpServer, stopHttpServer, HTTP_PORT } from './http-server.js';
@@ -22,7 +22,6 @@ import { getAllConnectionStates } from './connection-manager.js';
 import { loadStats, cleanupOldLogs } from './connection-log.js';
 import { startKeepaliveMonitor, stopKeepaliveMonitor } from './keepalive-monitor.js';
 import { logger } from './logger.js';
-const VERSION = '2.0.0';
 const PID_FILE = path.join(os.homedir(), '.wecom-aibot-mcp', 'server.pid');
 function showHelp() {
     console.log(`
@@ -37,6 +36,10 @@ function showHelp() {
 选项:
   --help, -h      显示帮助信息
   --version, -v   显示版本号
+  --setup         安装向导（交互式，询问本地 / 远程）
+  --setup --server          服务器端安装（配置机器人 + Token）
+  --setup --channel         Channel 客户端安装（写入 Channel MCP）
+  --setup --server --channel  本地完整安装（HTTP + Channel）
   --upgrade       强制升级全局配置（覆盖 MCP 配置、权限、skill）
   --reinstall     重新安装全局配置（删除后重新写入，保留机器人配置）
   --start         启动 MCP Server（后台服务模式）
@@ -52,19 +55,17 @@ function showHelp() {
   --list          列出所有已配置的机器人及其占用状态
   --delete [名称] 删除指定的机器人配置（保留 MCP 配置）
   --uninstall     卸载并删除所有配置（包括 MCP 配置、hook、skill）
+  --set-token [token]  设置/清除 Auth Token（远程部署用，--set-token --clear 清除）
   --clean-cache   清空 CC 注册表缓存（清理异常断线残留的 ccId）
 
 使用流程:
-  1. 首次安装: npx @vrs-soft/wecom-aibot-mcp
-     （进入配置向导，完成后自动后台启动服务）
+  1. 安装:    npx @vrs-soft/wecom-aibot-mcp --setup
+     （根据角色选择参数：--server / --channel / 两者都传 / 不传交互选择）
 
-  2. 已有配置: npx @vrs-soft/wecom-aibot-mcp
-     （显示状态，提示使用 --start 启动）
-
-  3. 启动服务: npx @vrs-soft/wecom-aibot-mcp --start
+  2. 启动服务: npx @vrs-soft/wecom-aibot-mcp --start
      （后台启动 MCP HTTP Server）
 
-  4. 停止服务: npx @vrs-soft/wecom-aibot-mcp --stop
+  3. 停止服务: npx @vrs-soft/wecom-aibot-mcp --stop
 
 拆分部署（远程 HTTP + 本地 Channel）:
 
@@ -104,9 +105,21 @@ function showVersion() {
 function showStatus() {
     const allRobots = listAllRobots();
     const connections = getAllConnectionStates();
+    const authToken = getAuthToken();
     // 检查服务是否运行
     const serverRunning = isServerRunning();
-    console.log(`\n服务状态: ${serverRunning ? '✅ 运行中' : '❌ 未启动'}\n`);
+    console.log(`\n服务状态: ${serverRunning ? '✅ 运行中' : '❌ 未启动'}`);
+    // 显示 Auth Token 状态（带部分 token 显示）
+    if (authToken) {
+        const maskedToken = authToken.length > 12
+            ? `${authToken.slice(0, 8)}...${authToken.slice(-4)}`
+            : `${authToken.slice(0, 4)}...`;
+        console.log(`Auth Token: ✅ 已配置 (${maskedToken})`);
+    }
+    else {
+        console.log(`Auth Token: （未配置，本地部署无需 token）`);
+    }
+    console.log('');
     if (allRobots.length === 0) {
         console.log('尚未配置机器人，请运行 npx @vrs-soft/wecom-aibot-mcp 启动配置向导');
         return;
@@ -122,7 +135,8 @@ function showStatus() {
     for (const robot of allRobots) {
         const usage = robotUsage.get(robot.name);
         const statusTag = usage ? ` [使用中]` : '';
-        console.log(`    Bot名称：  ${robot.name}${statusTag}`);
+        const docTag = robot.doc_mcp_url ? ' [文档✅]' : '';
+        console.log(`    Bot名称：  ${robot.name}${statusTag}${docTag}`);
         console.log(`    Bot ID：   ${robot.botId}`);
         console.log(`    目标用户：${robot.targetUserId}`);
         if (usage) {
@@ -297,9 +311,9 @@ async function main() {
     // 确定安装模式
     const installMode = args.includes('--http-only') ? 'http-only' :
         args.includes('--channel-only') ? 'channel-only' : 'full';
-    // --reinstall 命令需要先删除再安装，跳过开头的 ensureGlobalConfigs
-    // --http-only 模式不需要写 MCP 配置
-    if (!args.includes('--reinstall') && !args.includes('--http-only')) {
+    // --reinstall / --http-only / --setup 命令跳过顶部 ensureGlobalConfigs
+    // （--setup 自己在向导完成后调用）
+    if (!args.includes('--reinstall') && !args.includes('--http-only') && !args.includes('--setup')) {
         // 强制覆盖所有全局配置（不依赖智能体）
         ensureGlobalConfigs(installMode);
     }
@@ -325,7 +339,7 @@ async function main() {
     // --reinstall 命令：删除所有全局配置（保留机器人配置）后重新安装
     if (args.includes('--reinstall')) {
         logger.log('\n[mcp] 重新安装全局配置...');
-        console.log('[mcp] 保留所有机器人配置: ~/.wecom-aibot-mcp/config.json 和 robot-*.json');
+        console.log('[mcp] 保留所有机器人配置: ~/.wecom-aibot-mcp/robot-*.json');
         const CLAUDE_CONFIG_FILE = path.join(os.homedir(), '.claude.json');
         const CLAUDE_SETTINGS_FILE = path.join(os.homedir(), '.claude', 'settings.local.json');
         const VERSION_FILE = path.join(os.homedir(), '.wecom-aibot-mcp', 'version.json');
@@ -413,6 +427,48 @@ async function main() {
         uninstall();
         process.exit(0);
     }
+    // --set-token 命令：设置/清除 Auth Token
+    if (args.includes('--set-token')) {
+        const tokenIndex = args.indexOf('--set-token');
+        const clearToken = args.includes('--clear');
+        if (clearToken) {
+            setAuthToken(undefined);
+            updateMcpAuthHeaders(undefined);
+            console.log('[mcp] ✅ Auth Token 已清除（服务端 + 客户端 MCP 配置）');
+            process.exit(0);
+        }
+        // 检查下一个参数是否是 token（不是另一个 --flag）
+        const nextArg = args[tokenIndex + 1];
+        const token = (nextArg && !nextArg.startsWith('--')) ? nextArg : undefined;
+        if (!token) {
+            // 交互式输入 token
+            const readline = await import('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const input = await new Promise((resolve) => {
+                rl.question('请输入 Auth Token（留空取消）: ', (answer) => {
+                    rl.close();
+                    resolve(answer.trim());
+                });
+            });
+            if (!input) {
+                console.log('[mcp] 已取消');
+                process.exit(0);
+            }
+            setAuthToken(input);
+            updateMcpAuthHeaders(input);
+            console.log('[mcp] ✅ Auth Token 已设置');
+            console.log(`[mcp] 服务端: ~/.wecom-aibot-mcp/server.json`);
+            console.log(`[mcp] 客户端: ~/.claude.json MCP headers 已同步`);
+            console.log(`[mcp] Token: ${input.slice(0, 8)}...${input.slice(-4)}`);
+        }
+        else {
+            setAuthToken(token);
+            updateMcpAuthHeaders(token);
+            console.log('[mcp] ✅ Auth Token 已设置');
+            console.log(`[mcp] Token: ${token.slice(0, 8)}...${token.slice(-4)}`);
+        }
+        process.exit(0);
+    }
     if (args.includes('--add')) {
         await addMcpConfig();
         process.exit(0);
@@ -429,9 +485,87 @@ async function main() {
         await startMcpServerForeground();
         return; // 保持运行，不 exit
     }
+    // --setup：统一安装向导
+    //   --setup                    → 交互式（询问本地 / 远程）
+    //   --setup --server           → 服务器端（机器人配置 + Token）
+    //   --setup --channel          → Channel 客户端（写入 Channel MCP）
+    //   --setup --server --channel → 本地完整安装（HTTP + Channel）
+    if (args.includes('--setup')) {
+        const wantServer = args.includes('--server');
+        const wantChannel = args.includes('--channel');
+        if (wantServer && wantChannel) {
+            // 本地完整安装
+            console.log('\n[setup] 本地完整安装模式\n');
+            const savedConfig = loadConfig();
+            if (!savedConfig?.botId)
+                await runConfigWizard();
+            ensureGlobalConfigs('full');
+            startMcpServerBackground();
+            console.log('[setup] 安装完成！请重启 Claude Code 以加载配置');
+        }
+        else if (wantServer) {
+            // 服务器端
+            console.log('\n[setup] Server 安装模式\n');
+            const savedConfig = loadConfig();
+            if (!savedConfig?.botId)
+                await runConfigWizard();
+            const readline = await import('readline');
+            const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+            const token = await new Promise(resolve => rl.question('Auth Token（Client 端需填写相同 Token，留空跳过）: ', a => { rl.close(); resolve(a.trim()); }));
+            if (token)
+                setAuthToken(token);
+            console.log('\n[setup] Server 配置完成！');
+            console.log('  启动: npx @vrs-soft/wecom-aibot-mcp --http-only --start');
+        }
+        else if (wantChannel) {
+            // Channel 客户端
+            console.log('\n[setup] Channel Client 安装模式\n');
+            let mcpUrl = process.env.MCP_URL;
+            if (!mcpUrl) {
+                const readline = await import('readline');
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                mcpUrl = await new Promise(resolve => rl.question('远程服务器地址（如 https://your-server:18963）: ', a => { rl.close(); resolve(a.trim()); }));
+                if (!mcpUrl) {
+                    console.log('[setup] ❌ 地址不能为空');
+                    process.exit(1);
+                }
+                process.env.MCP_URL = mcpUrl;
+            }
+            if (!getAuthToken()) {
+                const readline = await import('readline');
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                const token = await new Promise(resolve => rl.question('Auth Token: ', a => { rl.close(); resolve(a.trim()); }));
+                if (token)
+                    setAuthToken(token);
+            }
+            ensureGlobalConfigs('channel-only');
+            console.log('[setup] Channel MCP 配置完成！请重启 Claude Code 以加载配置');
+        }
+        else {
+            // 交互式：1/2 模式选择
+            console.log('\n请选择安装模式：\n');
+            console.log('  1. 本地安装（完整功能：HTTP + Channel MCP）');
+            console.log('  2. 远程服务器（连接远程 HTTP MCP）\n');
+            const readline = await import('readline');
+            const modeChoice = await new Promise((resolve) => {
+                const rl = readline.createInterface({ input: process.stdin, output: process.stdout });
+                rl.question('请选择 (1/2，默认 1): ', a => { rl.close(); resolve(a.trim() || '1'); });
+            });
+            if (modeChoice === '2') {
+                await runRemoteInstallWizard();
+            }
+            else {
+                await runConfigWizard();
+                ensureGlobalConfigs('full');
+                startMcpServerBackground();
+            }
+        }
+        process.exit(0);
+    }
     // --channel：启动 Channel MCP 代理（stdio）
     // 注意：必须在 --debug 之前检查，否则 --channel --debug 会先触发 HTTP Server
-    if (args.includes('--channel')) {
+    // --setup --channel 已在上方处理，这里不拦截
+    if (args.includes('--channel') && !args.includes('--setup')) {
         // 检查 HTTP MCP 的 debug 标记文件
         const debugFile = path.join(os.homedir(), '.wecom-aibot-mcp', 'debug');
         const isDebug = fs.existsSync(debugFile) || args.includes('--debug');
@@ -509,12 +643,10 @@ async function main() {
             config = savedConfig;
         }
         else if (isInteractive) {
-            // TTY 模式下没有配置，启动配置向导
-            console.log('[config] 未找到配置，启动配置向导...\n');
-            const result = await runConfigWizard();
-            config = result.config;
-            instanceName = result.instanceName;
-            ranWizard = true;
+            // TTY 模式下没有配置：提示使用 --setup，不再隐式弹向导
+            console.log('[config] 未找到机器人配置。');
+            console.log('[config] 请运行: npx @vrs-soft/wecom-aibot-mcp --setup');
+            process.exit(1);
         }
         else {
             // 非 TTY 模式（MCP HTTP），必须有配置

package/dist/channel-server.js

@@ -15,7 +15,17 @@ import { z } from 'zod';
 import * as fs from 'fs';
 import * as path from 'path';
 import * as os from 'os';
+import { VERSION } from './config-wizard.js';
 const MCP_URL = process.env.MCP_URL || 'http://127.0.0.1:18963';
+const MCP_AUTH_TOKEN = process.env.MCP_AUTH_TOKEN;
+// 构建带 auth 的 fetch headers
+function getAuthHeaders() {
+    const headers = {};
+    if (MCP_AUTH_TOKEN) {
+        headers['Authorization'] = `Bearer ${MCP_AUTH_TOKEN}`;
+    }
+    return headers;
+}
 // Channel 日志文件
 const CHANNEL_LOG_FILE = path.join(os.homedir(), '.wecom-aibot-mcp', 'channel.log');
 /**
@@ -38,6 +48,7 @@ function logChannel(message, data) {
 let sseConnected = false;
 let sseAbortController = null;
 let mcpServer = null;
+let sseCurrentCcId = undefined;
 // HTTP MCP session ID（需要在转发请求前初始化）
 let httpSessionId = null;
 /**
@@ -52,6 +63,7 @@ async function initHttpSession() {
             headers: {
                 'Content-Type': 'application/json',
                 'Accept': 'application/json, text/event-stream',
+                ...getAuthHeaders(),
             },
             body: JSON.stringify({
                 jsonrpc: '2.0',
@@ -109,6 +121,7 @@ async function forwardToHttpMcp(toolName, params) {
             'Content-Type': 'application/json',
             'Accept': 'application/json, text/event-stream',
             'mcp-session-id': sessionId,
+            ...getAuthHeaders(),
         },
         body: JSON.stringify({
             jsonrpc: '2.0',
@@ -172,6 +185,7 @@ function connectSSE(ccId) {
         return;
     }
     sseConnected = true;
+    sseCurrentCcId = ccId;
     const sseUrl = ccId ? `${MCP_URL}/sse/${ccId}` : `${MCP_URL}/sse`;
     logChannel('Connecting to SSE', { url: sseUrl, ccId, mcpServerReady: mcpServer ? 'yes' : 'no' });
     sseAbortController = new AbortController();
@@ -183,6 +197,7 @@ function connectSSE(ccId) {
             'Accept': 'text/event-stream',
             'Cache-Control': 'no-cache',
             'Connection': 'keep-alive',
+            ...getAuthHeaders(),
         },
     }).then(async (res) => {
         if (!res.ok) {
@@ -210,6 +225,11 @@ function connectSSE(ccId) {
                 logChannel('SSE stream ended');
                 clearInterval(heartbeatInterval);
                 sseConnected = false;
+                // 非主动断开时自动重连
+                if (!sseAbortController?.signal.aborted) {
+                    logChannel('SSE 断线，3 秒后重连', { ccId });
+                    setTimeout(() => connectSSE(ccId), 3000);
+                }
                 break;
             }
             const chunk = decoder.decode(value, { stream: true });
@@ -280,6 +300,11 @@ function connectSSE(ccId) {
     }).catch((err) => {
         logChannel('SSE error', { error: String(err) });
         sseConnected = false;
+        // 非主动断开时自动重连
+        if (!sseAbortController?.signal.aborted) {
+            logChannel('SSE 出错，3 秒后重连', { ccId });
+            setTimeout(() => connectSSE(ccId), 3000);
+        }
     });
 }
 /**
@@ -352,8 +377,9 @@ function registerChannelTools(server) {
         bot_id: z.string().describe('企业微信 Bot ID'),
         secret: z.string().describe('机器人密钥'),
         default_user: z.string().optional().describe('默认目标用户'),
-    }, async ({ name, bot_id, secret, default_user }) => {
-        return forwardToHttpMcp('add_robot_config', { name, bot_id, secret, default_user });
+        doc_mcp_url: z.string().optional().describe('机器人文档 MCP URL（企业微信文档能力）'),
+    }, async ({ name, bot_id, secret, default_user, doc_mcp_url }) => {
+        return forwardToHttpMcp('add_robot_config', { name, bot_id, secret, default_user, doc_mcp_url });
     });
     // ============================================
     // 工具 8: 列出所有机器人
@@ -416,11 +442,12 @@ function registerChannelTools(server) {
         cc_id: z.string().describe('CC 唯一标识（enter_headless_mode 返回的 ccId）'),
         project_dir: z.string().optional().describe('项目目录路径（用于更新配置文件）'),
     }, async ({ cc_id, project_dir }) => {
-        // 断开 SSE 连接
+        // 断开 SSE 连接（abort 后重连逻辑不会触发）
         if (sseAbortController) {
             sseAbortController.abort();
             sseAbortController = null;
             sseConnected = false;
+            sseCurrentCcId = undefined;
             logChannel('SSE disconnected', { cc_id });
         }
         return forwardToHttpMcp('exit_headless_mode', { cc_id, project_dir: project_dir || process.cwd() });
@@ -445,7 +472,9 @@ function registerChannelTools(server) {
     // ============================================
     server.tool('get_skill', '获取 headless-mode skill 文件内容，用于写入本地项目目录。远程部署时 HTTP MCP 可能不在本地，skill 文件需要从此接口获取。', {}, async () => {
         // 直接请求 HTTP MCP 的 /skill 端点
-        const res = await fetch(`${MCP_URL}/skill`);
+        const res = await fetch(`${MCP_URL}/skill`, {
+            headers: getAuthHeaders(),
+        });
         if (!res.ok) {
             return {
                 content: [{
@@ -462,7 +491,97 @@ function registerChannelTools(server) {
                 }],
         };
     });
-    logChannel('Registered 13 tools');
+    // ============================================
+    // 文档代理工具（转发到 HTTP MCP）
+    // ============================================
+    const docTools = [
+        ['create_doc', '新建文档或智能表格', {
+                doc_type: z.number().int().describe('文档类型：3=文档，10=智能表格'),
+                doc_name: z.string().describe('文档名称'),
+                robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+            }],
+        ['get_doc_content', '获取文档内容（Markdown 格式）', {
+                type: z.number().int().describe('内容格式：2=Markdown'),
+                url: z.string().optional().describe('文档链接'),
+                docid: z.string().optional().describe('文档 docid'),
+                task_id: z.string().optional().describe('任务 ID（轮询时填写）'),
+                robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+            }],
+        ['edit_doc_content', '编辑文档内容（Markdown 格式覆写）', {
+                content: z.string().describe('覆写的文档内容'),
+                content_type: z.number().int().describe('内容类型：1=Markdown'),
+                url: z.string().optional().describe('文档链接'),
+                docid: z.string().optional().describe('文档 docid'),
+                robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+            }],
+        ['smartsheet_get_sheet', '查询智能表格子表信息', {
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_add_sheet', '添加智能表格子表', {
+                url: z.string().optional(), docid: z.string().optional(),
+                properties: z.object({ title: z.string().optional() }).optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_update_sheet', '更新智能表格子表标题', {
+                properties: z.object({ sheet_id: z.string(), title: z.string() }),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_delete_sheet', '删除智能表格子表', {
+                sheet_id: z.string(), url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_get_fields', '查询智能表格字段', {
+                sheet_id: z.string(), url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_add_fields', '添加智能表格字段', {
+                sheet_id: z.string(),
+                fields: z.array(z.object({ field_title: z.string(), field_type: z.string() })),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_update_fields', '更新智能表格字段标题', {
+                sheet_id: z.string(),
+                fields: z.array(z.object({ field_id: z.string(), field_title: z.string(), field_type: z.string() })),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_delete_fields', '删除智能表格字段', {
+                sheet_id: z.string(), field_ids: z.array(z.string()),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_get_records', '查询智能表格记录', {
+                sheet_id: z.string(), url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_add_records', '添加智能表格记录', {
+                sheet_id: z.string(),
+                records: z.array(z.object({ values: z.record(z.string(), z.unknown()) })),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_update_records', '更新智能表格记录', {
+                sheet_id: z.string(),
+                records: z.array(z.object({ record_id: z.string(), values: z.record(z.string(), z.unknown()) })),
+                key_type: z.enum(['CELL_VALUE_KEY_TYPE_FIELD_TITLE', 'CELL_VALUE_KEY_TYPE_FIELD_ID']),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+        ['smartsheet_delete_records', '删除智能表格记录', {
+                sheet_id: z.string(), record_ids: z.array(z.string()),
+                url: z.string().optional(), docid: z.string().optional(),
+                robot_name: z.string().optional(),
+            }],
+    ];
+    for (const [toolName, description, schema] of docTools) {
+        server.tool(toolName, description, schema, async (args) => {
+            return forwardToHttpMcp(toolName, args);
+        });
+    }
+    logChannel('Registered 28 tools (13 core + 15 doc proxy)');
 }
 /**
  * 启动 Channel MCP Server
@@ -472,7 +591,7 @@ export async function startChannelServer() {
     // 创建 MCP Server
     mcpServer = new McpServer({
         name: 'wecom-aibot-channel',
-        version: '2.0.0',
+        version: VERSION,
     }, {
         capabilities: {
             // 必须声明 experimental['claude/channel']，Claude Code 才会注册 notification listener

package/dist/client-pool.d.ts

@@ -14,6 +14,7 @@ export interface WecomConfig {
     secret: string;
     defaultUser: string;
     nameTag?: string;
+    doc_mcp_url?: string;
 }
 /**
  * 获取或创建 WecomClient 实例