cloudcc-cli 2.2.9 → 2.3.1

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

@@ -3,10 +3,12 @@
 本篇聚焦用 `cloudcc-cli` 的 `cc` 命令完成：
 
 - 创建自定义对象（Custom Object）
+- 删除自定义对象
 - 查询对象列表
 - 查询对象字段
 - 为对象创建字段（支持多字段类型）
--（可选）创建菜单、创建应用（把对象挂到导航中）
+- 删除字段
+  -（可选）创建菜单、创建应用（把对象挂到导航中）
 
 ---
 
@@ -21,14 +23,40 @@
 
 ```bash
 cc create object <projectPath> <label>
+cc create object <projectPath> <label> <nameLabel>
 ```
 
 示例：
 
 ```bash
 cc create object . 客户
+cc create object . 客户 customer_custom_object
 ```
 
+说明：
+
+- `nameLabel` 可选，不传时会由工具根据 `label` 自动生成（例如 `customer_custom_object`）。
+
+---
+
+## 删除自定义对象
+
+### CLI 命令（项目已有实现）
+
+```bash
+cc delete object <projectPath> <objid>
+```
+
+示例：
+
+```bash
+cc delete object . 20261EF49B88F9269cVr
+```
+
+说明：
+
+- `objid` 为对象 ID，可先用 `cc get object <projectPath> custom` 查询。
+
 ---
 
 ## 查询对象列表
@@ -36,19 +64,27 @@ cc create object . 客户
 ### CLI 命令（输出 JSON）
 
 ```bash
-# type 可选：standard / custom / both（默认：both）
+# type 可选：standard / custom / chat / trigger / fields
+# 不传 type 时返回 standard + custom
 cc get object <projectPath> [type]
+
+# 当 type=fields 时，需要额外传对象 JSON（至少含 objprefix）
+cc get object <projectPath> fields <encodedObjectJson>
 ```
 
 示例：
 
 ```bash
-cc get object . both
+cc get object .
+cc get object . custom
+cc get object . fields "$(node -e 'console.log(encodeURI(JSON.stringify({objprefix:\"a01\"})))')"
 ```
 
 用途：
 
 - 获取对象 `objprefix` / 对象 `id`（后续创建字段、触发器会用到）
+- `type=trigger` 时可拿到触发器创建所需的目标对象信息
+- `type=fields` 时用于基于对象前缀查询字段（需额外传 encodedObjectJson，通常更建议直接使用 `cc get fields`）
 
 ---
 
@@ -94,18 +130,65 @@ cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
 
 ---
 
+## 删除字段（Field）
+
+### CLI 命令（项目已有实现）
+
+```bash
+cc delete fields <projectPath> <fieldId> <objid>
+```
+
+示例：
+
+```bash
+cc delete fields . ffe2026F12B15D3sCX5R 202688F2CF34EE6vnMQ5
+```
+
+说明：
+
+- 删除接口为“彻底删除”，执行前请确认该字段未被公式字段、触发器、脚本、页面布局依赖。
+
+---
+
 ## 菜单与应用（让对象可访问）
 
 ### 创建菜单（CLI）
 
 ```bash
-cc create menu <type> <projectPath> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+cc create menu object <projectPath> <objectId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+cc create menu page <projectPath> <pageApi> <tabName> <pname> [tabStyle] [mobileimg] [cloudccservicetab] [mobileurl]
+cc create menu script <projectPath> <scriptId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+cc create menu site <projectPath> <siteId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
 ```
 
 示例：
 
 ```bash
 cc create menu object . <objectId> "我的对象菜单"
+cc create menu page . contract-assistant "合同助手" contract_assistant_menu
+```
+
+说明：
+
+- `pageApi` 为自定义页面 API 名，命令内部会自动拼接为 `lightningPage`（`pageApi#lightning`）。
+- `create menu page` 的 `pageType` 固定为 `customPage`，`mobileurl` 默认空字符串。
+- `pname` 为菜单名称字段，必填。
+
+### 查询菜单（CLI）
+
+```bash
+cc get menu <projectPath> [encodedCondJson]
+```
+
+说明：
+
+- 接口若返回分组结构（如 `botlist/objectlist/objlist/pagelist/scriptlist`），CLI 会自动聚合为数组并输出。
+- 聚合结果每一项会附带 `__group` 字段，表示来源分组。
+
+### 删除菜单（CLI）
+
+```bash
+cc delete menu <projectPath> <tabId>
 ```
 
 ### 创建应用（CLI）
