cloudcc-cli 2.3.3 → 2.3.5

package/src/button/index.js

@@ -0,0 +1,20 @@
+const cc = {};
+cc.doc = require("./doc");
+cc.get = require("./get");
+cc.create = require("./create");
+cc.delete = require("./delete");
+
+function Button(action, argvs) {
+    if (action === "doc") {
+        cc.doc(argvs);
+        return;
+    }
+    if (action === "create") {
+        // cc create button <projectPath> <objid> <label> [name] [btnType] [event]
+        cc.create(argvs[2], argvs[3], argvs[4], argvs[5], argvs[6], argvs[7]);
+        return;
+    }
+    cc[action](argvs[2], argvs[3], argvs[4]);
+}
+
+module.exports = Button;

package/src/classes/docs/introduction.md

@@ -232,26 +232,6 @@
 
 ---
 
-## 11. 线上现状观察（来自当前环境）
-
-线上共 87 个自定义类，命名与职责呈现明显分层趋势：
-
-- `Controller` 类：承接流程入口与动作编排
-- `Util` 类：沉淀通用方法与查询能力
-- `Service` 类：承担外部集成与业务服务
-- `Handler` 类：承接触发器下沉逻辑
-- `Bot` 类：承载智能助手相关业务
-
-从源码统计看，当前环境中大量类已在使用：
-
-- `CCService`（数据 CRUD 与查询）
-- JSON 处理能力
-- 异常机制（`Exception` 相关）
-
-这说明自定义类已成为该环境中“复杂逻辑与复用能力”的核心载体。
-
----
-
 ## 12. 一句话结论
 
 当业务进入“多对象、复杂规则、跨系统、可复用、可治理”阶段时，CloudCC 自定义类是最关键的后端实现手段：它不仅能实现功能，更能提升系统长期可维护性与稳定性。

package/src/fields/create.js

@@ -180,6 +180,18 @@ async function create(argvs) {
             let lookupObj = argvs[6];
             fieldData = M(objid, nameLabel, apiname, lookupObj, briefData.data);
         }
+        // 查询页面布局列表，取第一个绑定到字段
+        if (fieldData) {
+            const layoutRes = await postClass(
+                config.setupSvc + "/api/layout/newpage",
+                { objid: objid },
+                config.accessToken
+            );
+            if (layoutRes && layoutRes.result && Array.isArray(layoutRes.data) && layoutRes.data.length > 0) {
+                fieldData.layoutIds = layoutRes.data[0].id;
+            }
+        }
+        fieldData.remark = "auto created by cloudcc-cli ai agent";
         // 发送请求到服务器
         const result = await postClass(
             config.setupSvc + "/api/fieldSetup/save",

package/src/identityProvider/create.js

@@ -0,0 +1,78 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 创建身份提供商
+ * 接口: /samlSp/save
+ * 用法：cc create identityProvider <path> <entityid> <acsurl>
+ */
+async function create(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const entityid = argvs[3];
+        const acsurl = argvs[4];
+
+        if (!entityid || !acsurl) {
+            console.error();
+            console.error(chalk.red("Error: 缺少必需参数"));
+            console.error(chalk.yellow("用法: cc create identityProvider <path> <entityid> <acsurl>"));
+            console.error(chalk.yellow("示例: cc create identityProvider . 'http://testdev.cloudcc.cn/ccdomaingateway/apisvc' 'http://testdev.cloudcc.cn/ccdomaingateway/apisvc/saml2/sp/sso/acs'"));
+            console.error();
+            throw new Error("缺少必需参数: entityid 和 acsurl");
+        }
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green(`Creating identity provider, please wait...`));
+        console.error();
+
+        // 构建请求参数
+        const body = {
+            entityid: entityid,
+            acsurl: acsurl,
+            issuername: "",
+            nameidtype: "FederationId",
+            nameidformat: "1",
+            enablelogout: false,
+            logouturl: "",
+            custattrname: "",
+            id: ""
+        };
+
+        const res = await postClass(
+            config.setupSvc + "/api/samlSp/save",
+            body,
+            config.accessToken
+        );
+
+        if (res && res.result) {
+            console.error();
+            console.error(chalk.green("Success! Identity provider created."));
+            if (res.data) {
+                console.error(chalk.gray(`Response: ${JSON.stringify(res.data, null, 2)}`));
+            }
+            console.error();
+            return res;
+        }
+
+        const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+        console.error();
+        console.error(chalk.red("Error: " + msg));
+        console.error();
+        throw new Error("Create IdentityProvider Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("身份提供商创建失败:"), error.message || error);
+        throw error;
+    }
+}
+
+module.exports = create;

