cloudcc-cli 2.4.0 → 2.4.2

package/README.md

@@ -71,6 +71,66 @@ Resolve the script path on macOS/Linux with:
 echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 ```
 
+# ReleaseV2.4.2
+
+#### Release Date: 2026-4-9
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Config resilience
+  - Fixed `utils/config.js` fallback flow so commands no longer throw `ENOENT` when `package.json` is missing in the current working directory
+  - Added safe existence check and parse guard for legacy `devConsoleConfig` loading to continue with cache/v3/v2 config sources
+- Release maintenance
+  - Bumped package version to `2.4.2` and synchronized lockfile root version metadata
+- Dupe Catcher module
+  - Added a new `dupeCatcher` resource with `get`, `detail`, `create`, `delete`, and `doc` actions for filter/rule management
+  - Added `src/dupeCatcher/docs/devguide.md` with command contracts and payload guidance
+- Sharing Rule module
+  - Added a new `sharingRule` resource focused on object-based rule query via `cloudcc get sharingRule <objid> [projectPath]`
+  - Integrated sharing rule docs (`introduction` and `devguide`) aligned to the query-only workflow
+- CLI discovery and routing
+  - Registered `dupeCatcher` and `sharingRule` in `bin/index.js` and help metadata (`src/version/listModuleCommands.js`) so `cloudcc --help` and `cloudcc get -h` can discover both modules
+- HTML docs module
+  - Added a new `html` resource with `cloudcc doc html <introduction|devguide>` for single-file HTML component guidance
+  - Added `src/html/docs/introduction.md` and `src/html/docs/devguide.md`, including static-resource referencing guidance for JS/CSS/image assets
+- Skill alignment
+  - Updated `cloudcc-dev-skill/SKILL.md` to route HTML component guidance through `cloudcc doc html introduction|devguide`
+- Site docs module
+  - Added a new `site` resource with `cloudcc doc site <introduction|devguide>` to provide standalone site development guidance
+  - Added `src/site/docs/introduction.md`, `src/site/docs/devguide.md`, and frontend aesthetics references under `src/site/docs/frontend_aesthetics/`
+- OpenAPI browser SDK module
+  - Added a new `openapi` resource with `cloudcc get openapi [targetDir] [outputFileName]` to copy browser SDK files into standalone site projects
+  - Added `cloudcc doc openapi <introduction|devguide>` and module docs for account/password login and object API access from independent sites
+- CLI help and routing updates
+  - Registered `site` and `openapi` in routing/help metadata so `cloudcc --help` and `cloudcc get -h` can discover the new resources
+- Skill package cleanup
+  - Removed deprecated `cloudcc-dev-html` skill file and aligned `cloudcc-dev-skill` version metadata for consolidated site guidance
+- Project configuration (JSON)
+  - Added `cloudcc-cli.config.json` support via `getPackageJson4` in `utils/config.js` so projects with `package.json` `"type":"module"` are not blocked by CommonJS `require` on `.js` config
+  - `getPackageJson` now resolves JSON after cache and before legacy JS loaders (`getPackageJson3` / `getPackageJson2`); `loadCloudccConfigRootSync` and `resolveCloudccConfigFile` prefer JSON when both `.json` and `.js` exist
+  - `cloudcc create project` scaffolds `cloudcc-cli.config.json` (replaces the former `template/cloudcc-cli.configjs` template)
+  - Updated `config use`, `doctor`, plugin pull/publish ignore lists, `.npmignore`, and `classes` error text to recognize the new config filename
+
+# ReleaseV2.4.1
+
+#### Release Date: 2026-4-9
+
+#### Release Scope: Full
+
+#### Release Content
+
+- Docs alignment
+  - Refined `devguide` structure for `classes`, `timer`, and `triggers` to focus on implementation rules and avoid duplicated concept sections covered by `introduction`
+  - Added complete CLI command and argument sections in `classes` and `triggers` devguides, aligned with actual module handlers
+  - Expanded `timer` devguide command/argument coverage for all supported actions (`create`, `publish`, `pull`, `get`, `detail`, `pullList`, `delete`, `doc`)
+- Query parameter documentation
+  - Added trigger list query field documentation in trigger devguide, including `fid`/`objId` semantics
+  - Clarified script list query docs: `condition.objName` is the query field and its value should be object **label** (not API name)
+- MCP consistency
+  - Extended trigger list MCP schema and handler parameters (`objId`, paging, filter, sort) and aligned descriptions with CLI query body usage
+
 # ReleaseV2.4.0
 
 #### Release Date: 2026-4-8

package/bin/index.js

@@ -11,6 +11,8 @@ const modules = {
   triggers: require("../src/triggers/index"),
   timer: require("../src/timer/index"),
   script: require("../src/script/index"),
+  html: require("../src/html/index"),
+  site: require("../src/site/index"),
   jsp: require("../src/jsp/index"),
   token: require("../src/token/index"),
   object: require("../src/object/index"),
@@ -29,7 +31,10 @@ const modules = {
   singleSignOn: require("../src/singleSignOn/index"),
   pagelayout: require("../src/pagelayout/index"),
   validationRule: require("../src/validationRule/index"),
+  dupeCatcher: require("../src/dupeCatcher/index"),
+  sharingRule: require("../src/sharingRule/index"),
   permission: require("../src/permission/index"),
+  openapi: require("../src/openapi/index"),
 };
 
 /**

package/cloudcc-dev-skill/SKILL.md

@@ -1,6 +1,6 @@
 ---
 name: cloudcc-dev-skill
-description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `cloudcc doc <module> introduction|devguide` 获取官方模块文档，再给出方案与代码。用户提到 CloudCC、cloudcc-cli、模块文档、对象/字段、权限、触发器、类、组件、页面、脚本、JSP迁移、静态资源、菜单、应用、单点登录、身份提供方、校验规则时应优先使用。
+description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `cloudcc doc <module> introduction|devguide` 获取官方模块文档，再给出方案与代码。用户提到 CloudCC、cloudcc-cli、模块文档、对象/字段、权限、触发器、类、组件、页面、脚本、JSP 迁移、静态资源、菜单、应用、单点登录、身份提供方、校验规则、查重过滤器（Dupe Catcher）、重复/去重、共享规则时应优先使用。
 ---
 
 # CloudCC CRM 二开技能
@@ -34,7 +34,9 @@ description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `clou
 - 全局选项：`cloudcc doc globalSelectList introduction`、`cloudcc doc globalSelectList devguide`
 - 按钮：`cloudcc doc button introduction`、`cloudcc doc button devguide`
 - 页面布局：`cloudcc doc pagelayout introduction`、`cloudcc doc pagelayout devguide`
