cloudcc-cli 2.2.6 → 2.2.7

package/.cloudcc-cache.json

@@ -1,34 +1,38 @@
 {
+  "version_check": {
+    "timestamp": 1773815782543
+  },
+  "Je6yZ0TRyQFtpcH1gVKctqNhL": {
+    "username": "admin@testuat.com",
+    "baseUrl": "https://uat-one.cloudcc.cn/ccdomaingateway",
+    "orgId": "org28e02f50c6d727bbc",
+    "clientId": "MkZxyFscNEjHjQfR6lK4ZG8Ac",
+    "version": "public",
+    "openSecretKey": "ae62146f-e8d8-4cba-a60c-0d1e0cb80375",
+    "safetyMark": "Je6yZ0TRyQFtpcH1gVKctqNhL",
+    "CloudCCDev": "",
+    "apiSvc": "https://uat-one.cloudcc.cn/ccdomaingateway/apisvc",
+    "setupSvc": "https://uat-one.cloudcc.cn/ccdomaingateway/setup",
+    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYWRtaW5AdGVzdHVhdC5jb20iLCJiaW5kaW5nIjoiYzQ2MTFjMmYtZGYyNS00NTQ5LTkxZTktZDkzY2YyMGFjOWIzIiwiQ2xpZW50SWQiOiJNa1p4eUZzY05FakhqUWZSNmxLNFpHOEFjIiwiZXhwIjoxNzczODk5MzM1LCJvcmdJZCI6Im9yZzI4ZTAyZjUwYzZkNzI3YmJjIn0._cpwUjyBbaHYGphZ5pGAksySYeG_ErHx8mEc3r03mns",
+    "secretKey": "40e68c50d21f41a1a583d7a7d55da3",
+    "pluginToken": "unified20269eec2d32c",
+    "timestamp": 1773812935285
+  },
   "QVOllKTKhnm5oHp49tCsSHvHg": {
     "username": "appstore@cloudcc.cn",
     "baseUrl": "https://yundong.lightning.cloudcc.cn/ccdomaingateway",
+    "setupSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/setup",
     "orgId": "org9697882320dc71f28",
     "clientId": "bIA1IXRHl28hBkaQdiwQ63hZZ",
     "version": "public",
     "openSecretKey": "15bba2de-e6e7-42dc-9d7c-f9b157cd0ddb",
     "CloudCCDev": "",
     "safetyMark": "QVOllKTKhnm5oHp49tCsSHvHg",
+    "buildVersion": "v2",
     "apiSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/apisvc",
-    "setupSvc": "https://yundong.lightning.cloudcc.cn/ccdomaingateway/setup",
-    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYXBwc3RvcmVAY2xvdWRjYy5jbiIsImJpbmRpbmciOiJkYTY1NWYwOS02NmVmLTQ0NTktOTU5Ny05MmI3YWI1MTkzNTciLCJDbGllbnRJZCI6ImJJQTFJWFJIbDI4aEJrYVFkaXdRNjNoWloiLCJleHAiOjE3Njk3NjQ5NzYsIm9yZ0lkIjoib3JnOTY5Nzg4MjMyMGRjNzFmMjgifQ.Md2bT3oZKT-WHMLmEBdKw-sA9Hh2FC61qKTZffXHOJc",
+    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiYXBwc3RvcmVAY2xvdWRjYy5jbiIsImJpbmRpbmciOiJjYjhhZTY5MS0yNjJhLTRiMmEtOTVmNS05ODY3ZGIxYTNlYTEiLCJDbGllbnRJZCI6ImJJQTFJWFJIbDI4aEJrYVFkaXdRNjNoWloiLCJleHAiOjE3NzM5OTA4NzksIm9yZ0lkIjoib3JnOTY5Nzg4MjMyMGRjNzFmMjgifQ.lbROZu-5HCTHgOlqrWqWbR_oVIV7uTjh8sqiPGGkmis",
     "secretKey": "d99313b4298544bc8ca1ee7459227b",
-    "pluginToken": "unified202648c3bd21f",
-    "timestamp": 1769592177005
-  },
-  "9lTJpVZ7Gz6Q7Uu8KuO2BT4ED": {
-    "username": "cloudcc008@126.com",
-    "baseUrl": "https://cnbh01.cloudcc.cn/ccdomaingateway",
-    "setupSvc": "https://cnbh01.cloudcc.cn/ccdomaingateway/setup",
-    "orgId": "orgc481843971a8faa9a",
-    "clientId": "mruqXvHCsu1Mp6ZiFN30ddocZ",
-    "version": "public",
-    "openSecretKey": "88d38e16-3d07-49de-9de4-16bace67eaa6",
-    "safetyMark": "9lTJpVZ7Gz6Q7Uu8KuO2BT4ED",
-    "CloudCCDev": "",
-    "apiSvc": "https://cnbh01.cloudcc.cn/ccdomaingateway/apisvc",
-    "accessToken": "eyJ0eXAiOiJKV1QiLCJhbGciOiJIUzI1NiJ9.eyJhdWQiOiJjbG91ZGNjIiwibG9naW5OYW1lIjoiY2xvdWRjYzAwOEAxMjYuY29tIiwiYmluZGluZyI6IjMzMDk1MmUxLTY2NTgtNGUzNS04M2ZkLTRkYjRmMTE2NGM0YyIsIkNsaWVudElkIjoibXJ1cVh2SENzdTFNcDZaaUZOMzBkZG9jWiIsImV4cCI6MTc2OTc3MjU0OCwib3JnSWQiOiJvcmdjNDgxODQzOTcxYThmYWE5YSJ9.sdMAQfcYG7zdAokg5eXU0dNbHas7wmK-l2S4YREProo",
-    "secretKey": "52f3abb9f50a4cc392dbf9549e158d",
-    "pluginToken": "unified20265de00f22d",
-    "timestamp": 1769599748664
+    "pluginToken": "unified2026546fe51ba",
+    "timestamp": 1773818080344
   }
 }

