cloudcc-cli 2.2.3 → 2.2.4

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

@@ -0,0 +1,54 @@
+/**
+ * Client Script Publisher 工具处理器
+ * 将本地客户端脚本发布到服务器
+ */
+
+const publishScriptModule = require('../../../script/publish');
+
+/**
+ * 发布客户端脚本到服务器
+ * @param {Object} params - 参数对象
+ * @param {string} params.scriptPath - 脚本路径 "objName/scriptName"
+ * @param {string} params.projectPath - 项目根目录路径
+ */
+async function publishClientScript({ scriptPath, projectPath = process.cwd() }) {
+    try {
+        if (!scriptPath) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: '✗ 发布失败: scriptPath 是必填参数，格式为 "objName/scriptName"'
+                }]
+            };
+        }
+
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            // 调用原有的 publish 模块
+            await publishScriptModule(['publish', 'script', scriptPath], true);
+
+            return {
+                content: [{
+                    type: 'text',
+                    text: `✓ 发布成功！客户端脚本已发布到服务器\n\n脚本路径: script/${scriptPath}/\n\n提示：首次发布后，config.json 中会自动添加 id 字段`
+                }]
+            };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 发布失败: ${error.message}\n\n可能的原因:\n- 脚本文件不存在\n- 脚本格式不正确（必须包含 function main($CCDK, obj) 函数）\n- 网络连接问题\n- 服务器API不可用`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    publishClientScript
+};
+

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

@@ -0,0 +1,73 @@
+/**
+ * Client Script Puller 工具处理器
+ * 从服务器拉取客户端脚本到本地
+ */
+
+const pullScriptModule = require('../../../script/pull');
+const pullListScriptModule = require('../../../script/pullList');
+
+/**
+ * 从服务器拉取客户端脚本
+ * @param {Object} params - 参数对象
+ * @param {string} params.scriptPath - 脚本路径 "objName/scriptName"（可选，如果本地存在会从 config.json 读取 id）
+ * @param {string} params.scriptId - 脚本ID（可选，直接通过 ID 拉取）
+ * @param {string} params.projectPath - 项目根目录路径
+ */
+async function pullClientScript({ scriptPath, scriptId, projectPath = process.cwd() }) {
+    try {
+        // 确定输入：优先使用 scriptId，否则使用 scriptPath
+        const input = scriptId || scriptPath;
+
+        if (!input) {
+            return {
+                content: [{
+                    type: 'text',
+                    text: '✗ 拉取失败: 必须提供脚本路径或脚本ID'
+                }]
+            };
+        }
+
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            // 如果提供了 scriptId，使用 pullList 方法（会自动创建目录和文件）
+            if (scriptId) {
+                await pullListScriptModule(['pullList', 'script', scriptId, projectPath], true);
+
+                return {
+                    content: [{
+                        type: 'text',
+                        text: `✓ 拉取成功！脚本已从服务器拉取到本地\n\n脚本ID: ${scriptId}\n\n提示：脚本文件已自动创建在 script/{objName}/{scriptName}/ 目录下`
+                    }]
+                };
+            }
+
+            // 如果提供了 scriptPath，使用 pull 方法（需要本地已存在）
+            if (scriptPath) {
+                await pullScriptModule([null, null, scriptPath]);
+
+                return {
+                    content: [{
+                        type: 'text',
+                        text: `✓ 拉取成功！脚本已从服务器更新到本地\n\n脚本路径: script/${scriptPath}/`
+                    }]
+                };
+            }
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 拉取失败: ${error.message}\n\n可能的原因:\n- 脚本不存在\n- 脚本ID或路径不正确\n- 本地脚本未发布过（需要先发布才能拉取）`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    pullClientScript
+};
+

package/src/mcp/tools/CloudCC Development Overview/handler.js

@@ -0,0 +1,48 @@
+/**
+ * CloudCC Development Overview 工具处理器
+ * 提供 CloudCC 开发项目的总纲和工具导航
+ */
+
+const { prompts } = require('./prompt.js');
+
+/**
+ * 获取 CloudCC 开发项目概要信息
+ * @param {Object} params - 参数对象
+ * @param {string} params.topic - 查询主题（可选，默认为 'overview'）
+ * @returns {Object} MCP 格式的响应对象
+ * 
+ * 主题说明：
+ * - overview (默认): 📋 整体概览和工具导航 - 智能体首先应该阅读
+ * - tools: 🔧 所有 MCP 工具列表和使用提示（工具导航表）
+ * - decision-guide: 🎯 工具选择决策指南（场景化提示）
+ * - concepts: 📚 开发工具概念介绍
+ * - workflow: 🔄 开发流程和最佳实践
+ * - relationships: 🔗 工具之间的关系和依赖
+ */
+async function getCloudCCDevelopmentOverview({ }) {
+    try {
+
+        // 获取指定主题的内容
+        const result = prompts.overviewContent;
+
+        return {
+            content: [{
+                type: 'text',
+                text: result
+            }]
+        };
+    } catch (error) {
+        const errorMessage = error?.message || String(error);
+        const errorStack = error?.stack;
+        return {
+            content: [{
+                type: 'text',
+                text: `✗ 获取 CloudCC 开发项目概要失败: ${errorMessage}${errorStack ? '\n\n错误堆栈:\n' + errorStack : ''}`
+            }]
+        };
+    }
+}
+
+module.exports = {
+    getCloudCCDevelopmentOverview
+};