cloudcc-cli 2.3.1 → 2.3.3

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

@@ -1,214 +0,0 @@
-## 覆盖范围
-
-本篇聚焦用 `cloudcc-cli` 的 `cc` 命令完成：
-
-- 创建自定义对象（Custom Object）
-- 删除自定义对象
-- 查询对象列表
-- 查询对象字段
-- 为对象创建字段（支持多字段类型）
-- 删除字段
-  -（可选）创建菜单、创建应用（把对象挂到导航中）
-
----
-
-## 自定义对象（Custom Object）
-
-### 你需要准备什么信息
-
-- **对象显示标签（label）**：例如“客户”“合同”“付款计划”
-- **项目路径（projectPath）**：模板项目根目录
-
-### CLI 命令（项目已有实现）
-
-```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` 查询。
-
----
-
-## 查询对象列表
-
-### CLI 命令（输出 JSON）
-
-```bash
-# 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 .
-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`）
-
----
-
-## 查询对象字段列表
-
-### CLI 命令（输出 JSON）
-
-```bash
-cc get fields <projectPath> <objprefix>
-```
-
-示例：
-
-```bash
-cc get fields . a01
-```
-
-用途：
-
-- 在创建字段前，先确认是否已存在同名/同含义字段，避免重复与冲突。
-
----
-
-## 创建字段（Field）
-
-### CLI 命令形态（项目已有实现）
-
-字段创建命令由工具根据字段类型拼装，典型形态：
-
-```bash
-cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
-```
-
-### 字段类型选择建议（常用）
-
-- **S**：文本（最常用）
-- **N**：数字
-- **D / F**：日期 / 日期时间
-- **B**：复选框
-- **L / Q**：选项列表（单选/多选）
-- **Y / MR / M**：关系字段（查找/查找多选/主详）
-- **E / H / U**：邮箱/电话/URL
-
----
-
-## 删除字段（Field）
-
-### CLI 命令（项目已有实现）
-
-```bash
-cc delete fields <projectPath> <fieldId> <objid>
-```
-
-示例：
-
-```bash
-cc delete fields . ffe2026F12B15D3sCX5R 202688F2CF34EE6vnMQ5
-```
-
-说明：
-
-- 删除接口为“彻底删除”，执行前请确认该字段未被公式字段、触发器、脚本、页面布局依赖。
-
----
-
-## 菜单与应用（让对象可访问）
-
-### 创建菜单（CLI）
-
-```bash
-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）
-
-```bash
-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

