cloudcc-cli 2.2.3 → 2.2.4

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

@@ -0,0 +1,86 @@
+/**
+ * Class Puller 工具处理器
+ * 从服务器拉取自定义类
+ */
+
+const fs = require('fs');
+const path = require('path');
+const getClassModule = require('../../../classes/get');
+const pullClassModule = require('../../../classes/pull');
+const pullListModule = require('../../../classes/pullList');
+
+/**
+ * 从服务器拉取类
+ */
+async function pullClass({ className, projectPath = process.cwd() }) {
+    try {
+        const classPath = path.join(projectPath, `classes/${className}`);
+        const configPath = path.join(classPath, 'config.json');
+
+        // 检查本地是否存在该类
+        if (!fs.existsSync(configPath)) {
+            // 本地不存在，查询服务器
+            try {
+                const queryString = encodeURI(JSON.stringify({
+                    name: className
+                }));
+                const classList = await getClassModule(queryString, projectPath, true);
+
+                if (!classList || classList.length === 0) {
+                    return {
+                        content: [{
+                            type: 'text',
+                            text: `✗ 拉取失败: 服务器上不存在类 ${className}`
+                        }]
+                    };
+                }
+
+                // 找到匹配的类
+                const targetClass = classList.find(item => item.name === className || item.apiname === className);
+                if (!targetClass) {
+                    return {
+                        content: [{
+                            type: 'text',
+                            text: `✗ 拉取失败: 服务器上未找到类 ${className}`
+                        }]
+                    };
+                }
+
+                // 使用 ID 从服务器拉取并在本地创建
+                const originalCwd = process.cwd();
+                process.chdir(projectPath);
+
+                try {
+                    await pullListModule(targetClass.id, projectPath, true);
+                    return {
+                        content: [{
+                            type: 'text',
+                            text: `✓ 拉取成功！已从服务器拉取类 ${className} 并在本地创建\n\n本地路径: classes/${className}/`
+                        }]
+                    };
+                } finally {
+                    process.chdir(originalCwd);
+                }
+            } catch (error) {
+                return { content: [{ type: 'text', text: `✗ 拉取失败: ${error.message}` }] };
+            }
+        }
+
+        // 本地存在，直接更新
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            await pullClassModule(className);
+            return { content: [{ type: 'text', text: `✓ 拉取成功！本地文件已更新: classes/${className}/${className}.java` }] };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 拉取失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    pullClass
+};

package/src/mcp/tools/Class Puller/prompt.js

@@ -0,0 +1,49 @@
+/**
+ * Class Puller 工具知识库
+ * 提供类拉取指南
+ */
+
+module.exports = {
+    description: '从服务器拉取自定义类到本地',
+    parameters: {
+        className: {
+            type: 'string',
+            required: true,
+            description: '要拉取的类名'
+        },
+        projectPath: {
+            type: 'string',
+            required: false,
+            description: '项目路径，默认为当前工作目录'
+        }
+    },
+    pullModes: [
+        {
+            mode: '本地不存在',
+            description: '自动从服务器查询类信息，下载并在本地创建完整的类目录结构',
+            steps: [
+                '1. 在服务器上查询该类',
+                '2. 获取类的ID',
+                '3. 根据ID下载类内容',
+                '4. 在本地创建classes/{ClassName}目录',
+                '5. 生成.java文件和config.json'
+            ]
+        },
+        {
+            mode: '本地已存在',
+            description: '更新本地类文件为服务器最新版本',
+            steps: [
+                '1. 读取本地config.json获取类ID',
+                '2. 从服务器下载最新版本',
+                '3. 更新本地.java文件',
+                '4. 保留本地config.json配置'
+            ]
+        }
+    ],
+    notes: [
+        '拉取会覆盖@SOURCE_CONTENT_START和@SOURCE_CONTENT_END之间的内容',
+        '该标记外的内容（包括imports和其他）不会被覆盖',
+        '拉取前建议备份本地修改',
+        '拉取后应进行本地编译验证'
+    ]
+};

package/src/mcp/tools/Client Script Creator/handler.js

@@ -0,0 +1,179 @@
+/**
+ * Client Script Creator 工具处理器
+ * 提供客户端脚本的创建功能
+ */
+
+const path = require('path');
+const createScriptModule = require('../../../script/create');
+
+// pageId 选项定义
+const PAGE_ID_OPTIONS = [
+    { label: 'List View', id: 'list' },
+    { label: 'Detail View', id: 'detail' },
+    { label: 'Edit View', id: 'edit' },
+    { label: 'New View', id: 'add' }
+];
+
+// usageScenario 选项定义
+const USAGE_SCENARIO_OPTIONS = [
+    { label: 'All', id: '' },
+    { label: 'PC', id: 'PC' },
+    { label: 'H5', id: 'H5' },
+    { label: 'App', id: 'App' }
+];
+
+// event 选择范围根据 pageId 决定
+const PAGE_EVENT_MAP = {
+    list: ['onCreated', 'onLoad', 'onDestroy'],
+    detail: ['onLoad'],
+    edit: ['onCreated', 'onLoad', 'onDestroy', 'beforeSave', 'afterSave'],
+    add: ['onCreated', 'onLoad', 'onDestroy', 'beforeSave', 'afterSave']
+};
+
+/**
+ * 验证 event 是否在 pageId 对应的有效事件列表中
+ * @param {string} pageId - 页面ID
+ * @param {string} event - 事件名称
+ * @returns {boolean} 是否有效
+ */
+function validateEvent(pageId, event) {
+    if (!pageId || !event) {
+        return false;
+    }
+    const validEvents = PAGE_EVENT_MAP[pageId];
+    return validEvents && validEvents.includes(event);
+}
+
+/**
+ * 创建客户端脚本
+ * @param {Object} params - 参数对象
+ * @param {string} params.scriptName - 脚本名称（必填）
+ * @param {string} params.scriptDesc - 脚本描述（可选）
+ * @param {string} params.objId - 对象ID（必填）
+ * @param {string} params.objName - 对象名称（必填）
+ * @param {string} params.schemetableName - 对象表名（必填）
+ * @param {string} params.recordTypeId - 记录类型ID（可选）
+ * @param {string} params.recordTypeName - 记录类型名称（可选）
+ * @param {string} params.pageId - 页面ID：'list' | 'detail' | 'edit' | 'add'（必填）
+ * @param {string} params.eventType - 事件类型，默认为 'pageType'（可选）
+ * @param {string} params.event - 事件名称，根据 pageId 决定可选值（必填）
+ * @param {string} params.fieldId - 字段ID（可选）
+ * @param {string} params.usageScenario - 使用场景：'' | 'PC' | 'H5' | 'App'（可选）
+ * @param {string} params.projectPath - 项目根目录路径（可选）
+ */
+async function createClientScript({
+    scriptName,
+    scriptDesc = '',
+    objId,
+    objName,
+    schemetableName,
+    recordTypeId = '',
+    recordTypeName = '',
+    pageId,
+    eventType = 'pageType',
+    event,
+    fieldId = '',
+    usageScenario = '',
+    projectPath = process.cwd()
+}) {
+    try {
+        // 验证必填参数
+        if (!scriptName || !objId || !objName || !schemetableName || !pageId || !event) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: '✗ 创建失败: 缺少必填参数\n\n必填参数:\n- scriptName: 脚本名称\n- objId: 对象ID\n- objName: 对象名称\n- schemetableName: 对象表名\n- pageId: 页面ID (list/detail/edit/add)\n- event: 事件名称'
+                }]
+            };
+        }
+
+        // 验证 pageId 是否有效
+        const validPageIds = PAGE_ID_OPTIONS.map(opt => opt.id);
+        if (!validPageIds.includes(pageId)) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✗ 创建失败: pageId 无效\n\n有效的 pageId 值:\n${PAGE_ID_OPTIONS.map(opt => `- ${opt.id} (${opt.label})`).join('\n')}`
+                }]
+            };
+        }
+
+        // 验证 event 是否在 pageId 对应的有效事件列表中
+        if (!validateEvent(pageId, event)) {
+            const validEvents = PAGE_EVENT_MAP[pageId];
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✗ 创建失败: event 无效\n\n对于 pageId="${pageId}"，有效的 event 值:\n${validEvents.map(e => `- ${e}`).join('\n')}`
+                }]
+            };
+        }
+
+        // 验证 usageScenario 是否有效（如果提供）
+        if (usageScenario) {
+            const validScenarios = USAGE_SCENARIO_OPTIONS.map(opt => opt.id);
+            if (!validScenarios.includes(usageScenario)) {
+                return {
+                    content: [{
+                        type: 'text',
+                        text: `✗ 创建失败: usageScenario 无效\n\n有效的 usageScenario 值:\n${USAGE_SCENARIO_OPTIONS.map(opt => `- ${opt.id} (${opt.label})`).join('\n')}`
+                    }]
+                };
+            }
+        }
+
+        // 临时改变工作目录以兼容原有模块
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            // 构建完整的 ScriptInfo 配置对象
+            const scriptInfo = {
+                scriptName,
+                scriptDesc,
+                objId,
+                objName,
+                schemetableName,
+                recordTypeId,
+                recordTypeName,
+                pageId,
+                eventType,
+                event,
+                fieldId,
+                usageScenario
+            };
+
+            // 将配置对象编码为 URI 格式（create.js 期望的格式）
+            const encodedBody = encodeURI(JSON.stringify(scriptInfo));
+
+            // 调用原有的 create 模块
+            await createScriptModule([null, null, encodedBody]);
+
+            const scriptPath = path.join(projectPath, `script/${objName}/${scriptName}`);
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✓ 客户端脚本创建成功！\n\n脚本路径: ${scriptPath}\n生成的文件:\n  - ${scriptName}.js (脚本文件)\n  - config.json (配置文件)\n\n配置信息:\n${JSON.stringify(scriptInfo, null, 2)}\n\n下一步:\n1. 编辑 ${scriptName}.js 实现你的脚本逻辑\n2. 使用 publish_client_script 发布到服务器`
+                }]
+            };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 创建失败: ${error.message}\n\n可能的原因:\n- 脚本名称已存在\n- 权限不足\n- 磁盘空间不足\n- 配置数据格式错误`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    createClientScript,
+    PAGE_ID_OPTIONS,
+    USAGE_SCENARIO_OPTIONS,
+    PAGE_EVENT_MAP,
+    validateEvent
+};
+

package/src/mcp/tools/Client Script Detail Retriever/handler.js

@@ -0,0 +1,53 @@
+/**
+ * Client Script Detail Retriever 工具处理器
+ * 获取客户端脚本的详细信息
+ */
+
+const detailScriptModule = require('../../../script/detail');
+
+/**
+ * 获取客户端脚本详细信息
+ * @param {Object} params - 参数对象
+ * @param {string} params.scriptPath - 脚本路径 "objName/scriptName"（可选，优先从本地查询）
+ * @param {string} params.scriptId - 脚本ID（可选，当没有scriptPath时从服务器查询）
+ * @param {string} params.projectPath - 项目根目录路径
+ */
+async function getClientScriptDetail({ scriptPath, scriptId, projectPath = process.cwd() }) {
+    try {
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            // 调用 detail.js 模块
+            const detail = await detailScriptModule(['detail', 'script', scriptPath, scriptId, projectPath]);
+
+            return {
+                content: [{
+                    type: 'text',
+                    text: JSON.stringify(detail, null, 2)
+                }]
+            };
+        } catch (error) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✗ 获取失败: ${error.message}`
+                }]
+            };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 获取失败: ${error.message}`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    getClientScriptDetail
+};
+