cloudcc-cli 2.3.4 → 2.3.5

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/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. 设计建议（面向实施）
+
+- **先复用后新增**：优先检查资源库中是否已有同类资源，减少冗余
+- **按用途分层管理**：将业务资源与公共资源分开，降低变更影响
+- **关注性能**：对图片进行压缩，避免引入过大的静态文件影响加载速度
+- **建立变更记录**：重大资源替换建议记录版本和影响范围，便于回滚与排查

package/src/validationRule/create.js

@@ -121,12 +121,12 @@ async function create(argvs) {
         };
 
         const saveRes = await postClass(
-            config.setupSvc + "/api/validateRule/validateFunction",
+            config.setupSvc + "/api/validateRule/save",
             validateData,
             config.accessToken
         );
 
-        if (saveRes && saveRes.result) {
+        if (saveRes && (saveRes.result === true || saveRes.result === "true" || saveRes.returnCode === "1")) {
             console.error();
             console.error(chalk.green('Success! Validation rule created.'));
             console.error(`  规则名称: ${ruleName}`);

package/src/version/actionHelp.js

@@ -0,0 +1,25 @@
+const chalk = require("chalk")
+const { getResourcesForAction } = require("./listModuleCommands")
+
+function actionHelp(argvs) {
+  const action = argvs[0]
+  const list = getResourcesForAction(action)
+  console.error()
+  if (list.length === 0) {
+    console.error(chalk.yellow(`没有 resource 支持 action「${action}」。`))
+    console.error(chalk.gray("运行 ") + chalk.green("cc --help") + chalk.gray(" 查看全部命令。"))
+    console.error()
+    return
+  }
+  console.error(chalk.bold.cyan(`cc ${action}`) + chalk.gray(" <resource> [args...]"))
+  console.error()
+  console.error(chalk.yellow("可用的 resource："))
+  for (const r of list) {
+    console.error("  " + chalk.green(r))
+  }
+  console.error()
+  console.error(chalk.gray("示例：") + chalk.green(`cc ${action} ${list[0]}`) + chalk.gray(" <后续参数见各模块文档>"))
+  console.error()
+}
+
+module.exports = actionHelp

package/src/version/docs.js

@@ -0,0 +1,26 @@
+const { spawn } = require("child_process")
+const chalk = require("chalk")
+
+const HELP_CENTER = "https://help.cloudcc.cn/"
+
+function docs() {
+  const url = HELP_CENTER
+  try {
+    if (process.platform === "win32") {
+      spawn("cmd", ["/c", "start", "", url], { detached: true, stdio: "ignore" }).unref()
+    } else if (process.platform === "darwin") {
+      spawn("open", [url], { detached: true, stdio: "ignore" }).unref()
+    } else {
+      spawn("xdg-open", [url], { detached: true, stdio: "ignore" }).unref()
+    }
+    console.error()
+    console.error(chalk.green("已在浏览器打开：") + chalk.cyan(url))
+    console.error()
+  } catch (e) {
+    console.error()
+    console.error(chalk.yellow("无法自动打开浏览器，请手动访问："), chalk.cyan(url))
+    console.error()
+  }
+}
+
+module.exports = docs

package/src/version/doctor.js

@@ -0,0 +1,25 @@
+const fs = require("fs")
+const path = require("path")
+const chalk = require("chalk")
+const pkg = require("../../package.json")
+
+function doctor() {
+  console.error()
+  console.error(chalk.bold.cyan("cc doctor") + chalk.gray(" — 环境自检"))
+  console.error()
+  console.error(chalk.green("✓") + " Node " + process.version)
+  console.error(chalk.green("✓") + " cloudcc-cli v" + pkg.version)
+
+  const cwd = process.cwd()
+  const configPath = path.join(cwd, "cloudcc-cli.config.js")
+  if (fs.existsSync(configPath)) {
+    console.error(chalk.green("✓") + " 当前目录存在 cloudcc-cli.config.js")
+  } else {
+    console.error(
+      chalk.yellow("○") + " 当前目录未找到 cloudcc-cli.config.js（若在本目录开发 CloudCC 项目，请先初始化或放入配置）"
+    )
+  }
+  console.error()
+}
+
+module.exports = doctor

package/src/version/get.js

@@ -1,9 +1,15 @@
 const chalk = require("chalk")
 const pkg = require("../../package.json")
+const { getReleaseForExact, defaultReadmePath } = require("../../utils/readmeReleases")
+const { printReleaseNotesBlocks } = require("../../utils/formatReleaseNotes")
 
 function get() {
     console.error()
-    console.error(chalk.green(`cloudcc-cli version: ${pkg.version}`));
+    console.error(chalk.green(`cloudcc-cli version: ${pkg.version}`))
+    const rel = getReleaseForExact(defaultReadmePath(), pkg.version)
+    if (rel) {
+        printReleaseNotesBlocks([rel], console.error)
+    }
     console.error()
 }
 

package/src/version/help.js

@@ -0,0 +1,47 @@
+const chalk = require("chalk")
+const pkg = require("../../package.json")
+const { getModuleGroups, describeActionLine } = require("./listModuleCommands")
+
+function help() {
+  console.error()
+  console.error(chalk.bold.cyan("cloudcc-cli (cc)") + chalk.gray(` v${pkg.version}`))
+  console.error()
+  console.error(chalk.yellow("Usage:"))
+  console.error("  " + chalk.green("cc") + " <action> <resource> [args...]")
+  console.error()
+  console.error(chalk.yellow("Global:"))
+  console.error("  " + chalk.green("cc --help") + ", " + chalk.green("-h") + ", " + chalk.green("cc help") + "  显示本帮助")
+  console.error("  " + chalk.green("cc --version") + ", " + chalk.green("-v") + "  打印版本号")
+  console.error("  " + chalk.green("cc update") + "              升级全局 cloudcc-cli")
+  console.error("  " + chalk.green("cc uninstall") + "           卸载全局 cloudcc-cli")
+  console.error("  " + chalk.green("cc doctor") + "              环境自检（Node、配置、CLI 版本）")
+  console.error("  " + chalk.green("cc docs") + "               在浏览器打开 CloudCC 帮助中心")
+  console.error("  " + chalk.green("cc stats") + "              查看本地命令调用统计（默认开启，" + chalk.gray("CLOUDCC_CLI_STATS=0") + " 可关闭）")
+  console.error("  " + chalk.green("cc init") + " [项目名]      等同于 cc create project")
+  console.error("  " + chalk.green("cc <action> -h") + "        查看该 action 下可用的 resource")
+  console.error()
+  console.error(chalk.yellow("模块 (resource)"))
+  console.error()
+
+  const groups = getModuleGroups()
+  for (const { resources, actions } of groups) {
+    const title = resources.join(" / ")
+    console.error(chalk.bold.white("  " + title))
+    const ex = resources[0]
+    for (const a of actions) {
+      const cmd = "cc " + a + " " + ex
+      const note = describeActionLine(ex, a)
+      console.error("    " + chalk.green(cmd) + "  " + chalk.gray(note))
+    }
+    console.error()
+  }
+
+  console.error(chalk.yellow("Examples:"))
+  console.error("  " + chalk.gray("cc doc object introduction"))
+  console.error("  " + chalk.gray("cc get object Account"))
+  console.error()
+  console.error(chalk.gray("Developer docs: https://help.cloudcc.cn/"))
+  console.error()
+}
+
+module.exports = help

package/src/version/index.js

@@ -1,8 +1,15 @@
 const cc = {}
 cc.get = require("./get")
+cc.help = require("./help")
+cc.update = require("./update")
+cc.uninstall = require("./uninstall")
 
 function Version(action, argvs) {
-  cc[action](argvs)
+  const fn = cc[action]
+  if (!fn) {
+    throw new Error(`version: unsupported action ${action}`)
+  }
+  return Promise.resolve(fn(argvs))
 }
 
-module.exports = Version;
+module.exports = Version