-- 校验规则：`cloudcc doc validationRule introduction`、`cloudcc doc validationRule devguide`
+- 验证规则：`cloudcc doc validationRule introduction`、`cloudcc doc validationRule devguide`
+- 查重过滤器（dupeCatcher）：`cloudcc doc dupeCatcher introduction`、`cloudcc doc dupeCatcher devguide`
+- 共享规则（sharingRule）：`cloudcc doc sharingRule introduction`、`cloudcc doc sharingRule devguide`
 
 ### 组织与权限
 
@@ -53,7 +55,8 @@ description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `clou
 ### 前端扩展
 
 - 自定义Vue组件：`cloudcc doc plugin introduction`、`cloudcc doc plugin devguide`
-- 自定义Html组件：`./cloudcc-dev-html.md`
+- 自定义 HTML 组件：`cloudcc doc html introduction`、`cloudcc doc html devguide`
+- Site 开发规范：`cloudcc doc site introduction`、`cloudcc doc site devguide`
 - 自定义页面：`cloudcc doc customPage introduction`、`cloudcc doc customPage devguide`
 - 客户端脚本：`cloudcc doc script introduction`、`cloudcc doc script devguide`
 - 静态资源：`cloudcc doc staticResource introduction`、`cloudcc doc staticResource devguide`
@@ -90,12 +93,3 @@ description: 用于 CloudCC CRM 二次开发设计与实施。优先通过 `clou
 - **发布日志/Release Notes 规则（强制）**：凡是更新发布记录、版本日志、README 中
   `Release`/`Release Notes`
   区块，内容必须使用英文（标题、日期标签、条目描述均不得使用中文）。
-
-## 快速规则
-
-- 先确认 CLI 可用：优先检查 `cloudcc --version`。
-- 若未安装，执行：`npm i -g cloudcc-cli@latest`。
-- 当进行 CloudCC 方案设计时，必须读取所有模块的`introduction`文档后，再设计
-- 当进行 CloudCC 方案开发时，需要读取，对应模块的`devguide`信息后，再开发
-- 命令统一格式：`cloudcc doc <module> <introduction|devguide>`。
-- 特例：`config` 仅支持 `devguide`，不支持 `introduction`。

