weaver-e10-builder 1.0.10-beta → 1.0.12-beta

package/skill-docs/actionflows/references/components/document/AttachmentMove.md

@@ -0,0 +1,17 @@
+# 附件归档（`AttachmentMove`）
+
+## 何时使用
+
+将附件移动到指定文档目录。
+
+## 先查询
+
+查询附件、目标目录及操作人。
+
+## 不可猜测
+
+目录和可选 `fileFolderChild` 必须来自前端真实对象。
+
+## 最小计划
+
+`attachment`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentCopy.md

@@ -0,0 +1,17 @@
+# 文档另存为（`DocumentCopy`）
+
+## 何时使用
+
+把指定文档保存为另一篇新文档。
+
+## 先查询
+
+查询源文档、目标目录与操作人。
+
+## 不可猜测
+
+源文档和目录必须为真实 Browser 对象。
+
+## 最小计划
+
+`documents`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentDelete.md

@@ -0,0 +1,17 @@
+# 删除文档（`DocumentDelete`）
+
+## 何时使用
+
+将文档删除至回收站或按平台允许方式删除。
+
+## 先查询
+
+查询文档和操作人。
+
+## 不可猜测
+
+删除对象必须是当前租户真实文档。
+
+## 最小计划
+
+`documents`、`operator`、`deleteType`。

package/skill-docs/actionflows/references/components/document/DocumentEdit.md

@@ -0,0 +1,17 @@
+# 更新文档（`DocumentEdit`）
+
+## 何时使用
+
+更新文档字段、正文或附件。
+
+## 先查询
+
+查询目标文档、操作人和需要的前端设置 DTO。
+
+## 不可猜测
+
+至少提供一项实际变更；正文、附件流和设置对象只能使用真实 DTO。
+
+## 最小计划
+
+`documentId`、`operatorId` 与一项变更。

package/skill-docs/actionflows/references/components/document/DocumentMove.md

@@ -0,0 +1,17 @@
+# 移动文档（`DocumentMove`）
+
+## 何时使用
+
+将文档移动到目标目录。
+
+## 先查询
+
+查询文档、目录和操作人。
+
+## 不可猜测
+
+目录设置或子目录对象不能伪造。
+
+## 最小计划
+
+`documents`、`fileFolder`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentPermissionChange.md

@@ -0,0 +1,17 @@
+# 文档权限变更（`DocumentPermissionChange`）
+
+## 何时使用
+
+对文档执行赋权或收权。
+
+## 先查询
+
+查询文档及平台返回的权限对象。
+
+## 不可猜测
+
+固定赋权只能传真实 `SharePermissionBean`；动态赋权传真实上下文公式。
+
+## 最小计划
+
+`docId`、`assignType`，以及对应的 `permissionList` 或 `permissionFormula`。

package/skill-docs/actionflows/references/components/document/DocumentRenewal.md

@@ -0,0 +1,17 @@
+# 续借文档（`DocumentRenewal`）
+
+## 何时使用
+
+发起订阅文档的续借。
+
+## 先查询
+
+查询可续借文档与续借人。
+
+## 不可猜测
+
+文档必须是当前租户真实订阅/文档对象。
+
+## 最小计划
+
+`documentId`、`operatorId`。

package/skill-docs/actionflows/references/components/document/DocumentRevert.md

@@ -0,0 +1,17 @@
+# 还原删除文档（`DocumentRevert`）
+
+## 何时使用
+
+还原已删除文档。
+
+## 先查询
+
+确认已删除文档和操作人。
+
+## 不可猜测
+
+只处理真实回收站文档。
+
+## 最小计划
+
+`documents`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentSave.md

@@ -0,0 +1,17 @@
+# 新建文档（`DocumentSave`）
+
+## 何时使用
+
+在目标目录新建一篇文档。
+
+## 先查询
+
+查询目录、操作人及文档属性设置 DTO。
+
+## 不可猜测
+
+标题、目录、操作人和 `setting` 缺一不可；正文与附件只接受真实 DTO 或文件引用。
+
+## 最小计划
+
+`docTitle`、`fileFolder`、`operatorId`、`setting`。

