cloudcc-cli 2.2.9 → 2.3.0

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

@@ -0,0 +1,241 @@
+# 自定义设置相关接口
+
+## 指导文档
+
+直接使用以下命令查看指导文档：
+
+```bash
+cc doc customSetting
+```
+
+
+---
+
+## 查询自定义设置列表
+
+路径：`{服务名称}/api/customsetting/list`
+
+方法：POST
+
+接口描述：分页/查询自定义设置主列表，返回 `objList` 等。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| （请求体） | object | 非必须 | {} | 当前前端传空对象 |
+
+---
+
+## 新建/更新自定义设置（保存主对象）
+
+路径：`{服务名称}/api/customsetting/save`
+
+方法：POST
+
+接口描述：新建或编辑自定义设置主记录（标签、对象 API 名、类型、可见性、描述等）。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| tpSysObjectVO | object | 必须 | — | 主对象载体，见下表子字段 |
+
+**tpSysObjectVO 子字段：**
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| accessable | string | 视业务 | — | 可见性（如 `"2"` 表示公用等，与表单选项一致） |
+| dataType | string | 视业务 | — | 设置类型：`L` 列表，`H` 层次结构 |
+| id | string | 视业务 | `""` | 新建传空字符串；编辑传记录 id |
+| label | string | 视业务 | — | 标签 |
+| remark | string | 非必须 | — | 描述 |
+| schemetableName | string | 视业务 | — | 对象名（编辑时前端通常禁用修改） |
+
+---
+
+## 编辑前回显（自定义设置主对象）
+
+路径：`{服务名称}/api/customsetting/modify`
+
+方法：POST
+
+接口描述：根据主记录 id 拉取表单回显数据。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| objid | string | 必须 | — | 记录id |
+
+---
+
+## 删除自定义设置主对象
+
+路径：`{服务名称}/api/customsetting/deleteobj`
+
+方法：POST
+
+接口描述：删除一条自定义设置主记录。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| objid | string | 必须 | — | 记录id |
+
+---
+
+## 查询自定义设置详情（含字段列表）
+
+路径：`{服务名称}/api/customsetting/detail`
+
+方法：POST
+
+接口描述：详情页使用，返回主对象信息及 `cusFields` 字段列表。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| objid | string | 必须 | — | 记录id |
+
+---
+
+## 进入字段编辑（取字段编辑所需数据）
+
+路径：`{服务名称}/api/customsetting/editfile`
+
+方法：POST
+
+接口描述：点击某字段「编辑」时调用，用于打开字段编辑器。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| queryrecordid | string | 必须 | — | 字段行 id |
+
+---
+
+## 删除自定义字段
+
+路径：`{服务名称}/api/customsetting/deletefield`
+
+方法：POST
+
+接口描述：在详情页删除某条自定义字段。
+
+### 请求参数
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| id | string | 必须 | — | 字段行 id |
+| objid | string | 必须 | — | 所属自定义设置 id |
+
+---
+
+
+## 自定义字段类型静态配置
+> 前端静态配置，非后端接口返回）
+```json
+[
+  {
+    "id": "0001",
+    "name": "URL",
+    "type": "U",
+    "address": "允许用户输入任何有效的网址。如果用户单击该字段，将根据用户选择的模式在浏览器的新窗口或当前窗口中打开该 URL。系统默认在浏览器的新窗口中打开该URL。"
+  },
+  {
+    "id": "0002",
+    "name": "百分比",
+    "type": "P",
+    "address": "允许用户输入百分比数字（例如，10），并自动向数字添加百分号。"
+  },
+  {
+    "id": "0003",
+    "name": "币种",
+    "type": "c",
+    "address": "币种"
+  },
+  {
+    "id": "0004",
+    "name": "电话",
+    "type": "H",
+    "address": "允许用户输入任何电话号码。自动将其转换为电话号码格式。"
+  },
+  {
+    "id": "0005",
+    "name": "电子邮件",
+    "type": "E",
+    "address": "允许用户输入电子邮件地址，对其进行验证以确保格式正确。如果对于一个联系人和潜在客户指定了此字段，则用户单击“发送电子邮件”时可以选择地址。注意，自定义电子邮件地址无法用于批量电子邮件。"
+  },
+  {
+    "id": "0006",
+    "name": "复选框",
+    "type": "B",
+    "address": "允许用户选择“真”（选取）或“假”（不选取）值。"
+  },
+  {
+    "id": "0007",
+    "name": "日期",
+    "type": "D",
+    "address": "允许用户输入日期或从弹出式日历中选择日期。"
+  },
+  {
+    "id": "0008",
+    "name": "日期和时间",
+    "type": "F",
+    "address": "允许用户输入日期和时间，或从弹出式日历中选择日期。当用户单击弹出式日历中的某个日期后，该日期和当前时间将输入到日期/时间字段。"
+  },
+  {
+    "id": "0009",
+    "name": "数字",
+    "type": "N",
+    "address": "允许用户输入任何数字。将删除前置零。"
+  },
+  {
+    "id": "0010",
+    "name": "文本",
+    "type": "S",
+    "address": "允许用户输入任何字母和数字组合。"
+  },
+  {
+    "id": "0011",
+    "name": "长文本",
+    "type": "X",
+    "address": "允许用户输入多行文本，最多可输入 4000 个字符。"
+  }
+]
+```
+
+## 保存字段（新增/编辑字段）
+路径：`{服务名称}/api/customsetting/saveField`
+方法：POST
+接口描述：在自定义设置详情页中保存字段定义（字段新建或编辑）。
+### 请求参数
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| tpSysSchemetableVO | object | 必须 | — | 字段对象，见下方子字段表 |
+| fdtype | string | 必须 | — | 字段类型代码（如 `U` 表示 URL） |
+**tpSysSchemetableVO 子字段：**
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| schemetableId | string | 必须 | — | 所属自定义设置（对象）id |
+| id | string | 非必须 | — | 字段 id；编辑时传，新增可不传或传空 |
+| nameLabel | string | 必须 | — | 字段显示名称（标签） |
+| apiname | string | 必须 | — | 字段 API 名 |
+| edittype | string | 非必须 | — | 字段编辑类型（例如 URL 打开方式 `_blank`） |
+| schemefieldLength | string | 非必须 | — | 字段长度 |
+| defaultValue | string | 非必须 | — | 默认值 |
+| datafieldRef | string | 非必须 | — | 数据字段引用名 |
+| isDeleted | string | 非必须 | `"0"` | 删除标记 |
+| fieldState | string | 非必须 | `"enable"` | 字段状态 |
+| iscustom | string | 非必须 | `"1"` | 是否自定义字段 |
+| schemefieldType | string | 必须 | — | 字段类型代码（例如 `U`） |
+| schemefieldName | string | 必须 | — | 字段物理名/存储名 |
+
+
+
+
+

