cloudcc-cli 2.3.7 → 2.3.9

package/src/fields/fields/Q.js

@@ -1,35 +1,65 @@
 /**
- * 选项列表（多选）字段(Q)配置模板
+ * 选项列表（多选）字段(Q)配置模板（与 `L` 类似，另含 `visibleLines`、`showalloptions`）
+ * @param {string} useGlobalSelect 是否使用全局选项列表：`"0"` 否，`"1"` 是
+ * @param {string} edittype 选择样式，写入 `obj.edittype`：`radio` 或 `select`（多选常见为 `select`）
+ * @param {string} isPicklistSorted 是否按字母排序：`"0"` 否，`"1"` 是
+ * @param {string} defPl 是否将第一个值作为默认值：`"0"` 否，`"1"` 是
+ * @param {string} globalSelectId 全局选项列表 id（`useGlobalSelect` 为 `"1"` 时使用）
+ * @param {string} visibleLines 下拉最多展示几行选项，写入 `obj.visibleLines`
+ * @param {string} showalloptions 是否显示所有选项：`"0"` 否，`"1"` 是，写入 `obj.showalloptions`
  */
-module.exports = function (objid, nameLabel, apiname, ptext, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    ptext,
+    helps = "",
+    defaultValue = "",
+    profileList,
+    useGlobalSelect = "0",
+    edittype = "select",
+    isPicklistSorted = "0",
+    defPl = "0",
+    globalSelectId = "",
+    visibleLines = "4",
+    showalloptions = "0"
+) {
+    const ugs = useGlobalSelect === "1" ? "1" : "0";
+    const et = edittype === "radio" ? "radio" : "select";
+    const sorted = isPicklistSorted === "1" ? "1" : "0";
+    const dp = defPl === "1" ? "1" : "0";
+    const gid = ugs === "1" ? String(globalSelectId || "").trim() : "";
+    const vl = String(visibleLines || "4").trim() || "4";
+    const sao = showalloptions === "1" ? "1" : "0";
     return {
-        "objid": objid,
         "obj": {
             "id": "",
             "nameLabel": nameLabel,
             "apiname": apiname,
             "schemefieldLength": "255",
-            "edittype": "select",
-            "visibleLines": "4",
-            "showalloptions": "0",
+            "edittype": et,
+            "visibleLines": vl,
+            "showalloptions": sao,
             "renderstyle": "1",
             "remark": "",
-            "helps": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
+        "objid": objid,
         "dtype": "Q:选项列表（多选）",
         "fdtype": "Q",
         "ischecked": "false",
-        "useGlobalSelect": "0",
-        "globalSelectId": "province",
+        "useGlobalSelect": ugs,
+        "globalSelectId": gid,
         "ptext": ptext,
-        "isPicklistSorted": "0",
-        "defPl": "1",
+        "isPicklistSorted": sorted,
+        "defPl": dp,
         "iscover": "",
         "formulaText": "",
         "profileFieldJson": profileList.map(profile => ({
             "profileId": profile.id,
             "visible": "true",
             "readonly": "false"
-        })),
+        }))
     }
 }

package/src/fields/fields/S.js

