cloudcc-cli 2.3.1 → 2.3.3

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

@@ -1,150 +0,0 @@
-## 触发器（Trigger）
-
-## 覆盖范围
-
-本篇聚焦 CloudCC 后端 Java 触发器（通过 `cc` 命令）：
-
-- 按对象与时机创建触发器
-- 拉取线上源码片段
-- 发布本地源码片段
-
----
-
-## 目录结构（以本仓库约定为准）
-
-- `triggers/{objectName}/{triggerName}/...`
-
----
-
-## 源码同步边界（必须理解）
-
-该项目使用“片段同步”策略：
-
-- 触发器只会拉取/发布 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的内容。
-
-这意味着：
-
-- 片段外可保留模板、import、类结构等。
-- 片段内仅放可发布逻辑，不放本地临时调试代码。
-
----
-
-## 创建（关键入参）
-
-触发器 CLI 创建参数是一个 JSON 对象，需要 `encodeURI` 后作为单参数传入：
-
-```bash
-cc create triggers <encodedJson>
-```
-
-JSON 字段（示例）：
-
-- `name`: 触发器名（Java 命名规范）
-- `schemetableName`: 对象表名（如从对象列表拿到）
-- `targetObjectId`: 目标对象 ID
-- `triggerTime`: 触发时机（见下方枚举）
-
-可选枚举（以当前工具/handler 支持为准）：
-- `beforeInsert`
-- `beforeUpdate`
-- `beforeUpsert`
-- `beforeDelete`
-- `afterInsert`
-- `afterUpdate`
-- `afterUpsert`
-- `afterDelete`
-- `afterInsertCommit`
-- `afterUpdateCommit`
-- `afterUpsertCommit`
-- `afterDeleteCommit`
-- `approval`
-- `beforeBatch`
-- `afterBatch`
-- `commitBatch`
-
-示例（macOS/zsh）：
-
-```bash
-cc create triggers "$(node -e 'console.log(encodeURI(JSON.stringify({name:\"MyTrigger\",schemetableName:\"account\",targetObjectId:\"a01...\",triggerTime:\"beforeInsert\"})))')"
-```
-
----
-
-## 拉取 / 发布
-
-```bash
-# namePath 形如 objectName/triggerName（objectName 通常为小写目录）
-cc pull triggers <namePath>
-cc publish triggers <namePath>
-```
-
-> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
-
----
-
-## 生成文件说明
-当执行 `cc create triggers <encodedJson>` 后，通常会生成：
-- `triggers/<schemetableName_lower>/<triggerName>/<triggerName>.java`
-- `triggers/<schemetableName_lower>/<triggerName>/config.json`
-
-触发器 Java 包名为：`package triggers.<schemetableName_lower>.<triggerName>;`
-业务逻辑写在构造函数 `public <triggerName>()` 中，且可同步代码放进 `// @SOURCE_CONTENT_START` 与 `// @SOURCE_CONTENT_END` 之间。
-
----
-## 标记匹配与同步规则（务必）
-- `// @SOURCE_CONTENT_START` 与 `// @SOURCE_CONTENT_END` 必须各自独占一行（并且是注释行）
-- `publish`：有标记只上传标记之间内容；无标记则上传整个 `.java`（trim + `encodeURIComponent`）
-- `pull`：有标记只替换标记之间内容；无标记则用云端源码覆盖整个 `.java`
-
----
-## get / detail / pullList
-- `cc get triggers <encodedJson>`：返回 `[{ apiname, id, name }, ...]`
-- `cc detail triggers <objectName/triggerName> <triggerId>`：本地优先，不足时会按 `triggerId` 从服务器补齐
-- `cc pullList triggers <triggerId> <ProjectRoot>`：生成 `triggers/<schemetableName_lower>/<triggerName>/` 下的 `.java` 与 `config.json`
-
-典型查询体（示例）：
-```json
-{
-  "shownum": "2000",
-  "showpage": "1",
-  "fid": "<targetObjectId 或空串>",
-  "sname": "<triggerName 或空串>",
-  "rptcond": "",
-  "rptorder": ""
-}
-```
-
----
-## 查看完整编辑指南
-- `cc doc triggers`
-
----
-## 删除触发器
-
-```bash
-# 传 namePath（优先读取 triggers/<namePath>/config.json 中的 id）
-cc delete triggers <objectName/triggerName> [projectPath]
-
-# 或直接传 trigger id
-cc delete triggers <triggerId> [projectPath]
-```
-
-⚠️ **警告：删除操作不可逆，请谨慎使用。**
-
----
-## 触发器编辑 Checklist（最小必读）
-- 只在标记块内写可发布逻辑，不放临时调试代码
-- 保持幂等性，避免重复执行导致数据膨胀
-- 避免递归触发（触发器里再次更新同一对象时），优先使用批量/降递归 API 或短路条件
-- 查询字段尽量最小化，降低性能开销
-- 对关键分支加异常处理与必要日志，确保失败可定位
-
----
-## 推荐工作流（AI 执行顺序）
-
-1. 明确对象、触发时机与业务约束（幂等、递归更新风险）
-2. 创建触发器骨架（create）
-3. （可选）对齐线上基线：先 `publish` 一次生成 `id`，再 `pull`（或直接用 `pullList` 按 id 拉取）
-4. 编写片段内逻辑（批量处理优先）
-5. 发布（publish）（如第 3 步已发布，这里通常是二次 publish）
-6. 回归验证：插入/更新/删除/审批链路与异常分支

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

