cloudcc-cli 2.2.8 → 2.2.9

package/.cloudcc-cache.json

@@ -1,6 +1,6 @@
 {
   "version_check": {
-    "timestamp": 1773991959371
+    "timestamp": 1774424004502
   },
   "Je6yZ0TRyQFtpcH1gVKctqNhL": {
     "username": "admin@testuat.com",
@@ -34,5 +34,36 @@
     "secretKey": "d99313b4298544bc8ca1ee7459227b",
     "pluginToken": "unified2026624c45632",
     "timestamp": 1773991961909
+  },
+  "MA5XexqhSWW1jCeLpHcx4bXNh": {
+    "username": "gongjj@cloudcc.com",
+    "baseUrl": "https://yundong.lightning.cloudcc.cn/ccdomaingateway",
+    "orgId": "2010000000050855WyHh",
+    "clientId": "TsZ9nOhsriINhJFkxFr7i3Gja",
+    "openSecretKey": "41fb2c1f-84d2-41b5-bc46-0623041f96a0",
+    "CloudCCDev": "",
+    "safetyMark": "MA5XexqhSWW1jCeLpHcx4bXNh",
+    "apiSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/apisvc",
+    "setupSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/setup",
+    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiZ29uZ2pqQGNsb3VkY2MuY29tIiwiYmluZGluZyI6IjE5NzMxYjU0LWYwNmYtNDI4MS1hYWU3LWVjMWMzMzg3M2E1YSIsIkNsaWVudElkIjoiVHNaOW5PaHNyaUlOaEpGa3hGcjdpM0dqYSIsImV4cCI6MTc3NDUxMzI2Niwib3JnSWQiOiIyMDEwMDAwMDAwMDUwODU1V3lIaCJ9.pSAijHx9tUVQew9JINY6P2lD6kwvX-SRDYXxKQfVxbk",
+    "secretKey": "54db2d557fc04d11be2f9da34e2831",
+    "pluginToken": "unified2026461c3843d",
+    "timestamp": 1774340466848
+  },
+  "oFKfA8V9DXIcs1l2EIe6tGNOd": {
+    "username": "junsales@demo.com",
+    "baseUrl": "https://solution.lightning.cloudcc.cn/ccdomaingateway",
+    "setupSvc": "https://solution.lightning.cloudcc.cn/ccdomaingateway/setup",
+    "orgId": "orgb5bc93c891c40ceac",
+    "clientId": "halqHvw6tDXVCfWxeY9GOLxdp",
+    "version": "public",
+    "openSecretKey": "10634880-6b3c-4238-a4ef-83177b27ca33",
+    "safetyMark": "oFKfA8V9DXIcs1l2EIe6tGNOd",
+    "CloudCCDev": "",
+    "apiSvc": "https://solution.lightning.cloudcc.cn/ccdomaingateway/apisvc",
+    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoianVuc2FsZXNAZGVtby5jb20iLCJiaW5kaW5nIjoiMGNjZDM1YjktZjRkNS00MzAzLTljMWYtYjIwNmNkNTQ3OGQ3IiwiQ2xpZW50SWQiOiJoYWxxSHZ3NnREWFZDZld4ZVk5R09MeGRwIiwiZXhwIjoxNzc0NTk2ODEzLCJvcmdJZCI6Im9yZ2I1YmM5M2M4OTFjNDBjZWFjIn0.4Oep03fP-4Tlak5sowGAylp89aJq-XB_CfGlLRE7ONc",
+    "secretKey": "5c91aef5bc2740c49ab97831385036",
+    "pluginToken": "unified20264b53258f0",
+    "timestamp": 1774424014085
   }
 }

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

