cloudcc-cli 2.3.4 → 2.3.6

package/src/pagelayout/docs/devguide.md

@@ -13,7 +13,7 @@
 ### 查询页面布局列表
 
 ```bash
-cc get pagelayout <projectPath> <prefix>
+cloudcc get pagelayout <projectPath> <prefix>
 ```
 
 **参数说明：**
@@ -27,16 +27,16 @@ cc get pagelayout <projectPath> <prefix>
 
 ```bash
 # 查询对象 b25 的页面布局列表
-cc get pagelayout . b25
+cloudcc get pagelayout . b25
 
 # 查询客户对象（001）的页面布局列表
-cc get pagelayout . 001
+cloudcc get pagelayout . 001
 ```
 
 ### 创建页面布局
 
 ```bash
-cc create pagelayout <projectPath> <objId> <layoutName> [sourceLayoutId] [isCloneDynamic]
+cloudcc create pagelayout <projectPath> <objId> <layoutName> [sourceLayoutId] [isCloneDynamic]
 ```
 
 **参数说明：**
@@ -53,19 +53,19 @@ cc create pagelayout <projectPath> <objId> <layoutName> [sourceLayoutId] [isClon
 
 ```bash
 # 创建页面布局（自动使用默认布局作为模板）
-cc create pagelayout . 20267D1465464C5OB6m5 "课程表2"
+cloudcc create pagelayout . 20267D1465464C5OB6m5 "课程表2"
 
 # 指定源布局 ID 进行复制
-cc create pagelayout . 20267D1465464C5OB6m5 "课程表2" add20261DA7347CZPAUz
+cloudcc create pagelayout . 20267D1465464C5OB6m5 "课程表2" add20261DA7347CZPAUz
 
 # 不复制动态布局规则
-cc create pagelayout . 20267D1465464C5OB6m5 "课程表2" add20261DA7347CZPAUz false
+cloudcc create pagelayout . 20267D1465464C5OB6m5 "课程表2" add20261DA7347CZPAUz false
 ```
 
 ### 删除页面布局
 
 ```bash
-cc delete pagelayout <projectPath> <layoutId>
+cloudcc delete pagelayout <projectPath> <layoutId>
 ```
 
 **参数说明：**
@@ -79,5 +79,5 @@ cc delete pagelayout <projectPath> <layoutId>
 
 ```bash
 # 删除指定页面布局
-cc delete pagelayout . add202610BD89F09XyGT
+cloudcc delete pagelayout . add202610BD89F09XyGT
 ```

package/src/pagelayout/docs/introduction.md

@@ -40,5 +40,5 @@
 查看开发指南了解具体 CLI 命令：
 
 ```bash
-cc doc pagelayout devguide
+cloudcc doc pagelayout devguide
 ```

package/src/pagelayout/get.js

@@ -4,7 +4,7 @@ const chalk = require("chalk");
 
 /**
  * 查询页面布局列表
- * 用法：cc get pagelayout <projectPath> <prefix>
+ * 用法：cloudcc get pagelayout <projectPath> <prefix>
  */
 async function get(argvs, isMcp = false) {
     const projectPath = argvs[2] || process.cwd();
@@ -13,10 +13,10 @@ async function get(argvs, isMcp = false) {
     if (!prefix) {
         console.error();
         console.error(chalk.red("Error: 缺少对象前缀"));
-        console.error("用法: cc get pagelayout <projectPath> <prefix>");
+        console.error("用法: cloudcc get pagelayout <projectPath> <prefix>");
         console.error("示例:");
-        console.error("  cc get pagelayout . 001");
-        console.error("  cc get pagelayout . b25");
+        console.error("  cloudcc get pagelayout . 001");
+        console.error("  cloudcc get pagelayout . b25");
         console.error();
         throw new Error("缺少必需参数: prefix");
     }

package/src/permission/add.js

@@ -0,0 +1,164 @@
+const chalk = require('chalk');
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const inquirer = require('inquirer');
+
+/**
+ * 获取用户视图ID
+ * @param {Object} config - 项目配置
+ * @returns {Promise<string>} 视图ID
+ */
+async function getUserViewId(config) {
+    const res = await postClass(
+        config.setupSvc + "/api/usermange/queryUser",
+        {},
+        config.accessToken
+    );
+
+    if (res && res.result && res.data) {
+        // 优先使用返回的 viewId
+        if (res.data.viewId) {
+            return res.data.viewId;
+        }
+        // 否则使用 viewList 中的第一个
+        if (Array.isArray(res.data.viewList) && res.data.viewList.length > 0) {
+            return res.data.viewList[0].id;
+        }
+    }
+
+    throw new Error("未找到用户视图");
+}
+
+/**
+ * 查询可选用户列表
+ * @param {Object} config - 项目配置
+ * @param {string} viewId - 视图ID
+ * @param {string} keyword - 搜索关键词
+ * @returns {Promise<Array>} 用户列表
+ */
+async function queryUserList(config, viewId, keyword = '') {
+    const res = await postClass(
+        config.setupSvc + "/api/usermange/queryUserList",
+        {
+            start: 0,
+            limit: 10000,
+            viewId: viewId,
+            keyword: keyword,
+            notisusering: "true"
+        },
+        config.accessToken
+    );
+
+    if (res && res.result && res.data) {
+        return res.data.list || [];
+    }
+
+    throw new Error("查询用户列表失败");
+}
+
+/**
+ * 添加权限集分配用户
+ * 用法：cloudcc add permission <projectPath> <permsetId> [userIds...]
+ * 如果不指定 userIds，会进入交互式选择
+ * @param {Array} argvs - 命令行参数数组
+ * @param {boolean} isMcp - 是否为MCP模式
+ * @returns {Promise<Object>} 添加结果
+ */
+async function add(argvs, isMcp = false) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const permsetId = argvs[3];
+        // 从第4个参数开始是用户ID
+        let userIds = argvs.slice(4);
+
+        if (!permsetId) {
+            console.error();
+            console.error(chalk.red('Error: 缺少权限集ID'));
+            console.error('用法: cloudcc add permission <path> <permsetId> [userId1] [userId2] ...');
+            console.error('示例:');
+            console.error('  cloudcc add permission . "cac20258F0E4ABBnTxwi"                        # 交互式选择用户');
+            console.error('  cloudcc add permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT"   # 直接指定用户ID');
+            console.error();
+            throw new Error('缺少必需参数: permsetId');
+        }
+
+        const config = await getPackageJson(projectPath);
+
+        // 如果没有指定用户ID，进入交互式选择
+        if (userIds.length === 0) {
+            console.log();
+            console.log(chalk.blue('正在获取用户列表...'));
+
+            const viewId = await getUserViewId(config);
+            const userList = await queryUserList(config, viewId);
+
+            if (userList.length === 0) {
+                console.log(chalk.yellow("没有可用的用户"));
+                return { success: false, message: "没有可用的用户" };
+            }
+
+            // 交互式选择用户
+            const choices = userList.map(user => ({
+                name: `${user.name || '未命名'} (${user.loginname || ''}) - ${user.id}`,
+                value: user.id,
+                short: user.name || user.id
+            }));
+
+            const { selectedUsers } = await inquirer.prompt([
+                {
+                    type: 'checkbox',
+                    name: 'selectedUsers',
+                    message: '请选择要分配的用户（使用空格键选择，回车确认）:',
+                    choices: choices,
+                    validate: (input) => input.length > 0 || '请至少选择一个用户'
+                }
+            ]);
+
+            userIds = selectedUsers;
+        }
+
+        if (userIds.length === 0) {
+            console.log(chalk.yellow("未选择任何用户"));
+            return { success: false, message: "未选择任何用户" };
+        }
+
+        console.log();
+        console.log(chalk.blue(`正在为权限集 ${permsetId} 分配 ${userIds.length} 个用户...`));
+
+        const res = await postClass(
+            config.setupSvc + "/api/permissionGroup/addUsersetup",
+            {
+                id: permsetId,
+                ids: userIds.join(',')
+            },
+            config.accessToken
+        );
+
+        if (res && res.result) {
+            if (!isMcp) {
+                console.log();
+                console.log(chalk.green('✓ 用户分配成功'));
+                console.log(`  权限集ID: ${permsetId}`);
+                console.log(`  分配用户数: ${userIds.length}`);
+                console.log();
+            }
+            return {
+                success: true,
+                permsetId: permsetId,
+                userCount: userIds.length,
+                userIds: userIds
+            };
+        }
+
+        const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+        throw new Error("分配用户失败: " + msg);
+
+    } catch (error) {
+        if (!isMcp) {
+            console.error(chalk.red("Error: " + error.message));
+        }
+        throw error;
+    }
+}
+
+module.exports = add;

package/src/permission/assign.js

@@ -0,0 +1,84 @@
+const chalk = require('chalk');
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 获取权限集已分配的用户列表
+ * 用法：cloudcc assign permission <projectPath> <permsetId>
+ * @param {Array} argvs - 命令行参数数组
+ * @param {boolean} isMcp - 是否为MCP模式
+ * @returns {Promise<Object>} 包含用户列表和权限集信息的对象
+ */
+async function assign(argvs, isMcp = false) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const permsetId = argvs[3];
+
+        if (!permsetId) {
+            console.error();
+            console.error(chalk.red('Error: 缺少权限集ID'));
+            console.error('用法: cloudcc assign permission <path> <permsetId>');
+            console.error('示例:');
+            console.error('  cloudcc assign permission . "cac20258F0E4ABBnTxwi"');
+            console.error();
+            throw new Error('缺少必需参数: permsetId');
+        }
+
+        const config = await getPackageJson(projectPath);
+
+        const res = await postClass(
+            config.setupSvc + "/api/permissionGroup/queryUserlistBypermsetsid",
+            { id: permsetId },
+            config.accessToken
+        );
+
+        if (res && res.result && res.data) {
+            const userList = res.data.userlist || [];
+            const permsets = res.data.permsets || {};
+            const permsetName = permsets.values?.name || permsetId;
+
+            if (!isMcp) {
+                console.log();
+                console.log(chalk.green(`权限集: ${permsetName}`));
+                console.log(chalk.green(`ID: ${permsetId}`));
+                console.log();
+
+                if (userList.length === 0) {
+                    console.log(chalk.yellow("该权限集尚未分配给任何用户"));
+                } else {
+                    console.log(chalk.green(`已分配 ${userList.length} 个用户:`));
+                    console.log();
+
+                    // 表格形式输出
+                    const idWidth = Math.max(20, ...userList.map(item => item.id?.length || 0));
+                    const nameWidth = Math.max(8, ...userList.map(item => item.name?.length || 0));
+                    const loginWidth = Math.max(20, ...userList.map(item => item.loginname?.length || 0));
+
+                    console.log(chalk.cyan(`  ${'用户ID'.padEnd(idWidth)}  ${'姓名'.padEnd(nameWidth)}  ${'登录名'.padEnd(loginWidth)}  简档              角色`));
+                    console.log(chalk.cyan(`  ${'-'.repeat(idWidth)}  ${'-'.repeat(nameWidth)}  ${'-'.repeat(loginWidth)}  ----------------  ----------------`));
+
+                    userList.forEach(item => {
+                        console.log(`  ${(item.id || '').padEnd(idWidth)}  ${(item.name || '').padEnd(nameWidth)}  ${(item.loginname || '').padEnd(loginWidth)}  ${(item.profilename || '').padEnd(16)}  ${item.rolename || ''}`);
+                    });
+                    console.log();
+                }
+            }
+
+            return {
+                userList: userList,
+                permsets: permsets
+            };
+        }
+
+        const msg = res && (res.returnInfo || res.message) ? (res.returnInfo || res.message) : "Unknown error";
+        throw new Error("获取权限集用户列表失败: " + msg);
+
+    } catch (error) {
+        if (!isMcp) {
+            console.error(chalk.red("Error: " + error.message));
+        }
+        throw error;
+    }
+}
+
+module.exports = assign;

