cloudcc-cli 2.3.5 → 2.3.7

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

@@ -4,7 +4,7 @@ description: >-
   Defines how cloudcc-cli extends the `cc` command: argv shape, `bin/cc.js` entry
   (global flags, doctor/docs/init, action-level `-h`), `bin/index.js` Proxy routing,
   `src/version/listModuleCommands.js` for `--help`, per-resource `src/<resource>/index.js`
-  dispatch, and MCP via `node` + `bin/mcp.js` (no `cc-mcp` bin). Release / changelog:
+  dispatch, and MCP via `cc-mcp` (→ `bin/mcp.js`) or `node` + absolute path to `bin/mcp.js`.   Release / changelog in `README.md` must be **English only** (`# ReleaseV…` sections);
   ask whether to bump version; if not, only edit the existing `# ReleaseV…` for the
   current version in `README.md`. Use when adding or modifying CLI commands,
   subcommands, or modules in this repo, or when the user mentions cloudcc-cli
@@ -18,7 +18,7 @@ description: >-
 全局约定：
 
 ```text
-cc <动作 action> <资源 resource> <其余参数 ...>
+cloudcc <动作 action> <资源 resource> <其余参数 ...>
 ```
 
 - `argvs[0]` = 动作（如 `get`、`create`、`doc`、`assign` 等，随业务扩展）
@@ -27,11 +27,11 @@ cc <动作 action> <资源 resource> <其余参数 ...>
 
 示例：
 
-- `cc get object …` → `modules.object('get', argvs)`
-- `cc assign permission …` → `modules.permission('assign', argvs)`
-- `cc doc menu …` → `modules.menu('doc', argvs)`
+- `cloudcc get object …` → `modules.object('get', argvs)`
+- `cloudcc assign permission …` → `modules.permission('assign', argvs)`
+- `cloudcc doc menu …` → `modules.menu('doc', argvs)`
 
-权限模块曾使用旧写法 `cc permission assign …`（资源不在第二位），已废弃，见下文「历史调整摘要」。
+权限模块曾使用旧写法 `cloudcc permission assign …`（资源不在第二位），已废弃，见下文「历史调整摘要」。
 
 ---
 
@@ -60,32 +60,32 @@ cc <动作 action> <资源 resource> <其余参数 ...>
 | `uninstall`（且无第二参数） | `src/version/uninstall.js` 全局卸载 |
 | `doctor`（且无第二参数） | `src/version/doctor.js` 环境自检（Node、配置、版本） |
 | `docs`（且无第二参数） | `src/version/docs.js` 打开帮助中心浏览器页 |
-| `init …` | **等价** `cc create project …`（重写 `argvs` 后走主流程） |
+| `init …` | **等价** `cloudcc create project …`（重写 `argvs` 后走主流程） |
 | `init` + `-h` / `--help` | `src/version/initHelp.js` 简短说明 |
 | 任意 `action` + 第二参数为 `-h` / `--help` | `src/version/actionHelp.js`：列出支持该 **action** 的 **resource**（数据来自 `listModuleCommands`） |
 
-**无参 / 缺 resource**：仅输入 `cc` 时提示用法并指向 `cc --help`；仅输入 `cc <action>`（缺 `argvs[1]`）时提示补全 `resource`，并提示可用 `cc <action> -h`。
+**无参 / 缺 resource**：仅输入 `cc` 时提示用法并指向 `cloudcc --help`；仅输入 `cloudcc <action>`（缺 `argvs[1]`）时提示补全 `resource`，并提示可用 `cloudcc <action> -h`。
 
-**注意**：`doctor`、`docs`、`actionHelp`、`initHelp` **不要**挂到 `src/version/index.js` 的 `cc.*` 上，否则 `cc --help` 里通过解析 `index.js` 会误出现 `cc doctor version` 等行。它们由 `cc.js` **直接 `require`** 对应文件执行。
+**注意**：`doctor`、`docs`、`actionHelp`、`initHelp` **不要**挂到 `src/version/index.js` 的 `cc.*` 上，否则 `cloudcc --help` 里通过解析 `index.js` 会误出现 `cloudcc doctor version` 等行。它们由 `cc.js` **直接 `require`** 对应文件执行。
 
 ---
 
 ## `--help` 与模块清单（`src/version/`）
 
-- **`help.js`**：打印 Usage、Global 区、**按模块罗列** `cc <action> <resource>`；模块与顺序与 `bin/index.js` 的 `modules` 一致（见 `listModuleCommands.js`）。
+- **`help.js`**：打印 Usage、Global 区、**按模块罗列** `cloudcc <action> <resource>`；模块与顺序与 `bin/index.js` 的 `modules` 一致（见 `listModuleCommands.js`）。
 - **`listModuleCommands.js`**：
   - 从各资源目录 `index.js` **正则解析** `cc.<action> =` 得到 action 列表（与实现同步）。
   - **`MODULE_HINT`**：模块一句话说明；`schedule` / `timer` 合并为一组展示。
   - **`describeActionLine(resource, action)`**：行尾中文说明（替代省略号）。