package/skill-docs/actionflows/references/components/document/DocumentSubscription.md

@@ -0,0 +1,17 @@
+# 借阅文档（`DocumentSubscription`）
+
+## 何时使用
+
+发起文档借阅。
+
+## 先查询
+
+查询可借阅文档和操作人。
+
+## 不可猜测
+
+文档必须是当前租户真实订阅/文档对象。
+
+## 最小计划
+
+`documents`、`operator`。

package/skill-docs/actionflows/references/components/document/DocumentSubscriptionApprove.md

@@ -0,0 +1,17 @@
+# 文档借阅批准（`DocumentSubscriptionApprove`）
+
+## 何时使用
+
+批准文档借阅。
+
+## 先查询
+
+查询文档与借阅人。
+
+## 不可猜测
+
+借阅人必须为真实 Browser 对象。
+
+## 最小计划
+
+`documents`、`subscriber`。

package/skill-docs/actionflows/references/components/document/DocumentSubscriptionSendBack.md

@@ -0,0 +1,17 @@
+# 文档借阅退回（`DocumentSubscriptionSendBack`）
+
+## 何时使用
+
+处理文档借阅退回。
+
+## 先查询
+
+查询文档与借阅人。
+
+## 不可猜测
+
+不以文档名称或人员名称替代真实对象。
+
+## 最小计划
+
+`documents`、`subscriber`。

package/skill-docs/actionflows/references/components/document/DocumentSubscriptionWithdraw.md

@@ -0,0 +1,17 @@
+# 文档借阅收回（`DocumentSubscriptionWithdraw`）
+
+## 何时使用
+
+收回已借出的文档。
+
+## 先查询
+
+查询文档与借阅人。
+
+## 不可猜测
+
+仅对当前租户真实借阅记录执行。
+
+## 最小计划
+
+`documents`、`subscriber`。

package/skill-docs/actionflows/references/components/document/FileFolderSave.md

@@ -0,0 +1,17 @@
+# 创建文件夹（`FileFolderSave`）
+
+## 何时使用
+
+在指定上级目录创建文件夹。
+
+## 先查询
+
+查询上级目录、操作人及前端返回的子目录定义。
+
+## 不可猜测
+
+`fileFolderChild` 是前端 DTO，不能仅以名称拼造。
+
+## 最小计划
+
+`fileFolder`、`fileFolderChild`、`operator`。

package/skill-docs/actionflows/references/components/document/GetAttachmentInfo.md

@@ -0,0 +1,17 @@
+# 获取附件信息（`GetAttachmentInfo`）
+
+## 何时使用
+
+读取附件详情供后续节点使用。
+
+## 先查询
+
+确认附件 ID 来源和操作人。
+
+## 不可猜测
+
+附件 ID 不能由文件名推断。
+
+## 最小计划
+
+`attachmentId`、`operatorId`。

package/skill-docs/actionflows/references/components/document/GetDocumentInfo.md

@@ -0,0 +1,17 @@
+# 获取文档信息（`GetDocumentInfo`）
+
+## 何时使用
+
+读取文档详情供后续节点使用。
+
+## 先查询
+
+确认文档 ID 来源与操作人。
+
+## 不可猜测
+
+固定文档应使用真实 Browser 对象，上游值使用真实上下文。
+
+## 最小计划
+
+`docId`、`operatorId`。

package/skill-docs/actionflows/references/components/document/ModifyDocumentStatus.md

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

package/skill-docs/actionflows/references/components/document/ReplaceAttachment.md

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

package/skill-docs/actionflows/references/components/document/UpdatePrintNum.md

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

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

