weaver-work-cli 0.1.23 → 0.1.25

package/skills/weaver-e10-builder/actionflows/references/components/document/ModifyDocumentStatus.md

@@ -0,0 +1,17 @@
+# 更新状态（`ModifyDocumentStatus`）
+
+## 何时使用
+
+更新文档状态。
+
+## 先查询
+
+查询当前租户文档状态与目标文档。
+
+## 不可猜测
+
+状态只能取 `document-statuses` 返回值；文档固定值必须是真实 Browser 对象。
+
+## 最小计划
+
+`documents`、`docStatus`。

package/skills/weaver-e10-builder/actionflows/references/components/document/ReplaceAttachment.md

@@ -0,0 +1,17 @@
+# 替换附件（`ReplaceAttachment`）
+
+## 何时使用
+
+以新附件替换旧附件并升版。
+
+## 先查询
+
+查询新旧附件来源和操作人。
+
+## 不可猜测
+
+这是独立组件，不能用 `DocumentEdit` 伪装；两个附件都必须真实存在。
+
+## 最小计划
+
+`resourceFileId`、`targetFileId`、`employeeId`。

package/skills/weaver-e10-builder/actionflows/references/components/document/UpdatePrintNum.md

@@ -0,0 +1,17 @@
+# 更新打印次数（`UpdatePrintNum`）
+
+## 何时使用
+
+更新指定文档的打印次数。
+
+## 先查询
+
+查询目标文档及申请人、操作人。
+
+## 不可猜测
+
+打印次数必须大于零；人员为真实 Browser 对象。
+
+## 最小计划
+
+`documentId`、`printNum`、`applicant`、`operatorId`。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/ActionEbAdd.md