@@ -1,7 +1,19 @@
 /**
  * 文本字段(S)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    schemefieldLength,
+    helps,
+    isrepeat,
+    casesensitive,
+    placeholder,
+    defaultValue,
+    profileList
+) {
+    const length = schemefieldLength ? String(schemefieldLength) : "255";
     return {
         "objid": objid,
         "obj": {
@@ -9,12 +21,12 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": "",
-            "schemefieldLength": "255",
-            "isrepeat": "true",
-            "casesensitive": "",
-            "placeholder": "",
-            "defaultValue": ""
+            "helps": helps ? String(helps) : "",
+            "schemefieldLength": length,
+            "isrepeat": isrepeat !== undefined ? String(isrepeat) : "true",
+            "casesensitive": casesensitive ? String(casesensitive) : "",
+            "placeholder": placeholder ? String(placeholder) : "",
+            "defaultValue": defaultValue ? String(defaultValue) : ""
         },
         "dtype": "S:文本",
         "fdtype": "S",

package/src/fields/fields/SCORE.js

@@ -1,7 +1,12 @@
 /**
  * 评分字段(SCORE)配置模板
+ * schemefieldLength：最大评分，控制星星图标个数；平台允许 1～100，默认 10
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps = "", defaultValue = "", schemefieldLength = "10", profileList) {
+    const len =
+        schemefieldLength !== undefined && schemefieldLength !== null && String(schemefieldLength).trim() !== ""
+            ? String(schemefieldLength).trim()
+            : "10";
     return {
         "objid": objid,
         "obj": {
@@ -9,9 +14,9 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": "",
-            "schemefieldLength": "10",
-            "defaultValue": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "schemefieldLength": len,
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "SCORE:评分",
         "fdtype": "SCORE",

package/src/fields/fields/T.js

@@ -1,17 +1,17 @@
 /**
  * 时间字段(T)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps = "", defaultValue = "", profileList) {
     return {
         "objid": objid,
         "obj": {
             "id": "",
             "nameLabel": nameLabel,
             "apiname": apiname,
-            "schemefieldLength": "255",
             "remark": "",
-            "helps": "",
-            "defaultValue": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "schemefieldLength": "20",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "T:时间",
         "fdtype": "T",

package/src/fields/fields/U.js

@@ -1,18 +1,31 @@
 /**
  * URL字段(U)配置模板
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (objid, nameLabel, apiname, helps, edittype, defaultValue, profileList) {
+    const openMode = edittype && String(edittype).trim() !== ""
+        ? String(edittype).trim()
+        : "_blank";
+    const safeEdittype = openMode === "_self" ? "_self" : "_blank";
     return {
+        // 对象ID
         "objid": objid,
         "obj": {
+            // 字段ID
             "id": "",
+            // 字段名称
             "nameLabel": nameLabel,
+            // 字段API名称
             "apiname": apiname,
+            // 字段备注
             "remark": "",
-            "helps": "",
-            "edittype": "_blank",
-            "schemefieldLength": "255",
-            "defaultValue": ""
+            // 字段帮助
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            // 最大输入长度（字符）
+            "schemefieldLength": "2000",
+            // URL打开方式: _blank 新窗口打开, _self 当前窗口打开
+            "edittype": safeEdittype,
+            // 默认值
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : ""
         },
         "dtype": "U:URL",
         "fdtype": "U",

package/src/fields/fields/X.js

@@ -1,7 +1,21 @@
 /**
- * 文本区字段(X)配置模板
+ * 文本区字段(X)配置模板（多行文本，schemefieldLength 为最大字符数，常见上限 4000）
  */
