cloudcc-cli 2.3.4 → 2.3.6

package/src/profile/delete.js

@@ -4,7 +4,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 删除简档
- * 用法：cc delete profile <projectPath> <profileId>
+ * 用法：cloudcc delete profile <projectPath> <profileId>
  */
 async function remove(argvs) {
     try {
@@ -14,7 +14,7 @@ async function remove(argvs) {
         if (!profileId) {
             console.error();
             console.error(chalk.red("Error: 缺少简档 ID"));
-            console.error(chalk.yellow("用法: cc delete profile <projectPath> <profileId>"));
+            console.error(chalk.yellow("用法: cloudcc delete profile <projectPath> <profileId>"));
             console.error();
             throw new Error("缺少必需参数: profileId");
         }

package/src/profile/doc.js

@@ -21,14 +21,14 @@ function getDevGuideDoc() {
 }
 
 /**
- * cc doc profile <introduction|devguide>
+ * cloudcc doc profile <introduction|devguide>
  * @param {string[]} argvs [doc, type, introduction|devguide, ...]
  */
 function doc(argvs) {
     const subType = argvs[2];
     const key = String(subType || "").trim().toLowerCase();
     if (!key) {
-        throw new Error("cc doc profile 需要子命令：introduction 或 devguide");
+        throw new Error("cloudcc doc profile 需要子命令：introduction 或 devguide");
     }
     if (key === "introduction") {
         const content = getIntroductionDoc();

package/src/profile/docs/devguide.md

@@ -13,7 +13,7 @@
 ### 创建简档
 
 ```bash
-cc create profile <path> <profileName> [description]
+cloudcc create profile <path> <profileName> [description]
 ```
 
 **参数说明：**
@@ -28,16 +28,16 @@ cc create profile <path> <profileName> [description]
 
 ```bash
 # 创建简档
-cc create profile . "销售经理简档"
+cloudcc create profile . "销售经理简档"
 
 # 创建带描述的简档
-cc create profile . "销售代表简档" "适用于销售团队的权限配置"
+cloudcc create profile . "销售代表简档" "适用于销售团队的权限配置"
 ```
 
 ### 查询简档列表
 
 ```bash
-cc get profile <projectPath> [encodedCondJson]
+cloudcc get profile <projectPath> [encodedCondJson]
 ```
 
 **参数说明：**
@@ -51,16 +51,16 @@ cc get profile <projectPath> [encodedCondJson]
 
 ```bash
 # 获取所有简档
-cc get profile .
+cloudcc get profile .
 
 # 带查询条件
-cc get profile . '%7B%22type%22%3A%22custom%22%7D'
+cloudcc get profile . '%7B%22type%22%3A%22custom%22%7D'
 ```
 
 ### 删除简档
 
 ```bash
-cc delete profile <projectPath> <profileId>
+cloudcc delete profile <projectPath> <profileId>
 ```
 
 **参数说明：**
@@ -73,5 +73,5 @@ cc delete profile <projectPath> <profileId>
 **示例：**
 
 ```bash
-cc delete profile . aaa202672F656B7VfEjL
+cloudcc delete profile . aaa202672F656B7VfEjL
 ```

package/src/profile/docs/introduction.md

@@ -23,7 +23,7 @@
 创建一个新的自定义简档，基于现有简档进行克隆。
 
 ```bash
-cc create profile <path> <profileName> [description]
+cloudcc create profile <path> <profileName> [description]
 ```
 
 **参数说明：**
@@ -38,10 +38,10 @@ cc create profile <path> <profileName> [description]
 
 ```bash
 # 创建简档
-cc create profile . "销售经理简档"
+cloudcc create profile . "销售经理简档"
 
 # 创建带描述的简档
-cc create profile . "销售代表简档" "适用于销售团队的权限配置"
+cloudcc create profile . "销售代表简档" "适用于销售团队的权限配置"
 ```
 
 ---
@@ -51,7 +51,7 @@ cc create profile . "销售代表简档" "适用于销售团队的权限配置"
 获取当前环境中的所有简档列表。
 
 ```bash
-cc get profile <projectPath> [encodedCondJson]
+cloudcc get profile <projectPath> [encodedCondJson]
 ```
 
 **参数说明：**
@@ -65,10 +65,10 @@ cc get profile <projectPath> [encodedCondJson]
 
 ```bash
 # 获取所有简档
-cc get profile .
+cloudcc get profile .
 
 # 带查询条件
-cc get profile . '%7B%22type%22%3A%22custom%22%7D'
+cloudcc get profile . '%7B%22type%22%3A%22custom%22%7D'
 ```
 
 ---
@@ -78,7 +78,7 @@ cc get profile . '%7B%22type%22%3A%22custom%22%7D'
 删除指定的自定义简档。
 
 ```bash
-cc delete profile <projectPath> <profileId>
+cloudcc delete profile <projectPath> <profileId>
 ```
 
 **参数说明：**
@@ -92,7 +92,7 @@ cc delete profile <projectPath> <profileId>
 
 ```bash
 # 删除指定简档
-cc delete profile . a0I9D000000XXXXUAI
+cloudcc delete profile . a0I9D000000XXXXUAI
 ```
 
 ---
@@ -106,16 +106,16 @@ cc delete profile . a0I9D000000XXXXUAI
 cat cloudcc-cli.config.js
 
 # 2. 查询现有简档
-cc get profile .
+cloudcc get profile .
 
 # 3. 创建新的销售经理简档
-cc create profile . "销售经理简档" "销售团队经理级别的权限配置"
+cloudcc create profile . "销售经理简档" "销售团队经理级别的权限配置"
 
 # 4. 验证简档创建成功
-cc get profile .
+cloudcc get profile .
 
 # 5. 如需删除
-# cc delete profile . <profileId>
+# cloudcc delete profile . <profileId>
 ```
 
 ---

package/src/profile/get.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 查询简档列表
- * 用法：cc get profile <projectPath> [encodedCondJson]
+ * 用法：cloudcc get profile <projectPath> [encodedCondJson]
  */
 async function get(argvs, isMcp = false) {
     const projectPath = argvs[2] || process.cwd();

package/src/project/docs/devguide.md

@@ -18,7 +18,7 @@
   1. 安装 Node 与 npm，并切换 npm 源
   2. 安装 `cloudcc-cli` 全局依赖
   3. 安装 VS Code 与 CloudCC 插件
-  4. 配置本地 MCP（`cc-mcp`）
+  4. 配置本地 MCP（`node` 运行 `bin/mcp.js`）
   5. 使用 CLI 创建模板项目并安装依赖
   6. 通过 CRM 获取开发者密钥、安全标记并写入 `cloudcc-cli.config.js`
   7. 视情况配置私有云与多环境参数
@@ -109,15 +109,16 @@ sudo npm ls -g --depth=0
 
 ---
 
-## 5. 安装并配置本地 MCP（cc-mcp）
+## 5. 安装并配置本地 MCP
 
-在支持 MCP 的开发工具中（如 Cursor），需要在 MCP 配置文件中添加：
+在支持 MCP 的开发工具中（如 Cursor），需要在 MCP 配置文件中添加（使用 `node` 启动包内脚本，**将 `args` 中的路径换成本机全局安装后的绝对路径**）：
 
 ```json
 {
     "mcpServers": {
         "cloudcc-cli": {
-            "command": "cc-mcp"
+            "command": "node",
+            "args": ["<npm-global>/cloudcc-cli/bin/mcp.js"]
         }
     }
 }
@@ -126,7 +127,7 @@ sudo npm ls -g --depth=0
 说明：
 
 - `cloudcc-cli`：MCP 服务器标识，用于在工具中调用 CloudCC 相关能力
-- `command: "cc-mcp"`：实际执行的命令，通常由 `cloudcc-cli` 提供
+- `command` / `args`：通过 Node 执行 `cloudcc-cli` 包内的 `bin/mcp.js`（全局安装后路径一般为 `$(npm root -g)/cloudcc-cli/bin/mcp.js`，请粘贴为绝对路径）
 
 ---
 
@@ -138,7 +139,7 @@ sudo npm ls -g --depth=0
 
 ```bash
 cd ~/Documents
-cc create project demo1
+cloudcc create project demo1
 ```
 
 `demo1` 为示例项目名，可按需替换。
@@ -351,8 +352,8 @@ module.exports = {
 - [ ] npm 源已切换到 `https://registry.npmmirror.com`
 - [ ] 已全局安装 `cloudcc-cli` 并验证
 - [ ] 已安装 VS Code 与 CloudCC 插件（或已按官方指引配置 Cursor）
-- [ ] MCP 已配置 `cloudcc-cli → cc-mcp`
-- [ ] 已通过 `cc create project` 创建模板项目并成功 `npm i` + `npm run serve`
+- [ ] MCP 已配置 `cloudcc-cli`（`node` + `bin/mcp.js`）
+- [ ] 已通过 `cloudcc create project` 创建模板项目并成功 `npm i` + `npm run serve`
 - [ ] 已创建开发者账号并确认「代码管理」权限开启
 - [ ] 已获取开发者密钥与安全标记并正确配置 `cloudcc-cli.config.js`
 - [ ] 如为私有云，已配置 `version: "private"` 与正确的 `baseUrl`/网关前缀

package/src/recordType/create.js

@@ -4,7 +4,7 @@ const { postClass } = require("../../utils/http");
 const newInfo = require("./newInfo");
 
 /**
- * cc create recordType <projectPath> <encodedBodyJson>
+ * cloudcc create recordType <projectPath> <encodedBodyJson>
  *
  * encodedBodyJson（encodeURI 编码前）：
  * {

package/src/recordType/delete.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc delete recordType <projectPath> <encodedBodyJson>
+ * cloudcc delete recordType <projectPath> <encodedBodyJson>
  * 删除记录类型（删除前请先调用 validDelete 获取替换目标列表）
  *
  * encodedBodyJson（encodeURI 编码前）示例：

package/src/recordType/doc.js

@@ -11,14 +11,14 @@ function readDocFile(basename) {
 }
 
 /**
- * cc doc recordType <introduction|devguide>
+ * cloudcc doc recordType <introduction|devguide>
  * @param {string[]} argvs [doc, type, introduction|devguide, ...]
  */
 function doc(argvs) {
     const subType = argvs[2];
     const key = String(subType || "").trim().toLowerCase();
     if (!key) {
-        throw new Error("cc doc recordType 需要子命令：introduction 或 devguide");
+        throw new Error("cloudcc doc recordType 需要子命令：introduction 或 devguide");
     }
     if (key === "introduction") {
         const content = readDocFile("introduction");

package/src/recordType/docs/devguide.md

@@ -16,7 +16,7 @@
 
 ```bash
 # 获取指定对象的记录类型列表
-cc getList recordType . <objid>
+cloudcc getList recordType . <objid>
 ```
 
 ---
@@ -26,7 +26,7 @@ cc getList recordType . <objid>
 新建前需先获取简档列表、现有记录类型列表、页面布局列表：
 
 ```bash
-cc newInfo recordType . <objid>
+cloudcc newInfo recordType . <objid>
 ```
 
 返回结构：
@@ -46,7 +46,7 @@ cc newInfo recordType . <objid>
 ## 3. 新建记录类型
 
 ```bash
-cc create recordType . <encodedBodyJson>
+cloudcc create recordType . <encodedBodyJson>
 ```
 
 原始 JSON（`encodeURI` 编码前）：
@@ -74,7 +74,7 @@ cc create recordType . <encodedBodyJson>
 **Step 1：获取回显数据**
 
 ```bash
-cc editInfo recordType . <encodedBodyJson>
+cloudcc editInfo recordType . <encodedBodyJson>
 # encodedBodyJson: { "id": "<recordTypeId>", "objid": "<objid>" }
 ```
 
@@ -88,7 +88,7 @@ cc editInfo recordType . <encodedBodyJson>
 | 启用          | `isenable`    |
 
 ```bash
-cc editSave recordType . <encodedBodyJson>
+cloudcc editSave recordType . <encodedBodyJson>
 # encodedBodyJson: 将 editInfo 返回的 data 对象修改目标字段后提交
 ```
 
@@ -99,7 +99,7 @@ cc editSave recordType . <encodedBodyJson>
 **Step 1：删除前校验**（检测启用状态 + 获取可替换记录类型列表）
 
 ```bash
-cc validDelete recordType . <encodedBodyJson>
+cloudcc validDelete recordType . <encodedBodyJson>
 # encodedBodyJson: { "id": "<recordTypeId>", "objid": "<objid>" }
 ```
 
@@ -107,7 +107,7 @@ cc validDelete recordType . <encodedBodyJson>
 > - 若当前为**启用**状态，命令将报错并提示先执行禁用操作，不会继续执行删除校验
 > - 若当前为**禁用**状态，则正常返回可替换记录类型列表
 >
-> 请先调用 `cc editSave` 将 `isenable` 设为 `"false"` 完成禁用，再重新执行此命令。
+> 请先调用 `cloudcc editSave` 将 `isenable` 设为 `"false"` 完成禁用，再重新执行此命令。
 
 返回：
 
@@ -124,7 +124,7 @@ cc validDelete recordType . <encodedBodyJson>
 **Step 2：执行删除**
 
 ```bash
-cc delete recordType . <encodedBodyJson>
+cloudcc delete recordType . <encodedBodyJson>
 # encodedBodyJson: { "id": "<recordTypeId>", "objid": "<objid>", "replaceId": "<replaceId>" }
 ```
 
@@ -141,8 +141,8 @@ cc delete recordType . <encodedBodyJson>
 ## 6. 查看文档
 
 ```bash
-cc doc recordType introduction   # 能力与适用场景说明
-cc doc recordType devguide        # 本操作指南
+cloudcc doc recordType introduction   # 能力与适用场景说明
+cloudcc doc recordType devguide        # 本操作指南
 ```
 
 ---

package/src/recordType/editInfo.js

@@ -2,7 +2,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc editInfo recordType <projectPath> <encodedBodyJson>
+ * cloudcc editInfo recordType <projectPath> <encodedBodyJson>
  * 获取编辑记录类型的回显数据
  *
  * encodedBodyJson（encodeURI 编码前）示例：

package/src/recordType/editSave.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc editSave recordType <projectPath> <encodedBodyJson>
+ * cloudcc editSave recordType <projectPath> <encodedBodyJson>
  * 保存编辑后的记录类型（将 editInfo 返回的对象修改后提交）
  *
  * encodedBodyJson（encodeURI 编码前）为 editInfo 接口返回的 data 对象，

package/src/recordType/getList.js

@@ -2,7 +2,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc getList recordType <projectPath> <objid>
+ * cloudcc getList recordType <projectPath> <objid>
  * 获取指定对象的记录类型列表
  * @param {string} projectPath
  * @param {string} objid  对象 ID

package/src/recordType/newInfo.js

@@ -2,7 +2,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc newInfo recordType <projectPath> <objid>
+ * cloudcc newInfo recordType <projectPath> <objid>
  * 获取新建记录类型所需的表单初始信息（现有记录类型列表、简档列表、页面布局列表）
  * @param {string} projectPath
  * @param {string} objid  对象 ID

package/src/recordType/validDelete.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc validDelete recordType <projectPath> <encodedBodyJson>
+ * cloudcc validDelete recordType <projectPath> <encodedBodyJson>
  * 删除前校验：获取可替换的记录类型列表
  *
  * 执行逻辑：

package/src/res.md

@@ -1,6 +1,6 @@
 # cloudcc-cli 资源与操作
 
-`cc <action> <type> …`
+`cloudcc <action> <type> …`
 # CRM 相关
 
 ## plugin

package/src/role/create.js

@@ -6,7 +6,7 @@ const { id } = require('zod/locales');
 
 /**
  * 创建角色
- * 用法：cc create role <path> <roleName> [parentRoleName] [description]
+ * 用法：cloudcc create role <path> <roleName> [parentRoleName] [description]
  * 流程：
  * 1. 调用 role/addRole 获取直属上司列表
  * 2. 交互式选择直属上司（未指定时）或自动匹配（指定时）
@@ -16,7 +16,7 @@ const { id } = require('zod/locales');
  */
 async function create(argvs) {
     try {
-        // 命令行参数格式：cc create role <path> <roleName> [parentRoleName] [description]
+        // 命令行参数格式：cloudcc create role <path> <roleName> [parentRoleName] [description]
         const projectPath = argvs[2] || process.cwd();
         const roleName = argvs[3];
         const parentRoleName = argvs[4] || '';
@@ -25,11 +25,11 @@ async function create(argvs) {
         if (!roleName) {
             console.error();
             console.error(chalk.red('Error: 缺少角色名称'));
-            console.error('用法: cc create role <path> <roleName> [parentRoleName] [description]');
+            console.error('用法: cloudcc create role <path> <roleName> [parentRoleName] [description]');
             console.error('示例:');
-            console.error('  cc create role . "销售经理"           # 交互式选择直属上司');
-            console.error('  cc create role . "销售经理" "CEO"     # 指定直属上司为 CEO');
-            console.error('  cc create role . "销售经理" "CEO" "负责销售团队管理"');
+            console.error('  cloudcc create role . "销售经理"           # 交互式选择直属上司');
+            console.error('  cloudcc create role . "销售经理" "CEO"     # 指定直属上司为 CEO');
+            console.error('  cloudcc create role . "销售经理" "CEO" "负责销售团队管理"');
             console.error();
             throw new Error('缺少必需参数: roleName');
         }

package/src/role/delete.js

@@ -4,7 +4,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 删除角色
- * 用法：cc delete role <projectPath> <roleId>
+ * 用法：cloudcc delete role <projectPath> <roleId>
  */
 async function remove(argvs) {
     try {
@@ -14,7 +14,7 @@ async function remove(argvs) {
         if (!roleId) {
             console.error();
             console.error(chalk.red("Error: 缺少角色 ID"));
-            console.error(chalk.yellow("用法: cc delete role <projectPath> <roleId>"));
+            console.error(chalk.yellow("用法: cloudcc delete role <projectPath> <roleId>"));
             console.error();
             throw new Error("缺少必需参数: roleId");
         }

package/src/role/doc.js

@@ -21,14 +21,14 @@ function getDevGuideDoc() {
 }
 
 /**
- * cc doc role <introduction|devguide>
+ * cloudcc doc role <introduction|devguide>
  * @param {string[]} argvs [doc, type, introduction|devguide, ...]
  */
 function doc(argvs) {
     const subType = argvs[2];
     const key = String(subType || "").trim().toLowerCase();
     if (!key) {
-        throw new Error("cc doc role 需要子命令：introduction 或 devguide");
+        throw new Error("cloudcc doc role 需要子命令：introduction 或 devguide");
     }
     if (key === "introduction") {
         const content = getIntroductionDoc();

package/src/role/docs/devguide.md

@@ -13,7 +13,7 @@
 ### 创建角色
 
 ```bash
-cc create role <path> <roleName> [parentRoleName] [description]
+cloudcc create role <path> <roleName> [parentRoleName] [description]
 ```
 
 **参数说明：**
@@ -29,19 +29,19 @@ cc create role <path> <roleName> [parentRoleName] [description]
 
 ```bash
 # 交互式选择直属上司
-cc create role . "销售经理"
+cloudcc create role . "销售经理"
 
 # 指定直属上司（非交互式）
-cc create role . "销售经理" "CEO"
+cloudcc create role . "销售经理" "CEO"
 
 # 指定直属上司并添加描述
-cc create role . "市场专员" "销售总监" "负责市场推广工作"
+cloudcc create role . "市场专员" "销售总监" "负责市场推广工作"
 ```
 
 ### 查询角色列表
 
 ```bash
-cc get role <projectPath> [encodedCondJson]
+cloudcc get role <projectPath> [encodedCondJson]
 ```
 
 **参数说明：**
@@ -55,16 +55,16 @@ cc get role <projectPath> [encodedCondJson]
 
 ```bash
 # 获取所有角色
-cc get role .
+cloudcc get role .
 
 # 带查询条件
-cc get role . '%7B%22name%22%3A%22%E9%94%80%E5%94%AE%22%7D'
+cloudcc get role . '%7B%22name%22%3A%22%E9%94%80%E5%94%AE%22%7D'
 ```
 
 ### 删除角色
 
 ```bash
-cc delete role <projectPath> <roleId>
+cloudcc delete role <projectPath> <roleId>
 ```
 
 **参数说明：**
@@ -77,5 +77,5 @@ cc delete role <projectPath> <roleId>
 **示例：**
 
 ```bash
-cc delete role . a0I9D000000XXXXUAI
+cloudcc delete role . a0I9D000000XXXXUAI
 ```

package/src/role/docs/introduction.md

@@ -23,7 +23,7 @@
 创建一个新的 CloudCC 角色。
 
 ```bash
-cc create role <path> <roleName> [description]
+cloudcc create role <path> <roleName> [description]
 ```
 
 **参数说明：**
@@ -38,10 +38,10 @@ cc create role <path> <roleName> [description]
 
 ```bash
 # 创建角色
-cc create role . "销售经理"
+cloudcc create role . "销售经理"
 
 # 创建带描述的角色
-cc create role . "市场专员" "负责市场推广工作"
+cloudcc create role . "市场专员" "负责市场推广工作"
 ```
 
 ---
@@ -51,7 +51,7 @@ cc create role . "市场专员" "负责市场推广工作"
 获取当前环境中的所有角色列表。
 
 ```bash
-cc get role <projectPath> [encodedCondJson]
+cloudcc get role <projectPath> [encodedCondJson]
 ```
 
 **参数说明：**
@@ -65,10 +65,10 @@ cc get role <projectPath> [encodedCondJson]
 
 ```bash
 # 获取所有角色
-cc get role .
+cloudcc get role .
 
 # 带查询条件
-cc get role . '%7B%22name%22%3A%22%E9%94%80%E5%94%AE%22%7D'
+cloudcc get role . '%7B%22name%22%3A%22%E9%94%80%E5%94%AE%22%7D'
 ```
 
 ---
@@ -78,7 +78,7 @@ cc get role . '%7B%22name%22%3A%22%E9%94%80%E5%94%AE%22%7D'
 删除指定的角色。
 
 ```bash
-cc delete role <projectPath> <roleId>
+cloudcc delete role <projectPath> <roleId>
 ```
 
 **参数说明：**
@@ -92,7 +92,7 @@ cc delete role <projectPath> <roleId>
 
 ```bash
 # 删除指定角色
-cc delete role . a0I9D000000XXXXUAI
+cloudcc delete role . a0I9D000000XXXXUAI
 ```
 
 ---
@@ -106,17 +106,17 @@ cc delete role . a0I9D000000XXXXUAI
 cat cloudcc-cli.config.js
 
 # 2. 查询现有角色
-cc get role .
+cloudcc get role .
 
 # 3. 创建新角色
-cc create role . "销售经理"
-cc create role . "销售代表"
+cloudcc create role . "销售经理"
+cloudcc create role . "销售代表"
 
 # 4. 验证角色创建成功
-cc get role .
+cloudcc get role .
 
 # 5. 如需删除
-# cc delete role . <roleId>
+# cloudcc delete role . <roleId>
 ```
 
 ---

package/src/role/get.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 查询角色列表
- * 用法：cc get role <projectPath> [encodedCondJson]
+ * 用法：cloudcc get role <projectPath> [encodedCondJson]
  * 接口：POST /api/role/queryRole
  * 默认参数：{ display: "list" }
  */

package/src/scheduleJob/doc.js

@@ -28,7 +28,7 @@ function getDevGuideDoc() {
 }
 
 /**
- * cc doc scheduleJob <introduction|devguide>
+ * cloudcc doc scheduleJob <introduction|devguide>
  * @param {string[]} argvs [doc, type, introduction|devguide, ...]
  */
 function doc(argvs = []) {