weaver-e10-builder 1.1.9 → 1.2.2

package/skill-docs/_catalog.md

@@ -1,66 +1,77 @@
-# Skill Ebcoder 目录索引
-
-> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
->
-> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
-
-## Guides（编码指南）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
-| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
-| 字段联动、显隐联动、条件显示、form linkage | `references/form/guide-form-linkage.md` |
-| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
-| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
-| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
-| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
-| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
-| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
-| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
-| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
-| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
-| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
-| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
-| HRM矩阵、条件矩阵、matrix、映射表 | `references/hrm/guide-matrix.md` |
-| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
-| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
-
-## Reference（参考手册）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
-| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
-| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
-
-## Components（组件文档）
-
-| 用户意图关键词 | 加载文档 |
-|---------------|---------|
-| Button、按钮 | `references/components/@weapp-Button.md` |
-| Table、表格 | `references/components/display-Table.md` |
-| List、列表 | `references/components/display-List.md` |
-| Pagination、分页 | `references/components/display-Pagination.md` |
-| Icon、图标 | `references/components/display-Icon.md` |
-| Avatar、头像 | `references/components/display-Avatar.md` |
-| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
-| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
-| Input、输入框、文本框 | `references/components/form-Input.md` |
-| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
-| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
-| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
-| Badge、徽标 | `references/components/base-Badge.md` |
-| Tag、标签 | `references/components/base-Tag.md` |
-
-## 组合场景
-
-| 场景 | 需加载的文档 |
-|------|-------------|
-| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
-| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
-| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
-| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
-| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
-| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
-| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |
+# Skill Ebcoder 目录索引
+
+> 此文件列出所有子文档的加载条件，供 Agent 按需加载。不要一次性加载全部。
+>
+> 以下所有路径统一写作 `references/...`：相对工作区根目录（`skill copy` 拷出的位置），或本机 skill 根目录（完整安装自带）。
+
+## Guides（编码指南）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| 表单CRUD、增删改查、getSimpleData、withDisplayNames、getFieldOptions、saveFormData、updateFormData、deleteFormData、字段类型 | `references/coding/guide-form-crud.md`（前端代码） |
+| 编辑、修改、回显、handleEdit、getAllData、rawData、selectedPerson、editForm、数据回填 | `references/coding/guide-edit-backfill.md`（前端代码） |
+| 字段联动、显隐联动、条件显示、form linkage | `references/form/guide-form-linkage.md` |
+| 新建表单、form create、EB 表单标准创建流程 | `references/form/guide-create-form.md` |
+| 虚拟表、虚拟表单、数据源表单、业务表展示、数据加工结果 | `references/form/guide-virtual-form.md` |
+| 字段定义、字段类型、关联字段码表、DateRange、multiple | `references/form/ref-form-fields.md` |
+| FLOW/EXCEL、布局样表、布局蓝图、字段分组、singleRow | `references/form/guide-form-layout-planning.md` |
+| 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
+| 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
+| 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
+| 权责表、权责矩阵、权责表方式流程、分支场景、变量映射 | `references/workflow/guide-workflow-auth-resp.md` + `references/workflow/guide-workflow-condition.md` |
+| 公文流程、公文审批、收文、发文、公文设置、正文设置 | `references/workflow/guide-workflow-odoc.md` + `references/workflow/guide-workflow.md` |
+| 分支条件、出口条件、条件JSON、save-condition、连线条件、condition add | `references/workflow/guide-workflow-condition.md` |
+| 条件操作符编码、字段类型矩阵、关系符 | `references/workflow/operator-matrix.md` |
+| 动作流、跨表单、写入台账、ActionEbAdd/ActionEbUpdate/ActionEbDelete、提交事件、自定义事件触发、内置MQ监听/发送、HTTP/HTTPS、DML/数仓 | `references/workflow/guide-workflow-action.md`；复杂动作流组件契约按需读取 `actionflows/SKILL.md` 及其 `references/components/` |
+| 鉴权、登录、auth、ETEAMSID、多环境、profile、切换环境 | `references/auth/guide-auth.md` |
+| HRM矩阵、条件矩阵、matrix、映射表 | `references/hrm/guide-matrix.md` |
+| 报表、设计器报表、EDC报表、新建报表、report build、数据集、报表列、父格、合并、冻结、tableName | `references/report/guide-report-build.md`（建表主干）· `guide-report-modify.md`（改已有）· `ref-report-pitfalls.md`（先扫坑） |
+| 报表查询条件、高级搜索、筛选、queryType、默认值三件套 | `references/report/guide-report-query.md`；细则 `query-condition-api-guide.md` |
+| 报表命令、report 子命令、report build/verify/fix/scope/snapshot | `references/report/ref-report-commands.md` |
+| 报表接口、saveReportDevInfo、addDataset、getReportDevInfo、报表落库流程 | `references/report/api-report-build-fast-path.md` · `report-config-schema.md`（配置结构） · `report-data-model.md`（枚举） |
+| 报表单元格模型、cellType、displayType、expandType、groupType、countType | `references/report/report-data-model.md` · `report-config-schema.md` |
+| 报表权限、共享范围、viewRight、权责矩阵 | `references/report/report-permission-guide.md` |
+| 报表版本、快照、生命周期、回收站、复制挂菜单 | `references/report/report-lifecycle-api-guide.md` |
+| 报表条件格式、数据条、图标集 | `references/report/condition-format-guide.md` |
+| 新页面、导出、路由、entry.js、regOvProps、regReactChildren、asyncImport、publicUrl、Suspense | `references/coding/guide-page-export.md`（前端代码） |
+| 写页面、页面代码、React编码、组件、entry.js模板 | `references/coding/guide-page-code.md`（前端代码） |
+
+## Reference（参考手册）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
+| 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
+| 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
+
+## Components（组件文档）
+
+| 用户意图关键词 | 加载文档 |
+|---------------|---------|
+| Button、按钮 | `references/components/@weapp-Button.md` |
+| Table、表格 | `references/components/display-Table.md` |
+| List、列表 | `references/components/display-List.md` |
+| Pagination、分页 | `references/components/display-Pagination.md` |
+| Icon、图标 | `references/components/display-Icon.md` |
+| Avatar、头像 | `references/components/display-Avatar.md` |
+| EChart、图表、Echarts | `references/components/generic-Echarts.md` |
+| 文件预览、CorsComponent | `references/components/display-FilePreview.md` |
+| Input、输入框、文本框 | `references/components/form-Input.md` |
+| 人员选择、Browser Employee、resource | `references/components/form-EmployeeBrowser-api.md` |
+| 部门选择、Browser Department、department | `references/components/form-DepartmentBrowser-api.md` |
+| Upload、文件上传、附件、FileComponent | `references/components/form-Upload.md` |
+| Badge、徽标 | `references/components/base-Badge.md` |
+| Tag、标签 | `references/components/base-Tag.md` |
+
+## 组合场景
+
+| 场景 | 需加载的文档 |
+|------|-------------|
+| CRUD 列表页 | `references/coding/guide-form-crud.md`（前端代码） + `references/components/display-Table.md` + `references/components/display-Pagination.md` |
+| 表单新增/编辑弹窗 | `references/coding/guide-form-crud.md`（前端代码） + `references/coding/guide-edit-backfill.md` + 对应表单组件文档 |
+| 新建完整应用 | `references/common/ref-cli-commands.md` + `references/form/guide-create-form.md` + `references/coding/guide-page-export.md`（前端代码） |
+| 流程触发页面 | `references/workflow/guide-workflow.md` + `references/coding/guide-form-crud.md`（前端代码） |
+| 流程分支条件 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-condition.md` |
+| 跨表单动作流 | `references/workflow/guide-workflow.md` + `references/workflow/guide-workflow-action.md` |
+| 编译报错排查 | `references/coding/ref-compile-rules.md`（前端代码） |

package/skill-docs/actionflows/SKILL.md

@@ -14,6 +14,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 - **运行模式（默认）**：只运行 `e10-cli actionflow <命令>`、读取本 Skill 的当前阶段/当前组件说明；不得读取或修改 e10-cli 源码（`packages/cli/src/services/actionflow/`）。
 - **维护模式**：仅在用户明确要求修复、审计或新增组件时编辑实现；修改后必须跑类型检查、测试、构建和本 Skill 校验。校验目标固定为 `skill/actionflows`：不要把上层 `skill` 或发布目录 `skill-docs` 当作这个动作流 Skill 的标准目录校验。上层入口包含 E10 包的自定义元数据（如 `author`、`category`、`version`、`display_name`），不因通用校验器不认识这些扩展字段而改写、删除或迁移它们。
 - 参数、默认值、动态必填、真实对象结构的唯一权威是 `e10-cli actionflow component-describe <type>`，参考文件不重复属性表。
+- 动态赋值必须按“组件 × 属性”判断，不能因为属性类型写着 `Browser` 或 `platform_reference` 就一律当成固定值。先读取 [`references/dynamic_capability_matrix.md`](references/dynamic_capability_matrix.md)，再以当前租户 `component-describe`、上下文元数据和组件编译器实际契约为准；矩阵没有明确标记为已支持的属性不得臆造动态 DTO。
 
 ## 生成 SOP
 
@@ -43,15 +44,17 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 
 1. 写入 `event`、`actions`，条件和循环作为动作拓扑的一部分。
 2. 只传 `component-describe` 声明的参数；固定值与动态值根据业务需求选择，不能为了动态而动态。
-3. 中文 plan 写入当前工作区 `.actionflow-plans/`，以 `planFile` 传给 CLI；不在 Skill 目录写临时文件。CLI 不会自动删除 plan；确认 `valid=true`、`saved=true`、`readBackVerified=true` 后才允许手工清理。
-4. 不手写 `Output`、平台内部字段或 FormulaBean DTO，除非组件契约明确要求前端原对象。
-5. 定时组件只使用 Quartz Cron：传 `cornString`，不传 `rate`、`hour`、`cycle`、`day` 等历史调度参数。
-6. 触发器或查询组件未被需求明确限制输出字段时，不传 `queryFields`（或传空数组）：CLI 会默认全选，包含“数据ID”。如果需求明确引用某个业务字段，必须从当前租户的实时字段接口/字段选择器获取完整字段对象并保存真实 `id`，不能凭字段名、临时 ID 或只拼 `id/content`。查询节点还必须使用自身真实节点 ID 作为 `dataSource.enquiryId`，否则平台可能静默丢弃业务字段。正式回读必须确认每个声明的 `queryFields` 仍存在；缺失即生成失败，不能仅凭接口 `code=200`、`saved=true` 判定成功。e-builder 数据触发后发送消息且未显式给链接时，CLI 自动补 PC/移动端当前记录详情链接；不手写 `{formId}` / `{dataId}` 的 FormulaBean。查询结果字段动态赋值必须按手工设计器对象编译：普通业务字段使用 `FormField.<查询表单ID>.field_<真实字段ID>`，`config.paramKey` 使用 `<查询表单ID>.field_<真实字段ID>`，`config.fieldInfo.tablePrimaryKey` 为 `FormField`；系统字段按平台真实字段键（例如 `id`）保留。禁止使用 `FormData.<表单ID>[临时位置]...`，也禁止把临时公式 ID 当作 `frontId`。
-7. `ActionEbAdd` 批量新增以 `basisValue` 为明细行上下文：来源于该行的字段都用 `mapping`，编译为“依据值下级”（`switchType:"sub"`），下拉字段也同样处理。只有已核实来源/目标选项 ID 不同且语义需要转换时，才使用 `SWITCH`。关联 e-builder 字段应引用查询结果的 `数据ID`，固定格式为 `{target,kind:"query_result",source:"<EnquiryForm ref>",formId,fieldId:"id",index:0}`；`kind:"enquiry"`、`sourceId` 等旧写法会直接报错，绝不降级为空固定值。
-8. 动态赋值可使用或新建动作流变量、租户常量：已有资源必须用真实 ID；计划新建变量写顶层 `variables[]`，新建常量写 `constantDefinitions[]`，常量分组可传 `groupPk` 或 `groupName`。变量按当前 `applicationId + sceneId` 隔离，常量按分组跨动作流复用。生成时先调用真实接口创建/解析资源，再编译为变量 `type:"7"` 或常量 `type:"5"` FormulaBean；详细格式见 `references/dynamic_resources.md`。消息 `parts` 也支持 `variable`/`constant` 动态片段。
-8. 自定义事件和内置 MQ 的参数必须按对应平台组件说明提供原生参数对象；`CustomTrigger.customData`、`InnerMQListener.receiveParams`、`InnerMQSend.sendParams` 不能用猜测的字段替代。若验证要求“输入参数里有字段”，必须在生成前提供至少一行真实原生参数；`tables:[]`、`tableList:[]` 或省略 `receiveParams` 只能表示无输入参数，不能作为有参数的占位。`InnerMQListener` 与 `InnerMQSend` 是动作流级互斥组件，同一计划（包括条件/循环嵌套）同时出现时，CLI 在任何平台写接口前直接报错。
-9. 根触发节点的 `event.attr.icon` 必须使用平台真实图标：`CustomTrigger` 为 `Icon-N-Triggerrul`，`InnerMQListener` 为 `Icon-built-in-mq-listening-mcolor`；组件目录里的动作图标不能覆盖根触发器图标。保存后回读必须同时检查触发器图标、已声明输入参数的数量和查询字段，不能仅凭 `valid=true` / `saved=true` 判定配置正确。
-10. `InnerMQSend.sendParams.tableData` 必须遵循“参数类型决定数据类型候选”的平台规则：普通非数组标量通常只有“属性”一个选项，不应伪造可下拉状态；数组或 `json/xml/xml_string` 结构化参数才按真实候选设置 `dataType`，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
+3. 语义 plan 的节点配置统一放在 `params`：`event.params`、`actions[*].params` 以及条件/循环内部节点的 `params`。`data` 仅属于平台回读/更新 DTO，不能出现在 `generate` 语义计划中；CLI 会在调用任何平台接口前拒绝该结构，并提示具体路径。
+4. 中文 plan 写入当前工作区 `.actionflow-plans/`，以 `planFile` 传给 CLI；不在 Skill 目录写临时文件。CLI 不会自动删除 plan；确认 `valid=true`、`saved=true`、`readBackVerified=true` 后才允许手工清理。
+5. 不把 `Output` 写入 `actions`。需要配置终止状态、提示或页面动作时使用顶层 `finalOutput.params`；平台内部 FormulaBean 由 CLI 生成，只有组件契约明确要求前端原对象时才传原生 DTO。
+6. 定时组件优先使用平台原生频率：`rate=1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月，并按需提供 `cycle`、`hour`、`day`、`week`、`atWeek`、`atWeekDetail` 或 `lastWeek`；只有明确选择 `rate=6` 时才传 `cornString`。图形化频率必须提供 `startTime`。
+7. 触发器或查询组件未被需求明确限制输出字段时，不传 `queryFields`（或传空数组）：CLI 会默认全选，包含“数据ID”。如果需求明确引用某个业务字段，必须从当前租户的实时字段接口/字段选择器获取完整字段对象并保存真实 `id`，不能凭字段名、临时 ID 或只拼 `id/content`。查询节点还必须使用自身真实节点 ID 作为 `dataSource.enquiryId`，否则平台可能静默丢弃业务字段。正式回读必须确认每个声明的 `queryFields` 仍存在；缺失即生成失败，不能仅凭接口 `code=200`、`saved=true` 判定成功。e-builder 数据触发后发送消息且未显式给链接时，CLI 自动补 PC/移动端当前记录详情链接；不手写 `{formId}` / `{dataId}` 的 FormulaBean。查询结果字段动态赋值必须按手工设计器对象编译：普通业务字段使用 `FormField.<查询表单ID>.field_<真实字段ID>`，`config.paramKey` 使用 `<查询表单ID>.field_<真实字段ID>`，`config.fieldInfo.tablePrimaryKey` 为 `FormField`；系统字段按平台真实字段键（例如 `id`）保留。禁止使用 `FormData.<表单ID>[临时位置]...`，也禁止把临时公式 ID 当作 `frontId`。
+8. `ActionEbAdd` 批量新增以 `basisValue` 为明细行上下文：来源于该行的字段都用 `mapping`，编译为“依据值下级”（`switchType:"sub"`），下拉字段也同样处理。只有已核实来源/目标选项 ID 不同且语义需要转换时，才使用 `SWITCH`。关联 e-builder 字段应引用查询结果的 `数据ID`，固定格式为 `{target,kind:"query_result",source:"<EnquiryForm ref>",formId,fieldId:"id",index:0}`；`kind:"enquiry"`、`sourceId` 等旧写法会直接报错，绝不降级为空固定值。
+9. 动态赋值可使用或新建动作流变量、租户常量：已有资源必须用真实 ID；计划新建变量写顶层 `variables[]`，新建常量写 `constantDefinitions[]`，常量分组可传 `groupPk` 或 `groupName`。变量按当前 `applicationId + sceneId` 隔离，常量按分组跨动作流复用。生成时先调用真实接口创建/解析资源，再编译为变量 `type:"7"` 或常量 `type:"5"` FormulaBean；详细格式见 `references/dynamic_resources.md`。消息 `parts` 也支持 `variable`/`constant` 动态片段。
+9.1. 每个参数先分为“动态公式属性”“动态人员属性”“固定平台资源属性”三类：上下文、系统变量、变量、常量、函数/公式必须保留为 FormulaBean；动态人员必须使用真实人员字段上下文或系统变量，不得把引用里的 `id` 当人员 Browser ID 查询；工作流、文档目录、按钮、规则等平台资源只有在其组件契约明确提供动态引用时才允许动态化。生成前必须记录本次组件/属性的判定，生成后按属性检查回读结果；具体映射和验证状态见 `references/dynamic_capability_matrix.md`。
+10. 自定义事件和内置 MQ 的参数必须按对应平台组件说明提供原生参数对象；`CustomTrigger.customData`、`InnerMQListener.receiveParams`、`InnerMQSend.sendParams` 不能用猜测的字段替代。若验证要求“输入参数里有字段”，必须在生成前提供至少一行真实原生参数；`tables:[]`、`tableList:[]` 或省略 `receiveParams` 只能表示无输入参数，不能作为有参数的占位。`InnerMQListener` 与 `InnerMQSend` 是动作流级互斥组件，同一计划（包括条件/循环嵌套）同时出现时，CLI 在任何平台写接口前直接报错。
+11. 根触发节点的 `event.attr.icon` 必须使用平台真实图标：`CustomTrigger` 为 `Icon-N-Triggerrul`，`InnerMQListener` 为 `Icon-built-in-mq-listening-mcolor`；组件目录里的动作图标不能覆盖根触发器图标。保存后回读必须同时检查触发器图标、已声明输入参数的数量和查询字段，不能仅凭 `valid=true` / `saved=true` 判定配置正确。
+12. `InnerMQSend.sendParams.tableData` 必须遵循“参数类型决定数据类型候选”的平台规则：普通非数组标量通常只有“属性”一个选项，不应伪造可下拉状态；数组或 `json/xml/xml_string` 结构化参数才按真实候选设置 `dataType`，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
 
 ### 4. 生成与逐场景反馈
 
