cloudcc-cli 2.3.4 → 2.3.5

package/.claude/settings.json

@@ -20,7 +20,28 @@
       "Bash(node src/index.js profile --help)",
       "Bash(node src/index.js --help)",
       "Bash(echo \"Exit code: $?\")",
-      "Bash(ls -la *.json)"
+      "Bash(ls -la *.json)",
+      "Bash(node -c src/permission/index.js)",
+      "Bash(node -c src/permission/get.js)",
+      "Bash(node -c src/permission/assign.js)",
+      "Bash(node -c src/permission/add.js)",
+      "Bash(node -c src/permission/remove.js)",
+      "Bash(cc assign permission:*)",
+      "Bash(cc add permission:*)",
+      "Bash(cc remove permission:*)",
+      "Bash(\\))",
+      "Bash(:)",
+      "Bash(node bin/index.js get identityProvider)",
+      "Bash(/Users/chenwencai/Desktop/codeup/cloudcc-cli/cc get:*)",
+      "Bash(/Users/chenwencai/Desktop/codeup/cloudcc-cli/bin/cc.js)",
+      "Bash(/usr/local/bin/node bin/cc.js get identityProvider .)",
+      "Bash(/usr/local/bin/node bin/cc.js --help)",
+      "Bash(/usr/local/bin/node bin/cc.js token get .)",
+      "Bash(/Users/chenwencai/Desktop/codeup/cloudcc-cli/bin/cc.js get:*)",
+      "Bash(: true,)",
+      "Bash(CLOUDCC_USE=cdev node bin/cc.js get identityProvider)",
+      "Bash(: null,)",
+      "Bash(: null:*)"
     ]
   },
   "askForConfirmation": false,

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