package/src/permission/docs/devguide.md

@@ -0,0 +1,238 @@
+# CloudCC 权限集 CLI 命令说明
+
+命令格式为 **`cloudcc <动作> permission …`**（动作即下表「操作」列）。
+
+## 支持的命令
+
+| 操作 | 说明 |
+|------|------|
+| `get` | 查询权限集列表 |
+| `assign` | 查看权限集已分配的用户 |
+| `add` | 为权限集添加分配用户 |
+| `remove` | 从权限集移除分配用户 |
+
+## CLI 命令详解
+
+### 查询权限集列表
+
+```bash
+cloudcc get permission <path> [viewId] [page] [pageSize] [searchKeyWord]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `viewId` | 否 | 视图ID，不传则自动获取 |
+| `page` | 否 | 页码，默认为 1 |
+| `pageSize` | 否 | 每页数量，默认为 100000 |
+| `searchKeyWord` | 否 | 搜索关键词 |
+
+**示例：**
+
+```bash
+# 获取所有权限集列表
+cloudcc get permission .
+
+# 使用指定视图获取权限集
+cloudcc get permission . "00000000000000000000"
+
+# 搜索权限集
+cloudcc get permission . "" 1 100 "测试"
+```
+
+**输出示例：**
+
+```
+找到 17 个权限集:
+
+  ID                    名称             许可证            系统管理员
+  --------------------  ---------------  ----------------  ----------
+  aabbudgeting2024ACgL  利润云标准权限集  Budgeting         是
+  cac202530FE035CHCFGi  cloudcc222       CloudCC 用户      否
+  cac2025F039C6A5DQGrt  TestMFA22        CloudCC 用户      否
+  cac20258F0E4ABBnTxwi  古语云           CloudCC 用户      否
+  ...
+```
+
+### 查看已分配用户
+
+```bash
+cloudcc assign permission <path> <permsetId>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `permsetId` | 是 | 权限集ID |
+
+**示例：**
+
+```bash
+# 查看指定权限集的已分配用户
+cloudcc assign permission . "cac20258F0E4ABBnTxwi"
+```
+
+**输出示例：**
+
+```
+权限集: 古语云
+ID: cac20258F0E4ABBnTxwi
+
+已分配 6 个用户:
+
+  用户ID                  姓名      登录名               简档              角色
+  --------------------  --------  --------------------  ----------------  ----------------
+  00520263DB1540FTPmXK  我重新注册  421865903teet@qq.com  Cloudcc Partner 简档  青青草原艾艾合作伙伴用户
+  005202652FF2FA8dltk1  auto行    autoTest@cloudcc.com  系统管理员        测试
+  ...
+```
+
+### 添加分配用户
+
+```bash
+cloudcc add permission <path> <permsetId> [userIds...]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `permsetId` | 是 | 权限集ID |
+| `userIds` | 否 | 要分配的用户ID列表，不传则进入交互式选择 |
+
+**示例：**
+
+```bash
+# 交互式选择用户进行分配
+cloudcc add permission . "cac20258F0E4ABBnTxwi"
+
+# 直接指定单个用户ID进行分配
+cloudcc add permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT"
+
+# 直接指定多个用户ID进行分配（用空格分隔）
+cloudcc add permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT" "0052026C0A60504jNcbV"
+```
+
+**交互式选择模式：**
+
+```
+正在获取用户列表...
+
+? 请选择要分配的用户（使用空格键选择，回车确认）:
+ ❯◯ 张三 (zhangsan@example.com) - 00520260C00C6FEfsMnT
+  ◯ 李四 (lisi@example.com) - 0052026C0A60504jNcbV
+  ◯ 王五 (wangwu@example.com) - 0052026D0A60504jNcbW
+(Move up and down to reveal more choices)
+
+正在为权限集 cac20258F0E4ABBnTxwi 分配 2 个用户...
+
+✓ 用户分配成功
+  权限集ID: cac20258F0E4ABBnTxwi
+  分配用户数: 2
+```
+
+### 移除分配用户
+
+```bash
+cloudcc remove permission <path> <permsetId> [userIds...]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `permsetId` | 是 | 权限集ID |
+| `userIds` | 否 | 要移除的用户ID列表，不传则进入交互式选择 |
+
+**示例：**
+
+```bash
+# 交互式选择用户进行移除
+cloudcc remove permission . "cac20258F0E4ABBnTxwi"
+
+# 直接指定单个用户ID进行移除
+cloudcc remove permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT"
+
+# 直接指定多个用户ID进行移除（用空格分隔）
+cloudcc remove permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT" "0052026C0A60504jNcbV"
+```
+
+**交互式选择模式：**
+
+```
+正在获取已分配用户列表...
+
+? 请选择要删除的用户（使用空格键选择，回车确认）:
+ ❯◯ 张三 (zhangsan@example.com) - 00520260C00C6FEfsMnT
+  ◯ 李四 (lisi@example.com) - 0052026C0A60504jNcbV
+(Move up and down to reveal more choices)
+
+? 确定要从权限集中移除 2 个用户吗？ (y/N) y
+
+正在从权限集 cac20258F0E4ABBnTxwi 移除 2 个用户...
+
+✓ 用户移除成功
+  权限集ID: cac20258F0E4ABBnTxwi
+  移除用户数: 2
+```
+
+## 完整使用流程示例
+
+```bash
+# 1. 查看所有权限集
+cloudcc get permission .
+
+# 2. 查看某个权限集的已分配用户
+cloudcc assign permission . "cac20258F0E4ABBnTxwi"
+
+# 3. 为权限集添加用户（交互式选择）
+cloudcc add permission . "cac20258F0E4ABBnTxwi"
+
+# 4. 再次查看已分配用户，确认添加成功
+cloudcc assign permission . "cac20258F0E4ABBnTxwi"
+
+# 5. 移除某些用户（交互式选择）
+cloudcc remove permission . "cac20258F0E4ABBnTxwi"
+```
+
+## 数据字段说明
+
+### 权限集对象字段
+
+| 字段名 | 类型 | 说明 |
+|--------|------|------|
+| `id` | string | 权限集唯一标识 |
+| `name` | string | 权限集名称 |
+| `licence` | string | 许可证类型 |
+| `sysadmin` | string | 是否为系统管理员权限（"1"表示是，"0"表示否） |
+
+### 用户对象字段
+
+| 字段名 | 类型 | 说明 |
+|--------|------|------|
+| `id` | string | 用户唯一标识 |
+| `name` | string | 用户姓名 |
+| `loginname` | string | 登录名（邮箱） |
+| `profilename` | string | 简档名称 |
+| `profileid` | string | 简档ID |
+| `rolename` | string | 角色名称 |
+| `roleid` | string | 角色ID |
+| `alias` | string | 别名 |
+
+## 相关 API 接口
+
+| 接口 | 说明 |
+|------|------|
+| `POST /api/permissionGroup/queryPermsetsList` | 获取权限集视图列表 |
+| `POST /api/permissionGroup/listAJAX` | 查询权限集列表 |
+| `POST /api/permissionGroup/queryUserlistBypermsetsid` | 查询权限集已分配用户 |
+| `POST /api/permissionGroup/addUsersetup` | 为权限集添加用户 |
+| `POST /api/permissionGroup/deleteUsersetup` | 从权限集移除用户 |
+| `POST /api/usermange/queryUser` | 获取用户视图 |
+| `POST /api/usermange/queryUserList` | 查询用户列表 |