cloudcc-cli 2.3.4 → 2.3.6

package/src/customSetting/docs/devguide.md

@@ -1,6 +1,6 @@
 # CloudCC 自定义设置操作指南
 
-直接查看 CLI 文档：`cc doc customSetting`
+直接查看 CLI 文档：`cloudcc doc customSetting`
 
 ---
 
@@ -62,7 +62,7 @@
 #### 1) 查询自定义设置列表
 命令：
 ```bash
-cc get customSetting <projectPath> [encodedCondJson]
+cloudcc get customSetting <projectPath> [encodedCondJson]
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -72,7 +72,7 @@ cc get customSetting <projectPath> [encodedCondJson]
 #### 2) 查询自定义设置详情（含字段列表）
 命令：
 ```bash
-cc detail customSetting <projectPath> <settingId>
+cloudcc detail customSetting <projectPath> <settingId>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -82,7 +82,7 @@ cc detail customSetting <projectPath> <settingId>
 #### 3) 新建/更新自定义设置主对象
 命令：
 ```bash
-cc create customSetting <projectPath> <encodedBodyJson>
+cloudcc create customSetting <projectPath> <encodedBodyJson>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -101,7 +101,7 @@ cc create customSetting <projectPath> <encodedBodyJson>
 #### 4) 编辑前回显主对象表单数据
 命令：
 ```bash
-cc modify customSetting <projectPath> <settingId>
+cloudcc modify customSetting <projectPath> <settingId>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -111,7 +111,7 @@ cc modify customSetting <projectPath> <settingId>
 #### 5) 删除自定义设置主对象
 命令：
 ```bash
-cc delete customSetting <projectPath> <settingId>
+cloudcc delete customSetting <projectPath> <settingId>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -123,7 +123,7 @@ cc delete customSetting <projectPath> <settingId>
 #### 6) 进入字段编辑（取字段编辑所需数据）
 命令：
 ```bash
-cc editCustomSettingField customSetting <projectPath> <queryrecordid>
+cloudcc editCustomSettingField customSetting <projectPath> <queryrecordid>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -133,7 +133,7 @@ cc editCustomSettingField customSetting <projectPath> <queryrecordid>
 #### 7) 保存字段（新增/编辑字段）
 命令：
 ```bash
-cc saveCustomSettingField customSetting <projectPath> <encodedBodyJson>
+cloudcc saveCustomSettingField customSetting <projectPath> <encodedBodyJson>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
@@ -160,7 +160,7 @@ cc saveCustomSettingField customSetting <projectPath> <encodedBodyJson>
 #### 8) 删除自定义字段
 命令：
 ```bash
