cloudcc-cli 2.3.7 → 2.3.8

package/README.md

@@ -71,7 +71,7 @@ Resolve the script path on macOS/Linux with:
 echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 ```
 
-# ReleaseV2.3.7
+# ReleaseV2.3.8
 
 #### Release Date: 2026-4-1
 
@@ -79,6 +79,19 @@ echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 
 #### Release Content
 
+- CLI
+  - Moved the **`cloudcc-dev-skill`** folder to the updated location used by the current skill delivery flow
+- Documentation
+  - Updated release notes and aligned **`package.json` / npm** version to **2.3.8**
+
+# ReleaseV2.3.7
+
+#### Release Date:
+
+#### 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

package/cloudcc-dev-skill/SKILL.md

@@ -0,0 +1,78 @@
+---
+name: cloudcc-dev-skill
+description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `cloudcc doc <module> introduction|devguide` 获取官方模块文档，再给出方案与代码。用户提到 CloudCC、cloudcc-cli、模块文档、对象/字段、权限、触发器、类、组件、页面、脚本、静态资源、菜单、应用、单点登录、身份提供方、校验规则时应优先使用。
+---
+
+# CloudCC CRM 二开技能
+
+## 必须保留
+
+- 使用前必须检查npm全局包，是否安装了cloudcc-cli ，如果没有，那么先全局安装 npm
+  i -g cloudcc-cli@latest
+
+## 快速规则
+
+- 先确认 CLI 可用：优先检查 `cloudcc --version`。
+- 若未安装，执行：`npm i -g cloudcc-cli@latest`。
+- 只要涉及 CloudCC 设计或开发，先查文档再回答：优先 `introduction`，落地时看 `devguide`。
+- 命令统一格式：`cloudcc doc <module> <introduction|devguide>`。
+- 特例：`config` 仅支持 `devguide`，不支持 `introduction`。
+
+## 模块指令清单（按仓库当前实现）
+
+### 基础与环境
+
+- 项目：`cloudcc doc project introduction`、`cloudcc doc project devguide`
+- 配置：`cloudcc doc config 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`
+- 按钮：`cloudcc doc button introduction`、`cloudcc doc button devguide`
+- 页面布局：`cloudcc doc pagelayout introduction`、`cloudcc doc pagelayout devguide`
+- 校验规则：`cloudcc doc validationRule introduction`、`cloudcc doc validationRule 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`
+- 权限：`cloudcc doc permission introduction`、`cloudcc doc permission 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`
+
+### 前端扩展
+
+- 组件：`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`
+
+### 平台导航与系统能力
+
+- 菜单：`cloudcc doc menu introduction`、`cloudcc doc menu devguide`
+- 应用：`cloudcc doc application introduction`、`cloudcc doc application devguide`
+- 自定义设置：`cloudcc doc customSetting introduction`、`cloudcc doc customSetting devguide`
+- 身份提供方：`cloudcc doc identityProvider introduction`、`cloudcc doc identityProvider devguide`
+- 单点登录：`cloudcc doc singleSignOn introduction`、`cloudcc doc singleSignOn devguide`
+
+## 使用流程（执行顺序）
+
+1. 方案阶段：先调用 `cloudcc doc <module> introduction`，确认能力边界与适用场景。
+2. 实施阶段：再调用 `cloudcc doc <module> devguide`，按文档落地 CLI 命令与配置。
+3. 环境阶段：涉及项目初始化或鉴权问题时，优先查看 `project devguide` 与 `config devguide`。
+
+## 响应要求
+
+- 给方案或代码前，先明确引用了哪些 `cloudcc doc` 模块文档。
+- 若用户没有指定模块，先反问业务对象（如对象、权限、触发器、页面）或先给一个最小可行模块列表。
+- 输出命令时保持可直接复制执行，不混用过时命令格式。
+- **发布日志/Release Notes 规则（强制）**：凡是更新发布记录、版本日志、README 中 `Release`/`Release Notes` 区块，内容必须使用英文（标题、日期标签、条目描述均不得使用中文）。

package/cloudcc-dev-skill/config.json

@@ -0,0 +1,4 @@
+{
+  "version": "1.0.0",
+  "releaseDate": "2026-04-01"
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.3.7",
+  "version": "2.3.8",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",

package/src/classes/create.js

@@ -13,6 +13,16 @@ async function create(argvs) {
     let res = await checkUpdate();
     if (!res) {
         let config = await getPackageJson();
+        if (!config) {
+            console.error()
+            console.error(
+                chalk.yellow(
+                    "No valid cloudcc-cli config for this project. Create or fix cloudcc-cli.config.js (see cloudcc doc project devguide)."
+                )
+            )
+            console.error()
+            return
+        }
         const classesPath = path.join(process.cwd(), "classes/" + name);
         try {
             fs.mkdirSync(classesPath, { recursive: true })

package/utils/config.js

@@ -1,5 +1,6 @@
 const fs = require("fs");
 const path = require("path");
+const chalk = require("chalk");
 // 引入解密函数
 const { getDevConsoleConfig, decryptCloudCCDevInfo } = require("./utils");
 const { readCache } = require("./cache")
@@ -54,6 +55,14 @@ async function getPackageJson3(projectPath = process.cwd()) {
             config = { ...decryptedInfo, ...config }
             config.CloudCCDev = "";
             config = await getDevConsoleConfig(projectPath, config)
+        } else {
+            console.error(
+                chalk.yellow(
+                    "cloudcc-cli: CloudCCDev could not be decrypted or is empty (invalid base64/JSON). " +
+                        "Fix cloudcc-cli.config.js or use explicit fields / v2-style config; falling back to other config sources."
+                )
+            );
+            return null;
         }
     } else {
         config = null;

package/utils/utils.js

@@ -164,13 +164,20 @@ async function getDevConsoleConfig(projectPath = process.cwd(), config) {
     }
   */
 function decryptCloudCCDevInfo(encryptedData) {
+    if (encryptedData == null || typeof encryptedData !== "string" || !String(encryptedData).trim()) {
+        return null;
+    }
     try {
-        const binaryData = new Uint8Array(Buffer.from(encryptedData, 'base64'));
+        const binaryData = new Uint8Array(Buffer.from(encryptedData, "base64"));
         const decoder = new TextDecoder();
-        const jsonString = decoder.decode(binaryData);
-        return JSON.parse(jsonString);
-    } catch (error) {
-        console.error(error);
+        const jsonString = decoder.decode(binaryData).trim();
+        if (!jsonString) {
+            return null;
+        }
+        const parsed = JSON.parse(jsonString);
+        return typeof parsed === "object" && parsed !== null ? parsed : null;
+    } catch (_e) {
+        // Invalid base64, truncated blob, or non-JSON — typical when CloudCCDev is missing / placeholder
         return null;
     }
 }

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

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