cloudcc-cli 2.3.8 → 2.4.0

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

@@ -1,5 +1,5 @@
 ---
-name: cloudcc-cli-dev
+name: dev-guide
 description: >-
   Defines how cloudcc-cli extends the `cc` command: argv shape, `bin/cc.js` entry
   (global flags, doctor/docs/init, action-level `-h`), `bin/index.js` Proxy routing,
@@ -124,6 +124,10 @@ cloudcc <动作 action> <资源 resource> <其余参数 ...>
 3. 若有 `doc`，在 `src/<resource>/doc.js` 与 `docs/` 中维护说明；通过 `cloudcc doc <resource>` 可读。
 4. 更新 `src/version/listModuleCommands.js`：**`MODULE_KEYS_ORDER`**、**`MODULE_FOLDER`**，必要时 **`MODULE_HINT`**、**`RESOURCE_CN`**、**`describeActionLine`** 中的映射，保证 `cloudcc --help` 与 `cloudcc <action> -h` 正确。
 5. 自测：`node bin/cc.js <动作> <resource> …`、`cloudcc --help` / `cc --help`、`cloudcc <action> -h`；若 MCP 通过 `cliRunner` 调 **`cloudcc`**，确认参数顺序与文档一致。
+6. 若涉及 `fields` 模块的 `create` 参数扩展：保持“固定参数位置 + 空占位”约定，并同步更新实现、`src/fields/docs/devguide.md` 以及 MCP “Object Fields Creator” 参数透传。
+   - `cloudcc create fields`：`argvs[6]` 固定为 `remark`（写入 `obj.remark`）。
+   - 新增字段类型特殊参数时：按类型把参数按固定顺序追加到 `argvs` 后面（无值时调用方用空字符串占位），避免下标错位。
+   - 如有联动参数（如 `casesensitive` 依赖 `isrepeat=false`）：以实现为准，并在文档里明确“何时生效”。
 
 ---
 

package/README.md

