@vrs-soft/wecom-aibot-mcp 2.3.1 → 2.3.3

package/dist/channel-server.js

@@ -38,6 +38,7 @@ function logChannel(message, data) {
 let sseConnected = false;
 let sseAbortController = null;
 let mcpServer = null;
+let sseCurrentCcId = undefined;
 // HTTP MCP session ID（需要在转发请求前初始化）
 let httpSessionId = null;
 /**
@@ -172,6 +173,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();
@@ -210,6 +212,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 });
@@ -240,6 +247,7 @@ function connectSSE(ccId) {
                                         chatid: message.chatid || '',
                                         chattype: message.chattype || 'single',
                                         cc_id: msg.ccId || '',
+                                        quote_content: message.quoteContent || '',
                                     },
                                 },
                             };
@@ -279,6 +287,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);
+        }
     });
 }
 /**
@@ -351,8 +364,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: 列出所有机器人
@@ -378,7 +392,7 @@ function registerChannelTools(server) {
             agent_name,
             cc_id,
             robot_id,
-            project_dir,
+            project_dir: project_dir || process.cwd(),
             mode,
             auto_approve,
             auto_approve_timeout,
@@ -415,14 +429,15 @@ 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 });
+        return forwardToHttpMcp('exit_headless_mode', { cc_id, project_dir: project_dir || process.cwd() });
     });
     // ============================================
     // 工具 11: 从消息识别用户
@@ -461,7 +476,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

package/dist/client-pool.d.ts

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

package/dist/config-wizard.d.ts

@@ -4,6 +4,7 @@ export interface WecomConfig {
     targetUserId: string;
     targetUserName?: string;
     nameTag?: string;
+    doc_mcp_url?: string;
 }
 export declare function loadConfig(): WecomConfig | null;
 export declare function listAllMcpInstances(): Array<{
@@ -23,7 +24,12 @@ export declare function listAllRobots(): Array<{
     name: string;
     botId: string;
     targetUserId: string;
+    doc_mcp_url?: string;
 }>;
+export declare function getDocMcpUrl(robotName?: string): {
+    url: string | null;
+    error?: string;
+};
 export declare function ensureHookInstalled(): void;
 export declare function ensureGlobalConfigs(mode?: 'full' | 'http-only' | 'channel-only'): {
     upgraded: boolean;

package/dist/config-wizard.js

@@ -45,11 +45,16 @@ export function loadConfig() {
             const content = fs.readFileSync(BOT_CONFIG_FILE, 'utf-8');
             const config = JSON.parse(content);
             if (config.botId && config.secret && config.targetUserId) {
-                return {
+                const result = {
                     botId: config.botId,
                     secret: config.secret,
                     targetUserId: config.targetUserId,
                 };
+                if (config.nameTag)
+                    result.nameTag = config.nameTag;
+                if (config.doc_mcp_url)
+                    result.doc_mcp_url = config.doc_mcp_url;
+                return result;
             }
         }
     }
@@ -650,6 +655,9 @@ function writeMcpServerConfig(config, instanceName) {
         if (config.nameTag) {
             botConfig.nameTag = config.nameTag;
         }
+        if (config.doc_mcp_url) {
+            botConfig.doc_mcp_url = config.doc_mcp_url;
+        }
         // 检查名称唯一性（如果设置了新名称）
         if (config.nameTag && isRobotNameExists(config.nameTag, config.botId)) {
             console.log(`[config] ❌ 机器人名称 "${config.nameTag}" 已被其他机器人使用`);
@@ -843,6 +851,7 @@ export function listAllRobots() {
                 name,
                 botId: config.botId,
                 targetUserId: config.targetUserId,
+                ...(config.doc_mcp_url ? { doc_mcp_url: config.doc_mcp_url } : {}),
             });
         }
         catch {
@@ -860,6 +869,7 @@ export function listAllRobots() {
                     name,
                     botId: config.botId,
                     targetUserId: config.targetUserId,
+                    ...(config.doc_mcp_url ? { doc_mcp_url: config.doc_mcp_url } : {}),
                 });
             }
             catch {
@@ -869,6 +879,35 @@ export function listAllRobots() {
     }
     return robots;
 }
+// 获取指定机器人（或唯一机器人）的文档 MCP URL
+export function getDocMcpUrl(robotName) {
+    const robots = listAllRobots();
+    const robotsWithDoc = robots.filter(r => r.doc_mcp_url);
+    if (robotsWithDoc.length === 0) {
+        return {
+            url: null,
+            error: '未配置文档 MCP URL。请运行 `npx @vrs-soft/wecom-aibot-mcp --add` 添加机器人时填写文档 MCP URL，或通过 `add_robot_config` 工具设置。',
+        };
+    }
+    if (robotName) {
+        const robot = robotsWithDoc.find(r => r.name === robotName);
+        if (!robot) {
+            return {
+                url: null,
+                error: `未找到名为 "${robotName}" 的机器人，或该机器人未配置文档 MCP URL。已配置文档能力的机器人: ${robotsWithDoc.map(r => r.name).join(', ')}`,
+            };
+        }
+        return { url: robot.doc_mcp_url };
+    }
+    if (robotsWithDoc.length === 1) {
+        return { url: robotsWithDoc[0].doc_mcp_url };
+    }
+    // 多个机器人有 doc_mcp_url，需要用户指定
+    return {
+        url: null,
+        error: `有多个机器人配置了文档 MCP URL，请通过 robot_name 参数指定使用哪个机器人。已配置文档能力的机器人: ${robotsWithDoc.map(r => r.name).join(', ')}`,
+    };
+}
 // 写入 MCP 工具权限 + 注册 PermissionRequest hook 到 Claude settings
 function writeMcpPermissions() {
     try {
@@ -1075,7 +1114,8 @@ export async function runConfigWizard() {
         else {
             console.log('\n请选择要操作的机器人：\n');
             robots.forEach((robot, idx) => {
-                console.log(`  ${idx + 1}. ${robot.name} (Bot ID: ${robot.botId.slice(0, 12)}...)`);
+                const docTag = robot.doc_mcp_url ? ' [文档✅]' : '';
+                console.log(`  ${idx + 1}. ${robot.name} (Bot ID: ${robot.botId.slice(0, 12)}...)${docTag}`);
             });
             console.log(`  ${robots.length + 1}. 添加新机器人\n`);
             const choice = await question(rl, '请输入序号: ');
@@ -1150,12 +1190,23 @@ export async function runConfigWizard() {
                 }
             }
         }
-        // 第五步：目标用户（稍后通过消息自动识别）
+        // 第五步：文档 MCP URL（可选）
+        const currentDocUrl = targetRobot?.doc_mcp_url ?? '';
+        const docUrlPrompt = currentDocUrl
+            ? `文档 MCP URL（当前: ${currentDocUrl.slice(0, 40)}...，留空保持不变）: `
+            : '文档 MCP URL（可选，企业微信管理后台获取，留空跳过）: ';
+        let docMcpUrl = await question(rl, docUrlPrompt);
+        if (!docMcpUrl && currentDocUrl) {
+            docMcpUrl = currentDocUrl;
+            console.log('[config] 保持原文档 MCP URL');
+        }
+        // 第六步：目标用户（稍后通过消息自动识别）
         console.log('\n─────────────────────────────────────');
         console.log('配置确认：');
         console.log(`  机器人名称: ${robotName}`);
         console.log(`  Bot ID:     ${botId}`);
         console.log(`  Secret:     ${secret.slice(0, 8)}...${secret.slice(-4)}`);
+        console.log(`  文档 MCP:   ${docMcpUrl ? '✅ 已配置' : '（未配置）'}`);
         console.log(`  目标用户:   （将通过消息自动识别）`);
         console.log('─────────────────────────────────────\n');
         const confirm = await question(rl, '确认配置？(Y/n): ');
@@ -1167,8 +1218,9 @@ export async function runConfigWizard() {
         const config = {
             botId,
             secret,
-            targetUserId: '', // 稍后通过消息识别
+            targetUserId: targetRobot?.targetUserId || '', // 修改时保留原值，新建时稍后识别
             nameTag: robotName,
+            ...(docMcpUrl ? { doc_mcp_url: docMcpUrl } : {}),
         };
         // 如果是修改现有机器人，返回其 instanceName（用于删除旧配置）
         const instanceName = targetRobot ? targetRobot.name : 'wecom-aibot';

package/dist/doc-proxy.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 文档 MCP 代理模块
+ *
+ * 将文档工具调用代理转发到机器人专属的企业微信文档 MCP 服务（StreamableHTTP）。
+ * 每次调用建立独立连接，无需维护长连接状态。
+ */
+export interface DocToolResult {
+    content: Array<{
+        type: string;
+        text: string;
+    }>;
+    isError?: boolean;
+}
+/**
+ * 调用机器人文档 MCP 工具
+ *
+ * @param docMcpUrl  机器人专属的文档 MCP URL（含 uaKey）
+ * @param toolName   工具名称，如 create_doc、smartsheet_add_records 等
+ * @param args       工具参数
+ */
+export declare function callDocTool(docMcpUrl: string, toolName: string, args: Record<string, unknown>): Promise<DocToolResult>;

package/dist/doc-proxy.js

@@ -0,0 +1,46 @@
+/**
+ * 文档 MCP 代理模块
+ *
+ * 将文档工具调用代理转发到机器人专属的企业微信文档 MCP 服务（StreamableHTTP）。
+ * 每次调用建立独立连接，无需维护长连接状态。
+ */
+import { Client } from '@modelcontextprotocol/sdk/client/index.js';
+import { StreamableHTTPClientTransport } from '@modelcontextprotocol/sdk/client/streamableHttp.js';
+import { logger } from './logger.js';
+/**
+ * 调用机器人文档 MCP 工具
+ *
+ * @param docMcpUrl  机器人专属的文档 MCP URL（含 uaKey）
+ * @param toolName   工具名称，如 create_doc、smartsheet_add_records 等
+ * @param args       工具参数
+ */
+export async function callDocTool(docMcpUrl, toolName, args) {
+    const client = new Client({ name: 'wecom-aibot-doc-proxy', version: '1.0.0' }, { capabilities: {} });
+    try {
+        const transport = new StreamableHTTPClientTransport(new URL(docMcpUrl));
+        await client.connect(transport);
+        const result = await client.callTool({ name: toolName, arguments: args });
+        return {
+            content: result.content ?? [
+                { type: 'text', text: JSON.stringify(result) },
+            ],
+            isError: result.isError,
+        };
+    }
+    catch (err) {
+        logger.error(`[doc-proxy] 调用 ${toolName} 失败:`, err);
+        const message = err?.message ?? String(err);
+        return {
+            content: [{ type: 'text', text: `文档工具调用失败: ${message}\n\n请检查机器人的文档 MCP URL 是否正确，或该机器人是否已授权文档能力。` }],
+            isError: true,
+        };
+    }
+    finally {
+        try {
+            await client.close();
+        }
+        catch {
+            // 关闭时忽略错误
+        }
+    }
+}

package/dist/http-server.d.ts

@@ -31,6 +31,7 @@ export declare function pushMessageToSSEClient(robotName: string, message: {
     chatid: string;
     chattype: 'single' | 'group';
     timestamp: number;
+    quoteContent?: string;
 }, targetCcId?: string): Promise<void>;
 export interface ApprovalRequest {
     tool_name: string;

package/dist/http-server.js

@@ -109,6 +109,7 @@ export async function pushMessageToSSEClient(robotName, message, targetCcId) {
                     chatid: message.chatid,
                     chattype: message.chattype,
                     time: new Date(message.timestamp).toISOString(),
+                    quoteContent: message.quoteContent,
                 },
             });
             client.res.write(`event: message\ndata: ${data}\n\n`);
