weaver-e10-builder 1.1.9 → 1.2.3

package/skill-docs/actionflows/references/components/ebuilder/EbGetDataById.md

@@ -1,17 +1,17 @@
-# 获取表单数据详情（`EbGetDataById`）
-
-## 何时使用
-
-按数据 ID 获取指定 e-builder 表单的一条详情，供后续动作引用。
-
-## 先查询
-
-查询目标表单和读取操作人。
-
-## 不可猜测
-
-`dataId` 必须是实际数据 ID 或其真实上下文；`person` 只是 `operatorId` 的兼容别名。
-
-## 最小计划
-
-`targetForm`、`dataId`、`operatorId`（或 `person`）。
+# 获取表单数据详情（`EbGetDataById`）
+
+## 何时使用
+
+按数据 ID 获取指定 e-builder 表单的一条详情，供后续动作引用。
+
+## 先查询
+
+查询目标表单和读取操作人。
+
+## 不可猜测
+
+`dataId` 必须是实际数据 ID 或其真实上下文；`person` 只是 `operatorId` 的兼容别名。
+
+## 最小计划
+
+`targetForm`、`dataId`、`operatorId`（或 `person`）。`dataId` 和 `checkRight` 都支持固定值、上下文、系统变量、变量、常量和函数/公式；`operatorId` 支持固定人员 Browser 对象或动态人员公式。

package/skill-docs/actionflows/references/components/ebuilder/EnquiryForm.md

@@ -16,6 +16,12 @@
 
 `dataSource`、`person`；按 `opType` 补充查询字段和筛选条件。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含“数据ID”。未指定 `filter` 时，CLI 会生成平台必填的中性条件“数据ID不为空”，不改变业务筛选范围；只有明确指定 `filter` 时才使用业务条件。
 
+## 动态分页和条件
+
+- `formPageNo`、`formPageSize` 支持固定值、上下文、系统变量、变量、常量和函数/公式。
+- 需要由上游计算整段查询条件时使用 `conditionFormula`；它会写为 `conditionType:"assign"`，此时不得同时传 `filter`。
+- 普通业务筛选继续使用 `filter`，两种条件模式不能混用。
+
 ## 分组/汇总查询
 
 `opType:"groupFields"` 是原生“分组/汇总”能力，不需要规则集或外部计算组件：

package/skill-docs/actionflows/references/components/ebuilder/EventButton.md

@@ -1,33 +1,33 @@
-# e-builder 按钮触发（`EventButton`）
-
-## 何时使用
-
-需求明确为点击 e-builder 表单上的某个按钮时触发。它与 `EventFormData` 不同：后者只监听数据变动，不能识别是由哪个按钮触发。
-
-## 先查询
-
-1. 用 `form-applications`、`form-list` 确认表单和所属业务应用。
-2. 用 `e10-cli actionflow form-buttons '{"tableId":"<表单ID>","appId":"<应用ID>"}'` 读取真实按钮 ID、名称与启用状态。
-
-不要按按钮名称猜测 ID，也不要创建按钮作为生成动作流的隐含步骤。
-
-## 最小计划
-
-```json
-{
-  "event": {
-    "type": "EventButton",
-    "params": {
-      "targetForm": {"groupId":"<应用ID>","id":"<表单ID>"},
-      "buttonType": [{"id":"<按钮ID>","name":"<按钮名称>","buttonLocation":"after"}],
-      "triggerType": "sequence"
-    }
-  }
-}
-```
-
-`buttonLocation` 只能是 `before`（按钮默认动作前）或 `after`（默认动作后）。多选记录场景的 `triggerType` 为 `sequence`、`merge` 或 `parallel`。需要异步时在对应按钮项写 `asyncExecution:true`。
-
-## 上下文
-
-触发后可引用 `FormData`、`FormField`、`FormButton`、`SettingInfo`、`accessId` 和 `monitorId`。先通过组件上下文预检获取当前租户的字段，禁止猜测字段路径。
+# e-builder 按钮触发（`EventButton`）
+
+## 何时使用
+
+需求明确为点击 e-builder 表单上的某个按钮时触发。它与 `EventFormData` 不同：后者只监听数据变动，不能识别是由哪个按钮触发。
+
+## 先查询
+
+1. 用 `form-search '{"keyword":"<表名>"}'` 按表名直接拿到表单 `objId` 与所属业务应用 `appId`（同名表多于一条时按 `appName` 收窄）；只知道应用时用 `form-applications` → `form-list`。
+2. 用 `e10-cli actionflow form-buttons '{"tableId":"<表单ID>","appId":"<应用ID>"}'` 读取真实按钮 ID、名称与启用状态。
+
+不要按按钮名称猜测 ID，也不要创建按钮作为生成动作流的隐含步骤。
+
+## 最小计划
+
+```json
+{
+  "event": {
+    "type": "EventButton",
+    "params": {
+      "targetForm": {"groupId":"<应用ID>","id":"<表单ID>"},
+      "buttonType": [{"id":"<按钮ID>","name":"<按钮名称>","buttonLocation":"after"}],
+      "triggerType": "sequence"
+    }
+  }
+}
+```
+
+`buttonLocation` 只能是 `before`（按钮默认动作前）或 `after`（默认动作后）。多选记录场景的 `triggerType` 为 `sequence`、`merge` 或 `parallel`。需要异步时在对应按钮项写 `asyncExecution:true`。
+
+## 上下文
+
+触发后可引用 `FormData`、`FormField`、`FormButton`、`SettingInfo`、`accessId` 和 `monitorId`。先通过组件上下文预检获取当前租户的字段，禁止猜测字段路径。