@@ -0,0 +1,175 @@
+---
+name: cloudcc-cli-dev
+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:
+  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
+  structure, `cc` routing, new CLI features, or releases/changelog.
+---
+
+# cloudcc-cli 开发约定
+
+## 命令行结构（须保持一致）
+
+全局约定：
+
+```text
+cc <动作 action> <资源 resource> <其余参数 ...>
+```
+
+- `argvs[0]` = 动作（如 `get`、`create`、`doc`、`assign` 等，随业务扩展）
+- `argvs[1]` = 资源名，必须与 `bin/index.js` 里 `modules` 对象的 **key** 一致（如 `object`、`permission`、`pagelayout`）
+- `argvs[2]` 起 = 传给该资源子命令的参数
+
+示例：
+
+- `cc get object …` → `modules.object('get', argvs)`
+- `cc assign permission …` → `modules.permission('assign', argvs)`
+- `cc doc menu …` → `modules.menu('doc', argvs)`
+
+权限模块曾使用旧写法 `cc permission assign …`（资源不在第二位），已废弃，见下文「历史调整摘要」。
+
+---
+
+## `bin/cc.js`（入口）
+
+职责：
+
+1. 从 `process.argv` 取出 `argvs`（已 `splice(2)`）。
+2. **全局/维护命令**（**不**走 `bin/index.js` 的 `action + resource`）：在加载 `./index` 之前分支处理，见下节「全局命令与特例」。
+3. **主流程**：`await cc[action](argvs)`，其中 `cc` 来自 `./index`（`Proxy` 按 `argvs[1]` 选资源）。
+
+不要求在 `cc.js` 里为单个**业务**资源写分支；特例应消化在对应资源的 `index.js` 或 HTTP 层。与「帮助、自检、别名」相关的入口例外见下文。
+
+---
+
+## 全局命令与特例（`bin/cc.js`）
+
+下列命令在 **`modules` 路由之前** 处理，避免占用 `argvs[1]` 作为 resource：
+
+| 形式 | 行为 |
+|------|------|
+| `--help` / `-h` / `--h` | 调用 `src/version/help.js` 打印完整帮助 |
+| `help`（且无第二参数） | 同上 |
+| `-version` / `-v` / `--version` / `--v` | `src/version/get.js` 打印 CLI 版本 |
+| `update`（且无第二参数） | `src/version/update.js` 全局升级 |
+| `uninstall`（且无第二参数） | `src/version/uninstall.js` 全局卸载 |
+| `doctor`（且无第二参数） | `src/version/doctor.js` 环境自检（Node、配置、版本） |
+| `docs`（且无第二参数） | `src/version/docs.js` 打开帮助中心浏览器页 |
+| `init …` | **等价** `cc 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`。
+
+**注意**：`doctor`、`docs`、`actionHelp`、`initHelp` **不要**挂到 `src/version/index.js` 的 `cc.*` 上，否则 `cc --help` 里通过解析 `index.js` 会误出现 `cc doctor version` 等行。它们由 `cc.js` **直接 `require`** 对应文件执行。
+
+---
+
+## `--help` 与模块清单（`src/version/`）
+
+- **`help.js`**：打印 Usage、Global 区、**按模块罗列** `cc <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。
+- 新增 **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`。
+
+---
+
+## `bin/index.js`（按「动作」代理到「资源」）
+
+**必须**使用 `modules` 映射 + **`Proxy`** 导出，使任意合法 `action` 都对应一个函数 `(argvs) => …`，并在内部根据 **`argvs[1]`** 选择资源模块：
+
+- 对 `action === 'doc'`：若 `modules[type]` 不存在，抛出 `doc 不支持的类型: …`。
+- 其它动作：若 `modules[type]` 不存在，抛出 `不支持的类型: …`。
+- 否则调用：`modules[type](action, argvs)`。
+
+**禁止**仅 `module.exports = cc` 且只挂 `cc.object`、`cc.plugin` 等——那样 **`cc['get']` 不存在**，`await cc[action](argvs)` 会在 `get` 等动作上失败。
+
+新增资源时：在 `modules` 中增加一行，例如 `featureX: require("../src/featureX/index")`，并保证 CLI 上第二段参数与该 key 一致。
+
+---
+
+## `src/<resource>/index.js`（单资源入口）
+
+参照 `src/permission/index.js` / `src/pagelayout/index.js` 的写法：
+
+- 使用局部对象挂具体实现：`cc.get = require("./get")` 等。
+- `async function main(action, argvs) { await cc[action](argvs) }`（若子命令需返回值，可改为 `return await`）。
+- `module.exports = main`。
+
+子文件（`get.js`、`create.js` …）从 **`argvs`** 解析路径与业务参数（通常从 `argvs[2]` 开始，依各命令文档）。
+
+新增动作时：增加 `cc.<新动作> = require("./新文件")`，并保证与全局 `cc <动作> <资源>` 一致。
+
+---
+
+## 新增功能检查清单
+
+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`，确认参数顺序与文档一致。
+
+---
+
+## 发版：版本号与 README 变更日志（固定流程）
+
+在**写入或更新开发日志**（`README.md` 中的 `# ReleaseV…`）时，**以后均照此执行**：
+
+### 必须先确认：是否升级版本号
+
+- **向用户询问**：本次是否需要**升级 `package.json` / `package-lock.json` 的版本号**（新一次发版）？  
+- **若不需要升版**：**不要**修改 `package.json` 与 `package-lock.json` 的 `version`；只在 **`README.md` 里与当前 `package.json.version` 一致**的那一节 `# ReleaseV…`（例如已是 `# ReleaseV2.3.5`）中**增补或修订** `#### Release Content`（及必要时同一节内的日期说明），把新变更写进**现有版本**的日志里。  
+- **若需要升版**：再执行下面的「升版 + 新节」流程。
+
+### 升版 + 新 Release 节（仅在用户确认要发版时）
+
+1. **版本号**（与 `cc --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 列表）。  
+   - 结构建议：  
+     - `# ReleaseVx.y.z`  
+     - `#### Release Date: YYYY-M-D`  
+     - `#### Release Scope: Full`（或按实际填写）  
+     - `#### Release Content` 下用列表概括 CLI、文档、依赖等变更。  
+   - **不要删除**已有历史 `# ReleaseV…` 区块；新节始终在**时间顺序上最新**的位置（当前约定为文档前部、旧节整体下移）。
+
+3. **可选**  
+   - 若本次变更影响使用方式，同步更新 **Usage / CLI overview / MCP** 等 README 顶部英文说明。  
+   - `src/version/get.js` 从 `package.json` 读版本，**无需**单独改（除非改为硬编码，不推荐）。
+
+用户若**明确说**「发版」「升版本号」「新版本」，且未反对升版，可执行 **升版 + 新节**；若只说「更新日志」「记一下」「补 readme」等**未明确发版**，须**先问是否升版**，未确认则**只改当前版本对应的那一节 Release**。
+
+---
+
+## 历史调整摘要（架构演进）
+
+以下为本仓库 CLI 层曾做过、与上述约定相关的变更，便于排查旧文档或脚本：
+
+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` 保持不变。
+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` 路径。
+
+实现新功能时，**以本节与上文「命令行结构」为准**，勿再引入「首词为资源名」的并行体系。

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

