weaver-e10-builder 1.1.8 → 1.2.2

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

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

@@ -1,32 +1,32 @@
-# 更新人员
-
-组件类型：`HrmEmployeeUpdate`。先运行 `component-describe HrmEmployeeUpdate`。
-
-## 何时使用
-
-用于更新一个已有人员的资料。它不创建人员；需要新增人员时使用 `PersonnelOnboarding`。只变更在职/离职状态时使用 `AlterPersonStatus`。
-
-## 生成前查询
-
-1. 使用 `recipient-search` 分别取得操作人和待更新人员的当前租户 Browser 原对象。
-2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员字段定义。
-
-## 业务边界
-
-- `operators`、`person` 均为固定人员 Browser 原对象；本组件设计器不支持以动态上下文代替它们。
-- plan 只传 `fieldAssignments`，CLI 基于实时定义生成平台 `setting`；不允许手写 DTO。
-- Browser 字段必须匹配字段的真实选择器对象；字段名重名时必须传字段 ID。
-- 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
-
-## 语义计划形状
-
-```json
-{
-  "type": "HrmEmployeeUpdate",
-  "params": {
-    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
-    "person": {"id": "<真实人员ID>", "name": "<真实姓名>"},
-    "fieldAssignments": {"main": {"邮箱": "zhangsan@example.com"}}
-  }
-}
-```
+# 更新人员
+
+组件类型：`HrmEmployeeUpdate`。先运行 `component-describe HrmEmployeeUpdate`。
+
+## 何时使用
+
+用于更新一个已有人员的资料。它不创建人员；需要新增人员时使用 `PersonnelOnboarding`。只变更在职/离职状态时使用 `AlterPersonStatus`。
+
+## 生成前查询
+
+1. 固定人员时使用 `recipient-search` 分别取得操作人和待更新人员的当前租户 Browser 原对象；动态人员时改用真实人员字段上下文或当前用户系统变量。
+2. 使用 `hrm-onboarding-fields '{}'` 取得当前租户人员字段定义。
+
+## 业务边界
+
+- `operators`、`person` 支持固定人员 Browser 原对象、当前用户、上游人员上下文以及已解析的变量/常量/函数公式。固定人员仍必须是真实 Browser 对象，动态引用不能手输人员 ID。
+- plan 只传 `fieldAssignments`，CLI 基于实时定义生成平台 `setting`；不允许手写 DTO。
+- Browser 字段必须匹配字段的真实选择器对象；字段名重名时必须传字段 ID。
+- 至少提供一个待更新字段；字段、对象或必填约束无法解析时，停止生成。
+
+## 语义计划形状
+
+```json
+{
+  "type": "HrmEmployeeUpdate",
+  "params": {
+    "operators": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "person": {"id": "<真实人员ID>", "name": "<真实姓名>"},
+    "fieldAssignments": {"main": {"邮箱": "zhangsan@example.com"}}
+  }
+}
+```

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

@@ -1,40 +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:[]}` 期待它自动生成输入字段。
-
-根触发器图标不是猜测的 `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:[]}` 期待它自动生成输入字段。
+- 参数表中的“高级设置”（命名空间、默认值、敏感词等）目前没有独立的 CLI 参数或生成校验；如果已经取得平台完整的 `receiveParams` 原生对象，CLI 会随对象透传，但不会根据简化字段替你创建这些配置。
+
+根触发器图标不是猜测的 `Icon-message-queue`，平台内置 MQ 监听实际使用 `Icon-built-in-mq-listening-mcolor`；不要把发送动作的图标当成监听触发器图标。
+
+`InnerMQListener` 与动作 `InnerMQSend` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。

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

@@ -1,17 +1,19 @@
-# 简单定时器（`SimpleScheduler`）
-
-## 何时使用
-
-按 Quartz Cron 表达式定时触发。
-
-## 先查询
-
-无需外部对象；确认业务时间规则。
-
-## 不可猜测
-
-只传 `cornString`，例如每天 10:00：`0 0 10 * * ?`。不传 `rate/day/cycle/hour` 等历史调度参数。
-
-## 最小计划
-
-`cornString`。
+# 简单定时器（`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/skill-docs/actionflows/references/components/workflow/ApproveCreate.md