@@ -0,0 +1,100 @@
+# 新建表单数据（`ActionEbAdd`）
+
+## 何时使用
+
+向指定 e-builder 表单新增一条或一批数据；已有数据要修改时改用 `ActionEbUpdate`。
+
+## 选择项跨表映射
+
+来源、目标选择字段的选项 ID 经当前租户字段元数据确认一致时，直接 `mapping` 动态赋值；批量新增会生成“依据值下级”（`switchType:"sub"`），这是任务明细字段的默认做法。需求指定固定选项时，不做动态映射；在 `constants` 中传该字段的真实 `valueKey`（可同时带 `label`），例如 `"<任务类型字段id>":{"kind":"fixed","value":"<研发的valueKey>","label":"研发"}`。CLI 会保留目标字段 `Select` 类型，使设计器以下拉项“研发”回显。只有两边选项 ID 不同、且需求明确要求按语义转换时，才在 `formula`（批量明细为 `detail[].formula`）中用 `SWITCH` 显式映射：
+
+```json
+{
+  "<目标选择字段id>": {
+    "kind": "function",
+    "name": "SWITCH",
+    "args": [
+      {"kind":"context","paramKey":"<来源选择字段paramKey>","label":"来源类型"},
+      {"kind":"fixed","value":"<来源选项id1>"}, {"kind":"fixed","value":"<目标选项id1>"},
+      {"kind":"fixed","value":"<来源选项id2>"}, {"kind":"fixed","value":"<目标选项id2>"},
+      {"kind":"fixed","value":"<默认目标选项id>"}
+    ]
+  }
+}
+```
+
+批量新增时，普通 `mapping` 的 `明细表[].字段` 仍编译为 type=10 的“依据值下级”引用。函数参数则是另一套协议：它会明确引用 `明细表[0].字段`，不会把整张明细数组传入函数。
+
+## 先查询
+
+查询目标应用、表单、全量字段及创建人。明细赋值还须查询明细字段。
+
+## 不可猜测
+
+`targetForm`、人员和字段 ID 必须来自当前租户。动态来源只能使用本次触发器的真实 `paramKey`。
+
+`params.setting` 不是前端回读的 `EsbFormDataDto`。语义计划中不要直接复制前端的 `setting.main/detail`；主表使用 `mapping`、`constants`、`formula` 或旧格式赋值数组，明细使用 `detail` 语义项。CLI 会把这些语义项编译为后端 `EbuilderActionDTO.setting`，其核心结构是：
+
+```json
+{
+  "main": {
+    "<目标主表字段ID>": {
+      "formFieldKey": "",
+      "value": {
+        "assign": "<FormulaBean>",
+        "fieldType": "<目标字段componentKey/type>",
+        "switchType": "assign|fixvalue|sub",
+        "assignType": "",
+        "multiSelect": false
+      }
+    }
+  },
+  "detail": [
+    {
+      "detailTableId": "<目标明细表ID>",
+      "basisValue": "<来源明细表 FormulaBean>",
+      "data": { "<目标明细字段ID>": { "formFieldKey": "", "value": { "assign": "<FormulaBean>" } } },
+      "deleteFields": []
+    }
+  ],
+  "dataDrWithCalc": false,
+  "deleteMainFields": []
+}
+```
+
+赋值值可以是固定值、上下文、动作流变量、租户常量或函数/公式；变量/常量必须先按 `references/dynamic_resources.md` 使用真实 ID 或顶层定义解析，不能把名称直接当作固定文本。
+
+## 最小计划
+
+`targetForm`、`person`，以及至少一项 `mapping`、`constants`、`formula` 或 `setting`。`setting` 仅表示旧格式赋值数组，不表示上述平台 DTO。
+
+操作人选择：需求明确指定某人时才传该人的真实 Browser 对象并显示为固定值；需求未指定时传 `{"type":"role"}`，生成当前人 `{userid}` 动态值。不得为了补必填项从人员列表任意挑一个人。
+
+`opType:"batchInsert"` 时，`basisValue` 与 `mapping` 都是必填：前者指定要逐行遍历的上游明细，后者指定每行写入哪些目标字段。两者任一缺失，CLI 会在创建动作流前停止，绝不保存空壳批量节点。
+
+若流程触发器上下文中存在 `requestId`，而目标表恰有唯一一个未赋值的流程关联 Browser 字段（如“来源流程”或“关联流程”），CLI 会把它自动映射为当前流程实例 ID，并在结果的 `autoMappings` 中列出。显式映射、固定值、公式和旧 `setting` 始终优先，不会被覆盖；字段不唯一或类型不是流程关联字段时不猜测。
+
+### 明细表规则
+
+新增明细时，前端 `DetailForm` 以 `basisValue` 决定新增行数；没有依据值时会清空动态赋值。因此只要 `detail` 中配置了 `mapping`、`constants` 或 `formula`，就必须同时提供真实的 `basisValue`，通常写成上游明细列表字段并带 `[]`。CLI 不接受没有依据值的明细字段映射。
+
+`ActionEbAdd` 的 `ActionEbDlg` 未开启明细操作策略选择器，明细策略固定为新增。`detail` 不接受 `operateType`、`updateType`、`updateFieldCondition`、`updatePolicy` 或 `rowId`；这些字段会被 CLI 拒绝，明细更新/删除应改用 `ActionEbUpdate`（删除全部等特殊场景也不要伪造为新增）。编译结果不会写入前端不存在的 `operateType:"insert"`，只保存 `detailTableId`、`basisValue`、`data` 和 `deleteFields`。
+
+新增组件的 `person` 按前端结构保存为 type=8 容器，容器内再放当前用户 type=9 或固定人员 type=1 的子 FormulaBean；CLI 会自动补齐该容器。
+
+## 动态来源选择与查询结果引用
+
+- AI 应按需求和已生成上游节点的真实上下文选择来源：流程触发字段、前序动作输出、当次循环、系统变量、固定值或查询结果均可；**不得默认把所有映射绑定到流程触发，也不得默认插入查询节点**。
+- 仅当业务需要从另一张表反查、且结果可确定为单条时，才使用 `EnquiryForm` 查询 + 主表字段 `query_result` 引用（手工创建成功样本：`actionflows/references/examples/enquiry-form-batch-insert-scene2.json`）。
+  - EnquiryForm 在前，ActionEbAdd 的 sources 指向 EnquiryForm 节点；主表字段 assign `type=3`，`value="FormData.{查询表id}[{positionId}].id"`，`config.comType="EnquiryForm"`、`comId=EnquiryForm 节点 id`、`paramKey="{查询表id}[].id"`，childs 带固定值取下标 `[{type:"1", value:"0", position}]`。
+  - 细节见 `EnquiryForm.md`「批量新增主表字段引用查询结果」。
+- AI 选择查询结果时，plan 显式写 `kind:"query_result"`、`source:"<查询节点ref>"`、`formId`、`fieldId`、`index:0`；未选择时使用普通 `context`、`fixed`、`system_variable` 或函数树，不产生查询结果公式。`kind:"enquiry"` 与 `sourceId` 不是合法格式，CLI 必须拒绝，不能生成空固定值。
+
+## 函数公式赋值（type=6）
+
+- **plan 写法**：顶层 `formula: {目标字段id: <函数树>}`；函数调用为 `{kind:'function', name:'DATEDIFF', args:[...]}`，args 可为 `{kind:'context', paramKey, label, fieldType}` / `{kind:'fixed', value}` / 嵌套 `{kind:'function'}`。四则运算也写为函数树，禁止 `op + fields` 的旧格式。
+- **保存结构**：assign `type=6`，`value="{fnId}#{child.position}#..."`；`childs` 按参数槽位 `position` 串联，且 `detail[i].position` 必须与第 i 个 child 的 `position` 完全相同。`position` 与子公式 `id` 都是数字但不能混用：缺任一处会让设计器只显示根运算符（如 `(*)`），不显示参数。函数内部 `formulaType/config.paramType` 使用函数目录的 `resultType`（如 `double`），目标字段 `NumberComponent` 只写在外层 setting。内层函数同样 type=6 嵌套，叶子上下文 type=3 / 固定值 type=1。
+- **函数类别与 excelFunc**：`functionType` 必须原样使用函数目录的 `category`（如四则运算为 `operation`、日期函数为 `date`），不能用结果类型 `double` 代替。仅当函数目录实际返回 `excelFunc` 对象时才透传；没有就省略，尤其不能给 `×/÷/+/-` 伪造通用 `excelFunc`，否则编辑器会丢失运算符。禁止写字符串（如 `'mul'`）。
+- **函数来源与参数契约**：除 `custom`（自定义 JS）和 `code`（编码函数）外，标准函数名称、类别与**每个函数自身的完整参数契约**均内置在 Skill/CLI。参数不得泛化为 `param1/param2`：必须保留真实 `paramName`、`paramType`、`isRequire`、说明和枚举选项；例如 `DATEDIFF` 固定为 `startdate/enddate/datepart`。plan 只写函数名及实参；仅当计划实际使用函数时，CLI 才调用当前租户接口校验该函数可用并替换不可迁移的函数 ID，同时保留该租户的完整参数定义。接口不参与未使用函数的生成，也不决定标准函数是否受支持；当前租户缺少所用函数时明确停止。
+- 枚举函数参数的固定值必须从对应 `detail.paramSelectDetail` 选择；CLI 按选项的 `value` 写入真实值，并按该参数 detail 的 `paramType` 生成子 FormulaBean，不允许自定义参数类型或写入不存在的下拉值。示例：`DATEDIFF({date}, 预计完成日期, "天数") × 8` 中“天数”应匹配到 `{name:'天数',value:'dy'}`，最终写入 `value:'dy'`；首次用于新租户时仍应保存并回读确认。
+- **函数引用明细行字段**：函数参数若来自流程明细表，仍传真实 `paramKey:"<流程id>.<明细表id>[].<字段id>"`，但必须按手工编辑器的真实结构编译为 `type:3` 上下文引用，不能使用 `type:10/sub`，也不能使用 `mainBasis`。`value` 必须为 `FormData.<流程id>.<明细表id>[<索引子节点position>].<字段id>`；同时挂一个 `type:1`、`name/value:"0"` 的索引子节点，`[]` 内填写该子节点的 `position`。`config` 保留逻辑 `paramKey`（其中仍是 `[]`）、`fieldInfo.tablePrimaryKey:"FormData"`、`parentName:"<流程名>.<明细表名>[].<字段名>"` 和同样使用逻辑 `[]` 路径的 `multTypeObj`。缺少索引子节点时，编辑器会只显示红色字段名，丢失“流程触发 → 明细表[0] → 字段”的上下文链。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/ActionEbDelete.md

