weaver-work-cli 0.1.24 → 0.1.26

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

@@ -0,0 +1,17 @@
+# 提交流程（`ApproveCommit`）
+
+## 何时使用
+
+对已有流程进行审批提交，并可更新流程表单。
+
+## 先查询
+
+查询流程、实例上下文、操作人和目标流程表单字段。
+
+## 不可猜测
+
+只能对真实实例提交；字段映射不能跨流程猜测。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`operator`。

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

@@ -0,0 +1,17 @@
+# 征询转办流程（`ApproveConsulTurnTodo`）
+
+## 何时使用
+
+将意见征询的流程转交他人。
+
+## 先查询
+
+查询实例和接收人。
+
+## 不可猜测
+
+不能以普通转办替代征询转办。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

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

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

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

@@ -0,0 +1,19 @@
+# 删除流程（`ApproveDelete`）
+
+## 何时使用
+
+将指定流程实例移入回收站。`requestId` 会按前端协议生成一个 `type=8` 的 `multipleSelect` JSON FormulaBean 容器，容器子项可以是固定流程实例或动态公式。
+
+当前平台只注册此删除组件；**不支持“彻底删除流程”**。不得生成或使用 `ApproveCompletelyDelete`，否则设计器保存会报组件内部异常。
+
+## 先查询
+
+确认真实实例和操作人。
+
+## 不可猜测
+
+删除实例具有副作用，实例来源必须可追溯。
+
+## 最小计划
+
+`requestId`、`operator`。

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

@@ -0,0 +1,17 @@
+# 抄送流程（`ApproveDoCirculate`）
+
+## 何时使用
+
+将流程实例抄送给指定接收人。
+
+## 先查询
+
+查询实例与接收人 Browser 对象。
+
+## 不可猜测
+
+接收人不能仅用姓名或 ID 表示。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

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

@@ -0,0 +1,17 @@
+# 转发流程（`ApproveDoForward`）
+
+## 何时使用
+
+将流程转发给指定人员。
+
+## 先查询
+
+查询实例和接收人。
+
+## 不可猜测
+
+标题与意见可固定或引用上下文；人员必须为真实 Browser 对象。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

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

@@ -0,0 +1,17 @@
+# 转办流程（`ApproveDoTurnTodo`）
+
+## 何时使用
+
+将流程待办转交指定人员处理。
+
+## 先查询
+
+查询实例和接收人。
+
+## 不可猜测
+
+只对真实待办实例操作。
+
+## 最小计划
+
+`requestId`、`receiveIds`、`initiator`。

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

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

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

@@ -0,0 +1,17 @@
+# 干预流程（`ApproveIntervention`）
+
+## 何时使用
+
+将流程干预流转到指定节点并指定处理人。
+
+## 先查询
+
+查询真实流程、节点、实例、操作人和节点处理人。
+
+## 不可猜测
+
+`workflowId`、`submitToNodeId`、处理人均必须是当前租户 Browser 对象。
+
+## 最小计划
+
+`workflowId`、`submitToNodeId`、`requestId`、`employeeId`、`interventionReceiverIds`。

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

@@ -0,0 +1,17 @@
+# 强制结束流程（`ApproveMandatoryArchiving`）
+
+## 何时使用
+
+将审批中的真实流程实例强制归档。
+
+## 先查询
+
+确认流程实例 ID 和操作人。
+
+## 不可猜测
+
+该动作有业务副作用，不能按流程名称或定义 ID 操作。
+
+## 最小计划
+
+`requestId`、`operator`。

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

@@ -0,0 +1,17 @@
+# 抄送批注流程（`ApproveManualCC`）
+
+## 何时使用
+
+向指定人员抄送流程并允许批注意见。
+
+## 先查询
+
+查询实例和人员。
+
+## 不可猜测
+
+当前仅支持人员接收方，不把部门或角色伪装为人员。
+
+## 最小计划
+
+`requestId`、`receiveTypes: "user"`、`receiveIds`、`initiator`。

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

