weaver-e10-builder 1.6.14 → 1.6.16

package/skill-docs/actionflows/references/components/logic/MultipleExecution.md

@@ -1,38 +1,17 @@
-# 循环（MultipleExecution）
+# 循环组件
 
-循环体通过 `actions` 提供，至少包含一个非 `Output` 动作，当前不支持循环嵌套。
+`MultipleExecution` 支持指定次数（`cycleMode: "1"`）、指定条件（`"2"`）、指定数据逐条循环（`"3"`）和指定数据分批循环（`"4"`）。分页循环暂不支持。
 
-## 循环方式
-
-| `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；尚未自动创建变量及赋值节点时，不生成该模式。
-
-## 示例
+将循环体放在节点顶层 `actions`，至少包含一个执行组件。条件模式传 `params.condition`；逐条模式传 `detailData`；分批模式传 `batchDetailData` 和 `batchSizeData`，固定批次大小为 2–1000。次数和数据来源使用统一动态赋值语义或平台原生 FormulaBean。
 
 ```json
 {
   "type": "MultipleExecution",
-  "params": {
-    "cycleMode": "3",
-    "detailData": {
-      "kind": "context",
-      "source": "event",
-      "paramKey": "<workflowId>.<arrayField>[]"
-    }
-  },
-  "actions": [{ "type": "SendMessage", "params": { "receiver": { "type": "all" }, "msgTitlev": "逐条处理", "msgContentv": "..." } }]
+  "params": { "cycleMode": "1", "cycleTimes": { "kind": "fixed", "value": 3 } },
+  "actions": [{ "type": "<循环体组件>", "params": {} }]
 }
 ```
+
+循环节点及来源组件的动态字段以完整 `getComponentContext` 响应为准，在本地匹配字段；逐条和分批的子字段由来源参数树按父子关系展开。循环体 `scope: "current_loop"` 引用所属循环节点上下文。条件规则在保存动作流前调用平台条件服务持久化。
+
+引用循环内部其他组件的字段时，指定该组件的 `source`，并从其完整上下文中匹配字段；CLI 在最终节点 ID 确定后补齐外层循环路径。当前次循环的保存值包含循环位置，并用 `name` 为“已循环次数”的上下文子公式提供下标；历次循环保留 `[]`。嵌套循环分别处理各层，业务数组原有下标不变。公式的 `source` 指向最外层循环，`config.comId` 指向字段实际所属组件；字段及循环计数字段的 `frontId` 均使用接口返回的 ID。

package/skill-docs/actionflows/references/components/message/InnerMQSend.md

@@ -32,7 +32,7 @@
 
 ### 参数类型与数据类型联动
 
-CLI 生成 `ParamMappingBean`、`ParamSettingBean` 及其分组 DTO 的 `tableData` 时才归一化参数类型：依据后端 `ParamType` 枚举匹配；数字类型统一写 `int`，长整型写 `string`，无法匹配写 `string`。普通 `FormulaBean`、表单字段上下文、循环上下文和 `CustSetFormDto` 不使用这套归一化。如果 `paramType` 为 `json` 或字段开启 `arrs`，`dataType` 强制写为 `node`；普通非数组标量默认写为 `attribute`。
+CLI 生成 `ParamMappingBean`、`ParamSettingBean` 及其分组 DTO 的 `tableData` 时才归一化参数类型：依据后端 `ParamType` 枚举匹配；数字类型统一写 `int`，长整型写 `string`，无法匹配写 `string`。普通 `FormulaBean`、表单字段上下文和 `CustSetFormDto` 不使用这套归一化。如果 `paramType` 为 `json` 或字段开启 `arrs`，`dataType` 强制写为 `node`；普通非数组标量默认写为 `attribute`。
 
 `tableData` 中每一行的 `paramType` 决定 `dataType` 的合法候选和是否允许继续加下级，不能只把 `dataType` 当成一个任意字符串填写：
 
@@ -45,6 +45,10 @@ CLI 生成 `ParamMappingBean`、`ParamSettingBean` 及其分组 DTO 的 `tableDa
 
 ### FormulaBean 动态来源的统一规则
 
-上述参数类型规则只作用于参数 DTO；所有组件的动态字段生成 `FormulaBean` 时，还必须统一遵循五类来源：普通组件上下文取对应 `getComponentContext` 的真实字段；循环体取前端拼出的 `CycleParams` 并保留列表来源；`EsbFormDataDto`、`ParamMappingBean`/`ParamSettingBean`、`CustSetFormDto` 的依据值下级分别使用各自前端的 basisValue/相对 paramKey/parentName 规则。真实字段的 `frontId`、`paramKey`、`parentName`、`newParentName` 不可由字段名或路径尾段猜测，预检无法取得时直接失败。
+上述参数类型规则只作用于参数 DTO；所有组件的动态字段生成 `FormulaBean` 时，还必须统一遵循四类来源：普通组件上下文取对应 `getComponentContext` 的真实字段；`EsbFormDataDto`、`ParamMappingBean`/`ParamSettingBean`、`CustSetFormDto` 的依据值下级分别使用各自前端的 basisValue/相对 paramKey/parentName 规则。真实字段的 `frontId`、`paramKey`、`parentName`、`newParentName` 不可由字段名或路径尾段猜测，预检无法取得时直接失败。
 
