cloudcc-cli 2.2.6 → 2.2.8

package/src/script/doc.js

@@ -0,0 +1,259 @@
+/**
+ * script 文档统一入口（全量一次性输出）
+ */
+const fs = require("fs");
+const path = require("path");
+
+function generateFullMarkdownDoc() {
+    const lines = [
+        "# CloudCC 客户端脚本开发指南",
+        "",
+        "> 本文档参考 CloudCC 官方「客户端脚本」文档整理而成：[客户端脚本](https://help.cloudcc.cn/product03/ke-hu-duan-jiao-ben/)。  ",
+        "> 目标：指导开发者在不同页面（列表、新建/编辑、详情、全局）特定时机运行 JavaScript，基于 CCDK 能力实现字段控制、布局调整等前端增强。",
+        "",
+        "---",
+        "",
+        "## 1. 概念与入口",
+        "",
+        "### 1.1 什么是客户端脚本",
+        "",
+        "- 客户端脚本是在 **浏览器端**、特定页面和时机执行的一段 JavaScript。  ",
+        "- 依托 `$CCDK` 提供的桥接能力，可以：",
+        "  - 显示提示信息",
+        "  - 控制字段显隐 / 只读",
+        "  - 调整页面 DOM 结构",
+        "  - 在保存前/后执行校验或自定义逻辑",
+        "",
+        "### 1.2 进入客户端脚本设置页面",
+        "",
+        "1. 登录 CloudCC 系统  ",
+        "2. 点击右上角头像，选择「开发者平台」（仅管理员简档可见）  ",
+        "3. 左侧菜单：`扩展 → 客户端脚本`",
+        "",
+        "---",
+        "",
+        "## 2. 创建第一个客户端脚本",
+        "",
+        "### 2.1 新建脚本",
+        "",
+        "1. 在「客户端脚本」列表页，点击右上角「新建」  ",
+        "2. 填写基本信息（名称、适用对象/页面/事件等），进入代码编辑页面  ",
+        "3. 在代码输入区输入示例代码：",
+        "",
+        "```javascript",
+        "$CCDK.CCMessage.showMessage('hello cloudCC');",
+        "```",
+        "",
+        "4. 点击右上角「保存」",
+        "",
+        "### 2.2 回到前台查看效果",
+        "",
+        "例如：  ",
+        "- 配置为在「客户详情页 onLoad」执行  ",
+        "- 返回前台 → 打开客户菜单 → 进入任意一条客户详情  ",
+        "- 页面加载完成后，会看到 `hello cloudCC` 提示信息",
+        "",
+        "---",
+        "",
+        "## 3. 利用 devid 精确控制页面元素",
+        "",
+        "> 为方便控制页面元素，平台在关键 DOM 节点上添加了 `devid` 自定义属性，并使用特定业务 ID 绑定。可通过 F12 查看并用于脚本选择器。",
+        "",
+        "### 3.1 示例：禁用编辑页的「分级」字段",
+        "",
+        "#### 第一步：查看 devid",
+        "",
+        "1. 按 `F12` 打开浏览器开发者工具  ",
+        "2. 切换到「元素」(Elements) 面板  ",
+        "3. 使用元素选择器选中「分级」字段对应 DOM  ",
+        "4. 在右侧/标签属性中查找并复制该元素的 `devid` 值备用",
+        "",
+        "#### 第二步：创建客户端脚本",
+        "",
+        "在客户端脚本中，根据 `devid` 操作 DOM：",
+        "",
+        "```javascript",
+        "// 方式一：通过动态插入样式禁用点击",
+        "let style = document.createElement('style');",
+        "style.type = 'text/css';",
+        "style.innerHTML = '[devid=\"ffe201100003855g6Ipz\"]{pointer-events:none}';",
+        "document.getElementsByTagName('head').item(0).appendChild(style);",
+        "",
+        "// 方式二：直接隐藏某个元素",
+        "let dd = document.querySelector('div[devid=\"ffe201100003428r65pk\"]');",
+        "if (dd) {",
+        "  dd.style.display = \"none\";",
+        "}",
+        "```",
+        "",
+        "保存后回到前台，进入对应页面查看效果。",
+        "",
+        "### 3.2 示例：隐藏详情页某个字段",
+        "",
+        "同样通过 `devid` 精确定位字段，再注入样式：",
+        "",
+        "```javascript",
+        "// 隐藏并不占用空间",
+        "let style = document.createElement('style');",
+        "style.type = 'text/css';",
+        "style.innerHTML = '[devid=\"ffe20220523account01\"]{display:none !important}';",
+        "document.getElementsByTagName('head').item(0).appendChild(style);",
+        "```",
+        "",
+        "```javascript",
+        "// 隐藏但保留空间",
+        "let style = document.createElement('style');",
+        "style.type = 'text/css';",
+        "style.innerHTML = '[devid=\"ffe20220523account01\"]{visibility:hidden !important}';",
+        "document.getElementsByTagName('head').item(0).appendChild(style);",
+        "```",
+        "",
+        "### 3.3 示例：移动页面元素到其他位置",
+        "",
+        "```javascript",
+        "// 获取要移动的节点",
+        "const moveNode = document.querySelector('[devid=\"aee2024EFBBA5EEfs1Ta\"]');",
+        "// 目标节点",
+        "const targetNode = document.querySelector('[devid=\"adf2024D33E03DA6xzBj\"]');",
+        "// 目标节点的父节点",
+        "const targetParentNode = targetNode.parentNode;",
+        "",
+        "// 将需要移动的节点插入到目标节点前面",
+        "if (moveNode && targetNode && targetParentNode) {",
+        "  targetParentNode.insertBefore(moveNode, targetNode);",
+        "}",
+        "```",
+        "",
+        "**注意**：DOM 可能尚未渲染完成，可结合定时器或 `MutationObserver` 等机制等待节点出现。",
+        "",
+        "---",
+        "",
+        "## 4. 页面类型与脚本事件映射",
+        "",
+        "> 系统页面大致分为「全局、列表、新建/编辑、详情」等类型，每种页面支持不同事件，脚本在对应时机执行。",
+        "",
+        "以下是官方提供的主要事件（简化说明）：",
+        "",
+        "### 4.1 全局类型",
+        "",
+        "- **onCreate**",
+        "  - 适用：PC / HS",
+        "  - 函数签名：`function test($CCDK, obj = {})`",
+        "  - 说明：项目启动时触发（业务页面代码尚未执行）",
+        "",
+        "- **onLoad**",
+        "  - 适用：PC / HS",
+        "  - 场景：全局 UI 首次展示后",
+        "",
+        "- **onDestroy**",
+        "  - 适用：PC / HS",
+        "  - 场景：关闭 Tab / 更改流程等导致当前应用关闭时",
+        "",
+        "### 4.2 视图页（列表页面）",
+        "",
+        "事件函数统一形如：`function test($CCDK, obj = {})`",
+        "",
+        "- **onCreated**",
+        "  - 时机：进入视图页，但 DOM 还未创建  ",
+        "- **onLoad**",
+        "  - 时机：首次进入，或点击搜索刷新列表数据后  ",
+        "- **onDestroy**",
+        "  - 时机：离开列表页（如进入详情页等）",
+        "",
+        "### 4.3 新建/编辑页",
+        "",
+        "同样使用 `function test($CCDK, obj = {})`：",
+        "",
+        "- **onCreated**",
+        "  - 时机：进入新建/编辑页面，但 DOM 尚未创建  ",
+        "- **onLoad**",
+        "  - 时机：详情数据加载完成、页面渲染结束  ",
+        "- **onDestroy**",
+        "  - 时机：离开新建/编辑页面  ",
+        "- **beforeSave**",
+        "  - 参数：`obj.detailData` 为 key-value 形式的详情数据，**可以在这里修改**  ",
+        "  - 时机：点击保存按钮时触发，适合做前端校验与补充字段赋值  ",
+        "- **afterSave**",
+        "  - 时机：保存接口请求完成后触发  ",
+        "- **onChange**",
+        "  - 时机：编辑某个字段、光标失焦，且 value 有变化时触发",
+        "",
+        "### 4.4 详情页",
+        "",
+        "- **onLoad**",
+        "  - 适用：PC / HS  ",
+        "  - 时机：获取详情基础数据并完成 DOM 渲染后触发  ",
+        "",
+        "---",
+        "",
+        "## 5. 实战建议与注意事项",
+        "",
+        "### 5.1 DOM 渲染时机",
+        "",
+        "- 部分页面在脚本执行时 DOM 可能尚未完全渲染，建议：",
+        "  - 使用 `setTimeout` / 轮询检查目标节点是否存在  ",
+        "  - 或配合 `MutationObserver` 监听 DOM 变化后再操作  ",
+        "",
+        "### 5.2 与 CCDK 的配合",
+        "",
+        "- `$CCDK` 提供了多种能力，如：",
+        "  - `CCMessage`：消息提示  ",
+        "  - `CCLoad`：脚本/样式加载  ",
+        "  - 其他与对象/类交互的桥接能力  ",
+        "- 客户端脚本中应优先调用 `$CCDK` 而非自行拼接接口。",
+        "",
+        "### 5.3 与自定义组件的边界",
+        "",
+        "- 客户端脚本更适合：",
+        "  - 简单的字段控制",
+        "  - 小范围布局微调",
+        "  - 轻量交互增强  ",
+        "- 更复杂的 UI、交互与业务逻辑推荐用「自定义组件」实现（详见 `custom-component-dev.md`）。",
+        "",
+        "---",
+        "",
+        "## 6. 客户端脚本开发 Checklist",
+        "",
+        "- [ ] 已在「开发者平台 → 客户端脚本」正确选择对象、页面类型与事件（onLoad / beforeSave 等）  ",
+        "- [ ] 使用 `$CCDK` 能力而非手工拼接接口或直接依赖不稳定的全局变量  ",
+        "- [ ] 所有 DOM 操作都考虑了渲染时机，避免因节点不存在而报错  ",
+        "- [ ] 通过 `devid` 精确定位关键元素，避免依赖脆弱的层级或 class 选择器  ",
+        "- [ ] 对性能敏感操作（如定时器、频繁 DOM 查询）做了节流或销毁处理  ",
+        "- [ ] 已区分客户端脚本与自定义组件的职责，将复杂 UI / 交互放到组件中实现  ",
+        "- [ ] 在目标环境中完整测试：列表 / 新建 / 编辑 / 详情等场景，确认无脚本错误和布局异常  ",
+        "",
+    ];
+
+    const base = lines.join("\n");
+    const ccdkPath = path.join(__dirname, "..", "api", "ccdk-sdk.md");
+    let ccdkContent = "";
+    try {
+        ccdkContent = fs.readFileSync(ccdkPath, "utf8");
+    } catch (e) {
+        ccdkContent = `# CloudCC 前端 SDK（cloudcc-ccdk）使用指南\n\n（未找到文件：${ccdkPath}）\n`;
+    }
+
+    return [
+        base,
+        "",
+        "---",
+        "",
+        "## 附录：CCDK SDK 速查",
+        "",
+        "> 来源：`src/api/ccdk-sdk.md`",
+        "",
+        ccdkContent.trim(),
+        "",
+    ].join("\n");
+}
+
+function doc() {
+    const content = generateFullMarkdownDoc();
+    console.log(content);
+    return content;
+}
+
+// 兼容旧调用方：仍提供同名入口（但都返回全量文档）
+doc.getEditGuide = doc;
+
+module.exports = doc;