@@ -114,7 +197,18 @@ cc create menu object . <objectId> "我的对象菜单"
 cc create application <projectPath> <appName> <appCode> [menuIds]
 ```
 
+### 查询应用（CLI）
+
+```bash
+cc get application <projectPath> [encodedCondJson]
+```
+
+### 删除应用（CLI）
+
+```bash
+cc delete application <projectPath> <appId>
+```
+
 说明：
 
 - `menuIds`：可选，多个用逗号分隔；系统会确保默认菜单 `acf000001` 被包含。
-

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

@@ -4,6 +4,21 @@
 
 ---
 
+## 设计前阅读（先看模块文档）
+
+在做需求拆解与技术方案设计前，优先阅读 `docs` 目录中对应模块说明，先建立能力边界与适用场景认知，再进行选型与设计，避免组件误选。
+
+- 自定义类：`docs/自定义类.md`
+- 触发器：`docs/触发器类.md`
+- 定时类：`docs/cloudcc定时类.md`
+- 定时作业：`docs/cloudcc定时作业.md`
+- 自定义页面：`docs/自定义页面.md`
+- 自定义组件：`docs/CloudCC自定义组件使用说明.md`
+
+如需求涉及多个模块，按“后端能力 -> 页面能力 -> 组合方案”顺序阅读，再输出拆解结果与交付物清单。
+
+---
+
 ## 需求拆解模板（AI 必须输出）
 
 拿到需求后，先输出以下结构（缺信息则显式标注“待确认”）：

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

@@ -1,6 +1,6 @@
 ---
 name: cloudcc-cli-dev
-description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案选型，并通过 cloudcc-cli（cc 命令）创建/拉取/发布自定义对象、字段、菜单/应用、自定义类、定时器、触发器与 Vue 自定义组件等资产。用户提到 CloudCC、cloudcc-cli、cc 命令、对象/字段/触发器/定时器/自定义组件 时应优先使用。
+description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案选型，并通过 cloudcc-cli（cc 命令）创建/拉取/发布类、定时类、定时作业、触发器、自定义组件、自定义页面、自定义设置、客户端脚本与静态资源。用户提到 CloudCC、cloudcc-cli、cc 命令、类/定时类/定时作业/触发器/自定义组件/自定义页面/自定义设置/客户端脚本/静态资源 时应优先使用。
 ---
 
 # CloudCC CLI Development Skill
@@ -10,19 +10,39 @@ description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案
 
 ## 工作目录
 - 在openclaw环境中，需要在agent的workspace中创建code文件夹，然后在code文件中使用cc create project xxx，创建一个模版项目。
+- 每次启动这个技能，要扫描下code文件夹，查看创建的项目
 
 ## 使用方式（AI 必须遵循）
 
-- 先阅读 `REQUIREMENTS_BREAKDOWN.md`，输出需求拆解与交付物清单，再进入落地步骤。
+- 设计实现方案时，重点阅读 `REQUIREMENTS_BREAKDOWN.md`，输出需求拆解与交付物清单，发开时可以忽略
 - 需要环境/密钥 配置时，阅读 `INSTALL_AND_BOOTSTRAP.md`。
 - 需要建模时（对象/字段/菜单/应用），阅读 `OBJECTS_AND_FIELDS.md`。
-- 需要后端逻辑时（类/定时器/触发器），按主题阅读：
+- 需要开发后端逻辑时（类/定时器/触发器），按主题阅读：
   - `BACKEND_CLASS.md`
   - `BACKEND_SCHEDULE.md`
   - `BACKEND_TRIGGER.md`
-- 需要自定义组件时，阅读 `VUE_CUSTOM_COMPONENT.md`。
+- 需要开发自定义组件时，阅读 `VUE_CUSTOM_COMPONENT.md`。
+- 需要开发自定义页面时，阅读 `VUE_CUSTOM_PAGE.md`。
+- 需要开发自定义设置时，阅读 `CUSTOM-SETTING-API.md`。
+- 需要管理静态资源时，阅读 `STATIC-RESOURCE-API.md`。
+- 需要开发客户端脚本时，优先阅读 `CLI_CHEATSHEET.md` 中的 `script` 命令章节。
 - 需要快速对照命令与参数时，阅读 `CLI_CHEATSHEET.md`。
 
+## 密钥配置
+
+密钥应配置在每个项目的 `cloudcc-cli.config.js` 文件中，不要存储在技能目录中。
+
+示例配置：
+```javascript
+module.exports = {
+  "use": "junjiedemo",
+  "junjiedemo": {
+    "safetyMark": "xxx",
+    "CloudCCDev": "xxx"
+  }
+}
+```
+
 ## 强制安全边界
 
 - 不要在输出/代码/提交中包含真实密钥（`CloudCCDev`、`safetyMark`、`secretKey`、`openSecretKey`、token
@@ -37,8 +57,10 @@ description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案
 - 安装与初始化：`INSTALL_AND_BOOTSTRAP.md`
 - 需求拆解与方案选择：`REQUIREMENTS_BREAKDOWN.md`
 - 自定义对象与字段：`OBJECTS_AND_FIELDS.md`
-- 自定义类：`BACKEND_CLASS.md`
-- 定时类：`BACKEND_SCHEDULE.md`
-- 触发器：`BACKEND_TRIGGER.md`
+- 类/定时类/定时作业/触发器：`BACKEND_CLASS.md`、`BACKEND_SCHEDULE.md`、`BACKEND_TRIGGER.md`
 - Vue 自定义组件：`VUE_CUSTOM_COMPONENT.md`
+- 自定义页面：`VUE_CUSTOM_PAGE.md`
+- 自定义设置：`CUSTOM-SETTING-API.md`
+- 静态资源：`STATIC-RESOURCE-API.md`
+- 客户端脚本：`CLI_CHEATSHEET.md`（`script` 章节）
 - CLI 速查：`CLI_CHEATSHEET.md`

package/.cursor/skills/cloudcc-cli-dev/STATIC-RESOURCE-API.md

@@ -0,0 +1,60 @@
+# 静态资源（cc 命令模式）
+
+本文已从“直接 API 文档”重构为“`cc` 命令优先”。
+
+---
+
+## 覆盖范围
+
+通过 `cc` 管理静态资源：
+
+- 列表查询
+- 详情查询
+- 删除
+- 容量统计
+- 文档查看
+
+---
+
+## 命令速查
+
+```bash
+# 文档
+cc doc staticResource
+
+# 列表（condition 可选）
+cc get staticResource <projectPath> [encodedCondJson]
+
+# 详情
+cc detail staticResource <projectPath> <resourceId>
+
+# 删除
+cc delete staticResource <projectPath> <resourceId>
+
+# 容量统计
+cc count staticResource <projectPath> [encodedCondJson]
+```
+
+---
+
+## 参数说明
+
+- `projectPath`：项目根目录（包含 `cloudcc-cli.config.js`）。
+- `encodedCondJson`：`encodeURI(JSON.stringify({...}))` 形式条件参数。
+
+示例：
+
+```bash
+cc get staticResource . "$(node -e 'console.log(encodeURI(JSON.stringify({label:\"logo\"})))')"
+```
+
+```bash
+cc count staticResource .
+```
+
+---
+
+## 说明与边界
+
+- 当前未封装“文件上传/更新”命令（`saveStaticResource` 涉及 `FormData` 上传文件）。
+- 需要上传文件时，建议使用平台页面操作；后续可按需求补 `cc create staticResource`。

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` 字段
+
+---