@@ -0,0 +1,23 @@
+# 删除表单数据（`ActionEbDelete`）
+
+## 何时使用
+
+按筛选条件删除 e-builder 表单数据；还原已删除数据使用 `ActionEbRecover`。
+
+## 先查询
+
+查询目标表单、条件字段和操作人。
+
+## 不可猜测
+
+筛选条件必须引用目标表真实字段；不能把名称或非本次上下文的字段键写入条件。
+
+## 最小计划
+
+`targetForm`、`person`、`filterCondition`。
+
+## filterCondition 格式
+
+**以 `references/condition_rules.md` 为准**：`{"field":{"id":"<目标字段id>","label":"<字段名>"},"operator":"eq","right":{...}}`。`field` 是 `{id,label}` 对象、`operator` 用英文操作符（`eq/neq/gt/lt/gte/lte/contains/uncontains/empty/nempty`）、右值键用 `right`。**勿用**废弃的 `value` 别名 / `=` / 裸字符串 `field`，否则编译报「左侧字段 id 不在目标表单实时字段列表中」。
+
+当条件左字段是「关联流程」Workflow 时，必须由 Skill 根据实时字段元数据和 `workflowPath.formIds` 反查真实流程表单对象；编译后的左值使用原始数字 `fieldName`、`fieldType:"String"`、顶层 `sformId` 和 `formInfo.formId/layoutId`，不得套用普通业务字段的 `field_` 前缀或把目标表单版本 ID写成 `sformId`。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/ActionEbRecover.md

@@ -0,0 +1,17 @@
+# 还原表单数据（`ActionEbRecover`）
+
+## 何时使用
+
+还原指定表单中已删除的一条数据。
+
+## 先查询
+
+查询目标表单和操作人；数据 ID 可来自上游真实上下文。
+
+## 不可猜测
+
+不能将表单 ID 当作数据 ID；目标表单必须是当前租户真实对象。
+
+## 最小计划
+
+`targetForm`、`person`、`updateId`。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/ActionEbSaveVersion.md

