weaver-work-cli 0.1.23 → 0.1.25

package/skills/weaver-e10-builder/actionflows/references/components/logic/LogicFlowSet.md

@@ -0,0 +1,17 @@
+# 规则集（`LogicFlowSet`）
+
+## 何时使用
+
+引用当前租户已有规则集完成复杂规则判断或计算。
+
+## 先查询
+
+获得当前租户规则 Browser 原对象。
+
+## 不可猜测
+
+不在动作流中创建或编辑规则定义；没有真实规则对象即停止。
+
+## 最小计划
+
+`logicFlow`；可选 `inputParams` 必须为平台回读结构。

package/skills/weaver-e10-builder/actionflows/references/components/logic/MultipleExecution.md

@@ -0,0 +1,38 @@
+# 循环（MultipleExecution）
+
+循环体通过 `actions` 提供，至少包含一个非 `Output` 动作，当前不支持循环嵌套。
+
+## 循环方式
+
+| `cycleMode` | 场景 | 必填参数 |
+| --- | --- | --- |
+| `1` | 按指定次数 | `cycleTimes` |
+| `2` | 满足条件时继续 | `condition` |
+| `3` | 按列表逐条遍历 | `detailData` |
+| `4` | 按列表分批遍历 | `batchDetailData`、`batchSizeData` |
+| `5` | 存在下一页时继续 | `pageCycleData`（平台已有变量 FormulaBean） |
+
+## 参数规则
+
+- `cycleTimes`：固定整数 `1-1000`，或实时上下文的 `context/reference`。动态引用必须使用 `getComponentContext` 返回的完整 `paramKey`；预检会保留来源字段的真实类型、所属组件和参数路径。
+- `detailData` / `batchDetailData`：只能引用真实 List/数组字段（表单明细、多选浏览框或上游动态列表）。不可用普通文本字段伪装为列表。
+- `batchSizeData`：固定整数 `2-1000`。
+- `condition`：使用 ESB `ConditionRule`，与动作流分支复用同一类规则树和 `saveCondition` 持久化；它不是 e-builder 表单动作的 `filterInput/ConditionSet`。左值可使用完整 `paramKey`、字段显示名、`paramName` 或真实字段 ID；编译器会按当前流程实时上下文回填真实 DTO。
+- `pageCycleData`：设计器会创建布尔变量并在循环体首节点写入“是否存在下一页”。当前只接受已存在的原始 `type: "7"` 变量 FormulaBean；尚未自动创建变量及赋值节点时，不生成该模式。
+
+## 示例
+
+```json
+{
+  "type": "MultipleExecution",
+  "params": {
+    "cycleMode": "3",
+    "detailData": {
+      "kind": "context",
+      "source": "event",
+      "paramKey": "<workflowId>.<arrayField>[]"
+    }
+  },
+  "actions": [{ "type": "SendMessage", "params": { "receiver": { "type": "all" }, "msgTitlev": "逐条处理", "msgContentv": "..." } }]
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/logic/Output.md

@@ -0,0 +1,37 @@
+# 终止（`Output`）
+
+## 何时使用
+
+结束主链；由编译器自动补充。需要配置成功/失败状态、结束提示或页面动作时，通过计划顶层 `finalOutput.params` 配置。
+
+## 先查询
+
+无需查询。
+
+## 不可猜测
+
+不要把 `Output` 写入 `actions`。提醒内容必须使用前端富文本组件对应的 `ContestSettingDTO`，字段名是 `reminderContent`，不能再使用旧的 `reminderMsgFormula`。流程触发（`ApproveTrigger`）只支持提醒配置，不支持页面交互、页面动作或跳转地址；页面动作仅可用于 `EventButton`。`basisValue` 与 `jumpUrl` 支持固定值、上下文、系统变量、变量、常量、查询结果和函数/公式；其中 `jumpUrl` 仅在 `pageAction=3` 时生效。`fixedData`、`customOutputData` 属于平台原生高级输出结构，必须使用真实回读结构，不能猜测。
+
+`reminderContent` 支持两种输入：一是前端原生对象 `{id, content, formulaBeans, langSet}`；二是 CLI 语义模板 `{parts:[{type:"text",value:"..."},{type:"context",paramKey:"..."},{type:"system_variable",key:"{date}"},{type:"variable",id:"..."},{type:"constant",id:"..."}]}`。编译器会生成 Base64 内容和 `#{paramN}` 占位符，并将每个动态片段保存为 `formulaBeans[].value`。
+
+如果自定义触发动作流需要配置终止参数，在 `finalOutput.params.customParamSetting` 中使用同一套 `CustSetFormDto` 结构，`formType` 改为 `output`，新建时 `customId` 传空字符串，`deleteTableIds` 传空数组，`appId` 由编译器注入当前动作流应用 ID，关联 ID 由后端保存方法生成。终止参数字段的映射关系必须写在 `tableList[].fields[].formulaValue`，对应后端 `CustFormDetailDto.formulaValue`；不能放在字段的 `value`、`mapping` 或其他自定义属性中。
+
+## 最小计划
+
+```json
+{
+  "finalOutput": {
+    "params": {
+      "outputStatus": "0",
+      "reminder": "1",
+      "reminderContent": {
+        "parts": [
+          { "type": "text", "value": "失败：" },
+          { "type": "variable", "id": "<真实变量ID>", "name": "失败提示" }
+        ]
+      },
+      "pageAction": "0"
+    }
+  }
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/message/InnerMQSend.md

@@ -0,0 +1,50 @@
+# 内置 MQ 发送（`InnerMQSend`）
+
+## 何时使用
+
+向平台内置 MQ 的 Topic/队列发送消息时使用。它不是外部 MQ 连接器的生产者动作。
+
+## 参数
+
+```json
+{
+  "actions": [
+    {
+      "type": "InnerMQSend",
+      "params": {
+        "queueName": "真实Topic名称",
+        "sendModel": "1",
+        "sendParams": "<平台 InnerMqComponentDTO.sendParams 原生 ParamMappingBean>",
+        "inputParams": [
+          { "paramKey": "payload", "value": { "kind": "context", "paramKey": "<真实字段paramKey>", "label": "消息体" } }
+        ]
+      }
+    }
+  ]
+}
+```
+
+- `queueName` 和 `sendParams` 必填；固定 Topic 直接传字符串，CLI 会转换为平台所需的 `FormulaBean`。
+- `queueName` 也可以传统一动态赋值或平台原生 `FormulaBean`，包括上下文、系统变量、变量、常量和函数。
+- `sendModel` 为 `1` 广播模式或 `2` 集群模式，省略时默认 `1`。
+- `sendParams` 必须来自平台发送参数设计器的原生 `ParamMappingBean`，不要用 `receiveParams` 或普通字符串替代。
+- 需要给发送参数赋值时使用 `inputParams`。`paramKey` 必须命中 `sendParams.tableData` 的真实参数；`value` 支持固定值、上下文、系统变量、变量、常量、查询结果和函数/公式，CLI 会写入该行的 `formulaData`，不会重建参数定义。
+
+### 参数类型与数据类型联动
+
+CLI 生成 `ParamMappingBean`、`ParamSettingBean` 及其分组 DTO 的 `tableData` 时才归一化参数类型：依据后端 `ParamType` 枚举匹配；数字类型统一写 `int`，长整型写 `string`，无法匹配写 `string`。普通 `FormulaBean`、表单字段上下文、循环上下文和 `CustSetFormDto` 不使用这套归一化。如果 `paramType` 为 `json` 或字段开启 `arrs`，`dataType` 强制写为 `node`；普通非数组标量默认写为 `attribute`。
+
+`tableData` 中每一行的 `paramType` 决定 `dataType` 的合法候选和是否允许继续加下级，不能只把 `dataType` 当成一个任意字符串填写：
+
+- 普通标量（如 `string`、`int`、`boolean` 等）且 `arrs:false` 时，合法数据类型只有“属性”；平台因此不会显示数据类型下拉，这是正常行为。
+- `arrs:true` 时，平台允许在该参数类型对应的多个数据类型中选择；数组参数的 `paramKey` 回读时可能规范化为带 `[]` 的形式。
+- `json`、`xml`、`xml_string` 是结构化参数，可以通过 `parentId` 组织下级参数；下级参数仍需按自身 `paramType` 和父节点限制填写，不能把结构化参数拍平成普通标量。
+- 数据类型下拉是否显示是设计器根据参数类型、数组标志、父节点和固定类型限制计算出来的 UI 状态，不由服务端仅凭 `dataType` 字段强行打开。
+
+因此，需求只要求一个数据类型时不要伪造下拉；需求需要多种数据类型或下级节点时，必须按真实参数类型构造 `tableData` 层级。
+
+### FormulaBean 动态来源的统一规则
+
+上述参数类型规则只作用于参数 DTO；所有组件的动态字段生成 `FormulaBean` 时，还必须统一遵循五类来源：普通组件上下文取对应 `getComponentContext` 的真实字段；循环体取前端拼出的 `CycleParams` 并保留列表来源；`EsbFormDataDto`、`ParamMappingBean`/`ParamSettingBean`、`CustSetFormDto` 的依据值下级分别使用各自前端的 basisValue/相对 paramKey/parentName 规则。真实字段的 `frontId`、`paramKey`、`parentName`、`newParentName` 不可由字段名或路径尾段猜测，预检无法取得时直接失败。
+
+`InnerMQSend` 与触发器 `InnerMQListener` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。

package/skills/weaver-e10-builder/actionflows/references/components/message/SendMessage.md

@@ -0,0 +1,30 @@
+# 发送消息（`SendMessage`）
+
+## 何时使用
+
+向人员、角色、全员或上游人员字段发送 IM 消息。
+
+## 先查询
+
+固定接收人查询当前租户人员；上游负责人等动态接收人使用本次上下文；标题和正文中的动态片段也使用本次上下文。
+
+## 不可猜测
+
+提醒标题、提醒内容、推送图片 URL、PC 端链接和移动端链接统一使用前端 `AssignTextarea` 对应的 `ContestSettingDTO`。语义参数名分别为 `msgTitlev`、`msgContentv`、`picLink`、`msgPcLink`、`msgMobileLink`；可以传普通字符串、原生 `{id,content,formulaBeans,langSet}`，或 `parts` 模板。模板会编译成 Base64 内容、`#{paramN}` 占位符和独立 `formulaBeans`，对应手动配置时右侧的形式。**不再使用旧的 `msgTitle`、`msgContent`、`pcLink`、`mobileLink` 字段**。`parts` 的动态项支持 `context`、`system_variable`、`variable`、`constant`、`function`、`formula`、`query_result`，后两者必须按 `references/dynamic_resources.md` 使用真实资源或计划定义。需要拼接上下文时，必须拆成 `parts`，例如：
+
+```json
+{
+  "parts": [
+    {"type":"text","value":"批次任务："},
+    {"type":"context","paramKey":"<真实任务编号paramKey>","label":"任务编号"},
+    {"type":"text","value":"，设备："},
+    {"type":"context","paramKey":"<真实设备编号paramKey>","label":"设备编号"}
+  ]
+}
+```
+
+需要动态接收人时传 `receiver: {"type":"context","paramKey":"<真实人员字段paramKey>","label":"<字段名>"}`，不能把人员字段当固定人员 ID，也不能省略 `paramKey`。模板上下文只传 `paramKey` 和 `label`，由 CLI 按消息编辑器的动态片段结构编译，并绑定当前触发节点。对定时批量、按日期字段、表单数据等 e-builder 记录触发器，未显式提供链接时 CLI 自动生成 `msgPcLink` / `msgMobileLink` 的 PC/移动端详情链接：`formId` 为触发表单 ID 固定值，`dataId` 为上游“数据ID”动态上下文。显式 `msgPcLink` / `msgMobileLink` 会覆盖该默认行为。
+
+## 最小计划
+
+`receiver`、`msgTitlev`、`msgContentv`。