@@ -1,372 +0,0 @@
-## CLI 入口速查（本仓库已定义）
-
-`package.json` 中定义的 bin：
-
-- `cc`：主入口，统一使用 `cc <action> <type> ...`
-- `cloudccCreate`：项目模板创建入口（`bin/project.js`）
-- `cloudccBuild`：组件构建发布入口（`bin/plugin.js`）
-- `cc-mcp`：MCP 服务入口
-
----
-
-## 统一调用约定
-
-主入口格式：
-
-```bash
-cc <action> <type> [参数...]
-```
-
-常见 `action`：
-
-- `create`
-- `get`
-- `pull`
-- `publish`
-- `detail`
-- `pullList`
-- `delete`
-- `doc`
-- `count`
-- `use`
-- `approve`
-- `reject`
-
-> 注意：`-v/-version/--version/--v` 为特殊入口，不需要 `type`。
-
----
-
-## 命令覆盖矩阵（源码核对）
-
-以下为当前代码已接入的 `type -> action`：
-
-- `project`：`create`、`doc`
-- `config`：`use`、`get`
-- `token`：`get`
-- `brief`：`get`
-- `recordType`：`get`
-- `object`：`create`、`get`、`delete`
-- `fields`：`create`、`get`、`delete`
-- `menu`：`create`、`get`、`delete`
-- `application`：`create`、`get`、`delete`
-- `plugin`：`create`、`publish`、`get`、`detail`、`pull`、`delete`、`doc`
-- `customPage`：`create`、`get`、`delete`
-- `classes`：`create`、`publish`、`pull`、`get`、`detail`、`pullList`、`delete`、`doc`
-- `schedule`/`timer`（同一实现）：`create`、`publish`、`pull`、`get`、`detail`、`pullList`、`delete`
-- `scheduleJob`：`get`、`detail`、`delete`
-- `triggers`：`create`、`publish`、`pull`、`get`、`detail`、`pullList`、`delete`、`doc`
-- `script`：`create`、`publish`、`pull`、`get`、`detail`、`pullList`、`doc`
-- `approval`：`get`、`approve`、`reject`
-- `customSetting`：`create`、`get`、`detail`、`delete`、`doc`
-- `staticResource`：`get`、`detail`、`delete`、`count`、`doc`
-
----
-
-## encodeURI JSON 参数提醒
-
-触发器/定时类/脚本/审批等命令常要求 JSON 入参，建议统一：
-
-```bash
-ENCODED="$(node -e 'console.log(encodeURI(JSON.stringify({name:"MyTrigger",schemetableName:"account",targetObjectId:"a01...",triggerTime:"beforeInsert"})))')"
-cc create triggers "$ENCODED"
-```
-
----
-
-## 常用命令速查（按模块）
-
-### 版本与基础配置
-
-```bash
-# 版本
-cc -v
-cc --version
-
-# 切换/查看 cloudcc-cli.config.js 当前环境
-cc use config <env> [projectPath]
-cc get config [projectPath]
-
-# 获取 bus token
-cc get token <projectPath>
-
-# 获取简档信息（常用于对象/字段/应用等创建流程）
-cc get brief <projectPath>
-
-# 获取记录类型
-cc get recordType <projectPath> <prefix>
-```
-
-### 项目（project）
-
-```bash
-# 创建项目模板
-cc create project <projectName>
-
-# CLI 文档
-cc doc project
-```
-
-### 对象与字段
-
-```bash
-# 创建对象（nameLabel 可选，不传则按 label 自动生成）
-cc create object <projectPath> <label> [nameLabel]
-
-# 查询对象：type 可选
-# 常见值：standard / custom / chat / trigger / fields（不传表示全部）
-# 注意：type=fields 时还需要第 3 个参数（encodedObjectJson）
-cc get object <projectPath> [type]
-
-# type=fields 示例（第三参需包含 objprefix）
-cc get object <projectPath> fields <encodedObjectJson>
-
-# 删除对象
-cc delete object <projectPath> <objid>
-
-# 查询字段
-cc get fields <projectPath> <objprefix>
-
-# 创建字段
-# fieldType: S/U/SCORE/IMG/P/C/J/H/E/B/A/D/F/T/N/ENC/ENCD/X/L/Q/AD/LT/FL/Y/MR/M
-cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
-
-# 删除字段（彻底删除）
-cc delete fields <projectPath> <fieldId> <objid>
-```
-
-### 菜单与应用
-
-```bash
-# 创建菜单（object）
-cc create menu object <path> <objectId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
-
-# 创建菜单（page）
-# pageApi 会在内部自动拼接为 lightningPage（pageApi + "#lightning"）
-# 如已传入 xxx#lightning，也可兼容
-cc create menu page <path> <pageApi> <tabName> <pname> [tabStyle] [mobileimg] [cloudccservicetab] [mobileurl]
-
-# 创建菜单（script / site）
-cc create menu script <path> <scriptId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
-cc create menu site <path> <siteId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
-
-# 查询菜单（condJson 可选，需 encodeURI）
-cc get menu <path> [encodedCondJson]
-
-# 删除菜单
-cc delete menu <path> <tabId>
-
-# 创建应用（menuIds 可选，逗号分隔）
-cc create application <path> <appName> <appCode> [menuIds]
-
-# 获取应用列表（condJson 可选，需 encodeURI）
-cc get application <path> [encodedCondJson]
-
-# 删除应用
-cc delete application <path> <appId>
-```
-
-说明：
-
-- `create menu page` 中 `pageType` 固定为 `customPage`（内部写死）。
-- `create menu page` 中 `mobileurl` 默认 `""`。
-- `cc get menu` 会兼容接口分组返回（如 `botlist/objectlist/pagelist/...`），并汇总为数组输出；每项包含 `__group` 字段标记来源分组。
-
-### 组件（plugin）
-
-```bash
-# 创建本地组件模板
-cc create plugin <pluginName>
-
-# 发布组件
-cc publish plugin <pluginName>
-
-# 拉取组件（name 或 id）
-cc pull plugin <pluginNameOrId> [projectPath]
-
-# 获取列表
-cc get plugin <projectPath>
-
-# 详情（name 与 id 二选一；仅查 id 时可把 name 传空字符串）
-cc detail plugin <pluginName> <pluginId> [projectPath]
-
-# 删除云端组件（name 或 id）
-cc delete plugin <pluginNameOrId> [projectPath]
-
-# 组件文档
-cc doc plugin
-```
-
-### 自定义页面（customPage）
-
-```bash
-# 创建页面（pluginId 或 compLabel 均可）
-cc create customPage <pageLabel> <pageApi> <pluginId|compLabel> [projectPath]
-
-# 获取页面列表（pageNo/pageSize 可选）
-cc get customPage [pageNo] [pageSize] [projectPath]
-
-# 删除页面
-cc delete customPage <pageId> [projectPath]
-```
-
-### 后端类（classes）
-
-```bash
-cc create classes <ClassName>
-cc publish classes <ClassName>
-cc pull classes <ClassName>
-
-# 查询列表（condJson 需 encodeURI）
-cc get classes <encodedCondJson> <projectPath>
-
-# 详情（本地优先；也可仅传 id）
-cc detail classes <ClassName> <ClassId>
-
-# 批量拉取
-cc pullList classes <ClassId> <ProjectRoot>
-
-# 删除（传类名或类 id，类名时会优先读本地 config.json 的 id）
-cc delete classes <ClassNameOrId> [projectPath]
-
-# 文档
-cc doc classes
-```
-
-### 定时类（schedule / timer）
-
-```bash
-# schedule 与 timer 是同义 type
-cc create schedule <ScheduleName>
-cc publish schedule <ScheduleName>
-cc pull schedule <ScheduleName>
-
-cc create timer <ScheduleName>
-cc publish timer <ScheduleName>
-cc pull timer <ScheduleName>
-
-# 列表查询（condJson 需 encodeURI）
-cc get schedule <encodedCondJson> <projectPath>
-
-# 详情
-cc detail schedule <ScheduleName> <ScheduleId>
-
-# 批量拉取
-cc pullList schedule <ScheduleId> <ProjectRoot>
-
-# 删除定时类（传名称或 id）
-cc delete schedule <ScheduleNameOrId> [projectPath]
-```
-
-### 定时作业（scheduleJob）
-
-```bash
-# 列表（可选条件）
-cc get scheduleJob <projectPath> [encodedCondJson]
-
-# 详情
-cc detail scheduleJob <jobId> [projectPath]
-
-# 删除
-cc delete scheduleJob <jobId> [projectPath]
-```
-
-### 触发器（triggers）
-
-```bash
-# 创建（必含 name/schemetableName/targetObjectId/triggerTime）
-cc create triggers <encodedJson>
-
-# namePath: <schemetableNameLower>/<triggerName>
-cc publish triggers <namePath>
-cc pull triggers <namePath>
-
-# 列表查询（condJson 需 encodeURI）
-cc get triggers <encodedCondJson> <projectPath>
-
-# 详情（本地优先；也可仅查 id）
-cc detail triggers <namePath> <triggerId>
-
-# 批量拉取
-cc pullList triggers <triggerId> <ProjectRoot>
-
-# 删除（传 namePath 或 id）
-cc delete triggers <objectName/triggerName|triggerId> [projectPath]
-
-# 文档
-cc doc triggers
-```
-
-### 客户端脚本（script）
-
-```bash
-# 创建（JSON 需包含 objName/scriptName 等）
-cc create script <encodedJson>
-
-# scriptPath: <objName>/<scriptName>
-cc publish script <objName/scriptName>
-cc pull script <objName/scriptName>
-
-# 列表查询
-cc get script <encodedCondJson> <projectPath>
-
-# 详情
-cc detail script <objName/scriptName> <scriptId> [projectPath]
-
-# 批量拉取
-cc pullList script <scriptId> <ProjectRoot>
-
-# 文档
-cc doc script
-```
-
-### 审批（approval）
-
-```bash
-# 查询待审批列表（queryJson 可选，建议 encodeURI）
-cc get approval <projectPath> [encodedQueryJson]
-
-# 审批通过（approvalJson 建议 encodeURI）
-cc approve approval <projectPath> <encodedApprovalJson>
-
-# 审批拒绝（approvalJson 建议 encodeURI）
-cc reject approval <projectPath> <encodedApprovalJson>
-```
-
-### 文档型 type
-
-```bash
-cc doc customSetting
-cc doc staticResource
-```
-
-### 自定义设置（customSetting）
-
-```bash
-# 列表
-cc get customSetting <projectPath> [encodedCondJson]
-
-# 详情
-cc detail customSetting <projectPath> <settingId>
-
-# 创建/编辑（save，body 透传）
-cc create customSetting <projectPath> <encodedBodyJson>
-
-# 删除
-cc delete customSetting <projectPath> <settingId>
-```
-
-### 静态资源（staticResource）
-
-```bash
-# 列表
-cc get staticResource <projectPath> [encodedCondJson]
-
-# 详情
-cc detail staticResource <projectPath> <resourceId>
-
-# 删除
-cc delete staticResource <projectPath> <resourceId>
-
-# 容量统计
-cc count staticResource <projectPath> [encodedCondJson]
-```

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

