cloudcc-cli 2.3.9 → 2.4.1

package/README.md

@@ -71,6 +71,46 @@ Resolve the script path on macOS/Linux with:
 echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 ```
 
+# ReleaseV2.4.1
+
+#### Release Date: 2026-4-9
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Docs alignment
+  - Refined `devguide` structure for `classes`, `timer`, and `triggers` to focus on implementation rules and avoid duplicated concept sections covered by `introduction`
+  - Added complete CLI command and argument sections in `classes` and `triggers` devguides, aligned with actual module handlers
+  - Expanded `timer` devguide command/argument coverage for all supported actions (`create`, `publish`, `pull`, `get`, `detail`, `pullList`, `delete`, `doc`)
+- Query parameter documentation
+  - Added trigger list query field documentation in trigger devguide, including `fid`/`objId` semantics
+  - Clarified script list query docs: `condition.objName` is the query field and its value should be object **label** (not API name)
+- MCP consistency
+  - Extended trigger list MCP schema and handler parameters (`objId`, paging, filter, sort) and aligned descriptions with CLI query body usage
+
+# ReleaseV2.4.0
+
+#### Release Date: 2026-4-8
+
+#### Release Scope: Full
+
+#### Release Content
+
+- JSP migration module
+  - Added a new `jsp` resource module with `cloudcc analyze jsp`, `cloudcc split jsp`, and `cloudcc doc jsp <introduction|devguide>`
+  - Added migration pipeline support for JSP analysis and split generation, including parameter parsing and migration report output
+  - Added `src/jsp/docs/introduction.md` and `src/jsp/docs/devguide.md` for CLI-first JSP migration guidance
+- CLI integration
+  - Registered `jsp` in `bin/index.js` and `src/version/listModuleCommands.js` so `cloudcc --help` and `cloudcc <action> -h` can discover JSP commands
+  - Improved CLI error handling in `bin/cc.js` by setting non-zero exit code and printing cleaner error messages
+- MCP and skill alignment
+  - Refactored `mcp/tools/JSP Migrator/handler.js` to align with the new JSP module workflow
+  - Updated `cloudcc-dev-skill` docs/config to include JSP migration commands and latest skill metadata
+- Documentation and tests
+  - Updated project devguide wording for current-directory project creation
+  - Added JSP CLI tests in `test/jsp.cli.test.js` for command contract coverage
+
 # ReleaseV2.3.9
 
 #### Release Date: 2026-4-3
@@ -121,6 +161,14 @@ echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
   - **`ENC` / `ENCD`**: **`ENC.js`** / **`ENCD.js`** + **`buildFieldData`** share **`schemefieldLength`** (≤255), **`masktype`**, **`encrypttype`**, **`maskcharacter`**; **`devguide`** / MCP document **`argvs[9..12]`**
   - **`LT` (geolocation)**: **`LT.js`** + **`buildFieldData`** **`validateCurrencyLikePrecision`** for **`obj`** length fields; **`displayType`**; **`devguide`** / MCP **`argvs[9..11]`**
   - Refreshed **`package.json` / npm** version to **2.3.12** (patch-line **2.3.9–2.3.12** changelog is consolidated in this **ReleaseV2.3.9** section); this README supplement documents **`C` + universal `helps`/`defaultValue`** without a new npm version bump
+  - **Classes**: Rewrote `src/classes/docs/devguide.md` as an AI-oriented custom-class spec (when to use classes, mandatory cloudcc-cli workflow, SOURCE-only business code, `UserInfo`/`CCService`, thin entry points, SDK usage, structure); expanded and aligned `src/classes/docs/introduction.md`
+  - **Timer**: Rewrote `src/timer/docs/devguide.md` as an AI-oriented scheduled-job (`CCSchedule`) spec (fit checks vs triggers/pages, cloudcc-cli `schedule/` workflow, idempotency/observability/batch/timezone, SDK alignment); expanded and aligned `src/timer/docs/introduction.md`
+  - **Timer (follow-up)**: Trimmed duplicate framing in `src/timer/docs/devguide.md` (removed redundant “sources” list wrapper and SDK appendix intro paragraphs; kept bullet lists and SDK reference content)
+  - **Triggers**: Rewrote `src/triggers/docs/devguide.md` as an AI-oriented trigger spec (fit checks vs schedulers/classes/pages, real project layout and CLI constraints, SDK usage, structure, recursion/perf pitfalls); expanded and aligned `src/triggers/docs/introduction.md`
+  - **Repo `cloudcc-cli.config.js`**: Default `use` is now `appstore-cn` (was `hls`); removed the `hls` environment block from the checked-in sample config
+- Object
+  - **`cloudcc create object`** requires a **business description** as the **last** positional argument. The **`obj.remark`** payload is the default label-based prefix sentence plus a space plus that description. Supported forms: ``cloudcc create object <path> <label> <businessDescription>`` (auto-generated `nameLabel`) and ``cloudcc create object <path> <label> <nameLabel> <businessDescription>``. Omitting the description prints a usage hint and fails fast with an error.
+  - MCP tool **`create_custom_object`**: **`businessDescription`** is **required** (schema `z.string().min(1)`); **`mcp/tools/Object Creator/handler.js`** passes it as the trailing CLI argument. **`src/object/docs/devguide.md`** updated for the new contract.
 
 # ReleaseV2.3.8
 

package/bin/cc.js

@@ -116,8 +116,9 @@ async function runWithArgvs(argv) {
   try {
     await cc[act](argv)
   } catch (e) {
+    process.exitCode = 1
     console.error()
-    console.error(chalk.yellow("请查看帮助：cloudcc --help"), e)
+    console.error(chalk.yellow("请查看帮助：cloudcc --help"), e && e.message ? e.message : e)
     console.error()
   }
 }

package/bin/index.js

@@ -11,6 +11,7 @@ const modules = {
   triggers: require("../src/triggers/index"),
   timer: require("../src/timer/index"),
   script: require("../src/script/index"),
+  jsp: require("../src/jsp/index"),
   token: require("../src/token/index"),
   object: require("../src/object/index"),
   recordType: require("../src/recordType/index"),

package/cloudcc-dev-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cloudcc-dev-skill
-description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `cloudcc doc <module> introduction|devguide` 获取官方模块文档，再给出方案与代码。用户提到 CloudCC、cloudcc-cli、模块文档、对象/字段、权限、触发器、类、组件、页面、脚本、静态资源、菜单、应用、单点登录、身份提供方、校验规则时应优先使用。
+description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `cloudcc doc <module> introduction|devguide` 获取官方模块文档，再给出方案与代码。用户提到 CloudCC、cloudcc-cli、模块文档、对象/字段、权限、触发器、类、组件、页面、脚本、JSP迁移、静态资源、菜单、应用、单点登录、身份提供方、校验规则时应优先使用。
 ---
 
 # CloudCC CRM 二开技能
@@ -14,16 +14,17 @@ description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `clou
 
 - 先确认 CLI 可用：优先检查 `cloudcc --version`。
 - 若未安装，执行：`npm i -g cloudcc-cli@latest`。
