cloudcc-cli 2.2.3 → 2.2.4

package/src/mcp/readme.md

@@ -2,131 +2,136 @@
 * 每个功能独立一个工具
 
 ## 工具列表说明
-### 1:开发环境检查Tool
+### 1:开发环境检查Tool - Dev Environment Validator ✅
 * 用于检查当前环境，是否满足开发条件
 * 需要使用知识库
 
-### 2:创建开发环境Tool
+### 2:创建开发环境Tool - Dev Environment Creator ✅
 * 通过特定步骤创建一个开发模版项目
 * 需要使用知识库
 
-### 3:指导配置开发者密钥Tool
+### 3:指导配置开发者密钥Tool - Developer Key Setup Guide ✅
 * 检查当前环境的开发者密钥是否配置正确
 * 指导如何获取密钥，以及如何配置
 
-### 4:创建应用程序Tool
+### 4:创建应用程序Tool - App Creator
 * 创建一个应用程序
 
-### 5:查询应用列表
+### 5:查询应用列表 - App List Retriever
 * 查询环境所有应用程序
 
-### 6:创建自定义对象Tool
+### 6:创建自定义对象Tool - Custom Object Creator ✅
 * 创建一个自定义对象
 
-### 7:查询对象列表Tool
+### 7:查询对象列表Tool - Object List Retriever ✅
 * 查询所有对象信息，包含标准以及自定义
 
-### 8:查询某个对象的详细信息Tool
-* 查询某个对象的详细信息
-
-### 9:创建字段Tool
+### 9:创建字段Tool - Field Batch Creator ✅
 * 为某个对象批量创建字段
 * 需要所有字段知识库
 
-### 10:查询某个对象字段列表Tool
+### 10:查询某个对象字段列表Tool - Object Fields Retriever ✅
 * 通过对象id查询对象的字段列表信息
 
-### 11:创建自定义类Tool
+### 11:创建自定义类Tool - Custom Class Creator ✅
 * 创建一个自定义类
 
-### 12:查询自定义类列表Tool
+### 12:查询自定义类列表Tool - Class List Retriever ✅
 * 查询自定义类列表
 
-### 13:查询某个类的详细信息Tool
+### 13:查询某个类的详细信息Tool - Class Detail Retriever ✅
 * 根据id查询某个类详细信息
 
-### 14:编辑类Tool
+### 14:编辑类Tool - Custom Class Editor ✅
 * 使用类的开发者知识库进行编辑开发
 * 类的常用sdk
 
-### 15:拉取自定义类到本地Tool
+### 15:拉取自定义类到本地Tool - Class Puller (Pull Class To Local) ✅
 * 拉取线上的某个类代码到本地
 
-### 16:推送自定义类到线上Tool
+### 16:推送自定义类到线上Tool - Class Publisher (Push Class Online) ✅
 * 推送某个自定义类代码到线上
 
-### 17:创建定时类Tool
-* 创建一个自定义类
+### 17:创建定时类Tool - Scheduled Class Creator ✅
+* 创建一个定时类
 
-### 18:查询定时类列表Tool
-* 查询自定义类列表
+### 18:查询定时类列表Tool - Scheduled Class List Retriever ✅
+* 查询定时列表
 
-### 19:查询某个定时类的详细信息Tool
-* 根据id查询某个类详细信息
+### 19:查询某个定时类的详细信息Tool - Scheduled Class Detail Retriever ✅
+* 根据id查询某个定时详细信息
 
-### 20:编辑定时类Tool
-* 使用定时类的开发者知识库进行编辑开发
-* 类的常用sdk
+### 21:拉取定时类到本地Tool - Scheduled Class Puller ✅
+* 拉取线上的某个定时类代码到本地
 
-### 21:拉取定时类到本地Tool
-* 拉取线上的某个类代码到本地
+### 22:推送定时类代码到线上Tool - Scheduled Class Publisher ✅
+* 推送某个定时类代码到线上
 
-### 22:推送定时类代码到线上Tool
-* 推送某个自定义类代码到线上
+### 23:创建触发器Tool - Trigger Creator ✅
+* 创建一个触发器
 
-### 23:创建触发器Tool
-* 创建一个自定义类
+### 24:查询触发器列表Tool - Trigger List Retriever ✅
+* 查询触发器列表
 
-### 24:查询触发器列表Tool
-* 查询自定义类列表
+### 25:查询某个触发器的详细信息Tool - Trigger Detail Retriever ✅
+* 根据id查询某个触发器详细信息
 
-### 25:查询某个触发器的详细信息Tool
-* 根据id查询某个类详细信息
+### 26:编辑触发器Tool - Trigger Editor ✅
+* 使用触发器的开发者知识库进行编辑开发
+* 触发器的常用sdk
 
