cloudcc-cli 2.2.1 → 2.2.3

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

@@ -0,0 +1,1261 @@
+/**
+ * Classes 工具知识库
+ * 提供 Java 类模板、配置结构、API 文档和错误信息
+ */
+
+/**
+ * Java 类模板示例
+ */
+const javaClassTemplate = {
+    name: 'Java自定义类模板',
+    description: 'CloudCC 自定义类的标准结构，包含源码标记和基础依赖',
+    example: `package classes.{ClassName};
+
+import com.cloudcc.core.*;
+// @SOURCE_CONTENT_START
+public class {ClassName}{
+    private UserInfo userInfo;
+    private CCService cs;
+
+    public {ClassName}(UserInfo userInfo){
+        this(userInfo,new CCService(userInfo));
+    }
+    public {ClassName}(UserInfo userInfo,CCService cs){
+        this.userInfo = userInfo;
+        this.cs=cs;
+    }
+    
+    public String getName(String str){
+        str = "demo";
+        return str;
+    }
+}
+// @SOURCE_CONTENT_END`,
+    notes: [
+        '源码标记 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 用于标识可编辑区域',
+        '发布时只会上传标记之间的内容到服务器',
+        '从服务器拉取时会替换标记之间的内容',
+        'UserInfo 和 CCService 是 CloudCC 提供的核心服务类'
+    ]
+};
+
+/**
+ * config.json 配置文件结构
+ */
+const configStructure = {
+    name: 'config.json配置结构',
+    description: '每个自定义类目录下的配置文件',
+    fields: {
+        name: {
+            type: 'string',
+            required: true,
+            description: '类名，必须与文件名和package中的类名一致'
+        },
+        version: {
+            type: 'string',
+            required: true,
+            description: '版本号，通常为 "2"',
+            default: '2'
+        },
+        id: {
+            type: 'string',
+            required: false,
+            description: '类的服务器ID，首次发布后自动生成并保存'
+        }
+    },
+    example: {
+        name: 'MyClass',
+        version: '2',
+        id: 'abc123def456'
+    }
+};
+
+/**
+ * CCService 常用 API 文档
+ */
+const ccServiceApis = {
+    name: 'CCService API',
+    description: 'CloudCC 核心服务类，提供数据操作和业务逻辑功能',
+    apis: {
+        query: {
+            description: '查询对象数据',
+            signature: 'List<Map<String, Object>> query(String objectApiName, String fields, String condition)',
+            example: 'List<Map<String, Object>> accounts = cs.query("account", "id,name,email", "name like \'%公司%\'");'
+        },
+        save: {
+            description: '保存或更新对象数据',
+            signature: 'String save(String objectApiName, Map<String, Object> data)',
+            example: 'Map<String, Object> data = new HashMap<>();\ndata.put("name", "测试账户");\nString id = cs.save("account", data);'
+        },
+        delete: {
+            description: '删除对象数据',
+            signature: 'boolean delete(String objectApiName, String id)',
+            example: 'boolean result = cs.delete("account", "accountId123");'
+        },
+        executeFunction: {
+            description: '执行服务器端函数',
+            signature: 'Object executeFunction(String functionName, Object... params)',
+            example: 'Object result = cs.executeFunction("myFunction", param1, param2);'
+        }
+    }
+};
+
+/**
+ * UserInfo 常用属性文档
+ */
+const userInfoDocs = {
+    name: 'UserInfo API',
+    description: 'CloudCC 用户信息类，包含当前用户和组织信息',
+    properties: {
+        userId: {
+            type: 'String',
+            description: '当前用户ID'
+        },
+        userName: {
+            type: 'String',
+            description: '当前用户名称'
+        },
+        accountId: {
+            type: 'String',
+            description: '当前用户所属账户ID'
+        },
+        organizationId: {
+            type: 'String',
+            description: '组织ID'
+        }
+    },
+    example: 'String currentUserId = userInfo.getUserId();'
+};
+
+/**
+ * 错误信息映射表
+ */
+const errorMessages = {
+    'CLASS_ID_NOT_EXIST': {
+        message: 'Class ID 不存在，请先发布类到服务器',
+        solution: '使用 publish_class 工具先发布该类，系统会自动生成并保存 ID 到 config.json'
+    },
+    'CLASS_NOT_FOUND': {
+        message: '本地找不到该类文件',
+        solution: '确认类名正确，或使用 create_class 工具创建新类'
+    },
+    'CONFIG_NOT_FOUND': {
+        message: 'config.json 配置文件不存在',
+        solution: '类目录下必须包含 config.json 文件，可能需要重新创建该类'
+    },
+    'INVALID_CLASS_NAME': {
+        message: '类名不符合 Java 命名规范',
+        solution: '类名必须以字母开头，只能包含字母、数字和下划线'
+    },
+    'PROJECT_CONFIG_ERROR': {
+        message: '无法读取项目配置',
+        solution: '确保在 CloudCC 项目根目录下执行，且存在 cloudcc-cli.config.js 或 package.json 配置文件'
+    },
+    'NETWORK_ERROR': {
+        message: 'API 调用失败',
+        solution: '检查网络连接和 accessToken 配置是否正确'
+    },
+    'PUBLISH_FAILED': {
+        message: '发布类到服务器失败',
+        solution: '检查 accessToken 和 setupSvc 配置是否正确，确认网络连接正常'
+    },
+    'PULL_FAILED': {
+        message: '从服务器拉取类失败',
+        solution: '确认类 ID 存在且有权限访问，检查 accessToken 配置'
+    }
+};
+
+/**
+ * 常见问题和解决方案
+ */
+const faq = [
+    {
+        question: '如何创建一个新的自定义类？',
+        answer: '使用 create_class 工具，提供类名参数。系统会在 classes/{ClassName}/ 目录下生成三个文件：主类文件、测试类文件和 config.json'
+    },
+    {
+        question: '如何发布类到服务器？',
+        answer: '使用 publish_class 工具，提供类名。首次发布会自动保存服务器返回的 ID 到 config.json'
+    },
+    {
+        question: '如何同步服务器上的最新代码？',
+        answer: '使用 pull_class 工具，提供类名。系统会用服务器上的最新代码替换 @SOURCE_CONTENT_START 和 @SOURCE_CONTENT_END 之间的内容'
+    },
+    {
+        question: '如何批量下载多个类？',
+        answer: '使用 pull_multiple_classes 工具，提供类 ID 数组。系统会为每个类创建完整的目录结构'
+    },
+    {
+        question: '@SOURCE_CONTENT_START 标记有什么用？',
+        answer: '这些标记定义了可编辑的源码区域。发布时只上传标记之间的内容，拉取时也只替换这部分内容，保持包声明和导入语句不变'
+    }
+];
+
+/**
+ * 工具使用指南
+ */
+const usageGuide = {
+    workflow: [
+        '1. 使用 create_class 创建新类',
+        '2. 在生成的 .java 文件中编写业务逻辑（在 @SOURCE_CONTENT_START 标记之间）',
+        '3. 使用 publish_class 发布到服务器',
+        '4. 在服务器上测试和验证',
+        '5. 如需修改，本地编辑后重新发布',
+        '6. 如需同步服务器上的修改，使用 pull_class'
+    ],
+    bestPractices: [
+        '保持类名与文件名一致',
+        '不要手动修改 config.json 中的 id 字段',
+        '使用版本控制（Git）管理源码',
+        '定期备份重要的类文件',
+        '测试类（*Test.java）用于本地调试'
+    ]
+};
+
+/**
+ * EditClass 工具知识库 - 编辑类时需要的核心 API 文档
+ */
+
+/**
+ * 从 CCService 提取 API 文档
+ */
+function extractCCServiceApis() {
+    return {
+        name: 'CCService 数据操作 API',
+        description: '核心服务类，用于数据增删改查和业务逻辑操作',
+        apis: {
+            // 查询方法
+            cquery: {
+                description: '无条件查询所有数据',
+                signature: 'List<CCObject> cquery(String apiName)',
+                example: 'List<CCObject> accounts = cs.cquery("account");',
+                returns: 'CCObject 列表'
+            },
+            cqueryWithCondition: {
+                description: '条件查询数据',
+                signature: 'List<CCObject> cquery(String apiName, String expression)',
+                example: 'List<CCObject> result = cs.cquery("account", "name like \'%销售%\'");',
+                returns: 'CCObject 列表',
+                params: [
+                    { name: 'apiName', type: 'String', desc: '对象 API 名称，如 account, contact 等' },
+                    { name: 'expression', type: 'String', desc: '查询条件，支持 like, =, >, <, >= <= 等操作符' }
+                ]
+            },
+            cqlQuery: {
+                description: 'CQL 条件查询（推荐）',
+                signature: 'List<CCObject> cqlQuery(String apiName, String expression)',
+                example: 'List<CCObject> result = cs.cqlQuery("account", "status = \'active\'");',
+                returns: 'CCObject 列表',
+                note: '性能比 cquery 更优，推荐使用'
+            },
+
+            // 插入方法
+            insert: {
+                description: '新增单条记录',
+                signature: 'ServiceResult insert(CCObject cobj)',
+                example: `CCObject obj = new CCObject("account");
+obj.put("name", "新客户");
+obj.put("type", "1");
+ServiceResult sr = cs.insert(obj);
+String id = sr.get("id"); // 获取新增记录的 ID`,
+                returns: 'ServiceResult 包含新增记录的 ID'
+            },
+            insertBatch: {
+                description: '批量新增记录',
+                signature: 'ServiceResult insert(List<CCObject> datalist)',
+                example: `List<CCObject> list = new ArrayList<>();
+for(int i=0; i<3; i++) {
+    CCObject obj = new CCObject("account");
+    obj.put("name", "客户"+i);
+    list.add(obj);
+}
+ServiceResult sr = cs.insert(list);`,
+                returns: 'ServiceResult 包含所有新增记录的 ID'
+            },
+
+            // 更新方法
+            update: {
+                description: '更新单条记录',
+                signature: 'void update(CCObject cobj)',
+                example: `CCObject obj = new CCObject("account");
+obj.put("id", "existingId");
+obj.put("name", "更新的名称");
+cs.update(obj);`,
+                note: 'CCObject 必须包含 id 字段用于标识更新的记录'
+            },
+
+            // 删除方法
+            delete: {
+                description: '删除记录',
+                signature: 'void delete(CCObject cobj)',
+                example: `CCObject obj = new CCObject("account");
+obj.put("id", "recordId");
+cs.delete(obj);`
+            },
+
+            // Upsert 方法
+            upsert: {
+                description: '新增或更新记录（有 id 则更新，无则新增）',
+                signature: 'ServiceResult upsert(CCObject cobj)',
+                example: `CCObject obj = new CCObject("account");
+obj.put("id", "existingId"); // 存在则更新，不存在则新增
+obj.put("name", "账户名称");
+ServiceResult sr = cs.upsert(obj);`,
+                returns: 'ServiceResult 包含记录的 ID'
+            },
+
+            // 邮件方法
+            sendEmail: {
+                description: '发送邮件',
+                signature: 'String sendEmail(String subject, String htmlBody, String toAddress, String relatedid, String ccaddress, String bccaddress, String attachmentId, String s, String s1)',
+                example: 'cs.sendEmail("邮件主题", "<h1>邮件内容</h1>", "user@example.com", "", "", "", "", "", "");',
+                note: '该方法支持 HTML 格式的邮件内容'
+            }
+        },
+        bestPractices: [
+            '查询时优先使用 cqlQuery，性能更优',
+            '批量操作使用 insertBatch 而非循环调用 insert',
+            '修改数据前建议先查询验证数据存在',
+            '操作后检查 ServiceResult 的返回值确保成功',
+            '大量数据操作建议分批处理以避免超时'
+        ]
+    };
+}
+
+/**
+ * 从 CCObject 提取对象操作文档
+ */
+function extractCCObjectDocs() {
+    return {
+        name: 'CCObject 对象操作',
+        description: 'CloudCC 数据对象，继承自 HashMap<String, Object>，用于存储和传递业务数据。是所有数据操作的核心载体',
+
+        // 核心常量
+        constants: {
+            OBJECT_API: {
+                value: 'CCObjectAPI',
+                desc: '对象 API 名称的键常量，用于标识对象类型',
+                usage: 'obj.put(CCObject.OBJECT_API, "account");'
+            },
+            IS_SHARED: {
+                value: 'isShared',
+                desc: '对象共享状态的键常量',
+                usage: 'obj.put(CCObject.IS_SHARED, "true");'
+            },
+            SUM: {
+                value: 'sum',
+                desc: '汇总字段的键前缀常量',
+                usage: 'obj.putSumValue("amount", "10000"); // 存储为 "sumamount"'
+            }
+        },
+
+        // 构造方法
+        constructors: [
+            {
+                signature: 'CCObject()',
+                desc: '创建空的 CCObject 对象',
+                example: `CCObject obj = new CCObject();
+obj.put("CCObjectAPI", "account");  // 需手动指定对象类型`,
+                usage: '适用于动态确定对象类型的场景'
+            },
+            {
+                signature: 'CCObject(String ccobj)',
+                desc: '创建指定对象类型的 CCObject',
+                example: `CCObject account = new CCObject("account");
+CCObject contact = new CCObject("contact");
+CCObject opportunity = new CCObject("opportunity");`,
+                usage: '最常用的构造方式，自动设置 CCObjectAPI 字段',
+                recommended: true
+            },
+            {
+                signature: 'CCObject(String ccobj, String isShared)',
+                desc: '创建带共享状态的 CCObject',
+                example: `CCObject obj = new CCObject("account", "true");
+// 等同于：
+// CCObject obj = new CCObject("account");
+// obj.put("isShared", "true");`,
+                usage: '创建需要共享的对象时使用',
+                note: '第二个参数会被存储为 "isShared" 字段值'
+            }
+        ],
+
+        // 核心方法
+        methods: {
+            dataAccess: {
+                title: '数据存取方法（继承自 HashMap）',
+                items: [
+                    {
+                        name: 'put(String key, Object value)',
+                        desc: '设置字段值，key 为字段 API 名称',
+                        returns: 'Object - 旧值或 null',
+                        example: `obj.put("name", "销售部");
+obj.put("type", "1");
+obj.put("amount", 50000);
+obj.put("status", "active");
+obj.put("id", "recordId123");  // 更新时必须设置 id`
+                    },
+                    {
+                        name: 'get(String key)',
+                        desc: '获取字段值，返回 Object 需要类型转换',
+                        returns: 'Object - 字段值或 null',
+                        example: `String name = (String) obj.get("name");
+Integer amount = (Integer) obj.get("amount");
+String id = (String) obj.get("id");
+
+// 安全获取，避免空指针
+Object value = obj.get("field");
+if (value != null) {
+    String strValue = value.toString();
+}`
+                    },
+                    {
+                        name: 'containsKey(String key)',
+                        desc: '检查是否包含指定字段',
+                        returns: 'boolean',
+                        example: `if (obj.containsKey("id")) {
+    // 更新操作
+    cs.update(obj);
+} else {
+    // 新增操作
+    cs.insert(obj);
+}`
+                    },
+                    {
+                        name: 'remove(String key)',
+                        desc: '移除指定字段',
+                        returns: 'Object - 被移除的值',
+                        example: `obj.remove("tempField");  // 清理临时字段`
+                    },
+                    {
+                        name: 'keySet()',
+                        desc: '获取所有字段名集合',
+                        returns: 'Set<String>',
+                        example: `for (String key : obj.keySet()) {
+    Object value = obj.get(key);
+    DevLogger.devLogInfo(key + " = " + value);
+}`
+                    }
+                ]
+            },
+
+            specificMethods: {
+                title: 'CCObject 特有方法',
+                items: [
+                    {
+                        name: 'getObjectApiName()',
+                        desc: '获取对象的 API 名称（即对象类型）',
+                        returns: 'String - 对象 API 名称',
+                        example: `CCObject obj = new CCObject("account");
+String apiName = obj.getObjectApiName();  // 返回 "account"
+
+// 用于判断对象类型
+if ("account".equals(obj.getObjectApiName())) {
+    // 处理客户对象
+}`
+                    },
+                    {
+                        name: 'putSumValue(String sumValueKey, String value)',
+                        desc: '存储汇总字段值，会自动添加 "sum" 前缀',
+                        returns: 'void',
+                        example: `obj.putSumValue("amount", "10000");
+// 实际存储的 key 是 "sumamount"
+
+obj.putSumValue("quantity", "100");
+// 实际存储的 key 是 "sumquantity"`
+                    },
+                    {
+                        name: 'getSumValue(String sumValueKey)',
+                        desc: '获取汇总字段值',
+                        returns: 'Object - 汇总值',
+                        example: `Object total = obj.getSumValue("amount");
+// 实际获取的是 "sumamount" 字段的值
+
+String totalStr = (String) obj.getSumValue("amount");
+DevLogger.devLogInfo("总金额: " + totalStr);`
+                    }
+                ]
+            }
+        },
+
+        // 最佳实践
+        bestPractices: {
+            creation: [
+                '推荐使用 new CCObject("objectApi") 构造方法，自动设置对象类型',
+                '对象类型使用小写字母和下划线，如 account, custom_object',
+                '创建后立即设置必填字段，避免后续遗漏'
+            ],
+            dataManipulation: [
+                '获取字段值时进行类型转换和 null 检查',
+                '使用 containsKey() 判断字段是否存在',
+                '更新操作必须包含 id 字段',
+                '日期时间字段使用标准格式（yyyy-MM-dd HH:mm:ss）'
+            ],
+            withCCService: [
+                '新增前确保 CCObjectAPI 已设置',
+                '更新前先查询获取完整数据，避免覆盖其他字段',
+                '批量操作使用 List<CCObject> 提升性能',
+                '操作后检查返回的 ServiceResult'
+            ]
+        },
+
+        // 常见使用场景
+        usageExamples: [
+            {
+                scenario: '创建新记录',
+                code: `CCObject account = new CCObject("account");
+account.put("name", "新客户公司");
+account.put("type", "1");  // 客户类型
+account.put("industry", "制造业");
+account.put("status", "active");
+account.put("owner", userInfo.getUserId());
+
+ServiceResult result = cs.insert(account);
+String newId = (String) result.get("id");
+DevLogger.devLogInfo("新增成功，ID: " + newId);`
+            },
+            {
+                scenario: '更新现有记录',
+                code: `// 先查询获取完整数据
+List<CCObject> list = cs.cquery("account", "id = 'accountId123'");
+if (list.size() > 0) {
+    CCObject account = list.get(0);
+    account.put("name", "更新后的名称");
+    account.put("status", "inactive");
+    cs.update(account);
+    DevLogger.devLogInfo("更新成功");
+}`
+            },
+            {
+                scenario: '批量创建记录',
+                code: `List<CCObject> contacts = new ArrayList<>();
+for (int i = 0; i < 10; i++) {
+    CCObject contact = new CCObject("contact");
+    contact.put("name", "联系人" + i);
+    contact.put("email", "contact" + i + "@example.com");
+    contact.put("account", accountId);  // 关联到客户
+    contacts.add(contact);
+}
+
+ServiceResult result = cs.insert(contacts);
+DevLogger.devLogInfo("批量新增完成");`
+            },
+            {
+                scenario: '使用汇总字段',
+                code: `CCObject opportunity = new CCObject("opportunity");
+opportunity.put("name", "大客户项目");
+opportunity.put("stage", "商务谈判");
+opportunity.put("amount", 500000);
+
+// 设置汇总字段
+opportunity.putSumValue("totalAmount", "500000");
+opportunity.putSumValue("productCount", "3");
+
+ServiceResult result = cs.insert(opportunity);
+
+// 读取汇总字段
+String total = (String) opportunity.getSumValue("totalAmount");
+DevLogger.devLogInfo("总金额: " + total);`
+            },
+            {
+                scenario: '动态字段处理',
+                code: `CCObject obj = new CCObject("custom_object");
+
+// 遍历所有字段
+for (String key : obj.keySet()) {
+    Object value = obj.get(key);
+    if (value != null && !value.toString().isEmpty()) {
+        DevLogger.devLogInfo(key + ": " + value);
+    }
+}
+
+// 条件设置字段
+if (obj.containsKey("status")) {
+    obj.put("lastModified", new Date());
+}
+
+// 清理空字段
+List<String> keysToRemove = new ArrayList<>();
+for (String key : obj.keySet()) {
+    if (obj.get(key) == null) {
+        keysToRemove.add(key);
+    }
+}
+for (String key : keysToRemove) {
+    obj.remove(key);
+}`
+            }
+        ],
+
+        // 常见对象类型及其字段
+        commonObjects: [
+            {
+                name: 'account',
+                label: '客户/账户',
+                commonFields: [
+                    'id - 记录ID',
+                    'name - 客户名称',
+                    'type - 客户类型',
+                    'industry - 行业',
+                    'status - 状态',
+                    'owner - 负责人',
+                    'email - 邮箱',
+                    'phone - 电话',
+                    'website - 网站',
+                    'description - 描述'
+                ]
+            },
+            {
+                name: 'contact',
+                label: '联系人',
+                commonFields: [
+                    'id - 记录ID',
+                    'name - 姓名',
+                    'account - 所属客户',
+                    'email - 邮箱',
+                    'phone - 电话',
+                    'mobile - 手机',
+                    'title - 职位',
+                    'department - 部门'
+                ]
+            },
+            {
+                name: 'opportunity',
+                label: '商机',
+                commonFields: [
+                    'id - 记录ID',
+                    'name - 商机名称',
+                    'account - 客户',
+                    'stage - 阶段',
+                    'amount - 金额',
+                    'closeDate - 预计成交日期',
+                    'probability - 赢率',
+                    'owner - 负责人'
+                ]
+            },
+            {
+                name: 'task',
+                label: '任务',
+                commonFields: [
+                    'id - 记录ID',
+                    'subject - 主题',
+                    'status - 状态',
+                    'priority - 优先级',
+                    'owner - 负责人',
+                    'dueDate - 截止日期',
+                    'relatedTo - 相关对象',
+                    'description - 描述'
+                ]
+            }
+        ],
+
+        // 注意事项
+        notes: [
+            'CCObject 继承自 HashMap，拥有 HashMap 的所有方法',
+            '字段名使用对象的 API 名称，非标签名称',
+            'get() 方法返回 Object 类型，需要进行类型转换',
+            '汇总字段会自动添加 "sum" 前缀',
+            '与 CCService 配合使用完成数据的增删改查',
+            '更新操作必须包含 id 字段标识记录',
+            '建议对字段值进行 null 检查，避免空指针异常'
+        ]
+    };
+}
+
+/**
+ * 从 SendEmail 提取邮件发送文档
+ */
+function extractSendEmailDocs() {
+    return {
+        name: 'SendEmail 邮件服务',
+        description: '用于发送系统邮件和模板邮件',
+        methods: {
+            sendMailFromSystem: {
+                description: '发送自定义内容邮件',
+                signature: 'ServiceResult sendMailFromSystem(String[] toAddress, String[] ccAddress, String bccAddress, String subject, String content, boolean isText)',
+                example: `SendEmail sender = new SendEmail(userInfo);
+String[] toAddress = {"recipient@example.com"};
+String[] ccAddress = {"cc@example.com"};
+ServiceResult result = sender.sendMailFromSystem(
+    toAddress,
+    ccAddress,
+    "bcc@example.com",
+    "邮件主题",
+    "<h1>邮件正文</h1>",
+    false  // 非纯文本，支持 HTML
+);`,
+                params: [
+                    { name: 'toAddress', type: 'String[]', desc: '收件人邮箱数组' },
+                    { name: 'ccAddress', type: 'String[]', desc: '抄送人邮箱数组' },
+                    { name: 'bccAddress', type: 'String', desc: '密送人邮箱' },
+                    { name: 'subject', type: 'String', desc: '邮件主题' },
+                    { name: 'content', type: 'String', desc: '邮件内容，支持 HTML' },
+                    { name: 'isText', type: 'boolean', desc: '是否纯文本，false 表示支持 HTML' }
+                ]
+            },
+            sendEmailNew: {
+                description: '使用模板发送邮件',
+                signature: 'ServiceResult sendEmailNew(String templateId, String[] toAddress, String[] ccAddress, String bccAddress, String recordId)',
+                example: `SendEmail sender = new SendEmail(userInfo);
+ServiceResult result = sender.sendEmailNew(
+    "templateId123",
+    new String[]{"user@example.com"},
+    new String[]{"cc@example.com"},
+    "bcc@example.com",
+    "recordId456"  // 关联的业务记录 ID
+);`,
+                params: [
+                    { name: 'templateId', type: 'String', desc: '邮件模板 ID' },
+                    { name: 'toAddress', type: 'String[]', desc: '收件人邮箱数组' },
+                    { name: 'ccAddress', type: 'String[]', desc: '抄送人邮箱数组' },
+                    { name: 'bccAddress', type: 'String', desc: '密送人邮箱' },
+                    { name: 'recordId', type: 'String', desc: '关联的业务记录 ID，用于邮件中获取相关数据' }
+                ]
+            }
+        }
+    };
+}
+
+/**
+ * 从 TimeUtil 提取时间工具文档
+ */
+function extractTimeUtilDocs() {
+    return {
+        name: 'TimeUtil 时间工具',
+        description: '用于时间格式化和时区处理',
+        methods: {
+            getSimpleDateFormat: {
+                description: '获取日期格式化器',
+                signature: 'static SimpleDateFormat getSimpleDateFormat(String string, UserInfo userInfo)',
+                example: `SimpleDateFormat sdf = TimeUtil.getSimpleDateFormat("yyyy-MM-dd HH:mm:ss", userInfo);
+Date date = new Date();
+String dateStr = sdf.format(date);`,
+                commonFormats: [
+                    'yyyy-MM-dd HH:mm:ss',
+                    'yyyy-MM-dd',
+                    'MM/dd/yyyy',
+                    'HH:mm:ss',
+                    'yyyy-MM-dd HH:mm'
+                ]
+            }
+        }
+    };
+}
+
+/**
+ * 从 UserInfo 提取用户信息文档
+ */
+function extractUserInfoDocs() {
+    return {
+        name: 'UserInfo 用户信息',
+        description: '当前用户和权限信息',
+        properties: [
+            {
+                name: 'getUserId()',
+                desc: '获取当前用户 ID',
+                returns: 'String 用户 ID'
+            },
+            {
+                name: 'getRoleId()',
+                desc: '获取用户角色 ID',
+                returns: 'String 角色 ID'
+            },
+            {
+                name: 'getLoginName()',
+                desc: '获取登录名',
+                returns: 'String 登录名'
+            },
+            {
+                name: 'getUserName()',
+                desc: '获取用户名称',
+                returns: 'String 用户名'
+            },
+            {
+                name: 'getProfileId()',
+                desc: '获取配置文件 ID',
+                returns: 'String 配置文件 ID'
+            },
+            {
+                name: 'isIspartner()',
+                desc: '判断是否为合作伙伴',
+                returns: 'Boolean'
+            },
+            {
+                name: 'setBinding(String bind) / getBinding()',
+                desc: '获取/设置绑定信息',
+                returns: 'String 绑定信息'
+            }
+        ],
+        usage: 'UserInfo userInfo 作为参数传递给 CCService 和其他服务类，用于身份验证和权限检查'
+    };
+}
+
+/**
+ * 从 DevLogger 提取日志文档
+ */
+function extractDevLoggerDocs() {
+    return {
+        name: 'DevLogger 开发日志',
+        description: '用于调试和记录程序运行状态',
+        methods: [
+            {
+                name: 'devLogInfo(String log)',
+                desc: '输出 Info 级别日志',
+                example: 'DevLogger.devLogInfo("处理开始");',
+                usage: '记录程序正常执行信息'
+            },
+            {
+                name: 'devLogError(String log)',
+                desc: '输出 Error 级别日志',
+                example: 'DevLogger.devLogError("数据查询失败");',
+                usage: '记录错误信息'
+            },
+            {
+                name: 'devLogError(String log, Exception e)',
+                desc: '输出异常日志',
+                example: `try {
+    // 某些操作
+} catch(Exception e) {
+    DevLogger.devLogError("操作失败", e);
+}`,
+                usage: '记录异常堆栈信息'
+            }
+        ],
+        tips: [
+            '开发环境中使用日志调试代码逻辑',
+            '生产环境中根据需要调整日志级别',
+            '避免输出敏感信息到日志'
+        ]
+    };
+}
+
+/**
+ * 常见编辑需求场景
+ */
+function getEditScenarios() {
+    return [
+        {
+            scenario: '客户数据维护',
+            description: '新增、更新、删除客户信息',
+            example: `CCObject account = new CCObject("account");
+account.put("name", "新客户名称");
+account.put("type", "重点客户");
+account.put("industry", "制造业");
+ServiceResult result = cs.insert(account);
+if(result != null) {
+    DevLogger.devLogInfo("客户创建成功: " + result.get("id"));
+}`
+        },
+        {
+            scenario: '批量数据导入',
+            description: '批量新增或更新大量记录',
+            example: `List<CCObject> list = new ArrayList<>();
+for(CCObject data : importData) {
+    CCObject obj = new CCObject("contact");
+    obj.put("name", data.get("name"));
+    obj.put("email", data.get("email"));
+    list.add(obj);
+}
+ServiceResult result = cs.insert(list);
+DevLogger.devLogInfo("导入完成: " + result.get("id"));`
+        },
+        {
+            scenario: '条件查询和处理',
+            description: '查询符合条件的记录并处理',
+            example: `List<CCObject> records = cs.cqlQuery("opportunity", "stage = '商务谈判' AND amount > 50000");
+for(CCObject record : records) {
+    record.put("priority", "high");
+    cs.update(record);
+    DevLogger.devLogInfo("更新商机: " + record.get("id"));
+}`
+        },
+        {
+            scenario: '发送通知邮件',
+            description: '基于业务逻辑发送邮件通知',
+            example: `SendEmail sender = new SendEmail(userInfo);
+List<CCObject> tasks = cs.cqlQuery("task", "status = 'pending'");
+for(CCObject task : tasks) {
+    String[] recipients = {(String)task.get("ownerEmail")};
+    sender.sendMailFromSystem(recipients, null, null, 
+        "任务提醒: " + task.get("subject"),
+        "<p>您有一个待处理的任务，请及时处理。</p>",
+        false
+    );
+}`
+        }
+    ];
+}
+
+/**
+ * 编辑类的最佳实践
+ */
+function getEditBestPractices() {
+    return {
+        dataValidation: [
+            '新增或更新前验证数据的合法性',
+            '检查必填字段是否为空',
+            '验证数据格式是否正确',
+            '检查是否存在重复数据'
+        ],
+        errorHandling: [
+            '使用 try-catch 捕获异常',
+            '使用 DevLogger 记录错误信息',
+            '对关键操作进行日志记录',
+            '返回有意义的错误提示'
+        ],
+        performance: [
+            '使用批量操作替代循环调用',
+            '避免在循环中进行数据库查询',
+            '大数据量操作时分批处理',
+            '优先使用条件查询减少数据传输'
+        ],
+        security: [
+            '验证用户权限和数据访问权限',
+            '不要在日志中输出敏感数据',
+            '对外部输入进行验证和清理',
+            '使用 UserInfo 进行权限检查'
+        ]
+    };
+}
+
+/**
+ * EditClass 工具知识库对象
+ */
+const editCCServiceApis = extractCCServiceApis();
+const editCCObjectDocs = extractCCObjectDocs();
+const editSendEmailDocs = extractSendEmailDocs();
+const editTimeUtilDocs = extractTimeUtilDocs();
+const editUserInfoDocs = extractUserInfoDocs();
+const editDevLoggerDocs = extractDevLoggerDocs();
+const editScenarios = getEditScenarios();
+const editBestPractices = getEditBestPractices();
+
+/**
+ * 通用文档生成工具函数
+ */
+
+/**
+ * 格式化 API 文档
+ */
+function formatApiDocs(api) {
+    const lines = [`### ${api.name}\n${api.description}\n`];
+
+    for (const [key, method] of Object.entries(api.apis || api.methods || {})) {
+        lines.push(`#### ${method.description}`);
+        lines.push(`\`\`\`java\n${method.example}\n\`\`\``);
+
+        if (method.params) {
+            lines.push('**参数**:');
+            method.params.forEach(p => {
+                lines.push(`- ${p.name} (${p.type}): ${p.desc}`);
+            });
+        }
+        if (method.returns) lines.push(`**返回**: ${method.returns}`);
+        if (method.note) lines.push(`**提示**: ${method.note}`);
+        lines.push('');
+    }
+
+    if (api.bestPractices) {
+        lines.push('### 最佳实践');
+        api.bestPractices.forEach(p => {
+            lines.push(`- ${p}`);
+        });
+    }
+
+    return lines.join('\n');
+}
+
+/**
+ * 生成概览
+ */
+function generateOverview() {
+    const topics = [
+        '1. **ccservice** - CCService 数据操作 API（查询、新增、更新、删除等）',
+        '2. **object** - CCObject 对象操作方法',
+        '3. **email** - SendEmail 邮件服务',
+        '4. **time** - TimeUtil 时间格式化工具',
+        '5. **user** - UserInfo 用户信息获取',
+        '6. **logger** - DevLogger 日志输出',
+        '7. **scenarios** - 常见编辑场景示例',
+        '8. **bestpractices** - 编辑最佳实践'
+    ];
+
+    const navs = [
+        '- 编写数据操作代码 → 使用 `topic: \'ccservice\'` 或 `topic: \'object\'`',
+        '- 发送邮件或处理时间 → 使用 `topic: \'email\'` 或 `topic: \'time\'`',
+        '- 获取用户信息或日志 → 使用 `topic: \'user\'` 或 `topic: \'logger\'`',
+        '- 查看常见场景或最佳实践 → 使用 `topic: \'scenarios\'` 或 `topic: \'bestpractices\'`'
+    ];
+
+    return [
+        '## CloudCC 自定义类编辑知识库',
+        '',
+        '### 可用主题',
+        '',
+        ...topics,
+        '',
+        '### 快速导航',
+        ...navs
+    ].join('\n');
+}
+
+/**
+ * 生成 CCService 指南
+ */
+function generateCCServiceGuide() {
+    return formatApiDocs(editCCServiceApis);
+}
+
+/**
+ * 生成 CCObject 指南
+ */
+function generateCCObjectGuide() {
+    const obj = editCCObjectDocs;
+    const lines = [`### ${obj.name}\n${obj.description}\n`, '#### 构造方法'];
+
+    obj.constructors.forEach(c => {
+        lines.push(`**${c.signature}**: ${c.desc}`);
+        lines.push(`\`\`\`java\n${c.example}\n\`\`\``);
+        if (c.recommended) lines.push('⭐ 推荐使用\n');
+    });
+
+    lines.push('#### 数据存取方法');
+    if (obj.methods?.dataAccess?.items) {
+        obj.methods.dataAccess.items.forEach(item => {
+            lines.push(`- **${item.name}**: ${item.desc}`);
+            lines.push(`  \`\`\`java\n  ${item.example}\n  \`\`\``);
+        });
+    }
+
+    lines.push('#### 常见对象类型');
+    obj.commonObjects.forEach(o => {
+        lines.push(`- **${o.name}**: ${o.label}`);
+        lines.push(`  常用字段: ${o.commonFields.slice(0, 3).join(', ')}...`);
+    });
+
+    if (obj.bestPractices) {
+        lines.push('\n### 最佳实践');
+        for (const [category, practices] of Object.entries(obj.bestPractices)) {
+            const catName = category === 'creation' ? '创建对象' :
+                category === 'dataManipulation' ? '数据操作' : '与 CCService 集成';
+            lines.push(`**${catName}**:`);
+            practices.forEach(p => lines.push(`- ${p}`));
+        }
+    }
+
+    return lines.join('\n');
+}
+
+/**
+ * 生成邮件服务指南
+ */
+function generateEmailGuide() {
+    return formatApiDocs({ ...editSendEmailDocs, apis: editSendEmailDocs.methods });
+}
+
+/**
+ * 生成时间工具指南
+ */
+function generateTimeUtilGuide() {
+    const lines = [`### ${editTimeUtilDocs.name}\n${editTimeUtilDocs.description}\n`];
+
+    for (const [key, method] of Object.entries(editTimeUtilDocs.methods)) {
+        lines.push(`#### ${method.description}`);
+        lines.push(`\`\`\`java\n${method.example}\n\`\`\``);
+        if (method.commonFormats) {
+            lines.push('**常见时间格式**:');
+            method.commonFormats.forEach(fmt => lines.push(`- \`${fmt}\``));
+        }
+        lines.push('');
+    }
+
+    return lines.join('\n');
+}
+
+/**
+ * 生成用户信息指南
+ */
+function generateUserInfoGuide() {
+    const lines = [`### ${editUserInfoDocs.name}\n${editUserInfoDocs.description}\n`, '**属性和方法**:'];
+
+    editUserInfoDocs.properties.forEach(prop => {
+        lines.push(`- \`${prop.name}\`: ${prop.desc}`);
+        lines.push(`  返回: ${prop.returns}`);
+    });
+
+    lines.push(`\n**使用场景**: ${editUserInfoDocs.usage}`);
+    return lines.join('\n');
+}
+
+/**
+ * 生成日志输出指南
+ */
+function generateLoggerGuide() {
+    const lines = [`### ${editDevLoggerDocs.name}\n${editDevLoggerDocs.description}\n`];
+
+    editDevLoggerDocs.methods.forEach(method => {
+        lines.push(`#### ${method.name}`);
+        lines.push(`${method.desc} - ${method.usage}`);
+        lines.push(`\`\`\`java\n${method.example}\n\`\`\`\n`);
+    });
+
+    lines.push('### 使用建议');
+    editDevLoggerDocs.tips.forEach(tip => lines.push(`- ${tip}`));
+
+    return lines.join('\n');
+}
+
+/**
+ * 生成常见场景
+ */
+function generateScenariosGuide() {
+    const lines = ['## 常见编辑场景\n'];
+
+    editScenarios.forEach(scenario => {
+        lines.push(`### ${scenario.scenario}`);
+        lines.push(scenario.description);
+        lines.push('\n**示例代码**:');
+        lines.push(`\`\`\`java\n${scenario.example}\n\`\`\`\n`);
+    });
+
+    return lines.join('\n');
+}
+
+/**
+ * 生成最佳实践
+ */
+function generateBestPracticesGuide() {
+    const lines = ['## 编辑类最佳实践\n'];
+    const catMap = {
+        dataValidation: '数据验证',
+        errorHandling: '错误处理',
+        performance: '性能优化',
+        security: '安全性'
+    };
+
+    for (const [category, items] of Object.entries(editBestPractices)) {
+        lines.push(`### ${catMap[category] || category}`);
+        items.forEach(p => lines.push(`- ${p}`));
+        lines.push('');
+    }
+
+    return lines.join('\n');
+}
+
+/**
+ * 获取指定主题的编辑文档
+ */
+function getEditGuide(topic) {
+    const guides = {
+        overview: generateOverview,
+        ccservice: generateCCServiceGuide,
+        object: generateCCObjectGuide,
+        email: generateEmailGuide,
+        time: generateTimeUtilGuide,
+        user: generateUserInfoGuide,
+        logger: generateLoggerGuide,
+        scenarios: generateScenariosGuide,
+        bestpractices: generateBestPracticesGuide
+    };
+
+    const result = guides[topic] ? guides[topic]() : `✗ 未知的主题: ${topic}\n\n支持的主题: ${Object.keys(guides).join(', ')}`;
+
+    // 如果包含代码示例或最佳实践，添加 CloudCC 标准 API 规范提示
+    if (result.includes('```java') || result.includes('最佳实践')) {
+        return result + getCloudCCApiStandards();
+    }
+
+    return result;
+}
+
+/**
+ * 获取 CloudCC 标准 API 规范
+ * 确保编辑代码符合 CloudCC 的标准
+ */
+function getCloudCCApiStandards() {
+    return `
+
+## ⚠️ CloudCC 代码标准规范
+
+### 常用 API 速查表
+
+**DevLogger 日志输出**（正确用法）:
+\`\`\`java
+// ✅ 正确
+DevLogger.devLogInfo("日志信息");      // 输出 Info 级别
+DevLogger.devLogError("错误信息");     // 输出 Error 级别
+DevLogger.devLogError("错误信息", e);  // 输出异常堆栈
+
+// ❌ 错误（不存在这些方法）
+DevLogger.error("...");     // ✗ 无此方法
+DevLogger.warn("...");      // ✗ 无此方法
+DevLogger.debug("...");     // ✗ 无此方法
+\`\`\`
+
+**CCService 数据操作**（常用方法）:
+\`\`\`java
+// 查询（推荐使用 cqlQuery）
+List<CCObject> list = cs.cquery("account");
+List<CCObject> list = cs.cqlQuery("account", "status = 'active'");
+
+// 新增/更新/删除/Upsert
+ServiceResult sr = cs.insert(obj);
+cs.update(obj);
+cs.delete(obj);
+ServiceResult sr = cs.upsert(obj);
+
+// ❌ 过时 API（不推荐）
+List<Map> map = cs.query(...);  // 已过时，使用 cquery 或 cqlQuery
+\`\`\`
+
+**CCObject 对象操作**（标准模式）:
+\`\`\`java
+// 创建对象（标准做法）
+CCObject obj = new CCObject("account");
+
+// 存取字段
+obj.put("name", "值");
+String value = (String) obj.get("name");
+
+// 检查字段存在
+if (obj.containsKey("id")) {
+    // 执行更新操作
+    cs.update(obj);
+} else {
+    // 执行新增操作
+    cs.insert(obj);
+}
+\`\`\`
+
+### 编码检查清单
+- [ ] 日志使用 \`DevLogger.devLogInfo()\` 或 \`DevLogger.devLogError()\`
+- [ ] 查询优先使用 \`cs.cqlQuery()\` 而非 \`cs.query()\`
+- [ ] CCObject 使用 \`new CCObject("apiName")\` 标准构造
+- [ ] 操作后检查 \`ServiceResult\` 返回值
+- [ ] 异常处理使用 try-catch 并用 DevLogger 记录
+- [ ] 获取字段值进行类型转换：\`(String) obj.get("field")\`
+- [ ] 关键操作添加日志记录便于调试
+
+### 常见错误及修正
+
+| 错误代码 | 正确写法 |
+|--------|--------|
+| \`DevLogger.error(...)\` | \`DevLogger.devLogError(...)\` |
+| \`DevLogger.warn(...)\` | \`DevLogger.devLogInfo(...)\` |
+| \`cs.query(...)\` | \`cs.cqlQuery(...)\` |
+| \`new CCObject()\` 无参 | \`new CCObject("account")\` |
+| \`obj.get("field")\` 不转换 | \`(String) obj.get("field")\` |
+`;
+}
+
+module.exports = {
+    // Classes 工具核心知识库（供 handler 使用）
+    javaClassTemplate,    // viewCreateGuide() 使用
+    configStructure,      // viewCreateGuide() 使用
+    ccServiceApis,        // viewApiDocs() 使用
+    errorMessages,        // viewFAQ() 使用
+    faq,                  // viewFAQ() 使用
+    usageGuide,           // viewCreateGuide() 使用
+
+    // 文档生成函数（供 editClass 使用）
+    getEditGuide
+};