cloudcc-cli 2.3.7 → 2.3.9

package/src/fields/create.js

@@ -1,34 +1,7 @@
 const { postClass } = require("../../utils/http")
 const { getPackageJson } = require("../../utils/config");
 const chalk = require('chalk')
-const briefGet = require("../brief/get");
-const { labelToSlug } = require("../../utils/utils");
-const S = require("./fields/S");
-const U = require("./fields/U");
-const SCORE = require("./fields/SCORE");
-const IMG = require("./fields/IMG");
-const P = require("./fields/P");
-const C = require("./fields/C");
-const J = require("./fields/J");
-const H = require("./fields/H");
-const E = require("./fields/E");
-const B = require("./fields/B");
-const A = require("./fields/A");
-const D = require("./fields/D");
-const F = require("./fields/F");
-const T = require("./fields/T");
-const N = require("./fields/N");
-const ENC = require("./fields/ENC");
-const ENCD = require("./fields/ENCD");
-const X = require("./fields/X");
-const L = require("./fields/L");
-const Q = require("./fields/Q");
-const AD = require("./fields/AD");
-const LT = require("./fields/LT");
-const FL = require("./fields/FL");
-const Y = require("./fields/Y");
-const MR = require("./fields/MR");
-const M = require("./fields/M");
+const { buildFieldData } = require("./buildFieldData");
 
 /**
  * 创建字段
@@ -37,161 +10,28 @@ const M = require("./fields/M");
  */
 async function create(argvs) {
     try {
-        let fieldData = null;
         let projectPath = argvs[2];
         const config = await getPackageJson(projectPath);
-        let fieldType = argvs[3];
-        let objid = argvs[4];
         let nameLabel = argvs[5];
+        // 统一规则：所有字段创建中 argvs[6] 作为 remark（字段业务功能描述）
+        let remarkText = argvs[6];
+        if (!remarkText) remarkText = "auto created by cloudcc-cli ai agent";
         console.error(chalk.blue('\nCreating field ' + nameLabel + '...'));
-        if (fieldType == "S") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = S(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "U") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = U(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "SCORE") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = SCORE(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "IMG") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = IMG(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "P") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = P(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "C") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = C(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "J") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = J(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "H") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = H(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "E") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = E(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "B") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = B(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "A") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = A(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "D") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = D(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "F") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = F(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "T") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = T(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "N") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = N(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "ENC") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = ENC(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "ENCD") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = ENCD(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "X") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = X(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "L") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            let ptext = argvs[6];
-            fieldData = L(objid, nameLabel, apiname, ptext, briefData.data);
-        } else if (fieldType == "Q") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            let ptext = argvs[6];
-            fieldData = Q(objid, nameLabel, apiname, ptext, briefData.data);
-        } else if (fieldType == "AD") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = AD(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "LT") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = LT(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "FL") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            fieldData = FL(objid, nameLabel, apiname, briefData.data);
-        } else if (fieldType == "Y") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            let lookupObj = argvs[6];
-            fieldData = Y(objid, nameLabel, apiname, lookupObj, briefData.data);
-        } else if (fieldType == "MR") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            let lookupObj = argvs[6];
-            fieldData = MR(objid, nameLabel, apiname, lookupObj, briefData.data);
-        } else if (fieldType == "M") {
-            const slug = labelToSlug(nameLabel);
-            let apiname = `${slug}_custom_${fieldType}_field`.toLowerCase();
-            let briefData = await briefGet(argvs);
-            let lookupObj = argvs[6];
-            fieldData = M(objid, nameLabel, apiname, lookupObj, briefData.data);
-        }
+        let fieldData = await buildFieldData(argvs, { shift: 0 });
         // 查询页面布局列表，取第一个绑定到字段
         if (fieldData) {
             const layoutRes = await postClass(
                 config.setupSvc + "/api/layout/newpage",
-                { objid: objid },
+                { objid: fieldData.objid },
                 config.accessToken
             );
             if (layoutRes && layoutRes.result && Array.isArray(layoutRes.data) && layoutRes.data.length > 0) {
                 fieldData.layoutIds = layoutRes.data[0].id;
             }
         }