package/src/script/index.js

@@ -5,6 +5,7 @@ cc.pull = require("./pull")
 cc.get = require("./get")
 cc.pullList = require("./pullList")
 cc.detail = require("./detail")
+cc.doc = require("./doc")
 function main(action, argvs) {
   cc[action](argvs)
 }

package/src/timer/index.js

@@ -4,6 +4,7 @@ cc.publish = require("./publish")
 cc.pull = require("./pull")
 cc.get = require("./get")
 cc.pullList = require("./pullList")
+cc.detail = require("./detail")
 function Timer(action, argvs) {
   cc[action](argvs[2], argvs[3])
 }

package/src/triggers/doc.js

@@ -0,0 +1,342 @@
+/**
+ * triggers 文档统一入口（全量一次性输出）
+ */
+const fs = require("fs");
+const path = require("path");
+
+function generateFullMarkdownDoc() {
+    const lines = [
+        "# CloudCC 触发器开发指南",
+        "",
+        "> 本文档参考 CloudCC 官方「触发器」文档整理而成：[触发器](https://help.cloudcc.cn/product03/hong-fa-qi/)。  ",
+        "> 目标：帮助开发者正确编写、调试和使用触发器，理解触发时机、可用变量、与自定义类/Email/时间工具的协同，以及避免循环调用等常见坑。",
+        "",
+        "---",
+        "",
+        "## 1. 概念与入口",
+        "",
+        "### 1.1 什么是触发器",
+        "",
+        "- 触发器是在特定数据操作事件发生**之前或之后**执行的一段 Java 代码。  ",
+        "- 典型触发时间：",
+        "  - 在对象记录插入数据库之前 / 之后",
+        "  - 在对象记录更新之前 / 之后",
+        "  - 在对象记录删除之前 / 之后",
+        "  - 在审批相关场景（`approval`）中  ",
+        "- 主要用于：",
+        "  - 复杂字段校验（必填、多字段联动、一致性约束）",
+        "  - 自动带值 / 派生字段写入",
+        "  - 与其他对象联动更新",
+        "",
+        "### 1.2 触发器开发入口",
+        "",
+        "两种方式创建触发器：",
+        "",
+        "1. **通过开发者平台**  ",
+        "   - 登录系统 → 右上角头像 → 「开发者平台」（管理员简档可见）  ",
+        "   - 左侧菜单：`扩展 → 触发器 → 新建`",
+        "",
+        "2. **在对象后台设置中创建**  ",
+        "   - 进入目标对象的后台设置（对象管理）  ",
+        "   - 将页面滚动到底部，在「触发器」区域点击「新建`",
+        "",
+        "---",
+        "",
+        "## 2. 触发器配置项与触发时机",
+        "",
+        "### 2.1 基本配置",
+        "",
+        "- **名称**：汉字说明，用于描述触发器完成的功能  ",
+        "- **触发对象**：在哪个对象上执行触发器操作  ",
+        "- **触发时间（Trigger Event）**：决定在什么时机触发",
+        "",
+        "常用触发时间包括：",
+        "",
+        "- `beforeInsert`：新建/复制记录行满足触发条件前执行  ",
+        "- `beforeUpdate`：编辑记录行满足触发条件前执行  ",
+        "- `beforeUpsert`：新建和编辑/复制统一入口前执行  ",
+        "- `beforeDelete`：删除记录前执行  ",
+        "- `afterInsert`：新建/复制记录后执行（可获取记录 ID）  ",
+        "- `afterUpdate`：修改记录后执行  ",
+        "- `afterUpsert`：新建或编辑/复制后执行  ",
+        "- `afterDelete`：删除记录后执行  ",
+        "- `afterInsertCommit`：插入事务提交后执行，**报错不会回滚主事务**  ",
+        "- `afterUpdateCommit`：更新提交后执行，报错不会回滚  ",
+        "- `afterUpsertCommit`：保存提交后执行，报错不会回滚  ",
+        "- `afterDeleteCommit`：删除提交后执行，报错不会回滚  ",
+        "- `approval`：审批流程相关触发",
+        "",
+        "**提示**：  ",
+        "`before*` 阶段通常用于**校验与字段赋值**；`after*` 阶段适合做**关联对象更新、日志记录、异步操作触发**等。",
+        "",
+        "---",
+        "",
+        "## 3. 触发器中可用变量与基础语法",
+        "",
+        "### 3.1 可直接使用的变量",
+        "",
+        "- `(UserInfo) userInfo`：当前操作用户信息  ",
+        "- `(Map) record_new`：当前记录的**最新值**（新建/修改后）  ",
+        "- `(Map) record_old`：当前记录的**旧值**（修改前），在 `insert` 场景通常为 `null`  ",
+        "- `trigger`：触发器上下文对象，可用于添加错误提示等",
+        "",
+        "### 3.2 常用语法与含义",
+        "",
+        "| 语法                                   | 返回值   | 含义                               |",
+        "|----------------------------------------|----------|------------------------------------|",
+        "| `record_new.get(\"字段API\")`            | String   | 获取记录中字段的最新值            |",
+        "| `record_new.put(\"字段API\", \"字段值\")`  | void     | 为记录的某字段赋值                |",
+        "| `record_old.get(\"字段API\")`            | String   | 获取记录中字段的前一个值          |",
+        "| `record_old == null`                   | boolean  | 在 `beforeUpsert/afterUpsert` 中识别是否为新建 |",
+        "| `trigger.addErrorMessage(\"提示内容\")`  | void     | 在保存前用于提示并中止保存        |",
+        "",
+        "**提示**：  ",
+        "字段名使用**字段 API 名称**（如 `project_manager`、`start_date`），自定义字段一般以 `__c` 结尾。",
+        "",
+        "---",
+        "",
+        "## 4. 常见案例",
+        "",
+        "### 4.1 案例 1：字段联动带值（查询赋值）",
+        "",
+        "**需求**  ",
+        "在项目对象中，将当前项目经理的邮箱自动带入本对象的 `email` 字段。  ",
+        "",
+        "**触发事件**：`beforeUpsert`",
+        "",
+        "**代码示例**",
+        "",
+        "```java",
+        "String managerId = record_new.get(\"project_manager\") == null ? \"\" : record_new.get(\"project_manager\") + \"\"; // 新值",
+        "String managerId_old = record_old == null || record_old.get(\"project_manager\") == null ? \"\" : record_old.get(\"project_manager\") + \"\"; // 旧值",
+        "",
+        "// 项目经理字段新值和老值不相同时判定为该字段值发生改变，需重新查询用户表获取邮箱带到本记录中",
+        "if (!managerId.equals(managerId_old)) {",
+        "  List<CCObject> userlist = cquery(\"User\", \"id='\" + managerId + \"'\");",
+        "  if (userlist.size() > 0) {",
+        "    String email = userlist.get(0).get(\"email\") == null ? \"\" : userlist.get(0).get(\"email\") + \"\";",
+        "    record_new.put(\"email\", email);",
+        "  }",
+        "}",
+        "```",
+        "",
+        "要点：",
+        "- 使用 `record_new` / `record_old` 比较判断字段是否变更，**避免无谓查询与写入**。",
+        "- 查询用户对象时使用 `cquery(\"User\", ...)`。",
+        "",
+        "### 4.2 案例 2：复杂必填校验",
+        "",
+        "**需求**  ",
+        "当项目经理不为空时，项目开始日期与结束日期必填，否则不允许保存。",
+        "",
+        "**触发时间**：`beforeUpsert`",
+        "",
+        "**代码示例**",
+        "",
+        "```java",
+        "String managerId = record_new.get(\"project_manager\") == null ? \"\" : record_new.get(\"project_manager\") + \"\"; // 项目经理",
+        "String start_date = record_new.get(\"start_date\") == null ? \"\" : record_new.get(\"start_date\") + \"\";         // 项目开始日期",
+        "String end_date = record_new.get(\"end_date\") == null ? \"\" : record_new.get(\"end_date\") + \"\";               // 项目结束日期",
+        "",
+        "if (!\"\".equals(managerId) && (\"\".equals(start_date) || \"\".equals(end_date))) {",
+        "   trigger.addErrorMessage(\"请填写项目开始日期及项目结束日期\");",
+        "}",
+        "```",
+        "",
+        "要点：",
+        "- 通过 `trigger.addErrorMessage` 阻断保存并提示用户。",
+        "- 适合放在 `beforeInsert` / `beforeUpdate` / `beforeUpsert` 等阶段。",
+        "",
+        "---",
+        "",
+        "## 5. 进阶用法与注意事项",
+        "",
+        "### 5.1 触发器可直接引用的参数",
+        "",
+        "- `UserInfo userInfo`：当前操作用户  ",
+        "- `Map record_new` / `Map record_old`",
+        "",
+        "取字段值时直接使用字段 API 名称：",
+        "",
+        "```java",
+        "String name = record_new.get(\"name\") == null ? \"\" : record_new.get(\"name\") + \"\";",
+        "```",
+        "",
+        "### 5.2 循环调用限制",
+        "",
+        "触发器之间可以间接导致**循环调用**，例如：",
+        "- 在客户对象的 `update` 触发器中更新业务机会  ",
+        "- 在业务机会对象的 `update` 触发器中又更新客户（再次触发客户的 `update` 触发器）  ",
+        "",
+        "如果在触发器中不加条件控制，可能形成无限循环。平台限制：",
+        "- **最多允许 3 次循环调用**  ",
+        "- 超过 3 次系统会报错提示并终止执行",
+        "",
+        "建议：",
+        "- 在跨对象更新时增加「状态字段」或「字段变更判断」作为保护条件  ",
+        "- 避免在 A 的触发器中无条件更新 B，同时在 B 的触发器中又无条件更新 A  ",
+        "- 将复杂联动逻辑尽量下沉到自定义类中集中处理",
+        "",
+        "### 5.3 触发器中发送邮件通知",
+        "",
+        "触发器可以使用 `SendEmail` 发送系统邮件：",
+        "",
+        "```java",
+        "SendEmail sendEmail = new SendEmail(userInfo);",
+        "",
+        "// 直接发送邮件",
+        "sendEmail.sendMailFromSystem(",
+        "  new String[]{\"to@example.com\"},     // 收件人",
+        "  new String[]{\"cc@example.com\"},     // 抄送",
+        "  new String[]{\"bcc@example.com\"},    // 密送",
+        "  \"邮件主题\",",
+        "  \"邮件内容\",",
+        "  true                                // 是否文本邮件",
+        ");",
+        "",
+        "// 使用邮件模板发送",
+        "sendEmail.sendEmailNew(",
+        "  \"emailTemplateId\",",
+        "  new String[]{\"to@example.com\"},",
+        "  new String[]{\"cc@example.com\"},",
+        "  new String[]{\"bcc@example.com\"},",
+        "  record_new.get(\"id\") + \"\"           // 关联记录 ID",
+        ");",
+        "```",
+        "",
+        "### 5.4 获取邮件模板内容",
+        "",
+        "```java",
+        "/**",
+        " * lang：语言",
+        " * emailtemplateid：邮件模板ID",
+        " * id：记录id（可选）",
+        " */",
+        "Map<String, String> m = this.getMessageByTemplateId(lang, emailtemplateid, record_new.get(\"id\") + \"\");",
+        "",
+        "// 邮件标题",
+        "String subject = m.get(\"subject\");",
+        "// 邮件内容",
+        "String content = m.get(\"context\");",
+        "// 邮件是否为文本形式",
+        "String isText = m.get(\"istext\");",
+        "```",
+        "",
+        "可以先获取模板内容，再根据业务需要调整后发送。",
+        "",
+        "### 5.5 TimeUtil：多时区时间支持",
+        "",
+        "与自定义类中用法相同，触发器也应使用 `TimeUtil` 来处理与时区相关的时间：",
+        "",
+        "- 获取当前时间（按用户时区）：",
+        "",
+        "```java",
+        "TpSysTask task = new TpSysTask();",
+        "task.setBeginTime(TimeUtil.getNowDate(userInfo));",
+        "```",
+        "",
+        "- 获取带时区的 `SimpleDateFormat`：",
+        "",
+        "```java",
+        "SimpleDateFormat myDateFormat = TimeUtil.getSimpleDateFormat(\"yyyy-MM-dd\", userInfo);",
+        "```",
+        "",
+        "- 获取带时区的 `Calendar`：",
+        "",
+        "```java",
+        "Calendar cal = TimeUtil.getCalendar(userInfo);",
+        "```",
+        "",
+        "---",
+        "",
+        "## 6. 与 CCService / 自定义类的协同",
+        "",
+        "### 6.1 在触发器中使用 CCService",
+        "",
+        "触发器中同样可以实例化并使用 `CCService` 进行增删改查：",
+        "",
+        "```java",
+        "CCService cs = new CCService((UserInfo) userInfo);",
+        "",
+        "// 示例：根据当前记录字段查询机会",
+        "String accountId = record_new.get(\"khmc__c\") == null ? \"\" : record_new.get(\"khmc__c\") + \"\";",
+        "if (!\"\".equals(accountId)) {",
+        "  List<CCObject> opps = cs.cquery(",
+        "    \"Opportunity\",",
+        "    \"khmc__c = '\" + accountId + \"'\",",
+        "    \"jine__c desc\"",
+        "  );",
+        "  // TODO: 根据查询结果执行相应逻辑",
+        "}",
+        "```",
+        "",
+        "具体 `CCService` 能力详见 `custom-class-dev.md`。",
+        "",
+        "### 6.2 将复杂逻辑下沉到自定义类",
+        "",
+        "推荐模式：",
+        "",
+        "1. 触发器中只负责：",
+        "   - 判断是否需要执行逻辑（字段是否变化、状态是否满足、避免循环等）",
+        "   - 准备必需参数（如 `userInfo`、`record_new` / `record_old` 等）",
+        "2. 将主要业务逻辑封装到自定义类方法中：",
+        "",
+        "```java",
+        "// 触发器中",
+        "if (/* 条件满足 */) {",
+        "  new ProjectService(userInfo).handleAfterUpdate(record_old, record_new);",
+        "}",
+        "```",
+        "",
+        "好处：",
+        "- 逻辑集中、可复用、易测试  ",
+        "- 触发器代码保持精简，可读性更高",
+        "",
+        "---",
+        "",
+        "## 7. 触发器开发 Checklist",
+        "",
+        "- [ ] 已选择正确的**触发对象**与**触发时间**（before/after/commit/approval）  ",
+        "- [ ] 校验逻辑集中在 `before*` 阶段，并通过 `trigger.addErrorMessage` 给出清晰提示  ",
+        "- [ ] 使用 `record_new` / `record_old` 判断字段是否变化，避免不必要的数据库操作  ",
+        "- [ ] 涉及跨对象更新时，已经考虑并避免循环调用（尤其是双向更新）  ",
+        "- [ ] 发送邮件时使用 `SendEmail` / 模板，且确认模板与收件人配置正确  ",
+        "- [ ] 与时间相关逻辑使用 `TimeUtil`，避免跨时区错误  ",
+        "- [ ] 复杂业务逻辑拆分到自定义类中，通过触发器调用，触发器本身保持简洁  ",
+        "- [ ] 已在测试环境完整验证：新建、编辑、删除、审批等全场景，确认不会出现循环触发或异常回滚问题  ",
+        "",
+    ];
+
+    const base = lines.join("\n");
+    const sdkPath = path.join(__dirname, "..", "api", "backend-sdk-java.md");
+    let sdkContent = "";
+    try {
+        sdkContent = fs.readFileSync(sdkPath, "utf8");
+    } catch (e) {
+        sdkContent = `# CloudCC 后端 SDK（Java）使用指南\n\n（未找到文件：${sdkPath}）\n`;
+    }
+
+    return [
+        base,
+        "",
+        "---",
+        "",
+        "## 附录：后端 SDK（Java）速查",
+        "",
+        "> 来源：`src/api/backend-sdk-java.md`",
+        "",
+        sdkContent.trim(),
+        "",
+    ].join("\n");
+}
+
+function doc() {
+    const content = generateFullMarkdownDoc();
+    console.log(content);
+    return content;
+}
+
+// 兼容旧调用方：统一返回全量文档
+doc.getEditGuide = doc;
+
+module.exports = doc;

package/src/triggers/index.js

@@ -5,7 +5,12 @@ cc.pull = require("./pull")
 cc.get = require("./get")
 cc.pullList = require("./pullList")
 cc.detail = require("./detail")
+cc.doc = require("./doc")
 function Classes(action, argvs) {
+  if (action === "detail") {
+    cc[action](argvs[2], argvs[3]);
+    return;
+  }
   cc[action](argvs)
 }
 

package/target/maven-archiver/pom.properties

@@ -1,3 +1,3 @@
 artifactId=ccopenapi
 groupId=com.cloudcc.core
-version=0.0.3
+version=0.0.4