package/src/identityProvider/delete.js

@@ -0,0 +1,61 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 删除身份提供商
+ * 接口: /samlSp/delete
+ * 用法：cc delete identityProvider <projectPath> <appId>
+ */
+async function remove(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const appId = argvs[3];
+
+        if (!appId) {
+            console.error();
+            console.error(chalk.red("Error: 缺少身份提供商 app ID"));
+            console.error(chalk.yellow("用法: cc delete identityProvider <projectPath> <appId>"));
+            console.error(chalk.yellow("示例: cc delete identityProvider . QbjH30d9Oy"));
+            console.error();
+            throw new Error("缺少必需参数: appId");
+        }
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green(`Deleting identity provider (${appId}), please wait...`));
+        console.error();
+
+        const result = await postClass(
+            config.setupSvc + "/api/samlSp/delete",
+            { app: appId },
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            console.error();
+            console.error(chalk.green("Success! Identity provider deleted."));
+            console.error();
+            return result;
+        }
+
+        const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+        console.error();
+        console.error(chalk.red("Error: " + msg));
+        console.error();
+        throw new Error("Delete IdentityProvider Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("身份提供商删除失败:"), error);
+        throw error;
+    }
+}
+
+module.exports = remove;

package/src/identityProvider/doc.js

@@ -0,0 +1,46 @@
+/**
+ * identityProvider 文档入口：正文均在 `docs/` 目录。
+ */
+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");
+}
+
+/** 介绍文档：身份提供商能力、类型与入口 */
+function getIntroductionDoc() {
+    return readDocFile("introduction");
+}
+
+/** 开发指导：CLI 创建/查询/删除等 */
+function getDevGuideDoc() {
+    return readDocFile("devguide");
+}
+
+/**
+ * cc doc identityProvider <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 identityProvider 需要子命令：introduction 或 devguide");
+    }
+    if (key === "introduction") {
+        const content = getIntroductionDoc();
+        console.log(content);
+        return content;
+    }
+    if (key === "devguide") {
+        const content = getDevGuideDoc();
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${subType}，请使用 introduction 或 devguide`);
+}
+
+module.exports = doc;

package/src/identityProvider/docs/devguide.md

@@ -0,0 +1,107 @@
+# CloudCC 身份提供商 CLI 命令说明
+
+## 支持的命令
+
+| 操作 | 说明 |
+|------|------|
+| `create` | 创建新身份提供商 |
+| `get` | 查询身份提供商列表 |
+| `delete` | 删除身份提供商 |
+| `download` | 下载身份提供商证书 |
+
+## CLI 命令详解
+
+### 创建身份提供商
+
+```bash
+cc create identityProvider <path> <entityid> <acsurl>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 是 | 项目路径，`.` 表示当前目录 |
+| `entityid` | 是 | 实体 ID（Service Provider Entity ID）|
+| `acsurl` | 是 | ACS URL（Assertion Consumer Service URL）|
+
+**示例：**
+
+```bash
+# 创建身份提供商
+cc create identityProvider . "http://testdev.cloudcc.cn/ccdomaingateway/apisvc" "http://testdev.cloudcc.cn/ccdomaingateway/apisvc/saml2/sp/sso/acs"
+```
+
+### 查询身份提供商列表
+
+```bash
+cc get identityProvider <projectPath> [encodedCondJson]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `encodedCondJson` | 否 | URI 编码后的查询条件 JSON |
+
+**查询条件参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| `start` | number | 起始位置，默认 0 |
+| `limit` | number | 每页条数，默认 30 |
+| `keyword` | string | 搜索关键词 |
+
+**示例：**
+
+```bash
+# 获取所有身份提供商
+cc get identityProvider .
+
+# 带查询条件（搜索关键词）
+cc get identityProvider . '%7B%22keyword%22%3A%22test%22%2C%22limit%22%3A50%7D'
+```
+
+### 删除身份提供商
+
+```bash
+cc delete identityProvider <projectPath> <appId>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `appId` | 是 | 身份提供商的 app 字段值（从列表接口获取）|
+
+**示例：**
+
+```bash
+# 删除身份提供商
+cc delete identityProvider . QbjH30d9Oy
+```
+
+### 下载身份提供商证书
+
+```bash
+cc download identityProvider <projectPath> [savePath]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `savePath` | 否 | 证书保存路径，默认当前目录 |
+
+**示例：**
+
+```bash
+# 下载证书到当前目录
+cc download identityProvider .
+
+# 下载证书到指定路径
+cc download identityProvider . ./certificates
+```

package/src/identityProvider/docs/introduction.md

@@ -0,0 +1,31 @@
+# 身份提供商介绍
+
+## 功能概述
+
+身份提供商（Identity Provider）模块用于管理 CloudCC 平台的 SAML 身份提供商配置，支持以下功能：
+
+- **查看身份提供商列表**：查询已配置的所有 SAML 身份提供商
+- **新建身份提供商**：创建新的 SAML 身份提供商配置
+- **删除身份提供商**：删除已配置的 SAML 身份提供商
+- **下载证书**：下载身份提供商的 SAML 证书
+
+## 适用场景
+
+- 企业单点登录（SSO）集成
+- SAML 2.0 身份提供商配置
+- 多身份提供商管理
+
+## 字段说明
+
+### 身份提供商字段
+
+| 字段名 | 说明 | 默认值 |
+|--------|------|--------|
+| `entityid` | Service Provider Entity ID | 用户输入 |
+| `acsurl` | Assertion Consumer Service URL | 用户输入 |
+| `issuername` | 签发者名称 | 空字符串 |
+| `nameidtype` | Name ID 类型 | FederationId |
+| `nameidformat` | Name ID 格式 | 1 |
+| `enablelogout` | 启用注销 | false |
+| `logouturl` | 注销 URL | 空字符串 |
+| `custattrname` | 自定义属性名称 | 空字符串 |

package/src/identityProvider/download.js

@@ -0,0 +1,105 @@
+const chalk = require("chalk");
+const fs = require("fs");
+const path = require("path");
+const axios = require("axios");
+const https = require("https");
+const { getPackageJson } = require("../../utils/config");
+const { postClass } = require("../../utils/http");
+
+const httpsAgent = new https.Agent({
+    rejectUnauthorized: false,
+});
+
+/**
+ * 下载身份提供商证书
+ * 接口: /LoginHistory/getExportReportURL 获取下载链接，然后下载文件
+ * 用法：cc download identityProvider <projectPath> [savePath]
+ */
+async function download(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const savePath = argvs[3] || process.cwd();
+
+        const config = await getPackageJson(projectPath);
+        if (!config || !config.accessToken) {
+            console.error();
+            console.error(chalk.red("Error: 配置未找到或 accessToken 缺失"));
+            console.error();
+            throw new Error("配置未找到或 accessToken 缺失");
+        }
+
+        console.error();
+        console.error(chalk.green("Downloading certificate, please wait..."));
+        console.error();
+
+        // 确保证书保存目录存在
+        if (!fs.existsSync(savePath)) {
+            fs.mkdirSync(savePath, { recursive: true });
+        }
+
+        // 第一步：调用接口获取下载 URL
+        const result = await postClass(
+            config.setupSvc + "/api/LoginHistory/getExportReportURL",
+            {},
+            config.accessToken
+        );
+
+        if (result && result.result && result.data) {
+            const downloadUrl = result.data;
+
+            console.error(chalk.gray(`Got download URL: ${downloadUrl}`));
+            console.error(chalk.gray(`Downloading file...`));
+            console.error();
+
+            // 第二步：根据返回的 URL 下载文件
+            const response = await axios({
+                method: 'get',
+                url: downloadUrl,
+                httpsAgent: httpsAgent,
+                responseType: 'arraybuffer',
+                timeout: 120000
+            });
+
+            // 尝试从响应头获取文件名
+            let filename = "identity-provider.crt";
+            const contentDisposition = response.headers['content-disposition'];
+            if (contentDisposition) {
+                const match = contentDisposition.match(/filename[^;=\n]*=((['"]).*?\2|[^;\n]*)/);
+                if (match && match[1]) {
+                    filename = match[1].replace(/['"]/g, '');
+                }
+            }
+
+            // 如果 URL 中包含文件名，也尝试从中提取
+            const urlPath = new URL(downloadUrl).pathname;
+            const urlFilename = urlPath.split('/').pop();
+            if (urlFilename && urlFilename.includes('.')) {
+                filename = urlFilename;
+            }
+
+            const filePath = path.join(savePath, filename);
+            fs.writeFileSync(filePath, response.data);
+
+            console.error();
+            console.error(chalk.green("Success! Certificate downloaded."));
+            console.error(chalk.gray(`Saved to: ${filePath}`));
+            console.error();
+
+            return {
+                result: true,
+                filePath: filePath,
+                filename: filename,
+                downloadUrl: downloadUrl
+            };
+        }
+
+        const msg = result && (result.returnInfo || result.message) ? (result.returnInfo || result.message) : "Unknown error";
+        throw new Error("Get download URL failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("证书下载失败:"), error.message || error);
+        throw error;
+    }
+}
+
+module.exports = download;

package/src/identityProvider/get.js

@@ -0,0 +1,70 @@
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const chalk = require("chalk");
+
+/**
+ * 查询身份提供商列表
+ * 接口: /samlSp/queryList
+ * 用法：cc get identityProvider <projectPath> [encodedCondJson]
+ */
+async function get(argvs, isMcp = false) {
+    const projectPath = argvs[2] || process.cwd();
+    const condArg = argvs[3];
+
+    let body = {};
+    if (condArg) {
+        try {
+            body = JSON.parse(decodeURI(condArg));
+        } catch (e) {
+            try {
+                body = JSON.parse(condArg);
+            } catch (e2) {
+                throw new Error("Get IdentityProvider Failed: encodedCondJson 解析失败，请传 encodeURI(JSON.stringify(...))");
+            }
+        }
+    }
+
+    const config = await getPackageJson(projectPath);
+
+    const res = await postClass(
+        config.setupSvc + "/api/samlSp/queryList",
+        {
+            start: 0,
+            limit: 30,
+            keyword: "",
+            ...body
+        },
+        config.accessToken
+    );
+
+    if (res && res.result) {
+        const data = res.data;
+        let rawList = [];
+        if (Array.isArray(data)) {
+            rawList = data;
+        } else if (data && Array.isArray(data.list)) {
+            rawList = data.list;
+        } else if (data && Array.isArray(data.data)) {
+            rawList = data.data;
+        } else if (data && typeof data === "object") {
+            rawList = Object.keys(data)
+                .filter((key) => /list$/i.test(key) && Array.isArray(data[key]))
+                .flatMap((key) =>
+                    data[key].map((item) => ({
+                        ...item,
+                        __group: key
+                    }))
+                );
+        }
+
+        if (!isMcp) {
+            console.log(JSON.stringify(rawList, null, 2));
+        }
+        return rawList;
+    }
+
+    const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+    throw new Error("Get IdentityProvider Failed: " + msg);
+}
+
+module.exports = get;

package/src/identityProvider/index.js

@@ -0,0 +1,12 @@
+const cc = {}
+cc.create = require("./create")
+cc.delete = require("./delete")
+cc.get = require("./get")
+cc.download = require("./download")
+cc.doc = require("./doc")
+
+function main(action, argvs) {
+    cc[action](argvs)
+}
+
+module.exports = main;

package/src/menu/create-object.js

@@ -58,6 +58,7 @@ async function createObjectMenu(argvs) {
             p1: objectId,
             ...commonFields,
             profileIds: profileIds,
+            remark: "auto created by cloudcc-cli ai agent"
         };
 
         // 显示创建进度

package/src/menu/create-page.js

@@ -92,6 +92,7 @@ async function createPageMenu(argvs) {
             pname: pname,
             ...commonFields,
             profileIds: profileIds,
+            remark: "auto created by cloudcc-cli ai agent"
         };
 
         // 显示创建进度

package/src/menu/create-script.js

@@ -115,6 +115,7 @@ async function createScriptMenu(argvs) {
             },
             ...commonFields,
             profileIds: profileIds,
+            remark: "auto created by cloudcc-cli ai agent"
         };
 
         // 显示创建进度

package/src/menu/create-site.js

@@ -72,6 +72,7 @@ async function createSiteMenu(argvs) {
             },
             ...commonFields,
             profileIds: profileIds,
+            remark: "auto created by cloudcc-cli ai agent"
         };
 
         // 显示创建进度

package/src/object/create.js

@@ -67,7 +67,8 @@ async function create(argvs) {
                 beginIndex: "0",
                 isquickcreated: "false",
                 islbs: "false",
-                isreportcreated: "false"
+                isreportcreated: "false",
+                remark: "auto created by cloudcc-cli ai agent"
             }
         };
 

package/src/object/docs/devguide.md

@@ -59,13 +59,9 @@ cc get object <projectPath> custom
 ### 4.1 基本命令
 
 ```bash
-cc create object <projectPath> <label> [nameLabel]
+cc create object <projectPath> <label>
 ```
 
-规则：
-
-- 若传入 `nameLabel`，则使用传入值作为对象 API 名称
-- 若未传入 `nameLabel`，CLI 会根据 `label` 自动生成一个英文可用的 slug，并拼成对象 API 名称
 
 ### 4.2 创建过程