cloudcc-cli 2.2.1 → 2.2.3

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

@@ -0,0 +1,358 @@
+/**
+ * Classes 工具处理器
+ * 提供自定义类的创建、发布、拉取、查询等功能
+ */
+
+const fs = require('fs');
+const path = require('path');
+const createClassModule = require('../../../classes/create');
+const publishClassModule = require('../../../classes/publish');
+const pullClassModule = require('../../../classes/pull');
+const getClassModule = require('../../../classes/get');
+const pullListModule = require('../../../classes/pullList');
+
+/**
+ * 创建自定义类
+ */
+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}` }] };
+    }
+}
+
+/**
+ * 发布类到服务器
+ */
+async function publishClass({ className, projectPath = process.cwd() }) {
+    try {
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            await publishClassModule(className);
+            return { content: [{ type: 'text', text: `✓ 发布成功！类 ${className} 已发布到服务器` }] };
+        } finally {
+            process.chdir(originalCwd);
+        }
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 发布失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 从服务器拉取类
+ */
+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);
+
+                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);
+                    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}` }] };
+    }
+}
+
+/**
+ * 获取类列表
+ */
+async function listClasses({ queryParams = {}, limit = 20, projectPath = process.cwd() }) {
+    try {
+        const queryString = encodeURI(JSON.stringify(queryParams));
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        let classList;
+        try {
+            classList = await getClassModule(queryString, projectPath);
+        } finally {
+            process.chdir(originalCwd);
+        }
+
+        if (!classList || classList.length === 0) {
+            return { content: [{ type: 'text', text: '未找到任何类' }] };
+        }
+
+        const limitedList = classList.slice(0, limit);
+        let result = `## 类列表\n\n找到 ${classList.length} 个类，显示前 ${limitedList.length} 个\n\n`;
+
+        limitedList.forEach((item, index) => {
+            result += `### ${index + 1}. ${item.name || item.apiname}\n`;
+            result += `- **ID**: ${item.id}\n`;
+            result += `- **API名称**: ${item.apiname || 'N/A'}\n\n`;
+        });
+
+        if (classList.length > limit) {
+            result += `\n提示：还有 ${classList.length - limit} 个类未显示`;
+        }
+
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 查询失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 获取类详细信息
+ */
+async function getClassDetail({ className, projectPath = process.cwd() }) {
+    try {
+        const configPath = path.join(projectPath, `classes/${className}/config.json`);
+        const javaFilePath = path.join(projectPath, `classes/${className}/${className}.java`);
+
+        if (!fs.existsSync(configPath)) {
+            return { content: [{ type: 'text', text: `✗ 类 ${className} 不存在` }] };
+        }
+
+        const config = JSON.parse(fs.readFileSync(configPath, 'utf8'));
+        const javaContent = fs.readFileSync(javaFilePath, 'utf8');
+        const lines = javaContent.split('\n');
+
+        let result = `## 类信息: ${className}\n\n`;
+        result += `### 配置信息\n`;
+        result += `- **名称**: ${config.name}\n`;
+        result += `- **版本**: ${config.version}\n`;
+        result += `- **服务器ID**: ${config.id || '未发布'}\n\n`;
+        result += `### 文件信息\n`;
+        result += `- **路径**: classes/${className}/${className}.java\n`;
+        result += `- **总行数**: ${lines.length}\n\n`;
+        result += `### 源码预览（前50行）\n\`\`\`java\n`;
+        result += lines.slice(0, 50).join('\n');
+        if (lines.length > 50) {
+            result += `\n...\n（还有 ${lines.length - 50} 行未显示）`;
+        }
+        result += `\n\`\`\``;
+
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 批量拉取多个类
+ */
+async function pullMultipleClasses({ classIds, projectPath = process.cwd() }) {
+    const results = { success: [], failed: [] };
+
+    try {
+        const originalCwd = process.cwd();
+        process.chdir(projectPath);
+
+        try {
+            for (let i = 0; i < classIds.length; i++) {
+                const classId = classIds[i];
+                try {
+                    await pullListModule(classId, projectPath);
+                    results.success.push(classId);
+                } catch (error) {
+                    results.failed.push({ id: classId, error: error.message });
+                }
+            }
+        } finally {
+            process.chdir(originalCwd);
+        }
+
+        let result = `## 批量拉取完成\n\n`;
+        result += `- **成功**: ${results.success.length} 个\n`;
+        result += `- **失败**: ${results.failed.length} 个\n\n`;
+
+        if (results.success.length > 0) {
+            result += `### 成功的类\n${results.success.map(id => `- ${id}`).join('\n')}\n\n`;
+        }
+
+        if (results.failed.length > 0) {
+            result += `### 失败的类\n${results.failed.map(({ id, error }) => `- **${id}**: ${error}`).join('\n')}`;
+        }
+
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 批量拉取失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 查看创建指南 - 使用 javaClassTemplate、configStructure、usageGuide
+ */
+async function viewCreateGuide() {
+    try {
+        const prompt = require('./prompt');
+        let result = `## ${prompt.javaClassTemplate.name}\n\n`;
+        result += `${prompt.javaClassTemplate.description}\n\n`;
+        result += `### 代码模板\n\`\`\`java\n${prompt.javaClassTemplate.example}\n\`\`\`\n\n`;
+        result += `### 重要提示\n`;
+        prompt.javaClassTemplate.notes.forEach(note => {
+            result += `- ${note}\n`;
+        });
+
+        result += `\n## ${prompt.configStructure.name}\n\n`;
+        result += `${prompt.configStructure.description}\n\n`;
+        result += `### 配置字段\n`;
+        for (const [key, field] of Object.entries(prompt.configStructure.fields)) {
+            result += `- **${key}** (${field.type}${field.required ? ', 必需' : ''}): ${field.description}\n`;
+            if (field.default) result += `  默认值: ${field.default}\n`;
+        }
+        result += `\n### 示例\n\`\`\`json\n${JSON.stringify(prompt.configStructure.example, null, 2)}\n\`\`\`\n`;
+
+        result += `\n## 工作流\n`;
+        prompt.usageGuide.workflow.forEach(step => {
+            result += `${step}\n`;
+        });
+
+        result += `\n## 最佳实践\n`;
+        prompt.usageGuide.bestPractices.forEach(practice => {
+            result += `- ${practice}\n`;
+        });
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取创建指南失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 查看 API 文档 - 使用 ccServiceApis
+ */
+async function viewApiDocs() {
+    try {
+        const prompt = require('./prompt');
+        const api = prompt.ccServiceApis;
+        let result = `## ${api.name}\n\n${api.description}\n\n`;
+
+        for (const [key, method] of Object.entries(api.apis)) {
+            result += `### ${method.description}\n`;
+            result += `**签名**: \`${method.signature}\`\n\n`;
+            result += `**示例**:\n\`\`\`java\n${method.example}\n\`\`\`\n\n`;
+        }
+
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取 API 文档失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 查看常见问题 - 使用 faq、errorMessages
+ */
+async function viewFAQ() {
+    try {
+        const prompt = require('./prompt');
+        let result = `## 常见问题\n\n`;
+
+        prompt.faq.forEach((item, index) => {
+            result += `### ${index + 1}. ${item.question}\n`;
+            result += `${item.answer}\n\n`;
+        });
+
+        result += `## 错误信息\n\n`;
+        for (const [code, error] of Object.entries(prompt.errorMessages)) {
+            result += `### ${code}\n`;
+            result += `**错误**: ${error.message}\n`;
+            result += `**解决方案**: ${error.solution}\n\n`;
+        }
+
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取常见问题失败: ${error.message}` }] };
+    }
+}
+
+/**
+ * 编辑类 - 提供编辑时需要的知识库和代码示例
+ */
+async function editClass({ topic = 'ccservice' }) {
+    try {
+        const prompt = require('./prompt');
+        const result = prompt.getEditGuide(topic);
+        return { content: [{ type: 'text', text: result }] };
+    } catch (error) {
+        return { content: [{ type: 'text', text: `✗ 获取编辑指南失败: ${error.message}` }] };
+    }
+}
+
+module.exports = {
+    createClass,
+    publishClass,
+    pullClass,
+    listClasses,
+    getClassDetail,
+    pullMultipleClasses,
+    viewCreateGuide,
+    viewApiDocs,
+    viewFAQ,
+    editClass
+};