@@ -0,0 +1,71 @@
+---
+name: cloudcc-dev-skill
+description: CloudCC CRM 二次开发设计，实现工具 。用于在设计方案和实际开发时使用，优先通过各模块的 `cc doc <module> introduction` 与 `cc doc <module> devguide` 获取文档。用户提到 CloudCC、cloudcc-cli、`cc doc`、模块文档、设计方案、开发文档、项目初始化、开发环境、对象、字段、菜单、应用、类、定时类、触发器、自定义组件、自定义页面、自定义设置、客户端脚本、静态资源 时应优先使用。
+---
+
+# CloudCC CLI skill
+
+- 使用前必须检查npm全局包，是否安装了cloudcc-cli ，如果没有，那么先全局安装 npm
+  i -g cloudcc-cli@latest
+
+## 模块命令
+
+### 基础与环境
+
+- 开发环境设置：`cc doc project introduction`、`cc doc project devguide`
+- 开发环境密钥配置：`cc 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`
+
+### 权限与组织管理
+
+- 用户：`cc doc user introduction`、`cc doc user devguide`
+- 角色：`cc doc role introduction`、`cc doc role devguide`
+- 简档：`cc doc profile introduction`、`cc 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`
+
+### 业务扩展（前端）
+
+- 自定义组件：`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`
+
+### 平台配置与导航
+
+- 菜单：`cc doc menu introduction`、`cc doc menu devguide`
+- 应用：`cc doc application introduction`、`cc doc application devguide`
+- 自定义设置：`cc doc customSetting introduction`、`cc doc customSetting devguide`
+
+## 使用场景
+
+### 1. 快速了解CloudCC CRM每个模块的定义信息
+
+- 比如做方案设计、实现设计、模块选型时，优先调用每个模块的`introduction`文档。
+- 命令格式：`cc doc <module> introduction`
+- 目标：先理解模块定位、适用场景、能力边界。
+
+### 2. 要了解某个CloudCC CRM 环境状态
+
+- 先创建模版项目`cc create project demo`
+- 配置开发者密钥
+- 调用每个模块的 `devguide`
+  文档，命令格式：`cc doc <module> devguide`，了解如何查询系统数据
+
+### 3. 要进行二开实施
+
+- 先创建模版项目`cc create project demo`
+- 配置开发者密钥
+- 调用每个模块的 `devguide`
+  文档，命令格式：`cc doc <module> devguide`，了解如何创建，修改数据

package/README.md

@@ -1,26 +1,73 @@
 # Usage Guide
 
-- Global Installation
+## Global installation
 
-```
-// window
+```bash
+# Windows
 npm i -g cloudcc-cli
 
-// macos
+# macOS
 sudo npm i -g cloudcc-cli
 ```
 
-- Configure MCP
+## CLI overview
 
-```
+The `cc` entry point (`bin/cc.js`) has 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`.
+
+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.
+
+**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`.
+
+## 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.
+
+## MCP configuration
+
+`package.json` **does not** publish a `cc-mcp` binary. Start the MCP server with **Node** and the path to the bundled script:
+
+```json
 {
   "mcpServers": {
     "cloudcc-cli": {
-      "command": "cc-mcp"
+      "command": "node",
+      "args": ["<absolute-path-to-global-install>/cloudcc-cli/bin/mcp.js"]
     }
   }
 }
 ```
+
+After a global install, resolve the script path on macOS/Linux with:
+
+```bash
+echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
+```
+
+# ReleaseV2.3.5
+
+#### Release Date: 2026-4-1
+
+#### Release Scope: Full
+
+#### 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
+  - 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
+  - README and Cursor skill (`cloudcc-cli-dev`) updated to match the above
+  - README: “Version output and changelog” section (version output, README-based release notes, and formatting behavior)
+  - **`cloudcc-cli-dev` SKILL**: when editing the dev log, **ask whether to bump version**; if not, only update the existing **`# ReleaseV…`** for the current `package.json` version (no automatic version bump)
+
 # ReleaseV2.3.4
 
 #### Release Date: 2026-3-26

package/bin/cc.js