@@ -61,7 +64,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 
 ### 4.1 修改已有动作流
 
-已有动作流必须走独立的 `update` 命令，不得把已有 `appId` 塞进 `generate`，也不得按名称猜测目标：
+已有动作流必须走独立的 `update` 命令，不得把已有 `appId` 塞进 `generate`，也不得按名称猜测目标。只有在没有精确 ID 时，先用 `application-list` 查询动作流应用（不是 `form-applications` 的业务应用列表），按名称和所属业务应用核对；结果必须唯一，查不到或有歧义就请求精确 `appId`，不能自行挑一个：
 
 ```bash
 e10-cli actionflow update '@update-plan.json' --out update-result.json
@@ -76,15 +79,16 @@ e10-cli actionflow update '@update-plan.json' --out update-result.json
     {"op":"edit-node", "nodeId":"原节点 ID", "patch":{"data":{"...":"..."}}},
     {"op":"delete-node", "nodeId":"要删除的原节点 ID"},
     {"op":"add-node", "parentPath":"/actions", "index":1, "node":{"type":"平台节点类型","data":{}}},
+    {"op":"add-condition-branch", "conditionNodeId":"已有分支节点 ID", "branchName":"新增分支", "conditionDetail":{"conditionDataJson":"平台条件树 JSON"}, "branchActions":[]},
     {"op":"replace", "path":"/actions/0/data/...", "value":"新值"},
     {"op":"remove", "path":"/actions/0/data/..."}
   ]
 }
 ```
 