package/README.md

@@ -22,6 +22,18 @@ sudo npm i -g cloudcc-cli
 }
 ```
 
+# ReleaseV2.2.7
+
+#### Release Date: 2026-3-20
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Optimization
+  - 规范mcp使用，必须调用cc命令
+  - 提供了skill，用于访问cc命令
+
 # ReleaseV2.2.6
 
 #### Release Date: 2026-2-25

package/bin/cc.js

@@ -27,6 +27,13 @@ if (!type) {
 }
 const cc = require("./index")
 try {
+    if (action === "doc") {
+        if (!cc[type]) {
+            throw new Error(`doc 不支持的类型: ${type}`);
+        }
+        cc[type]("doc", argvs);
+        return;
+    }
     cc[argvs[1]](argvs[0], argvs);
 } catch (e) {
     console.error()

package/java/com/cloudcc/core/BaseException.java

@@ -0,0 +1,100 @@
+package com.cloudcc.core;
+
+import java.io.PrintStream;
+import java.io.PrintWriter;
+import java.util.ArrayList;
+import java.util.List;
+
+public class BaseException extends Exception {
+    private static final long serialVersionUID = -960185495264426709L;
+    public static final long ERROR_PAGE = 1L;
+    public static final long RETURN_PAGE = 2L;
+    public static final long RETURN_BYPAGE = 3L;
+    private Throwable rootCause = null;
+    private List exceptions = new ArrayList();
+    private List messageArgs = new ArrayList();
+    private String messageKey = null;
+    private long displayType = 1L;
+    private String returnForward = null;
+
+    protected BaseException() {
+    }
+
+    protected BaseException(String errmsg) {
+        super(errmsg);
+        this.messageArgs.add(errmsg);
+    }
+
+    protected BaseException(Throwable cause) {
+        super(cause);
+        this.rootCause = cause;
+    }
+
+    protected BaseException(String errmsg, Throwable cause) {
+        super(errmsg, cause);
+        this.messageArgs.add(errmsg);
+        this.rootCause = cause;
+    }
+
+    protected BaseException(List args) {
+        this.messageArgs = args;
+    }
+
+    protected BaseException(String msgKey, List args) {
+        this.messageKey = msgKey;
+        this.messageArgs = args;
+    }
+
+    public void printStackTrace(PrintWriter writer) {
+        super.printStackTrace(writer);
+        if (this.getRootCause() != null) {
+            this.getRootCause().printStackTrace(writer);
+        }
+
+        writer.flush();
+    }
+
+    public void printStackTrace(PrintStream outStream) {
+        this.printStackTrace(new PrintWriter(outStream));
+    }
+
+    public void printStackTrace() {
+        this.printStackTrace(System.err);
+    }
+
+    public Throwable getRootCause() {
+        return this.rootCause;
+    }
+
+    public String getMessageKey() {
+        return this.messageKey;
+    }
+
+    public List getExceptions() {
+        return this.exceptions;
+    }
+
+    public void addException(BaseException ex) {
+        this.exceptions.add(ex);
+    }
+
+    public List getMessageArgs() {
+        return this.messageArgs;
+    }
+
+    public long getDisplayType() {
+        return this.displayType;
+    }
+
+    public void setDisplayType(long displayType) {
+        this.displayType = displayType;
+    }
+
+    public String getReturnForward() {
+        return this.returnForward;
+    }
+
+    public void setReturnForward(String returnForward) {
+        this.returnForward = returnForward;
+    }
+}

package/java/com/cloudcc/core/BusiException.java

@@ -0,0 +1,43 @@
+package com.cloudcc.core;
+
+import java.util.List;
+
+public class BusiException extends BaseException {
+    private static final long serialVersionUID = -4060192906349249047L;
+
+    public BusiException() {
+    }
+
+    public BusiException(String errmsg) {
+        super(errmsg);
+    }
+
+    public BusiException(Throwable cause) {
+        super(cause);
+    }
+
+    public BusiException(String errmsg, Throwable cause) {
+        super(errmsg, cause);
+    }
+
+    public String toString() {
+        StringBuffer sb = new StringBuffer();
+        List messageArgs = this.getMessageArgs();
+
+        for(int i = 0; i < messageArgs.size(); ++i) {
+            sb.append("\t").append((String)messageArgs.get(i)).append("\n");
+        }
+
+        sb.append("\n\n");
+        Throwable t = this.getRootCause();
+        if (t != null) {
+            StackTraceElement[] ste = t.getStackTrace();
+
+            for(int i = 0; i < ste.length; ++i) {
+                sb.append("\t").append(ste[i]).append("\n");
+            }
+        }
+
+        return sb.toString();
+    }
+}

package/java/com/cloudcc/core/CCService.java

@@ -607,5 +607,7 @@ public class CCService {
 	public String process(String processType, String tid, String touserId, String comments, String appPath) {
 		return null;
 	}
-
+	public ServiceResult update(List<CCObject> ccobjs) throws BusiException {
+		return null;
+	}
 }

package/java/com/cloudcc/core/StringUtils.java

@@ -0,0 +1,7 @@
+package com.cloudcc.core;
+
+public class StringUtils {
+    public static boolean isNotNullAndEmpty(Object s){
+        return s != null && !s.equals("");
+    }
+}

package/java/com/cloudcc/core/TimeUtil.java

@@ -2,10 +2,43 @@
 package com.cloudcc.core;
 
 import java.text.SimpleDateFormat;
+import java.util.Date;
+import java.util.TimeZone;
 
 public class TimeUtil {
+    private static final TimeZone DEFAULT_TIMEZONE = TimeZone.getDefault();
+    private static final boolean isChinastandardTimeZone=true;
 
     public static SimpleDateFormat getSimpleDateFormat(String string, UserInfo userInfo) {
         return new SimpleDateFormat(string);
     }
+    public static Date getNowDate(UserInfo userInfo) {
+        return parseDate(new Date(), userInfo);
+    }
+    public static Date parseDate(Date date, UserInfo userInfo) {
+        TimeZone userTZ = getUserTimeZone(userInfo);
+        return parseDate(date, userTZ);
+    }
+    public static Date parseDate(Date date, TimeZone tz) {
+        if (isChinastandardTimeZone) {
+            if ((long)tz.getRawOffset() == 28800000L) {
+                return date;
+            } else {
+                long offset = (long)tz.getRawOffset() - 28800000L;
+                return new Date(date.getTime() + offset);
+            }
+        } else {
+            long offset = (long)(tz.getRawOffset() - DEFAULT_TIMEZONE.getRawOffset());
+            return new Date(date.getTime() + offset);
+        }
+    }
+
+    public static TimeZone getUserTimeZone(UserInfo userInfo) {
+        if (userInfo != null && StringUtils.isNotNullAndEmpty(userInfo.getTimeZone())) {
+            String timeZoneId = userInfo.getTimeZone();
+            return !timeZoneId.startsWith("+") && !timeZoneId.startsWith("-") ? TimeZone.getTimeZone(timeZoneId) : TimeZone.getTimeZone("GMT" + timeZoneId);
+        } else {
+            return TimeZone.getTimeZone("GMT+08:00");
+        }
+    }
 }

package/java/com/cloudcc/core/UserInfo.java

@@ -3,6 +3,15 @@ package com.cloudcc.core;
 public class UserInfo extends CCObject {
 	// 绑定信息
 	public String binding;
+	private String timeZone;
+
+	public String getTimeZone() {
+		return timeZone;
+	}
+
+	public void setTimeZone(String timeZone) {
+		this.timeZone = timeZone;
+	}
 
 	// 获取用户ID
 	public String getUserId() {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.2.6",
+  "version": "2.2.7",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",
@@ -16,6 +16,8 @@
     "cc-mcp": "bin/mcp.js"
   },
   "scripts": {
+    "test-cli-one": "node --test test/application.cli.test.js",
+    "test-cli-all": "node --test ",
     "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",
@@ -43,5 +45,9 @@
     "vue-custom-element": "^3.3.0",
     "vue-template-compiler": "^2.6.14",
     "zod": "^4.1.13"
+  },
+  "devDependencies": {
+    "sass": "^1.98.0",
+    "sass-loader": "^16.0.7"
   }
 }

package/pom.xml

@@ -4,7 +4,7 @@
 
     <groupId>com.cloudcc.core</groupId>
     <artifactId>ccopenapi</artifactId>
-    <version>0.0.3</version>
+    <version>0.0.4</version>
     <packaging>jar</packaging>
     <name>ccopenapi</name>
     <dependencies>

package/skill/BACKEND_CODE.md

@@ -0,0 +1,114 @@
+## 覆盖范围
+
+本篇聚焦 CloudCC 后端 Java 侧二开资产（通过 `cc` 命令）：
+
+- 自定义类（Class）
+- 定时类（Scheduled Class / Timer）
+- 触发器（Trigger）
+
+并给出“创建 → 拉取 → 编辑 → 发布”的闭环流程。
+
+---
+
+## 目录结构（以本仓库约定为准）
+
+创建后通常会生成在以下目录（项目根下）：
+
+- `classes/{ClassName}/...`
+- `schedule/{ScheduleName}/...`
+- `triggers/{objectName}/{triggerName}/...`
+
+---
+
+## 源码同步边界（必须理解）
+
+该项目使用“片段同步”策略：
+
+- **自定义类 / 定时类 / 触发器**：只会拉取/发布 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的内容。
+
+这意味着：
+
+- 你可以在片段外保留模板、import、类结构等；真正可同步的业务逻辑写在片段内。
+- 拉取会覆盖片段区域，因此片段内不要放本地专用逻辑（如临时调试代码）。
+
+---
+
+## 自定义类（Class）
+
+### 创建
+
+```bash
+# 在项目根目录执行
+cc create classes <ClassName>
+```
+
+### 拉取 / 发布（片段同步）
+
+```bash
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
+
+---
+
+## 定时类（Scheduled Class）
+
+### 创建
+
+```bash
+# 在项目根目录执行
+cc create schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+```
+
+---
+
+## 触发器（Trigger）
+
+### 创建（关键入参）
+
+触发器的 CLI 创建参数是一个 JSON 对象（需要 `encodeURI` 后作为单参传入）：
+
+```bash
+cc create triggers <encodedJson>
+```
+
+JSON 字段（示例）：
+
+- `name`: 触发器名（Java 命名规范）
+- `schemetableName`: 对象表名（如从对象列表拿到）
+- `targetObjectId`: 目标对象 ID
+- `triggerTime`: 触发时机（beforeInsert/afterUpdate/.../approval 等）
+
+示例（macOS/zsh，注意引号与编码）：
+
+```bash
+cc create triggers "$(node -e 'console.log(encodeURI(JSON.stringify({name:\"MyTrigger\",schemetableName:\"account\",targetObjectId:\"a01...\",triggerTime:\"beforeInsert\"})))')"
+```
+
+### 拉取 / 发布
+
+```bash
+# namePath 形如：objectName/triggerName（注意 objectName 通常为小写目录）
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+```
+
+> 说明：发布/拉取只会处理 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的代码片段。
+
+---
+
+## 推荐工作流（AI 执行顺序）
+
+当需求涉及后端逻辑时，建议 AI 按以下顺序执行：
+
+1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
+2. 创建类/触发器/定时器骨架（create_*）
+3. 拉取线上版本（pull_*）对齐基线（如是增量改造）
+4. 编写片段内业务逻辑（注意批量与幂等）
+5. 发布（publish_*）
+6. 回归验证：单条、批量、权限、异常分支
+

