cloudcc-cli 2.2.9 → 2.3.1

package/.cursor/skills/cloudcc-cli-dev/docs//350/207/252/345/256/232/344/271/211/351/241/265/351/235/242.md

@@ -0,0 +1,228 @@
+# CloudCC 自定义页面说明文档
+
+## 一、什么是自定义页面
+
+自定义页面是 CloudCC
+平台提供的可视化页面构建工具，基于**自定义组件**创建，通过**拖拉拽**的方式调整页面布局、配置组件属性，实现各种业务需求。
+
+### 核心特点
+
+- 🎨 **可视化编辑** - 无需编码，通过拖拽组件快速搭建页面
+- 🧩 **组件化** - 基于自定义组件构建，支持复用和扩展
+- 📱 **自适应布局** - 支持像素、百分比、视口等多种单位
+- 🔌 **灵活集成** - 支持菜单、内嵌、代码调用等多种使用方式
+
+---
+
+## 二、自定义页面能干什么
+
+### 1. 快速构建业务页面
+
+通过物料库中的基础组件和数据组件，快速搭建符合业务需求的页面，无需从零开始编码。
+
+### 2. 灵活布局设计
+
+- 支持固定宽高布局（像素单位）
+- 支持自适应布局（百分比单位）
+- 支持响应式布局（视口单位）
+
+### 3. 组件间通信
+
+通过 `$CCDK.CCBus` 实现组件间的消息传递，支持复杂业务逻辑的协同工作。
+
+### 4. 多场景集成
+
+- 创建独立菜单页面
+- 内嵌到系统详情页
+- 通过 `ccdk.openCustomPage()` 代码调用
+
+### 5. 移动端调试
+
+支持使用 eruda 插件在移动端 App 中调试 H5 页面。
+
+---
+
+## 三、主要作用
+
+| 作用            | 说明                         |
+| --------------- | ---------------------------- |
+| 🚀 **加速开发** | 可视化搭建，减少重复编码工作 |
+| 🔄 **组件复用** | 一次开发组件，多处页面使用   |
+| 🎯 **业务适配** | 灵活配置，快速响应业务变化   |
+| 📦 **降低门槛** | 非开发人员也可参与页面搭建   |
+| 🔧 **易于维护** | 组件化设计，修改影响范围可控 |
+
+---
+
+## 四、为什么要用自定义页面
+
+### 传统开发方式的问题
+
+- ❌ 每个页面都需要单独编码，重复工作多
+- ❌ 样式和布局不统一，维护成本高
+- ❌ 业务变更时需要修改代码，发布周期长
+- ❌ 非开发人员无法参与，依赖开发资源
+
+### 自定义页面的优势
+
+- ✅ **标准化** - 统一的组件规范和页面结构
+- ✅ **高效** - 拖拽式操作，分钟级完成页面搭建
+- ✅ **灵活** - 组件可配置，适应不同业务场景
+- ✅ **可扩展** - 支持自定义组件开发，满足特殊需求
+- ✅ **低代码** - 业务人员可参与，减少开发依赖
+
+---
+
+## 五、自定义页面能解决哪些问题
+
+### 1. 个性化业务需求
+
+标准页面无法满足的个性化业务场景，通过自定义页面快速实现。
+
+**示例**：特殊的审批流程页面、定制化的数据展示面板
+
+### 2. 复杂数据展示
+
+需要多维度、多格式展示数据的场景。
+
+**示例**：仪表盘、统计报表、数据可视化大屏
+
+### 3. 特殊交互需求
+
+标准组件无法满足的交互逻辑。
+
+**示例**：拖拽排序、动态表单、联动筛选
+
+### 4. 第三方系统集成
+
+需要嵌入外部系统或调用外部 API 的场景。
+
+**示例**：嵌入 BI 报表、调用外部服务接口
+
+### 5. 移动端适配
+
+需要同时支持 PC 和移动端的页面。
+
+**示例**：外勤人员使用的移动审批页面
+
+### 6. 快速原型验证
+
+业务需求不明确时，快速搭建原型进行验证。
+
+**示例**：新功能 MVP 验证、用户反馈收集
+
+---
+
+## 六、使用场景与业务场景
+
+### 6.1 推荐使用自定义页面的场景
+
+| 场景类型        | 具体场景                     | 推荐理由             |
+| --------------- | ---------------------------- | -------------------- |
+| 📊 **数据展示** | 仪表盘、统计报表、数据大屏   | 灵活布局，多组件组合 |
+| 📝 **表单录入** | 复杂表单、动态表单、多级表单 | 组件可配置，校验灵活 |
+| 🔍 **查询搜索** | 高级搜索、多条件筛选         | 组件间通信方便       |
+| 📋 **审批流程** | 定制化审批页、特殊流程       | 业务逻辑可定制       |
+| 📱 **移动端**   | 外勤应用、移动办公           | 自适应布局支持好     |
+| 🔗 **系统集成** | 嵌入外部系统、API 调用       | 扩展性强             |
+| 🎨 **品牌定制** | 企业个性化页面               | 样式可完全定制       |
+
+### 6.2 不推荐使用自定义页面的场景
+
+| 场景           | 原因         | 建议方案         |
+| -------------- | ------------ | ---------------- |
+| 标准 CRUD 操作 | 杀鸡用牛刀   | 使用系统标准页面 |
+| 简单信息展示   | 过度设计     | 使用系统详情页   |
+| 一次性使用     | 投入产出比低 | 评估是否需要     |
+
+---
+
+## 七、最佳实践
+
+### 7.1 页面设计原则
+
+```
+┌─────────────────────────────────┐
+│         自定义页面 (100%)        │
+│  ┌───────────────────────────┐  │
+│  │      自定义组件 (100%)     │  │
+│  │                           │  │
+│  │   组件内部自由布局         │  │
+│  │                           │  │
+│  └───────────────────────────┘  │
+└─────────────────────────────────┘
+```
+
+- 📐 **一页一组件** - 一个页面只放一个组件，画布和组件都设置 100% 宽高
+- 🧩 **组件内布局** - 复杂布局在组件内部实现，保持页面简洁
+- 🔄 **组件复用** - 通用功能封装成组件，多处复用
+
+### 7.2 组件通信规范
+
+```javascript
+// 组件 A - 接收消息
+mounted() {
+  this.$CCDK.CCBus.$on('demoB2A', (args) => {
+    console.log("收到消息", args)
+  })
+},
+beforeDestroy() {
+  this.$CCDK.CCBus.$off('demoB2A') // 记得解绑
+}
+
+// 组件 B - 发送消息
+methods: {
+  emit() {
+    this.$CCDK.CCBus.$emit("demoB2A", "消息内容")
+  }
+}
+```
+
+### 7.3 页面入口选择
+
+| 入口方式   | 适用场景           | 配置方式                |
+| ---------- | ------------------ | ----------------------- |
+| 菜单       | 独立功能模块       | 自定义页面菜单          |
+| 内嵌详情页 | 关联业务展示       | 系统详情页配置          |
+| 代码调用   | 动态跳转、条件打开 | `ccdk.openCustomPage()` |
+
+---
+
+## 八、快速开始
+
+### 8.1 创建自定义页面
+
+1. 登录 CloudCC 系统
+2. 点击右上角头像 → 开发者控制台
+3. 自定义布局 → 自定义页面 → 新建
+4. 从物料库拖拽组件到画布
+5. 配置组件属性
+6. 保存页面
+
+### 8.2 开发自定义组件
+
+参考：[自定义组件开发文档](https://cloudccone.feishu.cn/wiki/AzyWwgHBPiEG2gkeDEXcb56snbb)
+
+### 8.3 调试与发布
+
+- 使用预览功能测试页面
+- 移动端使用 eruda 调试
+- 发布后配置页面入口
+
+---
+
+## 九、总结
+
+自定义页面是 CloudCC 平台提供的**低代码页面构建解决方案**，核心价值在于：
+
+- 🎯 **提效** - 减少重复开发，加速交付
+- 🔧 **灵活** - 适应各种业务场景
+- 📦 **复用** - 组件化设计，一次开发多处使用
+- 🚀 **扩展** - 支持自定义组件，无上限扩展
+
+**适用原则**：标准功能优先，个性化需求用自定义页面。
+
+---
+
+_文档版本：1.0_\
+_最后更新：2026-03-25_

package/README.md

@@ -22,6 +22,28 @@ sudo npm i -g cloudcc-cli
 }
 ```
 
+# ReleaseV2.3.1
+
+#### Release Date: 2026-3-25
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Optimization
+  - Adjusted unit tests
+
+# ReleaseV2.3.0
+
+#### Release Date: 2026-3-25
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Optimization
+  - Fix class management commands
+
 # ReleaseV2.2.9
 
 #### Release Date: 2026-3-25
@@ -31,7 +53,7 @@ sudo npm i -g cloudcc-cli
 #### Release Content
 
 - Optimization
-  - 添加删除组件命令
+  - Add delete component command
 
 # ReleaseV2.2.8
 

package/bin/index.js

@@ -6,6 +6,11 @@ cc.plugin = require("../src/plugin/index")
 
 cc.classes = require("../src/classes/index")
 
+cc.customSetting = require("../src/customSetting/index")
+
+cc.staticResource = require("../src/staticResource/index")
+cc.customPage = require("../src/customPage/index")
+
 cc.schedule = require("../src/timer/index")
 
 cc.triggers = require("../src/triggers/index")
@@ -34,6 +39,8 @@ cc.menu = require("../src/menu/index")
 
 cc.application = require("../src/application/index")
 
+cc.scheduleJob = require("../src/scheduleJob/index")
+
 
 
 module.exports = cc;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.2.9",
+  "version": "2.3.1",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",
@@ -16,7 +16,7 @@
     "cc-mcp": "bin/mcp.js"
   },
   "scripts": {
-    "test-cli-one": "node --test test/application.cli.test.js",
+    "test-cli-one": "node --test test/menu.cli.test.js",
     "test-cli-all": "node --test ",
     "cc-pull": "git fetch --tags -f && git pull",
     "publish-lib": "npm publish --registry https://registry.npmjs.org && git add . && git commit -m 'update' && git push && curl https://npmmirror.com/sync/cloudcc-cli",

package/src/application/delete.js

@@ -0,0 +1,59 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 删除应用（Application）
+ * 用法：cc delete application <projectPath> <appId>
+ */
+async function remove(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const appId = argvs[3];
+
+        if (!appId) {
+            console.error();
+            console.error(chalk.red("Error: 缺少应用 ID"));
+            console.error(chalk.yellow("用法: cc delete application <projectPath> <appId>"));
+            console.error();
+            throw new Error("缺少必需参数: appId");
+        }
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green(`Deleting application (${appId}), please wait...`));
+        console.error();
+
+        const result = await postClass(
+            config.setupSvc + "/api/appProgram/deleteApp",
+            { id: appId },
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            console.error();
+            console.error(chalk.green("Success! Application deleted."));
+            console.error();
+            return result;
+        }
+
+        const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+        console.error();
+        console.error(chalk.red("Error: " + msg));
+        console.error();
+        throw new Error("Delete Application Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("应用删除失败:"), error);
+        throw error;
+    }
+}
+
+module.exports = remove;

package/src/application/get.js

@@ -2,12 +2,38 @@ const { postClass } = require("../../utils/http")
 const { getPackageJson } = require("../../utils/config")
 
 async function get(argvs, isMcp = false) {
-    // TODO: 实现获取应用列表的功能
-    let res = [];
-    if (!isMcp) {
-        console.log(JSON.stringify(res));
+    const projectPath = argvs[2] || process.cwd();
+    const condArg = argvs[3];
+
+    let body = {};
+    if (condArg) {
+        try {
+            body = JSON.parse(decodeURI(condArg));
+        } catch (e) {
+            throw new Error("Get Application List Failed: encodedCondJson 解析失败，请传 encodeURI(JSON.stringify(...))");
+        }
     }
-    return res
+
+    const config = await getPackageJson(projectPath);
+    const result = await postClass(
+        config.setupSvc + "/api/appProgram/queryAppList",
+        body,
+        config.accessToken
+    );
+
+    if (result && result.result) {
+        const data = result.data;
+        const rawList = Array.isArray(data)
+            ? data
+            : (data && Array.isArray(data.list) ? data.list : []);
+        if (!isMcp) {
+            console.log(JSON.stringify(rawList));
+        }
+        return rawList;
+    }
+
+    const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+    throw new Error("Get Application List Failed: " + msg);
 }
 
 module.exports = get;

package/src/application/index.js

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

package/src/classes/delete.js

@@ -0,0 +1,43 @@
+const fs = require("fs");
+const path = require("path");
+const chalk = require("chalk");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+async function remove(nameOrId, projectPath = process.cwd()) {
+    let classId = nameOrId;
+    const classPath = path.join(projectPath, `classes/${nameOrId}/`);
+    const configPath = path.join(classPath, "config.json");
+
+    if (fs.existsSync(configPath)) {
+        const configContent = JSON.parse(fs.readFileSync(configPath, "utf8"));
+        if (configContent.id) {
+            classId = configContent.id;
+        }
+    }
+
+    if (!classId) {
+        throw new Error("Delete Class Failed: class name or id is required");
+    }
+
+    const config = await getPackageJson(projectPath);
+    console.error();
+    console.error(chalk.green(`Deleting class (${classId}), please wait...`));
+    console.error();
+
+    const res = await postClass(
+        config.setupSvc + "/api/ccfag/delete",
+        { id: classId },
+        config.accessToken
+    );
+
+    if (res && res.result) {
+        console.error(chalk.green("Success! Class deleted."));
+        console.error();
+        return res;
+    }
+    const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+    throw new Error("Delete Class Failed: " + msg);
+}
+
+module.exports = remove;

package/src/classes/detail.js

@@ -4,7 +4,14 @@ const path = require("path")
 const { getPackageJson } = require("../../utils/config")
 const { postClass } = require("../../utils/http")
 
-async function detail(name, id) {
+function outputResult(result, isMcp) {
+    if (!isMcp) {
+        console.log(JSON.stringify(result));
+    }
+    return result;
+}
+
+async function detail(name, id, isMcp = false) {
     // 如果有 name，优先查询本地
     if (name && name !== '') {
         const classPath = path.join(process.cwd(), `classes/${name}/`);
@@ -15,14 +22,14 @@ async function detail(name, id) {
         if (fs.existsSync(configPath) && fs.existsSync(javaFilePath)) {
             let configContent = JSON.parse(fs.readFileSync(configPath, 'utf8'));
             let javaContent = fs.readFileSync(javaFilePath, 'utf8');
-            return {
+            return outputResult({
                 name: configContent.name,
                 version: configContent.version,
                 id: configContent.id || null,
                 source: javaContent,
                 published: !!configContent.id,
                 fromLocal: true
-            };
+            }, isMcp);
         }
 
         // 本地文件不完整，从服务器拉取
@@ -44,10 +51,10 @@ async function detail(name, id) {
         let res = await postClass(config.setupSvc + "/api/ccfag/detail", body, config.accessToken)
 
         if (res.result) {
-            return {
+            return outputResult({
                 ...res.data.trigger,
                 fromLocal: false
-            };
+            }, isMcp);
         } else {
             throw new Error('Get Class Details Failed: ' + res.returnInfo);
         }
@@ -62,10 +69,10 @@ async function detail(name, id) {
         let res = await postClass(config.setupSvc + "/api/ccfag/detail", body, config.accessToken)
 
         if (res.result) {
-            return {
+            return outputResult({
                 ...res.data.trigger,
                 fromLocal: false
-            };
+            }, isMcp);
         } else {
             throw new Error('Get Class Details Failed: ' + res.returnInfo);
         }

package/src/classes/index.js

@@ -1,6 +1,12 @@
 const cc = {}
-
+cc.create = require("./create")
+cc.publish = require("./publish")
+cc.pull = require("./pull")
+cc.get = require("./get")
+cc.pullList = require("./pullList")
+cc.detail = require("./detail")
 cc.doc = require("./doc")
+cc.delete = require("./delete")
 function Classes(action, argvs) {
   cc[action](argvs[2], argvs[3])
 }

package/src/customPage/create.js

@@ -0,0 +1,139 @@
+const chalk = require('chalk');
+const { getPackageJson } = require('../../utils/config');
+const { post } = require('../../utils/http');
+const BaseUrl = 'https://developer.apis.cloudcc.cn';
+
+/**
+ * 新建自定义页面
+ *
+ * 用法：cc create customPage <pageLabel> <pageApi> <pluginId|compLabel> [projectPath]
+ */
+async function createCustomPage(argvs) {
+    const pageLabel = argvs[2];
+    const pageApi = argvs[3];
+    const pluginIdentifier = argvs[4];
+    const projectPath = argvs[5] || process.cwd();
+
+    if (!pageLabel || !pageApi || !pluginIdentifier) {
+        console.error();
+        console.error(chalk.red('Error: pageLabel, pageApi and pluginId/compLabel are required'));
+        console.error(chalk.yellow('Usage: cc create customPage <pageLabel> <pageApi> <pluginId|compLabel> [projectPath]'));
+        console.error();
+        return;
+    }
+
+    const config = await getPackageJson(projectPath);
+    if (!config || !config.accessToken) {
+        console.error();
+        console.error(chalk.red('Error: Configuration not found or accessToken is missing'));
+        console.error();
+        return;
+    }
+
+    const devSvcDispatch = config.devSvcDispatch || '/devconsole';
+    const baseUrl = config.baseUrl || BaseUrl;
+
+    const header = {
+        appType: 'lightning-devconsole',
+        accessToken: config.accessToken,
+        source: 'lightning-devconsole',
+        version: 'public',
+    };
+
+    // 先通过 listCustomComp 获取组件列表，再按组件标识匹配目标组件
+    const listRes = await post(
+        `${baseUrl}${devSvcDispatch}/custom/pc/1.0/post/listCustomComp`,
+        { orgId: config.orgId || '' },
+        header
+    );
+    if (!listRes || String(listRes.returnCode) !== '200') {
+        throw new Error('Create Custom Page Failed: list custom components failed');
+    }
+
+    const groupedCompMap = listRes.data || {};
+    const compList = Array.isArray(groupedCompMap['label.dev.bizType.custom'])
+        ? groupedCompMap['label.dev.bizType.custom']
+        : [];
+    if (compList.length === 0) {
+        throw new Error('Create Custom Page Failed: no custom components found');
+    }
+
+    let pluginDetail = compList.find(item =>
+        item &&
+        (item.id === pluginIdentifier || item.compLabel === pluginIdentifier || item.compUniName === pluginIdentifier)
+    );
+    if (!pluginDetail) {
+        throw new Error(`Create Custom Page Failed: component "${pluginIdentifier}" not found in custom component list`);
+    }
+
+    let vueData = {};
+    try {
+        vueData = pluginDetail.vueData ? JSON.parse(pluginDetail.vueData) : {};
+    } catch (e) {
+        throw new Error('Create Custom Page Failed: plugin vueData is not valid JSON');
+    }
+
+    const randomId = (len = 10) => Math.random().toString(36).slice(2, 2 + len);
+    const itemId = randomId(10);
+    const compUniName = pluginDetail.compUniName || pluginDetail.component || pluginDetail.name;
+    const compLabel = pluginDetail.compLabel || pluginDetail.compName || compUniName;
+    const compDesc = pluginDetail.compDesc || '';
+    const templatePropObj = vueData.propObj && typeof vueData.propObj === 'object' ? vueData.propObj : {};
+
+    const pageContentItem = {
+        ...vueData,
+        id: itemId,
+        comId: pluginDetail.id,
+        name: compUniName,
+        componentInfo: {
+            ...(vueData.componentInfo || {}),
+            component: compUniName,
+            compName: compLabel,
+            compDesc,
+        },
+        propObj: {
+            ...templatePropObj,
+            id: itemId,
+            key: templatePropObj.key || randomId(4),
+            pageApi,
+        },
+    };
+
+    const body = {
+        id: '',
+        pageLabel,
+        pageApi,
+        pageContent: JSON.stringify([pageContentItem]),
+        orgId: pluginDetail.orgId || config.orgId || '',
+        compList: [{
+            id: pluginDetail.id,
+            compUniName,
+        }],
+        canvasStyleData: JSON.stringify({ width: 100, height: 100, scale: 100, unit: '%', pageApi }),
+        isTemplate: 0,
+    };
+
+    console.error();
+    console.error(chalk.green(`Creating custom page "${pageLabel}" (api: ${pageApi}, component: ${pluginIdentifier}), please wait...`));
+
+    const res = await post(
+        `${baseUrl}${devSvcDispatch}/custom/pc/1.0/post/insertCustomPage`,
+        body,
+        header
+    );
+
+    if (res && String(res.returnCode) === '200') {
+        const id = res.data?.id || res.data || '';
+        console.error(chalk.green(`Success! Custom page created.${id ? ' ID: ' + id : ''}`));
+        console.error();
+    } else {
+        const errMsg = res?.returnInfo || 'Unknown error';
+        console.error(chalk.red(`Fail: ${errMsg}`));
+        console.error();
+        throw new Error('Create Custom Page Failed: ' + errMsg);
+    }
+
+    return res;
+}
+
+module.exports = createCustomPage;