cloudcc-cli 2.3.4 → 2.3.6

package/src/application/create.js

@@ -10,7 +10,7 @@ const chalk = require('chalk')
  */
 async function create(argvs) {
     try {
-        // 命令行参数格式：cc create application <path> <p1> <p2> [duel1]
+        // 命令行参数格式：cloudcc create application <path> <p1> <p2> [duel1]
         // argvs: ['application', 'create', path, p1, p2, duel1]
         let path = argvs[2];
         let p1 = argvs[3];  // 应用名称
@@ -21,7 +21,7 @@ async function create(argvs) {
         if (!p1 || !p2) {
             console.error();
             console.error(chalk.red('Error: 缺少必需参数'));
-            console.error('用法: cc create application <path> <p1> <p2> [duel1]');
+            console.error('用法: cloudcc create application <path> <p1> <p2> [duel1]');
             console.error('  path: 项目路径');
             console.error('  p1: 应用名称');
             console.error('  p2: 应用代码');

package/src/application/delete.js

@@ -4,7 +4,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 删除应用（Application）
- * 用法：cc delete application <projectPath> <appId>
+ * 用法：cloudcc delete application <projectPath> <appId>
  */
 async function remove(argvs) {
     try {
@@ -14,7 +14,7 @@ async function remove(argvs) {
         if (!appId) {
             console.error();
             console.error(chalk.red("Error: 缺少应用 ID"));
-            console.error(chalk.yellow("用法: cc delete application <projectPath> <appId>"));
+            console.error(chalk.yellow("用法: cloudcc delete application <projectPath> <appId>"));
             console.error();
             throw new Error("缺少必需参数: appId");
         }

package/src/application/doc.js

@@ -21,14 +21,14 @@ function getDevGuideDoc() {
 }
 
 /**
- * cc doc application <introduction|devguide>
+ * cloudcc doc application <introduction|devguide>
  * @param {string[]} argvs [doc, type, introduction|devguide, ...]
  */
 function doc(argvs) {
     const subType = argvs[2];
     const key = String(subType || "").trim().toLowerCase();
     if (!key) {
-        throw new Error("cc doc application 需要子命令：introduction 或 devguide");
+        throw new Error("cloudcc doc application 需要子命令：introduction 或 devguide");
     }
     if (key === "introduction") {
         const content = getIntroductionDoc();

package/src/application/docs/devguide.md

@@ -4,10 +4,10 @@
 
 `application` 模块用于通过 CLI 管理 CloudCC 应用，当前提供：
 
-- 创建应用：`cc create application ...`
-- 查询应用：`cc get application ...`
-- 删除应用：`cc delete application ...`
-- 文档查看：`cc doc application introduction|devguide`
+- 创建应用：`cloudcc create application ...`
+- 查询应用：`cloudcc get application ...`
+- 删除应用：`cloudcc delete application ...`
+- 文档查看：`cloudcc doc application introduction|devguide`
 
 ---
 
@@ -15,7 +15,7 @@
 
 执行命令前请确认：
 
-- 已完成 `cc doc project devguide` 的环境初始化
+- 已完成 `cloudcc doc project devguide` 的环境初始化
 - 项目根目录存在可用配置，且包含 `accessToken`
 - 已准备应用名称、应用代码
 - 若需自定义菜单挂载，已准备菜单 ID 列表
@@ -25,10 +25,10 @@
 ## 3. 命令总览（以代码实现为准）
 
 ```bash
-cc create application <path> <p1> <p2> [duel1]
-cc get application <projectPath> [encodedCondJson]
-cc delete application <projectPath> <appId>
-cc doc application <introduction|devguide>
+cloudcc create application <path> <p1> <p2> [duel1]
+cloudcc get application <projectPath> [encodedCondJson]
+cloudcc delete application <projectPath> <appId>
+cloudcc doc application <introduction|devguide>
 ```
 
 参数约定：
@@ -45,7 +45,7 @@ cc doc application <introduction|devguide>
 ## 4. 创建应用
 
 ```bash
-cc create application <path> <p1> <p2> [duel1]
+cloudcc create application <path> <p1> <p2> [duel1]
 ```
 
 ### 4.1 参数说明
@@ -65,10 +65,10 @@ cc create application <path> <p1> <p2> [duel1]
 
 ```bash
 # 使用默认菜单 ID
-cc create application . "销售工作台" sales_workbench
+cloudcc create application . "销售工作台" sales_workbench
 
 # 指定菜单 ID（可多个）
-cc create application . "销售工作台" sales_workbench "acf000001,a0I9D000000XXXXUAI"
+cloudcc create application . "销售工作台" sales_workbench "acf000001,a0I9D000000XXXXUAI"
 ```
 
 ### 4.4 常见报错
@@ -77,7 +77,7 @@ cc create application . "销售工作台" sales_workbench "acf000001,a0I9D000000
 
 ```text
 Error: 缺少必需参数
-用法: cc create application <path> <p1> <p2> [duel1]
+用法: cloudcc create application <path> <p1> <p2> [duel1]
 ```
 
 - 角色列表获取失败（依赖 `brief/get`）：
@@ -91,7 +91,7 @@ Error: 缺少必需参数
 ## 5. 查询应用
 
 ```bash
-cc get application <projectPath> [encodedCondJson]
+cloudcc get application <projectPath> [encodedCondJson]
 ```
 
 说明：
@@ -103,10 +103,10 @@ cc get application <projectPath> [encodedCondJson]
 
 ```bash
 # 查询全部应用
-cc get application .
+cloudcc get application .
 
 # 按条件查询（示例）
-cc get application . '%7B%22appType%22%3A%22app%22%7D'
+cloudcc get application . '%7B%22appType%22%3A%22app%22%7D'
 ```
 
 若条件 JSON 无法解析，会报错：
@@ -120,7 +120,7 @@ Get Application List Failed: encodedCondJson 解析失败，请传 encodeURI(JSO
 ## 6. 删除应用
 
 ```bash
-cc delete application <projectPath> <appId>
+cloudcc delete application <projectPath> <appId>
 ```
 
 参数说明：
@@ -131,14 +131,14 @@ cc delete application <projectPath> <appId>
 示例：
 
 ```bash
-cc delete application . a0L9D000000XXXXUAI
+cloudcc delete application . a0L9D000000XXXXUAI
 ```
 
 缺少 `appId` 时会报错：
 
 ```text
 Error: 缺少应用 ID
-用法: cc delete application <projectPath> <appId>
+用法: cloudcc delete application <projectPath> <appId>
 ```
 
 ---
@@ -146,8 +146,8 @@ Error: 缺少应用 ID
 ## 7. 文档命令
 
 ```bash
-cc doc application introduction
-cc doc application devguide
+cloudcc doc application introduction
+cloudcc doc application devguide
 ```
 
 仅支持 `introduction` 与 `devguide`，其他子命令会抛错。
@@ -158,16 +158,16 @@ cc doc application devguide
 
 ```bash
 # 1) 先查现有应用，避免重名
-cc get application .
+cloudcc get application .
 
 # 2) 创建应用
-cc create application . "销售工作台" sales_workbench
+cloudcc create application . "销售工作台" sales_workbench
 
 # 3) 再次查询确认已创建
-cc get application .
+cloudcc get application .
 
 # 4) 如需回滚，按 appId 删除
-cc delete application . <appId>
+cloudcc delete application . <appId>
 ```
 
 ---

package/src/application/docs/introduction.md

@@ -76,6 +76,6 @@
 ## 8. 相关文档与命令
 
 ```bash
-cc doc application introduction
-cc doc application devguide
+cloudcc doc application introduction
+cloudcc doc application devguide
 ```

package/src/button/create.js

@@ -0,0 +1,169 @@
+/**
+ * 自定义按钮 - 新建
+ * API: POST {setupSvc}/api/buttonlink/saveButton
+ * CLI: cloudcc create button <projectPath> <objid> <label> [name] [btnType] [event]
+ *
+ * 参数说明：
+ * - projectPath  : 项目根目录
+ * - objid        : 对象 ID
+ * - label        : 按钮标签（必填）
+ * - name         : 按钮 API 名称（可选，默认同 label）
+ * - btnType      : 显示类型，detailBtn（详情页面按钮，默认）| listBtn（列表按钮）
+ * - event        : 按钮类型，template（默认）| lightning-script | lightning-url | url
+ *
+ * 各类型默认值：
+ * - template / lightning-script : functionCode = "alert('hello world')"
+ * - lightning-script            : h5FunctionCode = "alert('hello world')"
+ * - lightning-url / url         : functionCode = "www.cloudcc.com"
+ * - lightning-url               : mobileurl 自动选取自定义页面组件列表第一项
+ */
+const chalk = require("chalk");
+const axios = require("axios");
+const https = require("https");
+const http = require("http");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+// 用户侧 event 名称 -> API 实际 event 值
+const EVENT_MAP = {
+    "template": "lightning",
+    "lightning-script": "lightning-script",
+    "lightning-url": "lightning-url",
+    "url": "URL"
+};
+
+const httpsAgent = new https.Agent({ rejectUnauthorized: false });
+const httpAgent = new http.Agent({ rejectUnauthorized: false });
+
+/**
+ * 从 devconsole-svc 获取自定义页面组件列表，返回首个页面对象
+ * @param {string} setupSvc  配置中的 setupSvc 地址
+ * @param {string} accessToken
+ */
+async function fetchFirstCustomPage(setupSvc, accessToken) {
+    // 从 setupSvc 移除末尾服务路径，拼 devconsole 路径
+    // 例：https://xxx/ccdomaingateway/setup → https://xxx/ccdomaingateway/devconsole/...
+    const base = setupSvc.replace(/\/[^/]+$/, "");
+    const url = base + "/devconsole/custom/pc/1.0/post/pageCustomPage";
+    const res = await axios({
+        url,
+        method: "post",
+        httpsAgent,
+        httpAgent,
+        timeout: 60000,
+        headers: { "Content-Type": "application/json; charset=utf-8" },
+        data: {
+            head: {
+                appType: "lightning-setup",
+                appVersion: "0.0.1",
+                accessToken,
+                source: "lightning-setup",
+                version: "public"
+            },
+            body: {
+                pageNo: 1,
+                pageSize: 2000000,
+                condition: { pageLabel: "", dtBegin: "", dtEnd: "" }
+            }
+        }
+    });
+    const list = res.data && res.data.data && res.data.data.list;
+    return Array.isArray(list) && list.length > 0 ? list[0] : null;
+}
+
+/**
+ * 新建自定义按钮
+ * @param {string} projectPath
+ * @param {string} objid       对象 ID
+ * @param {string} label       按钮标签
+ * @param {string} name        按钮 API 名称（可选）
+ * @param {string} btnType     detailBtn | listBtn（默认 detailBtn）
+ * @param {string} eventType   template | lightning-script | lightning-url | url（默认 template）
+ */
+async function create(projectPath = process.cwd(), objid, label, name, btnType = "detailBtn", eventType = "template") {
+    if (!objid) throw new Error("Create Button Failed: objid is required");
+    if (!label) throw new Error("Create Button Failed: label is required");
+
+    const resolvedName = name || label;
+    const resolvedBtnType = btnType || "detailBtn";
+    const resolvedEvent = eventType || "template";
+
+    const apiEvent = EVENT_MAP[resolvedEvent];
+    if (!apiEvent) {
+        throw new Error(
+            `Create Button Failed: unknown event type "${resolvedEvent}". ` +
+            `Must be one of: template, lightning-script, lightning-url, url`
+        );
+    }
+
+    const config = await getPackageJson(projectPath);
+
+    console.error();
+    console.error(chalk.green("Creating custom button, please wait..."));
+    console.error();
+
+    // 构建按钮 VO 基础结构
+    const tpSysButtonVO = {
+        label,
+        name: resolvedName,
+        btnType: resolvedBtnType,
+        event: apiEvent,
+        behavior: "self",
+        menubar: true,
+        functionCode: "",
+        remark: "",
+        mobileurl: "",
+        h5FunctionCode: "",
+        category: "CustomButton",
+        custompageId: "",
+        iscustom: "",
+        visible: "1"
+    };
+
+    // 按类型填充默认值
+    if (resolvedEvent === "template") {
+        // PC 端 JavaScript 代码
+        tpSysButtonVO.functionCode = "alert('hello world')";
+    } else if (resolvedEvent === "lightning-script") {
+        // PC + 移动端均支持
+        tpSysButtonVO.functionCode = "alert('hello world')";
+        tpSysButtonVO.h5FunctionCode = "alert('hello world')";
+    } else if (resolvedEvent === "lightning-url") {
+        // PC 端 URL 地址
+        tpSysButtonVO.functionCode = "www.cloudcc.com";
+        // 移动端：自动取自定义页面组件列表第一项
+        try {
+            const firstPage = await fetchFirstCustomPage(config.setupSvc, config.accessToken);
+            if (firstPage) {
+                tpSysButtonVO.mobileurl = `__UNI__110007E/#/pages/index/index?pageApi=${firstPage.pageApi}`;
+                tpSysButtonVO.custompageId = firstPage.id;
+                console.error(chalk.cyan(`Using custom page: ${firstPage.pageLabel} (pageApi: ${firstPage.pageApi})`));
+            } else {
+                console.error(chalk.yellow("Warning: No custom page found, mobileurl will be empty."));
+            }
+        } catch (e) {
+            console.error(chalk.yellow(`Warning: Could not fetch custom page list: ${e.message}`));
+        }
+    } else if (resolvedEvent === "url") {
+        // PC 端 URL（仅 PC 支持）
+        tpSysButtonVO.functionCode = "www.cloudcc.com";
+    }
+
+    const body = { objid, tpSysButtonVO };
+
+    const res = await postClass(
+        config.setupSvc + "/api/buttonlink/saveButton",
+        body,
+        config.accessToken
+    );
+
+    if (res && res.result) {
+        console.error(chalk.green(`Success! Custom button "${label}" created.`));
+        console.error();
+        return res;
+    }
+
+    throw new Error("Create Button Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+}
+
+module.exports = create;

package/src/button/delete.js

@@ -0,0 +1,35 @@
+/**
+ * 自定义按钮 - 删除
+ * API: POST {setupSvc}/api/buttonlink/deleteButton
+ * CLI: cloudcc delete button <projectPath> <id>
+ *
+ * 参数说明：
+ * - projectPath : 项目根目录
+ * - id          : 自定义按钮 ID
+ */
+const chalk = require("chalk");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+async function remove(projectPath = process.cwd(), id) {
+    if (!id) {
+        throw new Error("Delete Button Failed: id is required");
+    }
+    const config = await getPackageJson(projectPath);
+    console.error();
+    console.error(chalk.green(`Deleting button (${id}), please wait...`));
+    console.error();
+    const res = await postClass(
+        config.setupSvc + "/api/buttonlink/deleteButton",
+        { id },
+        config.accessToken
+    );
+    if (res && res.result) {
+        console.error(chalk.green("Success! Button deleted."));
+        console.error();
+        return res;
+    }
+    throw new Error("Delete Button Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+}
+
+module.exports = remove;

package/src/button/doc.js

@@ -0,0 +1,36 @@
+/**
+ * button 文档统一入口
+ */
+const fs = require("fs");
+const path = require("path");
+
+const DOCS_DIR = path.join(__dirname, "docs");
+
+function readDocFile(basename) {
+    return fs.readFileSync(path.join(DOCS_DIR, `${basename}.md`), "utf8");
+}
+
+/**
+ * cloudcc doc button <introduction|devguide>
+ * @param {string[]} argvs [doc, type, introduction|devguide, ...]
+ */
+function doc(argvs) {
+    const subType = argvs[2];
+    const key = String(subType || "").trim().toLowerCase();
+    if (!key) {
+        throw new Error("cloudcc doc button 需要子命令：introduction 或 devguide");
+    }
+    if (key === "introduction") {
+        const content = readDocFile("introduction");
+        console.log(content);
+        return content;
+    }
+    if (key === "devguide") {
+        const content = readDocFile("devguide");
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`);
+}
+
+module.exports = doc;

package/src/button/docs/devguide.md

@@ -0,0 +1,133 @@
+# CloudCC 按钮与链接操作指南
+
+---
+
+## 1. 入口与列表页
+
+进入路径：`对象管理 → 选择对象 → 按钮和链接` 标签页
+
+列表页分为两个 Tab：
+- **标准按钮和链接**：系统内置，不可删除
+- **自定义按钮和链接**：开发者自定义
+
+列表展示字段：标签 / 名称 / 显示类型
+
+---
+
+## 2. 查询按钮列表
+
+```bash
+cloudcc get button . <prefix>
+```
+
+- `<prefix>`：对象的 prefix，可从对象管理页或对象 API 名称前缀获取（如 `a75`）
+
+返回结构：
+
+```json
+{
+  "objname": "玫瑰花不带刺",
+  "objid": "202646FC67ACF24D39sG",
+  "standbutton": [
+    {
+      "id": "adc20262A1F4957UmT0l",
+      "label": "提交待审批",
+      "name": "Submit",
+      "btnType": "detailBtn",
+      "category": "StandardButton",
+      "event": "URL",
+      "behavior": "self",
+      "url": null,
+      "functionCode": null,
+      "mobileurl": ""
+    }
+  ],
+  "custbutton": []
+}
+```
+
+| 字段          | 说明                                        |
+|---------------|---------------------------------------------|
+| `standbutton` | 标准按钮列表                                |
+| `custbutton`  | 自定义按钮列表                              |
+| `btnType`     | `detailBtn` 详情页按钮 / `listBtn` 列表按钮 |
+| `category`    | `StandardButton` 标准 / `CustomButton` 自定义 |
+| `event`       | `URL` 跳转 / `JavaScript` 执行脚本         |
+| `behavior`    | 打开方式：`self` 当前页 / `newWindow` 新窗口 |
+
+---
+
+## 3. 新建自定义按钮
+
+```bash
+cloudcc create button . <objid> <label> [name] [btnType] [event]
+```
+
+| 参数        | 必填 | 说明                                                                        |
+|-------------|------|-----------------------------------------------------------------------------|
+| `objid`     | ✅   | 所属对象 ID                                                                 |
+| `label`     | ✅   | 按钮标签（显示名称）                                                        |
+| `name`      | ❌   | 按钮 API 名称，默认同 `label`                                               |
+| `btnType`   | ❌   | 显示类型：`detailBtn`（详情页按钮，默认）/ `listBtn`（列表按钮）            |
+| `event`     | ❌   | 按钮类型，见下表，默认 `template`                                           |
+
+### 按钮类型（event）
+
+| 取值              | 平台支持         | 说明                                                      |
+|-------------------|------------------|-----------------------------------------------------------|
+| `template`        | 仅 PC            | PC 端 JavaScript 代码，默认代码 `alert('hello world')`    |
+| `lightning-script`| PC + 移动端      | PC 和移动端各需要 JS 代码，默认均为 `alert('hello world')` |
+| `lightning-url`   | PC + 移动端      | PC 端填 URL，移动端自动选取自定义页面组件列表第一项       |
+| `url`             | 仅 PC            | PC 端 URL 地址，默认 `www.cloudcc.com`                    |
+
+### 示例
+
+```bash
+# 新建 template 类型按钮（默认）
+cloudcc create button . 202646FC67ACF24D39sG "我的按钮"
+
+# 指定名称和显示类型
+cloudcc create button . 202646FC67ACF24D39sG "我的按钮" myBtn detailBtn
+
+# lightning-script 类型，列表按钮
+cloudcc create button . 202646FC67ACF24D39sG "脚本按钮" scriptBtn listBtn lightning-script
+
+# lightning-url 类型（移动端自动取第一个自定义页面组件）
+cloudcc create button . 202646FC67ACF24D39sG "跳转按钮" urlBtn detailBtn lightning-url
+
+# url 类型
+cloudcc create button . 202646FC67ACF24D39sG "外链按钮" linkBtn detailBtn url
+```
+
+> **注意：** 各类型代码/URL 默认值仅供快速创建使用，创建后请在页面上编辑替换为实际内容。
+
+---
+
+## 4. 删除自定义按钮
+
+```bash
+cloudcc delete button . <id>
+```
+
+| 参数  | 必填 | 说明               |
+|-------|------|--------------------|
+| `id`  | ✅   | 自定义按钮 ID      |
+
+> **注意：** 仅支持删除自定义按钮，标准按钮不可删除。
+
+### 示例
+
+```bash
+cloudcc delete button . adc202642BBED6BFlu6D
+```
+
+---
+
+## 5. 查看文档
+
+```bash
+cloudcc doc button introduction   # 能力与适用场景说明
+cloudcc doc button devguide        # 本操作指南
+```
+
+---

package/src/button/docs/introduction.md

@@ -0,0 +1,60 @@
+# CloudCC 按钮与链接能力说明
+
+## 1. 什么是按钮与链接
+
+按钮和链接有助于将 CloudCC 数据与外部 URL、应用程序、公司内部网或其他后端办公系统集成在一起。
+
+按钮可以显示在以下位置：
+- **详细信息页**：记录详情页面上的操作按钮
+- **相关列表**：对象关联子列表区域的操作按钮
+- **列表视图**：搜索/列表布局中的批量操作按钮
+
+---
+
+## 2. 按钮分类
+
+### 2.1 标准按钮（Standard Button）
+
+系统内置的标准操作按钮，不可删除，可控制显示/隐藏。
+
+| 标签       | 名称           | 显示类型         |
+|------------|----------------|-----------------|
+| 提交待审批  | Submit         | 详细信息页按钮   |
+| 编辑        | Edit           | 详细信息页按钮   |
+| 新建        | New            | 列表按钮         |
+| 批量转移    | Batch Transfer | 列表按钮         |
+| 删除        | Delete         | 详细信息页按钮   |
+| 批量新增    | Batch Added    | 列表按钮         |
+| 复制        | Clone          | 详细信息页按钮   |
+| 共享        | Share          | 详细信息页按钮   |
+| 批量删除    | Batch Delete   | 列表按钮         |
+| 批量编辑    | Batch Editor   | 列表按钮         |
+| 合并        | Merge          | 列表按钮         |
+
+### 2.2 自定义按钮（Custom Button）
+
+开发者自定义的按钮或链接，支持配置跳转 URL、执行脚本、调用自定义类等行为。
+
+---
+
+## 3. 按钮类型（btnType）
+
+| 值          | 说明           |
+|-------------|----------------|
+| `detailBtn` | 详细信息页按钮  |
+| `listBtn`   | 列表按钮        |
+
+## 4. 按钮行为（event）
+
+| 值            | 说明                   |
+|---------------|------------------------|
+| `URL`         | 跳转到指定 URL         |
+| `JavaScript`  | 执行 JavaScript 代码   |
+
+---
+
+## 5. 如何将按钮添加到页面
+
+- **详细信息页**：编辑页面布局，将按钮拖入布局
+- **相关列表**：在页面布局中找到相关列表，编辑其属性
+- **列表视图**：在"搜索布局"中编辑列表视图布局