package/skills/weaver-e10-builder/actionflows/references/components/personnel/AlterPersonStatus.md

@@ -0,0 +1,30 @@
+# 人员状态变更
+
+组件类型：`AlterPersonStatus`。先运行 `component-describe AlterPersonStatus`。
+
+## 何时使用
+
+用于把已有人员批量设为在职或离职。它只改变人员账号状态；不要用它修改人员资料、入职信息或人员类型。
+
+## 生成前查询
+
+固定人员时使用 `recipient-search` 取得每一位目标人员和操作人的当前租户 Browser 原对象；动态人员时使用真实人员字段上下文或当前用户系统变量。
+
+## 业务边界
+
+- `personList` 支持动态人员 FormulaBean 数组或固定人员 Browser 原对象数组；`operators` 支持动态人员 FormulaBean 或固定人员 Browser 原对象。不能把裸人员 ID 当作固定 Browser 对象。
+- `userStatus` 仅为 `1`（在职）或 `2`（离职）。
+- 变更离职状态会影响真实人员可用性；仅在用户明确要求时生成。
+
+## 语义计划形状
+
+```json
+{
+  "type": "AlterPersonStatus",
+  "params": {
+    "personList": [{"id": "<真实人员ID>", "name": "<真实姓名>"}],
+    "userStatus": "2",
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"}
+  }
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/personnel/HrmEmployeeUpdate.md

@@ -0,0 +1,34 @@
+# 更新人员
+
+组件类型：`HrmEmployeeUpdate`。先运行 `component-describe HrmEmployeeUpdate`。
+
+## 何时使用
+
+用于更新一个已有人员的资料。它不创建人员；需要新增人员时使用 `PersonnelOnboarding`。只变更在职/离职状态时使用 `AlterPersonStatus`。
+
+## 生成前查询
+
+1. 固定人员时使用 `recipient-search` 分别取得操作人和待更新人员的当前租户 Browser 原对象；动态人员时改用真实人员字段上下文或当前用户系统变量。
+2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员字段定义。
+
+## 业务边界
+
+- `operators`、`person` 支持固定人员 Browser 原对象、当前用户、上游人员上下文以及已解析的变量/常量/函数公式。固定人员仍必须是真实 Browser 对象，动态引用不能手输人员 ID。
+- plan 只传 `fieldAssignments`，CLI 交给通用 `EsbFormDataDto` 生成器，基于实时定义和更新模式生成平台 `setting`；不允许手写 DTO。
+- Browser 字段必须匹配字段的真实选择器对象；字段名重名时必须传字段 ID。
+- 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
+- 生成的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `update_original` 模式：主表、明细表都会按实时字段定义生成完整骨架，未修改主表字段为 `{"formFieldKey":"","value":{"original":true}}`，未修改明细字段为 `{"formFieldKey":"","value":{"original":true,"assign":null}}`。
+- `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields=[]`，每张输出的明细表带 `deleteFields=[]`；动态赋值字段、原值占位字段和 DTO 外壳都由公共生成器处理。
+
+## 语义计划形状
+
+```json
+{
+  "type": "HrmEmployeeUpdate",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "person": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "fieldAssignments": {"main": {"邮箱": "zhangsan@example.com"}}
+  }
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/personnel/PersonnelAlterType.md