@@ -0,0 +1,17 @@
+# 存为版本（`ActionEbSaveVersion`）
+
+## 何时使用
+
+为已启用版本能力的 e-builder 数据创建大版本或小版本。
+
+## 先查询
+
+查询目标表单、操作人及待版本化的数据 ID 来源。
+
+## 不可猜测
+
+不确认目标表已启用版本时不生成；不可用表单 ID 替代数据 ID。
+
+## 最小计划
+
+`targetForm`、`person`、`updateId`；版本策略按需求指定。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/ActionEbUpdate.md

@@ -0,0 +1,67 @@
+# 更新表单数据（`ActionEbUpdate`）
+
+## 何时使用
+
+更新已有 e-builder 数据；新增数据使用 `ActionEbAdd`，删除数据使用 `ActionEbDelete`。
+
+## 先查询
+
+查询目标表单及字段；按条件更新还要确认条件左字段和本次触发器上下文。
+
+## 不可猜测
+
+`id`、`updateData`、`fieldUpdate` 三种定位方式互不替代。`basisValue` 只用于真实上游明细依据值。
+
+更新赋值可以使用固定值、上下文、动作流变量、租户常量或函数/公式；变量必须属于当前动作流场景，常量必须是当前租户真实常量 ID。新建资源和名称引用见 `references/dynamic_resources.md`。
+
+## 最小计划
+
+`targetForm`、`person`、更新赋值，以及与 `opType` 对应的定位参数。
+
+## 三种更新模式
+
+- `opType:"updateData"`：必须配置 `filterCondition`，仅按条件更新；不支持 `basisValue`，也不能同时配置 `updateId` 或 `updateFieldCondition`。
+- `opType:"id"`：必须配置 `updateId`。不填写 `basisValue` 时按数据 ID 更新单条数据；填写真实上游明细依据值后，按依据值批量更新。
+- `opType:"fieldUpdate"`：必须配置 `updateFieldCondition` 和 `updatePolicy`。不填写 `basisValue` 时按字段匹配更新单条数据；填写真实上游明细依据值后，按依据值批量更新。
+
+`basisValue` 只是 `id` 和 `fieldUpdate` 的批量开关，不能用于条件筛选更新。CLI 会在编译前校验这些组合，避免把一个模式的定位参数静默带入另一个模式。
+
+### 明细表策略
+
+更新组件的 `ActionEbDlg` 会为每张明细表单独保存策略。`detail` 每项至少包含 `detailTableId`，可使用以下结构：
+
+```json
+{
+  "detailTableId": "<目标明细表ID>",
+  "operateType": "update",
+  "basisValue": {"paramKey": "<来源明细paramKey>[]", "label": "<来源明细表>"},
+  "updateType": "fields",
+  "updateFieldCondition": {
+    "updateField": [
+      {"fieldKey": "<匹配字段ID>", "assign": {"kind": "context", "paramKey": "<来源字段>"}}
+    ]
+  },
+  "updatePolicy": "ALL",
+  "mapping": {"<来源字段>": "<目标明细字段ID>"},
+  "constants": {"<目标明细字段ID>": "<固定值>"},
+  "formula": {},
+  "deleteFields": []
+}
+```
+
+`operateType` 与前端枚举一致：`default`、`add`、`update`、`updateAdd`、`cover`、`delete`。
+
+- `add`/`cover`：用于按依据值新增或覆盖明细；有字段赋值时需要 `basisValue`。
+- `update`/`updateAdd`：必须有 `basisValue` 和至少一个字段赋值；`updateType` 只能是 `fields` 或 `rowId`。`fields` 必须提供 `updateFieldCondition.updateField`，`rowId` 必须提供 `rowId`。
+- `delete`：`updateType` 可为 `fields`、`rowId` 或 `deleteAll`。前两者需要 `basisValue` 和对应条件，`deleteAll` 不需要依据值且不配置字段赋值。
+- `updatePolicy` 仅用于 `update`/`updateAdd`，可选 `ALL`、`FIRST`、`LAST`、`ZERO`、`EXCEPTION`。
+
+当 `operateType` 为 `update` 或 `updateAdd` 且 `updateType` 为 `fields` 时，`updateFieldCondition.updateField[].fieldKey` 是专门用于匹配的条件字段，不能同时出现在 `mapping`、`constants` 或 `formula` 的目标字段中。编译后的 `EsbDetailForm.data` 与 `EsbDetailForm.updateFieldCondition` 对同一字段只能保留一份；主表的 `updateFieldCondition` 与 `setting.main` 也遵循同样规则。按 `rowId` 更新时不能再配置 `updateFieldCondition`。
+
+`rowId` 使用动态赋值对象，例如 `{"kind":"context","paramKey":"<来源明细ID>","label":"明细数据ID"}`；CLI 会将它包装为后端 `EsbDetailForm.rowId` 的 `FieldValue`。`deleteFields` 仍表示清除字段配置，不表示删除明细行；删除明细行必须使用 `operateType:"delete"`。
+
+## filterCondition 格式（opType=updateData 定位条件）
+
+**以 `references/condition_rules.md` 为准**：`{"field":{"id":"<目标字段id>","label":"<字段名>"},"operator":"eq","right":{...}}`。`field` 是 `{id,label}` 对象、`operator` 用英文操作符（`eq/neq/gt/lt/gte/lte/contains/uncontains/empty/nempty`）、右值键用 `right`。**勿用**废弃的 `value` 别名 / `=` / 裸字符串 `field`，否则编译报「左侧字段 id 不在目标表单实时字段列表中」。
+
+当条件左字段是「关联流程」Workflow 时，必须由 Skill 根据实时字段元数据和 `workflowPath.formIds` 反查真实流程表单对象；编译后的左值使用原始数字 `fieldName`、`fieldType:"String"`、顶层 `sformId` 和 `formInfo.formId/layoutId`，不得套用普通业务字段的 `field_` 前缀或把目标表单版本 ID写成 `sformId`。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/DateTrigger.md

