cloudcc-cli 2.4.0 → 2.4.2

package/src/triggers/docs/devguide.md

@@ -25,50 +25,167 @@
 
 ## 2. 编写依据
 
-- 官方 SDK 文档负责定义 `CCObject`、`UserInfo`、`CCService`、`SendEmail`、`DevLogger`、`TimeUtil`、自定义设置、共享对象相关能力
-- `triggers devguide` 负责定义 CLI、目录结构、创建发布拉取删除方式和触发器模块约束
+- 官方 SDK 文档负责定义
+  `CCObject`、`UserInfo`、`CCService`、`SendEmail`、`DevLogger`、`TimeUtil`、自定义设置、共享对象相关能力
+- `triggers devguide` 负责定义
+  CLI、目录结构、创建发布拉取删除方式和触发器模块约束
 - 当前项目触发器样例负责补充“本项目常见写法”和“本项目容易踩坑的地方”
 
-## 3. AI 的总体职责
+## 3. 与 introduction 的分工（避免重复）
 
-AI 在编写触发器时，应把自己视为“对象生命周期规则设计者”，而不是“在构造函数里临时塞一段业务代码的人”。
+为避免与 `triggers introduction` 内容重复，本 `devguide` 只保留“开发落地规范”：
 
-AI 需要同时做到：
+- 命令与入参（可直接执行）
+- 目录与文件约束（可直接检查）
+- SDK 用法与边界（可直接编码）
+- 代码结构、性能/递归/幂等与交付要求（可直接评审）
 
-- 判断需求是否真的适合触发器
-- 选择合适的触发时机
-- 控制触发器体量，不把复杂逻辑全部堆在入口里
-- 正确调用 SDK 完成查、增、改、删、通知、日志、时间处理
-- 主动规避递归触发、重复生成、全表扫描、时区错误、共享误删等风险
+“触发器是什么、适用/不适用场景、能力边界、与其他实现方式差异”等概念说明，统一以
+`cloudcc doc triggers introduction` 为准。
 
-## 4. 先判断：是不是应该写成触发器
+## 4. triggers 模块支持的 CLI 命令总览（重点：入参）
 
-AI 在动手前，必须先判断需求是否属于“对象事件驱动”。
+说明：
 
-### 4.1 适合触发器的情况
+- 下文命令中的资源名使用 `triggers`。
+- `projectPath` 未传时，默认使用当前工作目录。
 
-- 某条记录新增时必须立即执行
-- 某条记录修改时必须立即校验或联动
-- 某条记录删除前必须阻止或删除后必须补偿
-- 提交审批、审批通过、审批撤回时必须执行规则
-- 当前规则必须平台层统一执行，不能依赖前端页面
-- 当前动作如果不在这一刻做，会造成数据错误、状态错误或流程错误
+#### 1) 创建触发器
 
-### 4.2 不适合优先使用触发器的情况
+命令：
 
