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

package/dist/config-wizard.d.ts

@@ -4,8 +4,13 @@ export interface WecomConfig {
     targetUserId: string;
     targetUserName?: string;
     nameTag?: string;
+    doc_mcp_url?: string;
 }
+export declare const VERSION: string;
 export declare function loadConfig(): WecomConfig | null;
+export declare function getAuthToken(): string | undefined;
+export declare function setAuthToken(token: string | undefined): boolean;
+export declare function updateMcpAuthHeaders(token?: string): void;
 export declare function listAllMcpInstances(): Array<{
     name: string;
     config: WecomConfig;
@@ -23,12 +28,21 @@ 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'): {
+export declare function ensureGlobalConfigs(mode?: 'full' | 'http-only' | 'channel-only' | 'remote' | 'remote-channel', remoteOptions?: {
+    url: string;
+    token: string;
+}): {
     upgraded: boolean;
     previousVersion?: string;
 };
+export declare function runRemoteInstallWizard(): Promise<'remote' | 'remote-channel' | 'server' | null>;
 export declare function saveConfig(config: WecomConfig, instanceName?: string): boolean;
 /**
  * 安装 headless-mode skill 到项目目录
@@ -58,7 +72,7 @@ export declare function detectUserIdFromMessage(client: any, timeoutSeconds?: nu
  *
  * 优先级：
  * 1. 环境变量（WECOM_BOT_ID, WECOM_SECRET, WECOM_TARGET_USER）
- * 2. 保存的配置文件（~/.wecom-aibot-mcp/config.json）
+ * 2. 保存的配置文件（~/.wecom-aibot-mcp/robot-*.json）
  * 3. 运行配置向导
  */
 export declare function getOrInitConfig(): Promise<WecomConfig>;

package/dist/config-wizard.js

@@ -4,7 +4,7 @@
  * 首次运行时引导用户配置 Bot ID、Secret 和默认目标用户
  *
  * 配置存储位置：
- * - 机器人配置：~/.wecom-aibot-mcp/config.json
+ * - 机器人配置：~/.wecom-aibot-mcp/robot-*.json
  * - MCP 配置：~/.claude.json (仅 URL)
  */
 import * as readline from 'readline';
@@ -14,8 +14,8 @@ import * as os from 'os';
 import { fileURLToPath } from 'url';
 import { logger } from './logger.js';
 const CONFIG_DIR = path.join(os.homedir(), '.wecom-aibot-mcp');
-const BOT_CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
 const VERSION_FILE = path.join(CONFIG_DIR, 'version.json');
+const SERVER_CONFIG_FILE = path.join(CONFIG_DIR, 'server.json'); // HTTP Server 配置（auth token 等）
 const CLAUDE_CONFIG_FILE = path.join(os.homedir(), '.claude.json');
 const CLAUDE_SETTINGS_FILE = path.join(os.homedir(), '.claude', 'settings.local.json');
 const HOOK_SCRIPT_PATH = path.join(CONFIG_DIR, 'permission-hook.sh');
@@ -23,8 +23,8 @@ const TASK_COMPLETED_HOOK_SCRIPT_PATH = path.join(CONFIG_DIR, 'task-completed-ho
 // Skill 模板路径（包内）- 使用 fileURLToPath 确保跨平台兼容
 const __filename = fileURLToPath(import.meta.url);
 const __dirname = path.dirname(__filename);
-// 版本号（从 package.json 读取）
-const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8')).version;
+// 版本号（从 package.json 读取，全局共享）
+export const VERSION = JSON.parse(fs.readFileSync(path.join(__dirname, '..', 'package.json'), 'utf-8')).version;
 const SKILL_TEMPLATE_DIR = path.join(__dirname, '..', 'skills', 'headless-mode');
 const SKILL_TEMPLATE_FILE = path.join(SKILL_TEMPLATE_DIR, 'SKILL.md');
 // MCP 工具权限列表（需要预授权以避免 headless 模式阻断）
@@ -37,19 +37,26 @@ function ensureConfigDir() {
         fs.mkdirSync(CONFIG_DIR, { recursive: true });
     }
 }
-// 从 ~/.wecom-aibot-mcp/config.json 读取已保存的配置
+// 从 ~/.wecom-aibot-mcp/robot-*.json 读取第一个有效配置
 export function loadConfig() {
     try {
-        // 从机器人配置文件读取
-        if (fs.existsSync(BOT_CONFIG_FILE)) {
-            const content = fs.readFileSync(BOT_CONFIG_FILE, 'utf-8');
+        if (!fs.existsSync(CONFIG_DIR))
+            return null;
+        const files = fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'));
+        for (const file of files) {
+            const content = fs.readFileSync(path.join(CONFIG_DIR, 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;
             }
         }
     }
@@ -58,6 +65,71 @@ export function loadConfig() {
     }
     return null;
 }
+// 获取 HTTP Server 的 auth token（从 server.json 读取）
+export function getAuthToken() {
+    if (!fs.existsSync(SERVER_CONFIG_FILE))
+        return undefined;
+    try {
+        const config = JSON.parse(fs.readFileSync(SERVER_CONFIG_FILE, 'utf-8'));
+        return config.authToken || undefined;
+    }
+    catch {
+        return undefined;
+    }
+}
+// 设置/清除 HTTP Server 的 auth token（写入 server.json）
+export function setAuthToken(token) {
+    ensureConfigDir();
+    let config = {};
+    if (fs.existsSync(SERVER_CONFIG_FILE)) {
+        try {
+            config = JSON.parse(fs.readFileSync(SERVER_CONFIG_FILE, 'utf-8'));
+        }
+        catch {
+            // ignore
+        }
+    }
+    if (token) {
+        config.authToken = token;
+    }
+    else {
+        delete config.authToken;
+        // 如果 config 为空，删除文件
+        if (Object.keys(config).length === 0) {
+            if (fs.existsSync(SERVER_CONFIG_FILE))
+                fs.unlinkSync(SERVER_CONFIG_FILE);
+            return true;
+        }
+    }
+    fs.writeFileSync(SERVER_CONFIG_FILE, JSON.stringify(config, null, 2));
+    return true;
+}
+// 更新 ~/.claude.json 中 wecom-aibot MCP 配置的 auth headers
+export function updateMcpAuthHeaders(token) {
+    if (!fs.existsSync(CLAUDE_CONFIG_FILE))
+        return;
+    try {
+        const content = fs.readFileSync(CLAUDE_CONFIG_FILE, 'utf-8');
+        const claudeConfig = JSON.parse(content);
+        if (!claudeConfig.mcpServers)
+            return;
+        // 更新所有 wecom-aibot 相关的 HTTP MCP 配置
+        for (const name of Object.keys(claudeConfig.mcpServers)) {
+            if (name.startsWith('wecom-aibot') && claudeConfig.mcpServers[name].type === 'http') {
+                if (token) {
+                    claudeConfig.mcpServers[name].headers = { Authorization: `Bearer ${token}` };
+                }
+                else {
+                    delete claudeConfig.mcpServers[name].headers;
+                }
+            }
+        }
+        fs.writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(claudeConfig, null, 2));
+    }
+    catch {
+        // ignore
+    }
+}
 // 获取所有 wecom-aibot 相关的 MCP 实例
 export function listAllMcpInstances() {
     // 现在只有一个主配置文件
@@ -134,18 +206,8 @@ export function deleteRobotConfig(robotName) {
         }
         // 查找机器人对应的配置文件
         let configFile = null;
-        let isDefault = false;
-        // 检查是否是默认机器人（config.json）
-        if (fs.existsSync(BOT_CONFIG_FILE)) {
-            const config = JSON.parse(fs.readFileSync(BOT_CONFIG_FILE, 'utf-8'));
-            const name = config.nameTag || `机器人-${config.botId?.slice(0, 8) || 'unknown'}`;
-            if (name === robotName) {
-                configFile = BOT_CONFIG_FILE;
-                isDefault = true;
-            }
-        }
-        // 检查其他机器人配置文件
-        if (!configFile && fs.existsSync(CONFIG_DIR)) {
+        // 从 robot-*.json 中查找
+        if (fs.existsSync(CONFIG_DIR)) {
             const files = fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'));
             for (const file of files) {
                 const filePath = path.join(CONFIG_DIR, file);
@@ -161,30 +223,8 @@ export function deleteRobotConfig(robotName) {
             console.log(`[config] 未找到机器人 "${robotName}" 的配置文件`);
             return false;
         }
-        // 如果是默认机器人，需要处理迁移
-        if (isDefault) {
-            // 查找其他机器人配置文件
-            const otherRobotFiles = fs.existsSync(CONFIG_DIR)
-                ? fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'))
-                : [];
-            if (otherRobotFiles.length > 0) {
-                // 将第一个其他机器人提升为默认
-                const newDefaultFile = path.join(CONFIG_DIR, otherRobotFiles[0]);
-                const newDefaultConfig = JSON.parse(fs.readFileSync(newDefaultFile, 'utf-8'));
-                fs.writeFileSync(BOT_CONFIG_FILE, JSON.stringify(newDefaultConfig, null, 2));
-                fs.unlinkSync(newDefaultFile);
-                console.log(`[config] 已将 "${newDefaultConfig.nameTag || otherRobotFiles[0]}" 提升为默认机器人`);
-            }
-            else {
-                // 没有其他机器人，直接删除默认配置
-                fs.unlinkSync(BOT_CONFIG_FILE);
-                console.log('[config] 已删除最后一个机器人配置');
-            }
-        }
-        else {
-            // 不是默认机器人，直接删除
-            fs.unlinkSync(configFile);
-        }
+        // 直接删除
+        fs.unlinkSync(configFile);
         console.log(`[config] 已删除机器人: ${robotName}`);
         return true;
     }
@@ -297,7 +337,7 @@ export function uninstall() {
             logger.error('[config] 删除 headless 状态索引失败:', err);
         }
     }
-    // 删除整个配置目录（包括 config.json、robot-*.json、hook 脚本、日志等）
+    // 删除整个配置目录（包括 robot-*.json、hook 脚本、日志等）
     // 使用 recursive: true 和 force: true 确保完全删除
     if (fs.existsSync(CONFIG_DIR)) {
         try {
@@ -650,6 +690,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}" 已被其他机器人使用`);
@@ -664,18 +707,10 @@ function writeMcpServerConfig(config, instanceName) {
             console.log(`[config] 已更新机器人配置: ${existingConfigFile}`);
         }
         else {
-            // 新配置：检查是否有默认配置文件
-            if (fs.existsSync(BOT_CONFIG_FILE)) {
-                // 有默认配置，创建新的 robot-*.json 文件
-                const newConfigPath = path.join(CONFIG_DIR, `robot-${Date.now()}.json`);
-                fs.writeFileSync(newConfigPath, JSON.stringify(botConfig, null, 2));
-                console.log(`[config] 已添加新机器人配置: ${newConfigPath}`);
-            }
-            else {
-                // 没有默认配置，写入 config.json
-                fs.writeFileSync(BOT_CONFIG_FILE, JSON.stringify(botConfig, null, 2));
-                console.log('[config] 已写入机器人配置 ~/.wecom-aibot-mcp/config.json');
-            }
+            // 新机器人：统一使用 robot-*.json
+            const newConfigPath = path.join(CONFIG_DIR, `robot-${Date.now()}.json`);
+            fs.writeFileSync(newConfigPath, JSON.stringify(botConfig, null, 2));
+            console.log(`[config] 已添加新机器人配置: ${newConfigPath}`);
         }
         // 2. 写入 MCP 配置到 ~/.claude.json（仅 URL）
         let claudeConfig = {};
@@ -699,7 +734,7 @@ function writeMcpServerConfig(config, instanceName) {
         logger.error('[config] 写入配置失败:', err);
         console.log('[config] ⚠️  请手动配置:');
         console.log('');
-        console.log('~/.wecom-aibot-mcp/config.json:');
+        console.log('~/.wecom-aibot-mcp/robot-*.json:');
         console.log(JSON.stringify({
             botId: config.botId,
             secret: config.secret,
@@ -743,6 +778,9 @@ export async function addMcpConfig() {
             console.log('Secret 不能为空');
             secret = await question(rl, 'Secret: ');
         }
+        // 获取文档 MCP URL（可选）
+        console.log('');
+        const docMcpUrl = await question(rl, '文档 MCP URL（可选，企业微信管理后台获取，留空跳过）: ');
         rl.close();
         // 检查是否已存在相同 botId 的配置
         const existingRobots = listAllRobots();
@@ -801,22 +839,14 @@ export async function addMcpConfig() {
             secret,
             targetUserId,
             nameTag: robotName,
+            ...(docMcpUrl ? { doc_mcp_url: docMcpUrl } : {}),
         };
         // 确保配置目录存在
         ensureConfigDir();
-        // 如果是第一个机器人，保存为默认配置
-        const defaultConfigPath = BOT_CONFIG_FILE;
+        // 统一使用 robot-*.json 格式
         const robotConfigPath = path.join(CONFIG_DIR, `robot-${Date.now()}.json`);
-        if (!fs.existsSync(defaultConfigPath)) {
-            // 第一个机器人作为默认
-            fs.writeFileSync(defaultConfigPath, JSON.stringify(robotConfig, null, 2));
-            console.log(`\n[config] ✅ 已设为默认机器人: ${robotName}`);
-        }
-        else {
-            // 后续机器人保存为独立文件
-            fs.writeFileSync(robotConfigPath, JSON.stringify(robotConfig, null, 2));
-            console.log(`\n[config] ✅ 已添加新机器人: ${robotName}`);
-        }
+        fs.writeFileSync(robotConfigPath, JSON.stringify(robotConfig, null, 2));
+        console.log(`\n[config] ✅ 已添加机器人: ${robotName}`);
         console.log(`[config] 用户 ID: ${targetUserId}`);
         // 列出所有机器人
         const robots = listAllRobots();
@@ -834,22 +864,7 @@ export async function addMcpConfig() {
 // 列出所有机器人配置
 export function listAllRobots() {
     const robots = [];
-    // 主配置文件（config.json）
-    if (fs.existsSync(BOT_CONFIG_FILE)) {
-        try {
-            const config = JSON.parse(fs.readFileSync(BOT_CONFIG_FILE, 'utf-8'));
-            const name = config.nameTag || `机器人-${config.botId?.slice(0, 8) || 'unknown'}`;
-            robots.push({
-                name,
-                botId: config.botId,
-                targetUserId: config.targetUserId,
-            });
-        }
-        catch {
-            // ignore
-        }
-    }
-    // 其他机器人配置
+    // 所有机器人配置（统一 robot-*.json 格式）
     if (fs.existsSync(CONFIG_DIR)) {
         const files = fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'));
         for (const file of files) {
@@ -860,6 +875,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 +885,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 {
@@ -919,7 +964,7 @@ export function ensureHookInstalled() {
     writeTaskCompletedHookScript();
 }
 // 确保所有全局配置已写入（强制覆盖，不依赖智能体）
-export function ensureGlobalConfigs(mode = 'full') {
+export function ensureGlobalConfigs(mode = 'full', remoteOptions) {
     ensureConfigDir();
     // 读取已安装版本
     let previousVersion;
@@ -942,6 +987,64 @@ export function ensureGlobalConfigs(mode = 'full') {
         fs.writeFileSync(VERSION_FILE, JSON.stringify({ version: VERSION, installedAt: Date.now() }, null, 2));
         return { upgraded, previousVersion };
     }
+    // remote 模式：仅写入远程 HTTP MCP 配置（带 token headers），不装 Channel/Hook
+    if (mode === 'remote') {
+        if (!remoteOptions?.url || !remoteOptions?.token) {
+            console.log('[config] ❌ 远程模式需要提供 URL 和 Token');
+            return { upgraded: false, previousVersion };
+        }
+        let claudeConfig = {};
+        if (fs.existsSync(CLAUDE_CONFIG_FILE)) {
+            claudeConfig = JSON.parse(fs.readFileSync(CLAUDE_CONFIG_FILE, 'utf-8'));
+        }
+        if (!claudeConfig.mcpServers)
+            claudeConfig.mcpServers = {};
+        claudeConfig.mcpServers['wecom-aibot'] = {
+            type: 'http',
+            url: remoteOptions.url,
+            headers: { Authorization: `Bearer ${remoteOptions.token}` },
+        };
+        fs.writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(claudeConfig, null, 2));
+        console.log('[config] remote 模式：已写入远程 HTTP MCP 配置（带 Token）');
+        fs.writeFileSync(VERSION_FILE, JSON.stringify({ version: VERSION, installedAt: Date.now() }, null, 2));
+        return { upgraded, previousVersion };
+    }
+    // remote-channel 模式：写入远程 HTTP MCP（带 token）+ Channel MCP
+    if (mode === 'remote-channel') {
+        if (!remoteOptions?.url || !remoteOptions?.token) {
+            console.log('[config] ❌ 远程模式需要提供 URL 和 Token');
+            return { upgraded: false, previousVersion };
+        }
+        let claudeConfig = {};
+        if (fs.existsSync(CLAUDE_CONFIG_FILE)) {
+            claudeConfig = JSON.parse(fs.readFileSync(CLAUDE_CONFIG_FILE, 'utf-8'));
+        }
+        if (!claudeConfig.mcpServers)
+            claudeConfig.mcpServers = {};
+        // HTTP MCP 配置（带 token）
+        claudeConfig.mcpServers['wecom-aibot'] = {
+            type: 'http',
+            url: remoteOptions.url,
+            headers: { Authorization: `Bearer ${remoteOptions.token}` },
+        };
+        // Channel MCP 配置（带 MCP_URL + MCP_AUTH_TOKEN）
+        const binPath = path.join(__dirname, 'bin.js');
+        claudeConfig.mcpServers['wecom-aibot-channel'] = {
+            command: 'node',
+            args: [binPath, '--channel'],
+            env: {
+                MCP_URL: remoteOptions.url,
+                MCP_AUTH_TOKEN: remoteOptions.token,
+            },
+        };
+        fs.writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(claudeConfig, null, 2));
+        console.log('[config] remote-channel 模式：已写入 HTTP MCP + Channel MCP 配置（带 Token）');
+        // Channel 模式需要权限配置
+        writeMcpPermissions();
+        console.log('[config] 已写入权限配置到 ~/.claude/settings.local.json');
+        fs.writeFileSync(VERSION_FILE, JSON.stringify({ version: VERSION, installedAt: Date.now() }, null, 2));
+        return { upgraded, previousVersion };
+    }
     // 1. 强制写入 MCP 配置到 ~/.claude.json
     let claudeConfig = {};
     if (fs.existsSync(CLAUDE_CONFIG_FILE)) {
@@ -958,11 +1061,17 @@ export function ensureGlobalConfigs(mode = 'full') {
             console.log('[config] 请设置环境变量: MCP_URL=http://远程IP:18963');
             return { upgraded: false, previousVersion };
         }
-        // Channel MCP 配置：硬编码本地路径
+        // Channel MCP 配置：使用当前模块路径
+        const binPath = path.join(__dirname, 'bin.js');
+        const channelEnv = { MCP_URL: mcpUrl };
+        const authToken = getAuthToken();
+        if (authToken) {
+            channelEnv.MCP_AUTH_TOKEN = authToken;
+        }
         claudeConfig.mcpServers['wecom-aibot-channel'] = {
             command: 'node',
-            args: ['/Volumes/Mac_Data/VScode/wecom-aibot-mcp/dist/bin.js', '--channel'],
-            env: { MCP_URL: mcpUrl },
+            args: [binPath, '--channel'],
+            env: channelEnv,
         };
         console.log(`[config] Channel-only 模式：Channel MCP 使用本地路径`);
     }
@@ -972,10 +1081,11 @@ export function ensureGlobalConfigs(mode = 'full') {
             type: 'http',
             url: 'http://127.0.0.1:18963/mcp',
         };
-        // Channel MCP 配置：硬编码本地路径
+        // Channel MCP 配置：使用当前模块路径
+        const binPath = path.join(__dirname, 'bin.js');
         claudeConfig.mcpServers['wecom-aibot-channel'] = {
             command: 'node',
-            args: ['/Volumes/Mac_Data/VScode/wecom-aibot-mcp/dist/bin.js', '--channel'],
+            args: [binPath, '--channel'],
             env: { MCP_URL: 'http://127.0.0.1:18963' },
         };
         console.log(`[config] full 模式：Channel MCP 使用本地路径`);
@@ -990,7 +1100,69 @@ export function ensureGlobalConfigs(mode = 'full') {
     console.log(`[config] 已记录版本号: ${VERSION}`);
     return { upgraded, previousVersion };
 }
-// 保存配置（直接写入 ~/.claude.json）
+// 远程安装向导（交互式输入 URL + Token）
+export async function runRemoteInstallWizard() {
+    const rl = createRL();
+    const CLAUDE_CONFIG_FILE = path.join(os.homedir(), '.claude.json');
+    try {
+        // 检测本机是否有 ~/.claude.json（判断是 Client 还是 Server）
+        const hasClaudeConfig = fs.existsSync(CLAUDE_CONFIG_FILE);
+        if (!hasClaudeConfig) {
+            // Server 安装模式：本机无 ~/.claude.json，作为远程服务器
+            console.log('\n检测到本机无 ~/.claude.json → Server 安装模式\n');
+            console.log('  Server 端只需启动 HTTP MCP Server，不写入 MCP 配置');
+            console.log('  Client 端在其他机器上安装\n');
+            const confirm = await question(rl, '确认作为远程 Server 安装？(y/N): ');
+            if (confirm.toLowerCase() !== 'y') {
+                console.log('[config] 已取消');
+                return null;
+            }
+            // Server 不写入 ~/.claude.json，只提示启动命令
+            console.log('\n─────────────────────────────────────');
+            console.log('Server 安装完成！');
+            console.log('  启动命令: npx @anthropic/wecom-aibot-mcp --http-only --start');
+            console.log('  或者:     npm run start:http');
+            console.log('─────────────────────────────────────\n');
+            console.log('[config] Client 端请在其他机器运行安装程序连接本服务器\n');
+            return 'server';
+        }
+        // Client 安装模式：本机有 ~/.claude.json，作为客户端
+        console.log('\n检测到本机有 ~/.claude.json → Client 安装模式\n');
+        console.log('  请选择连接远程服务器的方式：\n');
+        console.log('  1. 仅 HTTP MCP（轮询模式）');
+        console.log('  2. HTTP MCP + Channel MCP（推荐，消息自动唤醒）\n');
+        const choice = await question(rl, '请选择 (1/2): ');
+        const mode = choice === '2' ? 'remote-channel' : 'remote';
+        let serverUrl = await question(rl, '远程服务器地址（如 https://your-server:18963）: ');
+        while (!serverUrl) {
+            console.log('服务器地址不能为空');
+            serverUrl = await question(rl, '远程服务器地址: ');
+        }
+        // 标准化 URL（去掉尾部斜杠）
+        serverUrl = serverUrl.replace(/\/+$/, '');
+        let token = await question(rl, 'Auth Token（必填，远程服务器需配置相同 Token）: ');
+        while (!token) {
+            console.log('Auth Token 不能为空');
+            token = await question(rl, 'Auth Token: ');
+        }
+        // 写入配置
+        ensureGlobalConfigs(mode, { url: serverUrl, token });
+        console.log('\n─────────────────────────────────────');
+        console.log('Client 配置完成！');
+        console.log(`  模式:       ${mode === 'remote-channel' ? 'HTTP + Channel' : '仅 HTTP'}`);
+        console.log(`  服务器:     ${serverUrl}`);
+        console.log(`  Auth Token: ${token.slice(0, 8)}...${token.slice(-4)}`);
+        console.log('─────────────────────────────────────\n');
+        if (mode === 'remote-channel') {
+            console.log('Channel 模式优势：微信消息自动唤醒 agent，无需主动轮询');
+        }
+        console.log('[config] 请重启 Claude Code 以加载最新配置\n');
+        return mode;
+    }
+    finally {
+        rl.close();
+    }
+}
 export function saveConfig(config, instanceName) {
     ensureConfigDir(); // 确保运行时文件目录存在
     // 写入 MCP Server 配置到 ~/.claude.json
@@ -1075,7 +1247,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 +1323,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 +1351,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';
@@ -1180,15 +1365,6 @@ export async function runConfigWizard() {
 }
 // 查找机器人配置文件路径（按名称）
 export function findRobotConfigFile(robotName) {
-    // 检查默认配置文件
-    if (fs.existsSync(BOT_CONFIG_FILE)) {
-        const config = JSON.parse(fs.readFileSync(BOT_CONFIG_FILE, 'utf-8'));
-        const name = config.nameTag || `机器人-${config.botId?.slice(0, 8) || 'unknown'}`;
-        if (name === robotName) {
-            return BOT_CONFIG_FILE;
-        }
-    }
-    // 检查其他机器人配置文件
     if (fs.existsSync(CONFIG_DIR)) {
         const files = fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'));
         for (const file of files) {
@@ -1204,14 +1380,6 @@ export function findRobotConfigFile(robotName) {
 }
 // 查找机器人配置文件路径（按 botId）
 export function findRobotConfigFileByBotId(botId) {
-    // 检查默认配置文件
-    if (fs.existsSync(BOT_CONFIG_FILE)) {
-        const config = JSON.parse(fs.readFileSync(BOT_CONFIG_FILE, 'utf-8'));
-        if (config.botId === botId) {
-            return BOT_CONFIG_FILE;
-        }
-    }
-    // 检查其他机器人配置文件
     if (fs.existsSync(CONFIG_DIR)) {
         const files = fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'));
         for (const file of files) {
@@ -1283,7 +1451,7 @@ export async function detectUserIdFromMessage(client, timeoutSeconds = 60) {
  *
  * 优先级：
  * 1. 环境变量（WECOM_BOT_ID, WECOM_SECRET, WECOM_TARGET_USER）
- * 2. 保存的配置文件（~/.wecom-aibot-mcp/config.json）
+ * 2. 保存的配置文件（~/.wecom-aibot-mcp/robot-*.json）
  * 3. 运行配置向导
  */
 export async function getOrInitConfig() {

package/dist/connection-manager.js

@@ -29,8 +29,8 @@ function findRobotConfig(robotName) {
     const robot = robots.find(r => r.name === robotName || r.botId === robotName || r.name.includes(robotName));
     if (!robot)
         return null;
-    // 搜索所有配置文件（config.json + robot-*.json）
-    const allFiles = ['config.json', ...fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'))];
+    // 搜索所有机器人配置文件（robot-*.json）
+    const allFiles = fs.readdirSync(CONFIG_DIR).filter(f => f.startsWith('robot-') && f.endsWith('.json'));
     const files = allFiles.filter(f => fs.existsSync(path.join(CONFIG_DIR, f)));
     // 先按 botId 精确匹配找 secret
     for (const file of files) {