-        fieldData.remark = "auto created by cloudcc-cli ai agent";
+        // 统一写入 remark：模板一般在 fieldData.obj.remark，保留顶层 remark 做兼容
+        if (fieldData && fieldData.obj) fieldData.obj.remark = remarkText;
+        if (fieldData) fieldData.remark = remarkText;
         // 发送请求到服务器
         const result = await postClass(
             config.setupSvc + "/api/fieldSetup/save",
@@ -213,4 +53,4 @@ async function create(argvs) {
     }
 }
 
-module.exports = create;
+module.exports = create;

package/src/fields/detail.js

@@ -0,0 +1,37 @@
+const { postClass } = require("../../utils/http")
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 查询字段详情（平台字段编辑页数据），对应接口 fieldSetup/editField
+ * @param {string[]} argvs
+ * @param {boolean} [isMcp]
+ * @returns {Promise<object>}
+ */
+async function detail(argvs, isMcp = false) {
+    const projectPath = argvs[2];
+    const fieldId = argvs[3];
+    const fdtype = argvs[4];
+    const objid = argvs[5];
+    if (!projectPath || !fieldId || !fdtype || !objid) {
+        throw new Error(
+            "Missing arguments: cloudcc detail fields <projectPath> <fieldId> <fdtype> <objid>"
+        );
+    }
+    const config = await getPackageJson(projectPath);
+    const body = {
+        fieldId: String(fieldId).trim(),
+        fdtype: String(fdtype).trim(),
+        objid: String(objid).trim(),
+    };
+    const res = await postClass(
+        config.setupSvc + "/api/fieldSetup/editField",
+        body,
+        config.accessToken
+    );
+    if (!isMcp) {
+        console.log(JSON.stringify(res));
+    }
+    return res;
+}
+
+module.exports = detail;

package/src/fields/docs/devguide.md

@@ -2,7 +2,7 @@
 
 ## 1. 模块定位
 
-`fields` 模块用于管理 CloudCC 对象字段，当前提供查询、创建、删除三类能力。
+`fields` 模块用于管理 CloudCC 对象字段，当前提供字段列表查询、字段详情、创建、更新、删除能力。
 
 可通过以下命令读取文档：
 
@@ -17,7 +17,9 @@ cloudcc doc fields devguide
 
 ```bash
 cloudcc get fields <projectPath> <objPrefix>
-cloudcc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
+cloudcc detail fields <projectPath> <fieldId> <fdtype> <objid>
+cloudcc create fields <projectPath> <fieldType> <objid> <fieldLabel> <remark> [extraArg]
+cloudcc update fields <projectPath> <fieldId> <fieldType> <objid> <fieldLabel> <remark> [extraArg]
 cloudcc delete fields <projectPath> <fieldId> <objid>
 ```
 
@@ -29,19 +31,48 @@ cloudcc delete fields <projectPath> <fieldId> <objid>
 - `objid`：对象 ID
 - `fieldLabel`：字段显示名称
 - `extraArg`：部分字段类型需要的额外参数，如 `ptext` 或 `lookupObj`
-- `fieldId`：字段 ID（用于删除）
+- `remark`：用于描述字段的业务功能（写入字段模板的 `obj.remark`，位置固定为 `argvs[6]`）
+- `fieldId`：字段 ID（`update` / `delete` 必填；可通过 `get fields` 返回的 `id` 获取）
 
 说明：
 
-- 当前 CLI 参数以 `src/fields/create.js`、`src/fields/get.js`、`src/fields/delete.js` 的实际实现为准
+- 当前 CLI 参数以 `src/fields/buildFieldData.js`、`src/fields/create.js`、`src/fields/update.js`、`src/fields/get.js`、`src/fields/delete.js` 的实际实现为准
 - 字段 API 名称在当前创建逻辑中默认由 CLI 自动生成，不要求单独传入
 
 ---
 
-## 3. 查询字段
+## 3. 查询字段详情（detail）
+
+用于拉取与平台「字段编辑」页一致的数据（简档列表、对象列表、`fieldObj` 等），对应接口 **`POST /api/fieldSetup/editField`**。
 
 ### 3.1 基本命令
 
+```bash
+cloudcc detail fields <projectPath> <fieldId> <fdtype> <objid>
+```
+
+- `fieldId`：字段 ID（与 `get fields` 返回的 `id` 一致）
+- `fdtype`：字段类型编码（例如 `P`、`S`、`U`，与 `fdtype` / `schemefieldType` 一致）
+- `objid`：所属对象 ID
+
+请求体示例：
+
+```json
+{
+  "fieldId": "ffe2026A3B035C748w95",
+  "fdtype": "P",
+  "objid": "2026BEECB242636G72cD"
+}
+```
+
+成功时 CLI 将打印接口返回的 JSON（含 `result`、`data` 等，具体结构以平台为准）。
+
+---
+
+## 4. 查询字段列表（get）
+
+### 4.1 基本命令
+
 ```bash
 cloudcc get fields <projectPath> <objPrefix>
 ```