-`InnerMQSend` 与触发器 `InnerMQListener` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。
+`InnerMQSend` 与触发器 `InnerMQListener` 不能同时出现在一个动作流中，包括条件内部；CLI 会在创建或更新前拒绝该计划。
+
+## 新建参数的 ID
+
+新建参数设置或映射 DTO 时，在对应参数对象根部指定 `idPolicy: "new"`，CLI 会分配雪花 ID 并同步父子行和依据参数引用。需要引用父行时可用唯一临时 ID 关联；接口返回的已有参数应保留原 ID，不设置此标记。该标记仅供 CLI 使用，不传给后端。

package/skill-docs/actionflows/references/components/message/SendMessage.md

@@ -1,32 +1,32 @@
-# 发送消息（`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` 指定前端 `objType`：`resource`/`user`（人员）、`department`（部门）、`subcompany`（分部）、`role`（角色）、`group`（群组）、`position`（岗位）、`employeeScope`（人员范围）、`employeeShare`（人力资源条件）、`employeeOrganization`（人员组织多选）、`external`（外部联系人）、`all` 或 `allExternal`。固定对象使用 `{type,id,name}`；同一类型多选使用 `persons:[{id,name}]`，也可直接传前端多选 FormulaBean。部门/分部可传 `departmentAttribute` 和 `seclevel`，角色可传 `roleLevel`，岗位可传 `positionLevel`、`positionLevelDepartment`、`positionLevelSubcompany`、`positionAttribute`。动态对象使用 `kind:"context"`、`paramKey` 和 `label`，并可通过 `objectType` 指定非人员类型，例如 `{"type":"department","kind":"context","paramKey":"<真实部门字段paramKey>","label":"所属部门"}`。CLI 会按前端逻辑写入 `shareList` 的 `obj_id` / `obj_id_*` 字段；`objectList` 仅保留旧版兼容数据。模板上下文只传 `paramKey` 和 `label`，由 CLI 按消息编辑器的动态片段结构编译，并绑定当前触发节点。对定时批量、按日期字段、表单数据等 e-builder 记录触发器，未显式提供链接时 CLI 自动生成 `msgPcLink` / `msgMobileLink` 的 PC/移动端详情链接：`formId` 为触发表单 ID 固定值，`dataId` 为上游“数据ID”动态上下文。显式 `msgPcLink` / `msgMobileLink` 会覆盖该默认行为。
-
-动态接收人的 `shareList` 必须以 `targetId: "esbAssign"` 保存，并在对应的 `obj_id` 或 `obj_id_<类型>` 放入真实来源的动态公式；公式 `source`/`config.comId` 指向上游组件，而非提醒对象自身的 `sourceId`。人员变量使用 `{"kind":"variable","id":"<已解析变量ID>"}`；上下文字段必须取自 `getComponentContext`。部门、角色等 `targetType` 按前端对象类型及范围设置计算。固定对象仍以实际对象 ID 作为 `targetId`。
-
-## 最小计划
-
-`receiver`、`msgTitlev`、`msgContentv`。
+# 发送消息（`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` 指定前端 `objType`：`resource`/`user`（人员）、`department`（部门）、`subcompany`（分部）、`role`（角色）、`group`（群组）、`position`（岗位）、`employeeScope`（人员范围）、`employeeShare`（人力资源条件）、`employeeOrganization`（人员组织多选）、`external`（外部联系人）、`all` 或 `allExternal`。固定对象使用 `{type,id,name}`；同一类型多选使用 `persons:[{id,name}]`，也可直接传前端多选 FormulaBean。部门/分部可传 `departmentAttribute` 和 `seclevel`，角色可传 `roleLevel`，岗位可传 `positionLevel`、`positionLevelDepartment`、`positionLevelSubcompany`、`positionAttribute`。动态对象使用 `kind:"context"`、`paramKey` 和 `label`，并可通过 `objectType` 指定非人员类型，例如 `{"type":"department","kind":"context","paramKey":"<真实部门字段paramKey>","label":"所属部门"}`。CLI 会按前端逻辑写入 `shareList` 的 `obj_id` / `obj_id_*` 字段；`objectList` 仅保留旧版兼容数据。模板上下文只传 `paramKey` 和 `label`，由 CLI 按消息编辑器的动态片段结构编译，并绑定当前触发节点。对定时批量、按日期字段、表单数据等 e-builder 记录触发器，未显式提供链接时 CLI 自动生成 `msgPcLink` / `msgMobileLink` 的 PC/移动端详情链接：`formId` 为触发表单 ID 固定值，`dataId` 为上游“数据ID”动态上下文。显式 `msgPcLink` / `msgMobileLink` 会覆盖该默认行为。
+
+动态接收人的 `shareList` 必须以 `targetId: "esbAssign"` 保存，并在对应的 `obj_id` 或 `obj_id_<类型>` 放入真实来源的动态公式；公式 `source`/`config.comId` 指向上游组件，而非提醒对象自身的 `sourceId`。人员变量使用 `{"kind":"variable","id":"<已解析变量ID>"}`；上下文字段必须取自 `getComponentContext`。部门、角色等 `targetType` 按前端对象类型及范围设置计算。固定对象仍以实际对象 ID 作为 `targetId`。
+
+## 最小计划
+
+`receiver`、`msgTitlev`、`msgContentv`。

