cloudcc-cli 2.3.3 → 2.3.5

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("查询用户列表失败");
+}
+
+/**
+ * 添加权限集分配用户
+ * 用法：cc 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('用法: cc add permission <path> <permsetId> [userId1] [userId2] ...');
+            console.error('示例:');
+            console.error('  cc add permission . "cac20258F0E4ABBnTxwi"                        # 交互式选择用户');
+            console.error('  cc 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");
+
+/**
+ * 获取权限集已分配的用户列表
+ * 用法：cc 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('用法: cc assign permission <path> <permsetId>');
+            console.error('示例:');
+            console.error('  cc 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 命令说明
+
+命令格式为 **`cc <动作> permission …`**（动作即下表「操作」列）。
+
+## 支持的命令
+
+| 操作 | 说明 |
+|------|------|
+| `get` | 查询权限集列表 |
+| `assign` | 查看权限集已分配的用户 |
+| `add` | 为权限集添加分配用户 |
+| `remove` | 从权限集移除分配用户 |
+
+## CLI 命令详解
+
+### 查询权限集列表
+
+```bash
+cc get permission <path> [viewId] [page] [pageSize] [searchKeyWord]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `viewId` | 否 | 视图ID，不传则自动获取 |
+| `page` | 否 | 页码，默认为 1 |
+| `pageSize` | 否 | 每页数量，默认为 100000 |
+| `searchKeyWord` | 否 | 搜索关键词 |
+
+**示例：**
+
+```bash
+# 获取所有权限集列表
+cc get permission .
+
+# 使用指定视图获取权限集
+cc get permission . "00000000000000000000"
+
+# 搜索权限集
+cc get permission . "" 1 100 "测试"
+```
+
+**输出示例：**
+
+```
+找到 17 个权限集:
+
+  ID                    名称             许可证            系统管理员
+  --------------------  ---------------  ----------------  ----------
+  aabbudgeting2024ACgL  利润云标准权限集  Budgeting         是
+  cac202530FE035CHCFGi  cloudcc222       CloudCC 用户      否
+  cac2025F039C6A5DQGrt  TestMFA22        CloudCC 用户      否
+  cac20258F0E4ABBnTxwi  古语云           CloudCC 用户      否
+  ...
+```
+
+### 查看已分配用户
+
+```bash
+cc assign permission <path> <permsetId>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `permsetId` | 是 | 权限集ID |
+
+**示例：**
+
+```bash
+# 查看指定权限集的已分配用户
+cc assign permission . "cac20258F0E4ABBnTxwi"
+```
+
+**输出示例：**
+
+```
+权限集: 古语云
+ID: cac20258F0E4ABBnTxwi
+
+已分配 6 个用户:
+
+  用户ID                  姓名      登录名               简档              角色
+  --------------------  --------  --------------------  ----------------  ----------------
+  00520263DB1540FTPmXK  我重新注册  421865903teet@qq.com  Cloudcc Partner 简档  青青草原艾艾合作伙伴用户
+  005202652FF2FA8dltk1  auto行    autoTest@cloudcc.com  系统管理员        测试
+  ...
+```
+
+### 添加分配用户
+
+```bash
+cc add permission <path> <permsetId> [userIds...]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `permsetId` | 是 | 权限集ID |
+| `userIds` | 否 | 要分配的用户ID列表，不传则进入交互式选择 |
+
+**示例：**
+
+```bash
+# 交互式选择用户进行分配
+cc add permission . "cac20258F0E4ABBnTxwi"
+
+# 直接指定单个用户ID进行分配
+cc add permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT"
+
+# 直接指定多个用户ID进行分配（用空格分隔）
+cc 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
+cc remove permission <path> <permsetId> [userIds...]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `path` | 否 | 项目路径，`.` 表示当前目录，默认为当前目录 |
+| `permsetId` | 是 | 权限集ID |
+| `userIds` | 否 | 要移除的用户ID列表，不传则进入交互式选择 |
+
+**示例：**
+
+```bash
+# 交互式选择用户进行移除
+cc remove permission . "cac20258F0E4ABBnTxwi"
+
+# 直接指定单个用户ID进行移除
+cc remove permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT"
+
+# 直接指定多个用户ID进行移除（用空格分隔）
+cc 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. 查看所有权限集
+cc get permission .
+
+# 2. 查看某个权限集的已分配用户
+cc assign permission . "cac20258F0E4ABBnTxwi"
+
+# 3. 为权限集添加用户（交互式选择）
+cc add permission . "cac20258F0E4ABBnTxwi"
+
+# 4. 再次查看已分配用户，确认添加成功
+cc assign permission . "cac20258F0E4ABBnTxwi"
+
+# 5. 移除某些用户（交互式选择）
+cc 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` | 查询用户列表 |

package/src/permission/docs/introduction.md

@@ -0,0 +1,200 @@
+# Permission（权限集管理）
+
+Permission 模块用于管理 CloudCC 权限集的分配功能，包括查看权限集列表、查看已分配用户、添加分配用户和删除分配用户。
+
+## 功能介绍
+
+- **查看权限集列表**: 获取系统中的所有权限集
+- **查看已分配用户**: 查看指定权限集已分配的用户列表
+- **添加分配用户**: 为指定权限集分配用户
+- **删除分配用户**: 从指定权限集中移除用户
+
+## 命令
+
+命令统一为 **`cc <动作> <资源> …`**；本模块资源名为 **`permission`**。
+
+### 获取权限集列表
+
+```bash
+cc get permission <path> [viewId] [page] [pageSize] [searchKeyWord]
+```
+
+**参数说明：**
+- `path` - 项目路径（可选，默认为当前目录）
+- `viewId` - 视图ID（可选，不传则自动获取）
+- `page` - 页码（可选，默认为1）
+- `pageSize` - 每页数量（可选，默认为100000）
+- `searchKeyWord` - 搜索关键词（可选）
+
+**示例：**
+
+```bash
+# 获取所有权限集列表
+cc get permission .
+
+# 使用指定视图获取权限集
+cc get permission . "00000000000000000000"
+
+# 搜索权限集
+cc get permission . "" 1 100 "测试"
+```
+
+### 查看已分配用户
+
+```bash
+cc assign permission <path> <permsetId>
+```
+
+**参数说明：**
+- `path` - 项目路径（可选，默认为当前目录）
+- `permsetId` - 权限集ID（必需）
+
+**示例：**
+
+```bash
+# 查看指定权限集的已分配用户
+cc assign permission . "cac20258F0E4ABBnTxwi"
+```
+
+**输出示例：**
+
+```
+权限集: 古语云
+ID: cac20258F0E4ABBnTxwi
+
+已分配 6 个用户:
+
+  用户ID                  姓名      登录名               简档              角色
+  --------------------  --------  --------------------  ----------------  ----------------
+  00520263DB1540FTPmXK  我重新注册  421865903teet@qq.com  Cloudcc Partner 简档  青青草原艾艾合作伙伴用户
+  005202652FF2FA8dltk1  auto行    autoTest@cloudcc.com  系统管理员        测试
+  ...
+```
+
+### 添加分配用户
+
+```bash
+cc add permission <path> <permsetId> [userIds...]
+```
+
+**参数说明：**
+- `path` - 项目路径（可选，默认为当前目录）
+- `permsetId` - 权限集ID（必需）
+- `userIds` - 要分配的用户ID列表（可选，不传则进入交互式选择）
+
+**示例：**
+
+```bash
+# 交互式选择用户进行分配
+cc add permission . "cac20258F0E4ABBnTxwi"
+
+# 直接指定用户ID进行分配（多个用户用空格分隔）
+cc add permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT" "0052026C0A60504jNcbV"
+```
+
+**交互式选择模式：**
+
+如果不指定 userIds，命令会进入交互式选择模式，展示所有可用用户供选择：
+
+```
+? 请选择要分配的用户（使用空格键选择，回车确认）: (Press <space> to select, <a> to toggle all, <i> to invert selection)
+ ❯◯ 张三 (zhangsan@example.com) - 00520260C00C6FEfsMnT
+  ◯ 李四 (lisi@example.com) - 0052026C0A60504jNcbV
+  ◯ 王五 (wangwu@example.com) - 0052026D0A60504jNcbW
+```
+
+### 删除分配用户
+
+```bash
+cc remove permission <path> <permsetId> [userIds...]
+```
+
+**参数说明：**
+- `path` - 项目路径（可选，默认为当前目录）
+- `permsetId` - 权限集ID（必需）
+- `userIds` - 要移除的用户ID列表（可选，不传则进入交互式选择）
+
+**示例：**
+
+```bash
+# 交互式选择用户进行移除
+cc remove permission . "cac20258F0E4ABBnTxwi"
+
+# 直接指定用户ID进行移除（多个用户用空格分隔）
+cc remove permission . "cac20258F0E4ABBnTxwi" "00520260C00C6FEfsMnT" "0052026C0A60504jNcbV"
+```
+
+**交互式选择模式：**
+
+如果不指定 userIds，命令会进入交互式选择模式，展示当前已分配的用户供选择：
+
+```
+? 请选择要删除的用户（使用空格键选择，回车确认）: (Press <space> to select, <a> to toggle all, <i> to invert selection)
+ ❯◯ 张三 (zhangsan@example.com) - 00520260C00C6FEfsMnT
+  ◯ 李四 (lisi@example.com) - 0052026C0A60504jNcbV
+
+? 确定要从权限集中移除 2 个用户吗？ (y/N)
+```
+
+## 完整使用流程示例
+
+```bash
+# 1. 查看所有权限集
+cc get permission .
+
+# 2. 查看某个权限集的已分配用户
+cc assign permission . "cac20258F0E4ABBnTxwi"
+
+# 3. 为权限集添加用户（交互式选择）
+cc add permission . "cac20258F0E4ABBnTxwi"
+
+# 4. 再次查看已分配用户，确认添加成功
+cc assign permission . "cac20258F0E4ABBnTxwi"
+
+# 5. 移除某些用户（交互式选择）
+cc remove permission . "cac20258F0E4ABBnTxwi"
+```
+
+## 数据结构
+
+### 权限集对象
+
+```json
+{
+    "name": "古语云",
+    "licence": "CloudCC 用户",
+    "id": "cac20258F0E4ABBnTxwi",
+    "sysadmin": "0"
+}
+```
+
+**字段说明：**
+- `name` - 权限集名称
+- `licence` - 许可证类型
+- `id` - 权限集唯一标识
+- `sysadmin` - 是否为系统管理员权限（"1"表示是，"0"表示否）
+
+### 用户对象
+
+```json
+{
+    "loginname": "421865903teet@qq.com",
+    "profileid": "aaa000002",
+    "rolename": "青青草原艾艾合作伙伴用户",
+    "roleid": "2026A3D78466C42UokMO",
+    "profilename": "Cloudcc Partner 简档",
+    "name": "我重新注册",
+    "alias": null,
+    "id": "00520263DB1540FTPmXK"
+}
+```
+
+**字段说明：**
+- `id` - 用户唯一标识
+- `name` - 用户姓名
+- `loginname` - 登录名（邮箱）
+- `profilename` - 简档名称
+- `profileid` - 简档ID
+- `rolename` - 角色名称
+- `roleid` - 角色ID
+- `alias` - 别名