-- 需要按天、按周、按月跑批
-- 需要扫描大量历史数据做修复
-- 需要复杂重试或长链路集成补偿
-- 逻辑更像一个可复用服务，不只被一个触发器调用
-- 更偏页面交互、输入反馈、展示控制
-- 只是一个手动动作，不需要记录事件自动触发
+```bash
+cloudcc create triggers <encodedCreateJson>
+```
+
+`encodedCreateJson`（先 JSON.stringify，再 encodeURI）推荐字段：
+
+| 字段              | 必填 | 类型     | 说明                                                   |
+| ----------------- | ---- | -------- | ------------------------------------------------------ |
+| `schemetableName` | 是   | `string` | 目标对象 API 名（目录中会转小写）                      |
+| `targetObjectId`  | 是   | `string` | 目标对象 ID                                            |
+| `triggerTime`     | 是   | `string` | 触发时机，如 `beforeInsert`、`afterUpdate`、`approval` |
+| `name`            | 是   | `string` | 触发器名称                                             |
+| `apiname`         | 建议 | `string` | 触发器 API 名                                          |
+
+#### 2) 发布触发器
+
+命令：
+
+```bash
+cloudcc publish triggers <namePath>
+```
+
+参数：
+
+| 参数       | 必填 | 类型     | 说明                                    |
+| ---------- | ---- | -------- | --------------------------------------- |
+| `namePath` | 是   | `string` | 触发器路径，格式：`对象小写名/触发器名` |
+
+#### 3) 拉取触发器（按本地路径）
+
+命令：
+
+```bash
+cloudcc pull triggers <namePath>
+```
+
+参数：
+
+| 参数       | 必填 | 类型     | 说明                                                                             |
+| ---------- | ---- | -------- | -------------------------------------------------------------------------------- |
+| `namePath` | 是   | `string` | 触发器路径，格式：`对象小写名/触发器名`；会读取该目录 `config.json` 的 `id` 拉取 |
+
+#### 4) 查询触发器列表（支持条件查询）
+
+命令：
+
+```bash
+cloudcc get triggers <listQueryJson> [projectPath]
+```
+
+`listQueryJson` 推荐结构：
+
+```json
+{
+    "shownum": 2000,
+    "showpage": 1,
+    "sname": "",
+    "rptcond": "",
+    "rptorder": "",
+    "objId": ""
+}
+```
+
+字段语义：
+
+| 字段       | 含义              | 类型     | 是否推荐 | 说明                     |
+| ---------- | ----------------- | -------- | -------- | ------------------------ |
+| `shownum`  | 每页条数          | `number  | string`  | 推荐                     |
+| `showpage` | 页码              | `number  | string`  | 推荐                     |
+| `sname`    | 触发器名字        | `string` | 可选     | 按名称模糊筛选，模糊查询 |
+| `objId`    | 触发器作用对象 ID | `string` | 可选     | 对象id（对象筛选优先用该字段） |
+
+#### 5) 查看触发器详情
+
+命令：
+
+```bash
+cloudcc detail triggers <namePath> <id>
+```
+
+参数规则（实现口径）：
+
+| 参数       | 必填     | 类型     | 说明                                             |
+| ---------- | -------- | -------- | ------------------------------------------------ |
+| `namePath` | 条件必填 | `string` | 传 `namePath` 时优先查本地；本地不完整时再走线上 |
+| `id`       | 条件必填 | `string` | 当 `namePath` 为空时，必须传 `id` 走线上查询     |
+
+等价理解：`namePath` 与 `id` 至少传一个，优先使用 `namePath` 路径。
+
+#### 6) 按 ID 拉取并落地到本地目录
+
+命令：
+
+```bash
+cloudcc pullList triggers <id> <projectPath>
+```
+
+参数：
+
+| 参数          | 必填 | 类型     | 说明                                                        |
+| ------------- | ---- | -------- | ----------------------------------------------------------- |
+| `id`          | 是   | `string` | 线上触发器 ID                                               |
+| `projectPath` | 是   | `string` | 项目根目录；会写入到 `<projectPath>/triggers/<obj>/<name>/` |
+
+#### 7) 删除触发器
+
+命令：
+
+```bash
+cloudcc delete triggers <namePathOrId> [projectPath]
+```
+
+参数规则：
+
+| 参数           | 必填 | 类型     | 说明                                                                                  |
+| -------------- | ---- | -------- | ------------------------------------------------------------------------------------- |
+| `namePathOrId` | 是   | `string` | 可传触发器路径或线上 ID；若本地路径存在且 `config.json` 含 `id`，优先使用该 `id` 删除 |
+| `projectPath`  | 否   | `string` | 项目根目录，默认当前目录                                                              |
+
+#### 8) 文档命令
+
+命令：
+
+```bash
+cloudcc doc triggers <introduction|devguide>
+```
 
-### 4.3 AI 的默认选型规则
+参数：
 
-- 单条记录实时事件，用触发器
-- 可复用核心逻辑，下沉到自定义类
-- 周期批处理，用定时器
-- 页面交互，用页面脚本或组件
+| 参数          | 必填      | 类型 | 说明     |
+| ------------- | --------- | ---- | -------- |
+| `introduction | devguide` | 是   | `string` |
 
 ## 5. 当前项目中触发器的真实约束
 
@@ -230,7 +347,8 @@ AI 不能默认“更新一下没事”。
 
 ## 8. SDK 使用规范
 
-本节是本文的核心。以下 API 说明基于官方 SDK 页面整理，并专门补成“AI 可直接使用”的格式。
+本节是本文的核心。以下 API 说明基于官方 SDK 页面整理，并专门补成“AI
+可直接使用”的格式。
 
 写法原则：
 