package/skill-docs/actionflows/references/components/personnel/HrmEmployeeUpdate.md

@@ -19,6 +19,7 @@
 - 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
 - 生成的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `update_original` 模式：主表、明细表都会按实时字段定义生成完整骨架，未修改主表字段为 `{"formFieldKey":"","value":{"original":true}}`，未修改明细字段为 `{"formFieldKey":"","value":{"original":true,"assign":null}}`。
 - `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields=[]`，每张输出的明细表带 `deleteFields=[]`；动态赋值字段、原值占位字段和 DTO 外壳都由公共生成器处理。
+- 配置 `fieldAssignments.detail` 时，至少一个字段必须引用真实的来源表单明细上下文；CLI 从该字段已解析的上下文公式自动生成 `setting.detail[].basisValue`。若无法从上下文确认唯一来源明细，生成会报错，不会猜测依据值。设计器回读校验也会检查明细依据值和字段赋值。
 
 ## 语义计划形状
 

package/skill-docs/actionflows/references/components/personnel/PersonnelOnboarding.md

@@ -16,6 +16,7 @@
 - plan 传 `fieldAssignments`，CLI 交给通用 `EsbFormDataDto` 生成器，根据实时字段定义生成平台 `setting`；不允许手写 `setting` / `EsbFormDataDto`。
 - 编译后的 `setting` 统一使用通用 `EsbFormDataDto` 生成逻辑，并使用 `create` 模式：主表、明细表都会按实时字段定义生成完整骨架，未赋值主表字段为 `{"formFieldKey":""}`，未赋值明细字段为 `{"formFieldKey":"","value":{"assign":null}}`。
 - `setting` 统一补充 `dataDrWithCalc=false`、`deleteMainFields:[]`；每张输出的明细表带 `deleteFields:[]`。动态赋值字段和空字段都由公共生成器处理，入职组件不重复实现 DTO 保存逻辑。
+- 配置 `fieldAssignments.detail` 时，至少一个字段必须引用真实的来源表单明细上下文；CLI 从该字段已解析的上下文公式自动生成 `setting.detail[].basisValue`。若无法从上下文确认唯一来源明细，生成会报错，不会猜测依据值。设计器回读校验也会检查明细依据值和字段赋值。
 - 字段可用显示名或字段 ID。当前租户出现同名字段时必须使用字段 ID。
 - Browser 字段（部门、岗位、上级等）只接受其对应选择器返回的真实对象，不能把名称或 ID 当文本填入。
 - 未提供当前租户必填字段、或字段/取值无法解析时，停止生成并报告缺项。

package/skill-docs/actionflows/references/components/serverless/ServerlessAction.md

@@ -40,3 +40,7 @@
 - `request` 必须使用前端输入参数配置生成的原生 `ParamMappingBean`；`response` 必须使用前端输出参数配置生成的原生 `ParamSettingBean`。
 - 参数行的 `id`、`parentId`、`paramKey`、`paramType`、`dataType` 和前端高级配置会被保留；缺失的参数表/字段 ID 由 CLI 补齐，不能用语义字符串替代原生结构。
 - 二开动作执行后，可以引用 `Response.entry.<字段>` 上下文；请求参数上下文使用 `Request.entry.<字段>`。
+
+## 新建参数的 ID
+
+新建参数设置或映射 DTO 时，在对应参数对象根部指定 `idPolicy: "new"`，CLI 会分配雪花 ID 并同步父子行和依据参数引用。需要引用父行时可用唯一临时 ID 关联；接口返回的已有参数应保留原 ID，不设置此标记。该标记仅供 CLI 使用，不传给后端。

package/skill-docs/actionflows/references/components/trigger/CustomTrigger.md

@@ -55,17 +55,17 @@
 
 ## 自定义参数来源的 `frontId` 规则
 