@@ -0,0 +1,32 @@
+# 按日期字段触发（`DateTrigger`）
+
+## 何时使用
+
+根据 e-builder 数据中的日期/日期时间字段，在指定时机触发。
+
+## 先查询
+
+查询数据源、日期字段、可输出字段和操作人。
+
+## 不可猜测
+
+日期字段必须属于当前数据源；操作人必须是当前租户真实人员对象。
+
+## 最小计划
+
+`dataSource`、`dateField`、`operator`；其余时间规则按需求指定。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含后续链接/赋值需要的“数据ID”。
+
+## 重复周期
+
+`repeatType` 使用平台真实编码：
+
+| 值 | 含义 |
+|---|---|
+| `1` | 一次（不重复） |
+| `2` | 每天 |
+| `3` | 工作日（周一至周五） |
+| `4` | 每周 |
+| `5` | 每月 |
+| `6` | 每年 |
+
+不指定时默认为 `1`，即只触发一次。不要把 `1` 当成每日。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/EbGetDataById.md

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

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/EnquiryForm.md

@@ -0,0 +1,107 @@
+# 查询表单数据（`EnquiryForm`）
+
+## 何时使用
+
+查询 e-builder 表单列表或分组统计；按单条 ID 读取使用 `EbGetDataById`。
+
+## 先查询
+
+查询数据源、全部字段、筛选字段、输出字段和查询操作人。
+
+## 不可猜测
+
+筛选、排序、分组和输出字段都必须来自当前数据源；统计结果应作为后续节点上下文使用。
+
+## 最小计划
+
+`dataSource`、`person`；按 `opType` 补充查询字段和筛选条件。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含“数据ID”。未指定 `filter` 时，CLI 会生成平台必填的中性条件“数据ID不为空”，不改变业务筛选范围；只有明确指定 `filter` 时才使用业务条件。
+
+## 动态分页和条件
+
+- `formPageNo`、`formPageSize` 支持固定值、上下文、系统变量、变量、常量和函数/公式。
+- 需要由上游计算整段查询条件时使用 `conditionFormula`；它会写为 `conditionType:"assign"`，此时不得同时传 `filter`。
+- 普通业务筛选继续使用 `filter`，两种条件模式不能混用。
+
+## 分组/汇总查询
+
+`opType:"groupFields"` 是原生“分组/汇总”能力，不需要规则集或外部计算组件：
+
+- `groupFields` 是分组维度：`[{"field":"<真实字段id>"}]`；没有分组维度时传空数组。
+- `groupMessage` 是汇总值：`[{"field":"<真实字段id>","aggregator":"SUM"}]`。
+- 可用聚合方式：`SUM`、`MIN`、`AVG`、`MAX`、`COUNT`、`DISTINCTCOUNT`。其中 `SUM`/`AVG` 只用于数值字段。
+- 汇总输出字段名由平台固定为 `s_sum_<字段id>`、`s_min_<字段id>`、`s_avg_<字段id>`、`s_max_<字段id>`、`s_count_<字段id>`、`s_distinctcount_<字段id>`；后续节点引用它时使用 `kind:"query_result"`、`fieldId:"s_sum_<字段id>"`、`source:"<查询动作ref>"`、`index:0`。
+
+示例：汇总“收款金额”并让后续节点取第一条汇总结果：
+
+```json
+{
+  "type": "EnquiryForm",
+  "ref": "收款汇总",
+  "params": {
+    "dataSource": {"groupId":"<应用id>","id":"<合同收款表id>","text":"合同收款表"},
+    "person": {"type":"role"},
+    "opType": "groupFields",
+    "filter": {"field":{"id":"<关联项目字段id>","label":"关联项目"},"operator":"eq","right":{"kind":"context","paramKey":"<当前表单>.关联项目"}},
+    "groupFields": [],
+    "groupMessage": [{"field":"<收款金额字段id>","aggregator":"SUM"}]
+  }
+}
+```
+
+## 批量新增主表字段引用查询结果（2026-08-27 真机钉死）
+
+**结论：当需求确实需要反查时，EnquiryForm 查询结果可以赋给 `batchInsert` 主表字段（标量），但只限"单值反查"场景**。它不是任何表单新增动作的默认前置节点。手动创建成功样本：`references/examples/enquiry-form-batch-insert-scene2.json`（ApproveTrigger → EnquiryForm → ActionEbAdd(batchInsert) → Output）。样例中的 `opText` 是历史平台序列化快照，不是生成模板；生成时只依据语义 plan 和实时字段元数据，尤其不要复制其中 Workflow 左值的旧 `field_`/`Workflow` 组合。
+
+关键结构（与旧结论不同，已修正）：
+
+1. **EnquiryForm 节点（首动作）**：
+   - `dataSource.type = "LOGIC"`、`dataSource.groupId = "weaver-ebuilder-form-service"`（不是表单所属应用 id！）
+   - `queryFields[].id = "id"`（简写，不是 `{表id}[].id`）；`fieldGroup = { name: 表名, id: 表id }`
+   - 筛选：`filterInput.datas[].conditions.value` 用流程上下文 type=3（`ApprovalData.{wfId}.requestId`）
+   - 首动作 **不需要 sources**（undefined），ActionEbAdd 的 sources 指向 EnquiryForm 节点 wId
+
+2. **主表字段引用查询结果（项目名称 5453）**：
+   - assign：`type=3`，`value = "FormData.{查询表id}[{positionId}].id"`（**数组下标用 positionId 而非 `[]`**）
+   - `config.comType = "EnquiryForm"`、`config.comId = EnquiryForm 节点 id`、`config.paramKey = "{查询表id}[].id"`（paramKey 保持 `[]` 数组标记）
+   - **childs 必须带固定值取下标**：`[{ type: "1", value: "0", position: "{positionId}" }]`（value=0 取第一条）
+   - `frontId` = 查询结果字段的真实 `fieldId`（不能使用公式对象临时 id）；前端用它定位查询节点输出字段，否则会回显为“数据源查询（已删除）”并标红。
+
+3. 其余明细字段仍用依据值下级 type=10 直连（paramKey `{wfId}.{明细表id}[].{子字段id}`，source=event 节点 id）。
+
+4. 挂接注意：EnquiryForm 作为**流程首动作**保存成功；此前「两个起始执行组件」报错疑与给首动作补 sources 或 dataSource.type 用 FORM 有关，**勿给首动作补 sources**。
+
+计划中引用该结果时，必须显式写 `kind:"query_result"`，不能把它写成普通流程字段。例如：
+
+```json
+{
+  "mapping": {
+    "<查询表单id>[].id": {
+      "target": "<目标字段id>",
+      "kind": "query_result",
+      "source": "<EnquiryForm动作ref>",
+      "formId": "<查询表单id>",
+      "fieldId": "id",
+      "label": "数据ID",
+      "index": 0
+    }
+  }
+}
+```
+
+其中查询动作需显式声明例如 `{"type":"EnquiryForm","ref":"项目查询","params":{...}}`，后续写 `source:"项目查询"`。编译器会将该语义 `ref` 替换为实际节点 ID，并生成保存所需的 `childs` 下标公式；禁止使用或猜测平台节点 ID。
+
+## 关键边界：只支持"单值反查"，不支持"逐行明细反查"（2026-08-27 用户确认）
+
+**适用条件（场景2 成立的唯一前提）**：EnquiryForm 的筛选条件用的是**流程级唯一值**（如 `关联流程 eq requestId`），业务上一个流程只对应一条查询结果 → 取第一条（childs value=0）就是唯一那条，赋值主表字段正确。
+
+**禁止场景（多条结果）**：如果筛选条件用的是**明细行 id/明细字段**（如"按任务编号反查"），查询结果会有多条，且**数据源返回结果的顺序与流程明细表的行顺序不保证一致**（第 1 行明细对应的结果可能排在返回结果第 5 行）。此时：
+- 无法用"取第一条"对应到正确的明细行；
+- 无法把查询结果作为依据值（basisValue）传给下方组件——明细字段值仍需以**流程明细表本身作为依据值**（type=10 直连）；
+- **转化规则必须逐行做明细字段转化，多条结果做不到 → 该场景明确拒绝，不硬凑 EnquiryForm**。
+
+一句话决策：**EnquiryForm 反查只能给"与明细行无关的全局单值"（主表字段，按流程级唯一条件查）；凡需"按每行明细反查对应值"的，直接拒绝并告知用户**。
+
+## 曾经的错误结论（已推翻，勿沿用）
+
+- ~~EnquiryForm 输出是列表数组不能赋主表标量~~ → 实际通过 childs 固定值取下标（value=0 第一条）实现（仅限单值反查）。
+- ~~批量新增场景不要用 EnquiryForm 反查~~ → 单值反查是标准做法，见上；逐行反查仍不可行。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/EventButton.md