@@ -0,0 +1,97 @@
+## 自定义类（Class）
+
+## 覆盖范围
+
+本篇聚焦 CloudCC 后端 Java 自定义类（通过 `cc` 命令）：
+
+- 创建类骨架
+- 拉取线上源码片段
+- 发布本地源码片段
+- 列表、详情与按 ID 生成本地工程
+
+---
+
+## 目录结构（以本仓库约定为准）
+
+- `classes/{ClassName}/...`
+
+---
+
+## 生成文件说明
+
+当执行 `cc create classes <ClassName>` 后，通常会在项目根目录生成：
+
+- `classes/<ClassName>/<ClassName>.java`：主类文件
+- `classes/<ClassName>/<ClassName>Test.java`：测试桩文件（便于本地跑 main）
+- `classes/<ClassName>/config.json`：记录 `name`、`version`，以及首次 `publish` 成功后写入的 `id`
+
+`<ClassName>.java` 的 Java 包名为 `package classes.<ClassName>;`
+
+---
+
+## 源码同步边界（必须理解）
+
+该项目使用“片段同步”策略：
+
+- 自定义类只会拉取/发布 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的内容。
+
+这意味着：
+
+- 片段外可保留模板、import、类结构等。
+- 片段内仅放可发布逻辑，不放本地临时调试代码。
+
+---
+
+## 创建
+
+```bash
+# 在项目根目录执行
+cc create classes <ClassName>
+```
+
+## 拉取 / 发布
+
+```bash
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+### `pull` 前置条件
+
+- `pull` 会读取 `classes/<ClassName>/config.json` 里的 `id`
+- 如果本地 `config.json` 没有 `id`（通常表示从未 `publish` 过），会提示 “Class ID is not exist, please publish first”
+
+### `publish` 行为
+
+- `publish` 会从 `<ClassName>.java` 中提取 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的源码作为 `source` 上传
+- 首次发布成功后，会把云端返回的 `id` 写回本地 `config.json`
+
+---
+
+## 获取 / 详情 / 批量拉取
+
+```bash
+# 列出（可选：传入 encodeURI(JSON.stringify({...})) 查询体；不传则用默认分页参数）
+cc get classes <encodedJson>
+
+# 详情：优先本地读取；当没有本地信息或未发布时，再通过 id 查云端
+cc detail classes <ClassName> <ClassId>
+
+# 批量拉取：根据云端 id 生成本地 classes/<ClassName>/ 目录
+cc pullList classes <ClassId> <ProjectRoot>
+```
+
+说明：
+
+- `detail`/`pull` 等命令在本地优先；只要你本地 `classes/<ClassName>/config.json` 已包含 `id`，就可以按 id 查并拉取源码。
+
+---
+
+## 推荐工作流（AI 执行顺序）
+
+1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
+2. 创建类骨架（`create`）
+3. 拉取线上版本（`pull`）对齐基线（如是增量改造）
+4. 编写片段内业务逻辑（注意幂等、异常兜底）
+5. 发布（`publish`）
+6. 回归验证：单条调用、跨模块调用（触发器/定时类/组件等）与异常分支

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

@@ -0,0 +1,78 @@
+## 定时类（Scheduled Class / Timer）
+
+## 覆盖范围
+
+本篇聚焦 CloudCC 后端 Java 定时类（通过 `cc` 命令）：
+
+- 创建定时类骨架
+- 拉取线上源码片段
+- 发布本地源码片段
+- 列表、详情与按 ID 批量落地
+
+---
+
+## 目录结构（以本仓库约定为准）
+
+- `schedule/{ScheduleName}/...`
+
+---
+
+## 核心说明
+
+定时类在平台上对应“定时作业”类代码，本地由 `src/timer` 实现。CLI 上 `schedule` 与 `timer` 完全等价（同一模块），任选其一即可。
+
+### 目录与 Java 约定
+
+- 路径：`schedule/<ScheduleName>/`
+- 文件：
+  - `<ScheduleName>.java`：`package schedule.<ScheduleName>`，类 `extends CCSchedule`，业务逻辑写在无参构造函数中。
+  - `config.json`：至少包含 `name`、`version`；首次发布成功后会写入云端返回的 `id`，供后续拉取使用。
+
+### 片段同步
+
+- 推荐在构造函数体内使用 `// @SOURCE_CONTENT_START` 与 `// @SOURCE_CONTENT_END` 包裹可同步逻辑。
+- 发布：有标记时只上传标记之间源码；无标记时会把整文件作为 `source` 提交。
+- 拉取：有标记时只替换标记区间；无标记时用接口返回的 `tsource` 覆盖整个 `.java` 文件。
+
+---
+
+## 创建 / 发布 / 拉取
+
+```bash
+# 在项目根目录执行（schedule 可换成 timer）
+cc create schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+```
+
+**重要：`pull` 前置条件**
+
+- `config.json` 中必须已有 `id`（通常需先 `publish` 成功一次）。否则会出现 “Schedule ID is not exist, please publish first” 类提示。
+
+---
+
+## 列表 / 详情 / 按 ID 生成本地工程
+
+```bash
+# 列表（可选：传 encodeURI(JSON.stringify({...})) 查询体；不传用默认分页）
+cc get schedule
+
+# 详情：优先按本地 schedule/<name>/ 读取；仅查云端可传 id（name 置空）
+cc detail schedule <ScheduleName> <ScheduleId>
+
+# 按云端 id 拉取并在指定项目下生成 schedule/<name>/
+cc pullList schedule <ScheduleId> <ProjectRoot>
+```
+
+说明：`get` / `detail` / `pullList` 同样支持将子命令中的 `schedule` 写成 `timer`。
+
+---
+
+## 推荐工作流（AI 执行顺序）
+
+1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
+2. 创建定时类骨架（create）
+3. 拉取线上版本（pull）对齐基线（如是增量改造）
+4. 编写片段内业务逻辑（注意幂等、异常兜底）
+5. 发布（publish）
+6. 回归验证：单条、批量、跨天、异常分支

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