-  - **`getResourcesForAction(action)`**：供 `cc <action> -h` 列出 resource。
+  - **`getResourcesForAction(action)`**：供 `cloudcc <action> -h` 列出 resource。
 - 新增 **resource** 时：除改 `bin/index.js` 外，须在 `listModuleCommands.js` 中维护 **`MODULE_KEYS_ORDER`** 与 **`MODULE_FOLDER`**（及必要时 **`MODULE_HINT`**、**`RESOURCE_CN`**）。
 
 ---
 
 ## MCP 与 `package.json` bin
 
-- **`package.json` 的 `bin`** 仅注册 `cc`（及 `cloudccCreate`、`cloudccBuild` 等），**不**注册 `cc-mcp`。
-- MCP 启动使用 **`node`** + **`cloudcc-cli` 包内 `bin/mcp.js` 的绝对路径**（全局安装路径可用 `$(npm root -g)/cloudcc-cli/bin/mcp.js` 拼接）。详见仓库 `README.md` / `src/project/docs/devguide.md`。
+- **`package.json` 的 `bin`** 注册 **`cc`** 与 **`cloudcc`**（同一 `bin/cc.js`）、**`cc-mcp`**（→ `bin/mcp.js`）、`cloudccCreate`、`cloudccBuild` 等。
+- MCP：**推荐**全局安装后 **`PATH` 上直接使用 `cc-mcp`**（与常见 `mcp.json` 里 `"command": "cc-mcp"` 一致）；**亦可**用 **`node`** + **`bin/mcp.js` 绝对路径**（`$(npm root -g)/cloudcc-cli/bin/mcp.js`）。详见 `README.md` / `src/project/docs/devguide.md`。
 
 ---
 
@@ -113,7 +113,7 @@ cc <动作 action> <资源 resource> <其余参数 ...>
 
 子文件（`get.js`、`create.js` …）从 **`argvs`** 解析路径与业务参数（通常从 `argvs[2]` 开始，依各命令文档）。
 
-新增动作时：增加 `cc.<新动作> = require("./新文件")`，并保证与全局 `cc <动作> <资源>` 一致。
+新增动作时：增加 `cc.<新动作> = require("./新文件")`，并保证与全局 `cloudcc <动作> <资源>` 一致。
 
 ---
 
@@ -121,9 +121,9 @@ cc <动作 action> <资源 resource> <其余参数 ...>
 
 1. 在 `bin/index.js` 的 **`modules`** 中注册资源（key = CLI 第二段单词）。
 2. 新建或扩展 `src/<resource>/`，实现 `index.js` 及所需 `get`/`create`/… 子文件。
-3. 若有 `doc`，在 `src/<resource>/doc.js` 与 `docs/` 中维护说明；通过 `cc doc <resource>` 可读。
-4. 更新 `src/version/listModuleCommands.js`：**`MODULE_KEYS_ORDER`**、**`MODULE_FOLDER`**，必要时 **`MODULE_HINT`**、**`RESOURCE_CN`**、**`describeActionLine`** 中的映射，保证 `cc --help` 与 `cc <action> -h` 正确。
-5. 自测：`node bin/cc.js <动作> <resource> …`、`cc --help`、`cc <action> -h`；若 MCP 通过 `cliRunner` 调 `cc`，确认参数顺序与文档一致。
+3. 若有 `doc`，在 `src/<resource>/doc.js` 与 `docs/` 中维护说明；通过 `cloudcc doc <resource>` 可读。
+4. 更新 `src/version/listModuleCommands.js`：**`MODULE_KEYS_ORDER`**、**`MODULE_FOLDER`**，必要时 **`MODULE_HINT`**、**`RESOURCE_CN`**、**`describeActionLine`** 中的映射，保证 `cloudcc --help` 与 `cloudcc <action> -h` 正确。
+5. 自测：`node bin/cc.js <动作> <resource> …`、`cloudcc --help` / `cc --help`、`cloudcc <action> -h`；若 MCP 通过 `cliRunner` 调 **`cloudcc`**，确认参数顺序与文档一致。
 
 ---
 
@@ -131,21 +131,27 @@ cc <动作 action> <资源 resource> <其余参数 ...>
 
 在**写入或更新开发日志**（`README.md` 中的 `# ReleaseV…`）时，**以后均照此执行**：
 
+### Release log language（变更日志语言 — 强制）
+
+- **整节 `# ReleaseV…` 必须使用英文**：`#### Release Date`、`#### Release Scope`、`#### Release Content` 下的**所有列表与说明**均为英文；**不要**中英混写或整段中文。  
+- **原因**：`cc --version` 与注册表版本检查会从 README 解析这些块并在终端输出（`utils/readmeReleases.js` / `formatReleaseNotes.js`），英文便于统一展示与检索。  
+- **维护**：若某历史节仍为中文，在**编辑该节时**改为英文；不要求一次性翻完全部旧节，但**新增或修改的 Release 内容**一律英文。
+
 ### 必须先确认：是否升级版本号
 
 - **向用户询问**：本次是否需要**升级 `package.json` / `package-lock.json` 的版本号**（新一次发版）？  
