cloudcc-cli 2.3.6 → 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
@@ -84,8 +84,8 @@ cloudcc <动作 action> <资源 resource> <其余参数 ...>
 
 ## MCP 与 `package.json` bin
 
-- **`package.json` 的 `bin`** 注册 **`cc`** 与 **`cloudcc`**（同一 `bin/cc.js`，Unix 上推荐 `cloudcc` 以免与系统 C 编译器 `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`。
 
 ---
 
@@ -123,7 +123,7 @@ cloudcc <动作 action> <资源 resource> <其余参数 ...>
 2. 新建或扩展 `src/<resource>/`，实现 `index.js` 及所需 `get`/`create`/… 子文件。
 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` / `cloudcc --help`、`cloudcc <action> -h`；若 MCP 通过 `cliRunner` 调 **`cloudcc`**，确认参数顺序与文档一致。
+5. 自测：`node bin/cc.js <动作> <resource> …`、`cloudcc --help` / `cc --help`、`cloudcc <action> -h`；若 MCP 通过 `cliRunner` 调 **`cloudcc`**，确认参数顺序与文档一致。
 
 ---
 
@@ -131,10 +131,16 @@ cloudcc <动作 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.6`）中**增补或修订** `#### Release Content`（及必要时同一节内的日期说明），把新变更写进**现有版本**的日志里。  
+- **若不需要升版**：**不要**修改 `package.json` 与 `package-lock.json` 的 `version`；只在 **`README.md` 里与当前 `package.json.version` 一致**的那一节 `# ReleaseV…`（例如已是 `# ReleaseV2.3.7`）中**增补或修订** `#### Release Content`（及必要时同一节内的日期说明），把新变更写进**现有版本**的日志里；**增补/修订的正文仍须英文**（见「Release log language」）。  
 - **若需要升版**：再执行下面的「升版 + 新节」流程。
 
 ### 升版 + 新 Release 节（仅在用户确认要发版时）
@@ -145,7 +151,7 @@ cloudcc <动作 action> <资源 resource> <其余参数 ...>
 
 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`  
@@ -170,6 +176,6 @@ cloudcc <动作 action> <资源 resource> <其余参数 ...>
 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 规则从 `cloudcc permission:*` 调整为 `cloudcc assign permission:*` 等新模式（若仍使用 Claude 相关自动化）。
-6. **`bin/cc.js` 全局能力**：`--help`/`help`、`doctor`、`docs`、`init`（别名 `create project`）、`cloudcc <action> -h`；`package.json` **不**注册 `cc-mcp`，MCP 用 `node` + `bin/mcp.js` 路径。
+6. **`bin/cc.js` 全局能力**：`--help`/`help`、`doctor`、`docs`、`init`（别名 `create project`）、`cloudcc <action> -h`；MCP 通过 **`cc-mcp`** 或 **`node` + `bin/mcp.js`** 启动。
 
 实现新功能时，**以本节与上文「命令行结构」为准**，勿再引入「首词为资源名」的并行体系。

package/README.md

@@ -38,7 +38,21 @@ Run **`cloudcc --help`** or **`cc --help`** for the full command list: modules f
 
 ## 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
 {
@@ -51,12 +65,25 @@ Run **`cloudcc --help`** or **`cc --help`** for the full command list: modules f
 }
 ```
 
-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
@@ -86,7 +113,7 @@ echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 - CLI
   - 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`
-  - Removed `cc-mcp` from `package.json` `bin`; MCP is documented to use `node` and `bin/mcp.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
 - MCP

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.3.6",
+  "version": "2.3.7",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",
@@ -13,7 +13,8 @@
     "cloudccCreate": "bin/project.js",
     "cloudccBuild": "bin/plugin.js",
     "cc": "bin/cc.js",
-    "cloudcc": "bin/cc.js"
+    "cloudcc": "bin/cc.js",
+    "cc-mcp": "bin/mcp.js"
   },
   "scripts": {
     "test-cli-one": "node --test test/globalSelectList.cli.test.js",

package/src/project/docs/devguide.md

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