cloudcc-cli 2.3.0 → 2.3.1

package/.cursor/skills/cloudcc-cli-dev/CUSTOM-SETTING-API.md

@@ -1,241 +1,62 @@
-# 自定义设置相关接口
+# 自定义设置（cc 命令模式）
 
-## 指导文档
-
-直接使用以下命令查看指导文档：
-
-```bash
-cc doc customSetting
-```
-
-
----
-
-## 查询自定义设置列表
-
-路径：`{服务名称}/api/customsetting/list`
-
-方法：POST
-
-接口描述：分页/查询自定义设置主列表，返回 `objList` 等。
-
-### 请求参数
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| （请求体） | object | 非必须 | {} | 当前前端传空对象 |
-
----
-
-## 新建/更新自定义设置（保存主对象）
-
-路径：`{服务名称}/api/customsetting/save`
-
-方法：POST
-
-接口描述：新建或编辑自定义设置主记录（标签、对象 API 名、类型、可见性、描述等）。
-
-### 请求参数
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| tpSysObjectVO | object | 必须 | — | 主对象载体，见下表子字段 |
-
-**tpSysObjectVO 子字段：**
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| accessable | string | 视业务 | — | 可见性（如 `"2"` 表示公用等，与表单选项一致） |
-| dataType | string | 视业务 | — | 设置类型：`L` 列表，`H` 层次结构 |
-| id | string | 视业务 | `""` | 新建传空字符串；编辑传记录 id |
-| label | string | 视业务 | — | 标签 |
-| remark | string | 非必须 | — | 描述 |
-| schemetableName | string | 视业务 | — | 对象名（编辑时前端通常禁用修改） |
-
----
-
-## 编辑前回显（自定义设置主对象）
-
-路径：`{服务名称}/api/customsetting/modify`
-
-方法：POST
-
-接口描述：根据主记录 id 拉取表单回显数据。
-
-### 请求参数
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| objid | string | 必须 | — | 记录id |
+本文已从“直接调用 API”重构为“优先使用 `cc` 命令”。
 
 ---
 
-## 删除自定义设置主对象
-
-路径：`{服务名称}/api/customsetting/deleteobj`
+## 覆盖范围
 
-方法：POST
+通过 `cc` 管理自定义设置主记录：
 
-接口描述：删除一条自定义设置主记录。
-
-### 请求参数
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| objid | string | 必须 | — | 记录id |
+- 列表查询
+- 详情查询
+- 新建/编辑（save 透传）
+- 删除
+- 文档查看
 
 ---
 
-## 查询自定义设置详情（含字段列表）
-
-路径：`{服务名称}/api/customsetting/detail`
-
-方法：POST
+## 命令速查
 
-接口描述：详情页使用，返回主对象信息及 `cusFields` 字段列表。
-
-### 请求参数
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| objid | string | 必须 | — | 记录id |
-
----
-
-## 进入字段编辑（取字段编辑所需数据）
-
-路径：`{服务名称}/api/customsetting/editfile`
+```bash
+# 文档
+cc doc customSetting
 
-方法：POST
+# 列表（condition 可选）
+cc get customSetting <projectPath> [encodedCondJson]
 
-接口描述：点击某字段「编辑」时调用，用于打开字段编辑器。
+# 详情
+cc detail customSetting <projectPath> <settingId>
 
-### 请求参数
+# 新建/编辑（请求体透传到 save）
+cc create customSetting <projectPath> <encodedBodyJson>
 
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| queryrecordid | string | 必须 | — | 字段行 id |
+# 删除主记录
+cc delete customSetting <projectPath> <settingId>
+```
 
 ---
 
-## 删除自定义字段
-
-路径：`{服务名称}/api/customsetting/deletefield`
-
-方法：POST
-
-接口描述：在详情页删除某条自定义字段。
-
-### 请求参数
-
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| id | string | 必须 | — | 字段行 id |
-| objid | string | 必须 | — | 所属自定义设置 id |
+## 参数说明
 
----
+- `projectPath`：项目根目录（包含 `cloudcc-cli.config.js`）。
+- `encodedCondJson`：`encodeURI(JSON.stringify({...}))` 形式的查询体。
+- `encodedBodyJson`：`encodeURI(JSON.stringify({...}))` 形式的保存请求体。
 
+示例：
 