-- **若不需要升版**：**不要**修改 `package.json` 与 `package-lock.json` 的 `version`；只在 **`README.md` 里与当前 `package.json.version` 一致**的那一节 `# ReleaseV…`（例如已是 `# ReleaseV2.3.5`）中**增补或修订** `#### Release Content`（及必要时同一节内的日期说明），把新变更写进**现有版本**的日志里。  
+- **若不需要升版**：**不要**修改 `package.json` 与 `package-lock.json` 的 `version`；只在 **`README.md` 里与当前 `package.json.version` 一致**的那一节 `# ReleaseV…`（例如已是 `# ReleaseV2.3.7`）中**增补或修订** `#### Release Content`（及必要时同一节内的日期说明），把新变更写进**现有版本**的日志里；**增补/修订的正文仍须英文**（见「Release log language」）。  
 - **若需要升版**：再执行下面的「升版 + 新节」流程。
 
 ### 升版 + 新 Release 节（仅在用户确认要发版时）
 
-1. **版本号**（与 `cc --version` / `package.json` 一致）  
+1. **版本号**（与 `cloudcc --version` / `package.json` 一致）  
    - 在 **`package.json`** 中将 **`version`** 升为下一号（通常 patch `x.y.(z+1)`；破坏性变更再升 minor/major）。  
    - 同步 **`package-lock.json`** 根包 **`""`** 的 **`version`**（以及文件最顶部 `name`/`version` 字段，若存在），避免锁文件与 `package.json` 不一致。
 
 2. **README.md 变更日志**  
    - 在 **`README.md`** 中、**紧接「Usage Guide / CLI overview / MCP」等说明之后**、**旧版 Release 区块之上**，**插入新的** `# ReleaseV<主版本>.<次版本>.<补丁>` 一节（版本号与新的 `package.json` 一致）。  
-   - **新发布节全文使用英文**（标题、Release Date、Scope、Content 列表）。  
+   - **本节内容与上文「Release log language」一致：全文英文**（含标题行、Date、Scope、Content）。  
    - 结构建议：  
      - `# ReleaseVx.y.z`  
      - `#### Release Date: YYYY-M-D`  
@@ -167,9 +173,9 @@ cc <动作 action> <资源 resource> <其余参数 ...>
 
 1. **`bin/cc.js`**：业务命令仍统一为 `await cc[action](argvs)`（`cc` 来自 `./index`）；**全局/帮助类**（`--help`、`doctor`、`init` 等）在加载 `./index` **之前**分支；旧版在入口为 `permission` 单独写 `if` 的方式已废弃。
 2. **`bin/index.js`**：由「直接导出 `cc` 对象」改为 **`modules` + `Proxy`**，以支持以 **第一个单词为动作** 的路由；`doc` 对资源名做存在性校验。
-3. **`permission` 命令语义**：由旧的 `cc permission assign|add|remove`（资源不在第二位）改为符合全局约定的 **`cc assign permission`、`cc add permission`、`cc remove permission`**；`cc get permission` 保持不变。
+3. **`permission` 命令语义**：由旧的 `cloudcc permission assign|add|remove`（资源不在第二位）改为符合全局约定的 **`cloudcc assign permission`、`cloudcc add permission`、`cloudcc remove permission`**；`cloudcc get permission` 保持不变。
 4. **`src/permission/index.js`**：与 `pagelayout` 等资源对齐，使用 **`cc` 子对象 + `main(action, argvs)`** 分发，去掉仅服务于旧写法的单参数 argv 分支。
-5. **`.claude/settings.json`** 等：允许/bash 规则从 `cc permission:*` 调整为 `cc assign permission:*` 等新模式（若仍使用 Claude 相关自动化）。
-6. **`bin/cc.js` 全局能力**：`--help`/`help`、`doctor`、`docs`、`init`（别名 `create project`）、`cc <action> -h`；`package.json` **不**注册 `cc-mcp`，MCP 用 `node` + `bin/mcp.js` 路径。
+5. **`.claude/settings.json`** 等：允许/bash 规则从 `cloudcc permission:*` 调整为 `cloudcc assign permission:*` 等新模式（若仍使用 Claude 相关自动化）。
+6. **`bin/cc.js` 全局能力**：`--help`/`help`、`doctor`、`docs`、`init`（别名 `create project`）、`cloudcc <action> -h`；MCP 通过 **`cc-mcp`** 或 **`node` + `bin/mcp.js`** 启动。
 
 实现新功能时，**以本节与上文「命令行结构」为准**，勿再引入「首词为资源名」的并行体系。

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

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

package/README.md