-操作必须显式声明；`edit-node` 深合并 `patch`，原节点 `id/wId` 不允许修改；`delete-node` 会从设计树移除节点并填充 `deleteActions`；`add-node` 使用 `read-design --out` 得到的平台原生节点结构，可用 `index` 插入指定位置，自动补雪花 ID 并填充 `addIds`。新增执行节点必须插在终止节点之前，且同步修改终止节点的 `sources`。回读对象中的平台展示字段会先转换为 `saveDesign` 接受的写入 DTO（例如 EventButton 的 `eventButtonId` 和按钮对象），不能把回读 JSON 原样作为接口体。更新计划中的节点 ID 必须来自本次正式 `read-design`，不能复用更早版本的 ID。保存新版时平台可能为动作/出口重新分配内部 ID；回读校验优先按 ID，ID 变化时按动作树路径和类型匹配，不能因版本复制产生新 ID 就误判失败。`sources[].id` 由平台保存时动态分配/回读时可能省略，必须通过稳定的 `sources[].wId` 校验。未操作的节点和属性从正式回读原样作为保存基线，不会被新建编译器重建；新建动作流的 `assistLayer` 只写平台空骨架 `{"nodes":[],"layout":{}}`，更新已有动作流保留原生 X6 画布节点，不得伪造扁平 `{id,type,layout}` 节点，也不能把旧版本悬空节点带入新版。更新前自动备份完整正式设计到 `.actionflow-plans/backups/`；也可以传 `backupFile` 指定路径。
+操作必须显式声明；`edit-node` 深合并 `patch`，原节点 `id/wId` 不允许修改；`delete-node` 会从设计树移除节点并填充 `deleteActions`；`add-node` 使用 `read-design --out` 得到的平台原生节点结构，可用 `index` 插入指定位置，自动补雪花 ID 并填充 `addIds`。`add-condition-branch` 专门新增 `otherConditionBranch`，必须提供已有 Condition 节点 ID 和包含 `conditionDataJson` 的完整条件详情；CLI 会先调用条件服务保存规则，使用返回的真实 `conditionId/mapId/conditionKey`，再保存动作流，不能手工伪造条件 ID。分支内动作可通过 `branchActions` 提供，缺少节点 ID 时 CLI 自动补 ID 并从当前租户组件目录补齐节点壳。新增执行节点必须插在终止节点之前，且同步修改终止节点的 `sources`。回读对象中的平台展示字段会先转换为 `saveDesign` 接受的写入 DTO（例如 EventButton 的 `eventButtonId` 和按钮对象），不能把回读 JSON 原样作为接口体。更新计划中的节点 ID 必须来自本次正式 `read-design`，不能复用更早版本的 ID。保存新版时平台可能为动作/出口重新分配内部 ID；回读校验优先按 ID，ID 变化时按动作树路径和类型匹配，不能因版本复制产生新 ID 就误判失败。`sources[].id` 由平台保存时动态分配/回读时可能省略，必须通过稳定的 `sources[].wId` 校验。未操作的节点和属性从正式回读原样作为保存基线，不会被新建编译器重建；新建动作流的 `assistLayer` 只写平台空骨架 `{"nodes":[],"layout":{}}`，更新已有动作流保留原生 X6 画布节点，不得伪造扁平 `{id,type,layout}` 节点，也不能把旧版本悬空节点带入新版。更新前自动备份完整正式设计到 `.actionflow-plans/backups/`；也可以传 `backupFile` 指定路径。
 
