cloudcc-cli 2.4.0 → 2.4.1

package/README.md

@@ -71,6 +71,24 @@ Resolve the script path on macOS/Linux with:
 echo "$(npm root -g)/cloudcc-cli/bin/mcp.js"
 ```
 
+# 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/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.1",
   "description": "cloudcc-cli",
   "author": "cloudcc",
   "license": "ISC",

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/script/docs/devguide.md

@@ -55,9 +55,12 @@ cloudcc get script <encodedCondJson> <projectPath>
 | condition | object | 非必须 | `{}` | 查询条件 |
 | condition.scriptName | string | 非必须 | `""` | 脚本名称筛选 |
 | condition.pageLabel | string | 非必须 | `""` | 页面标签筛选 |
-| condition.objName | string | 非必须 | `""` | 对象名称筛选 |
+| condition.objName | string | 非必须 | `""` | 对象名称label筛选（例如你说“客户对象”，就传 `客户`；不要让 AI 自动映射成 `account`） |
 
-输出：简化列表（每条包含 `name` / `id` / `apiname`）。
+
+> 注意：`objName` 直接按你要查询的对象名称来传，并按实际值原样传入。  
+> 例如对象名称是 `客户`、`客户004`，就直接传 `客户`、`客户004`；**不要**按语义自动换成 `account`。  
+> 如果返回为空，通常意味着目标环境里的对象名称不是你传的这个值（可以去对象管理里看一下该对象的名称/标识）。
 
 ---
 
@@ -177,6 +180,23 @@ cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50
 cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'test',pageLabel:'',objName:''}})))")" .
 ```
 