@@ -10,24 +10,49 @@ npm i -g cloudcc-cli
 sudo npm i -g cloudcc-cli
 ```
 
+Verify the install (recommended on macOS/Linux — use **`cloudcc`** so it is not confused with the system C compiler **`cc`**):
+
+```bash
+cloudcc --version
+# or (same binary, alternate name)
+cc --version
+```
+
 ## CLI overview
 
-The `cc` entry point (`bin/cc.js`) has two layers:
+The CLI ships two global command names for the same entry (`bin/cc.js`): **`cc`** and **`cloudcc`**. On macOS/Linux, **`cloudcc`** is recommended so it does not collide with the system C compiler (`/usr/bin/cc` is often clang/gcc). **`cc`** remains for backward compatibility.
+
+Both names expose two layers:
 
-1. **Global / maintenance commands** (handled before the `action + resource` router): `--help` / `-h` / `cc help`, `--version` / `-v`, `update`, `uninstall`, `doctor`, `docs`, `stats` (local command usage statistics), `init` (equivalent to `cc create project`), and `cc <action> -h` or `cc <action> --help` to list **resources** that support the given **action**.
-2. **Business commands**: `cc <action> <resource> [...]` dispatched through `bin/index.js` (Proxy) to `src/<resource>/index.js`.
+1. **Global / maintenance commands** (handled before the `action + resource` router): `--help` / `-h` / `cloudcc help`, `--version` / `-v`, `update`, `uninstall`, `doctor`, `docs`, `stats` (local command usage statistics), `init` (equivalent to `cloudcc create project`), and `cloudcc <action> -h` or `cloudcc <action> --help` to list **resources** that support the given **action**.
+2. **Business commands**: `cloudcc <action> <resource> [...]` dispatched through `bin/index.js` (Proxy) to `src/<resource>/index.js`.
 
-Run **`cc --help`** for the full command list: modules follow `bin/index.js` `modules` keys, with short module hints and per-line descriptions maintained in `src/version/listModuleCommands.js`. When you add a resource, update **`MODULE_KEYS_ORDER`** and **`MODULE_FOLDER`** (and optional **`MODULE_HINT`** / **`RESOURCE_CN`** / **`describeActionLine`**) so `--help` and `cc <action> -h` stay accurate.
+Run **`cloudcc --help`** or **`cc --help`** for the full command list: modules follow `bin/index.js` `modules` keys, with short module hints and per-line descriptions maintained in `src/version/listModuleCommands.js`. When you add a resource, update **`MODULE_KEYS_ORDER`** and **`MODULE_FOLDER`** (and optional **`MODULE_HINT`** / **`RESOURCE_CN`** / **`describeActionLine`**) so `--help` and `cloudcc <action> -h` stay accurate.
 
-**Implementation note:** `doctor`, `docs`, `stats`, `actionHelp`, and `initHelp` are **not** attached to `src/version/index.js` as `cc.*` handlers; `cc.js` loads them directly so the generated help does not show misleading lines such as `cc doctor version`.
+**Implementation note:** `doctor`, `docs`, `stats`, `actionHelp`, and `initHelp` are **not** attached to `src/version/index.js` as `cc.*` handlers; `cc.js` loads them directly so the generated help does not show misleading lines such as `cloudcc doctor version`.
 
 ## Version output and changelog
 
-When you run **`cc --version`** / **`-v`** or when the built-in **version check** compares your install to the npm registry (e.g. during `cc update` / `checkUpdate`), the CLI prints the relevant **`# ReleaseV…`** sections from the package **`README.md`** (parsed at runtime via `utils/readmeReleases.js`). Output is rendered with **`utils/formatReleaseNotes.js`**: terminal-width wrapping, continuation lines aligned under the bullet text, and inline `` `code` `` spans kept intact so styling does not break across lines.
+- **`cloudcc --version`** / **`-v`**: prints the installed version string only (no embedded release notes).
+- **Registry version check** (`utils/checkVersion.js`, e.g. during **`cloudcc update`** or **`checkUpdate`** on pull/create flows): after comparing to npm, **only if a newer package exists** does the CLI print the relevant **`# ReleaseV…`** sections from **`README.md`** for versions **strictly after** the current install through **latest** (`utils/readmeReleases.js` → **`getReleasesBetween`**). If you are already up to date, no release block is printed (the panel still links to npm changelog). Rendering uses **`utils/formatReleaseNotes.js`**: terminal-width wrapping, aligned continuation lines, and safe inline `` `code` `` handling.
 
 ## MCP configuration
 
-`package.json` **does not** publish a `cc-mcp` binary. Start the MCP server with **Node** and the path to the bundled script:
+After **`npm i -g cloudcc-cli`**, the package publishes a **`cc-mcp`** binary (→ `bin/mcp.js`). If your IDE **`mcp.json`** uses a command name (not `node` + `args`), use:
+
+```json
+{
+  "mcpServers": {
+    "cloudcc-cli": {
+      "command": "cc-mcp"
+    }
+  }
+}
+```
+
+Ensure the npm global bin directory is on **`PATH`** (same as for `cloudcc` / `cc`). On Windows the shim is typically **`cc-mcp.cmd`**.
+
+**Alternative** (explicit Node + script path):
 
 ```json
 {
@@ -40,12 +65,43 @@ When you run **`cc --version`** / **`-v`** or when the built-in **version check*
 }
 ```
 