-动态赋值来源于当前触发组件的 `customData` 时，必须把 `event.params.customData`（后端类型 `CustSetFormDto`）作为唯一 ID 来源。不要从目标字段、FormulaBean 自身的 `id` 或 `paramKey` 尾段推导 `frontId`。
+动态赋值来源于自定义触发器时，先通过 `getComponentContext` 查询，使用选中参数行返回的 `ParamBean.id` 作为 `frontId`。不要从目标字段、FormulaBean 自身的 `id` 或 `paramKey` 尾段推导。
 
 按以下顺序生成：
 
-1. 先按动态引用的表路径，在 `customData.tableList[]` 中找到对应的表对象（后端类型 `CustFormTableDto`）。
-2. 如果引用选择的是表维度（例如 `主表key.明细表key[]`），生成的 FormulaBean 写 `frontId = tableList[].id`。
-3. 如果引用选择的是字段维度（例如 `主表key.字段key` 或 `主表key.明细表key[].字段key`），先在匹配表的 `fields[]` 中找到对应字段对象（后端类型 `CustFormDetailDto`），再写 `frontId = fields[].id`。
+1. 根据完整参数路径，在接口返回的分组和参数行中唯一匹配实际选择的上下文。
+2. 选择表维度时使用对应表参数行的 `id`。
+3. 选择字段维度时使用对应字段参数行的 `id`。
 4. 这个 `frontId` 要写到关联映射生成的 FormulaBean 上，包括普通动作映射和终止组件 `customParamSetting.tableList[].fields[].formulaValue`；不能写目标字段 ID、表名、字段名、临时公式 ID 或 `paramKey` 尾段。
-5. 对应表/字段没有真实 ID 时，`frontId` 写空串 `""`；有值时必须是纯数字字符串。`field_<数字>` 只能在生成时转成 `<数字>`。
+5. 对应表/字段没有真实 ID 时停止生成并提示查询上下文；有值时原样使用接口返回的 ID，不从 `field_` 前缀或参数路径推导。
 
-例如：
+例如，若接口返回表参数行 ID 为 `1001`、字段参数行 ID 为 `2001`，并与 `customData` 中的 ID 对应：
 
 ```json
 {

package/skill-docs/actionflows/references/components/trigger/InnerMQListener.md

@@ -1,41 +1,46 @@
-# 内置 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 会在创建或更新前拒绝该计划。
+# 内置 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:[]}` 期待它自动生成输入字段。
+- 接收明细数组时，父参数行设置 `paramType:"json"`、`dataType:"node"`、`arrs:true`；每个明细字段的 `parentId` 指向该父行的 `id`。参数名称可以使用语义名称。配置完成后通过 `component-context-fields` 查询实际返回的路径和字段 ID，明细依据值使用对应父行的真实上下文 ID，不按名称推导。
+- 参数表中的“高级设置”（命名空间、默认值、敏感词等）目前没有独立的 CLI 参数或生成校验；如果已经取得平台完整的 `receiveParams` 原生对象，CLI 会随对象透传，但不会根据简化字段替你创建这些配置。
+
+根触发器图标不是猜测的 `Icon-message-queue`，平台内置 MQ 监听实际使用 `Icon-built-in-mq-listening-mcolor`；不要把发送动作的图标当成监听触发器图标。
+
+`InnerMQListener` 与动作 `InnerMQSend` 不能同时出现在一个动作流中，包括条件内部；CLI 会在创建或更新前拒绝该计划。
+
+## 新建参数的 ID
+
+新建参数设置或映射 DTO 时，在对应参数对象根部指定 `idPolicy: "new"`，CLI 会分配雪花 ID 并同步父子行和依据参数引用。需要引用父行时可用唯一临时 ID 关联；接口返回的已有参数应保留原 ID，不设置此标记。该标记仅供 CLI 使用，不传给后端。

package/skill-docs/actionflows/references/components/trigger/WebHookTrigger.md

@@ -107,3 +107,7 @@ Webhook 触发的终止节点使用 `finalOutput.params.webhookCustomParamSettin
   }
 }
 ```
+
+## 新建参数的 ID
+
+新建参数设置或映射 DTO 时，在对应参数对象根部指定 `idPolicy: "new"`，CLI 会分配雪花 ID 并同步父子行和依据参数引用。需要引用父行时可用唯一临时 ID 关联；接口返回的已有参数应保留原 ID，不设置此标记。该标记仅供 CLI 使用，不传给后端。

package/skill-docs/actionflows/references/components/workflow/ApproveTrigger.md