@@ -0,0 +1,33 @@
+# e-builder 按钮触发（`EventButton`）
+
+## 何时使用
+
+需求明确为点击 e-builder 表单上的某个按钮时触发。它与 `EventFormData` 不同：后者只监听数据变动，不能识别是由哪个按钮触发。
+
+## 先查询
+
+1. 用 `form-search '{"keyword":"<表名>"}'` 按表名直接拿到表单 `objId` 与所属业务应用 `appId`（同名表多于一条时按 `appName` 收窄，应用名同名多命中或查无会直接报错并给候选，改用 `appId`）；只知道应用时用 `form-applications` → `form-list`。返回体 `truncated: true` 表示还有命中未返回，**据此判定表单不存在是错的**，应按 `appName` 收窄或传 `{"max":0}`。
+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/skills/weaver-e10-builder/actionflows/references/components/ebuilder/EventFormData.md

@@ -0,0 +1,19 @@
+# 表单数据触发（`EventFormData`）
+
+## 何时使用
+
+在 e-builder 表单新增、更新或删除数据后触发动作流。
+
+## 先查询
+
+查询触发表单及允许作为触发字段的真实字段。
+
+## 不可猜测
+
+触发时机、表单和字段以当前租户返回为准；不要把流程表单误当 e-builder 独立表单。
+
+多条数据变动的后续触发方式通过 `triggerType` 支持：`sequence`（依次）、`merge`（合并）、`parallel`（并行）。
+
+## 最小计划
+
+`dataSource` 与 `triggerTimes`；按需求补充触发字段。