@@ -227,6 +228,7 @@ async function handleWecomMessage(msg) {
                 chatid: msg.chatid,
                 chattype: msg.chattype,
                 timestamp: msg.timestamp,
+                quoteContent: msg.quoteContent,
             }, targetCcId);
             return;
         }
@@ -251,6 +253,7 @@ async function handleWecomMessage(msg) {
                 chatid: msg.chatid,
                 chattype: msg.chattype,
                 timestamp: msg.timestamp,
+                quoteContent: msg.quoteContent,
             }, ccId);
             return;
         }
@@ -267,6 +270,7 @@ async function handleWecomMessage(msg) {
                     chatid: msg.chatid,
                     chattype: msg.chattype,
                     timestamp: msg.timestamp,
+                    quoteContent: msg.quoteContent,
                 }, targetCcId);
                 return;
             }
@@ -284,6 +288,7 @@ async function handleWecomMessage(msg) {
                     chatid: msg.chatid,
                     chattype: msg.chattype,
                     timestamp: msg.timestamp,
+                    quoteContent: msg.quoteContent,
                 }, matchedCcId);
                 return;
             }
@@ -383,6 +388,7 @@ async function handleWecomMessage(msg) {
                     chatid: msg.chatid,
                     chattype: msg.chattype,
                     timestamp: msg.timestamp,
+                    quoteContent: msg.quoteContent,
                 }, matchedCcId);
             }
             else {

package/dist/tools/index.js

@@ -20,7 +20,8 @@
  * - 从 Session 自动获取 robotName
  */
 import { z } from 'zod';
-import { listAllRobots, installSkill } from '../config-wizard.js';
+import { listAllRobots, getDocMcpUrl, installSkill } from '../config-wizard.js';
+import { callDocTool } from '../doc-proxy.js';
 import { connectRobot, disconnectRobot, getClient, getConnectionState, } from '../connection-manager.js';
 import { registerCcId, unregisterCcId, getRobotByCcId, getProjectDirByCcId, generateCcId, } from '../http-server.js';
 import { subscribeWecomMessageByCcId } from '../message-bus.js';
@@ -312,13 +313,15 @@ npx @vrs-soft/wecom-aibot-mcp
         bot_id: z.string().describe('企业微信 Bot ID'),
         secret: z.string().describe('机器人密钥'),
         default_user: z.string().optional().describe('默认目标用户'),
-    }, async ({ 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 {
             content: [{
                     type: 'text',
                     text: JSON.stringify({
                         message: '请使用 --add 命令添加机器人配置',
                         command: `npx @vrs-soft/wecom-aibot-mcp --add`,
+                        tip: doc_mcp_url ? '运行向导时在"文档 MCP URL"提示处粘贴您的 URL' : undefined,
                     }, null, 2),
                 }],
         };
@@ -334,6 +337,7 @@ npx @vrs-soft/wecom-aibot-mcp
             name: robot.name,
             botId: robot.botId?.slice(0, 12) + '...', // 只显示前12位
             targetUser: robot.targetUserId,
+            hasDocMcp: !!robot.doc_mcp_url, // 是否配置了文档 MCP 能力
         }));
         return {
             content: [{
@@ -413,11 +417,11 @@ npx @vrs-soft/wecom-aibot-mcp
                     }],
             };
         }