@@ -1,113 +0,0 @@
-## 目标
-
-把业务需求翻译成 CloudCC CRM 二开落地项，并选择“应该做什么组件”：自定义对象/字段/菜单/应用/自定义类/定时器/触发器/自定义组件/客户端脚本。
-
----
-
-## 设计前阅读（先看模块文档）
-
-在做需求拆解与技术方案设计前，优先阅读 `docs` 目录中对应模块说明，先建立能力边界与适用场景认知，再进行选型与设计，避免组件误选。
-
-- 自定义类：`docs/自定义类.md`
-- 触发器：`docs/触发器类.md`
-- 定时类：`docs/cloudcc定时类.md`
-- 定时作业：`docs/cloudcc定时作业.md`
-- 自定义页面：`docs/自定义页面.md`
-- 自定义组件：`docs/CloudCC自定义组件使用说明.md`
-
-如需求涉及多个模块，按“后端能力 -> 页面能力 -> 组合方案”顺序阅读，再输出拆解结果与交付物清单。
-
----
-
-## 需求拆解模板（AI 必须输出）
-
-拿到需求后，先输出以下结构（缺信息则显式标注“待确认”）：
-
-- **背景与目标**：要解决什么问题，成功标准是什么。
-- **角色与权限**：涉及哪些用户/简档/权限集，是否需要后台权限调整。
-- **对象与数据模型**：
-  - 需要哪些**自定义对象**（表）？
-  - 需要哪些**字段**（类型、必填/唯一、默认值、选项、查找/主详关系）？
-  - 是否涉及**记录类型**、**布局**、**验证规则**（若 CLI 不覆盖，需在 CRM 配置）？
-- **业务流程**：
-  - 触发时机：保存前/保存后/提交审批/批处理/定时等
-  - 需要哪些自动化：校验、自动赋值、联动更新、异步任务、定时任务
-- **界面与交互**：
-  - 是否需要自定义页面或嵌入式 UI？
-  - 是否需要列表/详情/编辑页的前端交互（客户端脚本 / 自定义组件）？
-- **集成与外部依赖**：第三方接口、鉴权方式、重试/限流、日志与审计。
-- **风险与回滚**：数据迁移、权限影响、性能与批量场景、灰度与回滚方案。
-- **交付物清单**：最终要产出哪些 CloudCC 资产（对象/字段/菜单/应用/类/触发器/定时器/组件/脚本）。
-
----
-
-## 方案选型决策表（怎么判断用什么）
-
-### 自定义对象（Custom Object）
-
-当出现以下需求时，优先考虑创建自定义对象：
-
-- 需要一个新的业务实体（类似新表），有独立的字段、权限、页面与列表
-- 需要与现有对象建立查找/主详关系
-- 需要支持审批、报表、共享规则等平台能力（通常都围绕对象展开）
-
-### 自定义字段（Field）
-
-当需求是“给已有对象补充数据结构”时：
-
-- 新增文本/数值/日期/选项/查找关系等字段
-- 需要字段级校验、默认值、必填等（部分能力可能需在 CRM 配置完成）
-
-### 触发器（Trigger）
-
-当需求是“数据写入前后做强一致业务逻辑”时：
-
-- 保存前校验/自动赋值/阻止不合法写入（before*）
-- 保存后联动更新、写日志、创建子记录（after*）
-- 批量/审批/提交后回调等特定时机（approval/batch/commitBatch 等）
-
-> 注意：触发器要考虑**批量**、幂等、递归、性能与异常处理。
-
-### 自定义类（Class）
-
-当需求是“可复用的服务逻辑/复杂计算/对外接口封装”时：
-
-- 作为触发器/定时器/页面调用的后端服务类
-- 抽取通用能力（查询封装、校验器、集成适配器）
-
-### 定时类（Scheduled Class / Timer）
-
-当需求是“按时间周期跑任务”时：
-
-- 夜间同步、定时报表、到期提醒、批量修复数据
-- 需要可控的调度表达式与运行日志
-
-### 自定义组件（Vue Custom Component）
-
-当需求是“在 CloudCC UI 中提供复杂交互 UI”时：
-
-- 自定义表单、复杂联动、可视化、批量操作 UI
-- 需要前端框架能力（Vue2.x）与更强的用户体验
-
-### 客户端脚本（Client Script）
-
-当需求是“页面级轻量交互/字段联动/保存前校验”时：
-
-- 列表/详情/编辑/新建页生命周期钩子
-- 字段变更联动、提示、轻量校验
-
-> 客户端脚本更轻量；交互复杂或需要组件化复用，建议升级为自定义组件。
-
----
-
-## 推荐落地流程（AI 执行顺序）
-
-一般建议按以下顺序落地（从“数据结构”到“业务逻辑”再到“界面”）：
-
-1. **对象与字段**：先把数据模型搭好（对象、字段、关系）
-2. **菜单与应用**：让用户能访问（菜单/应用）
-3. **后端逻辑**：自定义类 / 触发器 / 定时器
-4. **前端交互**：客户端脚本 / 自定义组件
-5. **联调与回归**：核心路径 + 批量场景 + 权限场景
-6. **发布与回滚准备**：版本记录、灰度、回滚策略
-

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

@@ -1,66 +0,0 @@
----
-name: cloudcc-cli-dev
-description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案选型，并通过 cloudcc-cli（cc 命令）创建/拉取/发布类、定时类、定时作业、触发器、自定义组件、自定义页面、自定义设置、客户端脚本与静态资源。用户提到 CloudCC、cloudcc-cli、cc 命令、类/定时类/定时作业/触发器/自定义组件/自定义页面/自定义设置/客户端脚本/静态资源 时应优先使用。
----
-
-# CloudCC CLI Development Skill
-
-## cloudcc-cli
-- 需要检查全局是否安装了cloudcc-cli npm包，如果没有请先安装。
-
-## 工作目录
-- 在openclaw环境中，需要在agent的workspace中创建code文件夹，然后在code文件中使用cc create project xxx，创建一个模版项目。
-- 每次启动这个技能，要扫描下code文件夹，查看创建的项目
-
-## 使用方式（AI 必须遵循）
-
-- 设计实现方案时，重点阅读 `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_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
-  等）。
-- 后端类/触发器/定时器遵守片段同步：仅在
-  `@SOURCE_CONTENT_START`~`@SOURCE_CONTENT_END` 内编写可发布逻辑。
-- 客户端脚本遵守片段同步：仅在 `function main($CCDK, obj) { ... }`
-  的函数体内编写可发布逻辑。
-
-## 快速入口
-
-- 安装与初始化：`INSTALL_AND_BOOTSTRAP.md`
-- 需求拆解与方案选择：`REQUIREMENTS_BREAKDOWN.md`
-- 自定义对象与字段：`OBJECTS_AND_FIELDS.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

@@ -1,60 +0,0 @@
-# 静态资源（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_COMPONENT.md