package/README.md

@@ -22,6 +22,17 @@ sudo npm i -g cloudcc-cli
 }
 ```
 
+# ReleaseV2.3.0
+
+#### Release Date: 2026-3-25
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Optimization
+  - Fix class management commands
+
 # ReleaseV2.2.9
 
 #### Release Date: 2026-3-25
@@ -31,7 +42,7 @@ sudo npm i -g cloudcc-cli
 #### Release Content
 
 - Optimization
-  - 添加删除组件命令
+  - Add delete component command
 
 # ReleaseV2.2.8
 

package/bin/index.js

@@ -6,6 +6,10 @@ cc.plugin = require("../src/plugin/index")
 
 cc.classes = require("../src/classes/index")
 
+cc.customSetting = require("../src/customSetting/index")
+
+cc.customPage = require("../src/customPage/index")
+
 cc.schedule = require("../src/timer/index")
 
 cc.triggers = require("../src/triggers/index")

package/classes/CCdd/CCdd.java

@@ -0,0 +1,22 @@
+package classes.CCdd;
+
+import com.cloudcc.core.*;
+// @SOURCE_CONTENT_START
+public class CCdd{
+    private UserInfo userInfo;
+    private CCService cs;
+
+    public CCdd(UserInfo userInfo){
+        this(userInfo,new CCService(userInfo));
+    }
+    public CCdd(UserInfo userInfo,CCService cs){
+        this.userInfo = userInfo;
+        this.cs=cs;
+    }
+    
+    public String getName(String str){
+        str = "demo";
+        return str;
+    }
+}
+// @SOURCE_CONTENT_END    

package/classes/CCdd/CCddTest.java

@@ -0,0 +1,11 @@
+package classes.CCdd;
+
+import com.cloudcc.core.*;
+
+public class CCddTest {
+    public static void main(String[] args) {
+        CCdd obj = new CCdd(new UserInfo());
+        String name = obj.getName("test");
+        System.out.println("name:" + name);
+    }
+}

package/classes/CCdd/config.json

@@ -0,0 +1 @@
+{"name":"CCdd","version":"2","id":"ccp20269AAF29D2SqHiD"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.2.9",
+  "version": "2.3.0",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",

package/schedule/CCdd/CCdd.java

@@ -0,0 +1,11 @@
+package schedule.CCdd;
+
+import com.cloudcc.core.*;
+
+public class CCdd extends CCSchedule {
+    public CCdd() {
+        // @SOURCE_CONTENT_START
+        System.out.print("hello World");
+        // @SOURCE_CONTENT_END
+    }
+}

package/schedule/CCdd/config.json

@@ -0,0 +1 @@
+{"name":"CCdd","version":"2"}

package/src/classes/index.js

@@ -1,5 +1,10 @@
 const cc = {}
-
+cc.create = require("./create")
+cc.publish = require("./publish")
+cc.pull = require("./pull")
+cc.get = require("./get")
+cc.pullList = require("./pullList")
+cc.detail = require("./detail")
 cc.doc = require("./doc")
 function Classes(action, argvs) {
   cc[action](argvs[2], argvs[3])

package/src/customPage/create.js

@@ -0,0 +1,77 @@
+const chalk = require('chalk');
+const { getPackageJson } = require('../../utils/config');
+const { post } = require('../../utils/http');
+const BaseUrl = 'https://developer.apis.cloudcc.cn';
+
+/**
+ * 新建自定义页面
+ *
+ * 用法：cc customPage create <pageLabel> <pageApi> [projectPath]
+ */
+async function createCustomPage(argvs) {
+    const pageLabel = argvs[2];
+    const pageApi = argvs[3];
+    const projectPath = argvs[4] || process.cwd();
+
+    if (!pageLabel || !pageApi) {
+        console.error();
+        console.error(chalk.red('Error: pageLabel and pageApi are required'));
+        console.error(chalk.yellow('Usage: cc customPage create <pageLabel> <pageApi> [projectPath]'));
+        console.error();
+        return;
+    }
+
+    const config = await getPackageJson(projectPath);
+    if (!config || !config.accessToken) {
+        console.error();
+        console.error(chalk.red('Error: Configuration not found or accessToken is missing'));
+        console.error();
+        return;
+    }
+
+    const devSvcDispatch = config.devSvcDispatch || '/devconsole';
+    const baseUrl = config.baseUrl || BaseUrl;
+
+    const header = {
+        appType: 'lightning-devconsole',
+        accessToken: config.accessToken,
+        source: 'lightning-devconsole',
+        version: 'public',
+    };
+
+    const body = {
+        id: '',
+        pageLabel,
+        pageApi,
+        pageContent: '[]',
+        orgId: config.orgId || '',
+        renderVersion: '',
+        compList: [],
+        canvasStyleData: JSON.stringify({ width: 100, height: 100, scale: 100, unit: '%' }),
+        isTemplate: 0,
+    };
+
+    console.error();
+    console.error(chalk.green(`Creating custom page "${pageLabel}" (api: ${pageApi}), please wait...`));
+
+    const res = await post(
+        `${baseUrl}${devSvcDispatch}/custom/pc/1.0/post/insertCustomPage`,
+        body,
+        header
+    );
+
+    if (res && res.returnCode == 200) {
+        const id = res.data?.id || res.data || '';
+        console.error(chalk.green(`Success! Custom page created.${id ? ' ID: ' + id : ''}`));
+        console.error();
+    } else {
+        const errMsg = res?.returnInfo || 'Unknown error';
+        console.error(chalk.red(`Fail: ${errMsg}`));
+        console.error();
+        throw new Error('Create Custom Page Failed: ' + errMsg);
+    }
+
+    return res;
+}
+
+module.exports = createCustomPage;

package/src/customPage/delete.js

@@ -0,0 +1,65 @@
+const chalk = require('chalk');
+const { getPackageJson } = require('../../utils/config');
+const { post } = require('../../utils/http');
+const BaseUrl = 'https://developer.apis.cloudcc.cn';
+
+/**
+ * 删除自定义页面
+ *
+ * 用法：cc customPage delete <id> [projectPath]
+ */
+async function deleteCustomPage(argvs) {
+    const id = argvs[2];
+    const projectPath = argvs[3] || process.cwd();
+
+    if (!id) {
+        console.error();
+        console.error(chalk.red('Error: Custom page ID is required'));
+        console.error(chalk.yellow('Usage: cc customPage delete <id> [projectPath]'));
+        console.error();
+        return;
+    }
+
+    const config = await getPackageJson(projectPath);
+    if (!config || !config.accessToken) {
+        console.error();
+        console.error(chalk.red('Error: Configuration not found or accessToken is missing'));
+        console.error();
+        return;
+    }
+
+    const devSvcDispatch = config.devSvcDispatch || '/devconsole';
+    const baseUrl = config.baseUrl || BaseUrl;
+
+    const header = {
+        appType: 'lightning-devconsole',
+        accessToken: config.accessToken,
+        source: 'lightning-devconsole',
+        version: 'public',
+    };
+
+    const body = { id };
+
+    console.error();
+    console.error(chalk.green(`Deleting custom page (ID: ${id}), please wait...`));
+
+    const res = await post(
+        `${baseUrl}${devSvcDispatch}/custom/pc/1.0/post/deleteCustomPage`,
+        body,
+        header
+    );
+
+    if (res && res.returnCode == 200) {
+        console.error(chalk.green(`Success! Custom page (ID: ${id}) deleted.`));
+        console.error();
+    } else {
+        const errMsg = res?.returnInfo || 'Unknown error';
+        console.error(chalk.red(`Fail: ${errMsg}`));
+        console.error();
+        throw new Error('Delete Custom Page Failed: ' + errMsg);
+    }
+
+    return res;
+}
+
+module.exports = deleteCustomPage;

package/src/customPage/get.js

@@ -0,0 +1,85 @@
+const chalk = require('chalk');
+const { getPackageJson } = require('../../utils/config');
+const { post } = require('../../utils/http');
+const BaseUrl = 'https://developer.apis.cloudcc.cn';
+
+/**
+ * 获取自定义页面列表
+ *
+ * 用法：cc customPage list [pageNo] [pageSize] [projectPath]
+ */
+async function listCustomPage(argvs) {
+    const pageNo = parseInt(argvs[2], 10) || 1;
+    const pageSize = parseInt(argvs[3], 10) || 20;
+    const projectPath = argvs[4] || process.cwd();
+
+    const config = await getPackageJson(projectPath);
+    if (!config || !config.accessToken) {
+        console.error();
+        console.error(chalk.red('Error: Configuration not found or accessToken is missing'));
+        console.error();
+        return;
+    }
+
+    const devSvcDispatch = config.devSvcDispatch || '/devconsole';
+    const baseUrl = config.baseUrl || BaseUrl;
+
+    const header = {
+        appType: 'lightning-devconsole',
+        accessToken: config.accessToken,
+        source: 'lightning-devconsole',
+        version: 'public',
+    };
+
+    const body = {
+        pageNo,
+        pageSize,
+        condition: {
+            pageLabel: '',
+            dtBegin: '',
+            dtEnd: '',
+            pageApi: '',
+        },
+    };
+
+    console.error();
+    console.error(chalk.green(`Fetching custom page list (page ${pageNo}, size ${pageSize})...`));
+
+    const res = await post(
+        `${baseUrl}${devSvcDispatch}/custom/pc/1.0/post/pageCustomPage`,
+        body,
+        header
+    );
+
+    if (res && res.returnCode == 200) {
+        const data = res.data || {};
+        const records = data.records || data.list || data || [];
+        const total = data.total ?? (Array.isArray(records) ? records.length : 0);
+
+        console.error(chalk.green(`Success! Total: ${total}`));
+        console.error();
+
+        if (Array.isArray(records) && records.length > 0) {
+            records.forEach((item, index) => {
+                console.log(
+                    chalk.cyan(`[${index + 1}]`) +
+                    `  ID: ${item.id || '-'}` +
+                    `  Label: ${item.pageLabel || '-'}` +
+                    `  API: ${item.pageApi || '-'}`
+                );
+            });
+        } else {
+            console.log(chalk.yellow('No custom pages found.'));
+        }
+        console.error();
+    } else {
+        const errMsg = res?.returnInfo || 'Unknown error';
+        console.error(chalk.red(`Fail: ${errMsg}`));
+        console.error();
+        throw new Error('List Custom Page Failed: ' + errMsg);
+    }
+
+    return res;
+}
+
+module.exports = listCustomPage;

package/src/customPage/index.js

@@ -0,0 +1,10 @@
+const cc = {};
+cc.create = require('./create');
+cc.delete = require('./delete');
+cc.get = require('./get');
+
+function CustomPage(action, argvs) {
+    cc[action](argvs);
+}
+
+module.exports = CustomPage;

package/src/customSetting/doc.js

@@ -0,0 +1,196 @@
+/**
+ * customSetting 文档统一入口（全量一次性输出）
+ */
+const fs = require("fs");
+const path = require("path");
+
+function generateFullMarkdownDoc() {
+    const lines = [
+        "# CloudCC 自定义设置操作指南",
+        "",
+        "> 本文档按实际页面操作顺序整理，覆盖你提供的 7 个步骤图：",
+        "> 列表 -> 新建 -> 编辑 -> 详情建字段 -> 字段类型选择 -> 字段属性填写 -> 字段编辑。",
+        "",
+        "直接查看 CLI 文档：`cc doc customSetting`",
+        "",
+        "---",
+        "",
+        "## 1. 入口与列表页（图一）",
+        "",
+        "进入路径：`设置 -> 开发者空间 -> 自定义设置`。",
+        "",
+        "在列表页可看到：",
+        "- 标签",
+        "- 可见性",
+        "- 设置类型",
+        "- 描述",
+        "",
+        "右上角点击「新建」进入自定义设置创建弹窗。",
+        "",
+        "---",
+        "",
+        "## 2. 新建自定义设置（图二）",
+        "",
+        "点击图一右上角「新建」，弹出「自定义设置:新建」窗口，需要填写：",
+        "",
+        "- `标签`（必填）",
+        "- `对象名`（必填）",
+        "- `设置类型`（如：列表）",
+        "- `可见性`（如：公用）",
+        "- `描述`（可选）",
+        "",
+        "填写后保存，返回列表可看到新建记录。",
+        "",
+        "---",
+        "",
+        "## 3. 编辑自定义设置基础信息（图三）",
+        "",
+        "在列表中选择一条记录进入编辑弹窗「自定义设置:编辑」。",
+        "",
+        "常见行为：",
+        "- 可编辑：标签、可见性、描述等",
+        "- 对象名、设置类型通常按产品规则受限（常见为不可改）",
+        "",
+        "保存后回到列表，确认信息更新成功。",
+        "",
+        "---",
+        "",
+        "## 4. 进入详情并管理字段（图四）",
+        "",
+        "点击某条自定义设置后进入详情页，页面分为两块：",
+        "",
+        "1. 自定义设置详细信息（头部）",
+        "2. 自定义设置字段列表（下半区）",
+        "",
+        "在字段列表区域可点击「新建」，为当前自定义设置新增字段。",
+        "",
+        "---",
+        "",
+        "## 5. 新建字段 - 选择数据类型（图五）",
+        "",
+        "点击图四的「新建」后，进入「自定义字段」向导第一步：",
+        "",
+        "- 选择字段数据类型（如 URL、百分比、货币、电话、电子邮件、文本、日期等）",
+        "- 该步骤决定下一步字段属性表单内容",
+        "",
+        "选择完成后点击「下一步」。",
+        "",
+        "---",
+        "",
+        "## 6. 新建字段 - 填写字段属性并保存（图六）",
+        "",
+        "在第二步填写字段属性（示例为文本字段）：",
+        "",
+        "- 字段标签（必填）",
+        "- 长度（如文本长度 255）",
+        "- 字段名 / API 名称（必填）",
+        "- 独有配置（如不允许重复值，按需开启）",
+        "",
+        "点击「保存」后，即在当前自定义设置下创建了一个新字段。",
+        "",
+        "---",
+        "",
+        "## 7. 编辑已有字段（图七）",
+        "",
+        "保存成功后回到字段列表，可看到新字段。点击某字段的操作菜单（如「...」）可进行：",
+        "",
+        "- 编辑：修改字段属性（可修改范围受字段类型和系统规则限制）",
+        "- 删除：移除该字段（建议先确认是否已有业务依赖）",
+        "",
+        "编辑保存后，字段列表会展示最新结果。",
+        "",
+        "---",
+        "",
+        "## 8. 新建字段支持的所有字段类型",
+        "",
+        "自定义设置详情页「新建字段」当前支持以下字段类型（与前端字段类型选择一致）：",
+        "",
+        "| 类型代码（fdtype） | 类型名称 | 说明 |",
+        "|---|---|---|",
+        "| `U` | URL | 允许输入有效网址；点击后按打开方式在新/当前窗口打开 |",
+        "| `P` | 百分比 | 输入数字并自动添加百分号（如 10 -> 10%） |",
+        "| `c` | 币种 | 金额/币种类型字段 |",
+        "| `H` | 电话 | 输入电话号码并按电话格式展示 |",
+        "| `E` | 电子邮件 | 输入邮箱并校验格式（可用于“发送电子邮件”选择地址） |",
+        "| `B` | 复选框 | 布尔值（真/假） |",
+        "| `D` | 日期 | 输入或选择日期 |",
+        "| `F` | 日期和时间 | 输入或选择日期时间 |",
+        "| `N` | 数字 | 输入数字（会删除前置零） |",
+        "| `S` | 文本 | 字母数字组合文本 |",
+        "| `X` | 长文本 | 多行文本，最多 4000 字符 |",
+        "",
+        "在接口层面：新建/编辑字段使用 `POST /api/customsetting/saveField`，其中 `fdtype` 与 `tpSysSchemetableVO.schemefieldType` 建议保持一致（例如文本为 `S`，百分比为 `P`）。",
+        "",
+        "---",
+        "",
+        "## 9. Java 侧读取自定义设置（CCService）",
+        "",
+        "### 9.1 列表类型（List）",
+        "",
+        "```java",
+        "// 某 API 名称下的全部数据",
+        "Map listSettings = cs.getListCustomSetting(\"MyListSettingApiName\");",
+        "",
+        "// 指定 Name 的单条",
+        "Map singleSetting = cs.getListCustomSetting(\"MyListSettingApiName\", \"SomeName\");",
+        "```",
+        "",
+        "### 9.2 层次结构类型（Hierarchy）",
+        "",
+        "```java",
+        "// id 为简档 ID 或用户 ID",
+        "Map hiSetting = cs.getCustomSetting(\"MyHierarchySettingApiName\", profileOrUserId);",
+        "```",
+        "",
+        "---",
+        "",
+        "## 10. 操作 Checklist",
+        "",
+        "- [ ] 已在列表页确认目标自定义设置（标签/对象名）",
+        "- [ ] 新建时已正确选择设置类型与可见性",
+        "- [ ] 进入详情后通过字段向导完成字段新增",
+        "- [ ] 字段 `标签`、`API 名称`、`长度` 等配置符合规范",
+        "- [ ] 保存后已在字段列表验证新增或编辑结果",
+        "- [ ] 代码侧读取时，API 名称与平台配置保持一致",
+        "",
+    ];
+
+    const base = lines.join("\n");
+    const apiPath = path.join(
+        __dirname,
+        "..",
+        "..",
+        "cloudcc-cli-dev",
+        "CUSTOM-SETTING-API.md"
+    );
+    let apiContent = "";
+    try {
+        apiContent = fs.readFileSync(apiPath, "utf8");
+    } catch (e) {
+        apiContent = `# 自定义设置相关接口\n\n（未找到文件：${apiPath}）\n`;
+    }
+
+    return [
+        base,
+        "",
+        "---",
+        "",
+        "## 附录：自定义设置 Setup 接口速查",
+        "",
+        "> 来源：`cloudcc-cli-dev/CUSTOM-SETTING-API.md`",
+        "",
+        apiContent.trim(),
+        "",
+    ].join("\n");
+}
+
+function doc() {
+    const content = generateFullMarkdownDoc();
+    console.log(content);
+    return content;
+}
+
+doc.getClassEditorDoc = doc;
+doc.getEditGuide = doc;
+
+module.exports = doc;

package/src/customSetting/index.js

@@ -0,0 +1,7 @@
+const cc = {};
+cc.doc = require("./doc");
+function CustomSetting(action, argvs) {
+    cc[action](argvs[2], argvs[3]);
+}
+
+module.exports = CustomSetting;

package/target/classes/CCdd/config.json

@@ -0,0 +1 @@
+{"name":"CCdd","version":"2","id":"ccp20269AAF29D2SqHiD"}