cloudcc-cli 2.2.2 → 2.2.4

package/.vscode/settings.json

@@ -0,0 +1,3 @@
+{
+    "java.configuration.updateBuildConfiguration": "automatic"
+}

package/README.md

@@ -1,3 +1,50 @@
+# Usage Guide
+* Global Installation
+```
+// window
+npm i -g cloudcc-cli
+
+// macos
+sudo npm i -g cloudcc-cli
+```
+* Configure MCP
+```
+{
+  "mcpServers": {
+    "cloudcc-cli": {
+      "command": "cc-mcp"
+    }
+  }
+}
+```
+
+# ReleaseV2.2.4
+#### Release Date: 2026-1-19
+#### Release Scope: Full
+#### Release Content
+* Optimization
+    * Add create object MCP
+    * Add query object list MCP
+    * Add trigger management MCP
+    * Add custom component management MCP
+    * Add client script management MCP
+    * Add buildVersion, use new version when v2
+    * Optimize configuration cache logic to avoid updating cached configuration every time
+    * Add pull custom component functionality
+    * Fix issue where class files could still be created even when configuration was missing
+
+# ReleaseV2.2.3
+#### Release Date: 2025-12-11
+#### Release Scope: Full
+#### Release Content
+* Optimization
+    * Add development environment setup MCP service
+    * Add security key retrieval MCP service
+    * Add Class management MCP service
+    * Add custom component management MCP service
+    * Configuration information prioritized from config
+    * Fix script tag search logic
+
 # ReleaseV2.2.2
 #### Release Date: 2025-12-3
 #### Release Scope: Full

package/bin/cc.js

@@ -12,50 +12,26 @@ if (action === '-version' || action === '-v' || action === '--version' || action
 }
 
 if (!action) {
-    console.log()
-    console.log(chalk.yellow("Please see the help documentation"));
-    console.log()
+    console.error()
+    console.error(chalk.yellow("Please see the help documentation"));
+    console.error()
     return;
 }
 
 
 let type = argvs[1]
 if (!type) {
-    console.log()
-    console.log(chalk.yellow("Please see the help documentation"));
-    console.log()
+    console.error()
+    console.error(chalk.yellow("Please see the help documentation"));
+    console.error()
     return;
 }
+const cc = require("./index")
 
-const cc = {}
-
-cc.project = require("../src/project/index")
-
-cc.plugin = require("../src/plugin/index")
-
-cc.classes = require("../src/classes/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")
 try {
     cc[argvs[1]](argvs[0], argvs);
 } catch (e) {
-    console.log()
-    console.log(chalk.yellow("Please see the help documentation"), e);
-    console.log()
-}
+    console.error()
+    console.error(chalk.yellow("Please see the help documentation"), e);
+    console.error()
+}

package/bin/index.js