@@ -61,69 +92,162 @@ cloudcc get fields <projectPath> <objPrefix>
 
 ---
 
-## 4. 创建字段
+## 5. 创建字段
 
-### 4.1 基本命令
+### 5.1 基本命令
 
 ```bash
-cloudcc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
+cloudcc create fields <projectPath> <fieldType> <objid> <fieldLabel> <remark> [extraArg]
 ```
 
-建议：
+#### 公用参数（所有字段类型通用）
+
+- `projectPath`：本地项目路径
+- `fieldType`：字段类型编码（例如 `S`、`U`、`L`、`Y` 等）
+- `objid`：对象 ID
+- `fieldLabel`：字段显示名称
+- `remark`：字段业务功能描述（写入字段模板的 `obj.remark`；参数位置固定为 `argvs[6]`）
+- `helps`：帮助说明，固定`argvs[7]`
+- `defaultValue`：默认值，固定`argvs[8]`
+- `extraArg`：仅部分字段类型需要的额外入参；其含义与参数位置随 `fieldType` 变化（通常从 `argvs[9]` 开始）
+
+#### 字段特殊入参（按 `fieldType`）
+
+以下均假定 **`create fields`** 的 argv 下标（**`update fields`** 因多一个 `fieldId`，`remark` 及之后的参数整体 **`+1`**，见 [5.2](#52-更新字段)）。
+
+**约定**：**`helps`**、**`defaultValue`** 见上文公用参数（**`argvs[7]`**、**`argvs[8]`**）；本节只写各类型在 **`argvs[9]`** 起的**专属参数**。若不需要默认值，**`argvs[8]`** 仍请传 **`''`** 占位，避免与专属参数错位。
+
+- `S`（文本）
+  - `schemefieldLength`（可选）：字段长度；**`argvs[9]`**；不传默认 `255`
+  - `isrepeat`（可选）：是否允许重复值；**`argvs[10]`**；`true` / `false`；不传默认 `true`
+  - `placeholder`（可选）：输入框提示文案（`obj.placeholder`）；**`argvs[11]`**（与「空字符串占位」含义不同）
+  - `casesensitive`（可选）：是否区分大小写；**`argvs[12]`**；仅当 `isrepeat=false` 时生效；空则默认 `false`
+  - **空字符串占位**：**`argvs[9]`～`argvs[12]`** 顺序固定；若要向更后面的槽位传值，中间未用槽位须 **`''`**
+- `U`（URL）
+  - `edittype`（可选）：链接打开方式，`_blank` 或 `_self`；**`argvs[9]`**；不传默认 `_blank`；非 `_self` 按实现回退为 `_blank`
+- `P`（百分比）
+  - `schemefieldLength`（可选）：小数点**左侧**（整数部分）位数；**`argvs[9]`**；不传默认 `10`
+  - `decimalPlaces`（可选）：小数点**右侧**位数；**`argvs[10]`**；不传默认 `2`
+  - **约束**：两者须为非负整数，且**之和不能大于 18**
+- `C`（币种）
+  - 专属参数与 **`P`** 相同（**`argvs[9]`**、**`argvs[10]`**），约束相同
+- `N`（数字）
+  - `schemefieldLength`（可选）：小数点**左侧**（整数部分）位数；**`argvs[9]`**；不传默认 `10`
+  - `decimalPlaces`（可选）：小数点**右侧**位数；**`argvs[10]`**；不传默认 `0`
+  - `isrepeat`（可选）：是否允许重复值；**`argvs[11]`**；`true` / `false`；不传默认 `true`（允许重复）
+  - `displayThousands`（可选）：平台字段 **`obj.displayThousands`**；**`argvs[12]`**；**`"1"`** 表示不允许重复，**`"0"`** 表示允许重复；不传默认 **`"0"`**
+  - **约束**：`schemefieldLength` 与 `decimalPlaces` 须为非负整数，且**之和不能大于 18**（与 `P`/`C` 精度规则一致）
+- `IMG`（图片）
+  - **`defaultValue`**（**`argvs[8]`**）：**可上传图片数量**（写入 `obj.defaultValue`）；须为 **1～100** 的整数；空则默认 **`3`**
+  - **`formulaType`**（可选）：录入方式 **`url`** 或 **`input`**（顶层 `formulaType`）；**`argvs[9]`**；不传默认 **`input`**
+  - **`watermarkstatus`**（可选）：是否支持水印拍照；**`argvs[10]`**；**`"0"`** 不支持，**`"1"`** 支持；不传默认 **`"0"`**
+- `FL`（文件）
+  - **`defaultValue`**（**`argvs[8]`**）：**可上传文件数量**（须为 **1～100** 的整数；写入 **`obj.defaultValue`**，并与 **`obj.isrepeat`** 设为**同一数值**）；空则默认 **`1`**
+- `ENC`（加密文本-存储加密）、`ENCD`（加密文本-显示加密）
+  - 二者共用下列参数（**`argvs[9]`**～**`argvs[12]`**）：
+  - **`schemefieldLength`**（可选）：文本最大长度，写入 **`obj.schemefieldLength`**；**`argvs[9]`**；须为 **1～255** 的整数；不传默认 **`255`**
+  - **`masktype`**（可选）：掩码类型；**`argvs[10]`**；**`all`** 掩码全部；**`4`** 掩码后四位；**`card`** 卡号格式；**`custom`** 自定义；不传默认 **`all`**
+  - **`encrypttype`**（可选）：**`masktype`=`custom`** 时生效，自定义掩码规则；**`argvs[11]`**；参考 **`"{AAAA}{****}{AAAA}"`**；空则使用默认示例串
+  - **`maskcharacter`**（可选）：掩码字符；**`argvs[12]`**；**`*`** 或 **`X`**；不传默认 **`*`**
+- `LT`（地理定位）
+  - **`schemefieldLength`**（可选）：小数点**左侧**位数，写入 **`obj.schemefieldLength`**；**`argvs[9]`**；须为非负整数；不传默认 **`8`**（与默认 **`decimalPlaces`** 之和为 **18**，满足平台总位数上限）
+  - **`decimalPlaces`**（可选）：小数点**右侧**位数，写入 **`obj.decimalPlaces`**；**`argvs[10]`**；须为非负整数；不传默认 **`10`**
+  - **约束**：两者须为非负整数，且**之和不能大于 18**（与 **`P`** / **`C`** / **`N`** 精度规则一致）
+  - **`displayType`**（可选）：纬度与经度显示方式；**`argvs[11]`**；**`"1"`** 数字展示，**`"2"`** 度、分、秒；不传默认 **`"1"`**（写入顶层 **`displayType`**）
+- **仅公用 `helps` / `defaultValue`、无 `argvs[9]` 起专属参数的类型**：`D`、`F`、`T`、`H`、`A`、`AD` 等（**不含** **`IMG`** / **`FL`** / **`ENC`** / **`ENCD`** / **`LT`** 等已单列的类型；见上文各节）
+- `J`（文本区-长）
+  - 与 **`X`** 类似：多行文本；**`schemefieldLength`**（可选）为**最大字符数**；**`argvs[9]`**；须为 **1～32000** 的整数；不传默认 **`32000`**
+  - **`placeholder`**（可选）：输入区**提示信息**；**`argvs[10]`**
+  - **平台说明**：每个对象**最多 10 个** **`J`** 类型字段；条数由平台校验，**CLI 创建时不统计**，请在对象上自行控制数量
+- `X`（文本区）
+  - `schemefieldLength`（可选）：多行文本**最大字符数**；**`argvs[9]`**；须为 **1～4000** 的整数；不传默认 **`4000`**（与平台常见上限一致）
+  - `placeholder`（可选）：输入区**提示信息**；**`argvs[10]`**
+- `SCORE`（评分）
+  - `schemefieldLength`（可选）：**最大评分**，决定**星星图标显示个数**；**`argvs[9]`**；须为 **1～100** 的整数；不传默认 **`10`**
+- `E`（电子邮件）
+  - `isrepeat`（可选）：是否允许重复；**`argvs[9]`**；**`"true"`** 允许重复，**`"false"`** 不允许重复；不传默认 **`"true"`**
+- `B`（复选框）
+  - **`defaultValue`**（**`argvs[8]`**）：**仅** **`"0"`** 或 **`"1"`** —— **`"0"`** 表示默认**未选中**，**`"1"`** 表示默认**选中**；空或其它值按 **`"0"`** 处理
+- `L`（选项列表-单选）
+  - `ptext`（**`useGlobalSelect`=`"0"` 时必填**）：选项内容；**`argvs[9]`**；**格式**：多个选项用 **`\r\n`** 连接（勿用仅 `\n` 作为分隔）。**`useGlobalSelect`=`"1"`**（全局列表）时可为空字符串
+  - **`useGlobalSelect`**（可选）：是否使用全局选项列表；**`argvs[10]`**；**`"0"`** 不使用，**`"1"`** 使用；不传默认 **`"0"`**
+  - **`edittype`**（可选）：选择样式，写入 **`obj.edittype`**；**`argvs[11]`**；**`radio`** 单选框列表，**`select`** 单选下拉；不传默认 **`select`**
+  - **`isPicklistSorted`**（可选）：按字母顺序而非输入顺序排序；**`argvs[12]`**；**`"0"`** 否，**`"1"`** 是；不传默认 **`"0"`**
+  - **`defPl`**（可选）：将第一个值作为默认值；**`argvs[13]`**；**`"0"`** 否，**`"1"`** 是；不传默认 **`"0"`**
+  - **`globalSelectId`**：全局选项列表 id；**`argvs[14]`**。**`useGlobalSelect`=`"1"`** 时必填；为 **`"0"`** 时传 **`''`** 占位即可
+- `Q`（选项列表-多选）
+  - 与 **`L`** 相同的前缀参数：**`ptext`**、**`useGlobalSelect`**、**`edittype`**、**`isPicklistSorted`**、**`defPl`**、**`globalSelectId`**（**`argvs[9]`**～**`argvs[14]`**），含义与取值规则见上文 **「L（选项列表-单选）」**（**`useGlobalSelect`=`"0"`** 时 **`ptext`** 必填；**`"1"`** 时 **`globalSelectId`** 必填）
+  - **`visibleLines`**（可选）：下拉最多展示几行选项，写入 **`obj.visibleLines`**；**`argvs[15]`**；须为 **1～100** 的整数；不传默认 **`4`**
+  - **`showalloptions`**（可选）：是否显示所有选项，写入 **`obj.showalloptions`**；**`argvs[16]`**；**`"0"`** 否，**`"1"`** 是；不传默认 **`"0"`**
+- `Y`（查找关系）
+  - `lookupObj`（必填）：关联对象；**`argvs[9]`**
+  - **`lookupObjDefaultField`**（可选）：搜索辅助字段，写入 **`obj.lookupObjDefaultField`**；搜索时用于展示（如关联对象上用于显示的字段 API 名）；**`argvs[10]`**；不传或空字符串表示不指定
+- `MR`（查找多选）
+  - `lookupObj`（必填）：关联对象；**`argvs[9]`**
+- `M`（主详信息关系）
+  - `lookupObj`（必填）：关联对象；**`argvs[9]`**
+
+### 5.2 更新字段
+
+与 **创建** 共用同一套类型模板与请求体结构；**更新** 调用 **`/api/fieldSetup/saveField`**，**创建** 调用 **`/api/fieldSetup/save`**。更新时必须在请求体中设置 **`obj.id`** 为平台上的字段 ID，且 **不会** 自动绑定页面布局（不写入 `layoutIds`）。
+
+```bash
+cloudcc update fields <projectPath> <fieldId> <fieldType> <objid> <fieldLabel> <remark> [extraArg]
+```
 
-- 先确认对象存在且 `objid` 正确
-- 字段类型与业务含义保持一致（如日期、数字、文本）
-- 当前 CLI 会根据字段标签自动生成字段 API 名称
-- 如果字段依赖选项值或关联对象，创建前先准备好 `extraArg`
+- `fieldId`：平台字段 ID（`argvs[3]`），对应保存时的 `fieldData.obj.id`
+- 其余参数与 `create fields` 含义相同，但整体下标相对 **create** 后移一位：`fieldType` 为 `argvs[4]`，`objid` 为 `argvs[5]`，`fieldLabel` 为 `argvs[6]`，`remark` 为 `argvs[7]`；**`helps`** 为 **`argvs[8]`**、**`defaultValue`** 为 **`argvs[9]`**；各类型专属参数在 **create** 中为 **`argvs[9]`** 起，在 **update** 中为 **`argvs[10]`** 起（相对 **create** 一律 **`+1`**）
 
-### 4.2 支持的字段类型说明
+### 5.3 支持的字段类型说明
 
-根据 CloudCC 官方关于“对象-字段”的说明，平台层面支持文本、URL、百分比、币种、数字、文本区、长文本、富文本、电话、电子邮件、日期、日期/时间、评分、选项列表、图片、查找关系、主详信息关系、公式、自动编号、累计汇总、查找多选、复选框等类型。[CloudCC 帮助中心 - 标准对象 / 对象-字段](https://help.cloudcc.cn/product02/biao-zhun-dui-xiang/#3%E5%AF%B9%E8%B1%A1-%E5%AD%97%E6%AE%B5)
+根据 CloudCC 官方关于“对象-字段”的说明，平台层面支持文本、URL、百分比、币种、数字、文本区、长文本、富文本、电话、电子邮件、日期、日期/时间、评分、选项列表、图片、查找关系、主详信息关系、公式、自动编号、累计汇总、查找多选、复选框等类型。
 
 当前 `src/fields/fields` 中已实现的 CLI 字段类型如下。
 
+**说明**：下列类型在模板 **`obj`** 中带有固定的 **`schemefieldLength`** 默认值（与平台「最大长度」类属性对齐；未通过 CLI 覆盖时使用）：**`U`** `2000`，**`D`** / **`T`** `20`，**`F`** `30`，**`B`** `10`，**`H`** `15`，**`E`** `254`，**`IMG`** `255`，**`AD`** `500`；**`S`**、**`N`**、**`P`**、**`C`**、**`X`**、**`J`**、**`SCORE`** 等仍由各自字段逻辑或上文「字段特殊入参」定义。
+
 #### 基础输入类
 
 | CLI 类型编码 | 类型名称 | 说明 |
 | --- | --- | --- |
-| `S` | 文本 | 单行文本，默认长度 255 |
+| `S` | 文本 | 单行文本，默认长度 255（可通过 `schemefieldLength` 调整） |
 | `U` | URL | 输入有效网址，点击后可打开链接 |
-| `P` | 百分比 | 输入百分比数字 |
-| `C` | 币种 | 金额/币种场景，模板内部 `fdtype` 为 `c` |
+| `P` | 百分比 | 输入百分比数字；可通过 `schemefieldLength` / `decimalPlaces` 配置整数位与小数位 |
+| `C` | 币种 | 金额/币种场景，模板内部 `fdtype` 为 `c`；可通过 `schemefieldLength` / `decimalPlaces` 配置整数位与小数位（与 `P` 参数位一致） |
 | `N` | 数字 | 输入数值，适用于数量、金额基数等 |
 | `D` | 日期 | 仅日期 |
 | `T` | 时间 | 仅时间 |
 | `F` | 日期/时间 | 日期和时间组合 |
-| `B` | 复选框 | 布尔值，真/假 |
+| `B` | 复选框 | 默认值仅 `"0"` / `"1"`（未选中 / 选中），见上文 **「B（复选框）」** 专属说明 |
 | `H` | 电话 | 电话号码 |
-| `E` | 电子邮件 | 邮箱地址 |
-| `SCORE` | 评分 | 用于评分或评价场景 |
+| `E` | 电子邮件 | 邮箱地址；可选 `isrepeat`（`argvs[9]`），见上文 **「E（电子邮件）」** |
+| `SCORE` | 评分 | 最大评分 1～100（`schemefieldLength`，星星个数），见 **「SCORE（评分）」** |
 
 #### 文本区与内容类
 
 | CLI 类型编码 | 类型名称 | 说明 |
 | --- | --- | --- |
-| `X` | 文本区 | 多行文本，适合一般备注和说明 |
-| `J` | 文本区（长） | 长文本，模板默认长度 10000 |
+| `X` | 文本区 | 多行文本，最多 4000 字符（`schemefieldLength`），见 **「X（文本区）」** |
+| `J` | 文本区（长） | 多行长文本，最多 32000 字符；每对象最多 10 个 `J` 字段（平台限制），见 **「J（文本区-长）」** |
 | `A` | 文本区（富文本） | 支持富文本内容、图文描述 |
-| `IMG` | 图片 | 图片类字段 |
-| `FL` | 文件 | 文件类字段 |
+| `IMG` | 图片 | 上传数量见 **`defaultValue`**（`argvs[8]`），可选 **`formulaType`** / **`watermarkstatus`**（`argvs[9]` / `argvs[10]`），见上文 **「IMG（图片）」** |
+| `FL` | 文件 | 可上传文件数量见 **`defaultValue`**（`argvs[8]`），与 **`isrepeat`** 同步为同一数值，见上文 **「FL（文件）」** |
 
 #### 选择类
 
 | CLI 类型编码 | 类型名称 | 说明 |
 | --- | --- | --- |
-| `L` | 选项列表 | 单选下拉 |
-| `Q` | 选项列表（多选） | 多选下拉 |
+| `L` | 选项列表 | 单选；**`ptext`** / **`useGlobalSelect`** / **`edittype`**（radio·select）等见上文 **「L（选项列表-单选）」** |
+| `Q` | 选项列表（多选） | 与 **`L`** 类似的全局/排序等 + **`visibleLines`** / **`showalloptions`**，见 **「Q（选项列表-多选）」** |
 
-这两类字段创建时都需要额外的选项值参数：
+**`L`**、**`Q`** 在 **`ptext`** 之后还可带可选参数：**`L`** 为 **`argvs[10..14]`**；**`Q`** 为 **`argvs[10..16]`**（在 **`L`** 的基础上多 **`visibleLines`**、**`showalloptions`**），详见上文 **「L」** / **「Q」** 小节。
 
 ```bash
-cloudcc create fields <projectPath> L <objid> <fieldLabel> <ptext>
-cloudcc create fields <projectPath> Q <objid> <fieldLabel> <ptext>
+cloudcc create fields <projectPath> L <objid> <fieldLabel> <remark> [helps] [defaultValue] <ptext> [useGlobalSelect] [edittype] [isPicklistSorted] [defPl] [globalSelectId]
+cloudcc create fields <projectPath> Q <objid> <fieldLabel> <remark> [helps] [defaultValue] <ptext> [useGlobalSelect] [edittype] [isPicklistSorted] [defPl] [globalSelectId] [visibleLines] [showalloptions]
 ```
 
-其中 `ptext` 表示选项内容，通常用于传入候选值集合。
+其中 **`helps`**、**`defaultValue`** 在 **`argvs[7]`**、**`argvs[8]`**，**`ptext`** 在 **`argvs[9]`**（若不需要帮助或默认值，可用 **`''`** 占位）。**`L` / `Q`** 在 **`useGlobalSelect`=`"0"`** 时 **`ptext`** 必填；**`useGlobalSelect`=`"1"`** 时 **`ptext`** 可为 **`''`**，但 **`globalSelectId`**（**`argvs[14]`**）必填。**`L` / `Q` 的 `ptext` 格式要求**（本地列表）：多个选项之间必须使用 **`\r\n`（CRLF）** 换行连接，逻辑上等价于字符串 `"a\r\nb\r\nc"`（一行一个选项）。在 Shell 中可用 `$'a\r\nb\r\nc'` 等形式传入真实回车换行序列。若要向 **`argvs[10]`**（**`L`/`Q`** 专属参数）及之后某槽位传值而保留更前面槽位的默认，中间未用的槽位须用 **`''`** 占位（与 **`S`** 等类型相同约定）。
 
 平台层面的选项列表能力常用于：
 
@@ -137,19 +261,19 @@ cloudcc create fields <projectPath> Q <objid> <fieldLabel> <ptext>
 
 | CLI 类型编码 | 类型名称 | 说明 |
 | --- | --- | --- |
-| `Y` | 查找关系 | 关联另一个对象 |
+| `Y` | 查找关系 | 关联另一个对象；可选 **`lookupObjDefaultField`**（`argvs[10]`），见 **「Y（查找关系）」** |
 | `MR` | 查找多选 | 多选关联对象 |
 | `M` | 主详信息关系 | 主从/主详关系字段 |
 
 这三类字段创建时都需要额外传入目标对象参数：
 
 ```bash
-cloudcc create fields <projectPath> Y <objid> <fieldLabel> <lookupObj>
-cloudcc create fields <projectPath> MR <objid> <fieldLabel> <lookupObj>
-cloudcc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
+cloudcc create fields <projectPath> Y <objid> <fieldLabel> <remark> [helps] [defaultValue] <lookupObj> [lookupObjDefaultField]
+cloudcc create fields <projectPath> MR <objid> <fieldLabel> <remark> [helps] [defaultValue] <lookupObj>
+cloudcc create fields <projectPath> M <objid> <fieldLabel> <remark> [helps] [defaultValue] <lookupObj>
 ```
 
-其中 `lookupObj` 表示被关联对象。
+其中 **`helps`**、**`defaultValue`** 在 **`argvs[7]`**、**`argvs[8]`**，**`lookupObj`** 在 **`argvs[9]`**。`lookupObj` 表示被关联对象。**仅 `Y`** 还可选 **`lookupObjDefaultField`**（**`argvs[10]`**；不需要时可传 **`''`**）。
 
 这类字段常用于：
 
@@ -163,14 +287,14 @@ cloudcc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
 | CLI 类型编码 | 类型名称 | 说明 |
 | --- | --- | --- |
 | `AD` | 地址 | 地址复合字段 |
-| `LT` | 地理定位 | 地理坐标或定位信息 |
+| `LT` | 地理定位 | **`schemefieldLength`** / **`decimalPlaces`** / **`displayType`**（`argvs[9..11]`），见 **「LT」** |
 
 #### 安全与加密类
 
 | CLI 类型编码 | 类型名称 | 说明 |
 | --- | --- | --- |
-| `ENC` | 加密文本（存储加密） | 底层存储加密 |
-| `ENCD` | 加密文本（显示加密） | 展示时掩码加密 |
+| `ENC` | 加密文本（存储加密） | 与 **`ENCD`** 相同的 **`argvs[9..12]`**（长度·掩码），见 **「ENC / ENCD」** |
+| `ENCD` | 加密文本（显示加密） | 与 **`ENC`** 相同的 **`argvs[9..12]`**，见 **「ENC / ENCD」** |
 
 说明：
 
@@ -179,7 +303,7 @@ cloudcc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
 - `C` 在模板内部对应的 `fdtype` 为小写 `c`
 - 这两类字段更适合身份证号、银行卡号、敏感联系方式等场景
 
-### 4.3 当前 CLI 未覆盖但平台支持的字段能力
+### 5.4 当前 CLI 未覆盖但平台支持的字段能力
 
 根据官方文档，平台层面还支持以下字段能力，但当前 `src/fields/fields` 目录下尚未看到对应 CLI 创建模板：
 
@@ -191,9 +315,9 @@ cloudcc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
 
 ---
 
-## 5. 删除字段
+## 6. 删除字段
 
-### 5.1 基本命令
+### 6.1 基本命令
 
 ```bash
 cloudcc delete fields <projectPath> <fieldId> <objid>
@@ -207,7 +331,7 @@ cloudcc delete fields <projectPath> <fieldId> <objid>
 
 ---
 
-## 6. 开发前检查
+## 7. 开发前检查
 
 - 已完成 `cloudcc doc project devguide` 中的环境准备
 - 项目根目录存在可用的 `cloudcc-cli.config.js`
@@ -216,7 +340,7 @@ cloudcc delete fields <projectPath> <fieldId> <objid>
 
 ---
 
-## 7. 常见实践建议
+## 8. 常见实践建议
 
 - 优先先做对象建模，再补字段明细，避免频繁返工
 - 字段命名规范化（显示名称清晰、API 名称可维护）

package/src/fields/docs/introduction.md

@@ -40,7 +40,9 @@ CloudCC 对象上的字段通常分为两类：
 `fields` 模块用于围绕对象管理字段，当前支持：
 
 - 查询对象字段（标准字段 + 自定义字段）
+- 查询字段详情
 - 创建字段
+- 更新字段（需字段 ID）
 - 删除字段
 
 可通过以下命令读取文档：

package/src/fields/fields/A.js

@@ -1,7 +1,7 @@
 /**
  * 文本区（富文本）字段(A)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps = "", defaultValue = "", profileList) {
     return {
         "objid": objid,
         "obj": {
@@ -10,7 +10,8 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "apiname": apiname,
             "schemefieldLength": "255",
             "remark": "",
-            "helps": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "A:文本区（富文本）",
         "fdtype": "A",

package/src/fields/fields/AD.js

@@ -1,7 +1,7 @@
 /**
  * 地址字段(AD)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps = "", defaultValue = "", profileList) {
     return {
         "objid": objid,
         "obj": {
@@ -9,7 +9,9 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "schemefieldLength": "500",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "AD:地址",
         "fdtype": "AD",