-module.exports = function (objid, nameLabel, apiname, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    helps = "",
+    defaultValue = "",
+    schemefieldLength = "4000",
+    placeholder = "",
+    profileList
+) {
+    const len =
+        schemefieldLength !== undefined && schemefieldLength !== null && String(schemefieldLength).trim() !== ""
+            ? String(schemefieldLength).trim()
+            : "4000";
+    const ph = placeholder !== undefined && placeholder !== null ? String(placeholder) : "";
     return {
         "objid": objid,
         "obj": {
@@ -9,10 +23,10 @@ module.exports = function (objid, nameLabel, apiname, profileList) {
             "nameLabel": nameLabel,
             "apiname": apiname,
             "remark": "",
-            "helps": "",
-            "defaultValue": "",
-            "schemefieldLength": "255",
-            "placeholder": ""
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
+            "defaultValue": defaultValue !== undefined && defaultValue !== null ? String(defaultValue) : "",
+            "schemefieldLength": len,
+            "placeholder": ph
         },
         "dtype": "X",
         "fdtype": "X",

package/src/fields/fields/Y.js

@@ -1,7 +1,21 @@
 /**
  * 查找关系字段(Y)配置模板
+ * @param {string} lookupObjDefaultField 搜索辅助字段（`obj.lookupObjDefaultField`）；搜索时用于展示，可为 API 名字段等
  */
-module.exports = function (objid, nameLabel, apiname, lookupObj, profileList) {
+module.exports = function (
+    objid,
+    nameLabel,
+    apiname,
+    lookupObj,
+    helps = "",
+    defaultValue = "",
+    profileList,
+    lookupObjDefaultField = ""
+) {
+    const ldf =
+        lookupObjDefaultField !== undefined && lookupObjDefaultField !== null
+            ? String(lookupObjDefaultField).trim()
+            : "";
     return {
         "objid": objid,
         "obj": {
@@ -10,11 +24,10 @@ module.exports = function (objid, nameLabel, apiname, lookupObj, profileList) {
             "apiname": apiname,
             "schemefieldLength": "255",
             "remark": "",
-            "helps": "",
+            "helps": helps !== undefined && helps !== null ? String(helps) : "",
             "lookupObj": lookupObj,
-            "defaultValue": "",
             "childrelationName": nameLabel,
-            "lookupObjDefaultField": ""
+            "lookupObjDefaultField": ldf
         },
         "dtype": "Y:查找关系",
         "fdtype": "Y",

package/src/fields/index.js

@@ -1,6 +1,8 @@
 const cc = {}
 cc.get = require("./get")
+cc.detail = require("./detail")
 cc.create = require("./create")
+cc.update = require("./update")
 cc.delete = require("./delete")
 cc.doc = require("./doc")
 

package/src/fields/update.js

@@ -0,0 +1,148 @@
+const fs = require("fs");
+const path = require("path");
+const { postClass } = require("../../utils/http")
+const { getPackageJson } = require("../../utils/config");
+const chalk = require('chalk')
+const { buildFieldData } = require("./buildFieldData");
+
+/**
+ * 在 object/custom-objects 与 object/standard-objects 中按对象 id 查找 objprefix（供 queryField 使用）
+ */
+function findObjPrefixForObjId(projectPath, objid) {
+    if (!objid || String(objid).trim() === "") return null;
+    const roots = [
+        path.join(path.resolve(projectPath), "object/custom-objects"),
+        path.join(path.resolve(projectPath), "object/standard-objects"),
+    ];
+    for (const dir of roots) {
+        if (!fs.existsSync(dir)) continue;
+        let files;
+        try {
+            files = fs.readdirSync(dir);
+        } catch (_) {
+            continue;
+        }
+        for (const f of files) {
+            if (!f.endsWith(".json")) continue;
+            const fp = path.join(dir, f);
+            try {
+                const j = JSON.parse(fs.readFileSync(fp, "utf8"));
+                if (j && j.id === objid && j.objprefix) return String(j.objprefix).trim();
+            } catch (_) {}
+        }
+    }
+    return null;
+}
+
+/**
+ * saveField 需要与平台上已有字段一致的元数据（如 datafieldRef、schemetableId）。
+ * 在发起 saveField 前，用 queryField 拉取当前字段并合并进 payload。
+ */
+async function mergeUpdatePayloadFromServer(config, projectPath, fieldId, objid, fieldData) {
+    const prefix = findObjPrefixForObjId(projectPath, objid);
+    if (!prefix) {
+        console.error(
+            chalk.yellow(
+                "⚠ cloudcc update fields: 未在 object/custom-objects 或 object/standard-objects 中找到 objid=" +
+                    objid +
+                    " 的 objprefix；请先执行 cloudcc get object 同步对象清单后再试。"
+            )
+        );
+        if (fieldData.obj) fieldData.obj.schemetableId = String(objid).trim();
+        return;
+    }
+    const res = await postClass(
+        config.setupSvc + "/api/fieldSetup/queryField",
+        { prefix },
+        config.accessToken
+    );
+    if (!res || !res.result || !res.data) return;
+    const pool = [...(res.data.stdFields || []), ...(res.data.cusFields || [])];
+    const raw = pool.find((f) => f && f.id === fieldId);
+    if (!fieldData.obj) return;
+    fieldData.obj.schemetableId = String(objid).trim();
+    if (raw && raw.datafieldRef) fieldData.obj.datafieldRef = String(raw.datafieldRef);
+    if (raw && (raw.schemefieldName || raw.apiname)) {
+        fieldData.obj.apiname = String(raw.schemefieldName || raw.apiname);
+    }
+    if (raw && Array.isArray(raw.profileFieldJson) && raw.profileFieldJson.length > 0) {
+        fieldData.profileFieldJson = raw.profileFieldJson;
+    }
+    if (fieldData.layoutIds === undefined) fieldData.layoutIds = "";
+}
+
+/**
+ * create 使用 save，简档为 profileId + visible + readonly；saveField 需 profileid + permission。
+ */
+function normalizeProfileFieldJsonForSaveField(fieldData) {
+    if (!fieldData || !Array.isArray(fieldData.profileFieldJson)) return;
+    fieldData.profileFieldJson = fieldData.profileFieldJson
+        .map((row) => {
+            const pid = row.profileid || row.profileId;
+            if (!pid) return null;
+            if (row.permission != null && String(row.permission) !== "") {
+                return { profileid: String(pid), permission: String(row.permission) };
+            }
+            return { profileid: String(pid), permission: "1,0" };
+        })
+        .filter(Boolean);
+}
+
+/**
+ * 更新字段（与 create 共用同一套 payload 与类型分支；区别在于必须设置 `obj.id` 为字段 ID，且不请求 layout 绑定）
+ * @param {Array} argvs - 命令行参数数组
+ * @param {string} argvs[2] projectPath
+ * @param {string} argvs[3] fieldId（平台字段 id）
+ * @param {string} argvs[4] fieldType
+ * @param {string} argvs[5] objid
+ * @param {string} argvs[6] nameLabel
+ * @param {string} argvs[7] remark（与 create 相比各类型可选参数整体下标 +1）
+ * @returns {Promise<boolean>}
+ */
+async function update(argvs) {
+    try {
+        let projectPath = argvs[2];
+        const fieldId = argvs[3];
+        if (!fieldId || String(fieldId).trim() === "") {
+            throw new Error("Missing field id: argvs[3] (field id from platform)");
+        }
+        const config = await getPackageJson(projectPath);
+        let nameLabel = argvs[6];
+        let remarkText = argvs[7];
+        if (!remarkText) remarkText = "auto created by cloudcc-cli ai agent";
+        console.error(chalk.blue('\nUpdating field ' + nameLabel + ' (id=' + fieldId + ')...'));
+        let fieldData = await buildFieldData(argvs, { shift: 1 });
+        if (!fieldData) {
+            throw new Error("Unsupported or unknown fieldType for update");
+        }
+        if (fieldData.obj) fieldData.obj.id = String(fieldId).trim();
+        if (fieldData && fieldData.obj) fieldData.obj.remark = remarkText;
+        if (fieldData) fieldData.remark = remarkText;
+
+        const objid = argvs[5];
+        await mergeUpdatePayloadFromServer(config, projectPath, fieldId, objid, fieldData);
+        normalizeProfileFieldJsonForSaveField(fieldData);
+
+        const result = await postClass(
+            config.setupSvc + "/api/fieldSetup/saveField",
+            fieldData,
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            const okId = result.data && (typeof result.data === "string" || typeof result.data === "number")
+                ? result.data
+                : (result.data && result.data.id) || fieldId;
+            console.error(chalk.green('✓ Field updated successfully! ID: ' + okId));
+            return true;
+        } else {
+            console.error(chalk.yellow('⚠ Field update completed with warnings: ' + (result && result.returnInfo)));
+            return false;
+        }
+    } catch (error) {
+        console.error(chalk.red("Failed to update field: "), error.message || error);
+        return false;
+    }
+}
+
+module.exports = update;

package/test/fields.cli.test.js

@@ -21,6 +21,7 @@ test("字段管理流程：获取对象列表→create 字段→get 字段列表
   let objId = null;
   let objName = null;
   const fieldLabel = `AutoField_${Date.now()}`;
+  const fieldRemark = `AutoFieldRemark_${Date.now()}`;
   let fieldId = null;
 
   t.test("1) 获取对象列表（取第一个对象的 id 和 objprefix）", async () => {
@@ -45,7 +46,8 @@ test("字段管理流程：获取对象列表→create 字段→get 字段列表
   t.test("2) create 创建一个文本字段（S）", async () => {
     assert.ok(objId, "需要对象 id");
     // create fields 调用约定：cloudcc create fields <path> <fieldType> <objid> <nameLabel> [...]
-    const { stdout, stderr } = await runCc(["create", "fields", repoRoot, "S", objId, fieldLabel]);
+    // 统一规则：argvs[6] 作为 remark
+    const { stdout, stderr } = await runCc(["create", "fields", repoRoot, "S", objId, fieldLabel, fieldRemark]);
     // create fields 会通过 console.error 输出创建结果（见 src/fields/create.js）
     assert.match(
       `${stdout}\n${stderr}`,

package/utils/config.js

@@ -1,5 +1,6 @@
 const fs = require("fs");
 const path = require("path");
+const chalk = require("chalk");
 // 引入解密函数
 const { getDevConsoleConfig, decryptCloudCCDevInfo } = require("./utils");
 const { readCache } = require("./cache")
@@ -54,6 +55,14 @@ async function getPackageJson3(projectPath = process.cwd()) {
             config = { ...decryptedInfo, ...config }
             config.CloudCCDev = "";
             config = await getDevConsoleConfig(projectPath, config)
+        } else {
+            console.error(
+                chalk.yellow(
+                    "cloudcc-cli: CloudCCDev could not be decrypted or is empty (invalid base64/JSON). " +
+                        "Fix cloudcc-cli.config.js or use explicit fields / v2-style config; falling back to other config sources."
+                )
+            );
+            return null;
         }
     } else {
         config = null;

package/utils/utils.js

@@ -164,13 +164,20 @@ async function getDevConsoleConfig(projectPath = process.cwd(), config) {
     }
   */
 function decryptCloudCCDevInfo(encryptedData) {
+    if (encryptedData == null || typeof encryptedData !== "string" || !String(encryptedData).trim()) {
+        return null;
+    }
     try {
-        const binaryData = new Uint8Array(Buffer.from(encryptedData, 'base64'));
+        const binaryData = new Uint8Array(Buffer.from(encryptedData, "base64"));
         const decoder = new TextDecoder();
-        const jsonString = decoder.decode(binaryData);
-        return JSON.parse(jsonString);
-    } catch (error) {
-        console.error(error);
+        const jsonString = decoder.decode(binaryData).trim();
+        if (!jsonString) {
+            return null;
+        }
+        const parsed = JSON.parse(jsonString);
+        return typeof parsed === "object" && parsed !== null ? parsed : null;
+    } catch (_e) {
+        // Invalid base64, truncated blob, or non-JSON — typical when CloudCCDev is missing / placeholder
         return null;
     }
 }

package/.cursor/skills/cloudcc-dev-skill/SKILL.md

@@ -1,71 +0,0 @@
----
-name: cloudcc-dev-skill
-description: CloudCC CRM 二次开发设计，实现工具 。用于在设计方案和实际开发时使用，优先通过各模块的 `cloudcc doc <module> introduction` 与 `cloudcc doc <module> devguide` 获取文档。用户提到 CloudCC、cloudcc-cli、`cloudcc doc`、模块文档、设计方案、开发文档、项目初始化、开发环境、对象、字段、菜单、应用、类、定时类、触发器、自定义组件、自定义页面、自定义设置、客户端脚本、静态资源 时应优先使用。
----
-
-# CloudCC CLI skill
-
-- 使用前必须检查npm全局包，是否安装了cloudcc-cli ，如果没有，那么先全局安装 npm
-  i -g cloudcc-cli@latest
-
-## 模块命令
-
-### 基础与环境
-
-- 开发环境设置：`cloudcc doc project introduction`、`cloudcc doc project devguide`
-- 开发环境密钥配置：`cloudcc doc config devguide`
-
-### 元数据与模型设计
-
-- 对象：`cloudcc doc object introduction`、`cloudcc doc object devguide`
-- 对象字段：`cloudcc doc fields introduction`、`cloudcc doc fields devguide`
-- 对象记录类型：`cloudcc doc recordType introduction`、`cloudcc doc recordType devguide`
-- 全局选项列表：`cloudcc doc globalSelectList introduction`、`cloudcc doc globalSelectList devguide`
-
-### 权限与组织管理
-
-- 用户：`cloudcc doc user introduction`、`cloudcc doc user devguide`
-- 角色：`cloudcc doc role introduction`、`cloudcc doc role devguide`
-- 简档：`cloudcc doc profile introduction`、`cloudcc doc profile devguide`
-
-### 业务扩展（后端）
-
-- 后端类：`cloudcc doc classes introduction`、`cloudcc doc classes devguide`
-- 触发器：`cloudcc doc triggers introduction`、`cloudcc doc triggers devguide`
-- 定时类：`cloudcc doc timer introduction`、`cloudcc doc timer devguide`
-- 定时作业：`cloudcc doc scheduleJob introduction`、`cloudcc doc scheduleJob devguide`
-
-### 业务扩展（前端）
-
-- 自定义组件：`cloudcc doc plugin introduction`、`cloudcc doc plugin devguide`
-- 自定义页面：`cloudcc doc customPage introduction`、`cloudcc doc customPage devguide`
-- 客户端脚本：`cloudcc doc script introduction`、`cloudcc doc script devguide`
-- 静态资源：`cloudcc doc staticResource introduction`、`cloudcc doc staticResource devguide`
-
-### 平台配置与导航
-
-- 菜单：`cloudcc doc menu introduction`、`cloudcc doc menu devguide`
-- 应用：`cloudcc doc application introduction`、`cloudcc doc application devguide`
-- 自定义设置：`cloudcc doc customSetting introduction`、`cloudcc doc customSetting devguide`
-
-## 使用场景
-
-### 1. 快速了解CloudCC CRM每个模块的定义信息
-
-- 比如做方案设计、实现设计、模块选型时，优先调用每个模块的`introduction`文档。
-- 命令格式：`cloudcc doc <module> introduction`
-- 目标：先理解模块定位、适用场景、能力边界。
-
-### 2. 要了解某个CloudCC CRM 环境状态
-
-- 先创建模版项目`cloudcc create project demo`
-- 配置开发者密钥
-- 调用每个模块的 `devguide`
-  文档，命令格式：`cloudcc doc <module> devguide`，了解如何查询系统数据
-
-### 3. 要进行二开实施
-
-- 先创建模版项目`cloudcc create project demo`
-- 配置开发者密钥
-- 调用每个模块的 `devguide`
-  文档，命令格式：`cloudcc doc <module> devguide`，了解如何创建，修改数据