@@ -0,0 +1,17 @@
+# 拒绝退回申请（`ApproveRefuseRejectApply`）
+
+## 何时使用
+
+拒绝一项已发起的流程退回申请。
+
+## 先查询
+
+确认真实实例和操作人。
+
+## 不可猜测
+
+不要以普通审批或直接退回代替该动作。
+
+## 最小计划
+
+`requestId`、`employeeId`。

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

@@ -0,0 +1,17 @@
+# 退回申请流程（`ApproveRejectApply`）
+
+## 何时使用
+
+为流程发起退回申请。
+
+## 先查询
+
+确认实例和操作人。
+
+## 不可猜测
+
+该动作需要真实意见，不自动虚构退回原因。
+
+## 最小计划
+
+`requestId`、`employeeId`、`remark`。

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

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

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

@@ -0,0 +1,17 @@
+# 退回流程（`ApproveSendBack`）
+
+## 何时使用
+
+将流程退回至一个指定节点。
+
+## 先查询
+
+查询流程定义、实例、真实退回节点和操作人。
+
+## 不可猜测
+
+退回节点必须属于该流程；不能以节点名称或猜测 ID 代替。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`rejectToNodeId`、`operator`。

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

@@ -0,0 +1,17 @@
+# 共享流程（`ApproveShareEntry`）
+
+## 何时使用
+
+将流程实例共享给指定人员。
+
+## 先查询
+
+查询实例、共享对象和操作人。
+
+## 不可猜测
+
+当前仅支持人员共享；共享对象必须是 Browser 原对象。
+
+## 最小计划
+
+`requestIds`、`shareType: "user"`、`shareEntities`、`perator`。

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

