cloudcc-cli 2.3.4 → 2.3.5

package/mcp/index.js

@@ -662,11 +662,21 @@ mcpServer.registerTool(
     cloudccOverviewHandler.getCloudCCDevelopmentOverview
 );
 
+// ==================== JSP 迁移规则（供 AI 编排批量迁移） ====================
+mcpServer.registerTool(
+    'get_jsp_migration_rules',
+    {
+        description: '返回 JSP 迁移的固定规则：从 /controller.action?name= 定位 customize 下 JSP、批量迁移时如何循环调用其它 JSP 工具、以及 PageClsInvoker 调用约定。处理 JSP 迁移或批量迁移前应先调用本工具。',
+        inputSchema: z.object({})
+    },
+    jspMigratorHandler.getJspMigrationRules
+);
+
 // ==================== JSP Migration Analyzer 工具 ====================
 mcpServer.registerTool(
     'analyze_jsp_migration',
     {
-        description: '分析旧 JSP 页面，提取 reason 分支、对象依赖和迁移风险，输出迁移报告（不落地代码）。',
+        description: '分析旧 JSP 页面，提取 reason 分支、对象依赖和迁移风险，输出迁移报告（不落地代码）。批量迁移前建议先调用 get_jsp_migration_rules。',
         inputSchema: z.object({
             jspPath: z.string().min(1).describe('JSP 文件路径（绝对路径或相对 projectPath）'),
             helpDocPath: z.string().optional().describe('帮助文档路径（可选），如 jspTemp/帮助文档.md'),
@@ -684,7 +694,7 @@ mcpServer.registerTool(
 mcpServer.registerTool(
     'split_jsp_to_cloudcc',
     {
-        description: '将旧 JSP 页面拆分为 CloudCC 自定义类和自定义组件，并生成迁移报告。支持 apply/dry-run 两种模式。',
+        description: '将旧 JSP 页面拆分为 CloudCC 自定义类和自定义组件，并生成迁移报告。支持 apply/dry-run 两种模式。批量迁移前建议先调用 get_jsp_migration_rules。',
         inputSchema: z.object({
             jspPath: z.string().min(1).describe('JSP 文件路径（绝对路径或相对 projectPath）'),
             helpDocPath: z.string().optional().describe('帮助文档路径（可选），如 jspTemp/帮助文档.md'),

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

@@ -21,7 +21,7 @@ const { runCcCommand, buildRunDetail } = require('../../cliRunner');
  */
 async function getCloudCCDevelopmentOverview({ }) {
     try {
-        const run = runCcCommand(['doc', 'project', 'overview']);
+        const run = runCcCommand(['doc', 'project']);
         if (!run.success) {
             return {
                 content: [{

package/mcp/tools/JSP Migrator/handler.js

@@ -827,6 +827,51 @@ async function runMigration({
     }
 }
 
+/**
+ * 供 MCP 工具 get_jsp_migration_rules 返回的固定说明，便于 AI 在批量迁移前统一遵循。
+ */
+const JSP_MIGRATION_RULES_MARKDOWN = `# JSP 迁移处理规则（CloudCC）
+
+## 1. 从旧系统 URL 定位 JSP 源文件
+
+- 若页面或配置中出现形如 \`/controller.action?name=<name>\` 的地址（示例：\`name=wt_ly\`），应在**项目根目录下的 customize 目录**中查找对应 JSP。
+- 常见约定：\`<projectPath>/customize/<name>.jsp\`（若实际仓库使用子目录或其它扩展名，以仓库为准）。
+- 解析出真实路径后，再将其作为 \`jspPath\` 传入 \`analyze_jsp_migration\` 或 \`split_jsp_to_cloudcc\`（可相对 \`projectPath\`）。
+
+## 2. 批量迁移时的建议流程
+
+1. 先调用本说明（get_jsp_migration_rules）确认规则。
+2. 在仓库中列举或搜索 \`customize\` 下需处理的 \`.jsp\`（或根据 URL 中的 \`name\` 逐个解析路径）。
+3. 对每个 JSP 单独调用 \`analyze_jsp_migration\`（仅分析）或 \`split_jsp_to_cloudcc\`（生成类与组件）；不要假设 MCP 会在服务端自动循环多个文件。
+
+## 3. 自定义页面 / 自定义类中调用其它类（PageClsInvoker）
+
+在服务端自定义类中，通过 \`PageClsInvoker\` 调用其它自定义类方法，典型形式如下：
+
+\`\`\`java
+// userInfo 为当前上下文的 UserInfo；类名、方法名为目标自定义类及其方法；最后一个参数为参数列表（如 List）
+Object result = new PageClsInvoker(userInfo).invoker("TargetClassName", "targetMethodName", argList);
+\`\`\`
+
+示例（类名、方法名以实际平台为准）：
+
+\`\`\`java
+Object result2 = new PageClsInvoker(userInfo).invoker("LabDingTalkProdlemMessage", "sendTextMessageByUserCodeList", arglist0);
+\`\`\`
+
+迁移 JSP 内出现的同类调用时，保持上述调用形态，并核对目标类、方法在平台中已存在且参数类型一致。
+
+## 4. 与迁移工具的配合
+
+- \`analyze_jsp_migration\` / \`split_jsp_to_cloudcc\` 会从 JSP 文本中识别 \`PageClsInvoker(userInfo).invoker("类名","方法名", ...)\` 形式的依赖，并写入迁移报告；具体业务实现需在生成后的自定义类中补全或调整。
+`;
+
+async function getJspMigrationRules() {
+    return {
+        content: [{ type: 'text', text: JSP_MIGRATION_RULES_MARKDOWN }]
+    };
+}
+
 async function analyzeJspMigration(params) {
     return runMigration({ ...(params || {}), mode: 'dry-run' });
 }
@@ -836,6 +881,7 @@ async function splitJspToCloudcc(params) {
 }
 
 module.exports = {
+    getJspMigrationRules,
     analyzeJspMigration,
     splitJspToCloudcc,
     runMigrationForCli: runMigration

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.3.4",
+  "version": "2.3.5",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",
@@ -12,14 +12,13 @@
   "bin": {
     "cloudccCreate": "bin/project.js",
     "cloudccBuild": "bin/plugin.js",
-    "cc": "bin/cc.js",
-    "cc-mcp": "bin/mcp.js"
+    "cc": "bin/cc.js"
   },
   "scripts": {
     "test-cli-one": "node --test test/globalSelectList.cli.test.js",
     "test-cli-all": "node --test ",
     "cc-pull": "git fetch --tags -f && git pull",
-    "npm-login": "npm login --registry https://registry.npmmirror.com",
+    "npm-login": "npm login --registry https://registry.npmjs.com",
     "npm-publish": "npm publish --registry https://registry.npmjs.org && git add . && git commit -m 'update' && git push && curl https://npmmirror.com/sync/cloudcc-cli",
     "package-jar": "mvn clean && mvn package",
     "fetch-dev-env": "node src/mcp/tools/dev-env/fetcher.js",

package/src/button/create.js

@@ -0,0 +1,169 @@
+/**
+ * 自定义按钮 - 新建
+ * API: POST {setupSvc}/api/buttonlink/saveButton
+ * CLI: cc create button <projectPath> <objid> <label> [name] [btnType] [event]
+ *
+ * 参数说明：
+ * - projectPath  : 项目根目录
+ * - objid        : 对象 ID
+ * - label        : 按钮标签（必填）
+ * - name         : 按钮 API 名称（可选，默认同 label）
+ * - btnType      : 显示类型，detailBtn（详情页面按钮，默认）| listBtn（列表按钮）
+ * - event        : 按钮类型，template（默认）| lightning-script | lightning-url | url
+ *
+ * 各类型默认值：
+ * - template / lightning-script : functionCode = "alert('hello world')"
+ * - lightning-script            : h5FunctionCode = "alert('hello world')"
+ * - lightning-url / url         : functionCode = "www.cloudcc.com"
+ * - lightning-url               : mobileurl 自动选取自定义页面组件列表第一项
+ */
+const chalk = require("chalk");
+const axios = require("axios");
+const https = require("https");
+const http = require("http");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+// 用户侧 event 名称 -> API 实际 event 值
+const EVENT_MAP = {
+    "template": "lightning",
+    "lightning-script": "lightning-script",
+    "lightning-url": "lightning-url",
+    "url": "URL"
+};
+
+const httpsAgent = new https.Agent({ rejectUnauthorized: false });
+const httpAgent = new http.Agent({ rejectUnauthorized: false });
+
+/**
+ * 从 devconsole-svc 获取自定义页面组件列表，返回首个页面对象
+ * @param {string} setupSvc  配置中的 setupSvc 地址
+ * @param {string} accessToken
+ */
+async function fetchFirstCustomPage(setupSvc, accessToken) {
+    // 从 setupSvc 移除末尾服务路径，拼 devconsole 路径
+    // 例：https://xxx/ccdomaingateway/setup → https://xxx/ccdomaingateway/devconsole/...
+    const base = setupSvc.replace(/\/[^/]+$/, "");
+    const url = base + "/devconsole/custom/pc/1.0/post/pageCustomPage";
+    const res = await axios({
+        url,
+        method: "post",
+        httpsAgent,
+        httpAgent,
+        timeout: 60000,
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        data: {
+            head: {
+                appType: "lightning-setup",
+                appVersion: "0.0.1",
+                accessToken,
+                source: "lightning-setup",
+                version: "public"
+            },
+            body: {
+                pageNo: 1,
+                pageSize: 2000000,
+                condition: { pageLabel: "", dtBegin: "", dtEnd: "" }
+            }
+        }
+    });
+    const list = res.data && res.data.data && res.data.data.list;
+    return Array.isArray(list) && list.length > 0 ? list[0] : null;
+}
+
+/**
+ * 新建自定义按钮
+ * @param {string} projectPath
+ * @param {string} objid       对象 ID
+ * @param {string} label       按钮标签
+ * @param {string} name        按钮 API 名称（可选）
+ * @param {string} btnType     detailBtn | listBtn（默认 detailBtn）
+ * @param {string} eventType   template | lightning-script | lightning-url | url（默认 template）
+ */
+async function create(projectPath = process.cwd(), objid, label, name, btnType = "detailBtn", eventType = "template") {
+    if (!objid) throw new Error("Create Button Failed: objid is required");
+    if (!label) throw new Error("Create Button Failed: label is required");
+
+    const resolvedName = name || label;
+    const resolvedBtnType = btnType || "detailBtn";
+    const resolvedEvent = eventType || "template";
+
+    const apiEvent = EVENT_MAP[resolvedEvent];
+    if (!apiEvent) {
+        throw new Error(
+            `Create Button Failed: unknown event type "${resolvedEvent}". ` +
+            `Must be one of: template, lightning-script, lightning-url, url`
+        );
+    }
+
+    const config = await getPackageJson(projectPath);
+
+    console.error();
+    console.error(chalk.green("Creating custom button, please wait..."));
+    console.error();
+
+    // 构建按钮 VO 基础结构
+    const tpSysButtonVO = {
+        label,
+        name: resolvedName,
+        btnType: resolvedBtnType,
+        event: apiEvent,
+        behavior: "self",
+        menubar: true,
+        functionCode: "",
+        remark: "",
+        mobileurl: "",
+        h5FunctionCode: "",
+        category: "CustomButton",
+        custompageId: "",
+        iscustom: "",
+        visible: "1"
+    };
+
+    // 按类型填充默认值
+    if (resolvedEvent === "template") {
+        // PC 端 JavaScript 代码
+        tpSysButtonVO.functionCode = "alert('hello world')";
+    } else if (resolvedEvent === "lightning-script") {
+        // PC + 移动端均支持
+        tpSysButtonVO.functionCode = "alert('hello world')";
+        tpSysButtonVO.h5FunctionCode = "alert('hello world')";
+    } else if (resolvedEvent === "lightning-url") {
+        // PC 端 URL 地址
+        tpSysButtonVO.functionCode = "www.cloudcc.com";
+        // 移动端：自动取自定义页面组件列表第一项
+        try {
+            const firstPage = await fetchFirstCustomPage(config.setupSvc, config.accessToken);
+            if (firstPage) {
+                tpSysButtonVO.mobileurl = `__UNI__110007E/#/pages/index/index?pageApi=${firstPage.pageApi}`;
+                tpSysButtonVO.custompageId = firstPage.id;
+                console.error(chalk.cyan(`Using custom page: ${firstPage.pageLabel} (pageApi: ${firstPage.pageApi})`));
+            } else {
+                console.error(chalk.yellow("Warning: No custom page found, mobileurl will be empty."));
+            }
+        } catch (e) {
+            console.error(chalk.yellow(`Warning: Could not fetch custom page list: ${e.message}`));
+        }
+    } else if (resolvedEvent === "url") {
+        // PC 端 URL（仅 PC 支持）
+        tpSysButtonVO.functionCode = "www.cloudcc.com";
+    }
+
+    const body = { objid, tpSysButtonVO };
+
+    const res = await postClass(
+        config.setupSvc + "/api/buttonlink/saveButton",
+        body,
+        config.accessToken
+    );
+
+    if (res && res.result) {
+        console.error(chalk.green(`Success! Custom button "${label}" created.`));
+        console.error();
+        return res;
+    }
+
+    throw new Error("Create Button Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+}
+
+module.exports = create;

package/src/button/delete.js

@@ -0,0 +1,35 @@
+/**
+ * 自定义按钮 - 删除
+ * API: POST {setupSvc}/api/buttonlink/deleteButton
+ * CLI: cc delete button <projectPath> <id>
+ *
+ * 参数说明：
+ * - projectPath : 项目根目录
+ * - id          : 自定义按钮 ID
+ */
+const chalk = require("chalk");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+async function remove(projectPath = process.cwd(), id) {
+    if (!id) {
+        throw new Error("Delete Button Failed: id is required");
+    }
+    const config = await getPackageJson(projectPath);
+    console.error();
+    console.error(chalk.green(`Deleting button (${id}), please wait...`));
+    console.error();
+    const res = await postClass(
+        config.setupSvc + "/api/buttonlink/deleteButton",
+        { id },
+        config.accessToken
+    );
+    if (res && res.result) {
+        console.error(chalk.green("Success! Button deleted."));
+        console.error();
+        return res;
+    }
+    throw new Error("Delete Button Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+}
+
+module.exports = remove;

package/src/button/doc.js

@@ -0,0 +1,36 @@
+/**
+ * button 文档统一入口
+ */
+const fs = require("fs");
+const path = require("path");
+
+const DOCS_DIR = path.join(__dirname, "docs");
+
+function readDocFile(basename) {
+    return fs.readFileSync(path.join(DOCS_DIR, `${basename}.md`), "utf8");
+}
+
+/**
+ * cc doc button <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 button 需要子命令：introduction 或 devguide");
+    }
+    if (key === "introduction") {
+        const content = readDocFile("introduction");
+        console.log(content);
+        return content;
+    }
+    if (key === "devguide") {
+        const content = readDocFile("devguide");
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`);
+}
+
+module.exports = doc;

package/src/button/docs/devguide.md

@@ -0,0 +1,133 @@
+# CloudCC 按钮与链接操作指南
+
+---
+
+## 1. 入口与列表页
+
+进入路径：`对象管理 → 选择对象 → 按钮和链接` 标签页
+
+列表页分为两个 Tab：
+- **标准按钮和链接**：系统内置，不可删除
+- **自定义按钮和链接**：开发者自定义
+
+列表展示字段：标签 / 名称 / 显示类型
+
+---
+
+## 2. 查询按钮列表
+
+```bash
+cc get button . <prefix>
+```
+
+- `<prefix>`：对象的 prefix，可从对象管理页或对象 API 名称前缀获取（如 `a75`）
+
+返回结构：
+
+```json
+{
+  "objname": "玫瑰花不带刺",
+  "objid": "202646FC67ACF24D39sG",
+  "standbutton": [
+    {
+      "id": "adc20262A1F4957UmT0l",
+      "label": "提交待审批",
+      "name": "Submit",
+      "btnType": "detailBtn",
+      "category": "StandardButton",
+      "event": "URL",
+      "behavior": "self",
+      "url": null,
+      "functionCode": null,
+      "mobileurl": ""
+    }
+  ],
+  "custbutton": []
+}
+```
+
+| 字段          | 说明                                        |
+|---------------|---------------------------------------------|
+| `standbutton` | 标准按钮列表                                |
+| `custbutton`  | 自定义按钮列表                              |
+| `btnType`     | `detailBtn` 详情页按钮 / `listBtn` 列表按钮 |
+| `category`    | `StandardButton` 标准 / `CustomButton` 自定义 |
+| `event`       | `URL` 跳转 / `JavaScript` 执行脚本         |
+| `behavior`    | 打开方式：`self` 当前页 / `newWindow` 新窗口 |
+
+---
+
+## 3. 新建自定义按钮
+
+```bash
+cc create button . <objid> <label> [name] [btnType] [event]
+```
+
+| 参数        | 必填 | 说明                                                                        |
+|-------------|------|-----------------------------------------------------------------------------|
+| `objid`     | ✅   | 所属对象 ID                                                                 |
+| `label`     | ✅   | 按钮标签（显示名称）                                                        |
+| `name`      | ❌   | 按钮 API 名称，默认同 `label`                                               |
+| `btnType`   | ❌   | 显示类型：`detailBtn`（详情页按钮，默认）/ `listBtn`（列表按钮）            |
+| `event`     | ❌   | 按钮类型，见下表，默认 `template`                                           |
+
+### 按钮类型（event）
+
+| 取值              | 平台支持         | 说明                                                      |
+|-------------------|------------------|-----------------------------------------------------------|
+| `template`        | 仅 PC            | PC 端 JavaScript 代码，默认代码 `alert('hello world')`    |
+| `lightning-script`| PC + 移动端      | PC 和移动端各需要 JS 代码，默认均为 `alert('hello world')` |
+| `lightning-url`   | PC + 移动端      | PC 端填 URL，移动端自动选取自定义页面组件列表第一项       |
+| `url`             | 仅 PC            | PC 端 URL 地址，默认 `www.cloudcc.com`                    |
+
+### 示例
+
+```bash
+# 新建 template 类型按钮（默认）
+cc create button . 202646FC67ACF24D39sG "我的按钮"
+
+# 指定名称和显示类型
+cc create button . 202646FC67ACF24D39sG "我的按钮" myBtn detailBtn
+
+# lightning-script 类型，列表按钮
+cc create button . 202646FC67ACF24D39sG "脚本按钮" scriptBtn listBtn lightning-script
+
+# lightning-url 类型（移动端自动取第一个自定义页面组件）
+cc create button . 202646FC67ACF24D39sG "跳转按钮" urlBtn detailBtn lightning-url
+
+# url 类型
+cc create button . 202646FC67ACF24D39sG "外链按钮" linkBtn detailBtn url
+```
+
+> **注意：** 各类型代码/URL 默认值仅供快速创建使用，创建后请在页面上编辑替换为实际内容。
+
+---
+
+## 4. 删除自定义按钮
+
+```bash
+cc delete button . <id>
+```
+
+| 参数  | 必填 | 说明               |
+|-------|------|--------------------|
+| `id`  | ✅   | 自定义按钮 ID      |
+
+> **注意：** 仅支持删除自定义按钮，标准按钮不可删除。
+
+### 示例
+
+```bash
+cc delete button . adc202642BBED6BFlu6D
+```
+
+---
+
+## 5. 查看文档
+
+```bash
+cc doc button introduction   # 能力与适用场景说明
+cc doc button devguide        # 本操作指南
+```
+
+---

package/src/button/docs/introduction.md

@@ -0,0 +1,60 @@
+# CloudCC 按钮与链接能力说明
+
+## 1. 什么是按钮与链接
+
+按钮和链接有助于将 CloudCC 数据与外部 URL、应用程序、公司内部网或其他后端办公系统集成在一起。
+
+按钮可以显示在以下位置：
+- **详细信息页**：记录详情页面上的操作按钮
+- **相关列表**：对象关联子列表区域的操作按钮
+- **列表视图**：搜索/列表布局中的批量操作按钮
+
+---
+
+## 2. 按钮分类
+
+### 2.1 标准按钮（Standard Button）
+
+系统内置的标准操作按钮，不可删除，可控制显示/隐藏。
+
+| 标签       | 名称           | 显示类型         |
+|------------|----------------|-----------------|
+| 提交待审批  | Submit         | 详细信息页按钮   |
+| 编辑        | Edit           | 详细信息页按钮   |
+| 新建        | New            | 列表按钮         |
+| 批量转移    | Batch Transfer | 列表按钮         |
+| 删除        | Delete         | 详细信息页按钮   |
+| 批量新增    | Batch Added    | 列表按钮         |
+| 复制        | Clone          | 详细信息页按钮   |
+| 共享        | Share          | 详细信息页按钮   |
+| 批量删除    | Batch Delete   | 列表按钮         |
+| 批量编辑    | Batch Editor   | 列表按钮         |
+| 合并        | Merge          | 列表按钮         |
+
+### 2.2 自定义按钮（Custom Button）
+
+开发者自定义的按钮或链接，支持配置跳转 URL、执行脚本、调用自定义类等行为。
+
+---
+
+## 3. 按钮类型（btnType）
+
+| 值          | 说明           |
+|-------------|----------------|
+| `detailBtn` | 详细信息页按钮  |
+| `listBtn`   | 列表按钮        |
+
+## 4. 按钮行为（event）
+
+| 值            | 说明                   |
+|---------------|------------------------|
+| `URL`         | 跳转到指定 URL         |
+| `JavaScript`  | 执行 JavaScript 代码   |
+
+---
+
+## 5. 如何将按钮添加到页面
+
+- **详细信息页**：编辑页面布局，将按钮拖入布局
+- **相关列表**：在页面布局中找到相关列表，编辑其属性
+- **列表视图**：在"搜索布局"中编辑列表视图布局

package/src/button/get.js

@@ -0,0 +1,60 @@
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+/**
+ * cc get button <projectPath> <prefix>
+ * 查询对象的标准按钮和自定义按钮列表
+ *
+ * @param {string} projectPath
+ * @param {string} prefix  对象 prefix（如 "a75"）
+ * @param {boolean} isMcp
+ */
+async function get(projectPath = process.cwd(), prefix, isMcp = false) {
+    if (!prefix) {
+        throw new Error("Get Button List Failed: prefix is required");
+    }
+    const config = await getPackageJson(projectPath);
+    const res = await postClass(
+        config.setupSvc + "/api/buttonlink/listButton",
+        { prefix },
+        config.accessToken
+    );
+    if (res && res.result) {
+        const data = res.data || {};
+        const result = {
+            objname: data.objname || "",
+            objid: data.objid || "",
+            standbutton: (data.standbutton || []).map(btn => ({
+                id: btn.id,
+                label: btn.label,
+                name: btn.name,
+                btnType: btn.btnType,
+                category: btn.category,
+                event: btn.event,
+                behavior: btn.behavior,
+                url: btn.url || null,
+                functionCode: btn.functionCode || null,
+                mobileurl: btn.mobileurl || ""
+            })),
+            custbutton: (data.custbutton || []).map(btn => ({
+                id: btn.id,
+                label: btn.label,
+                name: btn.name,
+                btnType: btn.btnType,
+                category: btn.category,
+                event: btn.event,
+                behavior: btn.behavior,
+                url: btn.url || null,
+                functionCode: btn.functionCode || null,
+                mobileurl: btn.mobileurl || ""
+            }))
+        };
+        if (!isMcp) {
+            console.log(JSON.stringify(result));
+        }
+        return result;
+    }
+    throw new Error("Get Button List Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+}
+
+module.exports = get;

package/src/button/index.js

@@ -0,0 +1,20 @@
+const cc = {};
+cc.doc = require("./doc");
+cc.get = require("./get");
+cc.create = require("./create");
+cc.delete = require("./delete");
+
+function Button(action, argvs) {
+    if (action === "doc") {
+        cc.doc(argvs);
+        return;
+    }
+    if (action === "create") {
+        // cc create button <projectPath> <objid> <label> [name] [btnType] [event]
+        cc.create(argvs[2], argvs[3], argvs[4], argvs[5], argvs[6], argvs[7]);
+        return;
+    }
+    cc[action](argvs[2], argvs[3], argvs[4]);
+}
+
+module.exports = Button;

package/src/classes/docs/introduction.md

@@ -232,26 +232,6 @@
 
 ---
 
-## 11. 线上现状观察（来自当前环境）
-
-线上共 87 个自定义类，命名与职责呈现明显分层趋势：
-
-- `Controller` 类：承接流程入口与动作编排
-- `Util` 类：沉淀通用方法与查询能力
-- `Service` 类：承担外部集成与业务服务
-- `Handler` 类：承接触发器下沉逻辑
-- `Bot` 类：承载智能助手相关业务
-
-从源码统计看，当前环境中大量类已在使用：
-
-- `CCService`（数据 CRUD 与查询）
-- JSON 处理能力
-- 异常机制（`Exception` 相关）
-
-这说明自定义类已成为该环境中“复杂逻辑与复用能力”的核心载体。
-
----
-
 ## 12. 一句话结论
 
 当业务进入“多对象、复杂规则、跨系统、可复用、可治理”阶段时，CloudCC 自定义类是最关键的后端实现手段：它不仅能实现功能，更能提升系统长期可维护性与稳定性。