@vrs-soft/wecom-aibot-mcp 1.5.0 → 2.3.0

package/dist/config-wizard.js

@@ -12,17 +12,19 @@ import * as fs from 'fs';
 import * as path from 'path';
 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 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');
-// 版本号（与 package.json 同步）
-const VERSION = '1.4.2';
+const TASK_COMPLETED_HOOK_SCRIPT_PATH = path.join(CONFIG_DIR, 'task-completed-hook.sh');
 // 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;
 const SKILL_TEMPLATE_DIR = path.join(__dirname, '..', 'skills', 'headless-mode');
 const SKILL_TEMPLATE_FILE = path.join(SKILL_TEMPLATE_DIR, 'SKILL.md');
 // MCP 工具权限列表（需要预授权以避免 headless 模式阻断）
@@ -52,7 +54,7 @@ export function loadConfig() {
         }
     }
     catch (err) {
-        console.error('[config] 读取配置失败:', err);
+        logger.error('[config] 读取配置失败:', err);
     }
     return null;
 }
@@ -79,7 +81,7 @@ export function deleteConfig() {
         }
     }
     catch (err) {
-        console.error('[config] 删除配置失败:', err);
+        logger.error('[config] 删除配置失败:', err);
     }
 }
 // 删除 PermissionRequest hook（从 ~/.claude/settings.local.json）
@@ -105,7 +107,7 @@ export function deleteHook() {
         }
     }
     catch (err) {
-        console.error('[config] 删除 hook 失败:', err);
+        logger.error('[config] 删除 hook 失败:', err);
     }
 }
 // 删除 skill 文件
@@ -118,10 +120,80 @@ export function deleteSkills() {
         }
     }
     catch (err) {
-        console.error('[config] 删除 skill 失败:', err);
+        logger.error('[config] 删除 skill 失败:', err);
     }
 }