@@ -1,99 +1,99 @@
-# 流程触发（`ApproveTrigger`）
-
-## 同一流程的多条触发规则
-
-平台的“动作执行节点/出口”窗口可为同一个流程添加多行规则；不要把它误拆成多个动作流。计划用 `triggerRules` 表达：
-
-```json
-{
-  "workflowPath": {"id":"<流程id>","name":"<流程名>"},
-  "triggerRules": [
-    {"triggerTiming":"leave","approveNode":{"id":"<发起节点id>","name":"发起节点"}},
-    {"triggerTiming":"arrive","nodeTime":"2","approveNode":{"id":"<发起节点id>","name":"发起节点"}},
-    {"triggerTiming":"workflow_completed","approveNode":{"id":"<结束节点id>","name":"结束节点"}}
-  ]
-}
-```
-
-CLI 会逐条校验真实节点/出口及其允许的执行时间，并写入同一流程的 `singleApproveConfigs[workflowId]` 数组。未传 `triggerRules` 时，才使用原来的单条 `triggerTiming` 写法。
-
-## 活动版本
-
-动作执行节点/出口窗口里的“活动版本”对应触发规则中 `nodeOrLinkName[0].versionId`。可在计划中传 `workflowVersionId` 指定真实版本 ID：
-
-```json
-{
-  "workflowPath": {"id":"<流程id>","name":"<流程名>"},
-  "workflowVersionId": "<流程节点浏览接口返回的真实versionId>",
-  "triggerTiming": "submitted",
-  "approveNode": {"id":"<真实发起节点id>","name":"发起节点"}
-}
-```
-
-`workflowVersionId` 只能使用流程节点浏览接口返回的真实 `versionId`，CLI 会按流程、节点和版本一起校验；不传时沿用真实 `approveNode` 携带的版本。不会猜测或生成版本 ID。出口规则同样把真实版本写入 `nodeOrLinkName[0]`。
-
-## 多时机触发不同动作时，先按触发上下文分支
-
-多条规则触发的仍是**同一张动作流画布**，因此不能把“新增 / 删除 / 更新”三个动作直接串在主链上。应在事件后的第一个节点放 `Condition`，用流程触发器实时输出的字段路由：
-
-- `triggerType`：`pre`（节点前）、`after`（节点后）、`link`（出口）等；
-- `executeTime`：例如 `2` 表示返回到达；
-- `triggerNodeOrLinkId`：实际触发的节点或出口 ID。
-
-例如“发起节点离开新增、返回到达删除、结束节点正向到达更新”写成三条互斥分支：
-
-```text
-triggerNodeOrLinkId = 发起节点 AND triggerType = after AND executeTime = 1  -> 新建
-triggerNodeOrLinkId = 发起节点 AND triggerType = pre   AND executeTime = 2  -> 删除
-triggerNodeOrLinkId = 结束节点 AND triggerType = pre   AND executeTime = 1  -> 更新
-```
-
-以上三个字段必须从当前流程触发器的 `getComponentContext` 返回结果取真实 `paramKey`，不要手写成业务表单字段。
-
-## 何时使用
-
-由流程提交、审批、结束等时机触发动作流。
-
-## 先查询
-
-查询真实流程、节点和当前时机的 `workflow-context-fields`。
-
-## 不可猜测
-
-后续动态引用只使用本次返回的 `paramKey`；多流程触发按组件契约提供真实列表。
-
-## 最小计划
-
-`workflowPath`、`triggerTiming`；节点型时机提供真实 `approveNode`，出口型时机提供真实 `approveLink`。
-
-## 触发时机
-
-plan 统一使用：`arrive`（节点前/到达）、`submitted`（流程提交）、`approve_passed`（审批通过）、`workflow_completed`（流程结束）、`leave`、`link`、`delete`、`save`、`revert`、`pause`、`cancel`。中文界面名称可输入，CLI 会归一为上述值后再查询并校验对应的真实流程节点；不能按“第一个节点”猜测时机。
-
-## 类型联动：可选节点/出口与执行时间
-
-| `triggerTiming` | 可选对象 | `nodeTime` |
-|---|---|---|
-| `submitted` | 仅发起节点（nodeType=0） | 仅正向到达（1） |
-| `approve_passed` | 审批/中间节点（1/2/5） | 不使用 |
-| `workflow_completed` | 仅结束节点（3） | 仅正向到达（1） |
-| `arrive` | 当前流程真实节点（0/1/2/3/5） | 结束节点可选 1/2/3/4/5/6；其他节点 1/2/3/4/6 |
-| `leave` | 当前流程真实节点（0/1/2/3/5） | 1/2/3/6 |
-| `link` | 仅当前流程真实出口 `approveLink` | 不使用 |
-| `pause` | 发起/审批/中间节点（0/1/2/5） | 1/2 |
-| `cancel` | 当前流程真实节点（0/1/2/3/5） | 1/2 |
-| `delete` / `save` / `revert` | 当前流程真实节点（0/1/2/3/5） | 不使用 |
-
-出口不能使用 `approveNode`，也不自动选择“第一条出口”；需求未指定出口时必须先查并追问。
-
-## 执行时间（节点前 / 节点后）
-
-节点型触发可传 `nodeTime`，其值和设计器下拉框一致：`1` 正向流转到达、`2` 返回到达、`3` 强制收回到达、`4` 撤回到达、`5` 强制结束到达、`6` 干预到达。
-
-例如，要在某节点**返回到达**时触发，使用真实节点和 `nodeTime:"2"`：
-
-```json
-{"workflowPath":{"id":"<流程ID>","name":"<流程名>"},"triggerTiming":"arrive","approveNode":{"id":"<真实节点ID>","nodeType":1},"nodeTime":"2"}
-```
-
-`revert` 是“流程还原时”，与节点执行时间中的“返回到达”不是同一事件。
+# 流程触发（`ApproveTrigger`）
+
+## 同一流程的多条触发规则
+
+平台的“动作执行节点/出口”窗口可为同一个流程添加多行规则；不要把它误拆成多个动作流。计划用 `triggerRules` 表达：
+
+```json
+{
+  "workflowPath": {"id":"<流程id>","name":"<流程名>"},
+  "triggerRules": [
+    {"triggerTiming":"leave","approveNode":{"id":"<发起节点id>","name":"发起节点"}},
+    {"triggerTiming":"arrive","nodeTime":"2","approveNode":{"id":"<发起节点id>","name":"发起节点"}},
+    {"triggerTiming":"workflow_completed","approveNode":{"id":"<结束节点id>","name":"结束节点"}}
+  ]
+}
+```
+
+CLI 会逐条校验真实节点/出口及其允许的执行时间，并写入同一流程的 `singleApproveConfigs[workflowId]` 数组。未传 `triggerRules` 时，才使用原来的单条 `triggerTiming` 写法。
+
+## 活动版本
+
+动作执行节点/出口窗口里的“活动版本”对应触发规则中 `nodeOrLinkName[0].versionId`。可在计划中传 `workflowVersionId` 指定真实版本 ID：
+
+```json
+{
+  "workflowPath": {"id":"<流程id>","name":"<流程名>"},
+  "workflowVersionId": "<流程节点浏览接口返回的真实versionId>",
+  "triggerTiming": "submitted",
+  "approveNode": {"id":"<真实发起节点id>","name":"发起节点"}
+}
+```
+
+`workflowVersionId` 只能使用流程节点浏览接口返回的真实 `versionId`，CLI 会按流程、节点和版本一起校验；不传时沿用真实 `approveNode` 携带的版本。不会猜测或生成版本 ID。出口规则同样把真实版本写入 `nodeOrLinkName[0]`。
+
+## 多时机触发不同动作时，先按触发上下文分支
+
+多条规则触发的仍是**同一张动作流画布**，因此不能把“新增 / 删除 / 更新”三个动作直接串在主链上。应在事件后的第一个节点放 `Condition`，用流程触发器实时输出的字段路由：
+
+- `triggerType`：`pre`（节点前）、`after`（节点后）、`link`（出口）等；
+- `executeTime`：例如 `2` 表示返回到达；
+- `triggerNodeOrLinkId`：实际触发的节点或出口 ID。
+
+例如“发起节点离开新增、返回到达删除、结束节点正向到达更新”写成三条互斥分支：
+
+```text
+triggerNodeOrLinkId = 发起节点 AND triggerType = after AND executeTime = 1  -> 新建
+triggerNodeOrLinkId = 发起节点 AND triggerType = pre   AND executeTime = 2  -> 删除
+triggerNodeOrLinkId = 结束节点 AND triggerType = pre   AND executeTime = 1  -> 更新
+```
+
+以上三个字段必须从当前流程触发器的 `getComponentContext` 返回结果取真实 `paramKey`，不要手写成业务表单字段。
+
+## 何时使用
+
+由流程提交、审批、结束等时机触发动作流。
+
+## 先查询
+
+查询真实流程、节点和当前时机的 `workflow-context-fields`。
+
+## 不可猜测
+
+后续动态引用只使用本次返回的 `paramKey`；多流程触发按组件契约提供真实列表。
+
+## 最小计划
+
+`workflowPath`、`triggerTiming`；节点型时机提供真实 `approveNode`，出口型时机提供真实 `approveLink`。
+
+## 触发时机
+
+plan 统一使用：`arrive`（节点前/到达）、`submitted`（流程提交）、`approve_passed`（审批通过）、`workflow_completed`（流程结束）、`leave`、`link`、`delete`、`save`、`revert`、`pause`、`cancel`。中文界面名称可输入，CLI 会归一为上述值后再查询并校验对应的真实流程节点；不能按“第一个节点”猜测时机。
+
+## 类型联动：可选节点/出口与执行时间
+
+| `triggerTiming` | 可选对象 | `nodeTime` |
+|---|---|---|
+| `submitted` | 仅发起节点（nodeType=0） | 仅正向到达（1） |
+| `approve_passed` | 审批/中间节点（1/2/5） | 不使用 |
+| `workflow_completed` | 仅结束节点（3） | 仅正向到达（1） |
+| `arrive` | 当前流程真实节点（0/1/2/3/5） | 结束节点可选 1/2/3/4/5/6；其他节点 1/2/3/4/6 |
+| `leave` | 当前流程真实节点（0/1/2/3/5） | 1/2/3/6 |
+| `link` | 仅当前流程真实出口 `approveLink` | 不使用 |
+| `pause` | 发起/审批/中间节点（0/1/2/5） | 1/2 |
+| `cancel` | 当前流程真实节点（0/1/2/3/5） | 1/2 |
+| `delete` / `save` / `revert` | 当前流程真实节点（0/1/2/3/5） | 不使用 |
+
+出口不能使用 `approveNode`，也不自动选择“第一条出口”；需求未指定出口时必须先查并追问。
+
+## 执行时间（节点前 / 节点后）
+
+节点型触发可传 `nodeTime`，其值和设计器下拉框一致：`1` 正向流转到达、`2` 返回到达、`3` 强制收回到达、`4` 撤回到达、`5` 强制结束到达、`6` 干预到达。
+
+例如，要在某节点**返回到达**时触发，使用真实节点和 `nodeTime:"2"`：
+
+```json
+{"workflowPath":{"id":"<流程ID>","name":"<流程名>"},"triggerTiming":"arrive","approveNode":{"id":"<真实节点ID>","nodeType":1},"nodeTime":"2"}
+```
+
+`revert` 是“流程还原时”，与节点执行时间中的“返回到达”不是同一事件。