@@ -258,18 +376,18 @@ public CCObject(String ccobj, String isShared)
 
 参数说明：
 
-| 方法 | 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- | --- |
-| `CCObject(String ccobj)` | `ccobj` | `String` | 是 | 对象 API | 传对象 API 名，如 `Account`、`Opportunity` |
-| `CCObject(String ccobj, String isShared)` | `ccobj` | `String` | 是 | 对象 API | 用于共享对象 |
-| `CCObject(String ccobj, String isShared)` | `isShared` | `String` | 是 | 共享标识，建议使用 `CCObject.IS_SHARED` | 不要手写魔法值，优先常量 |
+| 方法                                      | 参数       | 类型     | 是否必填 | 官方说明                                | AI 使用说明                                |
+| ----------------------------------------- | ---------- | -------- | -------- | --------------------------------------- | ------------------------------------------ |
+| `CCObject(String ccobj)`                  | `ccobj`    | `String` | 是       | 对象 API                                | 传对象 API 名，如 `Account`、`Opportunity` |
+| `CCObject(String ccobj, String isShared)` | `ccobj`    | `String` | 是       | 对象 API                                | 用于共享对象                               |
+| `CCObject(String ccobj, String isShared)` | `isShared` | `String` | 是       | 共享标识，建议使用 `CCObject.IS_SHARED` | 不要手写魔法值，优先常量                   |
 
 常量字段：
 
-| 字段 | 类型 | 默认值 | 说明 |
-| --- | --- | --- | --- |
+| 字段         | 类型     | 默认值        | 说明          |
+| ------------ | -------- | ------------- | ------------- |
 | `OBJECT_API` | `String` | `CCObjectAPI` | 对象 API 常量 |
-| `IS_SHARED` | `String` | `isShared` | 共享对象常量 |
+| `IS_SHARED`  | `String` | `isShared`    | 共享对象常量  |
 
 #### 8.1.2 常用方法
 
@@ -282,17 +400,17 @@ public String put(String apiName, String value)
 
 参数说明：
 
-| 方法 | 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- | --- |
-| `put` | `apiName` | `String` | 是 | 字段 APIName | 必须传字段 API 名，不要传字段显示名 |
-| `put` | `value` | `String` | 是 | 字段值 | 官方示例按字符串传；AI 应按当前项目已有写法与 SDK 能力处理值类型 |
+| 方法  | 参数      | 类型     | 是否必填 | 官方说明     | AI 使用说明                                                      |
+| ----- | --------- | -------- | -------- | ------------ | ---------------------------------------------------------------- |
+| `put` | `apiName` | `String` | 是       | 字段 APIName | 必须传字段 API 名，不要传字段显示名                              |
+| `put` | `value`   | `String` | 是       | 字段值       | 官方示例按字符串传；AI 应按当前项目已有写法与 SDK 能力处理值类型 |
 
 返回值说明：
 
-| 方法 | 返回类型 | 含义 |
-| --- | --- | --- |
-| `getObjectApiName` | `String` | 当前对象 API 名 |
-| `put` | `String` | `HashMap` 风格返回值；在触发器里通常不依赖其返回值 |
+| 方法               | 返回类型 | 含义                                               |
+| ------------------ | -------- | -------------------------------------------------- |
+| `getObjectApiName` | `String` | 当前对象 API 名                                    |
+| `put`              | `String` | `HashMap` 风格返回值；在触发器里通常不依赖其返回值 |
 
 AI 使用规则：
 
@@ -324,15 +442,16 @@ public String getRoleId()
 
 返回值说明：
 
-| 方法 | 返回类型 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- |
+| 方法        | 返回类型 | 官方说明                       | AI 使用说明          |
+| ----------- | -------- | ------------------------------ | -------------------- |
 | `getUserId` | `String` | 当前用户 ID，未设置返回 `null` | 适合做当前操作人识别 |
-| `getOrgId` | `String` | 当前组织 ID，未设置返回 `null` | 适合做组织级逻辑判断 |
-| `getRoleId` | `String` | 当前角色 ID，未设置返回 `null` | 适合做角色权限判断 |
+| `getOrgId`  | `String` | 当前组织 ID，未设置返回 `null` | 适合做组织级逻辑判断 |
+| `getRoleId` | `String` | 当前角色 ID，未设置返回 `null` | 适合做角色权限判断   |
 
 AI 使用规则：
 
