cloudcc-cli 2.3.3 → 2.3.5

package/src/permission/get.js

@@ -0,0 +1,107 @@
+const chalk = require('chalk');
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 获取权限集视图ID
+ * @param {Object} config - 项目配置
+ * @returns {Promise<string>} 视图ID
+ */
+async function getPermsetViewId(config) {
+    const res = await postClass(
+        config.setupSvc + "/api/permissionGroup/queryPermsetsList",
+        {},
+        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("未找到权限集视图");
+}
+
+/**
+ * 获取权限集列表
+ * 用法：cc get permission <projectPath> [viewId] [page] [pageSize] [searchKeyWord]
+ * @param {Array} argvs - 命令行参数数组
+ * @param {boolean} isMcp - 是否为MCP模式
+ * @returns {Promise<Array>} 权限集列表
+ */
+async function get(argvs, isMcp = false) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const viewId = argvs[3] || '';
+        const page = parseInt(argvs[4]) || 1;
+        const pageSize = parseInt(argvs[5]) || 100000;
+        const searchKeyWord = argvs[6] || '';
+
+        const config = await getPackageJson(projectPath);
+
+        // 如果没有指定 viewId，先获取视图ID
+        let finalViewId = viewId;
+        if (!finalViewId) {
+            try {
+                finalViewId = await getPermsetViewId(config);
+            } catch (error) {
+                console.error(chalk.yellow("Warning: " + error.message));
+                throw error;
+            }
+        }
+
+        const res = await postClass(
+            config.setupSvc + "/api/permissionGroup/listAJAX",
+            {
+                viewId: finalViewId,
+                page: page,
+                pageSize: pageSize,
+                searchKeyWord: searchKeyWord
+            },
+            config.accessToken
+        );
+
+        if (res && res.result && res.data) {
+            const list = res.data.list || [];
+
+            if (!isMcp) {
+                if (list.length === 0) {
+                    console.log(chalk.yellow("未找到权限集"));
+                } else {
+                    console.log(chalk.green(`找到 ${list.length} 个权限集:`));
+                    console.log();
+                    // 表格形式输出
+                    const idWidth = Math.max(20, ...list.map(item => item.id?.length || 0));
+                    const nameWidth = Math.max(15, ...list.map(item => item.name?.length || 0));
+
+                    console.log(chalk.cyan(`  ${'ID'.padEnd(idWidth)}  ${'名称'.padEnd(nameWidth)}  许可证           系统管理员`));
+                    console.log(chalk.cyan(`  ${'-'.repeat(idWidth)}  ${'-'.repeat(nameWidth)}  ----------------  ----------`));
+
+                    list.forEach(item => {
+                        const sysAdminStr = item.sysadmin === '1' ? '是' : '否';
+                        console.log(`  ${(item.id || '').padEnd(idWidth)}  ${(item.name || '').padEnd(nameWidth)}  ${(item.licence || '').padEnd(16)}  ${sysAdminStr}`);
+                    });
+                    console.log();
+                }
+            }
+            return list;
+        }
+
+        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 = get;

package/src/permission/index.js

@@ -0,0 +1,10 @@
+const cc = {}
+cc.get = require("./get")
+cc.assign = require("./assign")
+cc.add = require("./add")
+cc.remove = require("./remove")
+async function main(action, argvs) {
+  await cc[action](argvs)
+}
+
+module.exports = main;

package/src/permission/remove.js

@@ -0,0 +1,145 @@
+const chalk = require('chalk');
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const inquirer = require('inquirer');
+
+/**
+ * 获取权限集已分配的用户列表
+ * @param {Object} config - 项目配置
+ * @param {string} permsetId - 权限集ID
+ * @returns {Promise<Array>} 已分配用户列表
+ */
+async function getAssignedUsers(config, permsetId) {
+    const res = await postClass(
+        config.setupSvc + "/api/permissionGroup/queryUserlistBypermsetsid",
+        { id: permsetId },
+        config.accessToken
+    );
+
+    if (res && res.result && res.data) {
+        return res.data.userlist || [];
+    }
+
+    throw new Error("获取已分配用户列表失败");
+}
+
+/**
+ * 删除权限集分配用户
+ * 用法：cc remove permission <projectPath> <permsetId> [userIds...]
+ * 如果不指定 userIds，会进入交互式选择
+ * @param {Array} argvs - 命令行参数数组
+ * @param {boolean} isMcp - 是否为MCP模式
+ * @returns {Promise<Object>} 删除结果
+ */
+async function remove(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 remove permission <path> <permsetId> [userId1] [userId2] ...');
+            console.error('示例:');
+            console.error('  cc remove permission . "cac20258F0E4ABBnTxwi"                        # 交互式选择用户');
+            console.error('  cc remove 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 userList = await getAssignedUsers(config, permsetId);
+
+            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: "未选择任何用户" };
+        }
+
+        // 确认删除
+        const { confirm } = await inquirer.prompt([
+            {
+                type: 'confirm',
+                name: 'confirm',
+                message: `确定要从权限集中移除 ${userIds.length} 个用户吗？`,
+                default: false
+            }
+        ]);
+
+        if (!confirm) {
+            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/deleteUsersetup",
+            {
+                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 = remove;

package/src/project/docs/devguide.md

@@ -18,7 +18,7 @@
   1. 安装 Node 与 npm，并切换 npm 源
   2. 安装 `cloudcc-cli` 全局依赖
   3. 安装 VS Code 与 CloudCC 插件
-  4. 配置本地 MCP（`cc-mcp`）
+  4. 配置本地 MCP（`node` 运行 `bin/mcp.js`）
   5. 使用 CLI 创建模板项目并安装依赖
   6. 通过 CRM 获取开发者密钥、安全标记并写入 `cloudcc-cli.config.js`
   7. 视情况配置私有云与多环境参数
@@ -109,15 +109,16 @@ sudo npm ls -g --depth=0
 
 ---
 
-## 5. 安装并配置本地 MCP（cc-mcp）
+## 5. 安装并配置本地 MCP
 
-在支持 MCP 的开发工具中（如 Cursor），需要在 MCP 配置文件中添加：
+在支持 MCP 的开发工具中（如 Cursor），需要在 MCP 配置文件中添加（使用 `node` 启动包内脚本，**将 `args` 中的路径换成本机全局安装后的绝对路径**）：
 
 ```json
 {
     "mcpServers": {
         "cloudcc-cli": {
-            "command": "cc-mcp"
+            "command": "node",
+            "args": ["<npm-global>/cloudcc-cli/bin/mcp.js"]
         }
     }
 }
@@ -126,7 +127,7 @@ sudo npm ls -g --depth=0
 说明：
 
 - `cloudcc-cli`：MCP 服务器标识，用于在工具中调用 CloudCC 相关能力
-- `command: "cc-mcp"`：实际执行的命令，通常由 `cloudcc-cli` 提供
+- `command` / `args`：通过 Node 执行 `cloudcc-cli` 包内的 `bin/mcp.js`（全局安装后路径一般为 `$(npm root -g)/cloudcc-cli/bin/mcp.js`，请粘贴为绝对路径）
 
 ---
 
@@ -351,7 +352,7 @@ module.exports = {
 - [ ] npm 源已切换到 `https://registry.npmmirror.com`
 - [ ] 已全局安装 `cloudcc-cli` 并验证
 - [ ] 已安装 VS Code 与 CloudCC 插件（或已按官方指引配置 Cursor）
-- [ ] MCP 已配置 `cloudcc-cli → cc-mcp`
+- [ ] MCP 已配置 `cloudcc-cli`（`node` + `bin/mcp.js`）
 - [ ] 已通过 `cc create project` 创建模板项目并成功 `npm i` + `npm run serve`
 - [ ] 已创建开发者账号并确认「代码管理」权限开启
 - [ ] 已获取开发者密钥与安全标记并正确配置 `cloudcc-cli.config.js`

package/src/role/create.js

@@ -2,6 +2,7 @@ const chalk = require('chalk');
 const inquirer = require('inquirer');
 const { postClass } = require("../../utils/http");
 const { getPackageJson } = require("../../utils/config");
+const { id } = require('zod/locales');
 
 /**
  * 创建角色
@@ -49,7 +50,7 @@ async function create(argvs) {
         console.error(chalk.blue('Step 1: 获取直属上司列表...'));
         const addRoleRes = await postClass(
             config.setupSvc + "/api/role/addRole",
-            { id: "bab2025F8B20EE4d4005" },
+            { id: config.orgId },
             config.accessToken
         );
 

package/src/role/delete.js

@@ -40,6 +40,7 @@ async function remove(argvs) {
         if (result && result.result) {
             console.error();
             console.error(chalk.green("Success! Role deleted."));
+            console.error(chalk.blue("返回结果:"), JSON.stringify(result, null, 2));
             console.error();
             return result;
         }

package/src/singleSignOn/delete.js

@@ -0,0 +1,61 @@
+const chalk = require("chalk");
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+
+/**
+ * 删除单点登录记录
+ * 接口: /spconfig/delete
+ * 用法：cc delete singleSignOn <projectPath> <id>
+ */
+async function remove(argvs) {
+    try {
+        const projectPath = argvs[2] || process.cwd();
+        const id = argvs[3];
+
+        if (!id) {
+            console.error();
+            console.error(chalk.red("Error: 缺少单点登录记录 id"));
+            console.error(chalk.yellow("用法: cc delete singleSignOn <projectPath> <id>"));
+            console.error(chalk.yellow("示例: cc delete singleSignOn . 20246DB16F11EDF4KHWd"));
+            console.error();
+            throw new Error("缺少必需参数: id");
+        }
+
+        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 single sign on record (${id}), please wait...`));
+        console.error();
+
+        const result = await postClass(
+            config.setupSvc + "/api/spconfig/delete",
+            { id: id },
+            config.accessToken
+        );
+
+        if (result && result.result) {
+            console.error();
+            console.error(chalk.green("Success! Single sign on record 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 SingleSignOn Failed: " + msg);
+    } catch (error) {
+        console.error();
+        console.error(chalk.red("单点登录记录删除失败:"), error);
+        throw error;
+    }
+}
+
+module.exports = remove;

package/src/singleSignOn/doc.js

@@ -0,0 +1,46 @@
+/**
+ * singleSignOn 文档入口：正文均在 `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 singleSignOn <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 singleSignOn 需要子命令：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/singleSignOn/docs/devguide.md

@@ -0,0 +1,61 @@
+# CloudCC 单点登录 CLI 命令说明
+
+## 支持的命令
+
+| 操作 | 说明 |
+|------|------|
+| `get` | 查询单点登录配置列表 |
+| `delete` | 删除单点登录记录 |
+
+## CLI 命令详解
+
+### 查询单点登录配置列表
+
+```bash
+cc get singleSignOn <projectPath> [encodedCondJson]
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `encodedCondJson` | 否 | URI 编码后的查询条件 JSON |
+
+**查询条件参数：**
+
+| 参数名 | 类型 | 说明 |
+|--------|------|------|
+| `start` | number | 起始位置，默认 0 |
+| `limit` | number | 每页条数，默认 30 |
+| `keyword` | string | 搜索关键词 |
+
+**示例：**
+
+```bash
+# 获取所有单点登录配置
+cc get singleSignOn .
+
+# 带查询条件（搜索关键词）
+cc get singleSignOn . '%7B%22keyword%22%3A%22test%22%2C%22limit%22%3A50%7D'
+```
+
+### 删除单点登录记录
+
+```bash
+cc delete singleSignOn <projectPath> <id>
+```
+
+**参数说明：**
+
+| 参数 | 必填 | 说明 |
+|------|------|------|
+| `projectPath` | 否 | 项目路径，默认当前目录 |
+| `id` | 是 | 单点登录记录 id（从列表接口获取）|
+
+**示例：**
+
+```bash
+# 删除单点登录记录
+cc delete singleSignOn . 20246DB16F11EDF4KHWd
+```

package/src/singleSignOn/docs/introduction.md

@@ -0,0 +1,3 @@
+# CloudCC 单点登录（SingleSignOn）
+
+单点登录（SSO）设置用于管理 CloudCC 平台中的服务提供商（SP）配置，支持查看和删除 SP 配置记录。

package/src/singleSignOn/get.js

@@ -0,0 +1,70 @@
+const { postClass } = require("../../utils/http");
+const { getPackageJson } = require("../../utils/config");
+const chalk = require("chalk");
+
+/**
+ * 查询单点登录配置列表
+ * 接口: /spconfig/list
+ * 用法：cc get singleSignOn <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 SingleSignOn Failed: encodedCondJson 解析失败，请传 encodeURI(JSON.stringify(...))");
+            }
+        }
+    }
+
+    const config = await getPackageJson(projectPath);
+
+    const res = await postClass(
+        config.setupSvc + "/api/spconfig/list",
+        {
+            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 SingleSignOn Failed: " + msg);
+}
+
+module.exports = get;

package/src/singleSignOn/index.js

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

package/src/staticResource/docs/introduction.md

@@ -1,3 +1,46 @@
 # CloudCC 静态资源介绍
 
-TODO
+## 1. 模块定位
+
+静态资源用于统一托管前端开发中需要复用的文件资源（如图片、字体、JS/CSS 文件、压缩包等）。
+当资源不适合直接内嵌在代码中时，可上传到静态资源库，再通过平台提供的访问链接在组件、页面、脚本中引用。
+
+## 2. 典型使用场景
+
+- 自定义组件引用公共图片、图标、字体文件
+- 自定义页面加载第三方前端库（如工具函数、样式文件）
+- 多个业务功能共享同一份资源，避免重复上传与多处维护
+
+## 3. 控制台入口
+
+1. 登录 CloudCC 系统
+2. 点击右上角头像，进入「开发者平台」（当前仅管理员简档可见）
+3. 在左侧菜单进入：`扩展 -> 静态资源`
+
+## 4. 核心操作流程
+
+### 4.1 新建静态资源
+
+1. 点击「新建」
+2. 填写必要信息（名称/标签、描述等）
+3. 上传资源文件并保存
+
+### 4.2 获取访问链接并应用
+
+1. 在资源列表中找到目标资源
+2. 点击复制图标获取资源访问链接
+3. 在组件/页面/脚本中使用该链接
+
+## 5. 关键约束与注意事项
+
+- 单个上传文件大小上限为 `5MB`
+- 建议使用可读性强、可维护的命名规范，便于检索和复用
+- 发布前应验证访问链接可用性，避免页面出现 404 或加载失败
+- 建议在团队内约定资源分类（如 `img/`、`font/`、`vendor/`）与版本策略
+
+## 6. 设计建议（面向实施）
+
+- **先复用后新增**：优先检查资源库中是否已有同类资源，减少冗余
+- **按用途分层管理**：将业务资源与公共资源分开，降低变更影响
+- **关注性能**：对图片进行压缩，避免引入过大的静态文件影响加载速度
+- **建立变更记录**：重大资源替换建议记录版本和影响范围，便于回滚与排查