@@ -0,0 +1,39 @@
+# 新建表单数据（`ActionEbAdd`）
+
+## 何时使用
+
+向指定 e-builder 表单新增一条或一批数据；已有数据要修改时改用 `ActionEbUpdate`。
+
+## 先查询
+
+查询目标应用、表单、全量字段及创建人。明细赋值还须查询明细字段。
+
+## 不可猜测
+
+`targetForm`、人员和字段 ID 必须来自当前租户。动态来源只能使用本次触发器的真实 `paramKey`。
+
+## 最小计划
+
+`targetForm`、`person`，以及至少一项 `mapping`、`constants`、`formula` 或 `setting`。
+
+操作人选择：需求明确指定某人时才传该人的真实 Browser 对象并显示为固定值；需求未指定时传 `{"type":"role"}`，生成当前人 `{userid}` 动态值。不得为了补必填项从人员列表任意挑一个人。
+
+`opType:"batchInsert"` 时，`basisValue` 与 `mapping` 都是必填：前者指定要逐行遍历的上游明细，后者指定每行写入哪些目标字段。两者任一缺失，CLI 会在创建动作流前停止，绝不保存空壳批量节点。
+
+若流程触发器上下文中存在 `requestId`，而目标表恰有唯一一个未赋值的流程关联 Browser 字段（如“来源流程”或“关联流程”），CLI 会把它自动映射为当前流程实例 ID，并在结果的 `autoMappings` 中列出。显式映射、固定值、公式和旧 `setting` 始终优先，不会被覆盖；字段不唯一或类型不是流程关联字段时不猜测。
+
+## 动态来源选择与查询结果引用
+
+- 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"` 和查询节点 `ref`；未选择时使用普通 `context`、`fixed`、`system_variable` 或函数树，不产生查询结果公式。
+
+## 函数公式赋值（type=6）
+
+- **plan 写法**：顶层 `formula: {目标字段id: <函数树>}`；函数调用为 `{kind:'function', name:'DAYS', args:[...]}`，args 可为 `{kind:'context', paramKey, label, fieldType}` / `{kind:'fixed', value}` / 嵌套 `{kind:'function'}`。`+`、`−`、`×`、`÷` 本身也是函数名；旧 `op: 'add'|'sub'|'mul'|'div'` + fields 列表仅保留兼容。
+- **保存结构**：assign `type=6`，`value="{fnId}#{child.id}#..."`；`childs` 以子公式对象的 `id` 串联。内层函数同样 type=6 嵌套，叶子上下文 type=3 / 固定值 type=1。
+- **excelFunc 必须是对象**：四则运算函数目录无 excelFunc，CLI 传 `null` 由 FormulaBean 构造器生成对象兜底；函数目录带 excelFunc 的（如 DAYS/TODAY）原样透传对象。禁止写字符串（如 `'mul'`）。
+- **函数来源**：除 `custom`（自定义 JS）和 `code`（编码函数）外，标准函数名称、类别与参数约束均内置在 Skill/CLI。plan 只写函数名；仅当计划实际使用函数时，CLI 才调用当前租户接口校验该函数可用并替换函数 ID。接口不参与未使用函数的生成，也不决定标准函数是否受支持；当前租户缺少所用函数时明确停止。
+- 任务工时示例：`DAYS(预计完成日期, TODAY()) × 8`：`{kind:'function',name:'×',args:[{kind:'function',name:'DAYS',args:[{kind:'context',paramKey:'<日期字段>',label:'预计完成日期',fieldType:'date'},{kind:'function',name:'TODAY',args:[]}]},{kind:'fixed',value:8}]}`；首次用于新租户时仍应保存并回读确认。

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

@@ -0,0 +1,21 @@
+# 删除表单数据（`ActionEbDelete`）
+
+## 何时使用
+
+按筛选条件删除 e-builder 表单数据；还原已删除数据使用 `ActionEbRecover`。
+
+## 先查询
+
+查询目标表单、条件字段和操作人。
+
+## 不可猜测
+
+筛选条件必须引用目标表真实字段；不能把名称或非本次上下文的字段键写入条件。
+
+## 最小计划
+
+`targetForm`、`person`、`filterCondition`。
+
+## filterCondition 格式
+
+**以 `actionflows/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 不在目标表单实时字段列表中」。

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

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

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

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

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

@@ -0,0 +1,21 @@
+# 更新表单数据（`ActionEbUpdate`）
+
+## 何时使用
+
+更新已有 e-builder 数据；新增数据使用 `ActionEbAdd`，删除数据使用 `ActionEbDelete`。
+
+## 先查询
+
+查询目标表单及字段；按条件更新还要确认条件左字段和本次触发器上下文。
+
+## 不可猜测
+
+`id`、`updateData`、`fieldUpdate` 三种定位方式互不替代。`basisValue` 只用于真实上游明细依据值。
+
+## 最小计划
+
+`targetForm`、`person`、更新赋值，以及与 `opType` 对应的定位参数。
+
+## filterCondition 格式（opType=updateData 定位条件）
+
+**以 `actionflows/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 不在目标表单实时字段列表中」。

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

