cloudcc-cli 2.4.1 → 2.4.2

package/README.md

@@ -71,6 +71,48 @@ 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

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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cloudcc-cli",
-  "version": "2.4.1",
+  "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/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
+

package/src/dupeCatcher/docs/devguide.md

@@ -0,0 +1,125 @@
+# CloudCC 查重过滤器（Dupe Catcher）CLI 命令说明
+
+> 对应 one-setup-web 的接口前缀：`{setupSvc}/api/duplication/*`
+
+## 1. 功能范围
+
+- 过滤器（Filter）：列表、详情、保存（新建/编辑）、删除
+- 规则（Rule）：回显详情、保存（新建/编辑）、删除
+- 辅助查询：可选对象、可选字段、条件面板字段列表
+
+## 2. 命令总览
+
+```bash
+# 过滤器列表
+cloudcc get dupeCatcher [projectPath]
+
+# 过滤器详情（含规则列表）
+cloudcc detail dupeCatcher <projectPath> <filterid>
+
+# 保存过滤器（新建/编辑）
+cloudcc create dupeCatcher <projectPath> filter <encodedBodyJson>
+
+# 删除过滤器
+cloudcc delete dupeCatcher <projectPath> filter <filterid>
+
+# 规则详情（回显）
+cloudcc detail dupeCatcher <projectPath> rule <ruleid>
+
+# 保存规则（新建/编辑）
+cloudcc create dupeCatcher <projectPath> rule <encodedBodyJson>
+
+# 删除规则
+cloudcc delete dupeCatcher <projectPath> rule <ruleid>
+
+# 新建过滤器前：查询可选对象
+cloudcc get dupeCatcher objects [projectPath]
+
+# 新建规则前：查询可选字段
+cloudcc get dupeCatcher <projectPath> fields <filterid>
+
+# 条件面板字段列表（复用工作流接口）
+cloudcc get dupeCatcher <projectPath> workflowFields <targetobjectid>
+```
+
+## 3. 参数说明
+
+### 3.1 projectPath
+
+- **可选**，项目根目录（默认当前目录）。
+
+### 3.2 encodedBodyJson
+
+- **必须**：`encodeURI(JSON.stringify(body))`
+
+### 3.3 命令参数一览
+
+| 命令 | 参数 |
+| :--- | :--- |
+| `cloudcc get dupeCatcher [projectPath]` | `projectPath` 可选 |
+| `cloudcc detail dupeCatcher <projectPath> <filterid>` | `projectPath` 可选（默认当前目录），`filterid` 必填 |
+| `cloudcc create dupeCatcher <projectPath> filter <encodedBodyJson>` | `projectPath` 可选（默认当前目录），`encodedBodyJson` 必填 |
+| `cloudcc delete dupeCatcher <projectPath> filter <filterid>` | `projectPath` 可选（默认当前目录），`filterid` 必填 |
+| `cloudcc detail dupeCatcher <projectPath> rule <ruleid>` | `projectPath` 可选（默认当前目录），`ruleid` 必填 |
+| `cloudcc create dupeCatcher <projectPath> rule <encodedBodyJson>` | `projectPath` 可选（默认当前目录），`encodedBodyJson` 必填 |
+| `cloudcc delete dupeCatcher <projectPath> rule <ruleid>` | `projectPath` 可选（默认当前目录），`ruleid` 必填 |
+| `cloudcc get dupeCatcher objects [projectPath]` | `projectPath` 可选 |
+| `cloudcc get dupeCatcher <projectPath> fields <filterid>` | `projectPath` 可选（默认当前目录），`filterid` 必填 |
+| `cloudcc get dupeCatcher <projectPath> workflowFields <targetobjectid>` | `projectPath` 可选（默认当前目录），`targetobjectid` 必填 |
+
+### 3.4 `create dupeCatcher filter` 的 body 字段
+
+| 字段 | 类型 | 是否必须 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `id` | string | 否 | 编辑时传；新建可不传 |
+| `name` | string | 是 | 过滤器名称 |
+| `objid` | string | 是 | 目标对象 id |
+| `errormessage` | string | 否 | 错误提示文案 |
+| `insertoperation` | string | 是 | 新增策略：`check` / `nothing` |
+| `insertIsSave` | string/null | 条件必填 | `insertoperation=check` 时建议传 `"1"`/`"0"`，否则传 `null` |
+| `insertIsTips` | string/null | 条件必填 | `insertoperation=check` 时建议传 `"1"`/`"0"`，否则传 `null` |
+| `updateoperation` | string | 是 | 更新策略：`check` / `nothing` |
+| `updateIsSave` | string/null | 条件必填 | `updateoperation=check` 时建议传 `"1"`/`"0"`，否则传 `null` |
+| `updateIsTips` | string/null | 条件必填 | `updateoperation=check` 时建议传 `"1"`/`"0"`，否则传 `null` |
+| `isprofile` | boolean | 否 | 是否简档 |
+| `isactive` | boolean | 否 | 是否启用 |
+| `conditionVals` | string | 是 | 条件面板产出的 JSON 字符串 |
+
+### 3.5 `create dupeCatcher rule` 的 body 字段
+
+| 字段 | 类型 | 是否必须 | 说明 |
+| :--- | :--- | :--- | :--- |
+| `id` | string | 否 | 编辑时传；新建可不传 |
+| `filterid` | string | 是 | 所属过滤器 id |
+| `fieldid` | string | 是 | 匹配字段 id |
+| `matchoption` | string | 是 | `exact` / `contains` / `firstNletters` / `lastNletters` |
+| `firstletters` | string | 条件必填 | `matchoption` 为 `firstNletters/lastNletters` 时传字母数 |
+| `isblank` | number | 否 | 空值是否参与匹配，常用 `1/0` |
+
+## 4. 示例
+
+### 4.1 查询过滤器列表
+
+```bash
+cloudcc get dupeCatcher .
+```
+
+### 4.2 保存过滤器（新建）
+
+> 关键字段（与页面一致）：`name`、`objid`、`insertoperation`、`updateoperation`、`conditionVals` 等。
+
+```bash
+cloudcc create dupeCatcher . filter "$(node -e "console.log(encodeURI(JSON.stringify({name:'测试过滤器',objid:'<objid>',errormessage:'',insertoperation:'check',insertIsSave:'1',insertIsTips:'1',updateoperation:'check',updateIsSave:'1',updateIsTips:'1',isprofile:false,isactive:true,conditionVals:'{}'})))")"
+```
+
+### 4.3 保存规则（新建）
+
+```bash
+cloudcc create dupeCatcher . rule "$(node -e "console.log(encodeURI(JSON.stringify({filterid:'<filterid>',fieldid:'<fieldid>',matchoption:'exact',firstletters:'',isblank:0})))")"
+```
+
+## 5. 注意事项
+
+- `filterid` / `ruleid` / `objid` / `fieldid` 都来自平台返回数据，请先通过列表/详情接口获取。
+- `conditionVals` 是页面条件面板产出的 **json 字符串**（不是对象），请按接口要求传入字符串。
+

