cloudcc-cli 2.3.5 → 2.3.7

package/src/validationRule/docs/devguide.md

@@ -13,7 +13,7 @@
 ### 创建验证规则
 
 ```bash
-cc create validationRule <path> <objectPrefix> [ruleName] [ruleContent] [errorMessage]
+cloudcc create validationRule <path> <objectPrefix> [ruleName] [ruleContent] [errorMessage]
 ```
 
 **参数说明：**
@@ -30,16 +30,16 @@ cc create validationRule <path> <objectPrefix> [ruleName] [ruleContent] [errorMe
 
 ```bash
 # 交互式输入所有信息
-cc create validationRule . "b00"
+cloudcc create validationRule . "b00"
 
 # 非交互式创建
-cc create validationRule . "b00" "规则1" "Batch_Size__c__f==5" "数量必须是5"
+cloudcc create validationRule . "b00" "规则1" "Batch_Size__c__f==5" "数量必须是5"
 ```
 
 ### 查询验证规则列表
 
 ```bash
-cc get validationRule <projectPath> <objectPrefix>
+cloudcc get validationRule <projectPath> <objectPrefix>
 ```
 
 **参数说明：**
@@ -53,13 +53,13 @@ cc get validationRule <projectPath> <objectPrefix>
 
 ```bash
 # 获取对象 b00 的所有验证规则
-cc get validationRule . "b00"
+cloudcc get validationRule . "b00"
 ```
 
 ### 删除验证规则
 
 ```bash
-cc delete validationRule <projectPath> <ruleId>
+cloudcc delete validationRule <projectPath> <ruleId>
 ```
 
 **参数说明：**
@@ -72,5 +72,5 @@ cc delete validationRule <projectPath> <ruleId>
 **示例：**
 
 ```bash
-cc delete validationRule . 202689E55795D38oAQlN
+cloudcc delete validationRule . 202689E55795D38oAQlN
 ```

package/src/validationRule/docs/introduction.md

@@ -23,7 +23,7 @@
 创建一个新的 CloudCC 验证规则。
 
 ```bash
-cc create validationRule <path> <objectPrefix> [ruleName] [ruleContent] [errorMessage]
+cloudcc create validationRule <path> <objectPrefix> [ruleName] [ruleContent] [errorMessage]
 ```
 
 **参数说明：**
@@ -40,10 +40,10 @@ cc create validationRule <path> <objectPrefix> [ruleName] [ruleContent] [errorMe
 
 ```bash
 # 交互式输入所有信息
-cc create validationRule . "b00"
+cloudcc create validationRule . "b00"
 
 # 非交互式创建
-cc create validationRule . "b00" "规则1" "Batch_Size__c__f==5" "数量必须是5"
+cloudcc create validationRule . "b00" "规则1" "Batch_Size__c__f==5" "数量必须是5"
 ```
 
 ---
@@ -53,7 +53,7 @@ cc create validationRule . "b00" "规则1" "Batch_Size__c__f==5" "数量必须
 获取指定对象的所有验证规则列表。
 
 ```bash
-cc get validationRule <projectPath> <objectPrefix>
+cloudcc get validationRule <projectPath> <objectPrefix>
 ```
 
 **参数说明：**
@@ -67,7 +67,7 @@ cc get validationRule <projectPath> <objectPrefix>
 
 ```bash
 # 获取对象 b00 的所有验证规则
-cc get validationRule . "b00"
+cloudcc get validationRule . "b00"
 ```
 
 ---
@@ -77,7 +77,7 @@ cc get validationRule . "b00"
 删除指定的验证规则。
 
 ```bash
-cc delete validationRule <projectPath> <ruleId>
+cloudcc delete validationRule <projectPath> <ruleId>
 ```
 
 **参数说明：**
@@ -91,7 +91,7 @@ cc delete validationRule <projectPath> <ruleId>
 
 ```bash
 # 删除指定规则
-cc delete validationRule . 202689E55795D38oAQlN
+cloudcc delete validationRule . 202689E55795D38oAQlN
 ```
 
 ---
@@ -105,16 +105,16 @@ cc delete validationRule . 202689E55795D38oAQlN
 cat cloudcc-cli.config.js
 
 # 2. 查询对象现有的验证规则
-cc get validationRule . "b00"
+cloudcc get validationRule . "b00"
 
 # 3. 创建新验证规则
-cc create validationRule . "b00"
+cloudcc create validationRule . "b00"
 
 # 4. 验证规则创建成功
-cc get validationRule . "b00"
+cloudcc get validationRule . "b00"
 
 # 5. 如需删除
-# cc delete validationRule . <ruleId>
+# cloudcc delete validationRule . <ruleId>
 ```
 
 ---

package/src/validationRule/get.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 查询验证规则列表
- * 用法：cc get validationRule <projectPath> <objectPrefix>
+ * 用法：cloudcc get validationRule <projectPath> <objectPrefix>
  * 接口：POST /api/validateRule/queryByPrefix
  * 参数：{ prefix: "b00" }
  */

package/src/version/actionHelp.js

@@ -7,18 +7,18 @@ function actionHelp(argvs) {
   console.error()
   if (list.length === 0) {
     console.error(chalk.yellow(`没有 resource 支持 action「${action}」。`))
-    console.error(chalk.gray("运行 ") + chalk.green("cc --help") + chalk.gray(" 查看全部命令。"))
+    console.error(chalk.gray("运行 ") + chalk.green("cloudcc --help") + chalk.gray(" 查看全部命令。"))
     console.error()
     return
   }
-  console.error(chalk.bold.cyan(`cc ${action}`) + chalk.gray(" <resource> [args...]"))
+  console.error(chalk.bold.cyan(`cloudcc ${action}`) + chalk.gray(" <resource> [args...]"))
   console.error()
   console.error(chalk.yellow("可用的 resource："))
   for (const r of list) {
     console.error("  " + chalk.green(r))
   }
   console.error()
-  console.error(chalk.gray("示例：") + chalk.green(`cc ${action} ${list[0]}`) + chalk.gray(" <后续参数见各模块文档>"))
+  console.error(chalk.gray("示例：") + chalk.green(`cloudcc ${action} ${list[0]}`) + chalk.gray(" <后续参数见各模块文档>"))
   console.error()
 }
 

package/src/version/doctor.js

@@ -5,7 +5,7 @@ const pkg = require("../../package.json")
 
 function doctor() {
   console.error()
-  console.error(chalk.bold.cyan("cc doctor") + chalk.gray(" — 环境自检"))
+  console.error(chalk.bold.cyan("cloudcc doctor") + chalk.gray(" — 环境自检"))
   console.error()
   console.error(chalk.green("✓") + " Node " + process.version)
   console.error(chalk.green("✓") + " cloudcc-cli v" + pkg.version)

package/src/version/get.js

@@ -1,15 +1,9 @@
 const chalk = require("chalk")
 const pkg = require("../../package.json")
-const { getReleaseForExact, defaultReadmePath } = require("../../utils/readmeReleases")
-const { printReleaseNotesBlocks } = require("../../utils/formatReleaseNotes")
 
 function get() {
     console.error()
     console.error(chalk.green(`cloudcc-cli version: ${pkg.version}`))
-    const rel = getReleaseForExact(defaultReadmePath(), pkg.version)
-    if (rel) {
-        printReleaseNotesBlocks([rel], console.error)
-    }
     console.error()
 }
 

package/src/version/help.js

@@ -4,21 +4,22 @@ const { getModuleGroups, describeActionLine } = require("./listModuleCommands")
 
 function help() {
   console.error()
-  console.error(chalk.bold.cyan("cloudcc-cli (cc)") + chalk.gray(` v${pkg.version}`))
+  console.error(chalk.bold.cyan("cloudcc-cli (cc / cloudcc)") + chalk.gray(` v${pkg.version}`))
+  console.error(chalk.dim("  与系统 C 编译器 cc 冲突时请使用 cloudcc"))
   console.error()
   console.error(chalk.yellow("Usage:"))
-  console.error("  " + chalk.green("cc") + " <action> <resource> [args...]")
+  console.error("  " + chalk.green("cc") + " / " + chalk.green("cloudcc") + " <action> <resource> [args...]")
   console.error()
   console.error(chalk.yellow("Global:"))
-  console.error("  " + chalk.green("cc --help") + ", " + chalk.green("-h") + ", " + chalk.green("cc help") + "  显示本帮助")
-  console.error("  " + chalk.green("cc --version") + ", " + chalk.green("-v") + "  打印版本号")
-  console.error("  " + chalk.green("cc update") + "              升级全局 cloudcc-cli")
-  console.error("  " + chalk.green("cc uninstall") + "           卸载全局 cloudcc-cli")
-  console.error("  " + chalk.green("cc doctor") + "              环境自检（Node、配置、CLI 版本）")
-  console.error("  " + chalk.green("cc docs") + "               在浏览器打开 CloudCC 帮助中心")
-  console.error("  " + chalk.green("cc stats") + "              查看本地命令调用统计（默认开启，" + chalk.gray("CLOUDCC_CLI_STATS=0") + " 可关闭）")
-  console.error("  " + chalk.green("cc init") + " [项目名]      等同于 cc create project")
-  console.error("  " + chalk.green("cc <action> -h") + "        查看该 action 下可用的 resource")
+  console.error("  " + chalk.green("cloudcc --help") + ", " + chalk.green("-h") + ", " + chalk.green("cloudcc help") + "  显示本帮助")
+  console.error("  " + chalk.green("cloudcc --version") + ", " + chalk.green("-v") + "  打印版本号")
+  console.error("  " + chalk.green("cloudcc update") + "              升级全局 cloudcc-cli")
+  console.error("  " + chalk.green("cloudcc uninstall") + "           卸载全局 cloudcc-cli")
+  console.error("  " + chalk.green("cloudcc doctor") + "              环境自检（Node、配置、CLI 版本）")
+  console.error("  " + chalk.green("cloudcc docs") + "               在浏览器打开 CloudCC 帮助中心")
+  console.error("  " + chalk.green("cloudcc stats") + "              查看本地命令调用统计（默认开启，" + chalk.gray("CLOUDCC_CLI_STATS=0") + " 可关闭）")
+  console.error("  " + chalk.green("cloudcc init") + " [项目名]      等同于 cloudcc create project")
+  console.error("  " + chalk.green("cloudcc <action> -h") + "        查看该 action 下可用的 resource")
   console.error()
   console.error(chalk.yellow("模块 (resource)"))
   console.error()
@@ -29,7 +30,7 @@ function help() {
     console.error(chalk.bold.white("  " + title))
     const ex = resources[0]
     for (const a of actions) {
-      const cmd = "cc " + a + " " + ex
+      const cmd = "cloudcc " + a + " " + ex
       const note = describeActionLine(ex, a)
       console.error("    " + chalk.green(cmd) + "  " + chalk.gray(note))
     }
@@ -37,8 +38,8 @@ function help() {
   }
 
   console.error(chalk.yellow("Examples:"))
-  console.error("  " + chalk.gray("cc doc object introduction"))
-  console.error("  " + chalk.gray("cc get object Account"))
+  console.error("  " + chalk.gray("cloudcc doc object introduction"))
+  console.error("  " + chalk.gray("cloudcc get object Account"))
   console.error()
   console.error(chalk.gray("Developer docs: https://help.cloudcc.cn/"))
   console.error()

package/src/version/initHelp.js

@@ -2,10 +2,10 @@ const chalk = require("chalk")
 
 function initHelp() {
   console.error()
-  console.error(chalk.bold.cyan("cc init") + chalk.gray(" — 与 ") + chalk.green("cc create project") + chalk.gray(" 相同"))
+  console.error(chalk.bold.cyan("cloudcc init") + chalk.gray(" — 与 ") + chalk.green("cloudcc create project") + chalk.gray(" 相同"))
   console.error()
   console.error(chalk.yellow("用法："))
-  console.error("  " + chalk.green("cc init") + " [项目名]")
+  console.error("  " + chalk.green("cloudcc init") + " [项目名]")
   console.error(chalk.gray("  不传项目名时进入交互式创建。"))
   console.error()
 }

package/src/version/listModuleCommands.js

@@ -39,7 +39,7 @@ const MODULE_KEYS_ORDER = [
 ]
 
 /**
- * 各 resource 一句话说明（供 --help 展示）。与自动解析的 action 列表互补，不替代 `cc doc <resource> introduction`。
+ * 各 resource 一句话说明（供 --help 展示）。与自动解析的 action 列表互补，不替代 `cloudcc doc <resource> introduction`。
  */
 const MODULE_HINT = {
   project: "创建/初始化 CloudCC 开发项目。",
@@ -181,7 +181,7 @@ const RESOURCE_CN = {
 }
 
 /**
- * 单行命令说明（替代行尾「…」），与 cc <action> <resource> 对应。
+ * 单行命令说明（替代行尾「…」），与 cloudcc <action> <resource> 对应。
  */
 function describeActionLine(resource, action) {
   const n = RESOURCE_CN[resource] || resource

package/src/version/stats.js

@@ -10,7 +10,7 @@ function stats() {
   const entries = Object.entries(data.counts || {}).sort((a, b) => b[1] - a[1])
 
   console.error()
-  console.error(chalk.bold.cyan("cc command statistics"))
+  console.error(chalk.bold.cyan("cloudcc command statistics"))
   console.error(chalk.gray("File: ") + chalk.dim(statsFilePath()))
   console.error(
     chalk.gray("Recording: ") +

package/test/application.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/classes.cli.test.js

@@ -13,7 +13,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/customSetting.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/fields.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 
@@ -44,7 +44,7 @@ test("字段管理流程：获取对象列表→create 字段→get 字段列表
 
   t.test("2) create 创建一个文本字段（S）", async () => {
     assert.ok(objId, "需要对象 id");
-    // create fields 调用约定：cc create fields <path> <fieldType> <objid> <nameLabel> [...]
+    // create fields 调用约定：cloudcc create fields <path> <fieldType> <objid> <nameLabel> [...]
     const { stdout, stderr } = await runCc(["create", "fields", repoRoot, "S", objId, fieldLabel]);
     // create fields 会通过 console.error 输出创建结果（见 src/fields/create.js）
     assert.match(

package/test/globalSelectList.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/menu-script.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/menu.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/object.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/plugin.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/scheduleJob.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/script.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/staticResource.cli.test.js

@@ -12,7 +12,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/timer.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/test/trigger.cli.test.js

@@ -14,7 +14,7 @@ function quoteArg(value) {
 }
 
 async function runCc(args) {
-  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  const cmd = `npx --prefix "${repoRoot}" cloudcc ${args.map(quoteArg).join(" ")}`;
   return execAsync(cmd, { cwd: repoRoot });
 }
 

package/utils/checkVersion.js

@@ -7,7 +7,6 @@ const fs = require('fs');
 const path = require('path');
 const {
     semverCompare,
-    getReleaseForExact,
     getReleasesBetween,
     defaultReadmePath,
 } = require("./readmeReleases");
@@ -40,7 +39,7 @@ function checkNpmVersion() {
     console.error('  ' + chalk.magenta('★') + ' Changelog       : ' + chalk.cyan('https://www.npmjs.com/package/cloudcc-cli'));
     console.error('  ' + chalk.gray('━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━━'));
 
-    printReadmeReleaseNotes(config.version, onlineVersion);
+    printReadmeReleaseNotesIfUpgradeNeeded(config.version, onlineVersion);
 
     if (onlineVersionNum - currentVersion > 0) {
         return onlineVersion;
@@ -49,20 +48,17 @@ function checkNpmVersion() {
 }
 
 /**
- * Prints README `# ReleaseV*` sections: all versions between current and latest when an update
- * exists; otherwise the section for the current version only.
+ * Prints README `# ReleaseV*` sections only when the registry has a **newer** version than local:
+ * all release blocks from current (exclusive) through latest (inclusive). If already up to date,
+ * prints nothing (changelog link remains in the version panel above).
  */
-function printReadmeReleaseNotes(currentVersion, latestVersion) {
-    const readmePath = defaultReadmePath();
-    let blocks = [];
-    if (semverCompare(latestVersion, currentVersion) > 0) {
-        blocks = getReleasesBetween(readmePath, currentVersion, latestVersion);
-    } else {
-        const one = getReleaseForExact(readmePath, currentVersion);
-        if (one) blocks = [one];
+function printReadmeReleaseNotesIfUpgradeNeeded(currentVersion, latestVersion) {
+    if (semverCompare(latestVersion, currentVersion) <= 0) {
+        return;
     }
+    const readmePath = defaultReadmePath();
+    const blocks = getReleasesBetween(readmePath, currentVersion, latestVersion);
     if (blocks.length === 0) {
-        console.error('\n');
         return;
     }
     printReleaseNotesBlocks(blocks, console.error);

package/utils/commandStats.js

@@ -4,7 +4,7 @@ const os = require("os")
 
 /**
  * 默认开启：在 ~/.cloudcc-cli/command-stats.json 累计调用次数；
- * 键为人类可读形式，如 `cc doc classes`、`cc get brief`。
+ * 键为人类可读形式，如 `cloudcc doc classes`、`cloudcc get brief`。
  * 设 `CLOUDCC_CLI_STATS=0` / `false` / `off` 可关闭。
  */
 function isEnabled() {
@@ -32,20 +32,20 @@ function formatRecordKey(action, resource) {
       action === "-version" ||
       action === "--version"
     ) {
-      return "cc --version"
+      return "cloudcc --version"
     }
     if (action === "-h" || action === "--h" || action === "--help") {
-      return "cc --help"
+      return "cloudcc --help"
     }
-    return `cc ${action}`
+    return `cloudcc ${action}`
   }
   if (res === "_help") {
-    return `cc ${action} --help`
+    return `cloudcc ${action} --help`
   }
   if (res === "-h" || res === "--help") {
-    return `cc ${action} -h`
+    return `cloudcc ${action} -h`
   }
-  return `cc ${action} ${res}`
+  return `cloudcc ${action} ${res}`
 }
 
 /**