@@ -0,0 +1,17 @@
+# 按日期字段触发（`DateTrigger`）
+
+## 何时使用
+
+根据 e-builder 数据中的日期/日期时间字段，在指定时机触发。
+
+## 先查询
+
+查询数据源、日期字段、可输出字段和操作人。
+
+## 不可猜测
+
+日期字段必须属于当前数据源；操作人必须是当前租户真实人员对象。
+
+## 最小计划
+
+`dataSource`、`dateField`、`operator`；其余时间规则按需求指定。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含后续链接/赋值需要的“数据ID”。

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

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

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

@@ -0,0 +1,75 @@
+# 查询表单数据（`EnquiryForm`）
+
+## 何时使用
+
+查询 e-builder 表单列表或分组统计；按单条 ID 读取使用 `EbGetDataById`。
+
+## 先查询
+
+查询数据源、全部字段、筛选字段、输出字段和查询操作人。
+
+## 不可猜测
+
+筛选、排序、分组和输出字段都必须来自当前数据源；统计结果应作为后续节点上下文使用。
+
+## 最小计划
+
+`dataSource`、`person`；按 `opType` 补充查询字段和筛选条件。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含“数据ID”。
+
+## 批量新增主表字段引用查询结果（2026-08-27 真机钉死）
+
+**结论：当需求确实需要反查时，EnquiryForm 查询结果可以赋给 `batchInsert` 主表字段（标量），但只限"单值反查"场景**。它不是任何表单新增动作的默认前置节点。手动创建成功样本：`actionflows/references/examples/enquiry-form-batch-insert-scene2.json`（ApproveTrigger → EnquiryForm → ActionEbAdd(batchInsert) → Output）。
+
+关键结构（与旧结论不同，已修正）：
+
+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` = 查询结果字段的临时 id（非表单字段 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/skill-docs/actionflows/references/components/ebuilder/EventFormData.md

@@ -0,0 +1,17 @@
+# 表单数据触发（`EventFormData`）
+
+## 何时使用
+
+在 e-builder 表单新增、更新或删除数据后触发动作流。
+
+## 先查询
+
+查询触发表单及允许作为触发字段的真实字段。
+
+## 不可猜测
+
+触发时机、表单和字段以当前租户返回为准；不要把流程表单误当 e-builder 独立表单。
+
+## 最小计划
+
+`dataSource` 与 `triggerTimes`；按需求补充触发字段。

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

@@ -0,0 +1,17 @@
+# 定时批量触发（`TimeBatchTrigger`）
+
+## 何时使用
+
+按 Quartz Cron 表达式扫描 e-builder 表单中满足条件的数据，并逐条触发后续动作。
+
+## 先查询
+
+查询数据源、查询/筛选字段与操作人。
+
+## 不可猜测
+
+批量筛选只能使用数据源真实字段；操作人不能使用文本或不存在的系统别名。
+
+## 最小计划
+
+`dataSource`、`cornString`、`operator`；按需求补充查询字段和筛选条件。未明确限制 `queryFields` 时不要传它（或传空数组），CLI 会默认全选主表和系统字段，包含后续链接/赋值需要的“数据ID”。只支持 Quartz Cron，例如每天 10:00：`0 0 10 * * ?`。

package/skill-docs/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` 回填设计。新建后 `getExpressionBean` 可能只返回分组骨架，不能以它覆盖完整叶子树。所有平台 Long ID 都按字符串处理；最终以动作流暂存回读和设计器弹窗确认。
+
+## 最小计划
+
+`branches`，每个 if/else if 有真实 `condition`，每个分支有动作列表。