-cc deleteCustomSettingField customSetting <projectPath> <fieldId> <settingId>
+cloudcc deleteCustomSettingField customSetting <projectPath> <fieldId> <settingId>
 ```
 请求参数：
 | 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |

package/src/customSetting/editCustomSettingField.js

@@ -1,7 +1,7 @@
 /**
  * 自定义设置字段 - 进入字段编辑（取字段编辑所需数据）
  * API: POST {setupSvc}/api/customsetting/editfile
- * CLI: cc editCustomSettingField customSetting <projectPath> <queryrecordid>
+ * CLI: cloudcc editCustomSettingField customSetting <projectPath> <queryrecordid>
  * 参数说明：
  * - projectPath: 项目根目录
  * - queryrecordid: 字段行 id

package/src/customSetting/get.js

@@ -1,7 +1,7 @@
 /**
  * 自定义设置 - 查询列表
  * API: POST {setupSvc}/api/customsetting/list
- * CLI: cc get customSetting <projectPath> [encodedCondJson]
+ * CLI: cloudcc get customSetting <projectPath> [encodedCondJson]
  * 参数说明：
  * - projectPath: 项目根目录
  * - encodedCondJson(可选): encodeURI(JSON.stringify(body))

package/src/customSetting/modify.js

@@ -1,7 +1,7 @@
 /**
  * 自定义设置 - 编辑前回显（主对象）
  * API: POST {setupSvc}/api/customsetting/modify
- * CLI: cc modify customSetting <projectPath> <settingId>
+ * CLI: cloudcc modify customSetting <projectPath> <settingId>
  * 参数说明：
  * - projectPath: 项目根目录
  * - objid(命令参数名 settingId): 自定义设置 id

package/src/customSetting/saveCustomSettingField.js

@@ -1,7 +1,7 @@
 /**
  * 自定义设置字段 - 保存字段（新增/编辑）
  * API: POST {setupSvc}/api/customsetting/saveField
- * CLI: cc saveCustomSettingField customSetting <projectPath> <encodedBodyJson>
+ * CLI: cloudcc saveCustomSettingField customSetting <projectPath> <encodedBodyJson>
  * 参数说明：
  * - projectPath: 项目根目录
  * - encodedBodyJson: encodeURI(JSON.stringify(body))

package/src/fields/delete.js

@@ -4,7 +4,7 @@ const { getPackageJson } = require("../../utils/config");
 
 /**
  * 删除字段（彻底删除）
- * 用法：cc delete fields <projectPath> <fieldId> <objid>
+ * 用法：cloudcc delete fields <projectPath> <fieldId> <objid>
  */
 async function remove(argvs) {
     const projectPath = argvs[2] || process.cwd();
@@ -14,7 +14,7 @@ async function remove(argvs) {
     if (!id || !objid) {
         console.error();
         console.error(chalk.red("Error: fieldId and objid are required"));
-        console.error(chalk.yellow("Usage: cc delete fields <projectPath> <fieldId> <objid>"));
+        console.error(chalk.yellow("Usage: cloudcc delete fields <projectPath> <fieldId> <objid>"));
         console.error();
         return;
     }

package/src/fields/docs/devguide.md

@@ -7,8 +7,8 @@
 可通过以下命令读取文档：
 
 ```bash
-cc doc fields introduction
-cc doc fields devguide
+cloudcc doc fields introduction
+cloudcc doc fields devguide
 ```
 
 ---
@@ -16,9 +16,9 @@ cc doc fields devguide
 ## 2. 当前支持的命令
 
 ```bash
-cc get fields <projectPath> <objPrefix>
-cc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
-cc delete fields <projectPath> <fieldId> <objid>
+cloudcc get fields <projectPath> <objPrefix>
+cloudcc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
+cloudcc delete fields <projectPath> <fieldId> <objid>
 ```
 
 说明：
@@ -43,7 +43,7 @@ cc delete fields <projectPath> <fieldId> <objid>
 ### 3.1 基本命令
 
 ```bash
-cc get fields <projectPath> <objPrefix>
+cloudcc get fields <projectPath> <objPrefix>
 ```
 
 返回结果包含：
@@ -66,7 +66,7 @@ cc get fields <projectPath> <objPrefix>
 ### 4.1 基本命令
 
 ```bash
-cc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
+cloudcc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
 ```
 
 建议：
@@ -119,8 +119,8 @@ cc create fields <projectPath> <fieldType> <objid> <fieldLabel> [extraArg]
 这两类字段创建时都需要额外的选项值参数：
 
 ```bash
-cc create fields <projectPath> L <objid> <fieldLabel> <ptext>
-cc create fields <projectPath> Q <objid> <fieldLabel> <ptext>
+cloudcc create fields <projectPath> L <objid> <fieldLabel> <ptext>
+cloudcc create fields <projectPath> Q <objid> <fieldLabel> <ptext>
 ```
 
 其中 `ptext` 表示选项内容，通常用于传入候选值集合。
@@ -144,9 +144,9 @@ cc create fields <projectPath> Q <objid> <fieldLabel> <ptext>
 这三类字段创建时都需要额外传入目标对象参数：
 
 ```bash
-cc create fields <projectPath> Y <objid> <fieldLabel> <lookupObj>
-cc create fields <projectPath> MR <objid> <fieldLabel> <lookupObj>
-cc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
+cloudcc create fields <projectPath> Y <objid> <fieldLabel> <lookupObj>
+cloudcc create fields <projectPath> MR <objid> <fieldLabel> <lookupObj>
+cloudcc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
 ```
 
 其中 `lookupObj` 表示被关联对象。
@@ -196,7 +196,7 @@ cc create fields <projectPath> M <objid> <fieldLabel> <lookupObj>
 ### 5.1 基本命令
 
 ```bash