package/skill-docs/actionflows/references/dynamic_capability_matrix.md

@@ -6,7 +6,7 @@
 
 | 属性类型 | 代表组件/属性 | 支持的动态来源 | 编译结果 |
 | --- | --- | --- | --- |
-| 普通字段赋值 | `ActionEbAdd`、`ActionEbUpdate`（含密级、密级有效期）、`HrmEmployeeUpdate.fieldAssignments`、`PersonnelOnboarding.fieldAssignments` | 上下文、循环当前行、系统变量、变量、常量、函数/公式 | 按目标字段类型生成 `type=3/5/6/7/8/9/10` 等 FormulaBean |
+| 普通字段赋值 | `ActionEbAdd`、`ActionEbUpdate`（含密级、密级有效期）、`HrmEmployeeUpdate.fieldAssignments`、`PersonnelOnboarding.fieldAssignments` | 上下文、系统变量、变量、常量、函数/公式 | 按目标字段类型生成 `type=3/5/6/7/8/9/10` 等 FormulaBean |
 | 查询结果字段 | `EnquiryForm` 输出被后续动作引用 | 查询结果字段、第一条记录 `index:0`、函数参数 | 使用查询节点真实 `source`、字段真实 ID 和平台结果字段对象 |
 | 查询分页与动态条件 | `EnquiryForm.formPageNo`、`formPageSize`、`conditionFormula` | 固定值、上下文、系统变量、变量、常量、函数/公式 | 页码/条数为 FormulaBean；动态条件使用 `conditionType:"assign"`，不能和普通 `filter` 并存 |
 | HTTP 请求参数 | `Http.inputParams.formulaData` | 固定值、上下文、系统变量、变量、常量、函数/公式 | 写入接口详情对应参数行的 FormulaBean，不改写接口参数定义 |