@@ -0,0 +1,33 @@
+const cc = {}
+
+cc.project = require("../src/project/index")
+
+cc.plugin = require("../src/plugin/index")
+
+cc.classes = require("../src/classes/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.approval = require("../src/approval/index")
+
+module.exports = cc;

package/bin/mcp-svc.js

@@ -0,0 +1,13 @@
+#!/usr/bin/env node
+/**
+ * MCP (Model Context Protocol) Streamable HTTP 服务启动脚本
+ * 用于部署到服务器，通过 HTTP 与客户端通信
+ * 
+ * 使用方法:
+ *   node bin/mcp-svc.js
+ *   或
+ *   MCP_PORT=3000 node bin/mcp-svc.js
+ */
+
+require('../src/mcp/index-svc.js');
+

package/bin/mcp.js

@@ -0,0 +1,18 @@
+#!/usr/bin/env node
+/**
+ * MCP (Model Context Protocol) 服务启动脚本
+ * 用于与 Claude Desktop、IDE 等客户端通信
+ */
+
+const { StdioServerTransport } = require('@modelcontextprotocol/sdk/server/stdio.js');
+const mcpServer = require('../src/mcp/index.js');
+
+async function main() {
+    const transport = new StdioServerTransport();
+    await mcpServer.connect(transport);
+}
+
+main().catch(error => {
+    console.error('Server error:', error);
+    process.exit(1);
+});

package/java/com/cloudcc/core/TriggerInvoker.java

@@ -5,6 +5,10 @@ import java.lang.reflect.InvocationTargetException;
 import java.util.Set;
 
 import org.reflections.Reflections;
+import org.reflections.scanners.SubTypesScanner;
+import org.reflections.util.ConfigurationBuilder;
+import org.reflections.util.ClasspathHelper;
+import org.apache.log4j.BasicConfigurator;
 
 public class TriggerInvoker {
     UserInfo uinfo = null;
@@ -25,8 +29,20 @@ public class TriggerInvoker {
     public ServiceResult handler(CCObject data) throws Exception {
         String objectApiName = data.getObjectApiName();
         ServiceResult sr = new ServiceResult();
+        // 初始化 log4j，避免无 appender 的警告
+        try {
+            BasicConfigurator.configure();
+        } catch (Exception ignore) {
+        }
+        // 使用包名前缀的简便构造，这会启用默认的扫描器（包含 SubTypesScanner）
         Reflections ref = new Reflections("com.cloudcc.trigger");
-        Set<Class<? extends CCTrigger>> clsSets = ref.getSubTypesOf(CCTrigger.class);
+        Set<Class<? extends CCTrigger>> clsSets = null;
+        try {
+            clsSets = ref.getSubTypesOf(CCTrigger.class);
+        } catch (org.reflections.ReflectionsException rex) {
+            // 没有配置 SubTypesScanner 或未找到任何触发器时，使用空集合继续执行
+            clsSets = java.util.Collections.emptySet();
+        }
         for (Class<? extends CCTrigger> subCls : clsSets) {
             try {
                 Constructor cons = subCls.getConstructor(CCObject.class, CCObject.class, ServiceResult.class,

package/package.json

@@ -1,30 +1,36 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.2.2",
+  "version": "2.2.4",
   "description": "cloudcc-cli",
+  "author": "cloudcc",
+  "license": "ISC",
   "keywords": [
     "cloudcc",
     "cloudcc-cli"
   ],
-  "main": "./bin",
-  "author": "cloudcc",
-  "license": "ISC",
+  "main": "bin/index.js",
   "bin": {
     "cloudccCreate": "bin/project.js",
     "cloudccBuild": "bin/plugin.js",
-    "cc": "bin/cc.js"
+    "cc": "bin/cc.js",
+    "cc-mcp": "bin/mcp.js"
   },
   "scripts": {
     "cc-pull": "git fetch --tags -f && git pull",
     "publish-lib": "npm publish --registry https://registry.npmjs.org && git add . && git commit -m 'update' && git push && curl https://npmmirror.com/sync/cloudcc-cli",
-    "package-jar": "mvn clean && mvn package"
+    "package-jar": "mvn clean && mvn package",
+    "fetch-dev-env": "node src/mcp/tools/dev-env/fetcher.js",
+    "fetch-key-guide": "node src/mcp/tools/key-guide/fetcher.js",
+    "fetch-ccdk": "node src/mcp/tools/ccdk/fetcher.js"
   },
   "dependencies": {
     "@babel/parser": "^7.28.5",
     "@babel/traverse": "^7.28.5",
+    "@modelcontextprotocol/sdk": "^1.23.0",
     "axios": "^0.21.4",
     "boxen": "^4.0.0",
     "chalk": "^2.4.2",
+    "cheerio": "^1.0.0-rc.12",
     "crypto-js": "^4.1.1",
     "dayjs": "^1.10.7",
     "fs-extra": "^11.2.0",
@@ -32,7 +38,10 @@
     "marked": "^5.0.1",
     "mem-fs": "^2.2.1",
     "mem-fs-editor": "^9.0.1",
+    "node-fetch": "^3.3.2",
+    "pinyin": "^4.0.0",
     "vue-custom-element": "^3.3.0",
-    "vue-template-compiler": "^2.6.14"
+    "vue-template-compiler": "^2.6.14",
+    "zod": "^4.1.13"
   }
 }

package/pom.xml

@@ -61,6 +61,7 @@
                         <configuration>
                             <sources>
                                 <source>${project.basedir}/java</source>
+                                <source>${project.basedir}/classes</source>
                             </sources>
                         </configuration>
                     </execution>

package/prompt/DevelopmentEnvironmentConstruction.ts

@@ -0,0 +1,133 @@
+export default {
+  "title": "cloudcc开发环境搭建教程",
+  "description": "本文档是关于搭建cloudcc开发环境的教程。",
+  "content":
+    `
+    --------CloudCC 开发环境搭建指南开始--------
+# CloudCC 开发环境搭建指南
+## 本指南用于引导用户逐步完成 CloudCC 开发环境的搭建。
+### 答复要求：
+* 当用户咨询开发环境搭建相关问题时，请遵循本指南内容，逐步引导用户操作，每次仅提供一个步骤，避免一次性给出所有步骤。
+* 当用户咨询自定义代码开发等非环境搭建相关问题时，请避免引用本指南内容。
+### 适用范围：
+* 本指南仅适用于解答 CloudCC 开发环境搭建问题，不适用于其他主题。
+
+## 搭建步骤
+### 安装 Node.js: 14.19.0（必须使用此版本）
+下载链接：http://nodejs.cn/download/
+
+推荐：使用 nvm（Node 版本管理器）来管理多个 Node.js 版本
+
+### 包管理器：npm
+为加快依赖安装速度，将 npm 注册表切换到阿里巴巴源：
+npm config set registry https://registry.npmmirror.com
+
+### 全局依赖
+ npm install -g @vue/cli@5.0.8
+ npm install -g @vue/cli-service-global@4.5.17
+ npm install -g cloudcc-cli
+
+ 检查安装状态，确认这三个包可见：
+ npm ls -g --depth=0
+
+### 安装 VS Code
+下载链接：https://code.visualstudio.com/download
+
+### 安装 CloudCC VS Code 插件：CloudCC。如已安装则忽略此步骤。
+
+### 创建并运行项目
+* cc create project demo1
+* 使用 VS Code 打开此项目
+* npm i
+* npm run serve
+
+### 打开 cloudcc-cli.config.js 文件，配置安全标记
+#### 公有云配置
+"devConsoleConfig": {
+   // CRM 开发者账户
+  "username": "xxx",
+  // 密钥
+  "secretKey": "xxx",
+  // 安全标记（通过系统重置安全标记邮件获取）
+  "safetyMark": "xxx",
+  // 注册时获得的客户端 ID
+  "clientId": "xxx",
+  // 注册时获得的密钥
+  "openSecretKey": "xxx",
+  // 组织 ID
+  "orgId": "xxx"
+},
+
+* secretKey获取方法
+    * 国内公有云 API 端点：https://developer.apis.cloudcc.cn/sysconfig/auth/secretkey/get
+    * 全球公有云 API 端点：https://global-gw.cloudcc.com/sysconfig/auth/secretkey/get
+    * 部署为公有云的私有云 API 端点：https://网关地址/systconfig/auth/secretkey/get
+
+* 请求方法：POST
+Content-Type: application/x-www-form-urlencoded
+请求体：{"username":"xxx"}
+curl -H "Content-Type: application/x-www-form-urlencoded" -d "username=cloudcc@xxxx" -X POST https://developer.apis.cloudcc.cn/sysconfig/auth/secretkey/get
+
+参数名称 | 描述 | 类型 | 备注
+safetyMark | 安全标记（通过系统重置安全标记邮件获取） | string | 必填
+获取方法：个人信息 - 重置我的安全标记
+clientId | 注册时获得的客户端 ID | string | 必填
+获取方法：管理设置 - 安全控制 - 已连接的应用程序
+openSecretKey | 注册时获得的密钥 | string | 必填
+获取方法：管理设置 - 安全控制 - 已连接的应用程序
+orgId | 组织 ID | string | 必填
+
+#### 私有云配置
+"devConsoleConfig": {
+   // CRM 开发者账户
+  "username": "admin@cloudccone.com",
+  // 密钥（必须与 sysconfig-svc 配置文件中的 cloudcc.private.secretKey 匹配，私有云默认值：abc）
+  "secretKey": "abc",
+  // 私有云需要配置网关地址，注意：URL 不应以 / 结尾
+  "baseUrl": "http://xxx",
+  // 私有云特有，固定格式用于标识私有云环境
+  "version": "private",
+  // 安全标记（通过系统重置安全标记邮件获取）
+  "safetyMark": "xxx",
+  // 注册时获得的客户端 ID
+  "clientId": "xxx",
+  // 注册时获得的密钥
+  "openSecretKey": "xxx",
+  // 组织 ID
+  "orgId": "xxx"
+},
+
+参数名称 | 描述 | 类型 | 备注
+safetyMark | 安全标记（通过系统重置安全标记邮件获取） | string | 必填
+获取方法：个人信息 - 重置我的安全标记
+clientId | 注册时获得的客户端 ID | string | 必填
+获取方法：管理设置 - 安全控制 - 已连接的应用程序
+openSecretKey | 注册时获得的密钥 | string | 必填
+获取方法：管理设置 - 安全控制 - 已连接的应用程序
+orgId | 组织 ID | string | 必填
+baseUrl | 网关地址 | string | 登录 CloudCC CRM 系统，按 F12，在控制台输入：$CCDK.CCConfig.getBaseUrl() 获取私有云的 baseUrl
+
+#### 特殊配置
+"devConsoleConfig": {
+   // 服务访问地址：
+   // 国内默认：https://developer.apis.cloudcc.cn
+   // 海外默认：https://developer.apis.cloudcc.com
+  "baseUrl": "http://xxx",
+   // 组件后台销毁时间，设置为 10 分钟（10*60*1000）
+  "destroyTimeout": 600000,
+  // 开发者平台网关前缀名称，注意：URL 不应以 / 结尾
+  "devSvcDispatch": "/devconsole",
+  // api-service 网关前缀地址，注意：URL 不应以 / 结尾
+  "apiSvcPrefix": "/xxx",
+  // setup-svc 网关前缀地址，注意：URL 不应以 / 结尾
+  "setupSvcPrefix": "/xxx"
+},
+
+### 在 VS Code 中打开已创建的项目，右键点击项目文件，选择创建组件。
+
+### 将创建的组件导入到 App.vue 中
+
+### 刷新浏览器以预览
+--------CloudCC 开发环境搭建指南结束--------
+`
+};