cloudcc-cli 2.3.9 → 2.4.1

package/src/jsp/split.js

@@ -0,0 +1,17 @@
+const { splitJspToCloudcc, parseCliJsonArg } = require("./migration")
+
+async function split(argvs) {
+  const params = parseCliJsonArg(
+    argvs[2],
+    "cloudcc split jsp <encodeURI(JSON.stringify(params))>"
+  )
+  const result = await splitJspToCloudcc(params)
+  if (!result.success) {
+    throw new Error(result.text)
+  }
+
+  console.log(result.text)
+  return result.text
+}
+
+module.exports = split

package/src/object/create.js

@@ -5,32 +5,58 @@ const { labelToSlug } = require("../../utils/utils");
 const chalk = require('chalk')
 
 /**
- * 将 label 转换为英文可用的 slug，用于生成 schemetableName
- * 优先尝试使用 pinyin 包（如果安装），否则使用宽松的 ASCII slug 方案
+ * 未显式传入备注时，根据对象标签生成默认业务功能说明（写入接口 remark）
+ * @param {string} label
  */
-// labelToSlug now lives in utils/utils.js
-
+function defaultObjectRemark(label) {
+    return `用于管理与「${label}」相关的业务数据`;
+}
 
 /**
- * 保存自定义对象按钮配置
+ * 创建自定义对象（接口 obj.remark：默认业务说明 + 必填业务功能描述，拼在后面）
  * @param {Array} argvs - 命令行参数数组
  * @returns {Promise<Object>} 保存结果
  */
 async function create(argvs) {
     try {
         let path = argvs[2];
-        // 兼容两种调用方式：
-        // 1) cloudcc object create <path> <nameLabel> <label>
-        // 2) cloudcc object create <path> <label>               (此时自动生成 nameLabel)
         let label = argvs[3];
         let nameLabel = argvs[4];
+        let remarkSuffix = argvs[5];
+
+        if (remarkSuffix == null) {
+            remarkSuffix = nameLabel;
+            nameLabel = undefined;
+        }
+
+        if (remarkSuffix == null || String(remarkSuffix).trim() === "") {
+            console.error();
+            console.error(chalk.red("Error: 缺少必需参数「业务功能描述」"));
+            console.error(
+                chalk.gray(
+                    "用法: cloudcc create object <path> <label> <业务功能描述>"
+                )
+            );
+            console.error(
+                chalk.gray(
+                    "      cloudcc create object <path> <label> <nameLabel> <业务功能描述>"
+                )
+            );
+            console.error();
+            throw new Error("缺少业务功能描述");
+        }
+
         if (nameLabel == undefined) {
             const slug = labelToSlug(label);
             nameLabel = `${slug}_custom_object`;
         }
+
+        const base = defaultObjectRemark(label);
+        const remark = `${base} ${String(remarkSuffix).trim()}`;
+
         let config = await getPackageJson(path);
 
-        // 从 brief/get 获取角色ID列表（仍使用原始 argv 参数： path 位于 argvs[2]）
+        // 从 brief/get 获取角色ID列表（path 位于 argvs[2]）
         // 注意：brief/get 的接口返回是 { success, data } 的格式
         let briefData = await briefGet(argvs);
 
@@ -68,7 +94,7 @@ async function create(argvs) {
                 isquickcreated: "false",
                 islbs: "false",
                 isreportcreated: "false",
-                remark: "auto created by cloudcc-cli ai agent"
+                remark
             }
         };
 

package/src/object/docs/devguide.md

@@ -17,7 +17,8 @@ cloudcc doc object devguide
 
 ```bash
 cloudcc get object <projectPath> [type]
-cloudcc create object <projectPath> <label> [nameLabel]
+cloudcc create object <projectPath> <label> <业务功能描述>
+cloudcc create object <projectPath> <label> <nameLabel> <业务功能描述>
 cloudcc delete object <projectPath> <objid>
 ```
 
@@ -25,7 +26,8 @@ cloudcc delete object <projectPath> <objid>
 
 - `projectPath`：本地项目路径，用于读取 `cloudcc-cli.config.js`
 - `label`：对象中文名称或展示名称
-- `nameLabel`：对象 API 名称；不传时会基于 `label` 自动生成
+- `nameLabel`：对象 API 名称；仅在上一种四参数形式中传入；不传（三参数形式）时基于 `label` 自动生成
+- `业务功能描述`（**必填**，放在最后）：拼接到默认 remark「用于管理与「label」相关的业务数据」之后，整体写入 `obj.remark`
 - `objid`：对象 ID
 
 ---
@@ -59,7 +61,8 @@ cloudcc get object <projectPath> custom
 ### 4.1 基本命令
 
 ```bash
-cloudcc create object <projectPath> <label>
+cloudcc create object <projectPath> <label> "记录客户拜访与跟进计划"
+cloudcc create object <projectPath> <label> <nameLabel> "主数据：客户主档"
 ```
 
 

package/src/project/docs/devguide.md

@@ -155,7 +155,7 @@ cd ~/Documents
 cloudcc create project demo1
 ```
 
-`demo1` 为示例项目名，可按需替换。
+`demo1` 为示例项目名，可按需替换，写入.表示在当前目录创建
 
 ### 6.2 安装依赖并启动
 

package/src/script/docs/devguide.md

@@ -55,9 +55,12 @@ cloudcc get script <encodedCondJson> <projectPath>
 | condition | object | 非必须 | `{}` | 查询条件 |
 | condition.scriptName | string | 非必须 | `""` | 脚本名称筛选 |
 | condition.pageLabel | string | 非必须 | `""` | 页面标签筛选 |
-| condition.objName | string | 非必须 | `""` | 对象名称筛选 |
+| condition.objName | string | 非必须 | `""` | 对象名称label筛选（例如你说“客户对象”，就传 `客户`；不要让 AI 自动映射成 `account`） |
 
-输出：简化列表（每条包含 `name` / `id` / `apiname`）。
+
+> 注意：`objName` 直接按你要查询的对象名称来传，并按实际值原样传入。  
+> 例如对象名称是 `客户`、`客户004`，就直接传 `客户`、`客户004`；**不要**按语义自动换成 `account`。  
+> 如果返回为空，通常意味着目标环境里的对象名称不是你传的这个值（可以去对象管理里看一下该对象的名称/标识）。
 
 ---
 
@@ -177,6 +180,23 @@ cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50
 cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'test',pageLabel:'',objName:''}})))")" .
 ```
 
+### 按对象名称筛选（示例：`客户` / `客户004`）
+
+```bash
+# 对象名称为“客户”
+cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'',pageLabel:'',objName:'客户'}})))")" .
+
+# 对象名称为“客户004”
+cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'',pageLabel:'',objName:'客户004'}})))")" .
+```
+
+错误示例（不要这样传）：
+
+```bash
+# 业务上说“客户”，就不要自作主张写成 account
+cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'',pageLabel:'',objName:'account'}})))")" .
+```
+
 ### 新建脚本（本地）
 
 ```bash