@@ -17,7 +17,6 @@
 | 人员参数 | 表单数据动作、流程动作、文档动作、`HrmEmployeeUpdate`、`PersonnelOnboarding`、`AlterPersonStatus`、会议/日程中的人员属性 | 当前用户、上游人员上下文、动作流变量/常量/函数 | 不再强制走固定人员查询；动态引用保持人员 FormulaBean，固定人员仍要求真实 Browser 对象 |
 | 会议和日程运行时字段 | `MeetingCreate` 的标题/密级/人员/关联标识，`ScheduleCreate` 的标题/时间/内容/其他地点/人员/日程类型/会议室 | 上下文、系统变量、变量、常量、函数/公式 | 后端 DTO 中的 FormulaBean 字段统一支持动态赋值；固定会议/日程资源仍保留 Browser 对象兼容 |
 | 流程和文档运行时字段 | 流程实例 ID、标题、意见、公文正文 ID、关联数据 ID、时间、文档/附件 ID、布尔开关等 `formula_or_reference` 属性 | 固定值、上下文、系统变量、变量、常量、查询结果、函数/公式 | 统一经共享公式编译器生成 FormulaBean；固定流程定义、节点、目录 DTO 不在此列 |
-| 循环参数 | `MultipleExecution.cycleTimes`、`batchSizeData`、`pageCycleData`、列表/明细来源 | 上下文、变量、常量、当前循环上下文 | 后端 FormulaBean 字段统一支持动态赋值；固定批量大小继续校验 2-1000，分页标志继续校验布尔类型 |
 | 条件右值 | `Condition` | 固定值、上下文、系统变量、变量、常量、函数 | 右值保留为公式树，不把动态字段名转成固定字符串 |
 | 终止节点动态输出 | `finalOutput.params.reminderContent`、`basisValue` | 富文本 `ContestSettingDTO`；提醒内容支持文本、上下文、系统变量、变量、常量、查询结果、函数/公式 | 自动补充的 `Output` 节点保留高级设置，无需在 `actions` 中手写终止节点；旧 `reminderMsgFormula` 不再用于新生成 |
 
