cloudcc-cli 2.3.1 → 2.3.3

package/src/staticResource/count.js

@@ -1,25 +1,46 @@
 const { getPackageJson } = require("../../utils/config");
-const { postClass } = require("../../utils/http");
+const BaseUrl = "https://developer.apis.cloudcc.cn";
 
+/**
+ * 静态资源 - 容量统计
+ * CLI: cc count staticResource <projectPath> [encodedCondJson]
+ * 参数说明：
+ * - projectPath: 项目根目录，默认 process.cwd()
+ * - encodedCondJson(可选): encodeURI(JSON.stringify(body))
+ * - body: 统计条件对象（可为空 {}）
+ * 请求头说明：
+ * - accessToken: 从 cloudcc-cli.config.js 读取
+ * - source: 默认 cloudcc_cli
+ */
 async function count(projectPath = process.cwd(), encodedCondJson, isMcp = false) {
     let body = {};
     if (encodedCondJson) {
         body = JSON.parse(decodeURI(encodedCondJson));
     }
     const config = await getPackageJson(projectPath);
-    const res = await postClass(
-        config.setupSvc + "/api/staticResource/countStaticResource",
-        body,
-        config.accessToken
+    const devSvcDispatch = config.devSvcDispatch || "/devconsole";
+    const baseUrl = config.baseUrl || BaseUrl;
+    const res = await fetch(
+        `${baseUrl}${devSvcDispatch}/staticResource/countStaticResource`,
+        {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json; charset=utf-8",
+                accessToken: config.accessToken,
+                source: config.source || "cloudcc_cli",
+            },
+            body: JSON.stringify(body),
+        }
     );
-    if (res && res.result) {
-        const data = res.data || {};
+    const data = await res.json();
+    if (data && (data.result || String(data.returnCode) === "200" || String(data.returnCode).endsWith("-OK"))) {
+        const countData = data.data || {};
         if (!isMcp) {
-            console.log(JSON.stringify(data));
+            console.log(JSON.stringify(countData));
         }
-        return data;
+        return countData;
     }
-    throw new Error("Count Static Resource Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+    throw new Error("Count Static Resource Failed: " + (data?.returnInfo || data?.message || "Unknown error"));
 }
 
 module.exports = count;

package/src/staticResource/create.js

@@ -0,0 +1,97 @@
+/**
+ * 静态资源 - 新建/编辑（上传）
+ * CLI: cc create staticResource <projectPath> <encodedBodyJson>
+ * 参数说明：
+ * - projectPath: 项目根目录
+ * - encodedBodyJson: encodeURI(JSON.stringify(body))
+ * - body:
+ *   {
+ *     filePath?: string,   // 新建必填；编辑不换文件可不传
+ *     label: string,       // 必填
+ *     desc?: string,       // 可选
+ *     id?: string,         // 编辑时传
+ *     name?: string,       // 可选，不传默认取文件名
+ *     type?: string        // 可选，不传默认取文件后缀
+ *   }
+ */
+const fs = require("fs");
+const path = require("path");
+const chalk = require("chalk");
+const { getPackageJson } = require("../../utils/config");
+
+const BaseUrl = "https://developer.apis.cloudcc.cn";
+
+async function create(projectPath = process.cwd(), encodedBodyJson) {
+    if (!encodedBodyJson) {
+        throw new Error("Create Static Resource Failed: encodedBodyJson is required");
+    }
+
+    const body = JSON.parse(decodeURI(encodedBodyJson));
+    const { filePath, label, desc = "", id = "", name, type } = body || {};
+
+    if (!label) {
+        throw new Error("Create Static Resource Failed: label is required");
+    }
+
+    const config = await getPackageJson(projectPath);
+    if (!config || !config.accessToken) {
+        throw new Error("Create Static Resource Failed: accessToken is missing");
+    }
+
+    const devSvcDispatch = config.devSvcDispatch || "/devconsole";
+    const baseUrl = config.baseUrl || BaseUrl;
+    const url = `${baseUrl}${devSvcDispatch}/staticResource/saveStaticResource`;
+
+    const formData = new FormData();
+    formData.append("label", String(label));
+    formData.append("desc", String(desc));
+    if (id) {
+        formData.append("id", String(id));
+    }
+
+    if (filePath) {
+        const absPath = path.isAbsolute(filePath) ? filePath : path.resolve(projectPath, filePath);
+        if (!fs.existsSync(absPath)) {
+            throw new Error(`Create Static Resource Failed: file not found - ${absPath}`);
+        }
+        const fileBuffer = fs.readFileSync(absPath);
+        const fileName = name || path.basename(absPath);
+        const fileType = type || path.extname(fileName).replace(".", "");
+        formData.append("name", fileName);
+        formData.append("type", fileType);
+        formData.append("file", new Blob([fileBuffer]), fileName);
+    } else {
+        // 编辑且不更换文件时，按接口约定传空字符串。
+        formData.append("file", "");
+        if (name) {
+            formData.append("name", String(name));
+        }
+        if (type) {
+            formData.append("type", String(type));
+        }
+    }
+
+    console.error();
+    console.error(chalk.green("Saving static resource, please wait..."));
+    console.error();
+
+    const res = await fetch(url, {
+        method: "POST",
+        headers: {
+            accessToken: config.accessToken,
+            source: config.source || "cloudcc_cli",
+        },
+        body: formData,
+    });
+    const result = await res.json();
+
+    if (result && (result.result || String(result.returnCode) === "200" || String(result.returnCode).endsWith("-OK"))) {
+        console.error(chalk.green("Success! Static resource saved."));
+        console.error();
+        return result;
+    }
+
+    throw new Error("Create Static Resource Failed: " + (result?.returnInfo || result?.message || "Unknown error"));
+}
+
+module.exports = create;

package/src/staticResource/delete.js

@@ -1,7 +1,19 @@
 const chalk = require("chalk");
 const { getPackageJson } = require("../../utils/config");
-const { postClass } = require("../../utils/http");
+const BaseUrl = "https://developer.apis.cloudcc.cn";
 
+/**
+ * 静态资源 - 删除
+ * CLI: cc delete staticResource <projectPath> <resourceId>
+ * 参数说明：
+ * - projectPath: 项目根目录，默认 process.cwd()
+ * - id(resourceId): 静态资源 id（必填）
+ * 请求体说明：
+ * - { id }
+ * 请求头说明：
+ * - accessToken: 从 cloudcc-cli.config.js 读取
+ * - source: 默认 cloudcc_cli
+ */
 async function remove(projectPath = process.cwd(), id) {
     if (!id) {
         throw new Error("Delete Static Resource Failed: id is required");
@@ -10,17 +22,27 @@ async function remove(projectPath = process.cwd(), id) {
     console.error();
     console.error(chalk.green(`Deleting static resource (${id}), please wait...`));
     console.error();
-    const res = await postClass(
-        config.setupSvc + "/api/staticResource/deleteStaticResource",
-        { id },
-        config.accessToken
+    const devSvcDispatch = config.devSvcDispatch || "/devconsole";
+    const baseUrl = config.baseUrl || BaseUrl;
+    const res = await fetch(
+        `${baseUrl}${devSvcDispatch}/staticResource/deleteStaticResource`,
+        {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json; charset=utf-8",
+                accessToken: config.accessToken,
+                source: config.source || "cloudcc_cli",
+            },
+            body: JSON.stringify({ id }),
+        }
     );
-    if (res && res.result) {
+    const data = await res.json();
+    if (data && (data.result || String(data.returnCode) === "200" || String(data.returnCode).endsWith("-OK"))) {
         console.error(chalk.green("Success! Static resource deleted."));
         console.error();
-        return res;
+        return data;
     }
-    throw new Error("Delete Static Resource Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+    throw new Error("Delete Static Resource Failed: " + (data?.returnInfo || data?.message || "Unknown error"));
 }
 
 module.exports = remove;

package/src/staticResource/detail.js

@@ -1,24 +1,46 @@
 const { getPackageJson } = require("../../utils/config");
-const { postClass } = require("../../utils/http");
+const BaseUrl = "https://developer.apis.cloudcc.cn";
 
+/**
+ * 静态资源 - 查询详情
+ * CLI: cc detail staticResource <projectPath> <resourceId>
+ * 参数说明：
+ * - projectPath: 项目根目录，默认 process.cwd()
+ * - id(resourceId): 静态资源 id（必填）
+ * 请求体说明：
+ * - { id }
+ * 请求头说明：
+ * - accessToken: 从 cloudcc-cli.config.js 读取
+ * - source: 默认 cloudcc_cli
+ */
 async function detail(projectPath = process.cwd(), id, isMcp = false) {
     if (!id) {
         throw new Error("Static Resource detail requires id");
     }
     const config = await getPackageJson(projectPath);
-    const res = await postClass(
-        config.setupSvc + "/api/staticResource/detailStaticResource",
-        { id },
-        config.accessToken
+    const devSvcDispatch = config.devSvcDispatch || "/devconsole";
+    const baseUrl = config.baseUrl || BaseUrl;
+    const res = await fetch(
+        `${baseUrl}${devSvcDispatch}/staticResource/detailStaticResource`,
+        {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json; charset=utf-8",
+                accessToken: config.accessToken,
+                source: config.source || "cloudcc_cli",
+            },
+            body: JSON.stringify({ id }),
+        }
     );
-    if (res && res.result) {
-        const data = res.data || {};
+    const data = await res.json();
+    if (data && (data.result || String(data.returnCode) === "200" || String(data.returnCode).endsWith("-OK"))) {
+        const detailData = data.data || {};
         if (!isMcp) {
-            console.log(JSON.stringify(data));
+            console.log(JSON.stringify(detailData));
         }
-        return data;
+        return detailData;
     }
-    throw new Error("Get Static Resource Detail Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+    throw new Error("Get Static Resource Detail Failed: " + (data?.returnInfo || data?.message || "Unknown error"));
 }
 
 module.exports = detail;

package/src/staticResource/doc.js

@@ -1,103 +1,36 @@
 /**
- * staticResource 文档统一入口（全量一次性输出）
+ * staticResource 文档入口：仅读取 docs/devguide.md。
  */
 const fs = require("fs");
 const path = require("path");
 
-function generateFullMarkdownDoc() {
-    const lines = [
-        "# CloudCC 静态资源（Static Resource）操作指南",
-        "",
-        "直接查看：`cc doc staticResource`",
-        "",
-        "> 静态资源用于在平台侧保存并复用静态文件（如图片、JS、CSS、压缩包等）。",
-        "> 本文档包含页面操作要点 + 相关接口速查（附录自动引入）。",
-        "",
-        "---",
-        "",
-        "## 1. 常见操作流程",
-        "",
-        "### 1.1 查询列表",
-        "",
-        "- 在静态资源列表页查看已有资源",
-        "- 可按 `label`（标签/名称）筛选（部分页面当前固定传空）",
-        "",
-        "### 1.2 新建静态资源（上传）",
-        "",
-        "核心字段：",
-        "- `label`：标签/名称（必填）",
-        "- `file`：上传文件（新建必传）",
-        "- `name`：文件名（通常取上传文件名）",
-        "- `type`：文件后缀（通常从文件名提取）",
-        "- `desc`：描述（可选）",
-        "",
-        "### 1.3 编辑静态资源",
-        "",
-        "- 编辑时需要传 `id`",
-        "- 若不重新上传文件，`file` 通常传空字符串 `\"\"`（以接口契约为准）",
-        "",
-        "### 1.4 查看详情",
-        "",
-        "- 通过资源 `id` 打开查看弹窗/详情接口",
-        "",
-        "### 1.5 删除静态资源",
-        "",
-        "- 通过资源 `id` 删除",
-        "- 删除前建议确认是否被页面、脚本或组件引用",
-        "",
-        "### 1.6 上传前容量校验",
-        "",
-        "- 上传前可先调用容量统计接口，获取当前占用大小",
-        "- 前端通常据此判断总大小是否超限（常见阈值约 15MB，具体以产品为准）",
-        "",
-        "---",
-        "",
-        "## 2. 接口与动作映射",
-        "",
-        "- **列表**：`POST /staticResource/listStaticResource`",
-        "- **详情**：`POST /staticResource/detailStaticResource`（`id`）",
-        "- **新建/编辑**：`POST /staticResource/saveStaticResource`（`FormData`）",
-        "- **删除**：`POST /staticResource/deleteStaticResource`（`id`）",
-        "- **容量统计**：`POST /staticResource/countStaticResource`",
-        "",
-        "---",
-        "",
-        "## 3. Checklist",
-        "",
-        "- [ ] 上传前已通过容量统计确认大小不会超限",
-        "- [ ] `label` 清晰可检索，避免重复命名",
-        "- [ ] 编辑不换文件时，确认 `file` 参数是否应传空字符串",
-        "- [ ] 删除前确认没有被页面/脚本/组件引用",
-        "",
-    ];
+const DOCS_DIR = path.join(__dirname, "docs");
+const DEVGUIDE = path.join(DOCS_DIR, "devguide.md");
 
-    const base = lines.join("\n");
-    const apiPath = path.join(__dirname, "..", "..", "cloudcc-cli-dev", "STATIC-RESOURCE-API.md");
-    let apiContent = "";
+function generateFullMarkdownDoc() {
+    let content = "";
     try {
-        apiContent = fs.readFileSync(apiPath, "utf8");
+        content = fs.readFileSync(DEVGUIDE, "utf8").trim();
     } catch (e) {
-        apiContent = `# 静态资源（Static Resource）接口文档\n\n（未找到文件：${apiPath}）\n`;
+        content = `# CloudCC 静态资源（Static Resource）操作指南\n\n（未找到文件：${DEVGUIDE}）\n`;
     }
 
-    return [
-        base,
-        "",
-        "---",
-        "",
-        "## 附录：静态资源接口速查",
-        "",
-        "> 来源：`cloudcc-cli-dev/STATIC-RESOURCE-API.md`",
-        "",
-        apiContent.trim(),
-        "",
-    ].join("\n");
+    return content;
 }
 
-function doc() {
-    const content = generateFullMarkdownDoc();
-    console.log(content);
-    return content;
+function doc(argvs = []) {
+    const subType = String(argvs[2] || "").trim().toLowerCase();
+    if (!subType || subType === "devguide") {
+        const content = generateFullMarkdownDoc();
+        console.log(content);
+        return content;
+    }
+    if (subType === "introduction") {
+        const content = getIntroductionDoc();
+        console.log(content);
+        return content;
+    }
+    throw new Error(`doc 不支持的子命令: ${argvs[2]}，请使用 introduction 或 devguide`);
 }
 
 doc.getEditGuide = doc;

package/src/staticResource/docs/devguide.md

@@ -0,0 +1,157 @@
+# 静态资源（Static Resource）操作指南
+
+直接查看：`cc doc staticResource`
+
+---
+
+## 1. 常见操作
+
+- 查询静态资源列表
+- 查看静态资源详情
+- 新建/编辑静态资源（上传）
+- 删除静态资源
+- 查询静态资源容量（上传前校验）
+
+---
+
+## 2. 常用 CLI 命令
+
+### 1) 查看静态资源指导文档
+
+命令：
+
+```bash
+cc doc staticResource
+```
+
+说明：输出静态资源完整操作文档，并自动附带本文件内容。
+
+### 2) 查询静态资源列表
+
+命令：
+
+```bash
+cc get staticResource <projectPath> [encodedCondJson]
+```
+
+参数说明：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| projectPath | string | 非必须 | 当前目录 | 项目根目录 |
+| encodedCondJson | string | 非必须 | — | `encodeURI(JSON.stringify(body))` 后的查询条件 |
+
+请求体（decoded 后）常用字段：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| label | string | 非必须 | `""` | 可用于按标签/名称筛选 |
+
+### 3) 查询静态资源详情
+
+命令：
+
+```bash
+cc detail staticResource <projectPath> <resourceId>
+```
+
+参数说明：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| projectPath | string | 非必须 | 当前目录 | 项目根目录 |
+| resourceId | string | 必须 | — | 静态资源 id |
+
+### 4) 新建/编辑静态资源（上传）
+
+命令：
+
+```bash
+cc create staticResource <projectPath> <encodedBodyJson>
+```
+
+参数说明：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| projectPath | string | 非必须 | 当前目录 | 项目根目录 |
+| encodedBodyJson | string | 必须 | — | `encodeURI(JSON.stringify(body))` |
+
+请求体（decoded 后）字段：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| filePath | string | 视场景 | — | 新建必填；编辑不换文件可不传 |
+| label | string | 必须 | — | 标签/名称 |
+| desc | string | 非必须 | `""` | 描述 |
+| id | string | 仅编辑 | `""` | 编辑时传静态资源 id |
+| name | string | 非必须 | 文件名 | 不传则从 `filePath` 推导 |
+| type | string | 非必须 | 文件后缀 | 不传则从文件名推导 |
+
+### 5) 删除静态资源
+
+命令：
+
+```bash
+cc delete staticResource <projectPath> <resourceId>
+```
+
+参数说明：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| projectPath | string | 非必须 | 当前目录 | 项目根目录 |
+| resourceId | string | 必须 | — | 静态资源 id |
+
+### 6) 统计静态资源容量（上传前校验）
+
+命令：
+
+```bash
+cc count staticResource <projectPath> [encodedCondJson]
+```
+
+参数说明：
+
+| 参数名称 | 类型 | 是否必须 | 默认值 | 备注 |
+| :--- | :--- | :--- | :--- | :--- |
+| projectPath | string | 非必须 | 当前目录 | 项目根目录 |
+| encodedCondJson | string | 非必须 | — | 当前实现通常不传，传值时同样为 `encodeURI(JSON.stringify(body))` |
+
+---
+
+## 3. 示例
+
+### 按 label 查询列表
+
+```bash
+cc get staticResource . "$(node -e 'console.log(encodeURI(JSON.stringify({label:\"logo\"})))')"
+```
+
+### 查询容量统计
+
+```bash
+cc count staticResource .
+```
+
+### 新建静态资源（上传文件）
+
+```bash
+cc create staticResource . "$(node -e "console.log(encodeURI(JSON.stringify({filePath:'./assets/logo.png',label:'logo_png',desc:'cli upload'})))")"
+```
+
+### 编辑静态资源（不替换文件）
+
+```bash
+cc create staticResource . "$(node -e "console.log(encodeURI(JSON.stringify({id:'69c4f469ec9eb4d5c8a1b76d',label:'logo_png_v2',desc:'rename only'})))")"
+```
+
+---
+
+## 4. Checklist
+
+- [ ] 已在正确项目目录执行命令（或显式传入 `projectPath`）
+- [ ] 列表查询条件已按 `encodeURI(JSON.stringify(...))` 传入
+- [ ] 删除前已确认资源未被页面/脚本/组件引用
+- [ ] 上传前已先执行容量统计
+

package/src/staticResource/docs/introduction.md

@@ -0,0 +1,3 @@
+# CloudCC 静态资源介绍
+
+TODO

package/src/staticResource/get.js

@@ -1,25 +1,48 @@
 const { getPackageJson } = require("../../utils/config");
-const { postClass } = require("../../utils/http");
+const BaseUrl = "https://developer.apis.cloudcc.cn";
 
+/**
+ * 静态资源 - 查询列表
+ * CLI: cc get staticResource <projectPath> [encodedCondJson]
+ * 参数说明：
+ * - projectPath: 项目根目录，默认 process.cwd()
+ * - encodedCondJson(可选): encodeURI(JSON.stringify(body))
+ * - body: 查询条件对象（可为空 {}），常用字段：label
+ * 请求头说明：
+ * - accessToken: 从 cloudcc-cli.config.js 读取
+ * - source: 默认 cloudcc_cli
+ */
 async function get(projectPath = process.cwd(), encodedCondJson, isMcp = false) {
     let body = {};
     if (encodedCondJson) {
         body = JSON.parse(decodeURI(encodedCondJson));
     }
     const config = await getPackageJson(projectPath);
-    const res = await postClass(
-        config.setupSvc + "/api/staticResource/listStaticResource",
-        body,
-        config.accessToken
+    const devSvcDispatch = config.devSvcDispatch || "/devconsole";
+    const baseUrl = config.baseUrl || BaseUrl;
+    const res = await fetch(
+        `${baseUrl}${devSvcDispatch}/staticResource/listStaticResource`,
+        {
+            method: "POST",
+            headers: {
+                "Content-Type": "application/json; charset=utf-8",
+                accessToken: config.accessToken,
+                source: config.source || "cloudcc_cli",
+            },
+            body: JSON.stringify(body),
+        }
     );
-    if (res && res.result) {
-        const list = res?.data?.objList || res?.data?.list || [];
+    const data = await res.json();
+    if (data && (data.result || String(data.returnCode) === "200" || String(data.returnCode).endsWith("-OK"))) {
+        const list = Array.isArray(data?.data)
+            ? data.data
+            : (data?.data?.objList || data?.data?.list || []);
         if (!isMcp) {
             console.log(JSON.stringify(list));
         }
         return list;
     }
-    throw new Error("Get Static Resource Failed: " + (res?.returnInfo || res?.message || "Unknown error"));
+    throw new Error("Get Static Resource Failed: " + (data?.returnInfo || data?.message || "Unknown error"));
 }
 
 module.exports = get;

package/src/staticResource/index.js

@@ -1,11 +1,12 @@
 const cc = {};
 cc.doc = require("./doc");
+cc.create = require("./create");
 cc.get = require("./get");
 cc.detail = require("./detail");
 cc.delete = require("./delete");
 cc.count = require("./count");
 function StaticResource(action, argvs) {
-    cc[action](argvs[2], argvs[3]);
+    cc[action](...argvs.slice(2));
 }
 
 module.exports = StaticResource;

package/src/timer/create.js

@@ -4,7 +4,12 @@ const path = require("path")
 const chalk = require("chalk")
 const { getPackageJson } = require("../../utils/config.js")
 
-async function create(name) {
+/**
+ * cc create timer <name>
+ * @param {string[]} argvs
+ */
+async function create(argvs) {
+    const name = argvs[2]
     let res = await checkUpdate();
     if (!res) {
         let config = await getPackageJson();

package/src/timer/delete.js

@@ -4,7 +4,13 @@ const chalk = require("chalk");
 const { getPackageJson } = require("../../utils/config");
 const { postClass } = require("../../utils/http");
 
-async function remove(nameOrId, projectPath = process.cwd()) {
+/**
+ * cc delete timer <nameOrId> [projectPath]
+ * @param {string[]} argvs
+ */
+async function remove(argvs) {
+    const nameOrId = argvs[2]
+    const projectPath = argvs[3] != null && argvs[3] !== "" ? argvs[3] : process.cwd()
     let scheduleId = nameOrId;
     const schedulePath = path.join(projectPath, `schedule/${nameOrId}/`);
     const configPath = path.join(schedulePath, "config.json");

package/src/timer/detail.js

@@ -5,12 +5,12 @@ const { getPackageJson } = require("../../utils/config")
 const { postClass } = require("../../utils/http")
 
 /**
- * 获取定时类详细信息
- * @param {string} name - 定时类名称（优先从本地查询）
- * @param {string} id - 定时类ID（当没有name时从服务器查询）
- * @returns {Object} 定时类详细信息
+ * cc detail timer <name> <id>
+ * @param {string[]} argvs
  */
-async function detail(name, id) {
+async function detail(argvs) {
+    const name = argvs[2]
+    const id = argvs[3]
     // 如果有 name，优先查询本地
     if (name && name !== '') {
         const schedulePath = path.join(process.cwd(), `schedule/${name}/`);