@@ -0,0 +1,38 @@
+# 人员状态变更
+
+组件类型：`PersonnelAlterType`。先运行 `component-describe PersonnelAlterType`。
+
+## 何时使用
+
+用于提交试用、入职、续签、调动、解雇、退休、离职和返聘等人员状态变更表单。只修改简单的在职/离职账号状态时，使用 `AlterPersonStatus`。
+
+## 生成前查询
+
+1. 使用 `recipient-search` 取得操作人的当前租户 Browser 原对象；也可以使用当前用户或上游人员上下文。
+2. 使用 `hrm-alter-type-fields {"personnelType":"redeploy"}` 按目标状态读取当前租户实时字段。不同 `personnelType` 的字段不能混用。
+
+## 业务边界
+
+- `personnelType` 是后端实体中的普通字符串，只支持 `trial`、`hire`、`extend`、`redeploy`、`dismiss`、`retire`、`quit`、`rehire`。
+- plan 只传 `fieldAssignments`，格式为 `{ "字段ID或唯一字段名": 值 }`；不要手写后端 `setting` 或 `FormulaBean` DTO。
+- 字段定义来自 `/api/bs/esb/setting/component/getHrmTypeField`，生成器会按实时 `items` 校验字段并使用真实字段 ID。字段名重名时必须传字段 ID。
+- 文本字段生成前端 `textarea#...#` 容器，多选字段生成 `multipleSelect#...#` 的 JSON 容器，Browser 字段保留真实选择对象的 ID、名称和原始值。
+- 后端 `save` 将 `operators` 保存为操作人公式，将 `setting` 保存为 CommonForm；因此本组件的 `setting` 是 `Map<String, FormulaBean>`，不属于 `EsbFormDataDto`，不会生成新增/更新表单的 `main/detail` 骨架。
+- 至少提供一个字段赋值；字段定义或动态引用无法解析时停止生成。
+
+## 语义计划形状
+
+```json
+{
+  "type": "PersonnelAlterType",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "personnelType": "redeploy",
+    "fieldAssignments": {
+      "switchDate": "1",
+      "newDepartment": {"id": "<部门ID>", "name": "<部门名称>"},
+      "notice": ["同步薪资", "通知直属上级"]
+    }
+  }
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/personnel/PersonnelOnboarding.md

@@ -0,0 +1,36 @@
+# 人员入职
+
+组件类型：`PersonnelOnboarding`。先运行 `component-describe PersonnelOnboarding`。
+
+## 何时使用
+
+用于新增人员到系统。它没有“目标人员”参数：人员由入职字段创建。若人员已经存在并只需改资料，改用 `HrmEmployeeUpdate`。
+
+## 生成前查询
+
+1. 使用 `recipient-search` 取得操作人的当前租户 Browser 原对象。
+2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员主表、明细、字段类型和必填项。
+
+## 业务边界
+
+- plan 传 `fieldAssignments`，CLI 交给通用 `EsbFormDataDto` 生成器，根据实时字段定义生成平台 `setting`；不允许手写 `setting` / `EsbFormDataDto`。
+- 编译后的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `create` 模式：主表、明细表都会按实时字段定义生成完整骨架，未赋值主表字段为 `{"formFieldKey":""}`，未赋值明细字段为 `{"formFieldKey":"","value":{"assign":null}}`。
+- `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields:[]`；每张输出的明细表带 `deleteFields:[]`。动态赋值字段和空字段都由公共生成器处理，入职组件不重复实现 DTO 保存逻辑。
+- 字段可用显示名或字段 ID。当前租户出现同名字段时必须使用字段 ID。
+- Browser 字段（部门、岗位、上级等）只接受其对应选择器返回的真实对象，不能把名称或 ID 当文本填入。
+- 未提供当前租户必填字段、或字段/取值无法解析时，停止生成并报告缺项。
+
+## 语义计划形状
+
+```json
+{
+  "type": "PersonnelOnboarding",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "fieldAssignments": {
+      "main": {"姓名": "张三", "部门": {"id": "<真实部门ID>", "name": "研发部"}},
+      "detail": [{"table": "教育经历", "fields": {"学校名称": "某大学"}}]
+    }
+  }
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/serverless/ServerlessAction.md