package/skills/weaver-e10-builder/actionflows/references/components/ebuilder/TimeBatchTrigger.md

@@ -0,0 +1,19 @@
+# 定时批量触发（`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/skills/weaver-e10-builder/actionflows/references/components/http/Http.md

@@ -0,0 +1,77 @@
+# 执行 HTTP（`Http`）
+
+执行已经在当前租户连接器中配置好的 HTTP/HTTPS 接口。平台前端组件类型是 `Http`；HTTPS 不是另一个组件类型，而是资源接口地址的协议。
+
+先运行：
+
+```bash
+e10-cli actionflow component-describe Http
+```
+
+按以下顺序发现真实对象，并把接口详情完整保存下来，避免终端摘要或截断输出造成误判：
+
+```bash
+e10-cli actionflow http-connectors --out http-connectors.json
+e10-cli actionflow http-resources '{"systemId":"<连接器ID>"}' --out http-resources.json
+e10-cli actionflow http-interfaces '{"systemId":"<连接器ID>","resourceId":"<资源ID>"}' --out http-interfaces.json
+e10-cli actionflow http-interface-detail '{"interfaceId":"<接口ID>"}' --out http-interface-detail.json
+```
+
+`http-interface-detail` 的 `request`、`response`、`address`、`requestMethod` 和 `type` 是生成计划的真实来源。正式 `generate` 还会在保存前再次按三个 ID 实时读取并校验这条链路：连接器名称/图标来自当前租户的 connector 列表，资源名称来自当前连接信息列表，接口名称和原生映射来自当前接口详情；找不到或归属不一致就停止，不会用旧环境的名称、图标或 DTO 继续生成。计划可以省略 `request`/`response`，但必须提供当前租户的三个 ID，CLI 会从接口详情补齐；如果显式传入原生映射，其 mapping ID 必须与当前接口详情一致。`type=http` 时地址可以是 `http://` 或 `https://`；`type=webservice` 时才考虑 `selectMethod`/`soapVersion`。
+
+## 必填对象
+
+- `systemId`：HTTP 连接器 ID。
+- `resourceId`：连接信息/资源 ID，必须属于 `systemId`。
+- `interfaceId`：执行接口 ID，必须属于 `resourceId`。
+- `request`：当前租户接口详情返回的原生 `ParamGroupMappingBean`。它是保存 HTTP 动作时的请求参数映射，不能用空数组或自行猜测的 `tables`/`tableData` 代替。
+
+这四项必须来自同一租户、同一条“连接器 → 资源 → 接口”链路。CLI 不根据名称猜 ID，也不把 HTTPS 地址改写成 HTTP。
+
+## 可选对象
+
+- `response`：接口详情返回的原生响应参数映射。传入后保留在节点数据中，供上下文字段和回读使用。
+- `address`：接口详情的回显地址；如果是 `https://`，必须原样保留。它不是替代 `resourceId/interfaceId` 的连接配置。
+- `requestMethod`：`GET`、`POST`、`PUT`、`PATCH` 或 `DELETE`。通常直接采用接口详情返回值。
+- `selectMethod`、`soapVersion`：只用于 WebService 兼容回显，普通 HTTP/HTTPS 接口不要填写。
+- `basisValue`：当请求 Body 是明细参数时传 `{ "paramKey": "<明细上下文paramKey>", "label": "<明细名>" }`，编译器写入平台 `basisValue` 和 `basisValueFormula`。
+- `inputParams`：请求参数赋值列表。每项必须指定真实的参数分组、参数名和赋值表达式；CLI 会把它写入对应请求参数行的 `formulaData`，保留接口详情原有的 `request.tables` 及参数元数据。
+
+输入参数格式是固定的：
+
+```json
+{
+  "inputParams": [
+    { "table": "Header", "paramKey": "Authorization", "value": { "kind": "fixed", "value": "Bearer xxx" } },
+    { "table": "Params", "paramKey": "requestId", "value": { "kind": "context", "paramKey": "requestId", "label": "流程ID" } },
+    { "table": "Header", "paramKey": "userid", "value": { "kind": "system_variable", "key": "{userid}" } }
+  ]
+}
+```
+
+`table` 只能是接口详情实际返回的 `Params`、`Header`、`Body`、`Url` 或 `Cookie`；`paramKey` 必须精确匹配该分组的真实参数（包括 JSON/明细字段的完整路径）。`value` 使用统一赋值类型，除上例外还可使用已支持的 `function`、`formula`、`variable`、`constant`、`transform` 和 `query_result`；变量/常量必须先按 `references/dynamic_resources.md` 解析，函数参数仍按函数目录的真实参数名和数量填写。CLI 会在保存前校验分组和参数是否存在，不能猜参数或静默新增参数。
+
+## 示例
+
+以下只展示结构，ID 和 `request` 必须替换为当前租户真实接口详情回读值：
+
+```json
+{
+  "type": "Http",
+  "params": {
+    "systemId": "<当前租户HTTP连接器ID>",
+    "resourceId": "<该连接器的资源ID>",
+    "interfaceId": "<该资源的接口ID>",
+    "address": "https://api.example.com/project",
+    "requestMethod": "POST",
+    "request": {
+      "<接口详情返回的原生字段>": "<按平台参数设计器保存的原值>"
+    },
+    "response": {
+      "<接口详情返回的原生响应字段>": "<按平台参数设计器保存的原值>"
+    }
+  }
+}
+```
+
+`response` 仍必须使用接口详情返回的原生对象。`request` 的结构和参数元数据不能用通用对象替换；但请求字段的赋值可以通过 `inputParams` 使用统一的固定值、上下文、系统变量或函数/公式语义，CLI 会转换成前端真实的 `formulaData` 协议。没有真实原生对象或参数不在接口详情中时，停止生成并先补齐接口上下文。

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