@@ -1,17 +1,17 @@
-# 新建流程（`ApproveCreate`）
-
-## 何时使用
-
-发起一个新的独立流程，不用于保存或提交已有流程。
-
-## 先查询
-
-查询目标流程、目标流程表单字段及发起人。
-
-## 不可猜测
-
-目标流程必须带真实表单字段；标题可固定、上下文或系统变量，映射目标字段不能猜。
-
-## 最小计划
-
-`workflowPath`、`operator`、`requestName`；按需求补充表单赋值。
+# 新建流程（`ApproveCreate`）
+
+## 何时使用
+
+发起一个新的独立流程，不用于保存或提交已有流程。
+
+## 先查询
+
+查询目标流程、目标流程表单字段及发起人。
+
+## 不可猜测
+
+目标流程必须带真实表单字段；标题可固定、上下文或系统变量，映射目标字段不能猜。
+
+## 最小计划
+
+`workflowPath`、`operator`、`requestName`；按需求补充表单赋值。`requestName`、`remark`、`odocId`、`dataId`、`secretLevel`、`secretLevelValidity` 均支持统一动态赋值；流程定义和退回节点仍必须使用真实 Browser/节点对象。

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

@@ -1,17 +1,19 @@
-# 删除流程（`ApproveDelete`）
-
-## 何时使用
-
-将指定流程实例移入回收站；永久删除使用 `ApproveCompletelyDelete`。
-
-## 先查询
-
-确认真实实例和操作人。
-
-## 不可猜测
-
-删除实例具有副作用，实例来源必须可追溯。
-
-## 最小计划
-
-`requestId`、`operator`。
+# 删除流程（`ApproveDelete`）
+
+## 何时使用
+
+将指定流程实例移入回收站。单个动态“数据 ID”可直接作为 `requestId`，CLI 会按平台协议封装成数组公式。
+
+当前平台只注册此删除组件；**不支持“彻底删除流程”**。不得生成或使用 `ApproveCompletelyDelete`，否则设计器保存会报组件内部异常。
+
+## 先查询
+
+确认真实实例和操作人。
+
+## 不可猜测
+
+删除实例具有副作用，实例来源必须可追溯。
+
+## 最小计划
+
+`requestId`、`operator`。

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

@@ -1,17 +1,19 @@
-# 委托流程（`ApproveEntrust`）
-
-## 何时使用
-
-将某人的流程委托给另一人代办。
-
-## 先查询
-
-查询操作人、委托人、受托人，并由预检读取该委托人的真实可用身份。
-
-## 不可猜测
-
-`identityId` 必须由当前租户返回；不能根据名称推断身份或范围。
-
-## 最小计划
-
-`operator`、`entrustUser`、`consignee`、`identityId`、`entrustType`。
+# 委托流程（`ApproveEntrust`）
+
+## 何时使用
+
+将某人的流程委托给另一人代办。
+
+## 先查询
+
+查询操作人、委托人、受托人，并由预检读取该委托人的真实可用身份。
+
+## 不可猜测
+
+`identityId` 必须由当前租户返回；不能根据名称推断身份或范围。
+
+两张设置表必须使用平台固定业务键（如 `entrustUserId`、`consigneeId`、`entrustType`、`approveId`）保存；预检返回的字段实例 ID 只能用于识别字段，不能作为 `setting.main` 的键，否则设计器会显示为空。
+
+## 最小计划
+
+`operator`、`entrustUser`、`consignee`、`identityId`、`entrustType`。

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

@@ -1,17 +1,17 @@
-# 保存流程（`ApproveSave`）
-
-## 何时使用
-
-保存已有流程及其表单数据，不执行审批提交。
-
-## 先查询
-
-查询流程定义、实例上下文和操作人。
-
-## 不可猜测
-
-实例 ID 与流程定义不可互换；表单赋值的目标字段必须来自真实流程表单。
-
-## 最小计划
-
-`workflowPath`、`requestId`、`operator`；按需求补充赋值。
+# 保存流程（`ApproveSave`）
+
+## 何时使用
+
+保存已有流程及其表单数据，不执行审批提交。
+
+## 先查询
+
+查询流程定义、实例上下文和操作人。
+
+## 不可猜测
+
+实例 ID 与流程定义不可互换；表单赋值的目标字段必须来自真实流程表单。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`operator`；按需求补充赋值。`requestId`、`requestName`、`remark`、`odocId`、`dataId` 和 `onlySaveForm` 都支持统一动态赋值。

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

@@ -1,84 +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` 写法。
-
-## 多时机触发不同动作时，先按触发上下文分支
-
-多条规则触发的仍是**同一张动作流画布**，因此不能把“新增 / 删除 / 更新”三个动作直接串在主链上。应在事件后的第一个节点放 `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