@@ -0,0 +1,42 @@
+# serverless/Action（`ServerlessAction`）
+
+## 何时使用
+
+用于执行平台的二开代码。`crossService=1` 时调用远程 serverless/Action 服务；`crossService=0` 时执行本地上传的 Java 类。
+
+## 参数
+
+```json
+{
+  "actions": [
+    {
+      "type": "ServerlessAction",
+      "params": {
+        "codeType": "customAction",
+        "crossService": 1,
+        "groupId": "ces",
+        "serverVersion": "1.1",
+        "request": {
+          "primaryKey": "",
+          "name": "",
+          "tableId": "<ParamMappingBean.tableId>",
+          "mappingTableId": "<ParamMappingBean.mappingTableId>",
+          "tableData": []
+        },
+        "response": {
+          "primaryKey": "",
+          "name": "",
+          "tableId": "<ParamSettingBean.tableId>",
+          "tableData": []
+        }
+      }
+    }
+  ]
+}
+```
+
+- `codeType` 当前仅支持 `customAction`。
+- `crossService=1` 时必须提供 `groupId`，`serverVersion` 按 provider/consumer 约定填写，可为空；`crossService=0` 时必须提供本地代码完整类路径 `address`。
+- `request` 必须使用前端输入参数配置生成的原生 `ParamMappingBean`；`response` 必须使用前端输出参数配置生成的原生 `ParamSettingBean`。
+- 参数行的 `id`、`parentId`、`paramKey`、`paramType`、`dataType` 和前端高级配置会被保留；缺失的参数表/字段 ID 由 CLI 补齐，不能用语义字符串替代原生结构。
+- 二开动作执行后，可以引用 `Response.entry.<字段>` 上下文；请求参数上下文使用 `Request.entry.<字段>`。