@@ -1,47 +1,125 @@
 #!/usr/bin/env node
 const chalk = require("chalk")
+const commandStats = require("../utils/commandStats")
 
-let argvs = process.argv.splice(2);
+let argvs = process.argv.splice(2)
 let action = argvs[0]
-// 处理版本查询命令
-if (action === '-version' || action === '-v' || action === '--version' || action === '--v') {
-    const version = require("../src/version/index")
-    version('get', argvs);
-    return;
+
+function recordStats(actionKey, resourceKey) {
+  try {
+    commandStats.record(actionKey, resourceKey)
+  } catch (_e) {}
+}
+
+function runVersion(subAction, argvSlice) {
+  const version = require("../src/version/index")
+  return version(subAction, argvSlice).catch((e) => {
+    console.error(e)
+    process.exit(1)
+  })
+}
+
+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()
+}
+
+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()
+}
+
+// 版本与全局维护命令（走 src/version，不参与 action + resource 路由）
+if (action === "-version" || action === "-v" || action === "--version" || action === "--v") {
+  recordStats(action, "_")
+  runVersion("get", argvs)
+  return
+}
+if (action === "--help" || action === "-h" || action === "--h") {
+  recordStats(action, "_")
+  runVersion("help", argvs)
+  return
+}
+if (action === "update" && !argvs[1]) {
+  recordStats("update", "_")
+  runVersion("update", argvs)
+  return
+}
+if (action === "uninstall" && !argvs[1]) {
+  recordStats("uninstall", "_")
+  runVersion("uninstall", argvs)
+  return
 }
 
 if (!action) {
-    console.error()
-    console.error(chalk.yellow("Please see the help documentation"));
-    console.error()
-    return;
+  hintCcHelp()
+  return
 }
 
+if (action === "help" && !argvs[1]) {
+  recordStats("help", "_")
+  runVersion("help", argvs)
+  return
+}
 
