cloudcc-cli 2.2.5 → 2.2.7

package/src/mcp/cliRunner.js

@@ -0,0 +1,61 @@
+const path = require("path");
+const { spawnSync } = require("child_process");
+
+function runCcCommand(args, options = {}) {
+    const { cwd = process.cwd(), timeoutMs = 120000 } = options;
+    const ccEntry = path.resolve(__dirname, "../../bin/cc.js");
+
+    const result = spawnSync(process.execPath, [ccEntry, ...args], {
+        cwd,
+        encoding: "utf8",
+        timeout: timeoutMs,
+        maxBuffer: 10 * 1024 * 1024
+    });
+
+    const stdout = (result.stdout || "").trim();
+    const stderr = (result.stderr || "").trim();
+    const hasError = Boolean(result.error);
+    const code = typeof result.status === "number" ? result.status : -1;
+
+    return {
+        success: !hasError && code === 0,
+        code,
+        stdout,
+        stderr,
+        error: hasError ? result.error.message : ""
+    };
+}
+
+function buildRunDetail(runResult) {
+    return [runResult.error, runResult.stderr, runResult.stdout].filter(Boolean).join("\n");
+}
+
+function runCcJsonCommand(args, options = {}) {
+    const runResult = runCcCommand(args, options);
+    if (!runResult.success) {
+        return {
+            success: false,
+            runResult,
+            detail: buildRunDetail(runResult),
+            data: null
+        };
+    }
+
+    try {
+        const data = runResult.stdout ? JSON.parse(runResult.stdout) : null;
+        return { success: true, runResult, detail: "", data };
+    } catch (error) {
+        return {
+            success: false,
+            runResult,
+            detail: `JSON 解析失败: ${error.message}\n${buildRunDetail(runResult)}`,
+            data: null
+        };
+    }
+}
+
+module.exports = {
+    runCcCommand,
+    runCcJsonCommand,
+    buildRunDetail
+};

package/src/mcp/index.js

@@ -11,7 +11,6 @@ const { McpServer } = require("@modelcontextprotocol/sdk/server/mcp.js");
 const { z } = require("zod");
 
 // 导入各个工具的处理器
-const ccdkHandler = require("./tools/ccdk/handler.js");
 const devEnvHandler = require("./tools/Dev Environment Creator/handler.js");
 const keyGuideHandler = require("./tools/Developer Key Setup Guide/handler.js");
 const devEnvValidatorHandler = require("./tools/Dev Environment Validator/handler.js");
@@ -20,6 +19,10 @@ const customObjectHandler = require('./tools/Object Creator/handler.js');
 const objectListHandler = require('./tools/Object List Retriever/handler.js');
 const objectFieldsHandler = require('./tools/Object Fields Retriever/handler.js');
 const fieldCreatorHandler = require('./tools/Object Fields Creator/handler.js');
+// 菜单相关工具处理器
+const menuCreatorHandler = require('./tools/Menu Creator/handler.js');
+// 应用相关工具处理器
+const applicationCreatorHandler = require('./tools/Application Creator/handler.js');
 // 自定义类工具处理器
 const classesHandler = require("./tools/Class List Retriever/handler.js");
 const classCreatorHandler = require('./tools/Class Creator/handler.js');