@@ -0,0 +1,137 @@
+## 触发器（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`
+
+---
+## 触发器编辑 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

@@ -0,0 +1,215 @@
+## CLI 入口速查（本仓库已定义）
+
+`package.json` 中定义的 bin：
+
+- `cc`：主入口（按模块分发 `create/get/pull/publish/detail/pullList/doc/use/approve/reject` 等）
+- `cloudccCreate`：创建模板项目（内部调用 `src/project/create.js`）
+- `cloudccBuild`：组件发布/构建相关（内部调用 `src/plugin/publish.js`）
+- `cc-mcp`：MCP 服务入口（运行在 IDE/MCP 客户端侧触发）
+
+---
+
+## 统一调用约定
+
+命令格式（主入口分发）：
+
+```bash
+cc <action> <type> [参数...]
+```
+
+常见 `action`：
+
+- `create`
+- `get`
+- `pull`
+- `publish`
+- `detail`
+- `pullList`
+- `doc`
+- `use`
+- `approve`
+- `reject`
+
+---
+
+## encodeURI JSON 参数提醒
+
+当某些命令需要传 JSON（例如触发器、定时类查询条件、自定义脚本等），建议用 `encodeURI(JSON.stringify(...))` 并用单引号/双引号把结果当作“单个参数”传入：
+
+```bash
+cc create triggers "$(node -e 'console.log(encodeURI(JSON.stringify({name:\"MyTrigger\",schemetableName:\"account\",targetObjectId:\"a01...\",triggerTime:\"beforeInsert\"})))')"
+```
+
+---
+
+## 常用 CLI 命令速查（按模块分组）
+
+### 项目与文档
+
+```bash
+# 创建模板项目
+cc create project <projectName>
+
+# 生成/输出文档（纯 CLI 文档）
+cc doc project overview
+cc doc project key-guide
+```
+
+### 配置、token、brief、recordType、版本
+
+```bash
+# 版本
+cc -v
+
+# 配置文件管理
+cc use config <env> [projectPath]
+cc get config [projectPath]
+
+# 从 CloudCC 获取 bus token（依赖你已配置的 dev 配置）
+cc get token <projectPath>
+
+# 获取页面/脚本相关的角色信息（brief）
+cc get brief <projectPath>
+
+# 拉取记录类型列表（需要 objprefix）
+cc get recordType <projectPath> <prefix>
+```
+
+### 自定义对象（object）与字段（fields）
+
+```bash
+# 创建自定义对象
+# nameLabel 可选；如果不传 nameLabel，会从 label 自动生成
+cc create object <projectPath> <label> [nameLabel]
+
+# 查询对象列表
+# type 可选：standard / custom / both（也支持 chat / trigger / fields 等内部类型）
+cc get object <projectPath> [type]
+
+# 查询对象字段（推荐直接用 fields 模块）
+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]
+```
+
+### 菜单（menu）与应用（application）
+
+```bash
+# 创建菜单（标签页）
+# type: object | page | script | site
+# path: 项目路径（用于读取 cloudcc-cli.config.js）
+cc create menu <type> <path> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+
+# 创建应用
+# menuIds 可选，多个用逗号分隔（内部会确保包含默认菜单 acf000001）
+cc create application <path> <appName> <appCode> [menuIds]
+
+# 获取应用（当前实现返回空列表）
+cc get application <path>
+```
+
+### 自定义组件（plugin / plugins）
+
+```bash
+# 创建到 plugins/<pluginName>/
+cc create plugin <pluginName>
+
+# 发布（编译并上传）
+cc publish plugin <pluginName>
+
+# 拉取（可传组件名或 ID）
+cc pull plugin <pluginNameOrId> [projectPath]
+
+# 列表
+cc get plugin <projectPath>
+
+# 详情
+# pluginName/pluginId（二选一即可；要传 id 时可以把 pluginName 置空 ""）
+cc detail plugin <pluginName> <pluginId> [projectPath]
+```
+
+### 后端自定义类（classes）
+
+```bash
+# 注意：当前 `src/classes/index.js` 仅接入 `doc`。
+# create/pull/publish/get/detail/pullList 这些命令在代码层面存在（src/classes/*.js），但未挂载到 CLI 类型分发里。
+cc doc classes
+
+# 如果后续你把 classes/index.js 挂载齐全，可按下面命令使用（实现已存在）：
+cc create classes <ClassName>
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+cc get classes <encodedCondJson> <projectPath>
+cc detail classes <ClassName> <ClassId>
+cc pullList classes <ClassId> <ProjectRoot>
+```
+
+### 后端定时类（schedule / timer）
+
+```bash
+# 创建（schedule 或 timer 二选一）
+cc create schedule <ScheduleName>
+cc create timer <ScheduleName>
+
+# 拉取/发布（本地目录 schedule/<ScheduleName>/）
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+
+cc pull timer <ScheduleName>
+cc publish timer <ScheduleName>
+
+# 列表（查询条件 JSON，需 encodeURI）
+cc get schedule <encodedCondJson> <projectPath>
+
+# 详情
+cc detail schedule <ScheduleName> <ScheduleId>
+
+# 批量拉取并生成本地 files：schedule/<name>/
+cc pullList schedule <ScheduleId> <ProjectRoot>
+```
+
+### 后端触发器（triggers）
+
+```bash
+# 创建：参数是 encodeURI(JSON)（必传：name/schemetableName/targetObjectId/triggerTime）
+cc create triggers <encodedJson>
+
+# 拉取/发布
+# namePath 形如：<schemetableNameLower>/<triggerName>
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+
+# 列表（查询条件 JSON，需 encodeURI）
+cc get triggers <encodedCondJson> <projectPath>
+
+# 详情（本地优先；也可只用 id）
+cc detail triggers <namePath> <triggerId>
+
+# 批量拉取并生成本地 triggers/<objectName>/<triggerName>/
+cc pullList triggers <triggerId> <ProjectRoot>
+```
+
+### 客户端脚本（script）
+
+```bash
+# 创建：参数是 encodeURI(JSON)（内部使用 body.objName/body.scriptName）
+cc create script <encodedJson>
+
+# 拉取/发布：scriptPath 形如 objName/scriptName
+cc pull script <objName/scriptName>
+cc publish script <objName/scriptName>
+
+# 列表（查询条件 JSON + 项目路径）
+cc get script <encodedCondJson> <projectPath>
+
+# 详情（本地优先；也可只用 id）
+cc detail script <objName/scriptName> <scriptId> <projectPath>
+
+# 批量拉取并生成目录：script/<objName>/<scriptName>/
+cc pullList script <scriptId> <ProjectRoot>
+
+# 文档
+cc doc script
+```