-- 只要涉及 CloudCC 设计或开发，先查文档再回答：优先 `introduction`，落地时看 `devguide`。
+- 当进行 CloudCC 方案设计时，必须读取所有模块的`introduction`文档后，再设计
+- 当进行 CloudCC 方案开发时，需要读取，对应模块的`devguide`信息后，再开发
 - 命令统一格式：`cloudcc doc <module> <introduction|devguide>`。
 - 特例：`config` 仅支持 `devguide`，不支持 `introduction`。
 
-## 模块指令清单（按仓库当前实现）
+## 模块指令清单
 
 ### 基础与环境
 
 - 项目：`cloudcc doc project introduction`、`cloudcc doc project devguide`
-- 配置：`cloudcc doc config devguide`（仅该子命令）
+- 配置：`cloudcc doc config devguide`
 
 ### 元数据与模型
 
@@ -51,11 +52,18 @@ description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `clou
 
 ### 前端扩展
 
-- 组件：`cloudcc doc plugin introduction`、`cloudcc doc plugin devguide`
+- 自定义Vue组件：`cloudcc doc plugin introduction`、`cloudcc doc plugin devguide`
+- 自定义Html组件：`./cloudcc-dev-html.md`
 - 自定义页面：`cloudcc doc customPage introduction`、`cloudcc doc customPage devguide`
 - 客户端脚本：`cloudcc doc script introduction`、`cloudcc doc script devguide`
 - 静态资源：`cloudcc doc staticResource introduction`、`cloudcc doc staticResource devguide`
 
+### 迁移与改造
+
+- JSP 迁移文档：`cloudcc doc jsp introduction`、`cloudcc doc jsp devguide`
+- JSP 分析：`cloudcc analyze jsp <encodeURI(JSON.stringify(params))>`
+- JSP 拆分生成：`cloudcc split jsp <encodeURI(JSON.stringify(params))>`
+
 ### 平台导航与系统能力
 
 - 菜单：`cloudcc doc menu introduction`、`cloudcc doc menu devguide`
@@ -66,13 +74,28 @@ description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `clou
 
 ## 使用流程（执行顺序）
 