@@ -0,0 +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` 是“流程还原时”，与节点执行时间中的“返回到达”不是同一事件。

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

@@ -0,0 +1,17 @@
+# 撤回流程（`ApproveWithdraw`）
+
+## 何时使用
+
+撤回已处理的流程。
+
+## 先查询
+
+确认实例和撤回操作人。
+
+## 不可猜测
+
+仅在平台允许的实例状态下生成。
+
+## 最小计划
+
+`requestId`、`operator`。

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

@@ -0,0 +1,17 @@
+# 流程关联文档赋权（`WorkFlowDocEmpowerment`）
+
+## 何时使用
+
+为流程关联文档设置人员范围权限。
+
+## 先查询
+
+查询真实流程实例、文档和需要的人员范围对象。
+
+## 不可猜测
+
+文档与权限范围不能由裸 ID 拼装；固定对象须使用真实 Browser 值。
+
+## 最小计划
+
+`requestId`、`documents`；按需求补充权限范围。

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

@@ -0,0 +1,17 @@
+# 流程存为文档（`WorkflowToDoc`）
+
+## 何时使用
+
+将流程内容作为附件形式存入文档。
+
+## 先查询
+
+查询流程、实例、操作人和平台返回的存文档设置。
+
+## 不可猜测
+
+固定目录必须是 `saveDirectoryBrowserValue` 的真实目录对象；设置为空时拒绝生成。
+
+## 最小计划
+
+`workflowPath`、`requestId`、`operator`、`toDocSettings`。

package/skills/weaver-e10-builder/actionflows/references/condition_rules.md

@@ -0,0 +1,100 @@
+# 条件业务规则
+
+仅在需求包含条件、筛选或 if/else 时读取本文件。
+
+- 用户没有说明条件成立或不成立后要做什么时，不擅自补写更新、删除、通知或其他业务动作。
+- 条件的业务含义存在多个合理解释时，向用户确认比较含义与各结果分支的预期动作。
+- 条件字段、操作符、值形态的**权威规范（前端 ConditionSet 源码逆向）**见下方「二、ESB filterInput / ConditionSet 右值规范」，来源：工作区 `condition-generator-skill/`（SKILL.md 第 6 章 + references/）。
+
+---
+
+## 一、筛选条件（filterCondition）plan 写法
+
+- 单条件：`{"field": {"id": "<目标字段id>", "label": "<字段名>"}, "operator": "<操作符>", "right": {...}}`。`right` 是唯一对外计划字段；不要使用历史别名 `value`。
+- 条件组（且/或）：`{"relationship": "and|or", "conditions": [ <条件1>, <条件2>, ... ]}`（编译器支持嵌套）。不接受平台输出 DTO 的 `datas` 或 `1/0`。
+- `right` 值形态（type）：
+  - `context`：`{"type":"context","paramKey":"<真实paramKey>","label":"<显示名>"}` —— 引用上游上下文（esbAssign.wId 自动指向当前节点）
+  - `native` + `mode: "currentTime"|"currentDate"|"now"|"today"`：**当前时间/当前日期**。编译器自动改写为系统参数 `{time}`/`{date}`（见下节 6），`conditions.value` 非空、`type:""`，设计器点开筛选器右值区能正常回显，不会出现「右值未配置」（真机验证 2026-08-18）
+  - `fixed`：普通固定值；字符串为 `{...}` 系统变量时自动识别为 system
+  - `system`：系统参数 token，如 `{userid}`/`{date}`/`{time}`（由动作流编译器内置 system_params 处理）
+- 操作符：`eq/neq/gt/lt/gte/lte/contains/uncontains/empty/nempty`（`empty/nempty` 无右值）
+- 日期字段用系统值：直接 `right.value = "{date}"` 或 `{time}`（ESB 体系），无需 `{today}`（那是通用 ConditionSet 的占位符写法，ESB 编译器会归一为 system）
+
+## 分支条件（`Condition`）
+
+分支条件和 `filterCondition` 共用 AND/OR 业务语义，但保存协议不同，不能互相复制 DTO。
+
+- **分支位置**：`branches` 写在节点顶层或 `params.branches` 都会被受理（`component-describe Condition` 声明的就是 `params.branches`）；归一化后草稿只保留顶层 `branches`。**同一节点不要两处各写一份**——读分支的实现统一走同一入口，两份写法只会让人误判哪份生效。
+- 计划用 `condition: { relationship: "and|or", conditions: [...] }`；叶子为 `{left, operator, right}`。顶层 `relationship` 直接作为条件树根关系；编译器不会额外套同关系 AND/OR，只有条件中明确嵌套的规则组才保留子组。
+- `left` 只能是当前上游组件的实时字段；`operator` 由字段类型限制，未知或不兼容时编译失败。
+- `right` 只用 `fixed`、`system`、`context`，或 `formula` 完整回读对象。`context` 必须写真实 `paramKey`，由运行时生成 FormulaBean；禁止把字段名作为固定值。
+- 保存采用 ESB `source=8`：预暂存注册来源节点 → `getConditionSet` → `saveCondition` → 以保存响应回填真实持久化 ID → 最终暂存。新建后 `getExpressionBean` 可能只返回分组骨架，不能覆盖完整 `childrens` 叶子树；`mapBaseId`、`conditionId`、`mapId` 和所有 Long ID 都保持字符串，新建条件不传本地 `conditionId`。
+
+## 二、ESB filterInput / ConditionSet 右值规范（源自 condition-generator-skill）
+
+ESB 动作流的 `filterInput`（TimeBatchTrigger/DateTrigger/数据动作筛选）与通用 ConditionSet 筛选器**结构同源**（`isNewFilter/isParent/datas/relationship/key` + 叶子 `conditions{func,type,value,text}`）。生成条件时遵循以下规范：
+
+### 1. 叶子条件结构
+
+```json
+{
+  "id": "<字段id>", "fieldName": "<字段英文名>",
+  "conditions": { "func": "lt", "type": "", "value": "{time}", "text": "当前时间" }
+}
+```
+
+`fieldType/text/objId/compType` 等元信息由编译器按真实字段补全（`buildFilterInput`），**plan 里不写**。对于关联字段，编译器必须保留平台所需的真实 `sformId`；`refObjId` 仅在该组件的正式 DTO 要求时保留，不能把它作为所有关联字段的统一必填项，也不能只写字段 ID或把表单版本 `formId` 当作关联对象身份，否则保存后设计器可能显示“字段已删除”。
+
+其中 Workflow 字段要区分两种 ID：`formInfo.formId` 是当前目标表单的版本 ID；顶层 `sformId` 是该字段关联的流程表单对象 ID。正式回读的 Workflow DTO 使用原始数字 `fieldName`、`fieldType:"String"`、空 `module`/`originBrowserType`，`config` 只保留 `fieldId`；不能按普通 e-builder 业务字段加 `field_` 前缀，也不能把组件名 `Workflow` 当作存储类型。`refObjId` 对 Workflow 不是必填。若实时字段接口没有返回 Workflow 的关联对象，预检必须根据当前 `workflowPath.formIds` 在同一应用的表单列表中反查对象 ID，并把目标表 `getFormLayout` 返回的默认布局 ID写入 `formInfo.layoutId`。反查不到时应报错停止，不能用目标表单版本 ID兜底。
+
+### 2. 值类型 `conditions.type` 枚举
+
+| type | 含义 | 适用 |
+|---|---|---|
+| `""` | 手动输入 / 选选项 / **系统值** | 文本/数值直接输入、选择框选选项、**日期选系统占位符** |
+| `"custom"` | 专用选择器 / 选择框手动输入 | 人员/部门/级联/地区/Select 手动输入；**日期 range 模式推荐**（渲染日期选择器） |
+| `"custombyhander"` | 手动输入（浏览器类组件） | 人员/部门/关联字段/文档/附件 |
+| `"formField"` | 引用本表/关联表字段值 | 所有类型（value 含 `compareFormField`，必须含 `objId`+`name` 否则回显空白） |
+| `"varField"` | 引用系统/流程变量 | 所有类型（value 含 `compareVarField`，`id` 必须是真实变量 id 否则回显空白） |
+| `"filterVal"` | 引用其他筛选组件搜索值 | 文本/数值/日期 |
+
+### 3. 系统日期占位符（通用 ConditionSet 写法，type 为 `""`）
+
+| 占位符 | 含义 |
+|---|---|
+| `{today}` | 当前日期 |
+| `{yesterday}` / `{tomorrow}` | 昨天 / 明天 |
+| `{currweek}` / `{lastweek}` / `{nextweek}` | 本周 / 上周 / 下周 |
+| `{currmonth}` / `{lastmonth}` / `{nextmonth}` | 本月 / 上月 / 下月 |
+| `{currseason}` / `{lastseason}` / `{nextseason}` | 本季 / 上季 / 下季 |
+| `{curryear}` / `{lastyear}` / `{nextyear}` | 本年 / 去年 / 明年 |
+
+自定义日期占位符（type `"custom"`，后端 `handleValue` 识别）：`{year}`（本年区间）、`{year}-{month}`（当月区间）、`{date:±N}`（今天±N 天）。
+
+> **ESB 差异**：ESB 动作流的系统值 token 由编译器内置 system_params 处理（`{date}`=当前日期、`{time}`=当前时刻、`{userid}` 等）；通用 ConditionSet 的 `{today}` 等占位符在 ESB filterInput 中由编译器归一（native `currentTime/currentDate/now/today` → `{time}`/`{date}`），生成时两者皆可，编译器兜底。
+
+### 4. func 操作符
+
+| func | 含义 | 适用 |
+|---|---|---|
+| `eq`/`neq` | 等于/不等于 | 所有 |
+| `gt`/`lt`/`gte`/`lte` | 大于/小于/大于等于/小于等于 | 数值、日期 |
+| `range` | 区间（value 为 `[起始,结束]`） | 数值、日期 |
+| `contains`/`uncontains` | 包含/不包含 | 文本 |
+| `empty`/`nempty` | 为空/不为空（无右值） | 所有 |
+
+### 5. 字段类型 × 值类型速查
+
+- 文本（String/Text/TextArea）：type `""`、`formField`、`varField`、`filterVal`；无 `custombyhander`
+- 数值（Number/NumberComponent）：type `""`（含 range）、`formField`、`varField`、`filterVal`；**无 `custombyhander`**
+- 日期（Date/DateComponent/DateInterval）：type `""`（手动输入/系统日期）、`"custom"`（手动输入，range 推荐）、`"customDate"`（仅宿主注入回调时可用，**默认不用**）、`formField`、`varField`、`filterVal`
+- 选择框（Select/RadioBox/CheckBox）：type `""`（选选项，value 逗号分隔）、`"custom"`（手动输入）、`formField`、`varField`
+- 人员（Employee）/部门（Department）：type `""`（系统选项）、`"custom"`（选人/选部门）、`"custombyhander"`、`formField`、`varField`
+
+### 6. 「当前时间」筛选的正确表达（真机验证 2026-08-18）
+
+ESB TimeBatchTrigger/DateTrigger 等定时器的 `filterCondition` 用「字段 < 当前时间」时：
+
+- plan 写：`{"field": {"id": "<日期字段id>", "label": "<字段名>"}, "operator": "lt", "right": {"type": "native", "mode": "currentTime", "label": "当前时间"}}`
+- 编译器把 `native currentTime/now/current_time` 改写为系统参数 `{time}`（`currentDate/today/current_date` → `{date}`），落到 system 路径
+- 读回后 `conditions = {"func":"lt","text":"当前时间","value":"{time}","type":"","isEsb":false}` —— value 非空，设计器点开筛选器右值区正常回显「当前时间」，**不会空**（此前直接透传 `type:"currentTime"` + `value:""` 导致点进去右值区空白，外部摘要正常）

package/skills/weaver-e10-builder/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.msgTitlev/msgContentv/picLink/msgPcLink/msgMobileLink` | 上下文、系统变量、变量、常量、函数/公式、查询结果 | 五个消息文本/链接字段统一保存为 `ContestSettingDTO`；正文占位符与独立绑定；接收人上下文仍保留为动态人员 FormulaBean |
+| 消息接收人 | `SendMessage.receiver` | 当前用户、上游人员上下文、固定人员 | 动态人员使用真实上下文 `paramKey`，固定人员使用当前租户 Browser 对象 |
+| 人员参数 | 表单数据动作、流程动作、文档动作、`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` 不再用于新生成 |
+
+## 需要按组件协议单独判定
+
+以下不是“永远不支持动态”，而是平台 DTO 对资源对象有额外约束，不能使用普通字段公式规则直接套用：
+
+- 流程定义/流程节点/退回节点/干预节点：通常需要当前租户真实流程 Browser 对象或节点对象；只有 `requestId`、标题、意见等字段类属性按组件契约支持动态。
+- 文档、目录、附件、共享权限、按钮、规则：固定对象需要当前租户真实 Browser/权限对象；如果组件说明或回读结构提供动态公式入口，必须单独实现该属性的编译器和回读校验。
+- 会议、日程、HRM 选择器的结构化对象：固定值仍以各自前端 Browser 契约为准；只要后端字段声明为 `FormulaBean`，同时支持动态引用。`Output.jumpUrl` 的后端 DTO 是 `FormulaBean`，支持固定值和动态引用，且仅在 `pageAction=3` 时生效。
+- 触发器配置、接口定义、连接器/资源/接口选择：这些是设计期平台资源，默认必须实时发现真实对象，不能把运行时上下文当成连接器或接口定义。
+
+## 处理规则
+
+1. 先执行 `component-describe <type>`，读取该属性的 `valueType`、`referenceType`、`valueShape`、`propertySources` 和运行时上下文。
+2. 若属性是字段值、人员值或公式值，优先调用共享公式编译器；不得在组件内部另写“只接受固定值”的分支。
+3. 若属性是平台资源对象，必须查看该组件前端回读/保存 DTO 是否有动态入口；没有证据就保留固定对象约束，并明确指出是平台协议限制，而不是 Skill 偷懒。
+4. 每新增一个动态属性，至少增加一个上下文用例和一个固定值回归用例；涉及数组/循环时再增加数组或当前循环用例。
+5. 生成成功不等于动态赋值正确：正式回读必须确认参数仍为对应 FormulaBean，来源 `paramKey`、`source/frontId`、变量/常量 ID 和循环作用域没有丢失。

