cloudcc-cli 2.3.1 → 2.3.3

package/src/application/docs/introduction.md

@@ -0,0 +1,81 @@
+# CloudCC 应用模块介绍
+
+## 1. 模块定位
+
+`application` 模块用于在 CloudCC 中创建和管理应用程序（Application）。
+
+应用是菜单与功能入口的承载容器。对象菜单、页面菜单、脚本菜单通常需要归属于某个应用，业务用户才会在对应导航中看到完整功能集合。
+
+---
+
+## 2. 应用能做什么
+
+通过 `application` 模块，你可以：
+
+- 创建新应用并设置应用名称、代码
+- 绑定菜单集合（支持多菜单 ID）
+- 获取当前组织内应用列表
+- 删除指定应用
+
+---
+
+## 3. 应用在平台中的作用
+
+应用解决的是“功能编排与入口组织”问题：
+
+- 将零散菜单按业务域组织为统一导航体验
+- 给不同业务线提供独立的应用入口
+- 配合简档权限，控制不同角色可见的应用能力
+
+---
+
+## 4. 典型使用流程
+
+在 CloudCC 中，应用相关流程通常如下：
+
+1. 准备对象、页面、脚本等能力
+2. 创建或确认对应菜单入口
+3. 创建应用并绑定菜单
+4. 验证应用在目标角色下的可见性与可用性
+
+`cloudcc-cli` 主要覆盖第 3 步（应用创建/查询/删除），建议结合菜单与权限配置一同验收。
+
+---
+
+## 5. 适用场景
+
+以下场景建议使用 `application` 模块：
+
+- 新项目上线，需要快速搭建业务导航应用
+- 多业务线并行，需要拆分不同应用入口
+- 现有菜单较多，需要按业务域重新归类到应用
+- 自动化脚本中需要批量创建和清理测试应用
+
+---
+
+## 6. 与其他模块的关系
+
+`application` 常与以下模块协同：
+
+- `menu`：应用通过菜单承载具体入口
+- `object`：对象能力常通过对象菜单进入应用
+- `customPage`：页面能力可通过页面菜单加入应用
+- `script`：脚本能力可通过脚本菜单加入应用
+
+---
+
+## 7. 建议实践
+
+- 应用命名与编码遵循统一规范（如业务域前缀）
+- 创建前先梳理菜单清单，避免重复或遗漏入口
+- 先在测试环境验证应用可见性，再推广到生产环境
+- 变更应用菜单后，回归验证关键业务流程是否可达
+
+---
+
+## 8. 相关文档与命令
+
+```bash
+cc doc application introduction
+cc doc application devguide
+```

package/src/application/index.js

@@ -2,6 +2,7 @@ const cc = {}
 cc.get = require("./get")
 cc.create = require("./create")
 cc.delete = require("./delete")
+cc.doc = require("./doc")
 function main(action, argvs) {
   cc[action](argvs)
 }

package/src/brief/get.js

