cloudcc-cli 2.3.0 → 2.3.1

package/.cursor/skills/cloudcc-cli-dev/VUE_CUSTOM_PAGE.md

@@ -0,0 +1,216 @@
+# 自定义页面（Custom Page）
+
+## 覆盖范围
+
+本篇聚焦 CloudCC 自定义页面（Custom Page）的 CLI 操作（仅 `cc` 命令）：
+
+- 创建自定义页面
+- 获取页面列表
+- 删除自定义页面
+
+---
+
+## 什么是自定义页面
+
+自定义页面是 CloudCC 平台提供的**可视化低代码页面构建工具**，基于**自定义组件**创建，通过拖拽组件的方式调整布局、配置属性，快速实现各种业务需求（仪表盘、审批流程、数据大屏等）。
+
+> 注意：自定义页面的内容由自定义组件组成。页面本身是"容器"，组件才是"内容"。  
+> 推荐最佳实践：**一页一组件**，画布和组件均设置 100% 宽高，复杂布局在组件内部实现。
+
+---
+
+## CLI 命令速查
+
+> CLI 调用模式：`cc <action> <type> ...`（动作在前，类型在后）
+
+| 操作     | 命令                                                       |
+| -------- | ---------------------------------------------------------- |
+| 创建页面 | `cc create customPage <pageLabel> <pageApi> <pluginId\|compLabel\|compUniName> [projectPath]` |
+| 查询列表 | `cc get customPage [pageNo] [pageSize] [projectPath]`      |
+| 删除页面 | `cc delete customPage <id> [projectPath]`                  |
+
+---
+
+## 创建自定义页面
+
+### 命令
+
+```bash
+cc create customPage <pageLabel> <pageApi> <pluginId|compLabel|compUniName> [projectPath]
+```
+
+### 参数说明
+
+| 参数                                   | 必填 | 说明                                                                                |
+| -------------------------------------- | ---- | ----------------------------------------------------------------------------------- |
+| `pageLabel`                            | 是   | 页面显示名称（中文/英文均可）                                                       |
+| `pageApi`                              | 是   | 页面 API 名称（唯一标识，英文）                                                     |
+| `pluginId\|compLabel\|compUniName`     | 是   | 组件标识：可传组件 ID、组件显示名（`compLabel`）或组件唯一名（`compUniName`）       |
+| `projectPath`                          | 否   | 项目路径，默认为当前工作目录 `cwd`                                                  |
+
+### 示例
+
+```bash
+# 使用组件 ID 创建
+cc create customPage 销售仪表盘 salesDashboard 69bba42dda48d241327d1cf7
+
+# 使用组件显示名（compLabel）创建
+cc create customPage 销售仪表盘 salesDashboard 合同助手
+
+# 使用组件唯一名（compUniName）创建
+cc create customPage 销售仪表盘 salesDashboard component-contract-assistant
+
+# 指定项目路径
+cc create customPage 销售仪表盘 salesDashboard 69bba42dda48d241327d1cf7 /path/to/project
+```
+
+### 说明
+
+- 创建成功后，控制台会输出页面 ID：`Success! Custom page created. ID: xxx`
+- `cc create customPage` 会自动创建“带组件”的页面，不再是空页面
+
+### `create` 命令补充说明（带组件场景）
+
+当前 `create` 命令内部采用以下流程生成 `pageContent`：
+
+1. 运行 `cc create customPage ...` 后，CLI 会自动从当前组织读取可用自定义组件，并只使用自定义组件分组（`label.dev.bizType.custom`）
+
+2. 在该分组中按输入标识匹配组件（优先支持：`id`、`compLabel`、`compUniName`）
+
+3. 以匹配到组件的 `vueData` 作为 `pageContent` 模板，并做如下处理：
+
+- 将 `vueData` 反序列化为对象（或数组元素对象）
+- 保留 `renderMode`、`isLock`、`events`、`eventsOption`、`style`、`styleOption`、`componentInfo`、`propObj`、`propOption` 等结构
+- 按页面实例补齐/替换基础字段：`id`、`comId`、`name`、`propObj.id`、`propObj.pageApi`
+- 生成 `compList`（最小字段：`id`、`compUniName`）
+
+> 推荐做法：一页一组件，画布与组件都使用 100% 宽高，复杂布局放到组件内部实现。
+
+---
+
+## 查询自定义页面列表
+
+### 命令
+
+```bash
+cc get customPage [pageNo] [pageSize] [projectPath]
+```
+
+### 参数说明
+
+| 参数          | 必填 | 默认值 | 说明                               |
+| ------------- | ---- | ------ | ---------------------------------- |
+| `pageNo`      | 否   | `1`    | 当前页码                           |
+| `pageSize`    | 否   | `20`   | 每页条数                           |
+| `projectPath` | 否   | `cwd`  | 项目路径，默认为当前工作目录       |
+
+### 示例
+
+```bash
+# 获取第 1 页，每页 20 条（默认）
+cc get customPage
+
+# 获取第 2 页，每页 10 条
+cc get customPage 2 10
+
+# 指定项目路径
+cc get customPage 1 20 /path/to/project
+```
+
+### 输出格式
+
+```
+[1]  ID: abc123  Label: 销售仪表盘  API: salesDashboard
+[2]  ID: def456  Label: 审批流程    API: approvalFlow
+```
+
+---
+
+## 将自定义页面挂到菜单（page 菜单）
+
+当你要把某个自定义页面放到导航菜单中时，需要先拿到该页面的 `pageApi`（上面列表输出中的 `API` 字段）。
+
+### 命令
+
+```bash
+cc create menu page <projectPath> <pageApi> <tabName> <pname> [tabStyle] [mobileimg] [cloudccservicetab] [mobileurl]
+```
+
+### 关键规则
+
+- `pageApi` 为自定义页面 API 名（例如 `avaya-callcenter`）。
+- CLI 内部会自动拼接 `lightningPage = pageApi + "#lightning"`。
+- `pageType` 固定为 `customPage`（无需手动传）。
+- `pname` 为菜单名称（必填，建议英文/数字/下划线）。
+- `mobileurl` 默认为空字符串 `""`。
+
+### 示例
+
+```bash
+# 1) 先查页面，拿 API 字段
+cc get customPage
+
+# 2) 用 pageApi 创建 page 类型菜单
+cc create menu page . avaya-callcenter "Avaya 呼叫中心" avaya_callcenter_menu
+
+# 3) 查询菜单确认
+cc get menu .
+```
+
+---
+
+## 删除自定义页面
+
+### 命令
+
+```bash
+cc delete customPage <id> [projectPath]
+```
+
+### 参数说明
+
+| 参数          | 必填 | 说明                               |
+| ------------- | ---- | ---------------------------------- |
+| `id`          | 是   | 页面 ID（从 `list` 命令中获取）    |
+| `projectPath` | 否   | 项目路径，默认为当前工作目录 `cwd` |
+
+### 示例
+
+```bash
+# 删除 ID 为 abc123 的自定义页面
+cc delete customPage abc123
+
+# 指定项目路径
+cc delete customPage abc123 /path/to/project
+```
+
+### 说明
+
+- 删除成功后控制台会输出：`Success! Custom page (ID: abc123) deleted.`
+- 删除仅影响**云端**记录，不影响本地任何文件
+
+---
+
+## 典型工作流
+
+```bash
+# 1. 查询已有页面列表，记录 ID
+cc get customPage
+
+# 2. 创建新页面（获取到 ID 后在开发者控制台拖拽组件填充）
+cc create customPage 销售仪表盘 salesDashboard 69bba42dda48d241327d1cf7
+
+# 3. 删除废弃页面
+cc delete customPage <id>
+```
+
+---
+
+## 注意事项
+
+- 所有命令需要项目目录下存在 `cloudcc-cli.config.js`（或 `package.json` 中包含 `accessToken`）才能正常工作
+- `pageApi` 在同一组织内必须唯一
+- `cc create customPage` 当前依赖“自定义组件分组（label.dev.bizType.custom）”数据
+- 目标组件必须在该分组中可匹配，且包含 `vueData` 字段
+
+---

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,17 @@ 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

package/bin/index.js

@@ -8,6 +8,7 @@ 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")
@@ -38,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.3.0",
+  "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;