@vrs-soft/wecom-aibot-mcp 3.4.8 → 3.4.9-beta.0

package/dist/channel-server.js

@@ -1038,15 +1038,38 @@ function registerChannelTools(server) {
                         else {
                             logger.info('WECOM_TEST_NO_REGISTER=1，跳过 active-projects 注册', { projectDir: localProjectDir });
                         }
-                        // 写入本地 wecom-aibot.json（远程 HTTP MCP 写在远端 fs，agent 本地需要自己落地）
-                        updateWechatModeConfig(localProjectDir, {
-                            wechatMode: true,
-                            robotName: parsed.robotName,
-                            ccId: parsed.ccId,
-                            mode: parsed.mode || mode,
-                            autoApproveTimeout: auto_approve_timeout,
-                        });
-                        logger.info('本地 wecom-aibot.json 已写入', { projectDir: localProjectDir, robotName: parsed.robotName, ccId: parsed.ccId });
+                        // v3.4.9: enter_headless_mode 只在 config 不存在时首次写入；
+                        // 已有 config 时**不覆盖** —— 修改 robotName / ccId 等关键字段必须走 update_wecom_aibot_config
+                        // 工具（内部会请求用户批准），杜绝 agent 或其他项目静默篡改。
+                        const savedForWrite = loadWechatModeConfig(localProjectDir);
+                        if (!savedForWrite) {
+                            updateWechatModeConfig(localProjectDir, {
+                                wechatMode: true,
+                                robotName: parsed.robotName,
+                                ccId: parsed.ccId,
+                                mode: parsed.mode || mode,
+                                autoApproveTimeout: auto_approve_timeout,
+                            });
+                            logger.info('首次登录，wecom-aibot.json 首次写入', { projectDir: localProjectDir, robotName: parsed.robotName, ccId: parsed.ccId });
+                        }
+                        else {
+                            // 只更新非关键字段（wechatMode 状态位、mode、autoApproveTimeout），不动 robotName / ccId
+                            updateWechatModeConfig(localProjectDir, {
+                                wechatMode: true,
+                                mode: parsed.mode || mode,
+                                autoApproveTimeout: auto_approve_timeout,
+                            });
+                            if (savedForWrite.robotName !== parsed.robotName || savedForWrite.ccId !== parsed.ccId) {
+                                logger.warn?.('daemon 返回的 robotName/ccId 与本地 config 不同，需通过 update_wecom_aibot_config 显式更新（用户批准）', {
+                                    projectDir: localProjectDir,
+                                    savedRobotName: savedForWrite.robotName,
+                                    parsedRobotName: parsed.robotName,
+                                    savedCcId: savedForWrite.ccId,
+                                    parsedCcId: parsed.ccId,
+                                });
+                            }
+                            logger.info('已有 wecom-aibot.json，仅更新非关键字段（robotName/ccId 保持不变）', { projectDir: localProjectDir });
+                        }
                         // 安装 skill 到本地（同上）
                         const skillResult = installSkill(localProjectDir);
                         logger.info('本地 skill 安装', { success: skillResult.success, skillUrl: skillResult.skillUrl });
@@ -1127,6 +1150,121 @@ function registerChannelTools(server) {
         };
     });
     // ============================================