@@ -48,17 +51,18 @@ const componentEditorGuideHandler = require('./tools/Component Editor Guide/hand
 const componentPullerHandler = require('./tools/Component Puller/handler.js');
 const componentPublisherHandler = require('./tools/Component Publisher/handler.js');
 // 客户端脚本工具处理器
-const clientScriptCreatorHandler = require('./tools/Client Script Creator/handler.js');
 const clientScriptListHandler = require('./tools/Client Script List Retriever/handler.js');
 const clientScriptDetailHandler = require('./tools/Client Script Detail Retriever/handler.js');
 const clientScriptEditorGuideHandler = require('./tools/Client Script Editor Guide/handler.js');
 const clientScriptPullerHandler = require('./tools/Client Script Puller/handler.js');
 const clientScriptPublisherHandler = require('./tools/Client Script Publisher/handler.js');
+// JSP 迁移工具处理器
+const jspMigratorHandler = require('./tools/JSP Migrator/handler.js');
 // CloudCC 开发项目概要工具处理器
 const cloudccOverviewHandler = require('./tools/CloudCC Development Overview/handler.js');
 
 const mcpServer = new McpServer({
-    name: 'cctool',
+    name: 'cici',
     version: '1.0.0'
 });
 
@@ -68,11 +72,11 @@ mcpServer.registerTool(
     {
         description: '帮助开发者检查本地环境是否支持开发 CloudCC 应用（例如自定义组件、自定义类），并按步骤、关键词、平台或难度返回对应的操作或验证命令。',
         inputSchema: z.object({
-            step: z.number().int().optional().describe('可选，按步骤号返回具体步骤'),
-            search: z.string().optional().describe('可选，按关键词搜索步骤'),
-            difficulty: z.enum(['easy', 'medium', 'hard']).optional().describe('可选，按难度过滤'),
+            // step: z.number().int().optional().describe('可选，按步骤号返回具体步骤'),
+            // search: z.string().optional().describe('可选，按关键词搜索步骤'),
+            // difficulty: z.enum(['easy', 'medium', 'hard']).optional().describe('可选，按难度过滤'),
             platform: z.enum(['windows', 'macos', 'linux']).optional().describe('可选，按平台获取命令'),
-            command: z.boolean().optional().describe('可选，返回所有命令的汇总')
+            // command: z.boolean().optional().describe('可选，返回所有命令的汇总')
         })
     },
     devEnvValidatorHandler.getDevEnvSetup
@@ -84,11 +88,11 @@ mcpServer.registerTool(
     {
         description: '获取 CloudCC 开发环境搭建指南，帮助用户按步骤完成开发环境的安装与配置。',
         inputSchema: z.object({
-            step: z.number().int().optional(),
-            search: z.string().optional(),
-            difficulty: z.enum(['easy', 'medium', 'hard']).optional(),
+            // step: z.number().int().optional(),
+            // search: z.string().optional(),
+            // difficulty: z.enum(['easy', 'medium', 'hard']).optional(),
             platform: z.enum(['windows', 'macos', 'linux']).optional(),
-            command: z.boolean().optional(),
+            // command: z.boolean().optional(),
         })
     },
     devEnvHandler.getDevEnvSetup
@@ -161,6 +165,36 @@ mcpServer.registerTool(
     fieldCreatorHandler.createObjectField
 );
 
+// ==================== Menu Creator ====================
+mcpServer.registerTool(
+    'create_menu',
+    {
+        description: '为 CloudCC CRM 创建菜单（标签页）。支持四种类型的菜单：object（自定义对象）、page（自定义页面）、script（自定义脚本）、site（站点）。菜单将在导航栏中显示，允许用户快速访问相应的资源。',
+        inputSchema: z.object({
+            menuType: z.enum(['object', 'page', 'script', 'site']).describe('菜单类型：object（自定义对象菜单）、page（自定义页面菜单）、script（自定义脚本菜单）、site（站点菜单）'),
+            resourceId: z.string().min(1).describe('资源ID。根据菜单类型不同，可以是：对象ID（object）、页面ID（page）、脚本ID（script）或站点ID（site）。可通过相应的列表工具获取'),
+            tabName: z.string().min(1).describe('菜单标签名称，将在导航栏中显示，建议使用对象的显示标签'),
+            projectPath: z.string().describe('项目根路径，默认为当前工作目录')
+        })
+    },
+    menuCreatorHandler.createMenuTool
+);
+
+// ==================== Application Creator ====================
+mcpServer.registerTool(
+    'create_application',
+    {
+        description: '在 CloudCC CRM 系统中创建一个应用（Application）。应用可以包含多个菜单，用于组织和管理相关的功能模块。',
+        inputSchema: z.object({
+            appName: z.string().min(1).describe('应用名称，将在系统中显示的标签'),
+            appCode: z.string().min(1).describe('应用代码，应用的唯一标识符'),
+            menuIds: z.string().optional().describe('菜单ID列表（可选），多个菜单ID时用逗号分隔。如果不提供，将使用默认菜单ID acf000001。如果提供，系统会自动确保 acf000001 包含在列表中'),
+            projectPath: z.string().describe('项目根路径，默认为当前工作目录')
+        })
+    },
+    applicationCreatorHandler.createApplicationTool
+);
+
 // ==================== Class List Retriever ====================
 mcpServer.registerTool(
     'get_custom_class_list',
@@ -428,7 +462,7 @@ mcpServer.registerTool(
 mcpServer.registerTool(
     'publish_custom_component',
     {
-        description: '将 Vue 自定义组件编译并发布到 CloudCC 服务器，必须使用返回的命令，在控制台执行',
+        description: '将 Vue 自定义组件编译并发布到 CloudCC 服务器',
         inputSchema: z.object({
             componentName: z.string().min(1).describe('要发布的组件名称'),
             projectPath: z.string().optional().describe('项目根目录路径，默认为当前工作目录')
@@ -628,4 +662,42 @@ mcpServer.registerTool(
     cloudccOverviewHandler.getCloudCCDevelopmentOverview
 );
 
+// ==================== JSP Migration Analyzer 工具 ====================
+mcpServer.registerTool(
+    'analyze_jsp_migration',
+    {
+        description: '分析旧 JSP 页面，提取 reason 分支、对象依赖和迁移风险，输出迁移报告（不落地代码）。',
+        inputSchema: z.object({
+            jspPath: z.string().min(1).describe('JSP 文件路径（绝对路径或相对 projectPath）'),
+            helpDocPath: z.string().optional().describe('帮助文档路径（可选），如 jspTemp/帮助文档.md'),
+            projectPath: z.string().optional().describe('项目根路径，默认当前工作目录'),
+            className: z.string().optional().describe('可选，指定生成类名'),
+            componentName: z.string().optional().describe('可选，指定生成组件名'),
+            outputProjectPath: z.string().optional().describe('可选，输出项目路径，默认等于 projectPath'),
+            reportDir: z.string().optional().describe('可选，报告目录，默认 migration-report')
+        })
+    },
+    jspMigratorHandler.analyzeJspMigration
+);
+
+// ==================== JSP Splitter 工具 ====================
+mcpServer.registerTool(
+    'split_jsp_to_cloudcc',
+    {
+        description: '将旧 JSP 页面拆分为 CloudCC 自定义类和自定义组件，并生成迁移报告。支持 apply/dry-run 两种模式。',
+        inputSchema: z.object({
+            jspPath: z.string().min(1).describe('JSP 文件路径（绝对路径或相对 projectPath）'),
+            helpDocPath: z.string().optional().describe('帮助文档路径（可选），如 jspTemp/帮助文档.md'),
+            projectPath: z.string().optional().describe('项目根路径，默认当前工作目录'),
+            outputProjectPath: z.string().optional().describe('输出项目路径，默认等于 projectPath'),
+            className: z.string().optional().describe('可选，指定生成类名'),
+            componentName: z.string().optional().describe('可选，指定生成组件名'),
+            reportDir: z.string().optional().describe('可选，报告目录，默认 migration-report'),
+            mode: z.enum(['apply', 'dry-run']).optional().default('apply').describe('apply: 生成文件；dry-run: 仅分析'),
+            overwrite: z.boolean().optional().default(false).describe('是否覆盖已存在文件，默认 false')
+        })
+    },
+    jspMigratorHandler.splitJspToCloudcc
+);
+
 module.exports = mcpServer;

package/src/mcp/readme.md

@@ -14,7 +14,7 @@
 * 检查当前环境的开发者密钥是否配置正确
 * 指导如何获取密钥，以及如何配置
 
-### 4:创建应用程序Tool - App Creator
+### 4:创建应用程序Tool - App Creator ✅
 * 创建一个应用程序
 
 ### 5:查询应用列表 - App List Retriever
@@ -131,7 +131,10 @@
 * 这是开始 CloudCC 开发前必须查看的工具
 * 需要使用知识库
 
-### 42:审批Tool - Approval
+### 42:审批Tool - Approval ✅
 * 拉取所有的待审批的记录
 * 通过id审批通过记录
-* 通过id拒绝审批通过记录
+* 通过id拒绝审批通过记录
+
+### 43:菜单Tool - Menu ✅
+* 创建自定义对象菜单

package/src/mcp/tools/Application Creator/handler.js

@@ -0,0 +1,78 @@
+/**
+ * Application Creator Handler
+ * 提供创建应用（Application）的 MCP 工具实现
+ */
+
+const path = require('path');
+const { runCcCommand, buildRunDetail } = require('../../cliRunner');
+
+/**
+ * 创建应用
+ * @param {{
+ *   appName: string,
+ *   appCode: string,
+ *   menuIds?: string,
+ *   projectPath?: string
+ * }} params
+ */
+async function createApplicationTool(params = {}) {
+    try {
+        const { appName, appCode, menuIds, projectPath } = params;
+
+        // 验证必需参数
+        if (!appName || !appCode) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: '✗ 参数缺失: appName (应用名称) 和 appCode (应用代码) 必须提供\n\n参数说明:\n- appName: 应用的显示名称\n- appCode: 应用的代码标识\n- menuIds: 菜单ID列表（可选，多个时用逗号分隔，默认包含 acf000001）\n- projectPath: 项目路径（可选，默认为当前工作目录）'
+                }]
+            };
+        }
+
+        const resolvedPath = path.resolve(projectPath || '.');
+
+        // 构建参数数组，格式: ['create', 'application', path, p1, p2, duel1]
+        // 注意：argvs[2] 是 path，argvs[3] 是 p1，argvs[4] 是 p2，argvs[5] 是 duel1
+        const args = [
+            'create',
+            'application',
+            resolvedPath,
+            appName,
+            appCode
+        ];
+
+        // 如果提供了 menuIds，添加到参数中
+        if (menuIds) {
+            args.push(menuIds);
+        }
+
+        const runResult = runCcCommand(args, { cwd: resolvedPath });
+
+        if (runResult.success) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✓ 应用创建成功!\n\n应用名称: ${appName}\n应用代码: ${appCode}\n项目目录: ${resolvedPath}\n菜单ID: ${menuIds || 'acf000001（默认）'}\n\n应用已成功创建并配置到 CloudCC 系统中。`
+                }]
+            };
+        } else {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `⚠ 应用创建遇到问题\n\n${buildRunDetail(runResult) || 'cc 命令执行失败'}\n\n请检查:\n1. 应用名称和应用代码是否符合规范\n2. CloudCC服务器连接是否正常\n3. 项目配置是否正确\n4. 是否有足够的权限创建应用\n5. 菜单ID是否正确`
+                }]
+            };
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 应用创建失败: ${error.message}\n\n错误详情:\n${error.stack || '无详细信息'}\n\n请检查:\n1. 应用名称和应用代码是否正确\n2. 项目路径是否正确\n3. CloudCC服务器连接是否正常\n4. 项目配置文件是否存在\n5. 菜单ID格式是否正确（多个时用逗号分隔）`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    createApplicationTool
+};

package/src/mcp/tools/Approval/handler.js

@@ -1,151 +1,5 @@
-/**
- * Approval 工具处理器
- * 提供审批相关的功能：拉取待审批记录、审批通过、拒绝审批
- */
-
 const { z } = require('zod');
-const axios = require('axios');
-
-const service = axios.create({
-    timeout: 60000,
-    headers: {
-        'Content-Type': 'application/json; charset=utf-8',
-    },
-});
-
-const postClass = (url, data = {}, accessToken) => {
-    if (accessToken) {
-        return service({
-            url,
-            method: 'post',
-            headers: { accessToken },
-            data
-        });
-    }
-    console.error();
-    console.error('Failed: \nOpenAPI Token is null. \nPlease provide token via参数.');
-    console.error();
-};
-
-// 统一校验 token 与 apiSvc，完全依赖入参便于迁移
-async function loadConfig(token, apiSvcOverride) {
-    const apiSvc = apiSvcOverride;
-    const accessToken = token;
-    if (!apiSvc) {
-        throw new Error('缺少 apiSvc，请通过参数传入接口域名');
-    }
-    if (!accessToken) {
-        throw new Error('缺少访问 token，请通过参数传入');
-    }
-    return { accessToken, apiSvc };
-}
-
-async function requestPendingApprovals(queryParams, token, apiSvcOverride) {
-    const { accessToken, apiSvc } = await loadConfig(token, apiSvcOverride);
-    const requestBody = {
-        approvalProjectType: queryParams.approvalProjectType || "0",
-        approvalProcessStatus: queryParams.approvalProcessStatus || "",
-        startTime: queryParams.startTime || "",
-        endTime: queryParams.endTime || "",
-        actor: queryParams.actor || "",
-        related: queryParams.related || "",
-        type: queryParams.type || "",
-        pageNum: queryParams.pageNum || 1,
-        pageSize: queryParams.pageSize || 10
-    };
-
-    const url = `${apiSvc}/api/approval/getAllApprovalHistoryPendingList`;
-    const response = await postClass(url, requestBody, accessToken);
-
-    if (response.result) {
-        const { list = [], zylist = [], allpage } = response.data;
-        const zhaiyaoMap = {};
-        zylist.forEach(item => {
-            zhaiyaoMap[item.id] = item.zhaiyao;
-        });
-
-        const enrichedList = list.map(record => ({
-            ...record,
-            zhaiyao: zhaiyaoMap[record.workItemid] || null
-        }));
-
-        return {
-            list: enrichedList,
-            allpage,
-            total: list.length
-        };
-    }
-
-    throw new Error('获取待审批记录失败: ' + (response.returnInfo || response.message || '未知错误'));
-}
-
-async function approveRequest(approvalParams, token, apiSvcOverride) {
-    const { accessToken, apiSvc } = await loadConfig(token, apiSvcOverride);
-    const { relatedId, workItemId } = approvalParams;
-
-    const getPermissionById = await postClass(
-        `${apiSvc}/api/objectdetail/getPermissionById`,
-        { id: relatedId },
-        accessToken
-    );
-    const { objectApi } = getPermissionById.data;
-
-    const requestBody = {
-        data: JSON.stringify([{ id: relatedId }]),
-        relatedId,
-        comments: '',
-        workItemId,
-        actionType: 'Approved',
-        objectApiName: objectApi,
-    };
-
-    const url = `${apiSvc}/api/approval/updateApprovalProcessOperation`;
-    const response = await postClass(url, requestBody, accessToken);
-
-    if (response.result) {
-        return {
-            success: true,
-            message: response.returnInfo || '审批通过成功',
-            data: response.data
-        };
-    }
-
-    throw new Error('审批通过失败: ' + (response.returnInfo || response.message || '未知错误'));
-}
-
-async function rejectRequest(approvalParams, token, apiSvcOverride) {
-    const { accessToken, apiSvc } = await loadConfig(token, apiSvcOverride);
-    const { relatedId, workItemId, comments } = approvalParams;
-
-    const getPermissionById = await postClass(
-        `${apiSvc}/api/objectdetail/getPermissionById`,
-        { id: relatedId },
-        accessToken
-    );
-    const { objectApi } = getPermissionById.data;
-
-    const requestBody = {
-        data: JSON.stringify([{ id: relatedId }]),
-        relatedId,
-        comments,
-        workItemId,
-        actionType: 'Rejected',
-        objectApiName: objectApi,
-    };
-
-    const url = `${apiSvc}/api/approval/updateApprovalProcessOperation`;
-    const response = await postClass(url, requestBody, accessToken);
-
-    if (response.result) {
-        return {
-            success: true,
-            message: response.returnInfo || '审批拒绝成功',
-            data: response.data
-        };
-    }
-
-    throw new Error('审批拒绝失败: ' + (response.returnInfo || response.message || '未知错误'));
-}
+const { runCcJsonCommand } = require('../../cliRunner');
 
 /**
  * 拉取所有的待审批的记录
@@ -186,11 +40,19 @@ async function getPendingApprovals({
             pageNum,
             pageSize
         };
-        const result = await requestPendingApprovals(queryParams, token, apiSvc);
+        const encoded = encodeURI(JSON.stringify(queryParams));
+        const run = runCcJsonCommand(['get', 'approval', process.cwd(), encoded]);
+        if (!run.success) {
+            return {
+                content: [{ type: 'text', text: `✗ 拉取待审批记录失败: ${run.detail || 'cc 命令执行失败'}` }]
+            };
+        }
+        const result = run.data || {};
+        const warn = (token || apiSvc) ? '\n\n提示: 当前已切换为 CLI 调用，token/apiSvc 参数不会覆盖本地配置。' : '';
 
         return {
             content: [
-                { type: 'text', text: "将以下结果转换为markdown表格的模式展示：" + JSON.stringify(result, null, 2) }
+                { type: 'text', text: "将以下结果转换为markdown表格的模式展示：" + JSON.stringify(result, null, 2) + warn }
             ]
         };
     } catch (error) {
@@ -211,6 +73,7 @@ async function approveRecord({
     confirm,
     objid,
     workItemId,
+    token = '',
     apiSvc = ''
 }) {
     try {
@@ -233,7 +96,17 @@ async function approveRecord({
             relatedId: objid,
             workItemId,
         };
-        const result = await approveRequest(approvalParams, token, apiSvc);
+        const encoded = encodeURI(JSON.stringify(approvalParams));
+        const run = runCcJsonCommand(['approve', 'approval', process.cwd(), encoded]);
+        if (!run.success) {
+            return {
+                content: [{ type: 'text', text: `✗ 审批通过失败: ${run.detail || 'cc 命令执行失败'}` }]
+            };
+        }
+        const result = run.data || { success: true };
+        if (token || apiSvc) {
+            result.warning = '当前已切换为 CLI 调用，token/apiSvc 参数不会覆盖本地配置。';
+        }
 
         return {
             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
@@ -276,7 +149,17 @@ async function rejectRecord({ confirm, objid, comment = '', workItemId, token =
             workItemId,
             comments: comment
         };
-        const result = await rejectRequest(approvalParams, token, apiSvc);
+        const encoded = encodeURI(JSON.stringify(approvalParams));
+        const run = runCcJsonCommand(['reject', 'approval', process.cwd(), encoded]);
+        if (!run.success) {
+            return {
+                content: [{ type: 'text', text: `✗ 拒绝审批失败: ${run.detail || 'cc 命令执行失败'}` }]
+            };
+        }
+        const result = run.data || { success: true };
+        if (token || apiSvc) {
+            result.warning = '当前已切换为 CLI 调用，token/apiSvc 参数不会覆盖本地配置。';
+        }
 
         return {
             content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]

package/src/mcp/tools/Class Creator/handler.js

@@ -4,29 +4,32 @@
  */
 
 const path = require('path');
-const createClassModule = require('../../../classes/create');
+const { runCcCommand } = require('../../cliRunner');
 
 /**
  * 创建自定义类
  */
 async function createClass({ className, projectPath = process.cwd() }) {
     try {
-        // 临时改变工作目录以兼容原有模块
-        const originalCwd = process.cwd();
-        process.chdir(projectPath);
+        if (!className || !className.trim()) {
+            return { content: [{ type: 'text', text: '✗ 参数缺失: className 必须提供' }] };
+        }
+
+        const resolvedPath = path.resolve(projectPath);
+        const runResult = runCcCommand(['create', 'classes', className], { cwd: resolvedPath });
 
-        try {
-            await createClassModule(className);
-            const classPath = path.join(projectPath, `classes/${className}`);
-            return {
-                content: [{
-                    type: 'text',
-                    text: `✓ 创建成功！\n\n类路径: ${classPath}\n生成的文件:\n  - ${className}.java (主类文件)\n  - ${className}Test.java (测试类文件)\n  - config.json (配置文件)`
-                }]
-            };
-        } finally {
-            process.chdir(originalCwd);
+        if (!runResult.success) {
+            const detail = [runResult.error, runResult.stderr, runResult.stdout].filter(Boolean).join('\n');
+            return { content: [{ type: 'text', text: `✗ 创建失败: ${detail || 'cc 命令执行失败'}` }] };
         }
+
+        const classPath = path.join(resolvedPath, `classes/${className}`);
+        return {
+            content: [{
+                type: 'text',
+                text: `✓ 创建成功！\n\n调用命令: cc create classes ${className}\n执行目录: ${resolvedPath}\n类路径: ${classPath}\n生成的文件:\n  - ${className}.java (主类文件)\n  - ${className}Test.java (测试类文件)\n  - config.json (配置文件)`
+            }]
+        };
     } catch (error) {
         return { content: [{ type: 'text', text: `✗ 创建失败: ${error.message}` }] };
     }

package/src/mcp/tools/Class Detail Retriever/handler.js

@@ -3,7 +3,8 @@
  * 获取自定义类的详细信息
  */
 
-const detailModule = require('../../../classes/detail');
+const path = require('path');
+const { runCcJsonCommand } = require('../../cliRunner');
 
 /**
  * 获取类详细信息
@@ -14,15 +15,13 @@ const detailModule = require('../../../classes/detail');
  */
 async function getClassDetail({ className, classId, projectPath = process.cwd() }) {
     try {
-        const originalCwd = process.cwd();
-        process.chdir(projectPath);
-
-        try {
-            const detail = await detailModule(className, classId);
-            return { content: [{ type: 'text', text: JSON.stringify(detail, null, 2) }] };
-        } finally {
-            process.chdir(originalCwd);
+        const resolvedPath = path.resolve(projectPath);
+        const args = ['detail', 'classes', className || '', classId || ''];
+        const run = runCcJsonCommand(args, { cwd: resolvedPath });
+        if (!run.success) {
+            return { content: [{ type: 'text', text: `✗ 获取失败: ${run.detail || 'cc 命令执行失败'}` }] };
         }
+        return { content: [{ type: 'text', text: JSON.stringify(run.data, null, 2) }] };
     } catch (error) {
         return { content: [{ type: 'text', text: `✗ 获取失败: ${error.message}` }] };
     }

package/src/mcp/tools/Class Editor Guide/handler.js

@@ -7,7 +7,7 @@
  * 2. 需要详细信息时再查询具体API类
  */
 
-const prompt = require('./prompt');
+const { runCcCommand, buildRunDetail } = require('../../cliRunner');
 
 /**
  * 获取编辑指南
@@ -27,34 +27,20 @@ const prompt = require('./prompt');
  */
 async function editClass({ topic = 'overview' } = {}) {
     try {
-        // 验证 topic 参数
-        const validTopics = [
-            'overview',      // 规范 + 最佳实践 + API概要
-            'ccservice',     // CCService 详细文档
-            'object',        // CCObject 详细文档
-            'email',         // SendEmail 详细文档
-            'time',          // TimeUtil 详细文档
-            'user',          // UserInfo 详细文档
-            'logger',        // DevLogger 详细文档
-            'scenarios'      // 常见场景
-        ];
-
-        if (topic && !validTopics.includes(topic)) {
+        const run = runCcCommand(['doc', 'classes', topic]);
+        if (!run.success) {
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 无效的主题: "${topic}"\n\n支持的主题:\n${validTopics.map(t => `- ${t}`).join('\n')}`
+                    text: `✗ 获取编辑指南失败: ${buildRunDetail(run) || 'cc 命令执行失败'}`
                 }]
             };
         }
 
-        // 获取指定主题的编辑指南
-        const result = prompt.getEditGuide(topic);
-
         return {
             content: [{
                 type: 'text',
-                text: result
+                text: run.stdout || ''
             }]
         };
     } catch (error) {