package/skills/weaver-e10-builder/actionflows/references/components/trigger/CustomTrigger.md

@@ -0,0 +1,82 @@
+# 自定义事件触发（`CustomTrigger`）
+
+## 何时使用
+
+需求明确要求由平台自定义事件主动触发动作流时使用。它不是 e-builder 表单数据变化触发，也不是按钮触发。
+
+## 参数
+
+唯一必填参数是 `customData`，新建时必须按后端 `CustSetFormDto` 组装。顶层字段为 `customId`、`formType`、`businessModule`、`tableList`、`deleteTableIds` 和 `appId`：`customId` 必须传空字符串，由 `CustSetFormService#saveCustSetForm` 生成组件关联 ID；`formType` 为 `input`；`deleteTableIds` 新建传空数组；`appId` 由编译器注入当前动作流应用 ID。不要使用旧的 `tables`/`SETTING` 结构。
+
+`tableList` 的主表需要 `id`、`formId`、`showName`、`isMain: true`、`orderNum` 和 `fields`；明细表需要 `id`、`showName`、`isMain: false`、`orderNum` 和 `fields`，不设置 `formId`。字段需要 `id`、`paramName`、`showName`、`paramType`、`isRequired`、`fieldComments`。缺少 ID 时由编译器生成；字段 `paramName` 不能为空。
+
+```json
+{
+  "event": {
+    "type": "CustomTrigger",
+    "params": {
+      "customData": {
+        "customId": "",
+        "formType": "input",
+        "businessModule": "",
+        "tableList": [{
+          "id": "<可选，缺失时生成>",
+          "formId": "<主表可选，缺失时生成>",
+          "showName": "",
+          "isMain": true,
+          "orderNum": 0,
+          "fields": [{
+            "id": "<可选，缺失时生成>",
+            "paramName": "payload",
+            "showName": "",
+            "paramType": "string",
+            "isRequired": false,
+            "fieldComments": ""
+          }]
+        }],
+        "deleteTableIds": []
+      }
+    }
+  }
+}
+```
+
+自定义参数的字段定义是业务特定的。根据需求新建时可以直接提供 `tableList` 和字段；`tableList` 或其中的 `fields` 为空时，设计器“输入参数设置”就是空白。已有组件的更新场景如需保留平台生成的 `customId`，应使用平台回读 DTO，不要把更新 DTO 当作新建 DTO。
+
+根触发器图标不是 `Icon-custom-trigger`，编译器统一保存为 `Icon-N-Triggerrul`。
+
+## 上下文
+
+触发后业务字段上下文根为 `SelectParams`，可引用 `SelectParams.<主表/明细表路径>`；同时可使用平台提供的 `FormField`、`SettingInfo`、`accessId` 和 `monitorId`。不要将自定义触发字段编译为 `FormData`。
+
+动态赋值的 `paramKey` 只写业务路径，不写 `FormData.`、`ApprovalData.` 或 `SelectParams.` 前缀。主表和明细表必须沿用同一个主表 key：主表字段写成 `主表key.字段key`，明细字段写成 `主表key.明细表key[].字段key`；只有最终公式的 `value`、`currentParamKey` 和 `allParamKey` 使用 `SelectParams.` 前缀。不能把明细字段写成 `FormData.明细表key[].字段key`，也不能省略前面的主表 key。
+
+## 自定义参数来源的 `frontId` 规则
+
+动态赋值来源于当前触发组件的 `customData` 时，必须把 `event.params.customData`（后端类型 `CustSetFormDto`）作为唯一 ID 来源。不要从目标字段、FormulaBean 自身的 `id` 或 `paramKey` 尾段推导 `frontId`。
+
+按以下顺序生成：
+
+1. 先按动态引用的表路径，在 `customData.tableList[]` 中找到对应的表对象（后端类型 `CustFormTableDto`）。
+2. 如果引用选择的是表维度（例如 `主表key.明细表key[]`），生成的 FormulaBean 写 `frontId = tableList[].id`。
+3. 如果引用选择的是字段维度（例如 `主表key.字段key` 或 `主表key.明细表key[].字段key`），先在匹配表的 `fields[]` 中找到对应字段对象（后端类型 `CustFormDetailDto`），再写 `frontId = fields[].id`。
+4. 这个 `frontId` 要写到关联映射生成的 FormulaBean 上，包括普通动作映射和终止组件 `customParamSetting.tableList[].fields[].formulaValue`；不能写目标字段 ID、表名、字段名、临时公式 ID 或 `paramKey` 尾段。
+5. 对应表/字段没有真实 ID 时，`frontId` 写空串 `""`；有值时必须是纯数字字符串。`field_<数字>` 只能在生成时转成 `<数字>`。
+
+例如：
+
+```json
+{
+  "customData": {
+    "tableList": [{
+      "id": "1001",
+      "fields": [{"id": "2001", "paramName": "name"}]
+    }]
+  },
+  "mapping": {
+    "targetFieldId": {"kind": "context", "paramKey": "main.name"}
+  }
+}
+```
+
+上例生成的关联 FormulaBean 必须是 `frontId: "2001"`；如果引用的是 `main[]` 表节点，则必须是 `frontId: "1001"`。