package/cloudcc-dev-skill/config.json

@@ -1,4 +1,4 @@
 {
-  "version": "1.0.3",
-  "releaseDate": "2026-04-07"
+  "version": "1.0.6",
+  "releaseDate": "2026-04-09"
 }

package/mcp/index.js

@@ -394,10 +394,15 @@ mcpServer.registerTool(
 mcpServer.registerTool(
     'get_trigger_list',
     {
-        description: '获取 CloudCC CRM 服务器上的触发器列表，可选筛选条件',
-        inputSchema: z.object({
-            triggerName: z.string().optional().describe('可选，触发器名称（用于筛选）'),
-            targetObjectId: z.string().optional().describe('可选，目标对象ID（用于筛选）'),
+        description: '获取 CloudCC CRM 服务器上的触发器列表。支持按触发器名称、对象ID筛选，并支持分页/扩展过滤/排序参数。',
+        inputSchema: z.object({
+            triggerName: z.string().optional().describe('可选，触发器名称（映射到查询字段 sname）'),
+            targetObjectId: z.string().optional().describe('可选，目标对象ID（映射到查询字段 fid）'),
+            objId: z.string().optional().describe('可选，目标对象ID语义化别名（会映射到 fid）'),
+            shownum: z.union([z.string(), z.number()]).optional().describe('可选，每页条数（默认 2000）'),
+            showpage: z.union([z.string(), z.number()]).optional().describe('可选，页码（默认 1）'),
+            rptcond: z.string().optional().describe('可选，扩展过滤条件（默认空字符串）'),
+            rptorder: z.string().optional().describe('可选，排序条件（默认空字符串）'),
             projectPath: z.string().describe('项目根目录路径，默认为当前工作目录')
         })
     },

package/mcp/tools/Trigger List Retriever/handler.js

@@ -9,20 +9,36 @@ const { runCcJsonCommand } = require('../../cliRunner');
 /**
  * 获取触发器列表
  * @param {Object} params - 参数对象
- * @param {string} params.triggerName - 可选，触发器名称（用于筛选）
- * @param {string} params.targetObjectId - 可选，目标对象ID（用于筛选）
+ * @param {string} params.triggerName - 可选，触发器名称（映射到 sname）
+ * @param {string} params.targetObjectId - 可选，目标对象ID（映射到 fid）
+ * @param {string} params.objId - 可选，目标对象ID（语义化别名，映射到 fid）
+ * @param {string|number} params.shownum - 可选，每页条数，默认 2000
+ * @param {string|number} params.showpage - 可选，页码，默认 1
+ * @param {string} params.rptcond - 可选，扩展过滤条件
+ * @param {string} params.rptorder - 可选，排序条件
  * @param {string} params.projectPath - 项目路径（可选，默认为当前工作目录）
  */
-async function listTriggers({ triggerName = '', targetObjectId = '', projectPath = process.cwd() }) {
+async function listTriggers({
+    triggerName = '',
+    targetObjectId = '',
+    objId = '',
+    shownum = '2000',
+    showpage = '1',
+    rptcond = '',
+    rptorder = '',
+    projectPath = process.cwd()
+}) {
     try {
         // 构造查询条件
+        const objectId = targetObjectId || objId || "";
         const queryBody = {
-            shownum: "2000",
-            showpage: "1",
-            fid: targetObjectId || "",
+            shownum: String(shownum),
+            showpage: String(showpage),
+            fid: objectId,
             sname: triggerName || "",
-            rptcond: '',
-            rptorder: ''
+            rptcond: rptcond || '',
+            rptorder: rptorder || '',
+            objId: objectId
         };
         
         const resolvedPath = path.resolve(projectPath);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.4.0",
+  "version": "2.4.2",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",
@@ -52,4 +52,4 @@
     "sass": "^1.98.0",
     "sass-loader": "^16.0.7"
   }
-}
+}

package/src/classes/create.js

@@ -17,7 +17,7 @@ async function create(argvs) {
             console.error()
             console.error(
                 chalk.yellow(
-                    "No valid cloudcc-cli config for this project. Create or fix cloudcc-cli.config.js (see cloudcc doc project devguide)."
+                    "No valid cloudcc-cli config for this project. Create or fix cloudcc-cli.config.json (or .js) (see cloudcc doc project devguide)."
                 )
             )
             console.error()

package/src/classes/docs/devguide.md

@@ -25,39 +25,152 @@
 
 - CloudCC 官方后端 SDK 参考：`CCObject`、`UserInfo`、`CCService`、`SendEmail`、`DevLogger`、`TimeUtil`
 
-## 3. AI 的总体职责
+## 3. 与 introduction 的分工（避免重复）
 
-AI 在编写 CloudCC 自定义类时，应把自己视为“服务端业务能力设计者”，而不是“只补一段能跑代码的脚本工具”。
+为避免与 `classes introduction` 内容重复，本 `devguide` 只保留“开发落地规范”：
 
-AI 需要同时满足以下目标：
+- 命令与入参（可直接执行）
+- 目录与文件约束（可直接检查）
+- SDK 用法与边界（可直接编码）
+- 代码结构、禁止事项与自检清单（可直接评审）
 
-- 功能正确
-- 结构清晰
-- 可复用
-- 易排错
-- 易发布
+“自定义类是什么、适用/不适用场景、能力边界、与其他实现方式差异”等概念说明，统一以 `cloudcc doc classes introduction` 为准。
 
-## 4. 什么时候应该使用自定义类
+## 4. classes 模块支持的 CLI 命令总览（重点：入参）
 
-满足以下任一情况时，AI 应优先选择自定义类实现：
+说明：
 
-- 逻辑需要在服务端执行
-- 一个动作会影响多个对象
-- 逻辑会被多个入口复用
-- 需要复杂规则计算
-- 需要流程状态推进
-- 需要调用外部系统
-- 需要处理附件、文件、目录
-- 需要统一日志、异常、时间处理
-- 需要自动通知、提醒、待办协同
-- 需要接入 AI 或分析能力
+- 下文命令中的资源名使用 `classes`。
+- `projectPath` 未传时，默认使用当前工作目录。
 
-以下场景不要优先上自定义类：
+#### 1) 创建自定义类
 
-- 只是简单展示
-- 只是轻量页面交互
-- 只是简单字段联动
-- 标准配置即可完成
+命令：
+
+```bash
+cloudcc create classes <name>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 是 | `string` | 类名（同时作为目录名、Java 主类名） |
+
+#### 2) 发布自定义类
+
+命令：
+
+```bash
+cloudcc publish classes <name>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 是 | `string` | 本地 `classes/<name>/` 目录名 |
+
+#### 3) 拉取自定义类（按本地名称）
+
+命令：
+
+```bash
+cloudcc pull classes <name>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 是 | `string` | 本地 `classes/<name>/` 目录名；会读取该目录 `config.json` 中的 `id` 拉取 |
+
+#### 4) 查询自定义类列表（支持条件查询）
+
+命令：
+
+```bash
+cloudcc get classes [listQueryJson] [projectPath]
+```
+
+`listQueryJson` 推荐结构：
+
+```json
+{
+    "shownum": 2000,
+    "showpage": 1,
+    "sname": ""
+}
+```
+
+字段说明：
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `shownum` | `number|string` | 否 | 每页条数，默认 `2000` |
+| `showpage` | `number|string` | 否 | 页码，默认 `1` |
+| `sname` | `string` | 否 | 名称筛选关键字，模糊查询 |
+
+#### 5) 查看自定义类详情
+
+命令：
+
+```bash
+cloudcc detail classes <name> <id>
+```
+
+参数规则（实现口径）：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 条件必填 | `string` | 传 `name` 时优先查本地；本地不完整时再走线上 |
+| `id` | 条件必填 | `string` | 当 `name` 为空时，必须传 `id` 走线上查询 |
+
+等价理解：`name` 与 `id` 至少传一个，优先使用 `name` 路径。
+
+#### 6) 按 ID 拉取并落地到本地目录
+
+命令：
+
+```bash
+cloudcc pullList classes <id> <projectPath>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `id` | 是 | `string` | 线上自定义类 ID |
+| `projectPath` | 是 | `string` | 项目根目录；会写入到 `<projectPath>/classes/<name>/` |
+
+#### 7) 删除自定义类
+
+命令：
+
+```bash
+cloudcc delete classes <nameOrId> [projectPath]
+```
+
+参数规则：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `nameOrId` | 是 | `string` | 可传本地目录名或线上 ID；若本地 `classes/<nameOrId>/config.json` 存在且带 `id`，优先使用其中 `id` 删除 |
+| `projectPath` | 否 | `string` | 项目根目录，默认当前目录 |
+
+#### 8) 文档命令
+
+命令：
+
+```bash
+cloudcc doc classes <introduction|devguide>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `introduction|devguide` | 是 | `string` | `introduction` 返回概念文档；`devguide` 返回开发规范（并附 SDK 速查） |
 
 ## 5. AI 必须遵守的硬规则
 

package/src/config/use.js

@@ -1,14 +1,29 @@
 const path = require("path")
 const fs = require("fs")
+const { resolveCloudccConfigFile } = require("../../utils/config.js")
 
 function use(env, projectPath = process.cwd()) {
-    let config = require(path.join(projectPath, "cloudcc-cli.config.js"));
-    config.use = env;
-    fs.writeFileSync(path.join(projectPath, "cloudcc-cli.config.js"),
+    const resolved = resolveCloudccConfigFile(projectPath)
+    if (!resolved) {
+        throw new Error("No cloudcc-cli.config.json or cloudcc-cli.config.js found")
+    }
+    if (resolved.kind === "json") {
+        const config = JSON.parse(fs.readFileSync(resolved.filePath, "utf8"))
+        config.use = env
+        fs.writeFileSync(resolved.filePath, JSON.stringify(config, null, 4) + "\n", "utf8")
+        return
+    }
+    const jsPath = resolved.filePath
+    delete require.cache[require.resolve(jsPath)]
+    const config = require(jsPath)
+    config.use = env
+    fs.writeFileSync(
+        jsPath,
         `module.exports = 
     ${JSON.stringify(config)}
-`
-        , 'utf8');
+`,
+        "utf8"
+    )
 }
 
 module.exports = use;

package/src/dupeCatcher/create.js

@@ -0,0 +1,76 @@
+const chalk = require("chalk")
+const { getPackageJson } = require("../../utils/config")
+const { postClass } = require("../../utils/http")
+
+/**
+ * Supported:
+ * - cloudcc create dupeCatcher filter <encodedBodyJson> [projectPath]
+ *   -> /api/duplication/saveFilter
+ *
+ * - cloudcc create dupeCatcher rule <encodedBodyJson> [projectPath]
+ *   -> /api/duplication/nsaverule
+ */
+function isPathLikeToken(v) {
+  if (typeof v !== "string" || !v) return false
+  return v === "." || v === ".." || /[\\/]/.test(v) || /:/.test(v)
+}
+
+async function request(projectPath, apiPath, body) {
+  const config = await getPackageJson(projectPath)
+  return await postClass(config.setupSvc + apiPath, body || {}, config.accessToken)
+}
+
+async function create(projectPath = process.cwd(), kind, encoded, isMcp = false) {
+  // compatibility: cloudcc create dupeCatcher filter <encoded> [projectPath]
+  if (!isPathLikeToken(projectPath)) {
+    encoded = kind
+    kind = projectPath
+    projectPath = process.cwd()
+  }
+
+  if (!kind || !encoded) {
+    throw new Error(
+      "Usage:\n" +
+        "- cloudcc create dupeCatcher filter <encodedBodyJson> [projectPath]\n" +
+        "- cloudcc create dupeCatcher rule <encodedBodyJson> [projectPath]"
+    )
+  }
+
+  let body
+  try {
+    body = JSON.parse(decodeURI(encoded))
+  } catch (e) {
+    throw new Error("Invalid encodedBodyJson (must be encodeURI(JSON.stringify(obj))). " + e.message)
+  }
+
+  if (kind === "filter") {
+    console.error()
+    console.error(chalk.green("Saving dupe catcher filter, please wait..."))
+    console.error()
+    const res = await request(projectPath, "/api/duplication/saveFilter", body)
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Create/Update DupeCatcher filter failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  if (kind === "rule") {
+    console.error()
+    console.error(chalk.green("Saving dupe catcher rule, please wait..."))
+    console.error()
+    const res = await request(projectPath, "/api/duplication/nsaverule", body)
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Create/Update DupeCatcher rule failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  throw new Error(`Unknown kind for create dupeCatcher: ${kind}. Expected 'filter' or 'rule'.`)
+}
+
+module.exports = create
+

package/src/dupeCatcher/delete.js

@@ -0,0 +1,69 @@
+const chalk = require("chalk")
+const { getPackageJson } = require("../../utils/config")
+const { postClass } = require("../../utils/http")
+
+/**
+ * Supported:
+ * - cloudcc delete dupeCatcher filter <filterid> [projectPath]
+ *   -> /api/duplication/deletefilter
+ *
+ * - cloudcc delete dupeCatcher rule <ruleid> [projectPath]
+ *   -> /api/duplication/deleterule
+ */
+function isPathLikeToken(v) {
+  if (typeof v !== "string" || !v) return false
+  return v === "." || v === ".." || /[\\/]/.test(v) || /:/.test(v)
+}
+
+async function request(projectPath, apiPath, body) {
+  const config = await getPackageJson(projectPath)
+  return await postClass(config.setupSvc + apiPath, body || {}, config.accessToken)
+}
+
+async function del(projectPath = process.cwd(), kind, id, isMcp = false) {
+  // compatibility: cloudcc delete dupeCatcher filter <id> [projectPath]
+  if (!isPathLikeToken(projectPath)) {
+    id = kind
+    kind = projectPath
+    projectPath = process.cwd()
+  }
+
+  if (!kind || !id) {
+    throw new Error(
+      "Usage:\n" +
+        "- cloudcc delete dupeCatcher filter <filterid> [projectPath]\n" +
+        "- cloudcc delete dupeCatcher rule <ruleid> [projectPath]"
+    )
+  }
+
+  if (kind === "filter") {
+    console.error()
+    console.error(chalk.green(`Deleting dupe catcher filter (${id}), please wait...`))
+    console.error()
+    const res = await request(projectPath, "/api/duplication/deletefilter", { filterid: id })
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Delete DupeCatcher filter failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  if (kind === "rule") {
+    console.error()
+    console.error(chalk.green(`Deleting dupe catcher rule (${id}), please wait...`))
+    console.error()
+    const res = await request(projectPath, "/api/duplication/deleterule", { ruleid: id })
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Delete DupeCatcher rule failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  throw new Error(`Unknown kind for delete dupeCatcher: ${kind}. Expected 'filter' or 'rule'.`)
+}
+
+module.exports = del
+

package/src/dupeCatcher/detail.js

@@ -0,0 +1,57 @@
+const { getPackageJson } = require("../../utils/config")
+const { postClass } = require("../../utils/http")
+
+/**
+ * Supported:
+ * - cloudcc detail dupeCatcher <filterid> [projectPath]
+ *   -> /api/duplication/detailfilter
+ *
+ * - cloudcc detail dupeCatcher rule <ruleid> [projectPath]
+ *   -> /api/duplication/updateNewrule
+ */
+function isPathLikeToken(v) {
+  if (typeof v !== "string" || !v) return false
+  return v === "." || v === ".." || /[\\/]/.test(v) || /:/.test(v)
+}
+
+async function request(projectPath, apiPath, body) {
+  const config = await getPackageJson(projectPath)
+  return await postClass(config.setupSvc + apiPath, body || {}, config.accessToken)
+}
+
+async function detail(projectPath = process.cwd(), kindOrId, maybeId, isMcp = false) {
+  // compatibility: cloudcc detail dupeCatcher <filterid> [projectPath]
+  if (!isPathLikeToken(projectPath)) {
+    maybeId = kindOrId
+    kindOrId = projectPath
+    projectPath = process.cwd()
+  }
+
+  if (!kindOrId) {
+    throw new Error("Missing id. Usage: cloudcc detail dupeCatcher <filterid> [projectPath]")
+  }
+
+  if (kindOrId === "rule") {
+    const ruleid = maybeId
+    if (!ruleid) throw new Error("Missing ruleid. Usage: cloudcc detail dupeCatcher rule <ruleid> [projectPath]")
+    const res = await request(projectPath, "/api/duplication/updateNewrule", { ruleid })
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Detail DupeCatcher rule failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  const filterid = kindOrId
+  const res = await request(projectPath, "/api/duplication/detailfilter", { filterid })
+  if (res && res.result) {
+    const data = res.data || res
+    if (!isMcp) console.log(JSON.stringify(data))
+    return data
+  }
+  throw new Error("Detail DupeCatcher filter failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+}
+
+module.exports = detail
+

package/src/dupeCatcher/doc.js

@@ -0,0 +1,11 @@
+const fs = require("fs")
+const path = require("path")
+
+function doc() {
+  const p = path.join(__dirname, "docs", "devguide.md")
+  const content = fs.readFileSync(p, "utf8")
+  console.log(content)
+}
+
+module.exports = doc
+