-更新默认根据目标动作流当前状态决定 `saveAndStart`，保持启用/未启用状态；只有计划显式传 `saveAndStart` 才改变它。触发器 `event` 必须原样保留，禁止通过 `replace/remove` 修改 `/event` 或其子路径；如果要改变触发类型、触发表单、触发时机或触发器参数，必须新建动作流。正式更新固定带 `saveNewVersion:true`，保存为原动作流的新版本。保存响应未返回新版 ID 时，CLI 必须重新查询版本列表定位版本号更大的新场景，再对新版正式回读；定位不到新版时不能拿旧版冒充校验通过。保存后必须正式回读并检查编辑、新增、删除及未修改节点是否仍在；接口失败或回读失败只返回原因和备份位置，不自动回滚、覆盖或删除目标动作流。
+更新默认根据目标动作流当前状态决定 `saveAndStart`，保持启用/未启用状态；只有计划显式传 `saveAndStart` 才改变它。触发器 `event` 必须原样保留，禁止通过 `replace/remove` 修改 `/event` 或其子路径；如果要改变触发类型、触发表单、触发时机或触发器参数，必须新建动作流。正式更新固定带 `saveNewVersion:true`，保存为原动作流的新版本。保存后无论目标原本启用还是禁用，CLI 都必须调用设计器真实的 `setActiveVersion/{appId}/{newSceneId}`，再读版本列表确认 `activeVersion` 是新版本；`saveAndStart` 只控制动作流启用状态，不控制活动版本。保存响应未返回新版 ID 时，CLI 必须重新查询版本列表定位版本号更大的新场景，再对新版正式回读；定位不到新版时不能拿旧版冒充校验通过。一次 update 最多执行一次正式保存：如果已保存但激活失败、活动版本回读不一致或正式回读失败，结果必须保留 `saved/sceneId/backupFile` 证据并停止，不能自动重跑、再次新建版本、回滚或删除；需要重试时由用户确认并基于新结果重新规划。保存后必须正式回读并检查编辑、新增、删除及未修改节点是否仍在。
 
 ### 5. 回读与异常分流
 