@@ -71,9 +71,90 @@ Resolve the script path on macOS/Linux with:
 echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 ```
 
+# 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
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Fields
+  - Added unified `remark` input for `cloudcc create fields` (writes to `obj.remark`)
+  - Extended `S` field creation with `schemefieldLength`, `helps`, `isrepeat`, `casesensitive`, `placeholder`, and `defaultValue`
+  - Extended `U` (URL) field creation with optional `helps`, `edittype` (`_blank` / `_self`), and `defaultValue` (fixed argv positions after `remark`)
+  - Updated the MCP “Object Fields Creator” tool to pass the new `S` parameters, optional `U` parameters, and optional `remark`; expanded `create_object_field` input schema to include these fields
+  - Extended `P` (percent) field creation with optional `helps`, `defaultValue`, `schemefieldLength` (digits left of the decimal point), and `decimalPlaces` (digits right of the decimal point); defaults remain `10` / `2` when omitted; MCP `create_object_field` and schema pass `P` parameters and document `decimalPlaces` / per-type `schemefieldLength` semantics
+  - Enforced percent (`P`) precision rule: `schemefieldLength` + `decimalPlaces` must be non-negative integers and their sum must not exceed **18**
+  - Added `cloudcc update fields` (POST `/api/fieldSetup/saveField`) to update existing fields; requires field id on `obj`; refactored shared payload building into `src/fields/buildFieldData.js` with argv shift for create vs update
+  - `update fields` / `saveField`: when merging server field metadata from `queryField`, also copy `apiname` from `schemefieldName` or `apiname` so the save payload stays aligned with the platform field definition
+  - Added `cloudcc detail fields` (POST `/api/fieldSetup/editField`) to load field edit-page data (`fieldId`, `fdtype`, `objid`)
+  - Extended `C` (currency) field creation with optional `helps`, `defaultValue`, `schemefieldLength`, and `decimalPlaces` (same argv layout and **≤ 18** total-digit rule as `P`)
+  - Extended `N` (number) field creation with optional `schemefieldLength` (integer digits left of the decimal), `decimalPlaces` (fraction digits), `isrepeat` (allow duplicate values; default `true`), and `displayThousands` (platform flag: `"1"` disallows repeats, `"0"` allows repeats per current CloudCC mapping; argv slots `argvs[9..12]` on **create**); **≤ 18** total digits enforced like `P`/`C`; MCP passes the same parameters
+  - Simple field templates (`U`, `D`, `T`, `F`, `B`, `H`, `E`, `IMG`, `AD`) now set default `obj.schemefieldLength` where missing (e.g. **phone `H`=`15`**, **email `E`=`254`**, **URL `U`=`2000`**, **date/time `D`/`T`/`F`=`20`/`20`/`30`**, **checkbox `B`=`10`**, **image `IMG`=`255`**, **address `AD`=`500`**) so save payloads align with platform length fields
+  - `B` (checkbox): `defaultValue` is coerced to **`"0"`** (unchecked) or **`"1"`** (checked) only; any other value falls back to **`"0"`**
+  - `E` (email): optional `isrepeat` at `argvs[9]` (**`"true"`** allows duplicate values, **`"false"`** disallows; default **`"true"`**); MCP passes the same parameter
+  - `SCORE` (rating): optional `schemefieldLength` at `argvs[9]` as **max score** (number of star icons), integer **1–100**, default **`10`**; MCP passes the same parameter
+  - `X` (multiline text area): optional `schemefieldLength` at `argvs[9]` (**max characters 1–4000**, default **`4000`**) and optional `placeholder` at `argvs[10]`; MCP passes the same parameters
+  - `J` (long multiline text): same argv layout as `X` with **max characters 1–32000** (default **`32000`**); platform limits **10 `J` fields per object** (not enforced by CLI); MCP passes the same parameters
+  - `IMG` (image): `defaultValue` at `argvs[8]` is **max upload count** (integer **1–100**, default **`3`** when omitted); optional `formulaType` (`url` / `input`) at `argvs[9]` (default **`input`**); optional `watermarkstatus` (`"0"` / `"1"`) at `argvs[10]` (default **`"0"`**); MCP passes `formulaType` and `watermarkstatus`
+  - `FL` (file): **`obj.defaultValue`** and **`obj.isrepeat`** are both set to the **max file upload count** (integer **1–100**, default **`1`** when omitted); `buildFieldData` validates the count like **`IMG`**
+  - `L` (picklist): optional **`useGlobalSelect`** / **`edittype`** (**`radio`** or **`select`** on **`obj`**) / **`isPicklistSorted`** / **`defPl`** / **`globalSelectId`** at **`argvs[10..14]`** (create); **`ptext`** required when **`useGlobalSelect`** is **`"0"`**; **`globalSelectId`** required when **`useGlobalSelect`** is **`"1"`**; defaults **`useGlobalSelect`=`"0"`**, **`edittype`=`select`**, sorted/defPl **`"0"`**; MCP **`create_object_field`** adds the same **`L`**-only arguments after **`ptext`**
+  - `Q` (multi-select picklist): same argv layout as **`L`** through **`argvs[14]`**, plus **`visibleLines`** (**`obj.visibleLines`**, integer **1–100**, default **`4`**) and **`showalloptions`** (**`obj.showalloptions`**, **`"0"`**/**`"1"`**, default **`"0"`**) at **`argvs[15..16]`**; **`ptext`** / **`globalSelectId`** rules match **`L`**; MCP passes **`visibleLines`** and **`showalloptions`**
+  - `Y` (lookup): **`lookupObj`** at **`argvs[9]`**; optional **`lookupObjDefaultField`** (**`obj.lookupObjDefaultField`**, search/display helper when searching) at **`argvs[10]`**; **`MR`** / **`M`** unchanged (**`lookupObj`** only); MCP passes **`lookupObjDefaultField`** only for **`Y`**
+  - **`Y`** / **`MR`** / **`M`**: save payload **`obj`** no longer includes **`defaultValue`** (CLI **`argvs[8]`** unchanged for **`helps`** / **`defaultValue`** position; platform lookup/master-detail fields do not use **`obj.defaultValue`** in these templates)
+  - **`ENC`** / **`ENCD` (encrypted text)**: **`obj.schemefieldLength`** (**1–255**, **`argvs[9]`**); top-level **`masktype`** (**`all`** / **`4`** / **`card`** / **`custom`**, **`argvs[10]`**), **`encrypttype`** (when **`masktype`=`custom`**, **`argvs[11]`**), **`maskcharacter`** (**`*`**/**`X`**, **`argvs[12]`**); same argv layout for both types
+  - **`LT` (geolocation)**: **`obj.schemefieldLength`** / **`obj.decimalPlaces`** (integer + fractional digits, **≤ 18** total like **`P`**/**`C`**/**`N`**, default **`8`**/**`10`**, **`argvs[9]`**/**`argvs[10]`**); **`displayType`** (**`"1"`** numeric / **`"2"`** DMS, **`argvs[11]`**); MCP passes **`schemefieldLength`**, **`decimalPlaces`**, **`displayType`**
+  - Most field templates wire **`helps`** and, where applicable, **`defaultValue`** on **`obj`**; `buildFieldData` uses a unified argv layout (`helps` / `defaultValue` at fixed indices after `remark`, then type-specific args from the next slot—e.g. `ptext` / `lookupObj` at `argvs[9]` for `L`/`Q`/`Y`/`MR`/`M` on **create**); MCP **Object Fields Creator** follows the same order
+  - **Argv contract (create, after `remark`=`argvs[6]`)**: `helps`=`argvs[7]`, `defaultValue`=`argvs[8]`; type-specific extras start at `argvs[9]` (`S`: length / `isrepeat` / `placeholder` / `casesensitive`; `U`: `edittype`; `P`/`C`: integer digits / `decimalPlaces`; `N`: integer digits / `decimalPlaces` / `isrepeat` / `displayThousands`; `E`: `isrepeat`; `SCORE`: `schemefieldLength` (max score / stars, 1–100); `X`: `schemefieldLength` (max chars, 1–4000) / `placeholder`; `J`: `schemefieldLength` (max chars, 1–32000) / `placeholder`; `IMG`: `formulaType` / `watermarkstatus`; `L`: `ptext` then `useGlobalSelect` / `edittype` (`radio`/`select`) / `isPicklistSorted` / `defPl` / `globalSelectId` at `argvs[10..14]`; `Q`: same as `L` through `argvs[14]`, then `visibleLines` / `showalloptions` at `argvs[15..16]`; `Y`: `lookupObj` at `argvs[9]`, optional `lookupObjDefaultField` at `argvs[10]`; `MR`/`M`: `lookupObj` at `argvs[9]`; `ENC`/`ENCD`: `schemefieldLength` (1–255) at `argvs[9]`, `masktype` / `encrypttype` / `maskcharacter` at `argvs[10..12]`; `LT`: `schemefieldLength` / `decimalPlaces` at `argvs[9..10]`, `displayType` at `argvs[11]`). **`update fields`** shifts those indices by **+1** (`remark`=`argvs[7]`, so `helps`=`argvs[8]`, `defaultValue`=`argvs[9]`, extras from `argvs[10]`).
+  - **Implementation**: `src/fields/buildFieldData.js` parses `S`, `U`, `P`, `C`, `N`, `E`, `SCORE`, `X`, `J`, `IMG`, `L`, `Q`, `Y`, `MR`, `M`, `ENC`, `ENCD`, and `LT` using the above layout (single `readHelpsDefault` helper for `helps`/`defaultValue`); MCP `create_object_field` pushes arguments in the same order as the CLI.
+- Documentation
+  - Updated `src/fields/docs/devguide.md` and `introduction.md` (`S`/`remark`, `U`, `L`/`Q` with **CRLF** `\r\n` for picklists, `P`, `C`, universal `helps`/`defaultValue`, `detail` / `update`, API notes)
+  - **`devguide`**: “Field-specific parameters” section rewritten to match the unified argv rule; shell examples for `L`/`Q`/`Y`/`MR`/`M` now show `[helps] [defaultValue]` before `ptext` / `lookupObj`; `N` documents `schemefieldLength` / `decimalPlaces` / `isrepeat` / `displayThousands` at `argvs[9..12]` (create); `B` documents checkbox `defaultValue` **`"0"`**/**`"1"`** only; `E` documents `isrepeat` at `argvs[9]`; `SCORE` documents max score (stars) **`1`–`100`** at `argvs[9]`; `X` documents max chars **`1`–`4000`** and `placeholder` at `argvs[9]` / `argvs[10]`; `J` documents **`1`–`32000`**, **10 fields per object** (platform), same argv slots as `X`; `IMG` documents upload count **`1`–`100`** at `argvs[8]` (default **`3`**), `formulaType` / `watermarkstatus` at `argvs[9]` / `argvs[10]`.
+  - **`IMG` / `FL`**: JSDoc on `src/fields/fields/IMG.js` and `FL.js` documents `defaultValue` (max images / max files), plus `IMG` `formulaType` (`url` / `input`) and `watermarkstatus` (`"0"` / `"1"`); **`devguide.md`** adds a **`FL`** subsection and table row (`defaultValue` = max file count, default **`1`**) and lists `FL` separately from types that only share generic `helps` / `defaultValue`
+  - **`FL` (follow-up)**: **`devguide.md`** updated so **`FL`** upload count (**1–100**) is written to both **`obj.defaultValue`** and **`obj.isrepeat`**; **`buildFieldData`** adds **`validateFlUploadCount`**; **`mcp/index.js`** `create_object_field` **`defaultValue`** schema documents **`FL`** (saved **`isrepeat`** matches the count)
+  - **`L` (picklist)**: **`src/fields/fields/L.js`** and **`buildFieldData`** support **`useGlobalSelect`**, **`obj.edittype`** (**`radio`**/**`select`**), **`isPicklistSorted`**, **`defPl`**, **`globalSelectId`**; **`devguide.md`** and MCP **`create_object_field`** (schema + **Object Fields Creator** argv) document **`argvs[10..14]`** after **`ptext`**
+  - **`Q` (multi-select picklist)**: **`src/fields/fields/Q.js`** aligns with **`L`** for global/sort options and adds **`obj.visibleLines`** / **`obj.showalloptions`**; **`buildFieldData`** **`normalizeQVisibleLines`**; **`devguide`** / MCP document **`argvs[15..16]`**
+  - **`devguide` (`L`/`Q`)**: shell placeholder wording for optional **`ptext`**-after slots now starts at **`argvs[10]`** (matches **`useGlobalSelect`** first), not **`argvs[12]`**
+  - **`Y` (lookup)**: optional **`lookupObjDefaultField`** (**`obj.lookupObjDefaultField`**, search/display helper) at **`argvs[10]`** (create); MCP **`create_object_field`** passes **`lookupObjDefaultField`** after **`lookupObj`**
+  - **`Y` / `MR` / `M`**: **`src/fields/fields/Y.js`**, **`MR.js`**, **`M.js`** drop **`obj.defaultValue`** from the create/save payload (aligned with platform lookup / master-detail field definitions)
+  - **`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
 