-### 26:编辑触发器Tool
-* 使用定时类的开发者知识库进行编辑开发
-* 类的常用sdk
+### 27:拉取触发器到本地Tool - Trigger Puller ✅
+* 拉取线上的某个触发器代码到本地
 
-### 27:拉取触发器到本地Tool
-* 拉取线上的某个类代码到本地
+### 28:推送触发器代码到线上Tool - Trigger Publisher ✅
+* 推送某个触发器代码到线上
 
-### 28:推送触发器代码到线上Tool
-* 推送某个自定义类代码到线上
+### 29:创建自定义组件Tool - Component Creator ✅
+* 创建一个自定义组件（Vue组件）
 
-### 29:创建自定义组件Tool
-* 创建一个自定义类
+### 30:查询自定义组件列表Tool - Component List Retriever ✅
+* 查询自定义组件列表（本地和服务器）
 
-### 30:查询自定义组件列表Tool
-* 查询自定义类列表
+### 31:查询某个自定义组件的详细信息Tool - Component Detail Retriever ✅
+* 根据组件名或ID查询某个组件详细信息
 
-### 31:查询某个自定义组件的详细信息Tool
-* 根据id查询某个类详细信息
+### 32:编辑自定义组件Tool - Component Editor ✅
+* 使用自定义组件的开发者知识库进行编辑开发
+* Vue组件的常用API和最佳实践
 
-### 32:编辑自定义组件Tool
-* 使用定时类的开发者知识库进行编辑开发
-* 类的常用sdk
+### 33:拉取自定义组件到本地Tool - Component Puller ✅
+* 拉取线上的某个组件代码到本地
 
-### 33:拉取自定义组件到本地Tool
-* 拉取线上的某个类代码到本地
+### 34:推送自定义组件代码到线上Tool - Component Publisher ✅
+* 推送某个自定义组件代码到线上
 
-### 34:推送自定义组件代码到线上Tool
-* 推送某个自定义类代码到线上
+## 操作过于复杂
+### 35:创建客户端脚本Tool - Client Script Creator ❌
+* 创建一个客户端脚本
 
-### 35:创建客户端脚本Tool
-* 创建一个自定义类
+### 36:查询客户端脚本组件列表Tool - Client Script List Retriever ✅
+* 查询客户端脚本列表
 
-### 36:查询客户端脚本组件列表Tool
-* 查询自定义类列表
+### 37:查询某个客户端脚本的详细信息Tool - Client Script Detail Retriever ✅
+* 根据id查询某个客户端脚本详细信息
 
-### 37:查询某个客户端脚本的详细信息Tool
-* 根据id查询某个类详细信息
+### 38:编辑客户端脚本Tool - Client Script Editor ✅
+* 使用ccdk知识库开发
 
-### 38:编辑客户端脚本Tool
-* 使用定时类的开发者知识库进行编辑开发
-* 类的常用sdk
+### 39:拉取客户端脚本到本地Tool - Client Script Puller ✅
+* 拉取线上的某个客户端脚本代码到本地
 
-### 39:拉取客户端脚本到本地Tool
-* 拉取线上的某个类代码到本地
+### 40:推送客户端脚本件代码到线上Tool - Client Script Pusher ✅
+* 推送某个自定义客户端脚本代码到线上
+
+### 41:CloudCC开发项目概要Tool - CloudCC Development Overview ✅
+* 【总纲工具】CloudCC 开发项目的总纲和工具导航
+* 提供所有 MCP 工具的列表、使用提示和选择指南
+* 帮助大模型在开发过程中快速找到并使用正确的工具
+* 这是开始 CloudCC 开发前必须查看的工具
+* 需要使用知识库
 
-### 40:推送客户端脚本件代码到线上Tool
-* 推送某个自定义类代码到线上
+### 42:审批Tool - Approval
+* 拉取所有的待审批的记录
+* 通过id审批通过记录
+* 通过id拒绝审批通过记录

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