-After a global install, resolve the script path on macOS/Linux with:
+Resolve the script path on macOS/Linux with:
 
 ```bash
 echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 ```
 
+# ReleaseV2.3.7
+
+#### Release Date: 2026-4-1
+
+#### Release Scope: Full
+
+#### Release Content
+
+- MCP
+  - **`cc-mcp`** (`package.json` → `bin/mcp.js`) is the recommended way to start the MCP server from IDE **`mcp.json`**; README **MCP configuration**, `src/project/docs/devguide.md` (section 5 and checklist), and **`.cursor/skills/cloudcc-cli-dev/SKILL.md`** are aligned, with **`node` + absolute path to `bin/mcp.js`** still documented as an alternative
+- Documentation
+  - Release notes and **`package.json` / npm** version aligned to **2.3.7**
+
+# ReleaseV2.3.6
+
+#### Release Date: 2026-4-1
+
+#### Release Scope: Full
+
+#### Release Content
+
+- CLI
+  - **`cloudcc` bin** (same entry as `cc` / `bin/cc.js`): avoids clashing with the system C compiler on Unix; MCP **`mcp/cliRunner.js`** spawns **`cloudcc`** / **`cloudcc.cmd`**
+  - **Command usage statistics** (default on): records `cloudcc <action> <resource>`-style keys (e.g. `` `cloudcc doc classes` `` for `` `cloudcc doc classes devguide` ``) in `` `~/.cloudcc-cli/command-stats.json` `` via **`utils/commandStats.js`** and **`bin/cc.js`**; run **`cloudcc stats`** to view; set **`CLOUDCC_CLI_STATS=0`** / **`false`** / **`off`** to disable
+  - Terminal hints / **`cloudcc --help`** output: user-facing examples prefer **`cloudcc`**; **`cc`** remains an alias
+  - **Changelog in terminal**: README **`# ReleaseV…`** excerpts print **only when the registry reports a newer version** than the running install (`utils/checkVersion.js`); **`cloudcc --version`** no longer dumps the current release section
+- Documentation
+  - README: post-install **`cloudcc --version`** / **`cc --version`** check; **`cloudcc --help`** vs **`cc --help`** wording; CLI overview and release log structure updates
+  - **`src/**/docs/*.md`** and inline CLI usage strings: examples use **`cloudcc`** where a shell command is shown (internal code patterns **`cc.*`** unchanged)
+  - Cursor skills (**`cloudcc-cli-dev`**, **`cloudcc-dev-skill`**) aligned with **`cloudcc`** / **`cc`** dual entry
+
 # ReleaseV2.3.5
 
 #### Release Date: 2026-4-1
@@ -55,12 +111,11 @@ echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 #### Release Content
 
 - CLI
-  - Global commands: `doctor`, `docs`, `cc help`, `init` (alias for `cc create project`), clearer empty-argv / missing-resource hints, and `cc <action> -h` to list resources for an action
-  - Richer `cc --help`: grouped modules, hints, and per-command descriptions via `src/version/listModuleCommands.js`
-  - Removed `cc-mcp` from `package.json` `bin`; MCP is documented to use `node` and `bin/mcp.js`
-  - Version checks and **`cc --version`** show **`# ReleaseV…`** blocks from **`README.md`** (`utils/readmeReleases.js`); `utils/checkVersion.js` prints notes when comparing to the registry
+  - Global commands: `doctor`, `docs`, `cloudcc help`, `init` (alias for `cloudcc create project`), clearer empty-argv / missing-resource hints, and `cloudcc <action> -h` to list resources for an action
+  - Richer `cloudcc --help`: grouped modules, hints, and per-command descriptions via `src/version/listModuleCommands.js`
+  - `cc-mcp` was temporarily removed from `package.json` `bin` in favor of `node` + `bin/mcp.js` only; **`cc-mcp` was restored in v2.3.6**; **v2.3.7** aligns README, project devguide, and **`cloudcc-cli-dev` SKILL** with **`"command": "cc-mcp"`** setup docs
+  - Version checks compare to the registry; **`# ReleaseV…`** excerpts from **`README.md`** were shown together with that check (behavior refined in v2.3.6: notes only when an upgrade exists)
   - Terminal-friendly release notes: width-aware wrapping, aligned continuation lines, **`utils/formatReleaseNotes.js`** styling, and safe handling of inline `` `code` `` when wrapping
-  - **Command usage statistics** (default on): records `cc <action> <resource>`-style keys (e.g. `` `cc doc classes` `` for `` `cc doc classes devguide` ``) in `` `~/.cloudcc-cli/command-stats.json` `` via **`utils/commandStats.js`** and **`bin/cc.js`**; run **`cc stats`** to view; set **`CLOUDCC_CLI_STATS=0`** / **`false`** / **`off`** to disable
 - MCP
   - New tool **`get_jsp_migration_rules`**: returns fixed JSP migration rules (resolve JSP under `customize` from `name=` URLs, suggested batch flow, **`PageClsInvoker`** invocation patterns); **`analyze_jsp_migration`** / **`split_jsp_to_cloudcc`** descriptions updated to recommend calling it before batch migration
 - Documentation