package/src/dupeCatcher/docs/introduction.md

@@ -0,0 +1,21 @@
+# CloudCC 查重过滤器（Dupe Catcher）介绍
+
+查重过滤器用于在**新建或编辑业务数据**时，按配置的**对象、字段与条件**检测是否与已有记录重复，从而提示或阻断保存。平台侧通过 **过滤器（Filter）** 与 **规则（Rule）** 两层建模：过滤器绑定目标对象与启用范围，规则描述具体匹配字段与逻辑。
+
+## 适用场景
+
+- 客户、联系人、线索等主数据**去重**（姓名 + 手机、邮箱等组合）。
+- 同一业务对象下**多套查重策略**（不同过滤器、不同规则集）。
+- 与 **one-setup-web** 中查重配置能力一致，CLI 面向**导出配置、脚本化维护、与本地工程联调**。
+
+## 能力边界（与开发指南的关系）
+
+- **介绍（本文）**：说明是什么、何时用、与平台概念对应关系。
+- **开发指南**：`cloudcc doc dupeCatcher devguide` — 列出 `get` / `detail` / `create` / `delete` 等 CLI 命令、参数与接口前缀 `{setupSvc}/api/duplication/*`。
+
+## 相关命令入口
+
+```bash
+cloudcc doc dupeCatcher introduction   # 本文
+cloudcc doc dupeCatcher devguide       # CLI 与接口说明
+```