@@ -6,7 +6,7 @@ async function get(argvs) {
         let path = argvs[2]
         let config = await getPackageJson(path);
 
-        // 调用接口获取自定义对象页面信息
+        // 获取简档列表
         let response = await postClass(
             config.setupSvc + "/api/customObject/newPage",
             {

package/src/classes/create.js

@@ -4,7 +4,12 @@ const path = require("path")
 const chalk = require("chalk")
 const { getPackageJson } = require("../../utils/config.js")
 
-async function create(name) {
+/**
+ * cc create classes <name>
+ * @param {string[]} argvs [action, type, name, ...]
+ */
+async function create(argvs) {
+    const name = argvs[2]
     let res = await checkUpdate();
     if (!res) {
         let config = await getPackageJson();

package/src/classes/delete.js

@@ -4,7 +4,13 @@ const chalk = require("chalk");
 const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
-async function remove(nameOrId, projectPath = process.cwd()) {
+/**
+ * cc delete classes <nameOrId> [projectPath]
+ * @param {string[]} argvs [action, type, nameOrId, projectPath?]
+ */
+async function remove(argvs) {
+    const nameOrId = argvs[2]
+    const projectPath = argvs[3] != null && argvs[3] !== '' ? argvs[3] : process.cwd()
     let classId = nameOrId;
     const classPath = path.join(projectPath, `classes/${nameOrId}/`);
     const configPath = path.join(classPath, "config.json");

package/src/classes/detail.js

@@ -11,7 +11,14 @@ function outputResult(result, isMcp) {
     return result;
 }
 
-async function detail(name, id, isMcp = false) {
+/**
+ * cc detail classes <name> <id>
+ * @param {string[]} argvs [action, type, name?, id?, isMcp?]
+ */
+async function detail(argvs) {
+    const name = argvs[2]
+    const id = argvs[3]
+    const isMcp = Boolean(argvs[4])
     // 如果有 name，优先查询本地
     if (name && name !== '') {
         const classPath = path.join(process.cwd(), `classes/${name}/`);

package/src/classes/doc.js

@@ -1,486 +1,63 @@
 /**
- * classes 文档统一入口（合并自 prompt.js + classEditor.js）
+ * classes 文档入口：正文均在 `docs/` 目录，本文件只负责按子命令读取并输出。
  */
 const fs = require("fs");
 const path = require("path");
 
-function generateFullMarkdownDoc() {
-    const lines = [
-        '# CloudCC 自定义类开发指南',
-        '',
-        '> 本文档参考 CloudCC 官方「自定义类」文档整理而成：[自定义类](https://help.cloudcc.cn/product03/zi-ding-yi-lei/)。  ',
-        '> 目标：指导开发者在 CloudCC 平台上编写 Java 自定义类，熟练使用 `CCService`、`CCObject`、`SendEmail`、`DevLogger`、`TimeUtil` 等工具类，并理解类在触发器、定时作业、自定义组件中的调用方式。',
-        '',
-        '---',
-        '',
-        '## 1. 概念与使用场景',
-        '',
-        '### 1.1 什么是自定义类',
-        '',
-        '- 自定义类本质上是运行在 CloudCC 平台上的 Java 类。  ',
-        '- 可被以下模块调用：',
-        '  - 自定义按钮',
-        '  - 触发器',
-        '  - 定时类 / 定时作业',
-        '  - 自定义组件（通过 CCDK 请求自定义类）',
-        '- 典型用途：',
-        '  - 封装复杂业务逻辑',
-        '  - 查询 / 写入对象数据',
-        '  - 调用自定义设置、发送邮件、记录开发日志',
-        '',
-        '**注意**：调用 `CCService` 的方法时，需要对异常进行显式抛出或捕获。',
-        '',
-        '### 1.2 入口：进入类开发页面',
-        '',
-        '1. 登录 CloudCC 系统  ',
-        '2. 点击右上角头像，选择「开发者平台」（仅对管理员简档用户开放）  ',
-        '3. 左侧菜单：`扩展 → 类`，进入类开发页面',
-        '',
-        '---',
-        '',
-        '## 2. 示例：查询客户对象数据（AccountClass）',
-        '',
-        '下面是一个官方示例类：查询客户对象数据并返回 JSON。',
-        '',
-        '```java',
-        'import net.sf.json.JSONObject;',
-        'import net.sf.json.JSONArray;',
-        'import net.sf.json.JSON;',
-        '',
-        '/**',
-        ' * author：*** on 2022-10-12',
-        ' * 客户类',
-        ' */',
-        'public class AccountClass {',
-        '    private CCService cs;',
-        '    private UserInfo userInfo;',
-        '',
-        '    public AccountClass(UserInfo userInfo) {',
-        '        this.userInfo = userInfo;',
-        '        cs = new CCService(userInfo);',
-        '    }',
-        '',
-        '    public JSONObject selectAccount() throws Exception {',
-        '        JSONObject rtninfo = new JSONObject(); // 返回结果',
-        '        JSONArray dataList = new JSONArray();  // 数据列表',
-        '        boolean flag = false;',
-        '        try {',
-        '            // 查询客户对象数据',
-        '            String sql = "select name, leixing, fenji, hangye from Account where is_deleted=\'0\' ";',
-        '            List<CCObject> accountList = cs.cqlQuery("Account", sql);',
-        '',
-        '            for (int i = 0; i < accountList.size(); i++) {',
-        '                String name = accountList.get(i).get("name") == null ? "" : accountList.get(i).get("name").toString();',
-        '                String type = accountList.get(i).get("leixing") == null ? "" : accountList.get(i).get("leixing").toString();',
-        '                String grade = accountList.get(i).get("fenji") == null ? "0" : accountList.get(i).get("fenji").toString();',
-        '                String industry = accountList.get(i).get("hangye") == null ? "0" : accountList.get(i).get("hangye").toString();',
-        '',
-        '                JSONObject data = new JSONObject();',
-        '                data.put("name", name);',
-        '                data.put("type", type);',
-        '                data.put("grade", grade);',
-        '                data.put("industry", industry);',
-        '                data.put("no", (i + 1) + ""); // 序号',
-        '                dataList.add(data);',
-        '            }',
-        '            flag = true;',
-        '        } catch (Exception e) {',
-        '            throw e;',
-        '        }',
-        '        rtninfo.put("status", flag);',
-        '        rtninfo.put("data", dataList.toString());',
-        '        return rtninfo;',
-        '    }',
-        '}',
-        '```',
-        '',
-        '要点：',
-        '- 构造函数接收 `UserInfo`，通过它实例化 `CCService`。  ',
-        '- 查询结果使用 `CCObject` 列表封装，再转为 `JSONObject`/`JSONArray` 返回。  ',
-        '- 方法签名抛出 `Exception`，调用方需要处理。',
-        '',
-        '---',
-        '',
-        '## 3. CCService：对象数据读写核心',
-        '',
-        '> `CCService` 是操作 CloudCC 对象（类似 ORM）的核心服务类，支持增删改查、自定义设置等。',
-        '',
-        '### 3.1 在类中实例化 CCService',
-        '',
-        '通用写法：',
-        '',
-        '```java',
-        'public class DemoClass {',
-        '    private CCService cs;',
-        '    private UserInfo userInfo;',
-        '',
-        '    public DemoClass(UserInfo userInfo) {',
-        '        this.userInfo = userInfo;',
-        '        this.cs = new CCService(userInfo);',
-        '    }',
-        '}',
-        '```',
-        '',
-        '在触发器中则通常不需要手动实例化，可直接使用平台提供的 `cs`（见触发器指南）。',
-        '',
-        '### 3.2 新增记录：insert',
-        '',
-        '1. 通过 `CCObject` 构造要插入的记录  ',
-        '2. 调用 `cs.insert(对象)` 持久化到数据库',
-        '',
-        '```java',
-        '// 构造一个数据对象，传入对象 API 名称',
-        'CCObject opp = new CCObject("Opportunity");',
-        '',
-        '// 给 CCObject 赋值，key 为字段 API 名称',
-        'opp.put("name", "新建机会");',
-        'opp.put("jine__c", 10000); // 示例：金额字段',
-        '',
-        '// 插入数据库',
-        'cs.insert(opp);',
-        '```',
-        '',
-        '**注意**：ID、自动编号、创建人、创建时间等系统字段不需要也不应该手动赋值。',
-        '',
-        '### 3.3 查询记录：cquery',
-        '',
-        '`cquery` 提供多种重载，用于按条件和排序查询数据。',
-        '',
-        '- 返回对象全部记录：',
-        '',
-        '```java',
-        'List<CCObject> opps = cs.cquery("Opportunity");',
-        '```',
-        '',
-        '- 按条件查询（where 表达式）：',
-        '',
-        '```java',
-        'List<CCObject> opps = cs.cquery(',
-        '    "Opportunity",',
-        '    "khmc__c = \'" + record_new.get("id") + "\'"',
-        ');',
-        '```',
-        '',
-        '- 按条件 + 排序：',
-        '',
-        '```java',
-        'List<CCObject> opps = cs.cquery(',
-        '    "Opportunity",',
-        '    "khmc__c = \'" + record_new.get("id") + "\'",',
-        '    "jine__c desc"',
-        ');',
-        '```',
-        '',
-        '**注意**：条件与排序中的自定义字段 API 名称要加 `__c` 后缀。',
-        '',
-        '### 3.4 修改记录：update',
-        '',
-        '```java',
-        '// 先查询到目标记录',
-        'List<CCObject> list = cs.cquery("Opportunity", "id = \'" + record_id + "\'");',
-        'if (!list.isEmpty()) {',
-        '    CCObject opp = list.get(0);',
-        '    opp.put("name", "修改后的机会名称");',
-        '    cs.update(opp);',
-        '}',
-        '```',
-        '',
-        '### 3.5 删除记录：delete',
-        '',
-        '```java',
-        'List<CCObject> list = cs.cquery("Opportunity", "id = \'" + record_id + "\'");',
-        'if (!list.isEmpty()) {',
-        '    CCObject opp = list.get(0);',
-        '    cs.delete(opp);',
-        '}',
-        '```',
-        '',
-        '### 3.6 操作共享表',
-        '',
-        '#### 查询共享表',
-        '',
-        '```java',
-        '// isDataObject 传 false，表示查询共享表',
-        'List<CCObject> shares = cs.cquery(',
-        '    "Opportunity",',
-        '    "userid = \'" + userId + "\'",',
-        '    false',
-        ');',
-        '```',
-        '',
-        '#### 删除共享表记录',
-        '',
-        '```java',
-        'cs.deleteShareObjectBySql("Opportunity", "userid = \'" + userId + "\'");',
-        '```',
-        '',
-        '**注意**：共享表中表达式里的字段 **不需要加 `__c` 后缀**。',
-        '',
-        '### 3.7 自定义设置（CustomSetting）',
-        '',
-        '#### 列表类型自定义设置（List）',
-        '',
-        '- 返回某个 API 名称下的全部数据：',
-        '',
-        '```java',
-        'Map listSettings = cs.getListCustomSetting("MyListSettingApiName");',
-        '```',
-        '',
-        '- 返回指定 `Name` 的单条数据：',
-        '',
-        '```java',
-        'Map singleSetting = cs.getListCustomSetting("MyListSettingApiName", "SomeName");',
-        '```',
-        '',
-        '#### 层次结构类型自定义设置（Hierarchy）',
-        '',
-        '```java',
-        '// id 为简档 ID 或用户 ID',
-        'Map hiSetting = cs.getCustomSetting("MyHierarchySettingApiName", profileOrUserId);',
-        '```',
-        '',
-        '---',
-        '',
-        '## 4. 常用工具类',
-        '',
-        '### 4.1 SendEmail：发送邮件',
-        '',
-        '```java',
-        'SendEmail sendEmail = new SendEmail(userInfo);',
-        'sendEmail.sendMailFromSystem(',
-        '    new String[]{"to@example.com"},     // 收件人',
-        '    new String[]{"cc@example.com"},     // 抄送',
-        '    new String[]{"bcc@example.com"},    // 密送',
-        '    "邮件主题",',
-        '    "邮件内容",',
-        '    true                                // 是否纯文本',
-        ');',
-        '```',
-        '',
-        '### 4.2 DevLogger：开发日志',
-        '',
-        '> 用于在自定义类中记录开发日志，便于排查问题。',
-        '',
-        '```java',
-        '// 初始化日志类',
-        'DevLogger cclogger = new DevLogger(userInfo);',
-        '',
-        '// 打印 info 级别日志',
-        'cclogger.devLogInfo("这是 info 日志");',
-        '',
-        '// 打印 error 级别日志',
-        'cclogger.devLogError("这是 error 日志");',
-        '',
-        '// 打印异常堆栈',
-        'try {',
-        '    // 业务逻辑',
-        '} catch (Exception e) {',
-        '    cclogger.devLogError("发生异常", e);',
-        '    throw e;',
-        '}',
-        '```',
-        '',
-        '### 4.3 TimeUtil：多时区日期时间',
-        '',
-        '> 为保证跨时区时间的准确性，推荐使用 `TimeUtil` 获取当前时间与时间格式化工具。',
-        '',
-        '- 获取当前时间（根据用户时区）：',
-        '',
-        '```java',
-        'TpSysTask task = new TpSysTask();',
-        'task.setBeginTime(TimeUtil.getNowDate(userInfo));',
-        '```',
-        '',
-        '- 使用 `SimpleDateFormat` 时设置时区：',
-        '',
-        '```java',
-        'SimpleDateFormat myDateFormat = new SimpleDateFormat("yyyy-MM-dd");',
-        'myDateFormat.setTimeZone(TimeUtil.getUserTimeZone(userInfo));',
-        '```',
-        '',
-        '- 使用工具方法直接获取带时区的 `SimpleDateFormat`：',
-        '',
-        '```java',
-        'SimpleDateFormat myDateFormat =',
-        '    TimeUtil.getSimpleDateFormat("yyyy-MM-dd", userInfo);',
-        '```',
-        '',
-        '- 使用 `Calendar` 时设置时区：',
-        '',
-        '```java',
-        '// 方式一',
-        'Calendar cal = Calendar.getInstance(TimeUtil.getUserTimeZone(userInfo));',
-        '',
-        '// 方式二（推荐使用工具方法）',
-        'Calendar cal2 = TimeUtil.getCalendar(userInfo);',
-        '```',
-        '',
-        '### 4.4 CCObject：数据载体',
-        '',
-        '```java',
-        '// 构造一个数据对象，传入对象 API 名称',
-        'CCObject opp = new CCObject("Opportunity");',
-        '',
-        '// 构造一个共享表对象',
-        'CCObject oppshare = new CCObject("Opportunity", CCObject.IS_SHARED);',
-        '',
-        '// 赋值',
-        'opp.put("name", "value");',
-        '```',
-        '',
-        '---',
-        '',
-        '## 5. 自定义类与其他模块的配合',
-        '',
-        '### 5.1 触发器中使用类',
-        '',
-        '- 触发器可以直接调用自定义类中的方法，也可以直接使用 `CCService`。  ',
-        '- 触发器由 CloudCC 平台动态编译，调用写法与普通 Java 方法调用类似。',
-        '- 典型模式：',
-        '  - 在触发器中只做入口和参数准备',
-        '  - 将复杂逻辑委托给自定义类方法',
-        '',
-        '（触发器具体语法与最佳实践详见 `custom-trigger-dev.md`。）',
-        '',
-        '### 5.2 自定义类调用其他自定义类（PageClsInvoker）',
-        '',
-        '> 当需要在一个自定义类中调用另一个自定义类的方法时，可使用 `PageClsInvoker` 的 `invoker` 方法。',
-        '',
-        '`invoker` 有两个常用重载：',
-        '',
-        '```java',
-        'Object invoker(String className, String method, List<Map> conlist, List<Map> arglist);',
-        'Object invoker(String className, String method, List<Map> conlist, Map map);',
-        '```',
-        '',
-        '参数说明：',
-        '- `className`：目标自定义类名称',
-        '- `method`：要调用的方法名',
-        '- `conlist`：构造器参数列表（可为 `null`）',
-        '  - 每个 Map 包含：',
-        '    - `argType`：参数类型',
-        '    - `argValue`：参数值',
-        '- `arglist` / `map`：方法参数',
-        '  - 同样包含 `argType` 和 `argValue`',
-        '',
-        '#### 5.2.1 使用 Map 作为方法参数',
-        '',
-        '目标类：',
-        '',
-        '```java',
-        'public class Hello {',
-        '',
-        '    public Hello() {}',
-        '',
-        '    public Hello(UserInfo userInfo) {',
-        '        System.out.print("测试");',
-        '    }',
-        '',
-        '    public void test5(Map map) throws Exception {',
-        '        System.out.print("获取 map 中的值" + map.get("name"));',
-        '    }',
-        '}',
-        '```',
-        '',
-        '调用方：',
-        '',
-        '```java',
-        'List<Map> conlist = new ArrayList<Map>();',
-        '',
-        'Map c = new HashMap();',
-        'c.put("argType", UserInfo.class);',
-        'c.put("argValue", userInfo);',
-        'conlist.add(c);',
-        '',
-        'Map m = new HashMap();',
-        'm.put("name", "Alex");',
-        '',
-        'new PageClsInvoker(userInfo).invoker("Hello", "test5", conlist, m);',
-        '```',
-        '',
-        '#### 5.2.2 使用 List<Map> 作为方法参数列表',
-        '',
-        '目标类：',
-        '',
-        '```java',
-        'public class Hello {',
-        '',
-        '    public Hello() {}',
-        '',
-        '    public ServiceResult test3(UserInfo userInfo, String leadName) throws Exception {',
-        '        CCService cs = new CCService((UserInfo) userInfo);',
-        '        CCObject co = new CCObject("Lead");',
-        '        co.put("name", leadName);',
-        '        ServiceResult sr = cs.insert(co);',
-        '        return sr;',
-        '    }',
-        '}',
-        '```',
-        '',
-        '调用方：',
-        '',
-        '```java',
-        'List<Map> arglist = new ArrayList<Map>();',
-        '',
-        'Map u = new HashMap();',
-        'u.put("argType", UserInfo.class);',
-        'u.put("argValue", userInfo);',
-        'arglist.add(u);',
-        '',
-        'Map n = new HashMap();',
-        'n.put("argType", String.class);',
-        'n.put("argValue", "Alex");',
-        'arglist.add(n);',
-        '',
-        'new PageClsInvoker(userInfo).invoker("Hello", "test3", null, arglist);',
-        '```',
-        '',
-        '---',
-        '',
-        '## 6. 自定义类开发 Checklist',
-        '',
-        '- [ ] 类名、方法名与调用方（按钮/触发器/组件/定时作业）约定一致  ',
-        '- [ ] 构造函数正确接收 `UserInfo` 并实例化 `CCService` 等依赖  ',
-        '- [ ] 所有 `CCService` 操作（`insert`/`update`/`delete`/`cquery`）使用正确的对象 API 名称和字段 API 名称（自定义字段加 `__c`）  ',
-        '- [ ] 访问共享表时，表达式中的字段未错误地添加 `__c` 后缀  ',
-        '- [ ] 涉及时间处理的逻辑统一使用 `TimeUtil`，避免时区问题  ',
-        '- [ ] 异常统一捕获并按需抛出，同时使用 `DevLogger` 记录关键错误信息  ',
-        '- [ ] 使用 `SendEmail` 时确认收件地址与内容来源安全可靠  ',
-        '- [ ] 使用 `PageClsInvoker` 跨类调用时，`argType` 与 `argValue` 类型匹配  ',
-        '- [ ] 对外暴露的方法返回结构（如 `JSONObject`）与前端/调用方约定一致，字段清晰、语义明确  ',
-    ];
+const DOCS_DIR = path.join(__dirname, "docs");
+const BACKEND_SDK_JAVA = path.join(__dirname, "..", "api", "backend-sdk-java.md");
 
-    const base = lines.join("\n");
-    const sdkPath = path.join(__dirname, "..", "api", "backend-sdk-java.md");
-    let sdkContent = "";
+function readDocFile(basename) {
+    return fs.readFileSync(path.join(DOCS_DIR, `${basename}.md`), "utf8");
+}
+
+/**
+ * 介绍文档（introduction.md）
+ * 用于了解 CloudCC 自定义类的概念、定位、价值与适用场景。
+ */
+function getIntroductionDoc() {
+    return readDocFile("introduction");
+}
+
+/**
+ * 开发指导文档（devguide.md + backend-sdk-java.md）
+ * 用于在 CloudCC 平台上进行自定义类的开发、调试与调用；末尾拼接后端 SDK 速查。
+ */
+function getDevGuideDoc() {
+    const base = readDocFile("devguide").trimEnd();
+    let sdk = "";
     try {
-        sdkContent = fs.readFileSync(sdkPath, "utf8");
+        sdk = fs.readFileSync(BACKEND_SDK_JAVA, "utf8").trim();
     } catch (e) {
-        sdkContent = `# CloudCC 后端 SDK（Java）使用指南\n\n（未找到文件：${sdkPath}）\n`;
+        sdk = "";
     }
-
-    return [
-        base,
-        "",
-        "---",
-        "",
-        "## 附录：后端 SDK（Java）速查",
-        "",
-        "> 来源：`src/api/backend-sdk-java.md`",
-        "",
-        sdkContent.trim(),
-        "",
-    ].join("\n");
+    if (!sdk) {
+        return base;
+    }
+    return [base, "", "---", "", "## 附录：后端 SDK（Java）速查", "", sdk, ""].join("\n");
 }
 
-function doc() {
-    const content = generateFullMarkdownDoc();
-    console.log(content);
-    return content;
+/**
+ * cc doc classes <introduction|devguide>
+ * @param {string[]} argvs [doc, type, introduction|devguide, ...]
+ */
+function doc(argvs) {
+    const subType = argvs[2]
+    const key = String(subType || "").trim().toLowerCase();
+    if (!key) {
+        throw new Error("cc doc classes 需要子命令：introduction 或 devguide");
+    }
+    if (key === "introduction") {
+        const content = getIntroductionDoc();
+        console.log(content);
+        return content;
+    }
+    if (key === "devguide") {
+        const content = getDevGuideDoc();
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`);
 }
 
-// 兼容旧调用方：统一指向同一个方法（仍返回全量文档）
-doc.getClassEditorDoc = doc;
-doc.getEditGuide = doc;
-
 module.exports = doc;