@@ -0,0 +1,39 @@
+# 动作流组件属性级动态赋值矩阵
+
+这份矩阵约束 Skill 的决策方式：**是否支持动态赋值取决于具体组件的具体属性**，不是取决于属性名里是否出现 Browser。矩阵只记录已经在 CLI 编译器和测试中接通的能力；平台新版本新增能力时，先补组件契约、编译器和测试，再把状态改为“已接通”。
+
+## 已接通
+
+| 属性类型 | 代表组件/属性 | 支持的动态来源 | 编译结果 |
+| --- | --- | --- | --- |
+| 普通字段赋值 | `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，不改写接口参数定义 |
+| MQ 发送参数 | `InnerMQSend.queueName`、`inputParams` | 固定值、上下文、系统变量、变量、常量、查询结果、函数/公式 | 保留原生 `sendParams` 参数定义，只向命中的参数行写入 `formulaData` |
+| DML SQL 参数 | `DMLExecute.fieldSet.assign` | 固定值、上下文、系统变量、变量、常量、查询结果、函数/公式 | 按 SQL 占位符生成 FormulaBean 数组，同时保留原生 FormulaBean 兼容入口 |
+| 消息模板 | `SendMessage.title/content.parts` | 上下文、系统变量、变量、常量 | 消息正文占位符与独立绑定；接收人上下文也保留为动态人员 FormulaBean |
+| 消息接收人 | `SendMessage.receiver` | 当前用户、上游人员上下文、固定人员 | 动态人员使用真实上下文 `paramKey`，固定人员使用当前租户 Browser 对象 |
+| 人员参数 | 表单数据动作、流程动作、文档动作、`HrmEmployeeUpdate`、`PersonnelOnboarding`、`AlterPersonStatus`、会议/日程中的人员属性 | 当前用户、上游人员上下文、动作流变量/常量/函数 | 不再强制走固定人员查询；动态引用保持人员 FormulaBean，固定人员仍要求真实 Browser 对象 |
+| 会议和日程运行时字段 | `MeetingCreate` 的标题/密级/人员，`ScheduleCreate` 的标题/时间/内容/其他地点/人员 | 上下文、系统变量、变量、常量、函数/公式 | 普通字段生成对应 FormulaBean；人员使用人员 FormulaBean；会议室、日程类型、关联流程等设计期资源仍保持 Browser 对象 |
+| 流程和文档运行时字段 | 流程实例 ID、标题、意见、公文正文 ID、关联数据 ID、时间、文档/附件 ID、布尔开关等 `formula_or_reference` 属性 | 固定值、上下文、系统变量、变量、常量、查询结果、函数/公式 | 统一经共享公式编译器生成 FormulaBean；固定流程定义、节点、目录 DTO 不在此列 |
+| 循环参数 | `MultipleExecution.cycleTimes`、列表/明细来源 | 上下文、变量、常量、当前循环上下文 | 按循环模式生成对应 `CycleParams`/FormulaBean |
+| 条件右值 | `Condition` | 固定值、上下文、系统变量、变量、常量、函数 | 右值保留为公式树，不把动态字段名转成固定字符串 |
+| 终止节点动态输出 | `finalOutput.params.reminderMsgFormula`、`basisValue` | 固定值、上下文、系统变量、变量、常量、查询结果、函数/公式 | 自动补充的 `Output` 节点保留高级设置，无需在 `actions` 中手写终止节点 |
+
+## 需要按组件协议单独判定
+
+以下不是“永远不支持动态”，而是平台 DTO 对资源对象有额外约束，不能使用普通字段公式规则直接套用：
+
+- 流程定义/流程节点/退回节点/干预节点：通常需要当前租户真实流程 Browser 对象或节点对象；只有 `requestId`、标题、意见等字段类属性按组件契约支持动态。
+- 文档、目录、附件、共享权限、按钮、规则：固定对象需要当前租户真实 Browser/权限对象；如果组件说明或回读结构提供动态公式入口，必须单独实现该属性的编译器和回读校验。
+- 会议、日程、HRM 选择器的结构化对象：人员属性与会议/日程资源属性分开判断。`MeetingCreate.flag`、日程类型、会议室和 `Output.jumpUrl` 均只接受前端允许的固定选择/固定文本，不能因为底层存储字段是 FormulaBean 就推导其支持动态。
+- 触发器配置、接口定义、连接器/资源/接口选择：这些是设计期平台资源，默认必须实时发现真实对象，不能把运行时上下文当成连接器或接口定义。
+
+## 处理规则
+
+1. 先执行 `component-describe <type>`，读取该属性的 `valueType`、`referenceType`、`valueShape`、`propertySources` 和运行时上下文。
+2. 若属性是字段值、人员值或公式值，优先调用共享公式编译器；不得在组件内部另写“只接受固定值”的分支。
+3. 若属性是平台资源对象，必须查看该组件前端回读/保存 DTO 是否有动态入口；没有证据就保留固定对象约束，并明确指出是平台协议限制，而不是 Skill 偷懒。
+4. 每新增一个动态属性，至少增加一个上下文用例和一个固定值回归用例；涉及数组/循环时再增加数组或当前循环用例。
+5. 生成成功不等于动态赋值正确：正式回读必须确认参数仍为对应 FormulaBean，来源 `paramKey`、`source/frontId`、变量/常量 ID 和循环作用域没有丢失。