package/skills/weaver-e10-builder/actionflows/references/dynamic_resources.md

@@ -0,0 +1,41 @@
+# 动态赋值资源：变量与常量
+
+动态赋值中的变量、常量不是普通文本，也不能直接把名称写进 `value`。CLI 会在生成阶段读取当前租户资源，必要时先创建资源，再把真实 ID 编译为平台 FormulaBean：变量是 `type:"7"`，常量是 `type:"5"`。
+
+## 使用已有资源
+
+```json
+{"kind":"variable","id":"<当前动作流已有变量ID>","name":"批次号"}
+{"kind":"constant","id":"<当前租户常量ID>","name":"接口地址"}
+```
+
+变量必须属于当前动作流的 `applicationId + sceneId`；常量按租户范围读取，可跨动作流使用。不能只传名称冒充 ID。生成时找不到真实资源会在保存前失败。
+
+## 按计划新建资源
+
+```json
+{
+  "variables": [{"ref":"批次变量","name":"批次变量","type":"string","value":""}],
+  "constantDefinitions": [{"ref":"服务地址","name":"服务地址","groupName":"接口配置","contentType":"string","content":"https://example.test"}],
+  "actions": [{"type":"ActionEbUpdate","params":{"constants":{"<目标字段>":{"kind":"variable","name":"批次变量"}}}}]
+}
+```
+
+- `variables[]` 调用 `application/variable/addVariable`，变量绑定本次新建动作流场景；类型使用平台值 `string`、`int`、`double`、`boolean`、`date`、`time`、`datetime`。
+- `constantDefinitions[]` 调用 `constant/save`；填写 `groupPk` 使用已有分组，填写 `groupName` 时按精确名称复用已有分组，不存在才调用 `constant/saveConstGroup` 新建分组。
+- 新建定义用 `{kind:"variable",name:"..."}` 或 `{kind:"constant",name:"..."}` 引用；也可以直接传平台真实 `id`。
+- `constants` 仍表示“目标字段 → 固定/动态赋值”的属性名，不与顶层 `constantDefinitions` 混用。固定值继续写 `{kind:"fixed",value:"..."}`。
+- 同一个动作流只能用自身变量；更新已有动作流时使用当前版本的变量 ID，CLI 不会把另一个动作流的变量 ID 自动迁移。
+
+## CLI 发现与创建
+
+```bash
+e10-cli actionflow variable-list '{"applicationId":"<应用ID>","sceneId":"<场景ID>"}'
+e10-cli actionflow variable-create '{"applicationId":"<应用ID>","sceneId":"<场景ID>","name":"批次变量","type":"string","value":""}'
+e10-cli actionflow constant-list
+e10-cli actionflow constant-group-list
+e10-cli actionflow constant-group-create '{"groupName":"接口配置"}'
+e10-cli actionflow constant-create '{"groupPk":"<分组ID>","name":"服务地址","contentType":"string","content":"..."}'
+```
+
+完整平台响应可用 CLI 的 `--out` 保存，终端只看摘要；不要根据截断输出判断资源是否创建成功。凭据和敏感常量值不写入 Skill、计划或 Git。