-## 自定义字段类型静态配置
-> 前端静态配置，非后端接口返回）
-```json
-[
-  {
-    "id": "0001",
-    "name": "URL",
-    "type": "U",
-    "address": "允许用户输入任何有效的网址。如果用户单击该字段，将根据用户选择的模式在浏览器的新窗口或当前窗口中打开该 URL。系统默认在浏览器的新窗口中打开该URL。"
-  },
-  {
-    "id": "0002",
-    "name": "百分比",
-    "type": "P",
-    "address": "允许用户输入百分比数字（例如，10），并自动向数字添加百分号。"
-  },
-  {
-    "id": "0003",
-    "name": "币种",
-    "type": "c",
-    "address": "币种"
-  },
-  {
-    "id": "0004",
-    "name": "电话",
-    "type": "H",
-    "address": "允许用户输入任何电话号码。自动将其转换为电话号码格式。"
-  },
-  {
-    "id": "0005",
-    "name": "电子邮件",
-    "type": "E",
-    "address": "允许用户输入电子邮件地址，对其进行验证以确保格式正确。如果对于一个联系人和潜在客户指定了此字段，则用户单击“发送电子邮件”时可以选择地址。注意，自定义电子邮件地址无法用于批量电子邮件。"
-  },
-  {
-    "id": "0006",
-    "name": "复选框",
-    "type": "B",
-    "address": "允许用户选择“真”（选取）或“假”（不选取）值。"
-  },
-  {
-    "id": "0007",
-    "name": "日期",
-    "type": "D",
-    "address": "允许用户输入日期或从弹出式日历中选择日期。"
-  },
-  {
-    "id": "0008",
-    "name": "日期和时间",
-    "type": "F",
-    "address": "允许用户输入日期和时间，或从弹出式日历中选择日期。当用户单击弹出式日历中的某个日期后，该日期和当前时间将输入到日期/时间字段。"
-  },
-  {
-    "id": "0009",
-    "name": "数字",
-    "type": "N",
-    "address": "允许用户输入任何数字。将删除前置零。"
-  },
-  {
-    "id": "0010",
-    "name": "文本",
-    "type": "S",
-    "address": "允许用户输入任何字母和数字组合。"
-  },
-  {
-    "id": "0011",
-    "name": "长文本",
-    "type": "X",
-    "address": "允许用户输入多行文本，最多可输入 4000 个字符。"
-  }
-]
+```bash
+cc get customSetting . "$(node -e 'console.log(encodeURI(JSON.stringify({shownum:20,showpage:1})))')"
 ```
 
-## 保存字段（新增/编辑字段）
-路径：`{服务名称}/api/customsetting/saveField`
-方法：POST
-接口描述：在自定义设置详情页中保存字段定义（字段新建或编辑）。
-### 请求参数
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| tpSysSchemetableVO | object | 必须 | — | 字段对象，见下方子字段表 |
-| fdtype | string | 必须 | — | 字段类型代码（如 `U` 表示 URL） |
-**tpSysSchemetableVO 子字段：**
-| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
-| :--- | :--- | :--- | :--- | :--- |
-| schemetableId | string | 必须 | — | 所属自定义设置（对象）id |
-| id | string | 非必须 | — | 字段 id；编辑时传，新增可不传或传空 |
-| nameLabel | string | 必须 | — | 字段显示名称（标签） |
-| apiname | string | 必须 | — | 字段 API 名 |
-| edittype | string | 非必须 | — | 字段编辑类型（例如 URL 打开方式 `_blank`） |
-| schemefieldLength | string | 非必须 | — | 字段长度 |
-| defaultValue | string | 非必须 | — | 默认值 |
-| datafieldRef | string | 非必须 | — | 数据字段引用名 |
-| isDeleted | string | 非必须 | `"0"` | 删除标记 |
-| fieldState | string | 非必须 | `"enable"` | 字段状态 |
-| iscustom | string | 非必须 | `"1"` | 是否自定义字段 |
-| schemefieldType | string | 必须 | — | 字段类型代码（例如 `U`） |
-| schemefieldName | string | 必须 | — | 字段物理名/存储名 |
-
-
+```bash
+cc create customSetting . "$(node -e 'console.log(encodeURI(JSON.stringify({label:\"DemoSetting\",schemetableName:\"demo_setting\",setType:\"list\",shareType:\"public\",description:\"demo\"})))')"
+```
 
+---
 
+## 说明与边界
 
+- `create customSetting` 是“透传模式”：请求体字段需符合平台 `save` 接口契约。
+- 字段级管理（如 `saveField`、`deletefield`）当前未单独封装命令；建议在平台页面完成，或后续再补 `cc` 子命令。
+- 生产环境执行删除前，先做依赖检查与备份。

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

@@ -1,6 +1,7 @@
 ## 目标
 
-让开发者（或 AI）在一台新机器上，完成 `cloudcc-cli` 的安装、模板项目创建、开发密钥配置，并能通过 `cc` 命令进行开发与发布。
+让开发者（或 AI）在一台新机器上，完成 `cloudcc-cli`
+的安装、模板项目创建、开发密钥配置，并能通过 `cc` 命令进行开发与发布。
 
 ---
 
@@ -22,7 +23,7 @@ sudo npm i -g cloudcc-cli
 cc -v
 ```
 
-> 说明：`cc` 是该 CLI 的统一入口命令之一（见本仓库 `package.json` 的 bin 配置）。
+> 说明：`cc` 是该 CLI 的统一入口命令之一。
 
 ---
 
@@ -47,13 +48,15 @@ npm run serve
 
 你需要一个具备“代码管理/开发者权限”的账号。
 
-- **开发者密钥（CloudCCDev）**：在 CRM 后台「连接的应用程序」中新建后获取并复制。
+- **开发者密钥（CloudCCDev）**：在 CRM
+  后台「连接的应用程序」中新建后获取并复制。
 - **安全标记（safetyMark）**：在个人设置中重置安全标记后，通过邮箱获取。
 
 ### 写入项目的 `cloudcc-cli.config.js`
 
-模板项目根目录通常会有 `cloudcc-cli.config.js`（或你们约定的同名配置文件），核心原则：
+模板项目根目录通常会有
+`cloudcc-cli.config.js`（或你们约定的同名配置文件），核心原则：
 
 - **多环境**：用 `use` 字段选择当前环境（如 `dev/uat/prod`）。
-- **不要提交真实密钥到 Git**：建议 `.gitignore` 忽略配置文件，或用本地私密文件方式管理。
-
+- **不要提交真实密钥到 Git**：建议 `.gitignore`
+  忽略配置文件，或用本地私密文件方式管理。

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`。