-cc delete fields <projectPath> <fieldId> <objid>
+cloudcc delete fields <projectPath> <fieldId> <objid>
 ```
 
 删除前建议：
@@ -209,7 +209,7 @@ cc delete fields <projectPath> <fieldId> <objid>
 
 ## 6. 开发前检查
 
-- 已完成 `cc doc project devguide` 中的环境准备
+- 已完成 `cloudcc doc project devguide` 中的环境准备
 - 项目根目录存在可用的 `cloudcc-cli.config.js`
 - 当前环境密钥配置正确
 - 已确认对象 API 名称、字段类型和命名规则

package/src/fields/docs/introduction.md

@@ -46,8 +46,8 @@ CloudCC 对象上的字段通常分为两类：
 可通过以下命令读取文档：
 
 ```bash
-cc doc fields introduction
-cc doc fields devguide
+cloudcc doc fields introduction
+cloudcc doc fields devguide
 ```
 
 ---
@@ -129,7 +129,7 @@ cc doc fields devguide
 - CloudCC 平台支持的完整字段能力
 - 当前 CLI 已实现的字段创建能力
 
-命令开发与自动化脚本，应以 `cc doc fields devguide` 中列出的“当前 CLI
+命令开发与自动化脚本，应以 `cloudcc doc fields devguide` 中列出的“当前 CLI
 支持字段类型”为准。
 
 ---

package/src/globalSelectList/create.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc create globalSelectList [projectPath] [encodedBodyJson]
+ * cloudcc create globalSelectList [projectPath] [encodedBodyJson]
  *
  * encodedBodyJson 示例（URI 编码前）：
  * {

package/src/globalSelectList/delete.js

@@ -3,7 +3,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc delete globalSelectList [projectPath] [id]
+ * cloudcc delete globalSelectList [projectPath] [id]
  *
  * 删除逻辑：
  * 1. 先以 deleteFromDisk=false 执行软删除

package/src/globalSelectList/detail.js

@@ -2,7 +2,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc detail globalSelectList [projectPath] [id]
+ * cloudcc detail globalSelectList [projectPath] [id]
  *
  * 返回结构：
  * {

package/src/globalSelectList/doc.js

@@ -27,14 +27,14 @@ function getDevGuideDoc() {
 }
 
 /**
- * cc doc globalSelectList <introduction|devguide>
+ * cloudcc doc globalSelectList <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 globalSelectList 需要子命令：introduction 或 devguide");
+        throw new Error("cloudcc doc globalSelectList 需要子命令：introduction 或 devguide");
     }
     if (key === "introduction") {
         const content = getIntroductionDoc();

package/src/globalSelectList/docs/devguide.md

@@ -35,7 +35,7 @@
 参数使用 `encodeURI` 编码后传入（保留 `"` 和 `:` 等 JSON 必要字符）：
 
 ```bash
-cc create globalSelectList . '%7B%22label%22:%22%E5%AE%A2%E6%88%B7%E7%AD%89%E7%BA%A7%22,%22name%22:%22customer_level%22,%22description%22:%22%E5%AE%A2%E6%88%B7%E7%AD%89%E7%BA%A7%E5%88%86%E7%B1%BB%22,%22ptext%22:%22%E6%99%AE%E9%80%9A%5Cr%5Cn%E9%93%B6%E7%89%8C%5Cr%5Cn%E9%87%91%E7%89%8C%22,%22isPicklistSorted%22:%220%22,%22isFirstDefault%22:%220%22%7D'
+cloudcc create globalSelectList . '%7B%22label%22:%22%E5%AE%A2%E6%88%B7%E7%AD%89%E7%BA%A7%22,%22name%22:%22customer_level%22,%22description%22:%22%E5%AE%A2%E6%88%B7%E7%AD%89%E7%BA%A7%E5%88%86%E7%B1%BB%22,%22ptext%22:%22%E6%99%AE%E9%80%9A%5Cr%5Cn%E9%93%B6%E7%89%8C%5Cr%5Cn%E9%87%91%E7%89%8C%22,%22isPicklistSorted%22:%220%22,%22isFirstDefault%22:%220%22%7D'
 ```
 
 原始 JSON（`encodeURI` 编码前）：