@@ -1,62 +0,0 @@
-# 自定义设置（cc 命令模式）
-
-本文已从“直接调用 API”重构为“优先使用 `cc` 命令”。
-
----
-
-## 覆盖范围
-
-通过 `cc` 管理自定义设置主记录：
-
-- 列表查询
-- 详情查询
-- 新建/编辑（save 透传）
-- 删除
-- 文档查看
-
----
-
-## 命令速查
-
-```bash
-# 文档
-cc doc customSetting
-
-# 列表（condition 可选）
-cc get customSetting <projectPath> [encodedCondJson]
-
-# 详情
-cc detail customSetting <projectPath> <settingId>
-
-# 新建/编辑（请求体透传到 save）
-cc create customSetting <projectPath> <encodedBodyJson>
-
-# 删除主记录
-cc delete customSetting <projectPath> <settingId>
-```
-
----
-
-## 参数说明
-
-- `projectPath`：项目根目录（包含 `cloudcc-cli.config.js`）。
-- `encodedCondJson`：`encodeURI(JSON.stringify({...}))` 形式的查询体。
-- `encodedBodyJson`：`encodeURI(JSON.stringify({...}))` 形式的保存请求体。
-
-示例：
-
-```bash
-cc get customSetting . "$(node -e 'console.log(encodeURI(JSON.stringify({shownum:20,showpage:1})))')"
-```
-
-```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,62 +0,0 @@
-## 目标
-
-让开发者（或 AI）在一台新机器上，完成 `cloudcc-cli`
-的安装、模板项目创建、开发密钥配置，并能通过 `cc` 命令进行开发与发布。
-
----
-
-## 安装 cloudcc-cli
-
-### 全局安装
-
-```bash
-# Windows
-npm i -g cloudcc-cli
-
-# macOS（通常需要 sudo）
-sudo npm i -g cloudcc-cli
-```
-
-### 验证版本
-
-```bash
-cc -v
-```
-
-> 说明：`cc` 是该 CLI 的统一入口命令之一。
-
----
-
-## 创建 CloudCC 模板项目
-
-在你的工作目录下执行：
-
-```bash
-cc create project demo1
-cd demo1
-npm i
-npm run serve
-```
-
-如果能在本地启动并访问页面，说明前端开发链路可用。
-
----
-
-## 配置开发者密钥与安全标记
-
-### 在 CloudCC CRM 后台获取
-
-你需要一个具备“代码管理/开发者权限”的账号。
-
-- **开发者密钥（CloudCCDev）**：在 CRM
-  后台「连接的应用程序」中新建后获取并复制。
-- **安全标记（safetyMark）**：在个人设置中重置安全标记后，通过邮箱获取。
-
-### 写入项目的 `cloudcc-cli.config.js`
-
-模板项目根目录通常会有
-`cloudcc-cli.config.js`（或你们约定的同名配置文件），核心原则：
-
-- **多环境**：用 `use` 字段选择当前环境（如 `dev/uat/prod`）。
-- **不要提交真实密钥到 Git**：建议 `.gitignore`
-  忽略配置文件，或用本地私密文件方式管理。