@@ -0,0 +1,349 @@
+/**
+ * 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 || '未知错误'));
+}
+
+/**
+ * 拉取所有的待审批的记录
+ * @param {Object} params - 参数对象
+ * @param {string} params.projectPath - 项目路径（可选，默认为当前工作目录）
+ * @param {string} params.approvalProjectType - 可选，审批项目类型，默认"0"
+ * @param {string} params.approvalProcessStatus - 可选，审批流程状态
+ * @param {string} params.startTime - 可选，开始时间
+ * @param {string} params.endTime - 可选，结束时间
+ * @param {string} params.actor - 可选，审批人
+ * @param {string} params.related - 可选，关联对象ID
+ * @param {string} params.type - 可选，类型
+ * @param {number} params.pageNum - 可选，页码，默认1
+ * @param {number} params.pageSize - 可选，每页数量，默认10
+ */
+async function getPendingApprovals({
+    token = '',
+    apiSvc = '',
+    approvalProjectType = "0",
+    approvalProcessStatus = "",
+    startTime = "",
+    endTime = "",
+    actor = "",
+    related = "",
+    type = "",
+    pageNum = 1,
+    pageSize = 10
+}) {
+    try {
+        const queryParams = {
+            approvalProjectType,
+            approvalProcessStatus,
+            startTime,
+            endTime,
+            actor,
+            related,
+            type,
+            pageNum,
+            pageSize
+        };
+        const result = await requestPendingApprovals(queryParams, token, apiSvc);
+
+        return {
+            content: [
+                { type: 'text', text: "将以下结果转换为markdown表格的模式展示：" + JSON.stringify(result, null, 2) }
+            ]
+        };
+    } catch (error) {
+        return {
+            content: [{ type: 'text', text: `✗ 拉取待审批记录失败: ${error.message}` }]
+        };
+    }
+}
+
+/**
+ * 通过id审批通过记录
+ * @param {Object} params - 参数对象
+ * @param {boolean} params.confirm - 是否已获得用户明确确认（必填）
+ * @param {string} params.objid - 关联对象ID（必填）
+ * @param {string} params.workItemId - 工作项ID（必填）
+ */
+async function approveRecord({
+    confirm,
+    objid,
+    workItemId,
+    apiSvc = ''
+}) {
+    try {
+        if (confirm !== true) {
+            return {
+                content: [{ type: 'text', text: '✗ 审批通过操作需要用户明确确认，请确认后再试' }]
+            };
+        }
+        if (!objid) {
+            return {
+                content: [{ type: 'text', text: '✗ 关联对象ID（objid）不能为空' }]
+            };
+        }
+        if (!workItemId) {
+            return {
+                content: [{ type: 'text', text: '✗ 工作项ID（workItemId）不能为空' }]
+            };
+        }
+        const approvalParams = {
+            relatedId: objid,
+            workItemId,
+        };
+        const result = await approveRequest(approvalParams, token, apiSvc);
+
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
+        };
+    } catch (error) {
+        return {
+            content: [{ type: 'text', text: `✗ 审批通过失败: ${error.message}` }]
+        };
+    }
+}
+
+/**
+ * 通过id拒绝审批通过记录
+ * @param {Object} params - 参数对象
+ * @param {boolean} params.confirm - 是否已获得用户明确确认（必填）
+ * @param {string} params.objid - 从审批记录中的objid字段获取
+ * @param {string} params.comment - 拒绝原因（必填）
+ * @param {string} params.workItemId - 工作项ID（必填），从审批记录中的workItemid字段获取
+ */
+async function rejectRecord({ confirm, objid, comment = '', workItemId, token = '', apiSvc = '' }) {
+    try {
+        if (confirm !== true) {
+            return {
+                content: [{ type: 'text', text: '✗ 拒绝审批操作需要用户明确确认，请确认后再试' }]
+            };
+        }
+        if (!objid) {
+            return {
+                content: [{ type: 'text', text: '✗ 审批记录ID不能为空' }]
+            };
+        }
+        if (!comment) {
+            return {
+                content: [{ type: 'text', text: '✗ 拒绝原因不能为空' }]
+            };
+        }
+
+        const approvalParams = {
+            relatedId: objid,
+            workItemId,
+            comments: comment
+        };
+        const result = await rejectRequest(approvalParams, token, apiSvc);
+
+        return {
+            content: [{ type: 'text', text: JSON.stringify(result, null, 2) }]
+        };
+    } catch (error) {
+        return {
+            content: [{ type: 'text', text: `✗ 拒绝审批失败: ${error.message}` }]
+        };
+    }
+}
+
+/**
+ * 工具注册配置对象
+ * 用于在 mcpServerInstance 中注册工具
+ */
+const toolDefinitions = [
+    {
+        name: 'get_pending_approvals',
+        description: '拉取所有的待审批的记录。',
+        inputSchema: z.object({
+            token: z.string().optional().describe('访问 token，可用于覆盖配置中的 accessToken'),
+            apiSvc: z.string().optional().describe('接口域名，可覆盖配置中的 apiSvc'),
+            approvalProjectType: z.string().optional().describe('审批项目类型，默认"0"'),
+            approvalProcessStatus: z.string().optional().describe('审批流程状态'),
+            startTime: z.string().optional().describe('开始时间'),
+            endTime: z.string().optional().describe('结束时间'),
+            actor: z.string().optional().describe('审批人'),
+            related: z.string().optional().describe('关联对象ID（用于筛选特定对象的审批记录）'),
+            type: z.string().optional().describe('类型'),
+            pageNum: z.number().int().optional().describe('页码，默认1'),
+            pageSize: z.number().int().optional().describe('每页数量，默认10')
+        }),
+        handler: getPendingApprovals
+    },
+    {
+        name: 'approve_record',
+        description: '【危险操作】审批通过某条审批记录。\
+在调用此工具前，必须向用户明确展示审批关键信息并进行二次确认。\
+只有当用户明确回复“确认通过”或 confirm=true 时，才能调用该工具。',
+        inputSchema: z.object({
+            confirm: z.boolean().describe('是否已获得用户明确确认。未确认时必须为 false。'),
+            objid: z.string().min(1).describe('从审批记录中的objid字段获取'),
+            workItemId: z.string().min(1).describe('从审批记录中的workItemid字段获取'),
+            token: z.string().optional().describe('访问 token，可用于覆盖配置中的 accessToken'),
+            apiSvc: z.string().optional().describe('接口域名，可覆盖配置中的 apiSvc'),
+        }),
+        handler: approveRecord
+    },
+    {
+        name: 'reject_record',
+        description: '【危险操作】通过id拒绝审批通过记录。\
+在调用此工具前，必须向用户明确展示审批关键信息并进行二次确认。\
+只有当用户明确回复“确认拒绝”或 confirm=true 时，才能调用该工具。',
+        inputSchema: z.object({
+            confirm: z.boolean().describe('是否已获得用户明确确认。未确认时必须为 false。'),
+            objid: z.string().min(1).describe('从审批记录中的objid字段获取'),
+            workItemId: z.string().min(1).describe('从审批记录中的workItemid字段获取'),
+            comment: z.string().min(1).describe('拒绝原因（必填）'),
+            token: z.string().optional().describe('访问 token，可用于覆盖配置中的 accessToken'),
+            apiSvc: z.string().optional().describe('接口域名，可覆盖配置中的 apiSvc'),
+        }),
+        handler: rejectRecord
+    }
+];
+module.exports = {
+    getPendingApprovals,
+    approveRecord,
+    rejectRecord,
+    toolDefinitions
+};

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