-1. 方案阶段：先调用 `cloudcc doc <module> introduction`，确认能力边界与适用场景。
+1. 方案阶段：先调用
+   `cloudcc doc <module> introduction`，确认能力边界与适用场景。
 2. 实施阶段：再调用 `cloudcc doc <module> devguide`，按文档落地 CLI 命令与配置。
-3. 环境阶段：涉及项目初始化或鉴权问题时，优先查看 `project devguide` 与 `config devguide`。
+3. 环境阶段：涉及项目初始化或鉴权问题时，优先查看 `project devguide` 与
+   `config devguide`。
+4. 若是旧系统 JSP 改造，先看 `cloudcc doc jsp devguide` 中的“JSP 迁移规则”章节，再执行 `cloudcc analyze jsp` / `cloudcc split jsp`。
 
 ## 响应要求
 
 - 给方案或代码前，先明确引用了哪些 `cloudcc doc` 模块文档。
 - 若用户没有指定模块，先反问业务对象（如对象、权限、触发器、页面）或先给一个最小可行模块列表。
 - 输出命令时保持可直接复制执行，不混用过时命令格式。
-- **发布日志/Release Notes 规则（强制）**：凡是更新发布记录、版本日志、README 中 `Release`/`Release Notes` 区块，内容必须使用英文（标题、日期标签、条目描述均不得使用中文）。
+- 若用户在 IDE / MCP 场景中做 JSP 迁移，可使用 MCP 工具 `get_jsp_migration_rules`、`analyze_jsp_migration`、`split_jsp_to_cloudcc`，但其规则来源仍以 `cloudcc doc jsp devguide` 为准。
+- **发布日志/Release Notes 规则（强制）**：凡是更新发布记录、版本日志、README 中
+  `Release`/`Release Notes`
+  区块，内容必须使用英文（标题、日期标签、条目描述均不得使用中文）。
+
+## 快速规则
+
+- 先确认 CLI 可用：优先检查 `cloudcc --version`。
+- 若未安装，执行：`npm i -g cloudcc-cli@latest`。
+- 当进行 CloudCC 方案设计时，必须读取所有模块的`introduction`文档后，再设计
+- 当进行 CloudCC 方案开发时，需要读取，对应模块的`devguide`信息后，再开发
+- 命令统一格式：`cloudcc doc <module> <introduction|devguide>`。
+- 特例：`config` 仅支持 `devguide`，不支持 `introduction`。

package/cloudcc-dev-skill/cloudcc-dev-html.md