-        // 如果用户传入 cc_id，直接使用；否则自动生成
-        const finalCcId = cc_id || generateCcId(effectiveAgentName);
-        // 检查 wecom-aibot.json 是否已有匹配的 ccId（重连场景）
+        // 检查 wecom-aibot.json 是否已有 ccId（重连场景）
         const existingConfig = loadWechatModeConfig(projectDir);
-        const isReconnect = existingConfig?.ccId === finalCcId;
+        // 优先级：cc_id 参数 > (非 agent_name 指定时) 配置文件已有 ccId > 自动生成
+        const finalCcId = cc_id || (!agent_name && existingConfig?.ccId) || generateCcId(effectiveAgentName);
+        const isReconnect = !!existingConfig?.ccId && existingConfig.ccId === finalCcId;
         // 注册 ccId 到 CC 注册表（重连直接覆盖，首次注册清理超时条目）
         registerCcId(finalCcId, selectedRobot.name, effectiveAgentName, mode, projectDir, isReconnect);
         // 更新项目配置文件中的 wechatMode 为 true
@@ -598,5 +602,205 @@ npx @vrs-soft/wecom-aibot-mcp
                 }],
         };
     });
-    logger.log('[mcp] 已注册 14 个工具');
+    // ============================================
+    // 文档代理工具（企业微信文档 MCP 能力）
+    // 代理转发到机器人专属的 doc_mcp_url
+    // ============================================
+    // 公共辅助：解析 doc MCP URL
+    function resolveDocUrl(robotName) {
+        const { url, error } = getDocMcpUrl(robotName);
+        if (!url) {
+            return {
+                url: null,
+                errorContent: { content: [{ type: 'text', text: error ?? '未配置文档 MCP URL' }] },
+            };
+        }
+        return { url };
+    }
+    server.tool('create_doc', '新建文档或智能表格。doc_type: 3=文档, 10=智能表格。创建成功后返回文档链接。', {
+        doc_type: z.number().int().describe('文档类型：3=文档，10=智能表格'),
+        doc_name: z.string().describe('文档名称，最多 255 个字符'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ doc_type, doc_name, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'create_doc', { doc_type, doc_name });
+    });
+    server.tool('get_doc_content', '获取企业微信文档内容（Markdown 格式）。支持异步轮询：首次调用无需 task_id，若 task_done 为 false 则带 task_id 继续轮询。', {
+        type: z.number().int().describe('内容格式：2=Markdown'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        task_id: z.string().optional().describe('任务 ID（轮询时填写）'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ type, url: docUrl, docid, task_id, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'get_doc_content', { type, url: docUrl, docid, task_id });
+    });
+    server.tool('edit_doc_content', '编辑企业微信文档内容，支持 Markdown 格式覆写。', {
+        content: z.string().describe('覆写的文档内容'),
+        content_type: z.number().int().describe('内容类型：1=Markdown'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ content, content_type, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'edit_doc_content', { content, content_type, url: docUrl, docid });
+    });
+    server.tool('smartsheet_get_sheet', '查询智能表格中的子表信息。', {
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_get_sheet', { url: docUrl, docid });
+    });
+    server.tool('smartsheet_add_sheet', '在智能表格内添加新子表。', {
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        properties: z.object({ title: z.string().optional() }).optional().describe('子表属性，可设置 title'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ url: docUrl, docid, properties, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_add_sheet', { url: docUrl, docid, properties });
+    });
+    server.tool('smartsheet_update_sheet', '修改智能表格子表的标题。', {
+        properties: z.object({
+            sheet_id: z.string().describe('子表 ID'),
+            title: z.string().describe('新标题'),
+        }).describe('子表属性'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ properties, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_update_sheet', { properties, url: docUrl, docid });
+    });
+    server.tool('smartsheet_delete_sheet', '删除智能表格中的子表（不可逆）。', {
+        sheet_id: z.string().describe('要删除的子表 ID'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_delete_sheet', { sheet_id, url: docUrl, docid });
+    });
+    server.tool('smartsheet_get_fields', '获取智能表格子表的字段（列）信息。', {
+        sheet_id: z.string().describe('子表 ID'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_get_fields', { sheet_id, url: docUrl, docid });
+    });
+    server.tool('smartsheet_add_fields', '向智能表格子表添加字段（列）。调用前必须先用 smartsheet_get_fields 查看现有字段并用 smartsheet_update_fields 重命名默认字段，否则会多出无用列。', {
+        sheet_id: z.string().describe('子表 ID'),
+        fields: z.array(z.object({
+            field_title: z.string(),
+            field_type: z.string(),
+        })).describe('要添加的字段列表'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, fields, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_add_fields', { sheet_id, fields, url: docUrl, docid });
+    });
+    server.tool('smartsheet_update_fields', '更新智能表格子表字段的标题（不能更改字段类型）。', {
+        sheet_id: z.string().describe('子表 ID'),
+        fields: z.array(z.object({
+            field_id: z.string(),
+            field_title: z.string(),
+            field_type: z.string(),
+        })).describe('要更新的字段列表'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, fields, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_update_fields', { sheet_id, fields, url: docUrl, docid });
+    });
+    server.tool('smartsheet_delete_fields', '删除智能表格子表中的字段（列）（不可逆）。', {
+        sheet_id: z.string().describe('子表 ID'),
+        field_ids: z.array(z.string()).describe('要删除的字段 ID 列表'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, field_ids, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_delete_fields', { sheet_id, field_ids, url: docUrl, docid });
+    });
+    server.tool('smartsheet_get_records', '查询智能表格子表的所有记录。', {
+        sheet_id: z.string().describe('子表 ID'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_get_records', { sheet_id, url: docUrl, docid });
+    });
+    server.tool('smartsheet_add_records', '向智能表格子表添加记录（行）。单次建议不超过 500 行。values 的 key 必须是字段标题（field_title），不能用 field_id。', {
+        sheet_id: z.string().describe('子表 ID'),
+        records: z.array(z.object({ values: z.record(z.string(), z.unknown()) })).describe('记录列表，values key 为字段标题'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, records, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_add_records', { sheet_id, records, url: docUrl, docid });
+    });
+    server.tool('smartsheet_update_records', '更新智能表格子表中的记录（行）。单次建议不超过 500 行。', {
+        sheet_id: z.string().describe('子表 ID'),
+        records: z.array(z.object({
+            record_id: z.string(),
+            values: z.record(z.string(), z.unknown()),
+        })).describe('要更新的记录列表，含 record_id 和 values'),
+        key_type: z.enum(['CELL_VALUE_KEY_TYPE_FIELD_TITLE', 'CELL_VALUE_KEY_TYPE_FIELD_ID']).describe('values 的 key 类型'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, records, key_type, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_update_records', { sheet_id, records, key_type, url: docUrl, docid });
+    });
+    server.tool('smartsheet_delete_records', '删除智能表格子表中的记录（行）（不可逆）。单次建议不超过 500 行。', {
+        sheet_id: z.string().describe('子表 ID'),
+        record_ids: z.array(z.string()).describe('要删除的记录 ID 列表'),
+        url: z.string().optional().describe('文档访问链接，与 docid 二选一'),
+        docid: z.string().optional().describe('文档 docid，与 url 二选一'),
+        robot_name: z.string().optional().describe('指定机器人名称（多机器人时必填）'),
+    }, async ({ sheet_id, record_ids, url: docUrl, docid, robot_name }) => {
+        const { url, errorContent } = resolveDocUrl(robot_name);
+        if (!url)
+            return errorContent;
+        return callDocTool(url, 'smartsheet_delete_records', { sheet_id, record_ids, url: docUrl, docid });
+    });
+    logger.log('[mcp] 已注册 29 个工具（含 15 个文档代理工具）');
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vrs-soft/wecom-aibot-mcp",
-  "version": "2.3.1",
+  "version": "2.3.3",
   "description": "企业微信智能机器人 MCP 服务 - Claude Code 审批通道",
   "type": "module",
   "main": "dist/index.js",