@@ -0,0 +1,37 @@
+/**
+ * Classes 工具处理器
+ * 提供自定义类的创建、发布、拉取、查询等功能
+ */
+
+const path = require('path');
+const createClassModule = require('../../../classes/create');
+
+/**
+ * 创建自定义类
+ */
+async function createClass({ className, projectPath = process.cwd() }) {
+    try {
+        // 临时改变工作目录以兼容原有模块
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        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);
+        }
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 创建失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    createClass
+};

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

@@ -0,0 +1,33 @@
+/**
+ * Class Detail Getter 工具处理器
+ * 获取自定义类的详细信息
+ */
+
+const detailModule = require('../../../classes/detail');
+
+/**
+ * 获取类详细信息
+ * @param {Object} params - 参数对象
+ * @param {string} params.className - 类名（可选，优先使用）
+ * @param {string} params.classId - 类ID（可选，当没有className时使用）
+ * @param {string} params.projectPath - 项目路径（可选，默认为当前工作目录）
+ */
+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);
+        }
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    getClassDetail
+};

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

@@ -0,0 +1,37 @@
+/**
+ * Class Detail Getter 工具知识库
+ * 提供类详细信息查看指南
+ */
+
+module.exports = {
+    description: '查看自定义类的详细信息',
+    parameters: {
+        className: {
+            type: 'string',
+            required: false,
+            description: '类名（可选，优先使用本地查询）'
+        },
+        classId: {
+            type: 'string',
+            required: false,
+            description: '类ID（可选，当没有className时使用服务器查询）'
+        },
+        projectPath: {
+            type: 'string',
+            required: false,
+            description: '项目路径，默认为当前工作目录'
+        }
+    },
+    notes: [
+        '至少需要提供 className 或 classId 其中之一',
+        '如果提供了 className，优先从本地文件获取（更快）',
+        '如果只提供 classId，从服务器查询',
+        '返回信息包括：基本配置、发布状态、服务器信息（如有）和源码预览'
+    ],
+    displayedInfo: [
+        '基本信息：包括类名、版本号、服务器ID、数据来源',
+        '发布状态：是否已发布到服务器',
+        '服务器信息：API名称、状态、创建/更新时间（如有）',
+        '源码预览：显示前50行源码内容'
+    ]
+};