-#### Release Date: 2026-4-1
+#### Release Date: 
 
 #### Release Scope: Full
 

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
@@ -158,8 +159,31 @@ mcpServer.registerTool(
             fieldType: z.enum(['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']).describe('字段类型：S(文本)，U(URL)，SCORE(评分)，IMG(图片)，P(百分比)，C(币种)，J(文本区-长，最长32000字符)，H(电话)，E(电子邮件)，B(复选框)，A(富文本)，D(日期)，F(日期/时间)，T(时间)，N(数字)，ENC(加密文本-存储加密)，ENCD(加密文本-显示加密)，X(文本区，最多4000字符)，L(选项列表-单选)，Q(选项列表-多选)，AD(地址)，LT(地理定位，用于录入经纬度)，FL(文件)，Y(查找关系)，MR(查找多选)，M(主详信息关系)'),
             nameLabel: z.string().min(1).describe('字段名称，必填字段'),
             projectPath: z.string().optional().describe('项目根路径，默认为当前工作目录'),
-            ptext: z.string().optional().describe('选项列表文本，多个选项用\\r\\n分隔，当字段类型为L(选项列表-单选)或Q(选项列表-多选)时必填'),
-            lookupObj: z.string().optional().describe('查找关系对象ID，当字段类型为Y(查找关系)、MR(查找多选)或M(主详信息关系)时必填'),
+            ptext: z.string().optional().describe('选项列表文本，多个选项用\\r\\n分隔；L/Q 在 useGlobalSelect=0 时必填，全局列表时可空，对应 CLI argvs[9]（create）'),
+            lookupObj: z.string().optional().describe('查找关系目标对象；Y/MR/M 必填，对应 CLI argvs[9]（create）'),
+            lookupObjDefaultField: z.string().optional().describe('Y(查找关系)：搜索辅助字段，写入 obj.lookupObjDefaultField；搜索时展示；对应 CLI argvs[10]（create），可空'),
+            remark: z.string().optional().describe('字段业务功能描述，写入 obj.remark；对应 CLI argvs[6]'),
+            schemefieldLength: z.string().optional().describe('S 长度 argvs[9]；P/C/N 整数位 argvs[9]；LT 小数点左侧位数 argvs[9] 默认8（与 decimalPlaces 之和≤18）；SCORE 1～100 默认10；X 1～4000 默认4000；J 长文本区 1～32000 默认32000；ENC/ENCD 1～255 默认255，argvs[9]（create）'),
+            helps: z.string().optional().describe('帮助文本，统一 argvs[7]（create）；update 为 argvs[8]'),
+            isrepeat: z.string().optional().describe('S argvs[10]；N argvs[11]；E(电子邮件) argvs[9]：true 允许重复，false 不允许，默认 true'),
+            casesensitive: z.string().optional().describe('S(文本) 区分大小写，argvs[12]，仅 isrepeat=false 时生效'),
+            placeholder: z.string().optional().describe('S 输入框提示 argvs[11]；X 文本区 argvs[10]；J 长文本区 argvs[10]'),
+            defaultValue: z.string().optional().describe('默认值，统一 argvs[8]（create）；update 为 argvs[9]；B(复选框) 仅 "0"/"1"（未选中/选中），其它按 "0"；IMG(图片) 为可上传图片数量 1～100，空则 3；FL(文件) 为可上传文件数量 1～100（保存时与 obj.isrepeat 同步为同一数值），空则 1'),
+            formulaType: z.string().optional().describe('IMG(图片)：录入方式 url 或 input，argvs[9]（create），空则 input'),
+            watermarkstatus: z.string().optional().describe('IMG(图片)：水印拍照 "0" 不支持 "1" 支持，argvs[10]（create），空则 0'),
+            edittype: z.string().optional().describe('U(URL)：_blank 或 _self，argvs[9]（create），空则 _blank。L/Q(选项列表)：radio 或 select，argvs[11]（create），空则 select'),
+            useGlobalSelect: z.string().optional().describe('L/Q(选项列表)：是否使用全局选项列表 "0" 否 "1" 是，argvs[10]（create），空则 0'),
+            isPicklistSorted: z.string().optional().describe('L/Q：按字母顺序排序 "0" 否 "1" 是，argvs[12]（create），空则 0'),
+            defPl: z.string().optional().describe('L/Q：将第一个值作为默认值 "0" 否 "1" 是，argvs[13]（create），空则 0'),
+            globalSelectId: z.string().optional().describe('L/Q：全局选项列表 id；useGlobalSelect=1 时必填，argvs[14]（create）'),
+            visibleLines: z.string().optional().describe('Q(多选)：下拉最多展示行数 1～100，写入 obj.visibleLines，argvs[15]（create），空则 4'),
+            showalloptions: z.string().optional().describe('Q(多选)：是否显示全部选项 "0" 否 "1" 是，写入 obj.showalloptions，argvs[16]（create），空则 0'),
+            masktype: z.string().optional().describe('ENC/ENCD：掩码类型 all | 4 | card | custom，argvs[10]（create），空则 all'),
+            encrypttype: z.string().optional().describe('ENC/ENCD：masktype=custom 时自定义规则，如 {AAAA}{****}{AAAA}；argvs[11]（create）；非 custom 可空'),
+            maskcharacter: z.string().optional().describe('ENC/ENCD：掩码字符 * 或 X，argvs[12]（create），空则 *'),
+            decimalPlaces: z.string().optional().describe('P/C 小数点右侧 argvs[10] 默认2；N 小数点右侧 argvs[10] 默认0；LT 小数点右侧 argvs[10] 默认10'),
+            displayType: z.string().optional().describe('LT(地理定位)：经纬度显示 "1" 数字 "2" 度分秒，顶层 displayType，argvs[11]（create），空则 1'),
+            displayThousands: z.string().optional().describe('N(数字) argvs[12]，默认0； "1"不允许重复，"0"允许重复（平台字段名 displayThousands）'),
         })
     },
     fieldCreatorHandler.createObjectField