package/{cloudcc-cli-dev → .cursor/skills/cloudcc-cli-dev}/SKILL.md

@@ -16,7 +16,10 @@ description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案
 - 先阅读 `REQUIREMENTS_BREAKDOWN.md`，输出需求拆解与交付物清单，再进入落地步骤。
 - 需要环境/密钥 配置时，阅读 `INSTALL_AND_BOOTSTRAP.md`。
 - 需要建模时（对象/字段/菜单/应用），阅读 `OBJECTS_AND_FIELDS.md`。
-- 需要后端逻辑时（类/定时器/触发器），阅读 `BACKEND_CODE.md`。
+- 需要后端逻辑时（类/定时器/触发器），按主题阅读：
+  - `BACKEND_CLASS.md`
+  - `BACKEND_SCHEDULE.md`
+  - `BACKEND_TRIGGER.md`
 - 需要自定义组件时，阅读 `VUE_CUSTOM_COMPONENT.md`。
 - 需要快速对照命令与参数时，阅读 `CLI_CHEATSHEET.md`。
 
@@ -34,6 +37,8 @@ description: CloudCC CRM 二次开发 CLI 助手。用于需求拆解与方案
 - 安装与初始化：`INSTALL_AND_BOOTSTRAP.md`
 - 需求拆解与方案选择：`REQUIREMENTS_BREAKDOWN.md`
 - 自定义对象与字段：`OBJECTS_AND_FIELDS.md`
-- 自定义类/定时器/触发器：`BACKEND_CODE.md`
+- 自定义类：`BACKEND_CLASS.md`
+- 定时类：`BACKEND_SCHEDULE.md`
+- 触发器：`BACKEND_TRIGGER.md`
 - Vue 自定义组件：`VUE_CUSTOM_COMPONENT.md`
 - CLI 速查：`CLI_CHEATSHEET.md`