-let type = argvs[1]
-if (!type) {
-    console.error()
-    console.error(chalk.yellow("Please see the help documentation"));
-    console.error()
-    return;
+if (action === "stats" && !argvs[1]) {
+  recordStats("stats", "_")
+  require("../src/version/stats")()
+  return
+}
+
+if (action === "doctor" && !argvs[1]) {
+  recordStats("doctor", "_")
+  require("../src/version/doctor")()
+  return
+}
+
+if (action === "docs" && !argvs[1]) {
+  recordStats("docs", "_")
+  require("../src/version/docs")()
+  return
 }
-const cc = require("./index")
 
-async function main() {
+if (action === "init") {
+  if (argvs[1] === "-h" || argvs[1] === "--help") {
+    recordStats("init", "_help")
+    require("../src/version/initHelp")()
+    return
+  }
+  runWithArgvs(["create", "project", ...argvs.slice(1)])
+  return
+}
+
+if (argvs[1] === "-h" || argvs[1] === "--help") {
+  recordStats(action, "-h")
+  require("../src/version/actionHelp")(argvs)
+  return
+}
+
+if (!argvs[1]) {
+  hintMissingResource(action)
+  return
+}
+
+async function runWithArgvs(argv) {
+  const act = argv[0]
+  const resource = argv[1]
+  if (act && resource) {
+    recordStats(act, resource)
+  }
+  const cc = require("./index")
   try {
-    if (action === "doc") {
-      if (!cc[type]) {
-        throw new Error(`doc 不支持的类型: ${type}`);
-      }
-      await cc[type]("doc", argvs);
-      return;
-    }
-    await cc[argvs[1]](argvs[0], argvs);
+    await cc[act](argv)
   } catch (e) {
     console.error()
-    console.error(chalk.yellow("Please see the help documentation"), e);
+    console.error(chalk.yellow("请查看帮助：cc --help"), e)
     console.error()
   }
 }
 
-main();
+runWithArgvs(argvs)

package/bin/index.js

@@ -1,55 +1,54 @@
-const cc = {}
-
-cc.project = require("../src/project/index")
-
-cc.plugin = require("../src/plugin/index")
-
-cc.classes = require("../src/classes/index")
-
-cc.customSetting = require("../src/customSetting/index")
-
-cc.globalSelectList = require("../src/globalSelectList/index")
-
-cc.staticResource = require("../src/staticResource/index")
-
-cc.customPage = require("../src/customPage/index")
-
-cc.schedule = require("../src/timer/index")
-
-cc.triggers = require("../src/triggers/index")
-
-cc.timer = require("../src/timer/index")
-
-cc.script = require("../src/script/index")
-
-cc.token = require("../src/token/index")
-
-cc.object = require("../src/object/index")
-
-cc.recordType = require("../src/recordType/index")
-
-cc.config = require("../src/config/index")
-
-cc.version = require("../src/version/index")
-
-cc.brief = require("../src/brief/index")
-
-cc.fields = require("../src/fields/index")
-
-cc.menu = require("../src/menu/index")
-
-cc.application = require("../src/application/index")
-
-cc.scheduleJob = require("../src/scheduleJob/index")
-
-cc.profile = require("../src/profile/index")
-
-cc.user = require("../src/user/index")
-
-cc.role = require("../src/role/index")
-
-cc.pagelayout = require("../src/pagelayout/index")
-
-cc.validationRule = require("../src/validationRule/index")
-
-module.exports = cc;
+const modules = {
+  project: require("../src/project/index"),
+  plugin: require("../src/plugin/index"),
+  classes: require("../src/classes/index"),
+  customSetting: require("../src/customSetting/index"),
+  globalSelectList: require("../src/globalSelectList/index"),
+  button: require("../src/button/index"),
+  staticResource: require("../src/staticResource/index"),
+  customPage: require("../src/customPage/index"),
+  schedule: require("../src/timer/index"),
+  triggers: require("../src/triggers/index"),
+  timer: require("../src/timer/index"),
+  script: require("../src/script/index"),
+  token: require("../src/token/index"),
+  object: require("../src/object/index"),
+  recordType: require("../src/recordType/index"),
+  config: require("../src/config/index"),
+  version: require("../src/version/index"),
+  brief: require("../src/brief/index"),
+  fields: require("../src/fields/index"),
+  menu: require("../src/menu/index"),
+  application: require("../src/application/index"),
+  scheduleJob: require("../src/scheduleJob/index"),
+  profile: require("../src/profile/index"),
+  user: require("../src/user/index"),
+  role: require("../src/role/index"),
+  identityProvider: require("../src/identityProvider/index"),
+  singleSignOn: require("../src/singleSignOn/index"),
+  pagelayout: require("../src/pagelayout/index"),
+  validationRule: require("../src/validationRule/index"),
+  permission: require("../src/permission/index"),
+};
+
+/**
+ * 对外导出供 `bin/cc.js` 使用：`await cc[action](argvs)`。
+ * argv 约定：action(动作) + resource(资源名，与 modules 的 key 一致) + 其余参数。
+ */
+module.exports = new Proxy(
+  {},
+  {
+    get(_, action) {
+      return function routed(argvs) {
+        const type = argvs[1];
+        if (action === "doc" && !modules[type]) {
+          throw new Error(`doc 不支持的类型: ${type}`);
+        }
+        if (!modules[type]) {
+          throw new Error(`不支持的类型: ${type}`);
+        }
+        return modules[type](action, argvs);
+      };
+    },
+  }
+);

package/mcp/cliRunner.js

@@ -1,11 +1,13 @@
-const path = require("path");
 const { spawnSync } = require("child_process");
 
+const CC_NOT_FOUND_HINT =
+    "未找到 cc 命令。请将 cloudcc-cli 全局安装并确保 PATH 可用：npm install -g cloudcc-cli";
+
 function runCcCommand(args, options = {}) {
     const { cwd = process.cwd(), timeoutMs = 120000 } = options;
-    const ccEntry = path.resolve(__dirname, "../../bin/cc.js");
+    const ccCommand = process.platform === "win32" ? "cc.cmd" : "cc";
 
-    const result = spawnSync(process.execPath, [ccEntry, ...args], {
+    const result = spawnSync(ccCommand, args, {
         cwd,
         encoding: "utf8",
         timeout: timeoutMs,
@@ -17,12 +19,17 @@ function runCcCommand(args, options = {}) {
     const hasError = Boolean(result.error);
     const code = typeof result.status === "number" ? result.status : -1;
 
+    let errorMsg = hasError ? result.error.message : "";
+    if (result.error && result.error.code === "ENOENT") {
+        errorMsg = CC_NOT_FOUND_HINT;
+    }
+
     return {
         success: !hasError && code === 0,
         code,
         stdout,
         stderr,
-        error: hasError ? result.error.message : ""
+        error: errorMsg
     };
 }