@@ -35,5 +34,5 @@
 1. 先执行 `component-describe <type>`，读取该属性的 `valueType`、`referenceType`、`valueShape`、`propertySources` 和运行时上下文。
 2. 若属性是字段值、人员值或公式值，优先调用共享公式编译器；不得在组件内部另写“只接受固定值”的分支。
 3. 若属性是平台资源对象，必须查看该组件前端回读/保存 DTO 是否有动态入口；没有证据就保留固定对象约束，并明确指出是平台协议限制，而不是 Skill 偷懒。
-4. 每新增一个动态属性，至少增加一个上下文用例和一个固定值回归用例；涉及数组/循环时再增加数组或当前循环用例。
-5. 生成成功不等于动态赋值正确：正式回读必须确认参数仍为对应 FormulaBean，来源 `paramKey`、`source/frontId`、变量/常量 ID 和循环作用域没有丢失。
+4. 每新增一个动态属性，至少增加一个上下文用例和一个固定值回归用例；涉及数组时再增加数组用例。
+5. 生成成功不等于动态赋值正确：正式回读必须确认参数仍为对应 FormulaBean，来源 `paramKey`、`source/frontId`、变量/常量 ID 没有丢失。

package/skill-docs/actionflows/references/function_rules.md

@@ -12,4 +12,8 @@
 
 生成时仅对实际使用的函数调用当前租户接口，校验可用性并获取当次函数 ID。
 
-消息标题/内容、循环和条件各有专用 DTO；只有对应组件说明明确支持函数树时才使用，不能因为它们也显示“动态赋值”就套用通用函数结构。
+使用 `e10-cli actionflow function-list '{"name":"CONCATENATE"}'` 查询当前租户的函数契约；不传 `name` 返回全部标准函数。函数 ID 及参数元数据以本次实时接口结果为准，不得手抄内置快照 ID。
+
+原生函数 FormulaBean 的 `config.paramSize` 来自函数目录，是函数声明的参数协议，不是本次参数个数，例如租户目录返回 `-1` 时必须保留 `-1`。通过 `update` 修改函数时，优先在正式回读结构上修改业务值，保留 `excelFunc`、参数位置和函数契约；本次修改涉及的函数会对照实时目录校验。`update` 的语义函数目前支持固定值、变量、常量、系统变量及嵌套函数；上下文参数须先查询真实上下文并使用完整平台公式。
+
+消息标题/内容和条件各有专用 DTO；只有对应组件说明明确支持函数树时才使用，不能因为它们也显示“动态赋值”就套用通用函数结构。

package/skill-docs/actionflows/references/trigger_runtime_notes.md

@@ -37,7 +37,7 @@
 `ActionEbUpdate` 等数据动作的筛选条件（filterCondition）右值走上下文引用时，条件对象里的 `esbAssign.wId` 字段**必须指向「当前节点」**（filterInput 所属的数据动作节点 id），**不能指向上游 event 节点**。
 
 - 设计器打开「动态赋值」对话框时，用 `esbAssign.wId` 在 `orginFlowDatas` 里定位当前组件；指向 event 节点 → 定位不到 → 右侧「暂无数据」（EmptyView，不可编辑/不可选）。
-- `value.source` / `config.comId` 仍指向 event 节点（公式来源，不变）；只有 `esbAssign.wId` 单独用当前节点 id。
+- `value.source` / `config.comId` 指向提供上下文的组件节点；来源是触发器时指向 event，来源是其他组件时指向实际来源节点。`esbAssign.wId` 指向当前节点。
 - 判断口径：读回后 `esbAssign.wId` 应等于该 ActionEbAdd/Update/Delete 节点的 `id`，不等于 `event.id`。
 
 ## 4b. 同类问题全量修复：mapping / updateId / basisValue / 明细依据值下级 / updateFieldCondition / requestName 的上下文公式也要 `esbAssign.wId`（真机验证 2026-08-18）