package/skills/weaver-e10-builder/actionflows/references/components/trigger/InnerMQListener.md

@@ -0,0 +1,41 @@
+# 内置 MQ 监听（`InnerMQListener`）
+
+## 何时使用
+
+需求明确要求监听平台内置 MQ 广播 Topic 时使用。它不同于外部 RabbitMQ/Kafka 等 `MqConsumer`。
+
+## 参数
+
+```json
+{
+  "event": {
+    "type": "InnerMQListener",
+    "params": {
+      "queueName": "真实Topic名称",
+      "sendModel": "1",
+      "receiveParams": {
+        "tableId": "<平台参数表 ID>",
+        "tableData": [{
+          "id": "<平台字段 ID>",
+          "paramKey": "payload",
+          "paramName": "payload",
+          "showName": "消息体",
+          "paramType": "string",
+          "dataType": "attribute",
+          "required": true,
+          "arrs": false
+        }]
+      }
+    }
+  }
+}
+```
+
+- `queueName` 必填，使用平台真实 Topic/队列名称。
+- `sendModel` 当前只支持 `1`（广播模式），省略时 CLI 默认填入 `1`。
+- `receiveParams` 可选；有业务接收字段时传平台原生 `ParamSettingBean`，在当前设计器回读结构中表现为 `tableId + tableData`，没有时省略。不能传 `{type:'SETTING', tables:[]}` 期待它自动生成输入字段。
+- 参数表中的“高级设置”（命名空间、默认值、敏感词等）目前没有独立的 CLI 参数或生成校验；如果已经取得平台完整的 `receiveParams` 原生对象，CLI 会随对象透传，但不会根据简化字段替你创建这些配置。
+
+根触发器图标不是猜测的 `Icon-message-queue`，平台内置 MQ 监听实际使用 `Icon-built-in-mq-listening-mcolor`；不要把发送动作的图标当成监听触发器图标。
+
+`InnerMQListener` 与动作 `InnerMQSend` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。

