# Usage Guide ## Global installation ```bash # Windows npm i -g cloudcc-cli # macOS sudo npm i -g cloudcc-cli ``` Verify the install (recommended on macOS/Linux — use **`cloudcc`** so it is not confused with the system C compiler **`cc`**): ```bash cloudcc get version # or (same binary, alternate name) cc get version ``` ## CLI overview The CLI ships two global command names for the same entry (`bin/cc.js`): **`cc`** and **`cloudcc`**. On macOS/Linux, **`cloudcc`** is recommended so it does not collide with the system C compiler (`/usr/bin/cc` is often clang/gcc). **`cc`** remains for backward compatibility. Both names use the same router: **`cloudcc [args...]`** (see `bin/index.js`). **Global / maintenance** commands use **`resource` = `version`** (e.g. **`cloudcc help version`**, **`cloudcc stats version`**); **business** commands use the resource module key (`object`, `project`, …). Run **`cloudcc help version`** (or **`cc help version`**) for the full command list: modules follow `bin/index.js` `modules` keys, with short module hints and per-line descriptions maintained in `src/version/listModuleCommands.js`. When you add a resource, update **`MODULE_KEYS_ORDER`** and **`MODULE_FOLDER`** (and optional **`MODULE_HINT`** / **`RESOURCE_CN`** / **`describeActionLine`**) so help and **`cloudcc actionHelp version `** stay accurate. **Implementation note:** maintenance handlers live in **`src/version/index.js`** (`cc.*`) and are reached as **`cloudcc version`** so the router always receives a valid **`resource`** segment. ## Version output and changelog - **`cloudcc get version`**: prints the installed version string only (no embedded release notes). - **Registry version check** (`utils/checkVersion.js`, e.g. during **`cloudcc update version`** or **`checkUpdate`** on pull/create flows): after comparing to npm, **only if a newer package exists** does the CLI print the relevant **`# ReleaseV…`** sections from **`README.md`** for versions **strictly after** the current install through **latest** (`utils/readmeReleases.js` → **`getReleasesBetween`**). If you are already up to date, no release block is printed (the panel still links to npm changelog). Rendering uses **`utils/formatReleaseNotes.js`**: terminal-width wrapping, aligned continuation lines, and safe inline `` `code` `` handling. ## Cursor Agent Skill (optional) After **`npm i -g cloudcc-cli`**, you can install the bundled **`cloudcc-dev-skill`** into Cursor’s skills folder so agents can follow CloudCC module guidance (`cloudcc doc …`) consistently. **Prerequisites:** the global **`cloudcc`** / **`cc`** command works (npm global bin on **`PATH`**). **User-wide install** (all workspaces), copies to **`~/.cursor/skills/cloudcc-dev-skill`**: ```bash cloudcc install skill ``` **Project-local install** (run from the repo root you opened in Cursor), copies to **`.cursor/skills/cloudcc-dev-skill`**: ```bash cloudcc install skill project # or cloudcc install skill --project ``` Restart Cursor or reload the window if the skill does not show up. For full environment setup (project folder, **`cloudcc-cli.config.json`**, optional template), see **`cloudcc doc project devguide`**. # ReleaseV2.5.4 #### Release Date: 2026-6-16 #### Release Scope: Full #### Release Content - Project template build warning cleanup - Disabled webpack performance hints in the generated `vue.config.js` so large UMD component bundles no longer print asset/entrypoint size warnings during packaging. - Added a template test to keep the Vue CLI webpack configuration covered. - English defaults for generated resources - Updated `create` scaffolds for classes, triggers, timers, plugins, HTML, custom pages, object remarks, menu script fields, site menu validation, JSP migration output, and project templates so generated resource content uses English placeholder text. - Updated code templates and examples in module `docs/devguide.md` and `docs/introduction.md` files so fenced code blocks no longer contain Chinese template text. # ReleaseV2.5.3 #### Release Date: 2026-6-2 #### Release Scope: Full #### Release Content - CCService lightweight update compatibility - Added the `updateLt(CCObject)` public stub to the bundled Java SDK so CloudCC class code can compile when using the lightweight update API. - Updated the `ccopenapi` jar version to `0.1.3` and synchronized the project template jar fallback. # ReleaseV2.5.2 #### Release Date: 2026-4-22 #### Release Scope: Full #### Release Content - Default config file migration to JSON format - Removed legacy `cloudcc-cli.config.js` from package sources. - Added `cloudcc-cli.config.json` as the packaged config entry in `.npmignore`. # ReleaseV2.5.1 #### Release Date: 2026-4-22 #### Release Scope: Full #### Release Content - Project template scaffold copy hardening - Updated `template/index.js` to stop copying removed `AGENTS.md` and avoid assertion crashes during `cloudcc create project`. - Added fallback copy logic for `CLAUDE` metadata so scaffolding uses `template/.claude/CLAUDE.md` when `template/CLAUDE.md` is absent. # ReleaseV2.5.0 #### Release Date: 2026-4-21 #### Release Scope: Full #### Release Content - Node 14 compatibility fix for template lib copy - Replaced `fs.cpSync` with `fs-extra.copySync` in `utils/checkVersion.js` when initializing the project `lib` folder from template. - Keeps the same copy behavior while avoiding runtime failure on Node 14 (`fs.cpSync is not a function`). # ReleaseV2.4.9 #### Release Date: 2026-4-20 #### Release Scope: Full #### Release Content - ccopenapi jar sync fallback enhancement - Updated `checkAndReplaceJar` in `utils/checkVersion.js` to copy the full template `lib` folder when the project `lib` folder is missing. - Added fallback to copy the template `ccopenapi-*.jar` when the project `lib` exists but has no `ccopenapi` jar. - Kept semantic version comparison and replacement behavior when both template and project jars are present. - HTML component CLI (`html` resource) - Added `cloudcc create html` to scaffold `html//index.html` and `config.json` locally. - Added `cloudcc publish html` to upload from that folder, save the HTML component, and auto-create the iframe custom page (reuses `customPage/common` helpers). - Added `get`, `detail`, and `delete` commands plus `devconsoleRequest` for flat JSON calls to `htmlComponent/*` endpoints. - Extended `customPage/common.js` with iframe page payload helpers and expanded `src/html/docs/devguide.md` (CLI usage and front-end guidance). - Updated `listModuleCommands` hint for the `html` resource. - Pull-list CLI robustness and tests update - Updated `pullList` handlers for classes, scripts, timer, and triggers to improve list pagination and argument handling consistency. - Adjusted corresponding CLI tests (`classes/script/timer/trigger`) to validate the updated pull-list behavior. # ReleaseV2.4.8 #### Release Date: 2026-4-17 #### Release Scope: Full #### Release Content - Project template identity status workflow update - Updated template `.cloudcc/IDENTITY.md` status model and sequence to `未开始 -> 需求设计 -> 实现设计 -> 任务拆解 -> 功能开发`. - Aligned `doc/状态.md` guidance with the new lifecycle labels for consistent progress reporting. - Project template config placeholder improvement - Replaced `template/cloudcc-cli.config.json` default placeholders with explicit setup prompts for `safetyMark` and `CloudCCDev`. - Release maintenance - Bumped package version to `2.4.8` and synchronized lockfile root version metadata. - CloudCC skill guidance update - Added `view` module documentation commands to the module checklist and kept OpenAPI CRUD guidance aligned with current CLI usage. - Refined long instruction lines in `cloudcc-dev-skill/SKILL.md` for clearer readability without changing functional intent. - CloudCC skill package metadata sync - Updated `cloudcc-dev-skill/config.json` version from `1.0.8` to `1.0.9`. - Fields developer guide parameter clarification - Added explicit parameter description for `cloudcc get fields ` in `src/fields/docs/devguide.md`. - Legacy resource list cleanup - Removed obsolete `src/res.md` static resource/action summary file. - Agent memory workflow update - Recorded that the phrase `推送技能仓库` should target the standalone `cloudcc-dev-skill` repository by default, including checking its own status, remote, and tracked branch before push. # ReleaseV2.4.7 #### Release Date: 2026-4-16 #### Release Scope: Full #### Release Content - Project template metadata cleanup - Moved `CLAUDE.md` into `template/.claude/CLAUDE.md` and removed legacy `template/AGENTS.md` from the project scaffold so new projects receive the correct Claude workspace instruction layout by default. - Project template doc seed - Added `template/doc/状态.md` and updated `template/index.js` to copy the `doc` folder during `cloudcc create project`, ensuring new projects include the initial status file by default. - Project create help fallback - Added explicit help handling in `src/project/create1.js` for `cloudcc create project -h|--help|help`, so help probes print usage and exit without entering scaffold creation. - Fields update metadata pipeline hardening - Refactored `src/fields/update.js` to fetch current field metadata through `detail.js` (`fieldSetup/editField`) before `saveField`, removing dependency on local object index files. - Added strict argument validation (`projectPath`, `fieldId`, `fieldType`, `objid`) and stronger payload guards to fail fast on invalid update inputs. - Normalized profile permission mapping from `profileList` into `profileFieldJson` and improved warning/error messages for easier troubleshooting. - Fields docs alignment - Updated `src/fields/docs/devguide.md` to keep the update section focused on effective `saveField` behavior and avoid outdated endpoint coupling text. - Plugin create validation and template guidance - Added strict custom element name validation in `src/plugin/create1.js` for `component-${name}` to reject invalid names early (lowercase letters and hyphens only, no digits) and return actionable CLI guidance. - Added create-time guard for missing plugin name and improved default plugin template hints for `compName` (concise display name) and `compDesc` (clear functional description). - Plugin developer guide updates - Updated `src/plugin/docs/devguide.md` with explicit custom element naming constraints and examples for valid/invalid plugin names. - Added recommended metadata authoring rules: keep `compName` concise and readable (within 6 Chinese characters) and `compDesc` descriptive (within 50 Chinese characters). - Release maintenance - Bumped package version to `2.4.7` and synchronized lockfile root version metadata. - CLI routing and command stats alignment - Updated `bin/cc.js` routing and command recording flow to keep single-argument commands on the version dispatcher and normalize stats recording for action/resource pairs. - Enhanced `utils/commandStats.js` key normalization so single-argument version aliases (`version`, `-v`, `-version`, `--version`) are counted under `cloudcc version`, while two-argument commands keep full keys like `cloudcc get doc`. - Resource index dispatch consistency - Standardized multiple module index dispatchers to align with the `cloudcc ` route pattern and keep action forwarding behavior consistent across resources. - Button module enhancement - Added `update` support for button management (`src/button/update.js`) and wired it into `src/button/index.js`. - Extended button create/update handling for event-specific payload content and CLI validation across `lightning-script`, `lightning-url`, and `url` modes. - Custom page and menu update support - Added custom page component switching via `cloudcc update customPage ...`, so an existing custom page can update its bound component without recreating the page manually. - Added custom page menu target switching via `cloudcc update menu page ...`, so an existing page menu can update its bound custom page API directly. - Config, custom page, and custom setting CLI coverage - Added `test/config.cli.test.js` and expanded CLI-first test flows for `config`, `customPage`, and `customSetting`, including doc checks, create/get/delete flows, and safer cleanup behavior. - Updated `customPage` tests to assert against real CLI text output (success lines and created IDs) instead of direct module return objects. - Application and classes test reliability improvements - Upgraded `test/application.cli.test.js` to cover `doc -> create -> get -> update -> delete` end-to-end. - Hardened `test/classes.cli.test.js` doc assertions and published-id parsing to support dynamic config-id keys. - Trigger and timer create companion-class switch - Added optional `autoCreateClass` parameter to `cloudcc create triggers [autoCreateClass]` and `cloudcc create timer [autoCreateClass]`. - Changed default behavior to not auto-create companion custom classes; passing `true` keeps the auto-create flow. - Updated generated Java templates for both resources to provide a no-companion-class safe entry skeleton when auto-create is disabled. - Trigger and timer developer guide updates - Updated `src/triggers/docs/devguide.md` and `src/timer/docs/devguide.md` to document the new optional parameter and recommend the auto-create mode (`... true`) in development workflows. - Dev guide skill path update - Migrated the internal `dev-guide` skill file from `.cursor/skills/dev-guide/SKILL.md` to `.claude/skills/dev-guide/SKILL.md`. - Claude workspace metadata cleanup - Removed legacy `.claude/settings.json` and removed `.claude/skills/dev-guide/SKILL.md` from the local workspace setup. - Added `.claude/CLAUDE.md` and `.claude/MEMORY.md` as local instruction and memory artifacts for the current development workflow. # ReleaseV2.4.6 #### Release Date: 2026-4-15 #### Release Scope: Full #### Release Content - CLI changelog command - Added `cloudcc changelog` as a global command to view release notes directly from `README.md`, including current version, specific version, and `--all` modes. - Help and skill guidance update - Updated CLI help output and `cloudcc-dev-skill/SKILL.md` to include changelog command usage for faster release-note lookup during development. - MCP server minimization - Refactored `mcp/index.js` to a minimal MCP server (`cc-mcp`, version from `package.json`) with no registered tools yet (handshake-only stub; ready for future `registerTool` extensions). - Dev-guide skill - Documented the 「推送代码」release workflow in `.cursor/skills/dev-guide/SKILL.md` (git diff → README `# ReleaseV…` branching rules). - Documented the 「发布版本」workflow (fill `Release Date` for the matching `# ReleaseV…`, then run `npm run npm-publish` from the repo root). - Release maintenance - Bumped package version to `2.4.6` and synchronized lockfile root version metadata. - Environment-scoped config id migration - Updated classes, timer, triggers, script, and plugin config readers to resolve resource ids by `loadCloudccConfigRootSync().use + "id"` with `|| config.id` fallback for backward compatibility. - Updated publish and pullList writers to persist only environment-scoped id keys and remove legacy `id` fields when writing fresh ids. - CLI regression validation and ignore path fix - Executed end-to-end CLI validation for create/publish/pull/delete across classes, timer, triggers, script, and plugin flows in a real org environment. - Corrected `.gitignore` trigger directory entry from `/trigger/` to `/triggers/` so generated trigger files are ignored consistently. # ReleaseV2.4.5 #### Release Date: 2026-4-14 #### Release Scope: Full #### Release Content - `CCService` async API stubs - Added `executeAsyncJob(Map)` and `executeAsyncCustomClass(Map)` to `java/com/cloudcc/core/CCService.java` so public docs and Java stubs stay aligned with async execution APIs. - Classes developer guide polish - Updated `src/classes/docs/devguide.md` to improve markdown table consistency and tighten long wrapped lines for clearer reading. - Release maintenance - Bumped package version to `2.4.5` and synchronized lockfile root version metadata. # ReleaseV2.4.4 #### Release Date: 2026-4-14 #### Release Scope: Full #### Release Content - Classes template reliability - Updated generated trigger test stubs in `src/classes/create.js` to use `HashMap` instead of the invalid `Map` instantiation, ensuring runnable Java sample code. - Classes docs output consistency - Updated `src/classes/doc.js` so `cloudcc doc classes introduction` trims trailing whitespace before output for cleaner terminal rendering. - Classes dev guide cleanup - Refined `src/classes/docs/devguide.md` by removing duplicated background sections and polishing guidance text to keep the document focused on implementation rules. - Release maintenance - Bumped package version to `2.4.4` and synchronized lockfile root version metadata. # ReleaseV2.4.3 #### Release Date: 2026-4-14 #### Release Scope: Full #### Release Content - Scaffolding: timer and trigger companions - `cloudcc create timer ` now generates the companion class `CCSchedule` (same as `create classes`) and wires `schedule//.java` to instantiate it and call `execute()` - `cloudcc create triggers ` now generates the companion class `CCTrigger` with a `cctrigger`-style template (`execute(HashMap, HashMap)`) and updates the trigger Java to delegate to it; trigger constructor is `public (UserInfo userInfo)` with `super(userInfo)` - `cloudcc create classes` supports an internal fourth argument `cctrigger` for the companion trigger template; default class template now uses `execute()` instead of the previous demo `getName` stub - Added guards when project config is missing (`cloudcc-cli.config.json` / `.js`) and clearer JSON parse errors for `create triggers` - Documentation - Updated `src/timer/docs/devguide.md` and `src/triggers/docs/devguide.md` for auto-generated companions, delegation pattern, and parameter typing notes - Schedule Job module enhancement - Added `create` action for `scheduleJob` to support saving scheduled jobs through `cloudcc create scheduleJob ` - Added `getList` action for `scheduleJob` to fetch program candidates used by `prgid` selection before creation - Schedule Job documentation - Updated `src/scheduleJob/docs/devguide.md` with creation prerequisites, parameter normalization rules, and command-first guidance for selecting `prgid` - Clarified command coverage and reordered sections to reflect the full workflow (`create`, `get`, `detail`, `getList`, `delete`, `doc`) - Skill guidance alignment - Updated `cloudcc-dev-skill/SKILL.md` to use the wording “定时作业” and keep `scheduleJob` module guidance aligned with current docs and command capabilities - Skill pack (`cloudcc-dev-skill`) - Bumped bundled skill metadata in `cloudcc-dev-skill/config.json` to `1.0.7` (`2026-04-14`) - Added a “Best practices” section for CCDK: bridges from custom pages/HTML/Site to custom classes (`$CCDK.CCCommon.post`) and to CRM shell capabilities (`$CCDK.CCPage`, e.g. `openListPage`), with Java and JavaScript samples; removed a duplicated “快速规则” block; clarified per-phase `cloudcc doc introduction|devguide` usage - Site and HTML documentation - `src/html/docs/devguide.md`: documented the recommended repo-root `html//index.html` layout for single HTML entry pages - `src/site/docs/devguide.md`: documented the recommended repo-root `site//` layout for full-site development; minor formatting cleanup for long lines - Skill installer (`cloudcc install skill`) - Added `skill` resource with `install` action: `cloudcc install skill` copies bundled `cloudcc-dev-skill` to `~/.cursor/skills/cloudcc-dev-skill`; `cloudcc install skill project` / `--project` installs under the current working directory’s `.cursor/skills` (excludes nested `.git` when copying) - Wired `bin/index.js` and `src/version/listModuleCommands.js` (`MODULE_KEYS_ORDER`, hints, `describeActionLine`) for `cloudcc install -h` discovery - README **Usage Guide**: the top-level **Cursor Agent Skill** section replaces the former **MCP configuration** (`cc-mcp` / `mcp.json`) instructions - Project environment documentation - Reworked `src/project/docs/devguide.md`: global `cloudcc-cli` required, project folder + mandatory `cloudcc-cli.config.json` (JSON examples), CLI vs VS Code/Cursor workflows, optional template project; replaced local MCP (`cc-mcp`) setup with Cursor Agent Skill installation via `cloudcc install skill` - Updated `.cursor/skills/dev-guide/SKILL.md` to document the `skill` module pattern - Release maintenance - Bumped package version to `2.4.3` and synchronized lockfile root version metadata - `CCService` stub alignment with platform - Removed `cquery(apiName, expression, fields, orderBy)` overload (platform does not support 4-param String variant) - Removed `pageQueryWithRoleRight(...)` (platform does not expose this method) - Removed `cqlQueryWithStatic(...)` (platform does not expose this method) - Fixed `cqlQueryWithLogInfo` signature to 3 params `(apiName, expression, logInfo)` matching platform - Fixed `pageQuery` / `pageQueryWithService` to handle both `JSONObject` and `JSONArray` response for `data` field - `getQueryPermission(String)` noted as stub-only; platform requires internal params # ReleaseV2.4.2 #### Release Date: 2026-4-9 #### Release Scope: Full #### Release Content - Config resilience - Fixed `utils/config.js` fallback flow so commands no longer throw `ENOENT` when `package.json` is missing in the current working directory - Added safe existence check and parse guard for legacy `devConsoleConfig` loading to continue with cache/v3/v2 config sources - Release maintenance - Bumped package version to `2.4.2` and synchronized lockfile root version metadata - Dupe Catcher module - Added a new `dupeCatcher` resource with `get`, `detail`, `create`, `delete`, and `doc` actions for filter/rule management - Added `src/dupeCatcher/docs/devguide.md` with command contracts and payload guidance - Sharing Rule module - Added a new `sharingRule` resource focused on object-based rule query via `cloudcc get sharingRule [projectPath]` - Integrated sharing rule docs (`introduction` and `devguide`) aligned to the query-only workflow - CLI discovery and routing - Registered `dupeCatcher` and `sharingRule` in `bin/index.js` and help metadata (`src/version/listModuleCommands.js`) so `cloudcc --help` and `cloudcc get -h` can discover both modules - HTML docs module - Added a new `html` resource with `cloudcc doc html ` for single-file HTML component guidance - Added `src/html/docs/introduction.md` and `src/html/docs/devguide.md`, including static-resource referencing guidance for JS/CSS/image assets - Skill alignment - Updated `cloudcc-dev-skill/SKILL.md` to route HTML component guidance through `cloudcc doc html introduction|devguide` - Site docs module - Added a new `site` resource with `cloudcc doc site ` to provide standalone site development guidance - Added `src/site/docs/introduction.md`, `src/site/docs/devguide.md`, and frontend aesthetics references under `src/site/docs/frontend_aesthetics/` - OpenAPI browser SDK module - Added a new `openapi` resource with `cloudcc get openapi [targetDir] [outputFileName]` to copy browser SDK files into standalone site projects - Added `cloudcc doc openapi ` and module docs for account/password login and object API access from independent sites - CLI help and routing updates - Registered `site` and `openapi` in routing/help metadata so `cloudcc --help` and `cloudcc get -h` can discover the new resources - Skill package cleanup - Removed deprecated `cloudcc-dev-html` skill file and aligned `cloudcc-dev-skill` version metadata for consolidated site guidance - Project configuration (JSON) - Added `cloudcc-cli.config.json` support via `getPackageJson4` in `utils/config.js` so projects with `package.json` `"type":"module"` are not blocked by CommonJS `require` on `.js` config - `getPackageJson` now resolves JSON after cache and before legacy JS loaders (`getPackageJson3` / `getPackageJson2`); `loadCloudccConfigRootSync` and `resolveCloudccConfigFile` prefer JSON when both `.json` and `.js` exist - `cloudcc create project` scaffolds `cloudcc-cli.config.json` (replaces the former `template/cloudcc-cli.configjs` template) - Updated `config use`, `doctor`, plugin pull/publish ignore lists, `.npmignore`, and `classes` error text to recognize the new config filename # 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 ` - 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 -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