-- `CCService`、`SendEmail`、`DevLogger`、`TimeUtil` 都应围绕 `userInfo` 构造或调用
+- `CCService`、`SendEmail`、`DevLogger`、`TimeUtil` 都应围绕 `userInfo`
+  构造或调用
 - 不要硬编码用户、组织、角色信息替代 `userInfo`
 
 ### 8.3 `CCService` 详细说明
@@ -352,9 +471,9 @@ public CCService(UserInfo userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 | 必须传当前上下文用户 |
+| 参数       | 类型       | 是否必填 | 官方说明 | AI 使用说明          |
+| ---------- | ---------- | -------- | -------- | -------------------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 | 必须传当前上下文用户 |
 
 #### 8.3.2 `insert`
 
@@ -366,9 +485,9 @@ public ServiceResult insert(CCObject ccobj) throws BusiException
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `ccobj` | `CCObject` | 是 | CC 对象 | 用于新增单条记录 |
+| 参数    | 类型       | 是否必填 | 官方说明 | AI 使用说明      |
+| ------- | ---------- | -------- | -------- | ---------------- |
+| `ccobj` | `CCObject` | 是       | CC 对象  | 用于新增单条记录 |
 
 返回值：
 
@@ -397,14 +516,14 @@ public List<CCObject> cquery(String apiName, String condtion, boolean isDataObje
 
 参数说明：
 
-| 方法 | 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- | --- |
-| `cquery(apiName, condtion, order)` | `apiName` | `String` | 是 | 对象 APIName | 必传对象 API |
-| `cquery(apiName, condtion, order)` | `condition` | `String` | 否 | 使用字段 APIName 查询，自定义字段一定要加 `__c`；无条件则查全部 | 必须收窄条件，避免全表查 |
-| `cquery(apiName, condtion, order)` | `order` | `String` | 否 | 使用字段 APIName 排序，自定义字段一定要加 `__c` | 只在确实需要排序时传 |
-| `cquery(apiName, condtion, isDataObject)` | `apiName` | `String` | 是 | 对象 APIName | 必传对象 API |
-| `cquery(apiName, condtion, isDataObject)` | `condtion` | `String` | 否 | 同上 | 自定义字段记得 `__c` |
-| `cquery(apiName, condtion, isDataObject)` | `isDataObject` | `Boolean` | 否 | `true` 查普通数据，`false` 查共享数据 | 不要混淆普通对象和共享对象口径 |
+| 方法                                      | 参数           | 类型      | 是否必填 | 官方说明                                                        | AI 使用说明                    |
+| ----------------------------------------- | -------------- | --------- | -------- | --------------------------------------------------------------- | ------------------------------ |
+| `cquery(apiName, condtion, order)`        | `apiName`      | `String`  | 是       | 对象 APIName                                                    | 必传对象 API                   |
+| `cquery(apiName, condtion, order)`        | `condition`    | `String`  | 否       | 使用字段 APIName 查询，自定义字段一定要加 `__c`；无条件则查全部 | 必须收窄条件，避免全表查       |
+| `cquery(apiName, condtion, order)`        | `order`        | `String`  | 否       | 使用字段 APIName 排序，自定义字段一定要加 `__c`                 | 只在确实需要排序时传           |
+| `cquery(apiName, condtion, isDataObject)` | `apiName`      | `String`  | 是       | 对象 APIName                                                    | 必传对象 API                   |
+| `cquery(apiName, condtion, isDataObject)` | `condtion`     | `String`  | 否       | 同上                                                            | 自定义字段记得 `__c`           |
+| `cquery(apiName, condtion, isDataObject)` | `isDataObject` | `Boolean` | 否       | `true` 查普通数据，`false` 查共享数据                           | 不要混淆普通对象和共享对象口径 |
 
 返回值：
 
@@ -432,10 +551,10 @@ public List<CCObject> cqlQuery(String apiName, String cql) throws Exception
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `apiName` | `String` | 是 | 对象 APIName | 必传主对象 API |
-| `cql` | `String` | 否 | SQL 语句，支持常用 `where` 条件 | 适用于聚合、复杂过滤；避免无边界 `select *` |
+| 参数      | 类型     | 是否必填 | 官方说明                        | AI 使用说明                                 |
+| --------- | -------- | -------- | ------------------------------- | ------------------------------------------- |
+| `apiName` | `String` | 是       | 对象 APIName                    | 必传主对象 API                              |
+| `cql`     | `String` | 否       | SQL 语句，支持常用 `where` 条件 | 适用于聚合、复杂过滤；避免无边界 `select *` |
 
 返回值：
 
@@ -463,9 +582,9 @@ public ServiceResult update(CCObject ccobj) throws Exception
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `ccobj` | `CCObject` | 是 | CC 对象 | 修改记录时必须带 `id` |
+| 参数    | 类型       | 是否必填 | 官方说明 | AI 使用说明           |
+| ------- | ---------- | -------- | -------- | --------------------- |
+| `ccobj` | `CCObject` | 是       | CC 对象  | 修改记录时必须带 `id` |
 
 返回值：
 
@@ -493,9 +612,9 @@ public ServiceResult delete(CCObject ccobj) throws Exception
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `ccobj` | `CCObject` | 是 | CC 对象 | 删除记录时通常必须带 `id` |
+| 参数    | 类型       | 是否必填 | 官方说明 | AI 使用说明               |
+| ------- | ---------- | -------- | -------- | ------------------------- |
+| `ccobj` | `CCObject` | 是       | CC 对象  | 删除记录时通常必须带 `id` |
 
 返回值：
 
@@ -523,10 +642,10 @@ public void deleteShareObjectBySql(String objectApiName, String expression) thro
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `objectApiName` | `String` | 是 | 对象 APIName | 共享对象 API |
-| `expression` | `String` | 是 | SQL 表达式，字段不需要加 `__c` | 这是共享删除的关键差异点 |
+| 参数            | 类型     | 是否必填 | 官方说明                       | AI 使用说明              |
+| --------------- | -------- | -------- | ------------------------------ | ------------------------ |
+| `objectApiName` | `String` | 是       | 对象 APIName                   | 共享对象 API             |
+| `expression`    | `String` | 是       | SQL 表达式，字段不需要加 `__c` | 这是共享删除的关键差异点 |
 
 返回值：
 
@@ -555,13 +674,13 @@ public Map getCustomSetting(String objectApiName, String id)
 
 参数说明：
 
-| 方法 | 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- | --- |
-| `getListCustomSetting(String objectApiName)` | `objectApiName` | `String` | 是 | 对象 APIName | 返回某个列表型自定义设置的全部数据 |
-| `getListCustomSetting(String apiName, String name)` | `apiName` | `String` | 是 | 对象 APIName | 取列表型自定义设置中的单条 |
-| `getListCustomSetting(String apiName, String name)` | `name` | `String` | 是 | 自定义设置属性名称 | 通过名称定位单条配置 |
-| `getCustomSetting(String objectApiName, String id)` | `objectApiName` | `String` | 是 | 对象 APIName | 用于层次结构型自定义设置 |
-| `getCustomSetting(String objectApiName, String id)` | `id` | `String` | 是 | 简档 id 或用户 id | 按权限上下文取配置 |
+| 方法                                                | 参数            | 类型     | 是否必填 | 官方说明           | AI 使用说明                        |
+| --------------------------------------------------- | --------------- | -------- | -------- | ------------------ | ---------------------------------- |
+| `getListCustomSetting(String objectApiName)`        | `objectApiName` | `String` | 是       | 对象 APIName       | 返回某个列表型自定义设置的全部数据 |
+| `getListCustomSetting(String apiName, String name)` | `apiName`       | `String` | 是       | 对象 APIName       | 取列表型自定义设置中的单条         |
+| `getListCustomSetting(String apiName, String name)` | `name`          | `String` | 是       | 自定义设置属性名称 | 通过名称定位单条配置               |
+| `getCustomSetting(String objectApiName, String id)` | `objectApiName` | `String` | 是       | 对象 APIName       | 用于层次结构型自定义设置           |
+| `getCustomSetting(String objectApiName, String id)` | `id`            | `String` | 是       | 简档 id 或用户 id  | 按权限上下文取配置                 |
 
 返回值：
 
@@ -597,9 +716,9 @@ public SendEmail(UserInfo userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 | 用当前上下文发送邮件 |
+| 参数       | 类型       | 是否必填 | 官方说明 | AI 使用说明          |
+| ---------- | ---------- | -------- | -------- | -------------------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 | 用当前上下文发送邮件 |
 
 #### 8.4.2 `sendMailFromSystem`
 
@@ -617,14 +736,14 @@ public boolean sendMailFromSystem(
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `toAddress` | `String[]` | 是 | 收件箱 | 没有收件人不要发送 |
-| `ccAddress` | `String[]` | 是 | 抄送人 | 没有可传空数组 |
-| `bccAddress` | `String[]` | 是 | 密送人 | 没有可传空数组 |
-| `subject` | `String` | 是 | 邮件标题 | 标题要能表达业务动作 |
-| `content` | `String` | 是 | 邮件内容 | HTML 内容要控制复杂度 |
-| `isText` | `boolean` | 是 | 是否采用 TXT 方式发送；`false` 为 HTML | HTML 邮件常用 `false` |
+| 参数         | 类型       | 是否必填 | 官方说明                               | AI 使用说明           |
+| ------------ | ---------- | -------- | -------------------------------------- | --------------------- |
+| `toAddress`  | `String[]` | 是       | 收件箱                                 | 没有收件人不要发送    |
+| `ccAddress`  | `String[]` | 是       | 抄送人                                 | 没有可传空数组        |
+| `bccAddress` | `String[]` | 是       | 密送人                                 | 没有可传空数组        |
+| `subject`    | `String`   | 是       | 邮件标题                               | 标题要能表达业务动作  |
+| `content`    | `String`   | 是       | 邮件内容                               | HTML 内容要控制复杂度 |
+| `isText`     | `boolean`  | 是       | 是否采用 TXT 方式发送；`false` 为 HTML | HTML 邮件常用 `false` |
 
 返回值：
 
@@ -651,13 +770,13 @@ public ServiceResult sendEmailNew(
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `emailtemplateid` | `String` | 是 | 邮件模版 id | 优先模板化发送 |
-| `toaddress` | `String[]` | 是 | 收件箱 | 传收件人数组 |
-| `ccaddress` | `String[]` | 是 | 抄送人 | 没有可传空数组 |
-| `bcaddress` | `String[]` | 是 | 密送人 | 官方签名为 `bcaddress`，按签名使用 |
-| `id` | `String` | 是 | 官方文档仅给出 `id` | 结合方法语义，AI 应将其视为模板填充关联记录 ID；此处为基于官方方法名与示例的推断 |
+| 参数              | 类型       | 是否必填 | 官方说明            | AI 使用说明                                                                      |
+| ----------------- | ---------- | -------- | ------------------- | -------------------------------------------------------------------------------- |
+| `emailtemplateid` | `String`   | 是       | 邮件模版 id         | 优先模板化发送                                                                   |
+| `toaddress`       | `String[]` | 是       | 收件箱              | 传收件人数组                                                                     |
+| `ccaddress`       | `String[]` | 是       | 抄送人              | 没有可传空数组                                                                   |
+| `bcaddress`       | `String[]` | 是       | 密送人              | 官方签名为 `bcaddress`，按签名使用                                               |
+| `id`              | `String`   | 是       | 官方文档仅给出 `id` | 结合方法语义，AI 应将其视为模板填充关联记录 ID；此处为基于官方方法名与示例的推断 |
 
 返回值：
 
@@ -684,9 +803,9 @@ public DevLogger(UserInfo userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 | 用当前上下文记录日志 |
+| 参数       | 类型       | 是否必填 | 官方说明 | AI 使用说明          |
+| ---------- | ---------- | -------- | -------- | -------------------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 | 用当前上下文记录日志 |
 
 #### 8.5.2 `devLogInfo`
 
@@ -698,9 +817,9 @@ public void devLogInfo(String info)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `info` | `String` | 是 | 日志信息 | 记录关键主键、关键分支、关键动作 |
+| 参数   | 类型     | 是否必填 | 官方说明 | AI 使用说明                      |
+| ------ | -------- | -------- | -------- | -------------------------------- |
+| `info` | `String` | 是       | 日志信息 | 记录关键主键、关键分支、关键动作 |
 
 返回值：
 
@@ -716,10 +835,10 @@ public void devLogError(String error, Throwable throwable)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `error` | `String` | 是 | 日志信息 | 错误信息必须包含业务上下文 |
-| `throwable` | `Throwable` | 否 | 异常对象 | 有异常时尽量带上 |
+| 参数        | 类型        | 是否必填 | 官方说明 | AI 使用说明                |
+| ----------- | ----------- | -------- | -------- | -------------------------- |
+| `error`     | `String`    | 是       | 日志信息 | 错误信息必须包含业务上下文 |
+| `throwable` | `Throwable` | 否       | 异常对象 | 有异常时尽量带上           |
 
 返回值：
 
@@ -737,7 +856,8 @@ AI 使用规则：
 类说明：
 
 - 官方说明：`Date` 和 `Calendar` 默认基于本地时区，跨时区处理容易出错
-- 作用：所有和当前时间、用户时区、格式化、Calendar 相关的逻辑，都应优先走 `TimeUtil`
+- 作用：所有和当前时间、用户时区、格式化、Calendar 相关的逻辑，都应优先走
+  `TimeUtil`
 
 #### 8.6.1 `getNowDate`
 
@@ -750,9 +870,9 @@ task.setBeginTime(TimeUtil.getNowDate(userInfo));
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 |
-| --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 |
+| 参数       | 类型       | 是否必填 | 官方说明 |
+| ---------- | ---------- | -------- | -------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 |
 
 AI 使用规则：
 
@@ -768,9 +888,9 @@ TimeUtil.getUserTimeZone(userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 |
-| --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 |
+| 参数       | 类型       | 是否必填 | 官方说明 |
+| ---------- | ---------- | -------- | -------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 |
 
 AI 使用规则：
 
@@ -786,10 +906,10 @@ SimpleDateFormat myDateFormat = TimeUtil.getSimpleDateFormat(format, userInfo);
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 默认值 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- | --- |
-| `format` | `String` | 是 | `"yyyy-MM-dd"` | 格式化 | 显式传格式串 |
-| `userInfo` | `UserInfo` | 是 | - | 用户对象 | 用用户时区创建格式化器 |
+| 参数       | 类型       | 是否必填 | 默认值         | 官方说明 | AI 使用说明            |
+| ---------- | ---------- | -------- | -------------- | -------- | ---------------------- |
+| `format`   | `String`   | 是       | `"yyyy-MM-dd"` | 格式化   | 显式传格式串           |
+| `userInfo` | `UserInfo` | 是       | -              | 用户对象 | 用用户时区创建格式化器 |
 
 #### 8.6.4 `getCalendar`
 

package/src/triggers/get.js

@@ -3,6 +3,13 @@ const { postClass } = require("../../utils/http")
 
 /**
  * cloudcc get triggers <listQueryJson> [projectPath]
+ * listQueryJson 字段说明：
+ * - shownum: 每页条数
+ * - showpage: 页码
+ * - sname: 触发器名字
+ * - objId: 触发器作用对象 ID（对象筛选请优先使用此字段）
+ * - rptcond: 额外筛选条件
+ * - rptorder: 排序条件
  * @param {string[]} argvs
  */
 async function get(argvs, isMcp = false) {

package/src/version/doctor.js

@@ -11,12 +11,19 @@ function doctor() {
   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")
+  const jsonPath = path.join(cwd, "cloudcc-cli.config.json")
+  const jsPath = path.join(cwd, "cloudcc-cli.config.js")
+  const hasJson = fs.existsSync(jsonPath)
+  const hasJs = fs.existsSync(jsPath)
+  if (hasJson || hasJs) {
+    const parts = []
+    if (hasJson) parts.push("cloudcc-cli.config.json")
+    if (hasJs) parts.push("cloudcc-cli.config.js")
+    console.error(chalk.green("✓") + " 当前目录存在 " + parts.join("、"))
   } else {
     console.error(
-      chalk.yellow("○") + " 当前目录未找到 cloudcc-cli.config.js（若在本目录开发 CloudCC 项目，请先初始化或放入配置）"
+      chalk.yellow("○") +
+        " 当前目录未找到 cloudcc-cli.config.json / cloudcc-cli.config.js（若在本目录开发 CloudCC 项目，请先初始化或放入配置）"
     )
   }
   console.error()