package/bin/cc.js

@@ -21,16 +21,16 @@ function runVersion(subAction, argvSlice) {
 
 function hintCcHelp() {
   console.error()
-  console.error(chalk.yellow("用法：") + chalk.green(" cc ") + chalk.gray("<action> <resource> [args...]"))
-  console.error(chalk.gray("完整帮助：") + chalk.green("cc --help") + chalk.gray(" 或 ") + chalk.green("cc -h") + chalk.gray(" 或 ") + chalk.green("cc help"))
+  console.error(chalk.yellow("用法：") + chalk.green(" cloudcc ") + chalk.gray("<action> <resource> [args...]"))
+  console.error(chalk.gray("完整帮助：") + chalk.green("cloudcc --help") + chalk.gray(" 或 ") + chalk.green("cloudcc -h") + chalk.gray(" 或 ") + chalk.green("cloudcc help"))
   console.error()
 }
 
 function hintMissingResource(act) {
   console.error()
-  console.error(chalk.yellow("缺少 resource：") + chalk.green(`cc ${act} <resource> ...`))
-  console.error(chalk.gray("查看该 action 下可用的 resource：") + chalk.green(`cc ${act} -h`))
-  console.error(chalk.gray("查看全部命令：") + chalk.green("cc --help"))
+  console.error(chalk.yellow("缺少 resource：") + chalk.green(`cloudcc ${act} <resource> ...`))
+  console.error(chalk.gray("查看该 action 下可用的 resource：") + chalk.green(`cloudcc ${act} -h`))
+  console.error(chalk.gray("查看全部命令：") + chalk.green("cloudcc --help"))
   console.error()
 }
 
@@ -117,7 +117,7 @@ async function runWithArgvs(argv) {
     await cc[act](argv)
   } catch (e) {
     console.error()
-    console.error(chalk.yellow("请查看帮助：cc --help"), e)
+    console.error(chalk.yellow("请查看帮助：cloudcc --help"), e)
     console.error()
   }
 }

package/mcp/cliRunner.js

@@ -1,11 +1,11 @@
 const { spawnSync } = require("child_process");
 
 const CC_NOT_FOUND_HINT =