@@ -1,151 +0,0 @@
-## 覆盖范围
-
-本篇聚焦 CloudCC Vue2.x 自定义组件（Custom Component）：
-
-- 创建组件骨架
-- 编辑与最佳实践入口
-- 编译与发布到服务器
-
----
-
-## 创建自定义组件
-
-### CLI 命令
-
-```bash
-# 创建组件必须使用这个命令，在项目根目录执行（会生成到 plugins/<pluginName>/）
-cc create plugin <pluginName>
-```
-
-创建完成后通常会生成以下结构（以 `create1` 的骨架为准）：
-
-- `plugins/<pluginName>/<pluginName>.vue`：组件入口文件（包含
-  `componentInfo`，并默认引入一个 `HelloWorld` 子组件）
-- `plugins/<pluginName>/components/HelloWorld.vue`：示例子组件
-- `plugins/<pluginName>/config.json`：组件元数据（至少包含 `component` /
-  `compName` / `compDesc`）
-
-> 组件入口文件里的 `componentInfo.component`
-> 需要全局唯一（用于平台识别/装载组件）。
-
----
-
-## 发布组件
-
-```bash
-cc publish plugin <pluginName>
-```
-
-> 发布会执行编译/打包/上传；如果组件依赖复杂，注意依赖收集与发布策略。
-
-### 打包/注册策略（publish1：v1 / v2）
-
-`publish1` 支持两种打包/注册方式，会根据组件里的 `componentInfo.buildVersion`
-选择：
-
-- 默认（v1，`buildVersion` 不写或不等于 `"v2"`）
-  - 使用 `vue-custom-element` 将组件注册为 Web Component/custom element
-  - 注册名来自 `componentInfo.component`
-- v2（设置 `componentInfo.buildVersion = "v2"`）
-  - 使用 `Vue.component` 的方式注册组件
-
-示例（在组件入口 `.vue` 的 `data()` 里配置）：
-
-```js
-componentInfo: {
-  component: "component-<pluginName>",
-  compName: "compName-<pluginName>",
-  compDesc: "Component description information",
-  // 选填：不填默认 v1；填 "v2" 则走 Vue.component 注册
-  buildVersion: "v2"
-}
-```
-
-### 加载模式（loadModel：lazy / start）
-
-`publish1` 会读取 `componentInfo.loadModel` 来决定组件加载时机：
-
-- `lazy`：默认，进入对应页面/区域后再加载
-- `start`：启动加载，在应用启动时即加载
-
-你可以在 `componentInfo` 中按需设置，例如：
-
-```js
-componentInfo: {
-  // ...
-  loadModel: "start";
-}
-```
-
----
-## 同步（从云端拉取）
-
-> “同步”在本仓库中对应 `pull`：把云端的自定义组件代码/配置拉到本地 `plugins/<pluginName>/`。
-
-### CLI 命令
-
-```bash
-# 同步插件到本地（可传组件名或 id）
-cc pull plugin <pluginNameOrId> [projectPath]
-```
-
-说明：
-
-- `projectPath` 可选；不传则默认当前工作目录。
-- 传组件名时：如果本地 `plugins/<pluginName>/config.json` 存在 `id`，会用 `id` 拉取；否则会把入参当作 `id` 处理。
-- 拉取后会生成/更新 `plugins/<归一化后的pluginName>/config.json` 与相关文件（包含依赖文件）。
----
-
-## 删除组件（云端）
-
-> 删除只影响**云端**记录，本地 `plugins/<pluginName>/` 目录不会被删除。
-
-### CLI 命令
-
-```bash
-# 传组件名（自动从本地 plugins/<pluginName>/config.json 读取 id）
-cc delete plugin <pluginName> [projectPath]
-
-# 直接传云端 ID
-cc delete plugin <pluginId> [projectPath]
-```
-
-说明：
-
-- 传组件名时：如果本地 `plugins/<pluginName>/config.json` 存在 `id`，会用 `id`
-  删除；否则把入参当作 `id` 直接请求。
-- `projectPath` 可选，不传则默认当前工作目录。
-- 删除成功后控制台会打印 `Success! Plugin (ID: xxx) deleted from server.`
-
----
-## 批量拉取
-
-> 当前仓库没有直接提供 `cc pullList plugin ...` 这种“内置批量拉取”命令。
-
-推荐方式：先用 `get plugin` 获取线上列表（包含 `id`），再用循环批量执行 `pull plugin <id>`。
-
-### 步骤 1：获取线上列表
-
-```bash
-cc get plugin <projectPath>
-```
-
-### 步骤 2：循环拉取（示例）
-
-```bash
-# 批量拉取前 N 个线上组件（示例 N=5）
-N=5
-ids=$(cc get plugin . | node -e "const a=JSON.parse(require('fs').readFileSync(0,'utf8')); console.log(a.slice(0,${N}).map(x=>x.id).filter(Boolean).join(' '))")
-for id in $ids; do
-  cc pull plugin "$id" .
-done
-```
----
-
-## 编辑要点（CLI 项目约束）
-
-- 组件目录通常为 `plugins/<pluginName>/`
-- 确保所有 `<style>` 标签带 `scoped`，避免全局样式污染
-- 发布通过 `cc publish plugin <pluginName>` 执行编译与上传
-
----