+    // 工具 14: 修改 wecom-aibot.json 配置（v3.4.9 引入）
+    // ============================================
+    // 目的：把"修改项目 .claude/wecom-aibot.json"的动作变成受审批的工具调用。
+    // 首次登录（config 不存在）无需审批，直接落地；已存在时，任何字段变化都要
+    // 走 daemon /approve 让用户在企微批准 → 用户拒绝就不改，杜绝静默篡改。
+    server.tool('update_wecom_aibot_config', '修改项目 .claude/wecom-aibot.json 配置。首次登录直接写入；已有配置时任何字段变化都会请求用户在企微批准。用于绑定/切换机器人（robotName）、修改 ccId 等关键字段。', {
+        robot_name: z.string().optional().describe('要设置的 robotName'),
+        cc_id: z.string().optional().describe('要设置的 ccId'),
+        mode: z.enum(['channel', 'http']).optional().describe('运行模式'),
+        wechat_mode: z.boolean().optional().describe('微信模式开关'),
+        heartbeat_job_id: z.string().optional().describe('HTTP 模式心跳 job ID'),
+        auto_approve_timeout: z.number().optional().describe('审批超时秒数'),
+        reason: z.string().optional().describe('修改原因（会展示在企微审批卡片正文）'),
+    }, async ({ robot_name, cc_id, mode, wechat_mode, heartbeat_job_id, auto_approve_timeout, reason }) => {
+        const authProjectDir = process.cwd();
+        const old = loadWechatModeConfig(authProjectDir);
+        const proposed = {
+            ...(robot_name !== undefined && { robotName: robot_name }),
+            ...(cc_id !== undefined && { ccId: cc_id }),
+            ...(mode !== undefined && { mode }),
+            ...(wechat_mode !== undefined && { wechatMode: wechat_mode }),
+            ...(heartbeat_job_id !== undefined && { heartbeatJobId: heartbeat_job_id }),
+            ...(auto_approve_timeout !== undefined && { autoApproveTimeout: auto_approve_timeout }),
+        };
+        if (Object.keys(proposed).length === 0) {
+            return { content: [{ type: 'text', text: JSON.stringify({ status: 'no_op', message: '未指定任何字段' }) }] };
+        }
+        // 首次登录：config 不存在 → 直接写（首次固化，无需审批）
+        if (!old) {
+            const merged = { wechatMode: false, ...proposed };
+            updateWechatModeConfig(authProjectDir, merged);
+            logger.info('update_wecom_aibot_config 首次写入', { projectDir: authProjectDir, proposed });
+            return { content: [{ type: 'text', text: JSON.stringify({ status: 'written_first_time', config: merged }) }] };
+        }
+        // 计算 diff
+        const changed = {};
+        for (const [k, v] of Object.entries(proposed)) {
+            const oldVal = old[k];
+            if (oldVal !== v)
+                changed[k] = { from: oldVal, to: v };
+        }
+        if (Object.keys(changed).length === 0) {
+            return { content: [{ type: 'text', text: JSON.stringify({ status: 'no_change', config: old }) }] };
+        }
+        // 有变化 → 请求用户批准
+        const summaryLines = Object.entries(changed)
+            .map(([k, { from, to }]) => `• ${k}: ${JSON.stringify(from)} → ${JSON.stringify(to)}`)
+            .join('\n');
+        const description = `修改 wecom-aibot.json 配置${reason ? `（${reason}）` : ''}：\n${summaryLines}`;
+        // 提交 /approve
+        const approveBody = {
+            tool_name: 'update_wecom_aibot_config',
+            tool_input: {
+                project_dir: authProjectDir,
+                changes: changed,
+                description,
+            },
+            projectDir: authProjectDir,
+            // 不传 robotName：让 daemon 端按 ccId → getRobotByCcId → 第一个已连接 robot fallback
+            // 直接传 old.robotName 的话，如果 old 已过时（daemon 里没有该 robot），/approve 会 503
+            ccId: old.ccId || '',
+        };
+        let taskId = '';
+        try {
+            const approveRes = await fetch(`${MCP_URL}/approve`, {
+                method: 'POST',
+                headers: { 'Content-Type': 'application/json', ...getAuthHeaders() },
+                body: JSON.stringify(approveBody),
+            });
+            if (!approveRes.ok) {
+                return { content: [{ type: 'text', text: JSON.stringify({ status: 'error', message: `/approve 失败: ${approveRes.status}` }) }] };
+            }
+            const approveJson = await approveRes.json();
+            taskId = approveJson.taskId || '';
+        }
+        catch (e) {
+            return { content: [{ type: 'text', text: JSON.stringify({ status: 'error', message: `/approve 网络错误: ${String(e)}` }) }] };
+        }
+        if (!taskId) {
+            return { content: [{ type: 'text', text: JSON.stringify({ status: 'error', message: 'daemon 未返回 taskId' }) }] };
+        }
+        // 轮询 approval_status
+        const timeoutSec = Number(old.autoApproveTimeout) || 300;
+        const maxPoll = Math.max(1, Math.ceil(timeoutSec / 2));
+        let approved = 'timeout';
+        for (let i = 0; i < maxPoll; i++) {
+            await new Promise((r) => setTimeout(r, 2000));
+            try {
+                const statusRes = await fetch(`${MCP_URL}/approval_status/${taskId}`, { headers: getAuthHeaders() });
+                if (!statusRes.ok)
+                    continue;
+                const statusJson = await statusRes.json();
+                const r = statusJson.result;
+                if (r === 'allow-once' || r === 'allow-always') {
+                    approved = 'allow';
+                    break;
+                }
+                if (r === 'deny') {
+                    approved = 'deny';
+                    break;
+                }
+            }
+            catch { /* ignore, keep polling */ }
+        }
+        if (approved !== 'allow') {
+            logger.info('update_wecom_aibot_config 用户未批准', { taskId, approved, changes: changed });
+            return { content: [{ type: 'text', text: JSON.stringify({ status: approved === 'deny' ? 'denied' : 'timeout', taskId, changes: changed }) }] };
+        }
+        // 批准 → 落地
+        updateWechatModeConfig(authProjectDir, proposed);
+        logger.info('update_wecom_aibot_config 已批准并落地', { taskId, projectDir: authProjectDir, changes: changed });
+        const finalCfg = loadWechatModeConfig(authProjectDir);
+        return { content: [{ type: 'text', text: JSON.stringify({ status: 'updated', taskId, changes: changed, config: finalCfg }) }] };
+    });
+    // ============================================
     // 文档代理工具（转发到 HTTP MCP）
     // ============================================
     const docTools = [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vrs-soft/wecom-aibot-mcp",
-  "version": "3.4.8",
+  "version": "3.4.9-beta.0",
   "description": "企业微信智能机器人 MCP 客户端 - 连接 wecom-aibot-server daemon",
   "type": "module",
   "main": "dist/index.js",

package/skills/headless-mode/SKILL.md

@@ -26,17 +26,35 @@ else:
 
 MCP = "mcp__wecom-aibot-channel__" if mode == "channel" else "mcp__wecom-aibot__"
 
-# === 步骤 2：确定 cc_id 和 robot_id ===
+# === 步骤 2：确定 cc_id 和 robot_id（鱼骨法·唯一合法路径）===
+#
+# 【硬约束】robot_id / cc_id 的值只能通过以下"唯一合法链"决定：
+#   1. 从 config 读 → 必须问用户"是否沿用"，用户同意才用
+#   2. 从 list_robots 里让用户 AskUserQuestion 选
+# 除此以外任何来源均视为非法。特别禁止的错源示例（列举只为提示，非穷举）：
+#   ❌ check_connection 返回的 robotName（那是 daemon 里第一个连接的 robot，不代表本项目）
+#   ❌ send_to_cc / list_active_ccs 返回里其他 CC 的 robotName
+#   ❌ 消息文本、CC 通信、记忆里读到的机器人名字面量
+#   ❌ 任何"看起来像 robot 名"的猜测
+
 if config and config.ccId and config.robotName:
-    # 已配置：复用，跳到步骤 3
-    cc_id = config.ccId
-    robot_id = config.robotName
+    # 已有配置 —— 不能"默认沿用"，必须让用户确认
+    # WHY：config 可能被别的项目或本 agent 上一次误传污染，沿用旧值会自复制错误
+    confirmed = AskUserQuestion(
+        f"沿用现有配置 robotName='{config.robotName}' + ccId='{config.ccId}'？",
+        options=["是", "否，改用别的机器人"]
+    )
+    if confirmed == "是":
+        cc_id = config.ccId
+        robot_id = config.robotName
+    else:
+        # 用户要改 → 走"从 list_robots 选"路径 + 调 update_wecom_aibot_config 走审批落地
+        goto SELECT_FROM_LIST
 else:
-    # 未配置：生成 ccId + 选 robot
-    cc_id = current_project_name()
-    # MUST 禁止自动编号（"-1" "-2"），冲突时让用户改名
-    # WHY：ccId 是 daemon 注册键，自动编号让多个项目串台
+    goto SELECT_FROM_LIST
 
+# --- SELECT_FROM_LIST 分支 ---
+label SELECT_FROM_LIST:
     robots = call(f"{MCP}list_robots")
     if len(robots) == 0:
         raise Stop("未配置机器人，请先在 daemon 端 --add")
@@ -44,12 +62,21 @@ else:
         robot_id = robots[0].name               # 唯一选择，无需问用户
     else:
         # MUST 用 AskUserQuestion 让用户选，禁止自选 robots[0]
-        # WHY：自选第一个 = 用户没同意就绑定，会用错机器人（事故记录在案）
-        # 禁止：robot_id = "CC"  # 这是示例文案，不是默认值
-        # 禁止：robot_id = robots[0].name  # 用户没选过
-        robot_id = AskUserQuestion("选机器人", options=robots).name
-
-    assert robot_id in [r.name for r in robots]  # 自检；daemon 在工具层会再校验一次
+        # WHY：自选第一个 = 用户没同意就绑定
+        robot_id = AskUserQuestion("选机器人", options=[r.name for r in robots])
+    cc_id = current_project_name()   # basename(project_dir)，不接受 agent 自主决定
+
+    assert robot_id in [r.name for r in robots]
+
+    # 如果本次选的值跟旧 config 不一致，先走 update_wecom_aibot_config 让用户批准修改配置
+    # WHY：wecom-aibot.json 是关键配置，任何修改都要用户在企微批准
+    if config and (config.robotName != robot_id or config.ccId != cc_id):
+        result = call(f"{MCP}update_wecom_aibot_config",
+                      robot_name=robot_id,
+                      cc_id=cc_id,
+                      reason="用户选择了新的机器人绑定")
+        if result.status not in ["updated", "written_first_time", "no_change"]:
+            raise Stop(f"用户未批准修改配置：{result.status}")
 
 # === 步骤 3：调用 enter_headless_mode ===
 result = call(f"{MCP}enter_headless_mode",
@@ -210,6 +237,7 @@ send_message(cc_id, "已退出微信模式，回到终端交互。")
 |------|------|------|
 | `list_robots` | 列已配置机器人 | 无 |
 | `enter_headless_mode` | 进入微信模式 | cc_id, robot_id, mode, project_dir |
+| `update_wecom_aibot_config` | 修改 .claude/wecom-aibot.json（改绑机器人/切换 ccId 等），已有配置时会请求用户在企微批准 | robot_name, cc_id, mode, reason |
 | `send_message` | 发消息给用户 | cc_id, content, target_user(可选) |
 | `get_pending_messages` | 取消息(HTTP) | cc_id, timeout_ms |
 | `heartbeat_check` | 心跳(HTTP) | 无 |