-    "未找到 cc 命令。请将 cloudcc-cli 全局安装并确保 PATH 可用：npm install -g cloudcc-cli";
+    "未找到 cloudcc 命令。请将 cloudcc-cli 全局安装并确保 PATH 可用：npm install -g cloudcc-cli（与系统 C 编译器 cc 区分，请使用 cloudcc）";
 
 function runCcCommand(args, options = {}) {
     const { cwd = process.cwd(), timeoutMs = 120000 } = options;
-    const ccCommand = process.platform === "win32" ? "cc.cmd" : "cc";
+    const ccCommand = process.platform === "win32" ? "cloudcc.cmd" : "cloudcc";
 
     const result = spawnSync(ccCommand, args, {
         cwd,

package/mcp/tools/Application Creator/handler.js

@@ -59,7 +59,7 @@ async function createApplicationTool(params = {}) {
             return {
                 content: [{
                     type: 'text',
-                    text: `⚠ 应用创建遇到问题\n\n${buildRunDetail(runResult) || 'cc 命令执行失败'}\n\n请检查:\n1. 应用名称和应用代码是否符合规范\n2. CloudCC服务器连接是否正常\n3. 项目配置是否正确\n4. 是否有足够的权限创建应用\n5. 菜单ID是否正确`
+                    text: `⚠ 应用创建遇到问题\n\n${buildRunDetail(runResult) || 'cloudcc 命令执行失败'}\n\n请检查:\n1. 应用名称和应用代码是否符合规范\n2. CloudCC服务器连接是否正常\n3. 项目配置是否正确\n4. 是否有足够的权限创建应用\n5. 菜单ID是否正确`
                 }]
             };
         }

package/mcp/tools/Approval/handler.js

@@ -44,7 +44,7 @@ async function getPendingApprovals({
         const run = runCcJsonCommand(['get', 'approval', process.cwd(), encoded]);
         if (!run.success) {
             return {
-                content: [{ type: 'text', text: `✗ 拉取待审批记录失败: ${run.detail || 'cc 命令执行失败'}` }]
+                content: [{ type: 'text', text: `✗ 拉取待审批记录失败: ${run.detail || 'cloudcc 命令执行失败'}` }]
             };
         }
         const result = run.data || {};
@@ -100,7 +100,7 @@ async function approveRecord({
         const run = runCcJsonCommand(['approve', 'approval', process.cwd(), encoded]);
         if (!run.success) {
             return {
-                content: [{ type: 'text', text: `✗ 审批通过失败: ${run.detail || 'cc 命令执行失败'}` }]
+                content: [{ type: 'text', text: `✗ 审批通过失败: ${run.detail || 'cloudcc 命令执行失败'}` }]
             };
         }
         const result = run.data || { success: true };
@@ -153,7 +153,7 @@ async function rejectRecord({ confirm, objid, comment = '', workItemId, token =
         const run = runCcJsonCommand(['reject', 'approval', process.cwd(), encoded]);
         if (!run.success) {
             return {
-                content: [{ type: 'text', text: `✗ 拒绝审批失败: ${run.detail || 'cc 命令执行失败'}` }]
+                content: [{ type: 'text', text: `✗ 拒绝审批失败: ${run.detail || 'cloudcc 命令执行失败'}` }]
             };
         }
         const result = run.data || { success: true };

package/mcp/tools/Class Creator/handler.js

@@ -20,14 +20,14 @@ async function createClass({ className, projectPath = process.cwd() }) {
 
         if (!runResult.success) {
             const detail = [runResult.error, runResult.stderr, runResult.stdout].filter(Boolean).join('\n');
-            return { content: [{ type: 'text', text: `✗ 创建失败: ${detail || 'cc 命令执行失败'}` }] };
+            return { content: [{ type: 'text', text: `✗ 创建失败: ${detail || 'cloudcc 命令执行失败'}` }] };
         }
 
         const classPath = path.join(resolvedPath, `classes/${className}`);
         return {
             content: [{
                 type: 'text',
-                text: `✓ 创建成功！\n\n调用命令: cc create classes ${className}\n执行目录: ${resolvedPath}\n类路径: ${classPath}\n生成的文件:\n  - ${className}.java (主类文件)\n  - ${className}Test.java (测试类文件)\n  - config.json (配置文件)`
+                text: `✓ 创建成功！\n\n调用命令: cloudcc create classes ${className}\n执行目录: ${resolvedPath}\n类路径: ${classPath}\n生成的文件:\n  - ${className}.java (主类文件)\n  - ${className}Test.java (测试类文件)\n  - config.json (配置文件)`
             }]
         };
     } catch (error) {

package/mcp/tools/Class Detail Retriever/handler.js

@@ -19,7 +19,7 @@ async function getClassDetail({ className, classId, projectPath = process.cwd()
         const args = ['detail', 'classes', className || '', classId || ''];
         const run = runCcJsonCommand(args, { cwd: resolvedPath });
         if (!run.success) {
-            return { content: [{ type: 'text', text: `✗ 获取失败: ${run.detail || 'cc 命令执行失败'}` }] };
+            return { content: [{ type: 'text', text: `✗ 获取失败: ${run.detail || 'cloudcc 命令执行失败'}` }] };
         }
         return { content: [{ type: 'text', text: JSON.stringify(run.data, null, 2) }] };
     } catch (error) {

package/mcp/tools/Class Editor Guide/handler.js

@@ -40,7 +40,7 @@ async function editClass({ topic = 'devguide' } = {}) {
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 获取编辑指南失败: ${buildRunDetail(run) || 'cc 命令执行失败'}`
+                    text: `✗ 获取编辑指南失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}`
                 }]
             };
         }

package/mcp/tools/Class List Retriever/handler.js

@@ -14,7 +14,7 @@ async function listClasses({ projectPath = process.cwd() }) {
         const resolvedPath = path.resolve(projectPath);
         const run = runCcJsonCommand(['get', 'classes'], { cwd: resolvedPath });
         if (!run.success) {
-            return { content: [{ type: 'text', text: `✗ 查询失败: ${run.detail || 'cc 命令执行失败'}` }] };
+            return { content: [{ type: 'text', text: `✗ 查询失败: ${run.detail || 'cloudcc 命令执行失败'}` }] };
         }
         const classList = run.data || [];
 

package/mcp/tools/Class Publisher/handler.js

@@ -14,7 +14,7 @@ async function publishClass({ className, projectPath = process.cwd() }) {
         const resolvedPath = path.resolve(projectPath);
         const run = runCcCommand(['publish', 'classes', className], { cwd: resolvedPath });
         if (!run.success) {
-            return { content: [{ type: 'text', text: `✗ 发布失败: ${buildRunDetail(run) || 'cc 命令执行失败'}` }] };
+            return { content: [{ type: 'text', text: `✗ 发布失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}` }] };
         }
         return { content: [{ type: 'text', text: `✓ 发布成功！类 ${className} 已发布到服务器` }] };
     } catch (error) {

package/mcp/tools/Class Puller/handler.js

@@ -14,7 +14,7 @@ async function pullClass({ className, projectPath = process.cwd() }) {
         const resolvedPath = path.resolve(projectPath);
         const run = runCcCommand(['pull', 'classes', className], { cwd: resolvedPath });
         if (!run.success) {
-            return { content: [{ type: 'text', text: `✗ 拉取失败: ${buildRunDetail(run) || 'cc 命令执行失败'}` }] };
+            return { content: [{ type: 'text', text: `✗ 拉取失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}` }] };
         }
         return { content: [{ type: 'text', text: `✓ 拉取成功！本地文件已更新: classes/${className}/${className}.java` }] };
     } catch (error) {

package/mcp/tools/Client Script Detail Retriever/handler.js

@@ -21,7 +21,7 @@ async function getClientScriptDetail({ scriptPath, scriptId, projectPath = proce
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 获取失败: ${run.detail || 'cc 命令执行失败'}`
+                    text: `✗ 获取失败: ${run.detail || 'cloudcc 命令执行失败'}`
                 }]
             };
         }

package/mcp/tools/Client Script Editor Guide/handler.js

@@ -11,7 +11,7 @@ async function editClientScript({ topic = "overview" } = {}) {
             return {
                 content: [{
                     type: "text",
-                    text: `✗ 获取编辑指南失败: ${buildRunDetail(run) || "cc 命令执行失败"}`
+                    text: `✗ 获取编辑指南失败: ${buildRunDetail(run) || "cloudcc 命令执行失败"}`
                 }]
             };
         }

package/mcp/tools/Client Script List Retriever/handler.js

@@ -30,7 +30,7 @@ async function listClientScripts({ projectPath = process.cwd(), condition = {} }
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 查询失败: ${run.detail || 'cc 命令执行失败'}\n\n可能的原因:\n- 项目路径不正确\n- 网络连接问题\n- 服务器API不可用`
+                    text: `✗ 查询失败: ${run.detail || 'cloudcc 命令执行失败'}\n\n可能的原因:\n- 项目路径不正确\n- 网络连接问题\n- 服务器API不可用`
                 }]
             };
         }

package/mcp/tools/Client Script Publisher/handler.js

@@ -29,7 +29,7 @@ async function publishClientScript({ scriptPath, projectPath = process.cwd() })
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 发布失败: ${buildRunDetail(run) || 'cc 命令执行失败'}\n\n可能的原因:\n- 脚本文件不存在\n- 脚本格式不正确（必须包含 function main($CCDK, obj) 函数）\n- 网络连接问题\n- 服务器API不可用`
+                    text: `✗ 发布失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}\n\n可能的原因:\n- 脚本文件不存在\n- 脚本格式不正确（必须包含 function main($CCDK, obj) 函数）\n- 网络连接问题\n- 服务器API不可用`
                 }]
             };
         }

package/mcp/tools/Client Script Puller/handler.js

@@ -31,7 +31,7 @@ async function pullClientScript({ scriptPath, scriptId, projectPath = process.cw
         if (scriptId) {
             const run = runCcCommand(['pullList', 'script', scriptId, resolvedPath], { cwd: resolvedPath });
             if (!run.success) {
-                return { content: [{ type: 'text', text: `✗ 拉取失败: ${buildRunDetail(run) || 'cc 命令执行失败'}` }] };
+                return { content: [{ type: 'text', text: `✗ 拉取失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}` }] };
             }
             return {
                 content: [{
@@ -42,7 +42,7 @@ async function pullClientScript({ scriptPath, scriptId, projectPath = process.cw
         }
         const run = runCcCommand(['pull', 'script', scriptPath], { cwd: resolvedPath });
         if (!run.success) {
-            return { content: [{ type: 'text', text: `✗ 拉取失败: ${buildRunDetail(run) || 'cc 命令执行失败'}` }] };
+            return { content: [{ type: 'text', text: `✗ 拉取失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}` }] };
         }
         return {
             content: [{

package/mcp/tools/CloudCC Development Overview/handler.js

@@ -26,7 +26,7 @@ async function getCloudCCDevelopmentOverview({ }) {
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 获取 CloudCC 开发项目概要失败: ${buildRunDetail(run) || 'cc 命令执行失败'}`
+                    text: `✗ 获取 CloudCC 开发项目概要失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}`
                 }]
             };
         }

package/mcp/tools/Component Creator/handler.js

@@ -18,7 +18,7 @@ async function createCustomComponent({ pluginName, projectPath = process.cwd() }
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 创建失败: ${buildRunDetail(run) || 'cc 命令执行失败'}`
+                    text: `✗ 创建失败: ${buildRunDetail(run) || 'cloudcc 命令执行失败'}`
                 }]
             };
         }

package/mcp/tools/Component Detail Retriever/handler.js

@@ -21,7 +21,7 @@ async function getCustomComponentDetail({ pluginName, pluginId, projectPath = pr
             return {
                 content: [{
                     type: 'text',
-                    text: `✗ 获取失败: ${run.detail || 'cc 命令执行失败'}\n\n可能的原因:\n- 组件不存在\n- 组件名称或ID不正确\n- 网络连接问题`
+                    text: `✗ 获取失败: ${run.detail || 'cloudcc 命令执行失败'}\n\n可能的原因:\n- 组件不存在\n- 组件名称或ID不正确\n- 网络连接问题`
                 }]
             };
         }