package/skills/weaver-e10-builder/actionflows/references/components/trigger/SimpleScheduler.md

@@ -0,0 +1,19 @@
+# 简单定时器（`SimpleScheduler`）
+
+## 何时使用
+
+按一次、按小时、按日、按周、按月或 Quartz Cron 表达式定时触发。
+
+## 先查询
+
+无需外部对象；确认业务时间规则。
+
+## 参数
+
+`rate` 为定时频率：`1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月、`6` Cron。图形化频率需要 `startTime`；按小时/日/周用 `cycle` 或指定列表，按月用 `day`、`atWeek` 或 `lastWeek`。选择 `rate=6` 时才需要 `cornString`，例如每天 10:00：`0 0 10 * * ?`。`endTime` 和 `openRetry` 可选。
+
+图形化频率直接使用平台原生字段，不要自行换算成 Cron；只有明确选择 `rate=6` 时才传 Cron。
+
+## 最小计划
+
+`rate`、`startTime`；按需求补充 `cycle`、`hour`、`day`、`week`、`atWeek`、`atWeekDetail`、`lastWeek`、`endTime`、`openRetry`。Cron 模式使用 `rate=6` + `cornString`。

package/skills/weaver-e10-builder/actionflows/references/components/trigger/WebHookTrigger.md

@@ -0,0 +1,91 @@
+# WebHook 请求触发（`WebHookTrigger`）
+
+`WebHookTrigger` 对应前端 `custom-webhook` 和 Java `WebHookTriggerComponent`。它接收外部 HTTP 请求，按配置的请求参数触发动作流。
+
+## 语义计划
+
+```json
+{
+  "event": {
+    "type": "WebHookTrigger",
+    "params": {
+      "requestUrl": "https://api.example.com/api/open-esb/server/webhook/trigger/order-created",
+      "request": {
+        "id": "webhook-request-1",
+        "mappingId": "webhook-mapping-1",
+        "tables": [
+          {
+            "name": "Params",
+            "primaryKey": "Params",
+            "tableId": "params-1",
+            "tableData": [
+              {
+                "id": "request-id",
+                "paramKey": "orderId",
+                "paramName": "orderId",
+                "showName": "订单 ID",
+                "paramType": "string",
+                "dataType": "attribute",
+                "required": true
+              }
+            ]
+          },
+          {
+            "name": "Header",
+            "primaryKey": "Header",
+            "tableId": "header-1",
+            "tableData": []
+          },
+          {
+            "name": "Body",
+            "primaryKey": "Body",
+            "tableId": "body-1",
+            "tableData": []
+          }
+        ]
+      },
+      "authAppIds": [
+        { "id": "app-1", "content": "普通应用-wull" }
+      ]
+    }
+  }
+}
+```
+
+`request` 应按设计器节点数据传入 `id`、可选 `mappingId` 和 `tables`。`tables` 的 `name` 只能是 `Params`、`Header`、`Body`；`primaryKey`、`tableId`、`customData` 等已有平台字段会原样保留，至少一个分组的 `tableData` 需要有字段，字段对象应来自前端参数设置组件。
+
+生成时推荐直接传设计器返回的完整 `requestUrl`。如果只有 `requestCode`，编译器也会生成 `/api/open-esb/server/webhook/trigger/<requestCode>` 形式的公开地址；Java 组件保存时使用最后一段作为 code。
+
+## 触发上下文
+
+Webhook 请求运行时由平台解析为三个上下文分组：`Params`、`Header`、`Body`。动作参数中的上下文引用使用完整路径，例如 `Params.orderId`、`Header.Authorization`、`Body.customer.name`；不要把它们写成 `FormData.*`。
+
+`authAppIds` 是 WebHook 触发器的必填认证应用列表，元素必须是 `{ "id": <应用ID>, "content": "<应用名称>" }`。生成前 CLI 会使用当前会话调用 `openApplicationBrowser` 并自动回填；默认使用接口返回的全部应用。如需限定范围，可在语义计划中传 `authAppNames: ["普通应用-wull"]`，CLI 会将筛选结果写入 `authAppIds`。没有认证应用时，CLI 不应生成 WebHook 触发器。
+
+## 终止节点响应
+
+Webhook 触发的终止节点使用 `finalOutput.params.webhookCustomParamSetting`，对应前端 `ParamGroupMappingBean`。必须包含 `Header`、`Body`、`StatusCode` 三个分组，并至少配置一个 Header 或 Body 字段；平台原生的 `id`、`mappingId`、`primaryKey`、`mappingTableId`、`customData` 和 `tableData` 直接保留。
+
+```json
+{
+  "finalOutput": {
+    "params": {
+      "webhookCustomParamSetting": {
+        "id": "response-setting-1",
+        "mappingId": "response-mapping-1",
+        "tables": [
+          { "name": "Header", "tableData": [] },
+          { "name": "StatusCode", "tableData": [] },
+          {
+            "name": "Body",
+            "customData": "{\"dataType\":\"application/json\"}",
+            "tableData": [
+              { "id": "response-a", "paramKey": "ab", "paramName": "ab", "paramType": "string", "required": true }
+            ]
+          }
+        ]
+      }
+    }
+  }
+}
+```

package/skills/weaver-e10-builder/actionflows/references/components/workflow/ApproveAddSign.md

@@ -0,0 +1,17 @@
+# 加审流程（`ApproveAddSign`）
+
+## 何时使用
+
+为流程增加审批人员。
+
+## 先查询
+
+查询实例、操作人和加审人员。
+
+## 不可猜测
+
+`src` 只用契约支持的加审方式。
+
+## 最小计划
+
+`requestId`、`employeeId`、`src`、`joinOperators`。

package/skills/weaver-e10-builder/actionflows/references/components/workflow/ApproveAgreeRejectApply.md

@@ -0,0 +1,17 @@
+# 同意退回申请（`ApproveAgreeRejectApply`）
+
+## 何时使用
+
+同意一项已发起的流程退回申请。
+
+## 先查询
+
+确认真实流程实例和操作人。
+
+## 不可猜测
+
+只处理退回申请，不等同于直接退回流程。
+
+## 最小计划
+
+`requestId`、`employeeId`。