cloudcc-cli 2.3.1 → 2.3.3

package/test/globalSelectList.cli.test.js

@@ -0,0 +1,94 @@
+const test = require("node:test");
+const assert = require("node:assert/strict");
+const { exec } = require("node:child_process");
+const { promisify } = require("node:util");
+const path = require("node:path");
+
+const execAsync = promisify(exec);
+const repoRoot = path.resolve(__dirname, "..");
+
+function quoteArg(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+async function runCc(args) {
+  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  return execAsync(cmd, { cwd: repoRoot });
+}
+
+test("全局选项列表", async (t) => {
+  const ts = Date.now();
+  const label = `TestGSL${ts}`;
+  const name = `test_gsl_${ts}`;
+  let createdId = null;
+
+  await t.test("1) 获取 doc（globalSelectList introduction / devguide）", async () => {
+    const intro = await runCc(["doc", "globalSelectList", "introduction"]);
+    assert.match(intro.stdout, /全局选项列表/);
+
+    const devguide = await runCc(["doc", "globalSelectList", "devguide"]);
+    assert.match(devguide.stdout, /全局选项列表/);
+  });
+
+  await t.test("2) 获取全局选项列表（get）", async () => {
+    const { stdout } = await runCc(["get", "globalSelectList", repoRoot]);
+    const list = JSON.parse(stdout.trim());
+    assert.ok(Array.isArray(list), "get globalSelectList 应返回数组");
+    assert.ok(list.length >= 0, "列表长度应为非负整数");
+  });
+
+  await t.test("3) 新建全局选项列表（create）", async () => {
+    const body = encodeURI(
+      JSON.stringify({
+        label,
+        name,
+        description: "cli test 自动创建",
+        ptext: "选项A\r\n选项B\r\n选项C",
+        isPicklistSorted: "0",
+        isFirstDefault: "1",
+      })
+    );
+    const { stderr } = await runCc(["create", "globalSelectList", repoRoot, body]);
+    assert.match(stderr, /Success|created/i, "create 应输出成功信息");
+
+    // 从列表中找到刚创建的记录，取得 id
+    const { stdout } = await runCc(["get", "globalSelectList", repoRoot]);
+    const list = JSON.parse(stdout.trim());
+    const found = list.find((item) => item.name === name || item.label === label);
+    assert.ok(found, "新建后 get 列表中应能找到该记录");
+    createdId = found.id;
+    assert.ok(createdId, "新建记录应有 id");
+  });
+
+  await t.test("4) 获取详情（detail）", async () => {
+    assert.ok(createdId, "detail 测试需要 createdId");
+    const { stdout } = await runCc(["detail", "globalSelectList", repoRoot, createdId]);
+    const result = JSON.parse(stdout.trim());
+
+    assert.ok(result.globalSelect, "detail 应返回 globalSelect 字段");
+    assert.equal(result.globalSelect.id, createdId, "detail.globalSelect.id 应与请求 id 一致");
+    assert.ok(result.globalSelect.label, "detail.globalSelect 应包含 label");
+    assert.ok(result.globalSelect.name, "detail.globalSelect 应包含 name");
+
+    assert.ok(Array.isArray(result.enabledList), "detail 应返回 enabledList 数组");
+    assert.ok(result.enabledList.length >= 3, "enabledList 应包含新建时填写的 3 个选项");
+
+    assert.ok(Array.isArray(result.disabledList), "detail 应返回 disabledList 数组");
+    assert.ok(Array.isArray(result.useList), "detail 应返回 useList 数组");
+  });
+
+  await t.test("5) 删除全局选项列表（delete）", async () => {
+    assert.ok(createdId, "delete 测试需要 createdId");
+    const { stdout, stderr } = await runCc(["delete", "globalSelectList", repoRoot, createdId]);
+    const out = `${stdout}\n${stderr}`.trim();
+    assert.match(out, /Success|deleted/i, "delete 应输出成功信息");
+  });
+
+  await t.test("6) 删除后 get 列表中不再包含该记录", async () => {
+    assert.ok(createdId, "验证删除需要 createdId");
+    const { stdout } = await runCc(["get", "globalSelectList", repoRoot]);
+    const list = JSON.parse(stdout.trim());
+    const found = list.find((item) => item.id === createdId);
+    assert.equal(found, undefined, "删除后列表中不应再包含已删除记录");
+  });
+});

package/test/menu-script.cli.test.js

@@ -0,0 +1,147 @@
+const test = require("node:test");
+const assert = require("node:assert/strict");
+const path = require("node:path");
+const { exec } = require("node:child_process");
+const { promisify } = require("node:util");
+
+const execAsync = promisify(exec);
+const repoRoot = path.resolve(__dirname, "..");
+
+function quoteArg(value) {
+  return `'${String(value).replace(/'/g, `'\\''`)}'`;
+}
+
+async function runCc(args) {
+  const cmd = `npx --prefix "${repoRoot}" cc ${args.map(quoteArg).join(" ")}`;
+  return execAsync(cmd, { cwd: repoRoot });
+}
+
+test("自定义脚本菜单管理流程：doc→创建脚本菜单→查询列表→删除", async (t) => {
+  const tabName = `CC测试脚本菜单_${Date.now()}`;
+  // pname 必须以字母开头，只能包含字母、数字、下划线
+  const pname = `test_script_menu_${Date.now()}`;
+  const functioncode = "ccc.alert('Hello from test');";
+  let menuId = null;
+
+  await t.test("0) 获取 doc（menu devguide 包含脚本菜单说明）", async () => {
+    const { stdout } = await runCc(["doc", "menu", "devguide"]);
+    assert.match(stdout, /脚本|script|functioncode/i, "devguide 应包含脚本菜单相关说明");
+  });
+
+  await t.test("1) 创建自定义脚本菜单（仅必需参数）", async () => {
+    const { stdout, stderr } = await runCc([
+      "create", "menu", "script",
+      repoRoot,
+      tabName,
+      pname
+    ]);
+    const out = `${stdout}\n${stderr}`.trim();
+    assert.match(out, /Success|成功/i, "create menu script 应输出成功信息");
+    assert.match(out, /console\.log\("hello"\)/i, "默认脚本内容应为 console.log(\"hello\")");
+  });
+
+  await t.test("2) 查询菜单列表（get menu）并匹配刚创建的脚本菜单", async () => {
+    const { stdout } = await runCc(["get", "menu", repoRoot]);
+    const list = JSON.parse(stdout.trim());
+    assert.ok(Array.isArray(list), "get menu 应返回数组");
+
+    // 脚本菜单可能在 scriptlist 中，也可能在合并后的列表中
+    const allMenus = Array.isArray(list) ? list : [];
+    const hit = allMenus.find((item) =>
+      item.tabName === tabName ||
+      item.tabLabel === tabName ||
+      item.label === tabName ||
+      item.name === tabName ||
+      item.pname === pname
+    );
+
+    if (!hit) {
+      console.error("[menu-script-test] 未在菜单列表定位到刚创建的脚本菜单，跳过删除步骤");
+      return;
+    }
+    menuId = hit.id;
+    assert.ok(menuId, "命中菜单应包含 id");
+    console.error(`\n[menu-script-test] 找到脚本菜单: ${hit.tabName || hit.label} (id=${menuId})`);
+  });
+
+  await t.test("3) 删除脚本菜单（delete menu）", async () => {
+    if (!menuId) {
+      console.error("[menu-script-test] 无 menuId，跳过 delete menu");
+      return;
+    }
+    const { stdout, stderr } = await runCc(["delete", "menu", repoRoot, menuId]);
+    const out = `${stdout}\n${stderr}`.trim();
+    assert.match(out, /Success|成功/i, "delete menu 应输出成功信息");
+  });
+});
+
+test("自定义脚本菜单完整参数测试", async (t) => {
+  const tabName = `CC脚本菜单完整_${Date.now()}`;
+  const pname = `full_test_menu_${Date.now()}`;
+  const functioncode = "console.log('Custom script executed'); ccc.alert('Done');";
+  const tabStyle = "cloudtab150";
+  const mobileimg = "cloudcc05";
+  let menuId = null;
+
+  await t.test("1) 创建带完整参数的脚本菜单", async () => {
+    const { stdout, stderr } = await runCc([
+      "create", "menu", "script",
+      repoRoot,
+      tabName,
+      pname,
+      functioncode,
+      tabStyle,
+      mobileimg
+    ]);
+    const out = `${stdout}\n${stderr}`.trim();
+    assert.match(out, /Success|成功/i, "带完整参数的 create menu script 应成功");
+    assert.match(out, /Custom script executed/, "应包含自定义脚本内容");
+  });
+
+  await t.test("2) 查询并清理", async () => {
+    const { stdout } = await runCc(["get", "menu", repoRoot]);
+    const list = JSON.parse(stdout.trim());
+    const hit = list.find((item) => item.tabName === tabName || item.pname === pname);
+    if (hit && hit.id) {
+      menuId = hit.id;
+      await runCc(["delete", "menu", repoRoot, menuId]);
+      console.error(`[menu-script-test] 已清理测试菜单: ${tabName}`);
+    }
+  });
+});
+
+test("自定义脚本菜单参数验证测试", async (t) => {
+  await t.test("1) 缺少 tabName 参数应返回错误", async () => {
+    await assert.rejects(
+      () => runCc(["create", "menu", "script", repoRoot]),
+      /Error|缺少|required/i,
+      "缺少必需参数时应报错"
+    );
+  });
+
+  await t.test("2) 自动生成 pname（当未提供时）", async () => {
+    const autoTabName = `AutoPnameTest_${Date.now()}`;
+    const { stdout, stderr } = await runCc([
+      "create", "menu", "script",
+      repoRoot,
+      autoTabName
+      // 不提供 pname，测试自动生成逻辑
+    ]);
+    const out = `${stdout}\n${stderr}`.trim();
+    // 由于 pname 是必需的，这里应该提示自动生成或报错
+    // 根据代码逻辑，如果不提供 pname 会尝试用 tabName 生成
+    console.error(`[menu-script-test] 自动生成测试输出: ${out.substring(0, 200)}`);
+
+    // 清理：查询并删除
+    try {
+      const { stdout: listOut } = await runCc(["get", "menu", repoRoot]);
+      const list = JSON.parse(listOut.trim());
+      const hit = list.find((item) => item.tabName === autoTabName);
+      if (hit && hit.id) {
+        await runCc(["delete", "menu", repoRoot, hit.id]);
+      }
+    } catch (e) {
+      // 忽略清理错误
+    }
+  });
+});

package/test/menu.cli.test.js

@@ -16,12 +16,19 @@ async function runCc(args) {
   return execAsync(cmd, { cwd: repoRoot });
 }
 
-test("菜单管理流程：获取对象列表→create menu object", async (t) => {
+test("菜单管理流程：doc→获取对象列表→create menu object", async (t) => {
   let objectId = null;
   let objectName = null;
   const tabName = `CC测试菜单Tab_${Date.now()}`;
   let menuId = null;
 
+  await t.test("0) 获取 doc（menu introduction / devguide）", async () => {
+    const intro = await runCc(["doc", "menu", "introduction"]);
+    assert.match(intro.stdout, /菜单/);
+    const dev = await runCc(["doc", "menu", "devguide"]);
+    assert.match(dev.stdout, /菜单/);
+  });
+
   await t.test("1) 获取自定义对象列表（取第一个自定义对象 id 用于创建菜单）", async () => {
     const { stdout } = await runCc(["get", "object", repoRoot, "custom"]);
     const list = JSON.parse(stdout.trim());

package/test/plugin.cli.test.js

@@ -39,9 +39,11 @@ test("组件管理流程：创建→doc→发布→拉取→详情→列表→
     assert.ok(config.component && config.component.includes(pluginName));
   });
 
-  t.test("2) 获取 doc（plugin overview）", async () => {
-    const { stdout } = await runCc(["doc", "plugin", "overview"]);
-    assert.ok(stdout.length > 0, "doc plugin 应有输出");
+  t.test("2) 获取 doc（plugin introduction / devguide）", async () => {
+    const intro = await runCc(["doc", "plugin", "introduction"]);
+    assert.match(intro.stdout, /自定义组件/);
+    const dev = await runCc(["doc", "plugin", "devguide"]);
+    assert.match(dev.stdout, /自定义组件/);
   });
 
   t.test("3) 发布组件（publish：以输出判断成功）", async () => {

package/test/timer.cli.test.js

@@ -18,7 +18,7 @@ async function runCc(args) {
   return execAsync(cmd, { cwd: repoRoot });
 }
 
-test("定时任务管理流程：创建→发布→拉取→线上详情→列表→批量拉取→delete→清空 schedule 文件夹", async (t) => {
+test("定时任务管理流程：创建→doc→发布→拉取→线上详情→列表→批量拉取→delete→清空 schedule 文件夹", async (t) => {
   const timerName = `CCTimer${Date.now()}`;
   const timerDir = path.join(scheduleRoot, timerName);
   const configPath = path.join(timerDir, "config.json");
@@ -37,14 +37,21 @@ test("定时任务管理流程：创建→发布→拉取→线上详情→列
     assert.equal(config.name, timerName);
   });
 
-  t.test("2) 发布定时任务（publish，写回 config.id）", async () => {
+  t.test("2) 获取 doc（timer introduction / devguide）", async () => {
+    const intro = await runCc(["doc", "timer", "introduction"]);
+    assert.match(intro.stdout, /定时类/);
+    const dev = await runCc(["doc", "timer", "devguide"]);
+    assert.match(dev.stdout, /定时/);
+  });
+
+  t.test("3) 发布定时任务（publish，写回 config.id）", async () => {
     await runCc(["publish", "timer", timerName]);
     const configAfterPublish = JSON.parse(fs.readFileSync(configPath, "utf8"));
     publishedId = configAfterPublish.id || null;
     assert.ok(publishedId, "publish 后应写入 config.id");
   });
 
-  t.test("3) 拉取定时任务（pull：覆盖 SOURCE 区域）", async () => {
+  t.test("4) 拉取定时任务（pull：覆盖 SOURCE 区域）", async () => {
     const localJava = fs.readFileSync(javaPath, "utf8");
     const modifiedJava = localJava.replace(
       /\/\/ @SOURCE_CONTENT_START[\s\S]*?\/\/ @SOURCE_CONTENT_END/,
@@ -57,12 +64,12 @@ test("定时任务管理流程：创建→发布→拉取→线上详情→列
     assert.ok(!javaAfterPull.includes("LOCAL_ONLY"), "pull 后应使用远端源码替换本地标记内容");
   });
 
-  t.test("4) 查询线上定时任务详情（detail：仅使用 id）", async () => {
+  t.test("5) 查询线上定时任务详情（detail：仅使用 id）", async () => {
     assert.ok(publishedId, "发布后应有 publishedId");
     await assert.doesNotReject(() => runCc(["detail", "timer", "", publishedId]));
   });
 
-  t.test("5) get 获取线上定时任务列表（取前2个 id）", async () => {
+  t.test("6) get 获取线上定时任务列表（取前2个 id）", async () => {
     const listQuery = encodeURI(
       JSON.stringify({
         shownum: "2000",
@@ -80,7 +87,7 @@ test("定时任务管理流程：创建→发布→拉取→线上详情→列
     assert.ok(topIds.length >= 1, "线上定时任务列表至少应包含 1 个 id");
   });
 
-  t.test("6) 批量拉取前2个定时任务（pullList）", async () => {
+  t.test("7) 批量拉取前2个定时任务（pullList）", async () => {
     assert.ok(topIds.length >= 1, "pullList 需要至少 1 个线上定时任务 id");
     const beforeCount = fs.existsSync(scheduleRoot)
       ? fs.readdirSync(scheduleRoot).filter((n) => fs.statSync(path.join(scheduleRoot, n)).isDirectory()).length
@@ -96,13 +103,13 @@ test("定时任务管理流程：创建→发布→拉取→线上详情→列
     assert.ok(afterCount >= beforeCount, "pullList 之后 schedule 目录应存在/可用");
   });
 
-  t.test("7) 删除当前创建定时类（delete timer）", async () => {
+  t.test("8) 删除当前创建定时类（delete timer）", async () => {
     const { stdout, stderr } = await runCc(["delete", "timer", timerName, repoRoot]);
     const out = `${stdout}\n${stderr}`.trim();
     assert.match(out, /Success|成功/i, "delete timer 应输出成功信息");
   });
 
-  t.test("8) 清空 schedule 文件夹", async () => {
+  t.test("9) 清空 schedule 文件夹", async () => {
     if (fs.existsSync(scheduleRoot)) {
       fs.rmSync(scheduleRoot, { recursive: true, force: true });
     }

package/test/trigger.cli.test.js

@@ -65,9 +65,11 @@ test("触发器管理流程：获取对象→创建→doc→发布→拉取→
     assert.equal(config.triggerTime, triggerTime);
   });
 
-  t.test("3) 获取 doc（triggers overview）", async () => {
-    const { stdout } = await runCc(["doc", "triggers", "overview"]);
-    assert.match(stdout, /触发器|CCTrigger|编辑指南/i);
+  t.test("3) 获取 doc（triggers introduction / devguide）", async () => {
+    const intro = await runCc(["doc", "triggers", "introduction"]);
+    assert.match(intro.stdout, /触发器/);
+    const dev = await runCc(["doc", "triggers", "devguide"]);
+    assert.match(dev.stdout, /触发器/);
   });
 
   t.test("4) 发布触发器（publish，写回 config.id）", async () => {

package/.cursor/skills/cloudcc-cli-dev/BACKEND_CLASS.md

@@ -1,111 +0,0 @@
-## 自定义类（Class）
-
-## 覆盖范围
-
-本篇聚焦 CloudCC 后端 Java 自定义类（通过 `cc` 命令）：
-
-- 创建类骨架
-- 拉取线上源码片段
-- 发布本地源码片段
-- 列表、详情与按 ID 生成本地工程
-
----
-
-## 目录结构（以本仓库约定为准）
-
-- `classes/{ClassName}/...`
-
----
-
-## 生成文件说明
-
-当执行 `cc create classes <ClassName>` 后，通常会在项目根目录生成：
-
-- `classes/<ClassName>/<ClassName>.java`：主类文件
-- `classes/<ClassName>/<ClassName>Test.java`：测试桩文件（便于本地跑 main）
-- `classes/<ClassName>/config.json`：记录 `name`、`version`，以及首次 `publish` 成功后写入的 `id`
-
-`<ClassName>.java` 的 Java 包名为 `package classes.<ClassName>;`
-
----
-
-## 源码同步边界（必须理解）
-
-该项目使用“片段同步”策略：
-
-- 自定义类只会拉取/发布 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的内容。
-
-这意味着：
-
-- 片段外可保留模板、import、类结构等。
-- 片段内仅放可发布逻辑，不放本地临时调试代码。
-
----
-
-## 创建
-
-```bash
-# 在项目根目录执行
-cc create classes <ClassName>
-```
-
-## 拉取 / 发布
-
-```bash
-cc pull classes <ClassName>
-cc publish classes <ClassName>
-```
-
-### `pull` 前置条件
-
-- `pull` 会读取 `classes/<ClassName>/config.json` 里的 `id`
-- 如果本地 `config.json` 没有 `id`（通常表示从未 `publish` 过），会提示 “Class ID is not exist, please publish first”
-
-### `publish` 行为
-
-- `publish` 会从 `<ClassName>.java` 中提取 `@SOURCE_CONTENT_START` 与 `@SOURCE_CONTENT_END` 之间的源码作为 `source` 上传
-- 首次发布成功后，会把云端返回的 `id` 写回本地 `config.json`
-
----
-
-## 获取 / 详情 / 批量拉取 / 删除
-
-```bash
-# 列出（可选：传入 encodeURI(JSON.stringify({...})) 查询体；不传则用默认分页参数）
-cc get classes <encodedJson>
-
-# 详情：优先本地读取；当没有本地信息或未发布时，再通过 id 查云端
-cc detail classes <ClassName> <ClassId>
-
-# 批量拉取：根据云端 id 生成本地 classes/<ClassName>/ 目录
-cc pullList classes <ClassId> <ProjectRoot>
-```
-
-说明：
-
-- `detail`/`pull` 等命令在本地优先；只要你本地 `classes/<ClassName>/config.json` 已包含 `id`，就可以按 id 查并拉取源码。
-
----
-
-## 删除类
-
-```bash
-# 传类名（优先读取 classes/<ClassName>/config.json 中的 id）
-cc delete classes <ClassName> [projectPath]
-
-# 或直接传类 id
-cc delete classes <ClassId> [projectPath]
-```
-
-⚠️ **警告：删除操作不可逆，请谨慎使用。**
-
----
-
-## 推荐工作流（AI 执行顺序）
-
-1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
-2. 创建类骨架（`create`）
-3. 拉取线上版本（`pull`）对齐基线（如是增量改造）
-4. 编写片段内业务逻辑（注意幂等、异常兜底）
-5. 发布（`publish`）
-6. 回归验证：单条调用、跨模块调用（触发器/定时类/组件等）与异常分支

package/.cursor/skills/cloudcc-cli-dev/BACKEND_SCHEDULE.md

@@ -1,152 +0,0 @@
-# 定时作业管理（Scheduled Class / Timer）
-
-定时作业是 CloudCC 后台设置中的功能，依赖二开中的定时类，用于定时执行任务的 Java 类。
-
-本篇涵盖：
-- **定时类开发**：通过 `cc` 命令创建/拉取/发布定时类代码
-- **定时作业管理**：通过 `cc` 命令查询/详情/删除线上定时作业
-
----
-
-## 覆盖范围
-
-本篇聚焦 CloudCC 后端 Java 定时类（通过 `cc` 命令）：
-
-- 创建定时类骨架
-- 拉取线上源码片段
-- 发布本地源码片段
-- 列表、详情与按 ID 批量落地
-
----
-
-## 目录结构（以本仓库约定为准）
-
-- `schedule/{ScheduleName}/...`
-
----
-
-## 核心说明
-
-定时类在平台上对应"定时作业"类代码，本地由 `src/timer` 实现。CLI 上 `schedule` 与 `timer` 完全等价（同一模块），任选其一即可。
-
-### 目录与 Java 约定
-
-- **路径**：`schedule/<ScheduleName>/`
-- **文件**：
-  - `<ScheduleName>.java`：`package schedule.<ScheduleName>`，类 `extends CCSchedule`，业务逻辑写在无参构造函数中。
-  - `config.json`：至少包含 `name`、`version`；首次发布成功后会写入云端返回的 `id`，供后续拉取使用。
-
-### 片段同步
-
-- 推荐在构造函数体内使用 `// @SOURCE_CONTENT_START` 与 `// @SOURCE_CONTENT_END` 包裹可同步逻辑。
-- **发布**：有标记时只上传标记之间源码；无标记时会把整文件作为 `source` 提交。
-- **拉取**：有标记时只替换标记区间；无标记时用接口返回的 `tsource` 覆盖整个 `.java` 文件。
-
----
-
-## 创建 / 发布 / 拉取
-
-```bash
-# 在项目根目录执行（schedule 可换成 timer）
-cc create schedule <ScheduleName>
-cc publish schedule <ScheduleName>
-cc pull schedule <ScheduleName>
-```
-
-**重要：`pull` 前置条件**
-
-- `config.json` 中必须已有 `id`（通常需先 `publish` 成功一次）。否则会出现 "Schedule ID is not exist, please publish first" 类提示。
-
----
-
-## 列表 / 详情 / 按 ID 生成本地工程
-
-```bash
-# 列表（可选：传 encodeURI(JSON.stringify({...})) 查询体；不传用默认分页）
-cc get schedule
-
-# 详情：优先按本地 schedule/<name>/ 读取；仅查云端可传 id（name 置空）
-cc detail schedule <ScheduleName> <ScheduleId>
-
-# 按云端 id 拉取并在指定项目下生成 schedule/<name>/
-cc pullList schedule <ScheduleId> <ProjectRoot>
-```
-
-**说明**：`get` / `detail` / `pullList` 同样支持将子命令中的 `schedule` 写成 `timer`。
-
----
-
-## 推荐工作流（AI 执行顺序）
-
-1. 通过对象/字段工具确认数据结构（必要时先建对象字段）
-2. 创建定时类骨架（create）
-3. 拉取线上版本（pull）对齐基线（如是增量改造）
-4. 编写片段内业务逻辑（注意幂等、异常兜底）
-5. 发布（publish）
-6. 回归验证：单条、批量、跨天、异常分支
-
----
-
-## 删除定时类
-
-```bash
-# 传定时类名（优先读取 schedule/<name>/config.json 中的 id）
-cc delete schedule <ScheduleName> [projectPath]
-
-# 或直接传定时类 id
-cc delete schedule <ScheduleId> [projectPath]
-```
-
-⚠️ **警告：删除操作不可逆，请谨慎使用。**
-
----
-
-## 定时作业（scheduleJob）命令化管理
-
-当前已提供 `scheduleJob` 类型，可通过 CLI 管理定时作业配置（执行计划）：
-
-```bash
-# 查询定时作业列表（可选条件）
-cc get scheduleJob <projectPath> [encodedCondJson]
-
-# 查询定时作业详情
-cc detail scheduleJob <jobId> [projectPath]
-
-# 删除定时作业
-cc delete scheduleJob <jobId> [projectPath]
-```
-
-说明：
-
-- `scheduleJob` 管理的是“定时作业配置”，不是定时类源码。
-- 删除定时作业后，定时类代码仍可能存在；只是该执行计划被移除。
-
----
-
-## 注意事项
-
-1. **片段同步**：只编辑 `// @SOURCE_CONTENT_START` ~ `// @SOURCE_CONTENT_END` 之间的代码。
-2. **命名规范**：定时类名遵循 Java 大驼峰命名。
-3. **幂等与异常**：定时任务要可重复执行，并做好异常兜底和日志。
-4. **pull 前置条件**：必须先 `publish` 成功一次，`config.json` 中有 `id` 才能 `pull`。
-5. **权限要求**：需要对应系统管理权限（定时类/定时作业管理）。
-
----
-
-## 完整工作流程（cc 命令）
-
-```bash
-# 1) 开发定时类
-cc create schedule MyTimer
-cc pull schedule MyTimer
-# ...编辑代码...
-cc publish schedule MyTimer
-
-# 2) 运维查询定时作业
-cc get scheduleJob .
-cc detail scheduleJob <jobId> .
-
-# 3) 必要时删除
-cc delete schedule MyTimer .
-cc delete scheduleJob <jobId> .
-```