package/skill/CLI_CHEATSHEET.md

@@ -0,0 +1,90 @@
+## CLI 入口速查（本仓库已定义）
+
+`package.json` 中定义的 bin：
+
+- `cc`：主入口（支持 `create` / `get` / `pull` / `publish` / `doc` 等）
+- `cloudccCreate`：创建模板项目（内部调用 `src/project/create.js`）
+- `cloudccBuild`：组件发布/构建相关（内部调用 `src/plugin/publish.js`）
+
+---
+
+## 常用 CLI 命令速查（按开发流程分组）
+
+### 项目与文档
+
+```bash
+# 版本
+cc -v
+
+# 创建模板项目
+cc create project <projectName>
+
+# 输出项目文档（纯 CLI 文档）
+cc doc project overview
+cc doc project key-guide
+```
+
+### 对象与字段
+
+```bash
+# 创建自定义对象
+cc create object <projectPath> <label>
+
+# 查询对象列表（输出 JSON）
+# type 可选：standard / custom / both（默认：both）
+cc get object <projectPath> [type]
+
+# 查询对象字段（输出 JSON）
+cc get fields <projectPath> <objprefix>
+
+# 创建字段（字段类型决定参数个数）
+cc create fields <projectPath> <fieldType> <objid> <nameLabel> [ptext|lookupObj]
+```
+
+### 菜单与应用
+
+```bash
+# 创建菜单（标签页）
+cc create menu <type> <projectPath> <resourceId> <tabName> [tabStyle] [mobileimg] [cloudccservicetab]
+
+# 创建应用
+cc create application <projectPath> <appName> <appCode> [menuIds]
+```
+
+### 自定义类（classes）
+
+```bash
+cc create classes <ClassName>
+cc pull classes <ClassName>
+cc publish classes <ClassName>
+```
+
+### 定时类（schedule）
+
+```bash
+cc create schedule <ScheduleName>
+cc pull schedule <ScheduleName>
+cc publish schedule <ScheduleName>
+```
+
+### 触发器（triggers）
+
+```bash
+# 创建：参数是一个 JSON（需 encodeURI 后作为单个参数传入）
+cc create triggers <encodedJson>
+
+# 拉取/发布：namePath 形如 objectName/triggerName
+cc pull triggers <namePath>
+cc publish triggers <namePath>
+```
+
+### 自定义组件（plugin / plugins）
+
+```bash
+# 创建（生成到 plugins/<pluginName>/）
+cc create plugin <pluginName>
+
+# 发布（编译并上传）
+cc publish plugin <pluginName>
+```
+