package/src/dupeCatcher/get.js

@@ -0,0 +1,88 @@
+const { getPackageJson } = require("../../utils/config")
+const { postClass } = require("../../utils/http")
+
+/**
+ * Dupe Catcher (Duplication) queries.
+ *
+ * Supported:
+ * - cloudcc get dupeCatcher [projectPath]
+ *   -> /api/duplication/getList
+ *
+ * - cloudcc get dupeCatcher objects [projectPath]
+ *   -> /api/duplication/insetNewfilter
+ *
+ * - cloudcc get dupeCatcher fields <filterid> [projectPath]
+ *   -> /api/duplication/insetNewrule
+ *
+ * - cloudcc get dupeCatcher workflowFields <targetobjectid> [projectPath]
+ *   -> /api/workFlowSetup/newWorkflow
+ */
+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 get(projectPath = process.cwd(), sub, subArg, isMcp = false) {
+  // compatibility: cloudcc get dupeCatcher objects [projectPath]
+  if (!isPathLikeToken(projectPath) && (projectPath === "objects" || projectPath === "fields" || projectPath === "workflowFields")) {
+    subArg = sub
+    sub = projectPath
+    projectPath = process.cwd()
+  }
+
+  if (!sub) {
+    const res = await request(projectPath, "/api/duplication/getList", {})
+    if (res && res.result) {
+      const list = res.data || res.list || []
+      if (!isMcp) console.log(JSON.stringify(list))
+      return list
+    }
+    throw new Error("Get DupeCatcher filter list failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  if (sub === "objects") {
+    const res = await request(projectPath, "/api/duplication/insetNewfilter", {})
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Get DupeCatcher objects failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  if (sub === "fields") {
+    const filterid = subArg
+    if (!filterid) throw new Error("Missing filterid. Usage: cloudcc get dupeCatcher fields <filterid> [projectPath]")
+    const res = await request(projectPath, "/api/duplication/insetNewrule", { filterid })
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Get DupeCatcher fields failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  if (sub === "workflowFields") {
+    const targetobjectid = subArg
+    if (!targetobjectid) {
+      throw new Error("Missing targetobjectid. Usage: cloudcc get dupeCatcher workflowFields <targetobjectid> [projectPath]")
+    }
+    const res = await request(projectPath, "/api/workFlowSetup/newWorkflow", { targetobjectid })
+    if (res && res.result) {
+      const data = res.data || res
+      if (!isMcp) console.log(JSON.stringify(data))
+      return data
+    }
+    throw new Error("Get DupeCatcher workflowFields failed: " + (res?.returnInfo || res?.message || "Unknown error"))
+  }
+
+  throw new Error(`Unknown subcommand for get dupeCatcher: ${sub}`)
+}
+
+module.exports = get
+

package/src/dupeCatcher/index.js

@@ -0,0 +1,14 @@
+const cc = {}
+
+cc.get = require("./get")
+cc.detail = require("./detail")
+cc.create = require("./create")
+cc.delete = require("./delete")
+cc.doc = require("./doc")
+
+function main(action, argvs) {
+  cc[action](argvs[2], argvs[3], argvs[4], argvs[5])
+}
+
+module.exports = main
+