@@ -59,10 +59,10 @@ cc create globalSelectList . '%7B%22label%22:%22%E5%AE%A2%E6%88%B7%E7%AD%89%E7%B
 
 ```bash
 # 获取全部列表（默认分页 pageSize=10000）
-cc get globalSelectList
+cloudcc get globalSelectList
 
 # 指定项目路径
-cc get globalSelectList /path/to/project
+cloudcc get globalSelectList /path/to/project
 ```
 
 返回结果为 `globalSelectList` 数组，每条记录包含：
@@ -85,7 +85,7 @@ cc get globalSelectList /path/to/project
 ## 4. 查看详情
 
 ```bash
-cc detail globalSelectList . <id>
+cloudcc detail globalSelectList . <id>
 ```
 
 - `<id>`：全局选项列表的 ID，可从列表接口返回值中获取
@@ -129,7 +129,7 @@ cc detail globalSelectList . <id>
 ## 5. 删除全局选项列表
 
 ```bash
-cc delete globalSelectList . <id>
+cloudcc delete globalSelectList . <id>
 ```
 
 删除逻辑分两步自动处理：
@@ -144,10 +144,10 @@ cc delete globalSelectList . <id>
 
 ```bash
 # 查看能力介绍
-cc doc globalSelectList introduction
+cloudcc doc globalSelectList introduction
 
 # 查看操作指南（本文）
-cc doc globalSelectList devguide
+cloudcc doc globalSelectList devguide
 ```
 
 

package/src/globalSelectList/get.js

@@ -2,7 +2,7 @@ const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
 /**
- * cc get globalSelectList [projectPath] [encodedCondJson]
+ * cloudcc get globalSelectList [projectPath] [encodedCondJson]
  * @param {string} projectPath
  * @param {string} encodedCondJson
  * @param {boolean} isMcp

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
+ * 用法：cloudcc 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("用法: cloudcc create identityProvider <path> <entityid> <acsurl>"));
+            console.error(chalk.yellow("示例: cloudcc 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
+ * 用法：cloudcc 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("用法: cloudcc delete identityProvider <projectPath> <appId>"));
+            console.error(chalk.yellow("示例: cloudcc 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");
+}
+
+/**
+ * cloudcc 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("cloudcc 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
+cloudcc create identityProvider <path> <entityid> <acsurl>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 是 | 项目路径，`.` 表示当前目录 |
+| `entityid` | 是 | 实体 ID（Service Provider Entity ID）|
+| `acsurl` | 是 | ACS URL（Assertion Consumer Service URL）|
+
+**示例：**
+
+```bash
+# 创建身份提供商
+cloudcc create identityProvider . "http://testdev.cloudcc.cn/ccdomaingateway/apisvc" "http://testdev.cloudcc.cn/ccdomaingateway/apisvc/saml2/sp/sso/acs"
+```
+
+### 查询身份提供商列表
+
+```bash
+cloudcc get identityProvider <projectPath> [encodedCondJson]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `encodedCondJson` | 否 | URI 编码后的查询条件 JSON |
+
+**查询条件参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| `start` | number | 起始位置，默认 0 |
+| `limit` | number | 每页条数，默认 30 |
+| `keyword` | string | 搜索关键词 |
+
+**示例：**
+
+```bash
+# 获取所有身份提供商
+cloudcc get identityProvider .
+
+# 带查询条件（搜索关键词）
+cloudcc get identityProvider . '%7B%22keyword%22%3A%22test%22%2C%22limit%22%3A50%7D'
+```
+
+### 删除身份提供商
+
+```bash
+cloudcc delete identityProvider <projectPath> <appId>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `appId` | 是 | 身份提供商的 app 字段值（从列表接口获取）|
+
+**示例：**
+
+```bash
+# 删除身份提供商
+cloudcc delete identityProvider . QbjH30d9Oy
+```
+
+### 下载身份提供商证书
+
+```bash
+cloudcc download identityProvider <projectPath> [savePath]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `savePath` | 否 | 证书保存路径，默认当前目录 |
+
+**示例：**
+
+```bash
+# 下载证书到当前目录
+cloudcc download identityProvider .
+
+# 下载证书到指定路径
+cloudcc 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` | 自定义属性名称 | 空字符串 |