+### 按对象名称筛选（示例：`客户` / `客户004`）
+
+```bash
+# 对象名称为“客户”
+cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'',pageLabel:'',objName:'客户'}})))")" .
+
+# 对象名称为“客户004”
+cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'',pageLabel:'',objName:'客户004'}})))")" .
+```
+
+错误示例（不要这样传）：
+
+```bash
+# 业务上说“客户”，就不要自作主张写成 account
+cloudcc get script "$(node -e "console.log(encodeURI(JSON.stringify({pageSize:50,pageNo:1,condition:{scriptName:'',pageLabel:'',objName:'account'}})))")" .
+```
+
 ### 新建脚本（本地）
 
 ```bash

package/src/timer/docs/devguide.md

@@ -18,38 +18,16 @@
 - `2-timer-classes-analysis.md` 提供当前项目定时器使用场景和共性模式
 - `timer devguide` 提供本地目录、CLI、发布和 SOURCE 区域约束
 
-## 3. 先判断：是不是应该写成定时器类
+## 3. 与 introduction 的分工（避免重复）
 
-AI 在动手写代码前，必须先判断需求是否真的适合用定时器类。
+为避免与 `timer introduction` 内容重复，本 `devguide` 只保留“开发落地规范”：
 
-### 3.1 适合定时器类的情况
+- 命令与入参（可直接执行）
+- 目录与文件约束（可直接检查）
+- SDK 用法与边界（可直接编码）
+- 代码模板与禁止事项（可直接评审）
 
-- 任务按时间触发，而不是按单条记录实时触发
-- 需要每天、每周、每月、月初、月末执行
-- 需要批量扫描一批记录并统一处理
-- 需要失败补偿、周期重试或后台巡检
-- 需要构建底表、看板、台账、报表支撑数据
-- 需要在满足条件后自动提醒、自动推进、自动同步
-
-### 3.2 不适合定时器类的情况
-
-- 记录保存时必须立刻校验或立刻拦截
-- 单笔数据变化后必须在同一事务里马上联动
-- 高度依赖前端交互、人工确认、页面反馈
-- 只是一次性临时数据处理，不需要长期调度
-
-### 3.3 当前项目中定时器的六大主类型
-
-根据现有项目总结，AI 应优先将需求归入以下类型之一：
-
-- 提醒通知类
-- 同步推送集成类
-- 刷新更新修正类
-- 报表底表支撑类
-- 自动生成派生类
-- 权限共享治理类
-
-如果需求明显不属于上述类型，AI 应重新评估是否真的应该落到定时器类。
+“定时器是什么、能解决什么、与触发器差异、适用/不适用场景”等概念说明，统一以 `cloudcc doc timer introduction` 为准。
 
 ## 4. 文件与交付规范
 
@@ -75,6 +53,217 @@ AI 在动手写代码前，必须先判断需求是否真的适合用定时器
 - 让类继承 `CCSchedule`
 - 构造方法名与类名一致
 
+### 4.4 timer 模块支持的 CLI 命令总览（重点：入参）
+
+说明：
+
+- 下文命令中的资源名使用 `timer`，也可使用别名 `schedule`（两者路由到同一模块）。
+- `projectPath` 未传时，默认使用当前工作目录。
+
+#### 1) 创建定时类
+
+命令：
+
+```bash
+cloudcc create timer <name>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 是 | `string` | 定时类名称（同时作为目录名、Java 类名） |
+
+示例：
+
+```bash
+cloudcc create timer DailySyncJob
+```
+
+---
+
+#### 2) 发布定时类
+
+命令：
+
+```bash
+cloudcc publish timer <name>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 是 | `string` | 本地 `schedule/<name>/` 目录名 |
+
+示例：
+
+```bash
+cloudcc publish timer DailySyncJob
+```
+
+---
+
+#### 3) 拉取定时类（按本地名称）
+
+命令：
+
+```bash
+cloudcc pull timer <name>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 是 | `string` | 本地 `schedule/<name>/` 目录名；会读取该目录 `config.json` 中的 `id` 到线上拉取 |
+
+示例：
+
+```bash
+cloudcc pull timer DailySyncJob
+```
+
+---
+
+#### 4) 查询定时类列表（支持条件查询）
+
+命令：
+
+```bash
+cloudcc get timer [listQueryJson] [projectPath]
+```
+
+`listQueryJson` 推荐结构：
+
+```json
+{
+    "shownum": 2000,
+    "showpage": 1,
+    "sname": "",
+}
+```
+
+字段说明：
+
+| 字段 | 类型 | 必填 | 说明 |
+| --- | --- | --- | --- |
+| `shownum` | `number|string` | 否 | 每页条数，默认 `2000` |
+| `showpage` | `number|string` | 否 | 页码，默认 `1` |
+| `sname` | `string` | 否 | 名称筛选关键字，模糊查询 |
+
+示例：
+
+```bash
+cloudcc get timer "$(node -e 'console.log(encodeURI(JSON.stringify({shownum:2000,showpage:1,fid:\"\",sname:\"Daily\",rptcond:\"\",rptorder:\"\"})))')"
+```
+
+---
+
+#### 5) 查看定时类详情
+
+命令：
+
+```bash
+cloudcc detail timer <name> <id>
+```
+
+参数规则（实现口径）：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `name` | 条件必填 | `string` | 传 `name` 时优先查本地；本地不完整时再走线上 |
+| `id` | 条件必填 | `string` | 当 `name` 为空时，必须传 `id` 走线上查询 |
+
+等价理解：`name` 与 `id` 至少传一个，优先使用 `name` 路径。
+
+示例（按本地名）：
+
+```bash
+cloudcc detail timer DailySyncJob
+```
+
+示例（按线上 id）：
+
+```bash
+cloudcc detail timer "" a0Bxxxxxxxxxxxx
+```
+
+---
+
+#### 6) 按 ID 拉取并落地到本地目录
+
+命令：
+
+```bash
+cloudcc pullList timer <id> <projectPath>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `id` | 是 | `string` | 线上定时类 ID |
+| `projectPath` | 是 | `string` | 项目根目录；会写入到 `<projectPath>/schedule/<name>/` |
+
+示例：
+
+```bash
+cloudcc pullList timer a0Bxxxxxxxxxxxx /path/to/project
+```
+
+---
+
+#### 7) 删除定时类
+
+命令：
+
+```bash
+cloudcc delete timer <nameOrId> [projectPath]
+```
+
+参数规则：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `nameOrId` | 是 | `string` | 可传本地目录名或线上 ID；若本地 `schedule/<nameOrId>/config.json` 存在且带 `id`，优先使用其中 `id` 删除 |
+| `projectPath` | 否 | `string` | 项目根目录，默认当前目录 |
+
+示例（按名称）：
+
+```bash
+cloudcc delete timer DailySyncJob
+```
+
+示例（按 id）：
+
+```bash
+cloudcc delete timer a0Bxxxxxxxxxxxx
+```
+
+---
+
+#### 8) 文档命令
+
+命令：
+
+```bash
+cloudcc doc timer <introduction|devguide>
+```
+
+参数：
+
+| 参数 | 必填 | 类型 | 说明 |
+| --- | --- | --- | --- |
+| `introduction|devguide` | 是 | `string` | `introduction` 返回概念文档；`devguide` 返回开发规范（并附 SDK 速查） |
+
+示例：
+
+```bash
+cloudcc doc timer introduction
+cloudcc doc timer devguide
+```
+
 ## 5. AI 编写定时器类的核心原则
 
 ### 5.1 先分析，再编码

package/src/triggers/docs/devguide.md

@@ -25,50 +25,168 @@
 
 ## 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,
+    "fid": "",
+    "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 +348,8 @@ AI 不能默认“更新一下没事”。
 
 ## 8. SDK 使用规范
 
-本节是本文的核心。以下 API 说明基于官方 SDK 页面整理，并专门补成“AI 可直接使用”的格式。
+本节是本文的核心。以下 API 说明基于官方 SDK 页面整理，并专门补成“AI
+可直接使用”的格式。
 
 写法原则：
 
@@ -258,18 +377,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 +401,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 +443,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 +472,9 @@ public CCService(UserInfo userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 | 必须传当前上下文用户 |
+| 参数       | 类型       | 是否必填 | 官方说明 | AI 使用说明          |
+| ---------- | ---------- | -------- | -------- | -------------------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 | 必须传当前上下文用户 |
 
 #### 8.3.2 `insert`
 
@@ -366,9 +486,9 @@ public ServiceResult insert(CCObject ccobj) throws BusiException
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `ccobj` | `CCObject` | 是 | CC 对象 | 用于新增单条记录 |
+| 参数    | 类型       | 是否必填 | 官方说明 | AI 使用说明      |
+| ------- | ---------- | -------- | -------- | ---------------- |
+| `ccobj` | `CCObject` | 是       | CC 对象  | 用于新增单条记录 |
 
 返回值：
 
@@ -397,14 +517,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 +552,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 +583,9 @@ public ServiceResult update(CCObject ccobj) throws Exception
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `ccobj` | `CCObject` | 是 | CC 对象 | 修改记录时必须带 `id` |
+| 参数    | 类型       | 是否必填 | 官方说明 | AI 使用说明           |
+| ------- | ---------- | -------- | -------- | --------------------- |
+| `ccobj` | `CCObject` | 是       | CC 对象  | 修改记录时必须带 `id` |
 
 返回值：
 
@@ -493,9 +613,9 @@ public ServiceResult delete(CCObject ccobj) throws Exception
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `ccobj` | `CCObject` | 是 | CC 对象 | 删除记录时通常必须带 `id` |
+| 参数    | 类型       | 是否必填 | 官方说明 | AI 使用说明               |
+| ------- | ---------- | -------- | -------- | ------------------------- |
+| `ccobj` | `CCObject` | 是       | CC 对象  | 删除记录时通常必须带 `id` |
 
 返回值：
 
@@ -523,10 +643,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 +675,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 +717,9 @@ public SendEmail(UserInfo userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 | 用当前上下文发送邮件 |
+| 参数       | 类型       | 是否必填 | 官方说明 | AI 使用说明          |
+| ---------- | ---------- | -------- | -------- | -------------------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 | 用当前上下文发送邮件 |
 
 #### 8.4.2 `sendMailFromSystem`
 
@@ -617,14 +737,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 +771,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 +804,9 @@ public DevLogger(UserInfo userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 | 用当前上下文记录日志 |
+| 参数       | 类型       | 是否必填 | 官方说明 | AI 使用说明          |
+| ---------- | ---------- | -------- | -------- | -------------------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 | 用当前上下文记录日志 |
 
 #### 8.5.2 `devLogInfo`
 
@@ -698,9 +818,9 @@ public void devLogInfo(String info)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `info` | `String` | 是 | 日志信息 | 记录关键主键、关键分支、关键动作 |
+| 参数   | 类型     | 是否必填 | 官方说明 | AI 使用说明                      |
+| ------ | -------- | -------- | -------- | -------------------------------- |
+| `info` | `String` | 是       | 日志信息 | 记录关键主键、关键分支、关键动作 |
 
 返回值：
 
@@ -716,10 +836,10 @@ public void devLogError(String error, Throwable throwable)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 | AI 使用说明 |
-| --- | --- | --- | --- | --- |
-| `error` | `String` | 是 | 日志信息 | 错误信息必须包含业务上下文 |
-| `throwable` | `Throwable` | 否 | 异常对象 | 有异常时尽量带上 |
+| 参数        | 类型        | 是否必填 | 官方说明 | AI 使用说明                |
+| ----------- | ----------- | -------- | -------- | -------------------------- |
+| `error`     | `String`    | 是       | 日志信息 | 错误信息必须包含业务上下文 |
+| `throwable` | `Throwable` | 否       | 异常对象 | 有异常时尽量带上           |
 
 返回值：
 
@@ -737,7 +857,8 @@ AI 使用规则：
 类说明：
 
 - 官方说明：`Date` 和 `Calendar` 默认基于本地时区，跨时区处理容易出错
-- 作用：所有和当前时间、用户时区、格式化、Calendar 相关的逻辑，都应优先走 `TimeUtil`
+- 作用：所有和当前时间、用户时区、格式化、Calendar 相关的逻辑，都应优先走
+  `TimeUtil`
 
 #### 8.6.1 `getNowDate`
 
@@ -750,9 +871,9 @@ task.setBeginTime(TimeUtil.getNowDate(userInfo));
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 |
-| --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 |
+| 参数       | 类型       | 是否必填 | 官方说明 |
+| ---------- | ---------- | -------- | -------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 |
 
 AI 使用规则：
 
@@ -768,9 +889,9 @@ TimeUtil.getUserTimeZone(userInfo)
 
 参数说明：
 
-| 参数 | 类型 | 是否必填 | 官方说明 |
-| --- | --- | --- | --- |
-| `userInfo` | `UserInfo` | 是 | 用户对象 |
+| 参数       | 类型       | 是否必填 | 官方说明 |
+| ---------- | ---------- | -------- | -------- |
+| `userInfo` | `UserInfo` | 是       | 用户对象 |
 
 AI 使用规则：
 
@@ -786,10 +907,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,14 @@ const { postClass } = require("../../utils/http")
 
 /**
  * cloudcc get triggers <listQueryJson> [projectPath]
+ * listQueryJson 字段说明：
+ * - shownum: 每页条数
+ * - showpage: 页码
+ * - sname: 触发器名字
+ * - fid: 触发器作用对象 ID（兼容字段）
+ * - objId: 触发器作用对象 ID（会自动映射到 fid）
+ * - rptcond: 额外筛选条件
+ * - rptorder: 排序条件
  * @param {string[]} argvs
  */
 async function get(argvs, isMcp = false) {