@@ -107,10 +111,14 @@ e10-cli actionflow component-list
 e10-cli actionflow component-describe <type>
 e10-cli actionflow generate '{"planFile":"@<绝对路径>","appName":"AI-名称"}' --out generate-result.json  # 默认保存并启用
 e10-cli actionflow generate '{"planFile":"@...","mode":"stash"}'                   # 显式暂存（不启用）
-e10-cli actionflow update '@update-plan.json' --out update-result.json       # 读取后按原 ID 保留式修改
+e10-cli actionflow application-list '{"name":"动作流名称"}'              # 先发现动作流应用，再用唯一结果的精确 appId
+e10-cli actionflow activate-version '{"appId":"动作流ID","sceneId":"版本场景ID"}' # 只切换默认打开版本，不改变启用状态
+e10-cli actionflow enable '{"appId":"动作流ID"}'                         # 单独启用，不修改设计、不创建版本
+e10-cli actionflow disable '{"appId":"动作流ID"}'                        # 单独禁用，不修改设计、不创建版本
+e10-cli actionflow update '@update-plan.json' --out update-result.json       # 读取后按原 ID 保留式修改；一次保存，失败停止
 ```
 
-常用发现命令：`form-applications`、`form-list`、`form-fields`、`workflow-browser-list`、`workflow-search`、`workflow-nodes`、`workflow-context-fields`、`recipient-search`、`document-statuses`、`hrm-onboarding-fields`、`variable-list`、`variable-create`、`constant-list`、`constant-group-list`、`constant-group-create`、`constant-create`、`http-connectors`、`http-resources`、`http-interfaces`、`http-interface-detail`、`design-versions`、`read-stash`。变量/常量计划定义和引用见 `references/dynamic_resources.md`。
+常用发现命令：`form-applications`、`form-list`、`form-fields`、`workflow-browser-list`、`workflow-search`、`workflow-nodes`、`workflow-context-fields`、`recipient-search`、`document-statuses`、`hrm-onboarding-fields`、`variable-list`、`variable-create`、`constant-list`、`constant-group-list`、`constant-group-create`、`constant-create`、`http-connectors`、`http-resources`、`http-interfaces`、`http-interface-detail`、`application-list`、`design-versions`、`read-stash`。变量/常量计划定义和引用见 `references/dynamic_resources.md`。
 
 ## 触发器边界
 

package/skill-docs/actionflows/references/components/calendar/MeetingCreate.md

@@ -1,17 +1,17 @@
-# 创建会议（`MeetingCreate`）
-
-## 何时使用
-
-创建会议并设置会议字段。
-
-## 先查询
-
-查询创建人、召集人、联系人及会议相关选择器对象。
-
-## 不可猜测
-
-人员、会议室、类型、附件等资源必须为真实对象；当前字段赋值按已验证固定值处理。
-
-## 最小计划
-
-`operators`、`meetingType`，以及需求涉及的会议字段。
+# 创建会议（`MeetingCreate`）
+
+## 何时使用
+
+创建会议并设置会议字段。
+
+## 先查询
+
+固定人员或资源值要查询创建人、召集人、联系人及会议相关选择器对象；动态人员可直接使用上下文、系统变量、变量、常量或函数。
+
+## 不可猜测
+
+会议标题、密级等普通字段支持固定值和动态赋值；创建人、召集人、联系人支持固定人员对象和动态人员公式。会议类型、会议室、附件、关联流程等设计期资源仍必须使用当前租户真实选择器对象，不能把上下文强行当作资源 ID。
+
+## 最小计划
+
+`operators`、`meetingType`，以及需求涉及的会议字段。

package/skill-docs/actionflows/references/components/calendar/ScheduleCreate.md

@@ -1,17 +1,17 @@
-# 创建日程（`ScheduleCreate`）
-
-## 何时使用
-
-创建日程、参与人、共享人和地点。
-
-## 先查询
-
-查询创建人、参与人、负责人、会议室和日程类型。
-
-## 不可猜测
-
-人员和资源必须为真实 Browser 对象；标题、时间、内容目前只传已验证固定值。
-
-## 最小计划
-
-`creatorUser`、`title`、`startTime`、`endTime`。
+# 创建日程（`ScheduleCreate`）
+
+## 何时使用
+
+创建日程、参与人、共享人和地点。
+
+## 先查询
+
+固定人员或资源值要查询创建人、参与人、负责人、会议室和日程类型；动态人员可直接使用上下文、系统变量、变量、常量或函数。
+
+## 不可猜测
+
+标题、开始时间、结束时间、内容、其他地点支持固定值和动态赋值；创建人、参与人、负责人、共享人支持固定人员对象和动态人员公式。日程类型、会议室仍是设计期资源，必须使用当前租户真实 Browser 对象。
+
+## 最小计划
+
+`creatorUser`、`title`、`startTime`、`endTime`。

package/skill-docs/actionflows/references/components/database/DMLExecute.md

@@ -8,7 +8,7 @@
 - `sqlContentDw` 必填，必须包含 `dataset.sqlQuery.sql` 和 `dataSetConn.id`。
 - `dataSetConn.id` 应先通过 `e10-cli actionflow datasource-list` 查询当前环境的真实数据源连接；不要用其他环境的 ID。
 - SQL 使用明文，参数占位符写成 `[${参数名}]` 或 `[ ${参数名} ]`。
-- 每个占位符必须在 `fieldSet` 中有同名 `assignName`，`assign` 必须是平台原生 FormulaBean 数组。
+- 每个占位符必须在 `fieldSet` 中有同名 `assignName`。`assign` 可直接使用统一动态赋值（固定值、上下文、系统变量、变量、常量、查询结果、函数/公式），也兼容平台原生 FormulaBean 数组。
 - SQL 为空、占位符与 `fieldSet` 不匹配、结果集结构非法时，CLI 会在保存前拒绝生成。
 
 ## 最小计划
@@ -26,8 +26,8 @@
       }
     },
     "fieldSet": [
-      { "assignName": "id", "assign": ["<平台原生 FormulaBean>"] },
-      { "assignName": "name", "assign": ["<平台原生 FormulaBean>"] }
+      { "assignName": "id", "assign": { "kind": "context", "paramKey": "<真实字段paramKey>", "label": "数据ID" } },
+      { "assignName": "name", "assign": { "kind": "variable", "id": "<真实变量ID>", "name": "名称变量" } }
     ]
   }
 }

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

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

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/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`，不会重建参数定义。
 
 ### 参数类型与数据类型联动