package/skill/INSTALL_AND_BOOTSTRAP.md

@@ -0,0 +1,59 @@
+## 目标
+
+让开发者（或 AI）在一台新机器上，完成 `cloudcc-cli` 的安装、模板项目创建、开发密钥配置，并能通过 `cc` 命令进行开发与发布。
+
+---
+
+## 安装 cloudcc-cli
+
+### 全局安装
+
+```bash
+# Windows
+npm i -g cloudcc-cli
+
+# macOS（通常需要 sudo）
+sudo npm i -g cloudcc-cli
+```
+
+### 验证版本
+
+```bash
+cc -v
+```
+
+> 说明：`cc` 是该 CLI 的统一入口命令之一（见本仓库 `package.json` 的 bin 配置）。
+
+---
+
+## 创建 CloudCC 模板项目
+
+在你的工作目录下执行：
+
+```bash
+cc create project demo1
+cd demo1
+npm i
+npm run serve
+```
+
+如果能在本地启动并访问页面，说明前端开发链路可用。
+
+---
+
+## 配置开发者密钥与安全标记
+
+### 在 CloudCC CRM 后台获取
+
+你需要一个具备“代码管理/开发者权限”的账号。
+
+- **开发者密钥（CloudCCDev）**：在 CRM 后台「连接的应用程序」中新建后获取并复制。
+- **安全标记（safetyMark）**：在个人设置中重置安全标记后，通过邮箱获取。
+
+### 写入项目的 `cloudcc-cli.config.js`
+
+模板项目根目录通常会有 `cloudcc-cli.config.js`（或你们约定的同名配置文件），核心原则：
+
+- **多环境**：用 `use` 字段选择当前环境（如 `dev/uat/prod`）。
+- **不要提交真实密钥到 Git**：建议 `.gitignore` 忽略配置文件，或用本地私密文件方式管理。
+