package/skill-docs/actionflows/references/components/ebuilder/EventFormData.md

@@ -12,6 +12,8 @@
 
 触发时机、表单和字段以当前租户返回为准；不要把流程表单误当 e-builder 独立表单。
 
+多条数据变动的后续触发方式通过 `triggerType` 支持：`sequence`（依次）、`merge`（合并）、`parallel`（并行）。
+
 ## 最小计划
 
 `dataSource` 与 `triggerTimes`；按需求补充触发字段。

package/skill-docs/actionflows/references/components/ebuilder/TimeBatchTrigger.md

@@ -1,17 +1,19 @@
-# 定时批量触发（`TimeBatchTrigger`）
-
-## 何时使用
-
-按 Quartz Cron 表达式扫描 e-builder 表单中满足条件的数据，并逐条触发后续动作。
-
-## 先查询
-
-查询数据源、查询/筛选字段与操作人。
-
-## 不可猜测
-
-批量筛选只能使用数据源真实字段；操作人不能使用文本或不存在的系统别名。
-
-## 最小计划
-
-`dataSource`、`cornString`、`operator`；按需求补充查询字段和筛选条件。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含后续链接/赋值需要的“数据ID”。只支持 Quartz Cron，例如每天 10:00：`0 0 10 * * ?`。
+# 定时批量触发（`TimeBatchTrigger`）
+
+## 何时使用
+
+按一次、按小时、按日、按周、按月或 Quartz Cron 表达式扫描 e-builder 表单中满足条件的数据，并逐条触发后续动作。
+
+## 先查询
+
+查询数据源、查询/筛选字段与操作人。
+
+## 不可猜测
+
+批量筛选只能使用数据源真实字段；操作人不能使用文本或不存在的系统别名。
+
+`rate` 使用平台原生频率编码：`1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月、`6` Cron。图形化频率需要 `startTime`；按小时/日/周用 `cycle` 或指定列表，按月用 `day`、`atWeek` 或 `lastWeek`。`orderFields` 支持查询排序；`endTime` 支持定时窗口；`openRetryFlag` 支持失败补偿。
+
+## 最小计划
+
+`dataSource`、`rate`、`startTime`、`operator`；按需求补充频率子项、查询字段、筛选条件、`orderFields`、`endTime` 和 `openRetryFlag`。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含后续链接/赋值需要的“数据ID”。Cron 模式使用 `rate=6` + `cornString`，例如每天 10:00：`0 0 10 * * ?`。

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

@@ -1,17 +1,28 @@
-# 终止（`Output`）
-
-## 何时使用
-
-结束主链或分支；通常由编译器自动补充。
-
-## 先查询
-
-无需查询。
-
-## 不可猜测
-
-普通 semantic plan 不应手写该节点。
-
-## 最小计划
-
-无需传入。
+# 终止（`Output`）
+
+## 何时使用
+
+结束主链；由编译器自动补充。需要配置成功/失败状态、结束提示或页面动作时，通过计划顶层 `finalOutput.params` 配置。
+
+## 先查询
+
+无需查询。
+
+## 不可猜测
+
+不要把 `Output` 写入 `actions`。`reminderMsgFormula` 与 `basisValue` 支持固定值、上下文、系统变量、变量、常量、查询结果和函数/公式；`jumpUrl` 在前端只允许固定文本。`fixedData`、`customOutputData` 属于平台原生高级输出结构，必须使用真实回读结构，不能猜测。
+
+## 最小计划
+
+```json
+{
+  "finalOutput": {
+    "params": {
+      "outputStatus": "0",
+      "reminder": "1",
+      "reminderMsgFormula": { "kind": "variable", "id": "<真实变量ID>", "name": "失败提示" },
+      "pageAction": "0"
+    }
+  }
+}
+```

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

@@ -14,7 +14,10 @@
       "params": {
         "queueName": "真实Topic名称",
         "sendModel": "1",
-        "sendParams": "<平台 InnerMqComponentDTO.sendParams 原生 ParamMappingBean>"
+        "sendParams": "<平台 InnerMqComponentDTO.sendParams 原生 ParamMappingBean>",
+        "inputParams": [
+          { "paramKey": "payload", "value": { "kind": "context", "paramKey": "<真实字段paramKey>", "label": "消息体" } }
+        ]
       }
     }
   ]
@@ -22,9 +25,10 @@
 ```
 
 - `queueName` 和 `sendParams` 必填；固定 Topic 直接传字符串，CLI 会转换为平台所需的 `FormulaBean`。
-- `queueName` 也可以传已解析的 `context`/`fixed`/`system_variable` 赋值或平台原生 `FormulaBean`。
+- `queueName` 也可以传统一动态赋值或平台原生 `FormulaBean`，包括上下文、系统变量、变量、常量和函数。
 - `sendModel` 为 `1` 广播模式或 `2` 集群模式，省略时默认 `1`。
 - `sendParams` 必须来自平台发送参数设计器的原生 `ParamMappingBean`，不要用 `receiveParams` 或普通字符串替代。
+- 需要给发送参数赋值时使用 `inputParams`。`paramKey` 必须命中 `sendParams.tableData` 的真实参数；`value` 支持固定值、上下文、系统变量、变量、常量、查询结果和函数/公式，CLI 会写入该行的 `formulaData`，不会重建参数定义。
 
 ### 参数类型与数据类型联动
 

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` 都支持统一动态赋值。