@@ -0,0 +1,23 @@
+# 条件分支（`Condition`）
+
+## 何时使用
+
+根据上游字段进入 if/else if/else 分支。
+
+## 先查询
+
+查询当前触发器的真实上下文字段及字段类型。
+
+## 不可猜测
+
+条件左值只能引用当前可见上下文；右值、操作符和字段类型必须匹配。未知操作符或类型不兼容必须报错，不能静默改成“等于”。无法通过条件编辑器实际回显时，不伪称已验证。
+
+右值使用 `fixed`、`system`、`context` 之一；动态右值传 `type:"context"` 和真实 `paramKey`，或传平台回读的完整 `formula`。不要把动态字段名当作固定字符串。
+
+## 保存与回读
+
+分支条件由运行时在预暂存注册来源节点后保存：取得真实 `mapBaseId`，保存完整 `childrens` 树，并以保存响应的真实 `conditionId/mapBaseId/mapId` 回填设计。顶层 `relationship` 直接作为根关系，不能再包一层相同关系的子组；只有 plan 明确写出的嵌套 AND/OR 才保留嵌套。新建后 `getExpressionBean` 可能只返回分组骨架，不能以它覆盖完整叶子树。所有平台 Long ID 都按字符串处理；最终以动作流暂存回读和设计器弹窗确认。
+
+## 最小计划
+
+`branches`，每个 if/else if 有真实 `condition`，每个分支有动作列表。