-// 删除单个 MCP 配置（按实例名）
+// 删除单个机器人配置（按名称）
+export function deleteRobotConfig(robotName) {
+    try {
+        const robots = listAllRobots();
+        const robot = robots.find(r => r.name === robotName);
+        if (!robot) {
+            console.log(`[config] 机器人 "${robotName}" 不存在`);
+            return false;
+        }
+        // 查找机器人对应的配置文件
+        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)) {
+            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);
+                const config = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+                const name = config.nameTag || file.replace('.json', '');
+                if (name === robotName) {
+                    configFile = filePath;
+                    break;
+                }
+            }
+        }
+        if (!configFile) {
+            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);
+        }
+        console.log(`[config] 已删除机器人: ${robotName}`);
+        return true;
+    }
+    catch (err) {
+        logger.error('[config] 删除机器人配置失败:', err);
+        return false;
+    }
+}
+// 删除单个 MCP 配置（按实例名）- 已弃用，保留用于 --uninstall
 export function deleteMcpConfig(instanceName) {
     try {
         if (!fs.existsSync(CLAUDE_CONFIG_FILE)) {
@@ -146,45 +218,54 @@ export function deleteMcpConfig(instanceName) {
         return true;
     }
     catch (err) {
-        console.error('[config] 删除配置失败:', err);
+        logger.error('[config] 删除配置失败:', err);
         return false;
     }
 }
 // 交互式删除机器人配置
-export async function deleteMcpConfigInteractive(instanceName) {
-    const instances = listAllMcpInstances();
-    if (instances.length === 0) {
+export async function deleteRobotConfigInteractive(robotName) {
+    const robots = listAllRobots();
+    if (robots.length === 0) {
         console.log('[config] 没有找到任何企业微信机器人配置');
         return;
     }
-    // 如果提供了实例名，直接删除
-    if (instanceName) {
-        deleteMcpConfig(instanceName);
-        return;
-    }
-    // 否则显示列表让用户选择
+    // 始终显示列表
     console.log('\n企业微信机器人配置列表：\n');
-    instances.forEach((inst, idx) => {
-        console.log(`  ${idx + 1}. ${inst.name} (Bot ID: ${inst.config.botId.slice(0, 12)}..., 用户: ${inst.config.targetUserId})`);
+    robots.forEach((robot, idx) => {
+        const isDefault = idx === 0;
+        const defaultTag = isDefault ? ' [默认]' : '';
+        console.log(`  ${idx + 1}. ${robot.name}${defaultTag} (Bot ID: ${robot.botId.slice(0, 12)}..., 用户: ${robot.targetUserId})`);
     });
+    // 如果提供了机器人名称，验证并删除
+    if (robotName) {
+        const found = robots.find(r => r.name === robotName);
+        if (!found) {
+            console.log(`\n[config] 未找到名为 "${robotName}" 的机器人`);
+            return;
+        }
+        console.log(`\n[config] 将删除机器人: ${robotName}`);
+        deleteRobotConfig(robotName);
+        return;
+    }
+    // 没有提供名称，让用户选择
     console.log(`  0. 取消\n`);
     const rl = createRL();
     try {
-        const choice = await question(rl, '请选择要删除的配置序号: ');
+        const choice = await question(rl, '请选择要删除的机器人序号: ');
         const choiceNum = parseInt(choice);
         if (choiceNum === 0) {
             console.log('[config] 已取消');
             return;
         }
-        if (choiceNum < 1 || choiceNum > instances.length) {
+        if (choiceNum < 1 || choiceNum > robots.length) {
             console.log('[config] 无效选择');
             return;
         }
-        const selected = instances[choiceNum - 1];
-        const confirm = await question(rl, `确认删除 "${selected.name}"？(y/N): `);
+        const selected = robots[choiceNum - 1];
+        const confirm = await question(rl, `确认删除机器人 "${selected.name}"？(y/N): `);
         if (confirm.toLowerCase() === 'y') {
-            deleteMcpConfig(selected.name);
-            console.log(`[config] 请重启 Claude Code 以生效\n`);
+            deleteRobotConfig(selected.name);
+            console.log(`[config] MCP 配置保留，其他机器人仍可正常使用\n`);
         }
         else {
             console.log('[config] 已取消');
@@ -194,6 +275,11 @@ export async function deleteMcpConfigInteractive(instanceName) {
         rl.close();
     }
 }
+// 交互式删除 MCP 配置（已弃用，保留用于兼容）
+export async function deleteMcpConfigInteractive(instanceName) {
+    // 转换为删除机器人配置
+    await deleteRobotConfigInteractive(instanceName);
+}
 // 完全卸载（删除所有相关配置）
 export function uninstall() {
     console.log('\n[config] 开始卸载 wecom-aibot-mcp...\n');
@@ -208,7 +294,7 @@ export function uninstall() {
             console.log('[config] 已删除 headless 状态索引');
         }
         catch (err) {
-            console.error('[config] 删除 headless 状态索引失败:', err);
+            logger.error('[config] 删除 headless 状态索引失败:', err);
         }
     }
     // 删除整个配置目录（包括 config.json、robot-*.json、hook 脚本、日志等）
@@ -242,7 +328,7 @@ export function uninstall() {
             }
         }
         catch (err) {
-            console.error('[config] 删除配置目录失败:', err);
+            logger.error('[config] 删除配置目录失败:', err);
         }
     }
     console.log('\n[config] 卸载完成');
@@ -471,11 +557,91 @@ fi
     fs.writeFileSync(HOOK_SCRIPT_PATH, script, { mode: 0o755 });
     console.log(`[config] Hook 脚本已写入: ${HOOK_SCRIPT_PATH}`);
 }
+// 生成并写入 TaskCompleted hook 脚本
+// 用于任务完成后自动恢复微信消息轮询
+function writeTaskCompletedHookScript() {
+    const script = `#!/bin/bash
+# wecom-aibot-mcp TaskCompleted hook
+# 任务完成后检查是否需要恢复微信消息轮询
+#
+# 固定端口: 18963
+# 检查 $(pwd)/.claude/wecom-aibot.json 的 wechatMode 和 autoApprove 字段
+
+MCP_PORT=18963
+
+# 先保存输入（TaskCompleted 事件数据）
+INPUT=$(cat)
+
+# 日志输出：--debug 模式下输出到 stderr，否则静默
+DEBUG_FILE="$HOME/.wecom-aibot-mcp/debug"
+log_debug() {
+  if [[ -f "$DEBUG_FILE" ]]; then
+    echo "$1" >&2
+  fi
+}
+
+log_debug "[$(date)] TaskCompleted hook called. INPUT: \${INPUT:0:200}"
+
+# 检查项目目录的微信模式配置文件
+PROJECT_DIR=$(pwd)
+CONFIG_FILE="$PROJECT_DIR/.claude/wecom-aibot.json"
+
+log_debug "[$(date)] Checking config: $CONFIG_FILE"
+
+# 配置文件不存在，不在微信模式
+if [[ ! -f "$CONFIG_FILE" ]]; then
+  log_debug "[$(date)] No config file, exit 0 (allow complete)"
+  exit 0
+fi
+
+# 检查 wechatMode 是否为 true（微信模式开关）
+WECHAT_MODE=$(jq -r '.wechatMode // false' "$CONFIG_FILE" 2>/dev/null)
+log_debug "[$(date)] wechatMode: $WECHAT_MODE"
+if [[ "$WECHAT_MODE" != "true" ]]; then
+  log_debug "[$(date)] wechatMode not true, exit 0 (allow complete)"
+  exit 0
+fi
+
+# 检查 autoApprove 是否为 true（需要恢复轮询的模式）
+AUTO_APPROVE=$(jq -r '.autoApprove // false' "$CONFIG_FILE" 2>/dev/null)
+log_debug "[$(date)] autoApprove: $AUTO_APPROVE"
+if [[ "$AUTO_APPROVE" != "true" ]]; then
+  log_debug "[$(date)] autoApprove not true, exit 0 (allow complete)"
+  exit 0
+fi
+
+# 检查 MCP Server 是否在线
+HEALTH=$(curl -s -m 2 "http://127.0.0.1:$MCP_PORT/health" 2>/dev/null)
+log_debug "[$(date)] Health check: $HEALTH"
+if ! echo "$HEALTH" | jq -e '.status == "ok"' > /dev/null 2>&1; then
+  log_debug "[$(date)] MCP Server offline, exit 0 (allow complete)"
+  exit 0
+fi
+
+# 获取 ccId
+CC_ID=$(jq -r '.ccId // empty' "$CONFIG_FILE" 2>/dev/null)
+log_debug "[$(date)] ccId: $CC_ID"
+if [[ -z "$CC_ID" ]]; then
+  log_debug "[$(date)] No ccId in config, exit 0 (allow complete)"
+  exit 0
+fi
+
+# 处于微信模式且 autoApprove 为 true，需要恢复轮询
+# 使用 exit code 2 阻止任务完成，并提示 Claude 调用 MCP 工具
+log_debug "[$(date)] ✅ WeChat mode active, blocking completion to resume polling"
+log_debug "[$(date)] ccId=$CC_ID, will prompt Claude to call get_pending_messages"
+echo "任务已完成，请调用 mcp__wecom-aibot__get_pending_messages(cc_id=\"$CC_ID\", timeout_ms=30000) 恢复微信消息轮询" >&2
+exit 2
+`;
+    ensureConfigDir();
+    fs.writeFileSync(TASK_COMPLETED_HOOK_SCRIPT_PATH, script, { mode: 0o755 });
+    console.log(`[config] TaskCompleted Hook 脚本已写入: ${TASK_COMPLETED_HOOK_SCRIPT_PATH}`);
+}
 // 写入 MCP Server 配置到 ~/.claude.json
 function writeMcpServerConfig(config, instanceName) {
     try {
-        // 1. 写入机器人配置到 ~/.wecom-aibot-mcp/config.json
         ensureConfigDir();
+        // 构建机器人配置对象
         const botConfig = {
             botId: config.botId,
             secret: config.secret,
@@ -484,8 +650,33 @@ function writeMcpServerConfig(config, instanceName) {
         if (config.nameTag) {
             botConfig.nameTag = config.nameTag;
         }
-        fs.writeFileSync(BOT_CONFIG_FILE, JSON.stringify(botConfig, null, 2));
-        console.log('[config] 机器人配置已写入 ~/.wecom-aibot-mcp/config.json');
+        // 检查名称唯一性（如果设置了新名称）
+        if (config.nameTag && isRobotNameExists(config.nameTag, config.botId)) {
+            console.log(`[config] ❌ 机器人名称 "${config.nameTag}" 已被其他机器人使用`);
+            console.log('[config] 请使用不同的名称');
+            return false;
+        }
+        // 按 botId 查找现有配置文件
+        const existingConfigFile = findRobotConfigFileByBotId(config.botId);
+        if (existingConfigFile) {
+            // 更新现有配置文件
+            fs.writeFileSync(existingConfigFile, JSON.stringify(botConfig, null, 2));
+            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');
+            }
+        }
         // 2. 写入 MCP 配置到 ~/.claude.json（仅 URL）
         let claudeConfig = {};
         if (fs.existsSync(CLAUDE_CONFIG_FILE)) {
@@ -505,7 +696,7 @@ function writeMcpServerConfig(config, instanceName) {
         return true;
     }
     catch (err) {
-        console.error('[config] 写入配置失败:', err);
+        logger.error('[config] 写入配置失败:', err);
         console.log('[config] ⚠️  请手动配置:');
         console.log('');
         console.log('~/.wecom-aibot-mcp/config.json:');
@@ -562,11 +753,16 @@ export async function addMcpConfig() {
             console.log(`[config] 如需更新配置，请使用 --config 命令`);
             return;
         }
-        // 检查名称是否重复（仅提示，不阻止）
+        // 检查名称是否重复（阻止）
         const duplicateName = existingRobots.find(r => r.name === robotName);
         if (duplicateName) {
-            console.log(`\n[config] ⚠️ 注意：名称 "${robotName}" 已被使用`);
-            console.log(`[config] 建议使用不同的名称以方便识别`);
+            console.log(`\n[config] ❌ 名称 "${robotName}" 已被使用`);
+            console.log(`[config] 请使用不同的名称以方便识别`);
+            console.log(`[config] 当前已配置的机器人:`);
+            existingRobots.forEach((r, i) => {
+                console.log(`  ${i + 1}. ${r.name}`);
+            });
+            return;
         }
         // 先连接验证凭证
         console.log('\n[config] 正在连接企业微信...');
@@ -631,7 +827,7 @@ export async function addMcpConfig() {
         console.log('\n[config] MCP 配置无需修改，多个机器人共享同一个 HTTP 服务');
     }
     catch (err) {
-        console.error('[config] 添加配置失败:', err);
+        logger.error('[config] 添加配置失败:', err);
         rl.close();
     }
 }
@@ -673,44 +869,6 @@ export function listAllRobots() {
     }
     return robots;
 }
-// 安装 skill 文件到 ~/.claude/skills/
-function installSkills() {
-    try {
-        const claudeSkillsDir = path.join(os.homedir(), '.claude', 'skills', 'headless-mode');
-        const skillFile = path.join(claudeSkillsDir, 'SKILL.md');
-        // 确保目录存在
-        if (!fs.existsSync(claudeSkillsDir)) {
-            fs.mkdirSync(claudeSkillsDir, { recursive: true });
-        }
-        // 尝试多个可能的源路径（支持 npm 安装和开发模式）
-        const possibleSources = [
-            // 1. 包内路径（npm 安装后的位置）
-            SKILL_TEMPLATE_FILE,
-            // 2. 开发模式路径
-            path.join(process.cwd(), 'skills', 'headless-mode', 'SKILL.md'),
-            // 3. 相对于 dist 目录的路径
-            path.join(__dirname, '..', 'skills', 'headless-mode', 'SKILL.md'),
-        ];
-        let sourceFile = null;
-        for (const src of possibleSources) {
-            if (fs.existsSync(src)) {
-                sourceFile = src;
-                break;
-            }
-        }
-        if (sourceFile) {
-            fs.copyFileSync(sourceFile, skillFile);
-            console.log(`[config] skill 文件已安装: ${skillFile}`);
-        }
-        else {
-            console.log('[config] ⚠️  skill 文件未找到，请手动创建 ~/.claude/skills/headless-mode/SKILL.md');
-            console.log('[config]    查找路径:', possibleSources.join(', '));
-        }
-    }
-    catch (err) {
-        console.error('[config] 安装 skill 文件失败:', err);
-    }
-}
 // 写入 MCP 工具权限 + 注册 PermissionRequest hook 到 Claude settings
 function writeMcpPermissions() {
     try {
@@ -751,17 +909,17 @@ function writeMcpPermissions() {
         writeHookScript();
     }
     catch (err) {
-        console.error('[config] 写入配置失败:', err);
+        logger.error('[config] 写入配置失败:', err);
         console.log('[config] ⚠️  请手动配置，详见 README');
     }
 }
 // 确保 hook 已安装（幂等，可多次调用）
 export function ensureHookInstalled() {
     writeMcpPermissions();
-    installSkills();
+    writeTaskCompletedHookScript();
 }
 // 确保所有全局配置已写入（强制覆盖，不依赖智能体）
-export function ensureGlobalConfigs() {
+export function ensureGlobalConfigs(mode = 'full') {
     ensureConfigDir();
     // 读取已安装版本
     let previousVersion;
@@ -775,7 +933,16 @@ export function ensureGlobalConfigs() {
         upgraded = true;
         console.log(`[config] 版本升级: ${previousVersion || '未安装'} -> ${VERSION}`);
     }
-    // 1. 强制写入 MCP 配置到 ~/.claude.json（覆盖）
+    // http-only 模式：不写入 MCP 配置（远程部署场景）
+    if (mode === 'http-only') {
+        console.log('[config] HTTP-only 模式：跳过 MCP 配置写入');
+        // 只写权限配置和 Hook（可选，用于本地调试）
+        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)) {
         const content = fs.readFileSync(CLAUDE_CONFIG_FILE, 'utf-8');
@@ -783,20 +950,42 @@ export function ensureGlobalConfigs() {
     }
     if (!claudeConfig.mcpServers)
         claudeConfig.mcpServers = {};
-    // 强制覆盖（不检查是否存在）
-    claudeConfig.mcpServers['wecom-aibot'] = {
-        type: 'http',
-        url: 'http://127.0.0.1:18963/mcp',
-    };
+    if (mode === 'channel-only') {
+        // Channel-only 模式：必须通过 MCP_URL 指定远程地址
+        const mcpUrl = process.env.MCP_URL;
+        if (!mcpUrl) {
+            console.log('[config] ❌ Channel-only 模式需要指定 MCP_URL');
+            console.log('[config] 请设置环境变量: MCP_URL=http://远程IP:18963');
+            return { upgraded: false, previousVersion };
+        }
+        // Channel MCP 配置：硬编码本地路径
+        claudeConfig.mcpServers['wecom-aibot-channel'] = {
+            command: 'node',
+            args: ['/Volumes/Mac_Data/VScode/wecom-aibot-mcp/dist/bin.js', '--channel'],
+            env: { MCP_URL: mcpUrl },
+        };
+        console.log(`[config] Channel-only 模式：Channel MCP 使用本地路径`);
+    }
+    else {
+        // full 模式：同时写入 HTTP MCP 和 Channel MCP 配置
+        claudeConfig.mcpServers['wecom-aibot'] = {
+            type: 'http',
+            url: 'http://127.0.0.1:18963/mcp',
+        };
+        // Channel MCP 配置：硬编码本地路径
+        claudeConfig.mcpServers['wecom-aibot-channel'] = {
+            command: 'node',
+            args: ['/Volumes/Mac_Data/VScode/wecom-aibot-mcp/dist/bin.js', '--channel'],
+            env: { MCP_URL: 'http://127.0.0.1:18963' },
+        };
+        console.log(`[config] full 模式：Channel MCP 使用本地路径`);
+    }
     fs.writeFileSync(CLAUDE_CONFIG_FILE, JSON.stringify(claudeConfig, null, 2));
     console.log('[config] 已写入 MCP 配置到 ~/.claude.json');
     // 2. 强制写入权限配置和 Hook
     writeMcpPermissions();
     console.log('[config] 已写入权限配置到 ~/.claude/settings.local.json');
-    // 3. 强制安装 skill
-    installSkills();
-    console.log('[config] 已安装 skill 到 ~/.claude/skills/');
-    // 4. 写入版本号
+    // 3. 写入版本号
     fs.writeFileSync(VERSION_FILE, JSON.stringify({ version: VERSION, installedAt: Date.now() }, null, 2));
     console.log(`[config] 已记录版本号: ${VERSION}`);
     return { upgraded, previousVersion };
@@ -805,16 +994,19 @@ export function ensureGlobalConfigs() {
 export function saveConfig(config, instanceName) {
     ensureConfigDir(); // 确保运行时文件目录存在
     // 写入 MCP Server 配置到 ~/.claude.json
-    writeMcpServerConfig(config, instanceName);
+    const success = writeMcpServerConfig(config, instanceName);
+    if (!success) {
+        return false;
+    }
     // 写入 MCP 工具权限和 Hook 到 ~/.claude/settings.local.json
     writeMcpPermissions();
-    // 安装 skill 到全局 ~/.claude/skills/（用户级别）
-    installSkills();
-    // 安装 skill 到项目目录（项目级别）
+    // 安装 skill 到项目目录（项目级别，支持远程部署）
     installSkill(process.cwd());
+    return true;
 }
 /**
  * 安装 headless-mode skill 到项目目录
+ * 返回：{ success, skillUrl? } - 如果模板不存在，返回 HTTP endpoint URL
  */
 export function installSkill(projectDir) {
     const skillDir = path.join(projectDir, '.claude', 'skills', 'headless-mode');
@@ -825,12 +1017,18 @@ export function installSkill(projectDir) {
     }
     // 检查模板文件是否存在
     if (!fs.existsSync(SKILL_TEMPLATE_FILE)) {
-        console.log('[config] Skill 模板文件不存在，跳过安装');
-        return;
+        console.log('[config] Skill 模板文件不存在，返回 HTTP endpoint URL');
+        // 返回 HTTP endpoint URL，让 agent 通过 WebFetch 下载
+        return {
+            success: false,
+            skillUrl: `${process.env.MCP_URL || 'http://127.0.0.1:18963'}/skill`,
+            message: '请通过 skillUrl 下载 skill 文件并写入本地',
+        };
     }
     // 写入 skill 文件
     fs.copyFileSync(SKILL_TEMPLATE_FILE, skillFile);
     console.log(`[config] 已安装 skill 到 ${skillFile}`);
+    return { success: true };
 }
 // 创建 readline 接口
 function createRL() {
@@ -866,69 +1064,96 @@ export async function runConfigWizard() {
     console.log('╚════════════════════════════════════════════════════════════╝');
     const rl = createRL();
     try {
-        // 检查是否有多个机器人配置
-        const instances = listAllMcpInstances();
-        let instanceName = 'wecom-aibot';
-        let robotName = '';
-        if (instances.length > 1) {
-            // 多个机器人，让用户选择要修改哪个
-            console.log('\n检测到多个机器人配置，请选择要修改的：\n');
-            instances.forEach((inst, idx) => {
-                console.log(`  ${idx + 1}. ${inst.name} (Bot ID: ${inst.config.botId.slice(0, 12)}...)`);
+        const robots = listAllRobots();
+        let targetRobot = null;
+        let isNewRobot = false;
+        // 第一步：选择要修改的机器人
+        if (robots.length === 0) {
+            console.log('\n首次配置，将创建新机器人\n');
+            isNewRobot = true;
+        }
+        else {
+            console.log('\n请选择要操作的机器人：\n');
+            robots.forEach((robot, idx) => {
+                console.log(`  ${idx + 1}. ${robot.name} (Bot ID: ${robot.botId.slice(0, 12)}...)`);
             });
-            console.log(`  ${instances.length + 1}. 添加新机器人\n`);
+            console.log(`  ${robots.length + 1}. 添加新机器人\n`);
             const choice = await question(rl, '请输入序号: ');
             const choiceNum = parseInt(choice);
-            if (choiceNum >= 1 && choiceNum <= instances.length) {
-                instanceName = instances[choiceNum - 1].name;
-                console.log(`\n已选择修改: ${instanceName}\n`);
+            if (choiceNum >= 1 && choiceNum <= robots.length) {
+                targetRobot = robots[choiceNum - 1];
+                console.log(`\n已选择修改: ${targetRobot.name}\n`);
             }
-            else if (choiceNum === instances.length + 1) {
-                // 添加新机器人
-                const newName = await question(rl, '请输入新机器人名称: ');
-                if (!newName) {
-                    console.log('[config] 机器人名称不能为空');
-                    process.exit(1);
-                }
-                robotName = newName;
-                console.log(`\n将创建新机器人: ${robotName}\n`);
+            else if (choiceNum === robots.length + 1) {
+                isNewRobot = true;
+                console.log('\n将创建新机器人\n');
             }
             else {
                 console.log('[config] 无效选择');
                 process.exit(1);
             }
         }
-        else if (instances.length === 1) {
-            instanceName = instances[0].name;
-            console.log(`\n将修改现有配置: ${instanceName}\n`);
-        }
-        else {
-            // 首次配置，要求输入机器人名称
-            console.log('\n首次配置，请输入机器人信息：\n');
-            const newName = await question(rl, '机器人名称（用于识别，如"工作机器人"）: ');
-            if (!newName) {
+        // 第二步：输入机器人名称
+        let robotName = await question(rl, `机器人名称（${targetRobot ? `当前: ${targetRobot.name}` : '用于识别'}）: `);
+        if (!robotName) {
+            if (targetRobot) {
+                robotName = targetRobot.name; // 保持原名称
+                console.log(`[config] 保持原名称: ${robotName}`);
+            }
+            else {
                 console.log('[config] 机器人名称不能为空');
                 process.exit(1);
             }
-            robotName = newName;
-            console.log(`\n将创建机器人: ${robotName}\n`);
         }
-        // 1. 获取 Bot ID
-        let botId = await question(rl, 'Bot ID: ');
-        while (!botId) {
-            console.log('Bot ID 不能为空');
-            botId = await question(rl, 'Bot ID: ');
+        // 检查名称是否与其他机器人重复
+        if (isNewRobot || (targetRobot && robotName !== targetRobot.name)) {
+            const duplicateName = robots.find(r => r.name === robotName && r !== targetRobot);
+            if (duplicateName) {
+                console.log(`[config] ❌ 名称 "${robotName}" 已被使用`);
+                process.exit(1);
+            }
         }
-        // 2. 获取 Secret
-        let secret = await question(rl, 'Secret: ');
-        while (!secret) {
-            console.log('Secret 不能为空');
-            secret = await question(rl, 'Secret: ');
+        // 第三步：输入 Bot ID
+        let botId = await question(rl, `Bot ID（${targetRobot ? `当前: ${targetRobot.botId.slice(0, 12)}...` : '必填'}）: `);
+        if (!botId) {
+            if (targetRobot) {
+                botId = targetRobot.botId; // 保持原 Bot ID
+                console.log(`[config] 保持原 Bot ID`);
+            }
+            else {
+                console.log('Bot ID 不能为空');
+                botId = await question(rl, 'Bot ID: ');
+                if (!botId) {
+                    console.log('[config] Bot ID 不能为空');
+                    process.exit(1);
+                }
+            }
         }
-        // 3. 目标用户 ID 稍后通过消息自动识别
+        // 第四步：输入 Secret
+        let secret = await question(rl, `Secret（${targetRobot ? `当前: ${targetRobot.botId.slice(0, 8)}...` : '必填'}）: `);
+        if (!secret) {
+            if (targetRobot) {
+                // 读取原 Secret
+                const configFile = findRobotConfigFile(targetRobot.name);
+                if (configFile) {
+                    const config = JSON.parse(fs.readFileSync(configFile, 'utf-8'));
+                    secret = config.secret;
+                    console.log(`[config] 保持原 Secret`);
+                }
+            }
+            else {
+                console.log('Secret 不能为空');
+                secret = await question(rl, 'Secret: ');
+                if (!secret) {
+                    console.log('[config] Secret 不能为空');
+                    process.exit(1);
+                }
+            }
+        }
+        // 第五步：目标用户（稍后通过消息自动识别）
         console.log('\n─────────────────────────────────────');
         console.log('配置确认：');
-        console.log(`  机器人名称: ${robotName || instanceName}`);
+        console.log(`  机器人名称: ${robotName}`);
         console.log(`  Bot ID:     ${botId}`);
         console.log(`  Secret:     ${secret.slice(0, 8)}...${secret.slice(-4)}`);
         console.log(`  目标用户:   （将通过消息自动识别）`);
@@ -943,14 +1168,72 @@ export async function runConfigWizard() {
             botId,
             secret,
             targetUserId: '', // 稍后通过消息识别
-            nameTag: robotName || undefined,
+            nameTag: robotName,
         };
+        // 如果是修改现有机器人，返回其 instanceName（用于删除旧配置）
+        const instanceName = targetRobot ? targetRobot.name : 'wecom-aibot';
         return { config, instanceName };
     }
     finally {
         rl.close();
     }
 }
+// 查找机器人配置文件路径（按名称）
+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) {
+            const filePath = path.join(CONFIG_DIR, file);
+            const config = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            const name = config.nameTag || file.replace('.json', '');
+            if (name === robotName) {
+                return filePath;
+            }
+        }
+    }
+    return null;
+}
+// 查找机器人配置文件路径（按 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) {
+            const filePath = path.join(CONFIG_DIR, file);
+            const config = JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+            if (config.botId === botId) {
+                return filePath;
+            }
+        }
+    }
+    return null;
+}
+// 检查机器人名称是否已存在（排除指定 botId）
+export function isRobotNameExists(name, excludeBotId) {
+    const robots = listAllRobots();
+    for (const robot of robots) {
+        if (robot.name === name && robot.botId !== excludeBotId) {
+            return true;
+        }
+    }
+    return false;
+}
 /**
  * 通过等待用户消息来识别用户 ID（使用已有的 client）
  */
@@ -1029,9 +1312,9 @@ export async function getOrInitConfig() {
     }
     // 3. 非 TTY（MCP stdio 模式）不能启动交互向导
     if (!process.stdin.isTTY) {
-        console.error('[config] 未找到配置，且当前为非交互模式。');
-        console.error('[config] 请在 ~/.claude.json 的 mcpServers 中设置环境变量:');
-        console.error('[config]   WECOM_BOT_ID, WECOM_SECRET, WECOM_TARGET_USER');
+        logger.error('[config] 未找到配置，且当前为非交互模式。');
+        logger.error('[config] 请在 ~/.claude.json 的 mcpServers 中设置环境变量:');
+        logger.error('[config]   WECOM_BOT_ID, WECOM_SECRET, WECOM_TARGET_USER');
         process.exit(1);
     }
     // 4. TTY 模式下运行配置向导