@@ -0,0 +1,42 @@
+---
+name: cloudcc-dev-html
+description: 指导在 CloudCC 相关仓库中编写单个 HTML 入口页：推荐 Tailwind（tailwindcss-browser）、Alpine.js、ECharts（BootCDN）、可使用 window.$CCDK。用户提到单页 HTML、html/index、BootCDN、Tailwind、Alpine、ECharts、CCDK、$CCDK 时使用。
+---
+
+# CloudCC 单 HTML 页面开发规范
+
+版本信息见同目录 [config.json](config.json)。
+
+## 1. 技能用途：创建单个 HTML 页面
+
+- 本技能用于在项目中编写**单个 HTML 入口文件**（通常为 **`html/index.html`**），在 CloudCC 内嵌或单独打开，与 `plugins/` 等业务源码区分存放。
+- 静态依赖（样式、脚本、字体等）**优先使用线上绝对地址**（`https://...`）引入；**公有云**推荐 [BootCDN](https://www.bootcdn.cn/) 等中国大陆可稳定访问的源；**私有云 / 内网**可将所需文件下载后上传到组织静态资源，再改为静态资源 URL。
+- 平台业务接口与模块说明以 **cloudcc-dev-skill**（`cloudcc doc <module>`）为准；本技能不替代平台开发指南。
+
+## 2. 页面推荐的样式与交互库
+
+以下为独立页**推荐**组合（通过 BootCDN 固定版本，升级时改 URL 中版本号；私有云按上一节改链）。
+
+**样式：Tailwind CSS（tailwindcss-browser，浏览器端编译）**
+
+```html
+<script src="https://cdn.bootcdn.net/ajax/libs/tailwindcss-browser/4.1.13/index.global.min.js"></script>
+```
+
+**交互：Alpine.js v3（CDN 构建，使用 `defer`，放在 `head`；与 Tailwind 同页时 Tailwind 在前、Alpine 在后）**
+
+```html
+<script defer src="https://cdn.bootcdn.net/ajax/libs/alpinejs/3.15.0/cdn.min.js"></script>
+```
+
+**图表：ECharts（按需引入；与 Tailwind、Alpine 同页时，建议放在二者之后，在初始化图表的脚本之前加载）**
+
+```html
+<script src="https://cdn.bootcdn.net/ajax/libs/echarts/6.0.0/echarts.min.js"></script>
+```
+
+## 3. 页面可使用 CCDK
+
+- 在 CloudCC 运行环境（自定义页面、内嵌 HTML 等）中，可通过 **`window.$CCDK`** 使用平台提供的 **CCDK** 能力；脚本应通过该入口调用，不依赖未文档化的其它全局名。
+- 在浏览器中直接打开本地文件时通常**没有** `$CCDK`，须做存在性判断或区分环境，避免报错。
+- CCDK 具体 API 以平台文档及 **cloudcc-dev-skill** 中相关说明为准。

package/cloudcc-dev-skill/config.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.0.0",
-  "releaseDate": "2026-04-01"
+  "version": "1.0.3",
+  "releaseDate": "2026-04-07"
 }

package/mcp/index.js

@@ -115,7 +115,8 @@ mcpServer.registerTool(
         description: '在 CloudCC CRM 系统中创建一个自定义对象（Custom Object），相当于数据库的表。',
         inputSchema: z.object({
             label: z.string().min(1).describe('对象的显示标签（例如: 客户）'),
-            projectPath: z.string().describe('项目根路径，默认为当前工作目录')
+            projectPath: z.string().describe('项目根路径，默认为当前工作目录'),
+            businessDescription: z.string().min(1).describe('对象业务功能描述（必填），拼接到默认 remark 文案之后')
         })
     },
     customObjectHandler.createCustomObject
@@ -393,10 +394,15 @@ mcpServer.registerTool(
 mcpServer.registerTool(
     'get_trigger_list',
     {
-        description: '获取 CloudCC CRM 服务器上的触发器列表，可选筛选条件',
+        description: '获取 CloudCC CRM 服务器上的触发器列表。支持按触发器名称、对象ID筛选，并支持分页/扩展过滤/排序参数。',
         inputSchema: z.object({
-            triggerName: z.string().optional().describe('可选，触发器名称（用于筛选）'),
-            targetObjectId: z.string().optional().describe('可选，目标对象ID（用于筛选）'),
+            triggerName: z.string().optional().describe('可选，触发器名称（映射到查询字段 sname）'),
+            targetObjectId: z.string().optional().describe('可选，目标对象ID（映射到查询字段 fid）'),
+            objId: z.string().optional().describe('可选，目标对象ID语义化别名（会映射到 fid）'),
+            shownum: z.union([z.string(), z.number()]).optional().describe('可选，每页条数（默认 2000）'),
+            showpage: z.union([z.string(), z.number()]).optional().describe('可选，页码（默认 1）'),
+            rptcond: z.string().optional().describe('可选，扩展过滤条件（默认空字符串）'),
+            rptorder: z.string().optional().describe('可选，排序条件（默认空字符串）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
         })
     },