weaver-e10-builder 1.5.7 → 1.5.10

package/skill-docs/_catalog.md

@@ -22,7 +22,10 @@
 | 布局样式模板、换配色、form layout init | `references/form/style-templates.md`（流式/表格式两套，同名不同 id） |
 | 已有表单加字段、改必填/只读、布局被重建、add-field --reinit、别动别人的表、布局组件、associatedId、字段标题取不到 | `references/form/guide-form-layout-incremental.md` |
 | 表单复杂编号、serial-mark、流水号、代字 | `references/form/guide-form-serial-mark.md` |
+| 分类搜索、分类筛选、list-search-group、选项配置、日期粒度、选项排序 | `references/common/ref-cli-commands.md` |
+| 表单消息提醒、数据变动提醒、form message、提醒对象、推送渠道、IM提醒 | `references/form/guide-form-message.md` |
 | 表单数据读写、form data、写入数据、查询数据、删除数据 | `references/form/guide-form-data.md` |
+| 流程归档权限、归档查看/编辑/删除、归档附件权限、form permission archive、创建人相关、字段相关、矩阵相关、归档卡片 | `references/form/guide-form-archive-permission.md` |
 | 列表自定义文本列、富文本列、列里插入字段、form nlist、列表式视图 | `references/form/guide-list-custom-text.md` |
 | 流程、审批、workflow、提交流程、flowpage、预填、URL传参、节点、操作者、审批人、连线 | `references/workflow/guide-workflow.md` |
 | 流程绑的表、流程关联表单、workflow info、workflowId 查表单、formId 不是 objId | `references/common/ref-cli-commands.md`（`workflow info` 一行） |
@@ -50,9 +53,10 @@
 | 用户意图关键词 | 加载文档 |
 |---------------|---------|
 | CLI、命令、打包、build、import、创建应用、创建表单、菜单、project、form create、app create、matrix | `references/common/ref-cli-commands.md` |
+| 应用发布、启用应用、停用应用、发布到前台、取消发布、应用发布信息、前台入口、应用名多语言、app enable/disable/publish/unpublish/publish-info、app lang | `references/app/guide-app-publish.md` |
 | 完整实施方案、规划能力地图、资源依赖、需求映射、plan 前预检 | `references/common/map.md`，随后使用 `references/common/guide-plan-template.md` |
 | 接口文档导入、Postman、系统接口、连接器接口、createSystemInterfaceByAi、接口批量创建 | `references/esb-interface/guide-import.md` |
-| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单 | `references/menu/system-menus.md` |
+| 系统菜单、内置菜单、挂系统页面到菜单、menuUrl、pageType、工作流菜单、独立页面菜单、菜单改名、menu rename、重命名菜单、找不到菜单、二级菜单、子菜单、父菜单、菜单层级、menu add-table --parent、menu add-start --parent | `references/menu/system-menus.md` + `references/common/ref-cli-commands.md` |
 | 编译、语法、报错、不支持、babel、打包、var、const、let、es2015、stage-2 | `references/coding/ref-compile-rules.md`（前端代码） |
 
 ## Components（组件文档）

package/skill-docs/actionflows/SKILL.md

@@ -49,6 +49,7 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 2. 只传 `component-describe` 声明的参数；固定值与动态值根据业务需求选择，不能为了动态而动态。
 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` 后才允许手工清理。
+4.1. 命名遵循“展示中文、机器字段 code 化”：动作流名称、节点显示名称、参数 `showName`/`label`、说明文字等面向用户的展示字段可以使用中文；`paramName`、`paramKey`、变量/常量引用名、请求编码、Topic/队列名、字段路径、公式引用键以及其他机器可读标识默认使用英文字母、数字和下划线，优先 lowerCamelCase 或 snake_case，不使用中文、空格或特殊字符。`type`、`kind`、`paramType`、枚举值等必须沿用组件契约中的 code；已从平台真实对象取得的 ID、名称、原生 DTO 字段和固定资源值不得擅自改写，只对 AI 新建的语义标识执行该规则。
 5. 不把 `Output` 写入 `actions`。需要配置终止状态、提示或页面动作时使用顶层 `finalOutput.params`；提醒内容使用前端富文本组件对应的 `reminderContent`（`ContestSettingDTO`，动态片段放在 `formulaBeans`），不要使用旧的 `reminderMsgFormula`。流程触发（`ApproveTrigger`）只支持提醒，不支持页面交互、页面动作或跳转地址；页面动作仅可用于 `EventButton`。平台内部 FormulaBean 由 CLI 生成，只有组件契约明确要求前端原对象时才传原生 DTO。
 5.1. 所有 CLI 生成或继续编译的 FormulaBean，只要包含 `frontId`，允许使用空串；非空时必须使用平台真实字段 ID 的纯数字字符串。`field_<数字>` 仅可在生成时规范化为 `<数字>`。禁止把字段名、paramKey 尾段、临时公式 ID 或其他包含字母/符号的值写入 `frontId`；非空值无法解析为纯数字时必须直接报错。
 6. 定时组件优先使用平台原生频率：`rate=1` 一次、`2` 按小时、`3` 按日、`4` 按周、`5` 按月，并按需提供 `cycle`、`hour`、`day`、`week`、`atWeek`、`atWeekDetail` 或 `lastWeek`；只有明确选择 `rate=6` 时才传 `cornString`。图形化频率必须提供 `startTime`。
@@ -58,7 +59,8 @@ description: "将业务需求编译为 Weaver ESB 动作流，或读取已有动
 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`。
+12. 仅在生成 `ParamMappingBean`、`ParamSettingBean`（及其同形态的参数分组 DTO）的 `tableData[].paramType` 时，按后端 `com.weaver.esb.base.enums.ParamType` 归一化：无法匹配枚举值回退为文本 `string`；数字类型统一为整数 `int`；长整型统一为文本 `string`。这条规则不适用于普通 `FormulaBean`、表单字段上下文、循环上下文或 `CustSetFormDto`。`paramType=json` 或 `arrs=true` 时 `dataType` 强制为节点 `node`，不能保留/生成属性 `attribute`；其他普通标量默认使用属性，结构化参数的下级用 `parentId` 表达，并保留父子约束。具体规则见 `references/components/message/InnerMQSend.md`。
+12.1. 所有组件的动态字段最终都必须生成合法的 `FormulaBean`，统一按以下五类来源处理：①普通组件上下文只能使用该组件 `getComponentContext` 返回的字段元数据；②循环体字段使用前端循环上下文拼出的 `CycleParams`，并保留循环数据源的真实来源；③`EsbFormDataDto` 的依据值下级按表单设置组件的 `basisValue`、`parentName`、`paramName` 和数组层级规则生成；④`ParamMappingBean`/`ParamSettingBean` 的依据值下级按参数设置组件的相对 `paramKey` 和 `basisParamKey` 规则生成；⑤`CustSetFormDto` 的依据值下级沿用表单设置组件规则。不能按字段名、paramKey 尾段、组件默认根或临时 ID 凭空补造 `frontId`、`parentName`、`paramKey`、`newParentName`；缺少真实上下文时应在预检阶段报错。
 
 ### 4. 生成与逐场景反馈
 

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

@@ -10,7 +10,7 @@
 
 ## 不可猜测
 
-不要把 `Output` 写入 `actions`。提醒内容必须使用前端富文本组件对应的 `ContestSettingDTO`，字段名是 `reminderContent`，不能再使用旧的 `reminderMsgFormula`。流程触发（`ApproveTrigger`）只支持提醒配置，不支持页面交互、页面动作或跳转地址；页面动作仅可用于 `EventButton`。`basisValue` 仍支持固定值、上下文、系统变量、变量、常量、查询结果和函数/公式；`jumpUrl` 在前端只允许固定文本。`fixedData`、`customOutputData` 属于平台原生高级输出结构，必须使用真实回读结构，不能猜测。
+不要把 `Output` 写入 `actions`。提醒内容必须使用前端富文本组件对应的 `ContestSettingDTO`，字段名是 `reminderContent`，不能再使用旧的 `reminderMsgFormula`。流程触发（`ApproveTrigger`）只支持提醒配置，不支持页面交互、页面动作或跳转地址；页面动作仅可用于 `EventButton`。`basisValue` 与 `jumpUrl` 支持固定值、上下文、系统变量、变量、常量、查询结果和函数/公式；其中 `jumpUrl` 仅在 `pageAction=3` 时生效。`fixedData`、`customOutputData` 属于平台原生高级输出结构，必须使用真实回读结构，不能猜测。
 
 `reminderContent` 支持两种输入：一是前端原生对象 `{id, content, formulaBeans, langSet}`；二是 CLI 语义模板 `{parts:[{type:"text",value:"..."},{type:"context",paramKey:"..."},{type:"system_variable",key:"{date}"},{type:"variable",id:"..."},{type:"constant",id:"..."}]}`。编译器会生成 Base64 内容和 `#{paramN}` 占位符，并将每个动态片段保存为 `formulaBeans[].value`。
 

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

@@ -32,6 +32,8 @@
 
 ### 参数类型与数据类型联动
 
+CLI 生成 `ParamMappingBean`、`ParamSettingBean` 及其分组 DTO 的 `tableData` 时才归一化参数类型：依据后端 `ParamType` 枚举匹配；数字类型统一写 `int`，长整型写 `string`，无法匹配写 `string`。普通 `FormulaBean`、表单字段上下文、循环上下文和 `CustSetFormDto` 不使用这套归一化。如果 `paramType` 为 `json` 或字段开启 `arrs`，`dataType` 强制写为 `node`；普通非数组标量默认写为 `attribute`。
+
 `tableData` 中每一行的 `paramType` 决定 `dataType` 的合法候选和是否允许继续加下级，不能只把 `dataType` 当成一个任意字符串填写：
 
 - 普通标量（如 `string`、`int`、`boolean` 等）且 `arrs:false` 时，合法数据类型只有“属性”；平台因此不会显示数据类型下拉，这是正常行为。
@@ -41,4 +43,8 @@
 
 因此，需求只要求一个数据类型时不要伪造下拉；需求需要多种数据类型或下级节点时，必须按真实参数类型构造 `tableData` 层级。
 
+### FormulaBean 动态来源的统一规则
+
+上述参数类型规则只作用于参数 DTO；所有组件的动态字段生成 `FormulaBean` 时，还必须统一遵循五类来源：普通组件上下文取对应 `getComponentContext` 的真实字段；循环体取前端拼出的 `CycleParams` 并保留列表来源；`EsbFormDataDto`、`ParamMappingBean`/`ParamSettingBean`、`CustSetFormDto` 的依据值下级分别使用各自前端的 basisValue/相对 paramKey/parentName 规则。真实字段的 `frontId`、`paramKey`、`parentName`、`newParentName` 不可由字段名或路径尾段猜测，预检无法取得时直接失败。
+
 `InnerMQSend` 与触发器 `InnerMQListener` 不能同时出现在一个动作流中，包括条件和循环内部；CLI 会在创建或更新前拒绝该计划。

package/skill-docs/actionflows/references/dynamic_capability_matrix.md

@@ -15,9 +15,9 @@
 | 消息模板 | `SendMessage.msgTitlev/msgContentv/picLink/msgPcLink/msgMobileLink` | 上下文、系统变量、变量、常量、函数/公式、查询结果 | 五个消息文本/链接字段统一保存为 `ContestSettingDTO`；正文占位符与独立绑定；接收人上下文仍保留为动态人员 FormulaBean |
 | 消息接收人 | `SendMessage.receiver` | 当前用户、上游人员上下文、固定人员 | 动态人员使用真实上下文 `paramKey`，固定人员使用当前租户 Browser 对象 |
 | 人员参数 | 表单数据动作、流程动作、文档动作、`HrmEmployeeUpdate`、`PersonnelOnboarding`、`AlterPersonStatus`、会议/日程中的人员属性 | 当前用户、上游人员上下文、动作流变量/常量/函数 | 不再强制走固定人员查询；动态引用保持人员 FormulaBean，固定人员仍要求真实 Browser 对象 |
-| 会议和日程运行时字段 | `MeetingCreate` 的标题/密级/人员，`ScheduleCreate` 的标题/时间/内容/其他地点/人员 | 上下文、系统变量、变量、常量、函数/公式 | 普通字段生成对应 FormulaBean；人员使用人员 FormulaBean；会议室、日程类型、关联流程等设计期资源仍保持 Browser 对象 |
+| 会议和日程运行时字段 | `MeetingCreate` 的标题/密级/人员/关联标识，`ScheduleCreate` 的标题/时间/内容/其他地点/人员/日程类型/会议室 | 上下文、系统变量、变量、常量、函数/公式 | 后端 DTO 中的 FormulaBean 字段统一支持动态赋值；固定会议/日程资源仍保留 Browser 对象兼容 |
 | 流程和文档运行时字段 | 流程实例 ID、标题、意见、公文正文 ID、关联数据 ID、时间、文档/附件 ID、布尔开关等 `formula_or_reference` 属性 | 固定值、上下文、系统变量、变量、常量、查询结果、函数/公式 | 统一经共享公式编译器生成 FormulaBean；固定流程定义、节点、目录 DTO 不在此列 |
-| 循环参数 | `MultipleExecution.cycleTimes`、列表/明细来源 | 上下文、变量、常量、当前循环上下文 | 按循环模式生成对应 `CycleParams`/FormulaBean |
+| 循环参数 | `MultipleExecution.cycleTimes`、`batchSizeData`、`pageCycleData`、列表/明细来源 | 上下文、变量、常量、当前循环上下文 | 后端 FormulaBean 字段统一支持动态赋值；固定批量大小继续校验 2-1000，分页标志继续校验布尔类型 |
 | 条件右值 | `Condition` | 固定值、上下文、系统变量、变量、常量、函数 | 右值保留为公式树，不把动态字段名转成固定字符串 |
 | 终止节点动态输出 | `finalOutput.params.reminderContent`、`basisValue` | 富文本 `ContestSettingDTO`；提醒内容支持文本、上下文、系统变量、变量、常量、查询结果、函数/公式 | 自动补充的 `Output` 节点保留高级设置，无需在 `actions` 中手写终止节点；旧 `reminderMsgFormula` 不再用于新生成 |
 
@@ -27,7 +27,7 @@
 
 - 流程定义/流程节点/退回节点/干预节点：通常需要当前租户真实流程 Browser 对象或节点对象；只有 `requestId`、标题、意见等字段类属性按组件契约支持动态。
 - 文档、目录、附件、共享权限、按钮、规则：固定对象需要当前租户真实 Browser/权限对象；如果组件说明或回读结构提供动态公式入口，必须单独实现该属性的编译器和回读校验。
-- 会议、日程、HRM 选择器的结构化对象：人员属性与会议/日程资源属性分开判断。`MeetingCreate.flag`、日程类型、会议室和 `Output.jumpUrl` 均只接受前端允许的固定选择/固定文本，不能因为底层存储字段是 FormulaBean 就推导其支持动态。
+- 会议、日程、HRM 选择器的结构化对象：固定值仍以各自前端 Browser 契约为准；只要后端字段声明为 `FormulaBean`，同时支持动态引用。`Output.jumpUrl` 的后端 DTO 是 `FormulaBean`，支持固定值和动态引用，且仅在 `pageAction=3` 时生效。
 - 触发器配置、接口定义、连接器/资源/接口选择：这些是设计期平台资源，默认必须实时发现真实对象，不能把运行时上下文当成连接器或接口定义。
 
 ## 处理规则

package/skill-docs/references/app/guide-app-publish.md

@@ -0,0 +1,92 @@
+# 应用发布：启用 → 发布到前台 → 改发布信息 → 取消发布
+
+应用建出来只是「壳」。要让成员真正在前台用上，还要走**启用**和**发布到前台**两步；
+应用名还可以按语言给不同显示。
+
+## 一、四个动作与先后关系
+
+| 命令 | 作用 | 前置 |
+|---|---|---|
+| `app enable <appId>` | 启用应用 | — |
+| `app publish <appId>` | 发布到前台（应用中心里出现入口） | 先 `enable` |
+| `app publish-info <appId>` | 改前台的显示名 / 简介 / 分类 | 先 `publish` |
+| `app unpublish <appId>` | 取消发布（收回前台入口） | 先 `publish` |
+
+`app read <appId>` 里的 `publishEnabled`：`1` 已启用、`2` 已停用、`0` 从未启用。
+
+> ⚠️ **停用会连带收回已发布状态。** 前台那句「应用暂未启用，启用后才可以发布给成员使用」
+> 说的就是这个 —— 别把 `app disable` 当成「临时关一下、发布态还在」。
+
+## 二、发布
+
+```bash
+e10-cli app enable <appId>
+e10-cli app publish <appId> --name "会议室管理" --description "预约与审批" --category 综合办公
+```
+
+- `--name` 不给就用应用名；`--description` 不给就用应用描述。
+- `--category` 是**应用中心里的分类**：汇报 / 协作 / HRM / 审批 / 数据协作 / 综合办公 / CRM / 自定义。
+  不指定则落**自定义**。
+- 发布后前台入口的地址形如 `/ebdapp/view/<appId>`。
+
+> ⚠️ **每次发布都会生成一个新的前台 id**，取消后重新发布**不会**沿用旧号。
+> 别把这个 id 当稳定标识存下来，要用的时候现查（`app publish-info` 会报出来）。
+
+## 三、改发布信息
+
+`app publish-info` 改的是**前台那份配置**（显示名 / 简介 / 分类），
+**不动应用本身的名称与描述** —— 后者用 `app edit`。
+
+```bash
+e10-cli app publish-info <appId> --name "新的前台名"
+e10-cli app publish-info <appId> --description "改后的简介"
+e10-cli app publish-info <appId> --category CRM
+```
+
+三个参数至少给一个；不给分类就**沿用现有的**，不会被打回「自定义」。
+
+## 四、取消发布
+
+```bash
+e10-cli app unpublish <appId>
+```
+
+> ⚠️ **不可逆**，也没有回收站。移除后前台入口消失，成员看不到；
+> 重新发布会是一个**新入口**。命令会回读确认入口确实没了才报成功，
+> 重复执行只会提示「未发布到前台，无需取消」。
+
+## 五、应用名多语言
+
+应用名可以按语言给不同显示。
+
+```bash
+e10-cli app lang get <appId>              # 看各语言当前值
+e10-cli app lang set <appId> --en "Meeting Room"
+e10-cli app lang set <appId> --zh "会议室管理" --en "Meeting Room"
+```
+
+- **简体中文那档就是应用名本身。** 只给 `--en` 时，命令会先把现有各语言读回来再整份写回，
+  **不会**出现「只改英文、中文被清空」。
+- 简体中文缺省沿用应用当前名称，可以用 `--zh` 显式覆盖。
+- 已经建过多语言标签时是**原地更新**，不会堆积一堆标签。
+- 单独改应用名（`app edit --name`）**不动**多语言配置，两者互不干扰。
+
+## 六、命令一览
+
+| 命令 | 说明 |
+|---|---|
+| `e10-cli app enable <appId>` | 启用应用 |
+| `e10-cli app disable <appId>` | 停用应用（**会收回已发布状态**） |
+| `e10-cli app publish <appId> [--name] [--description] [--category]` | 发布到前台 |
+| `e10-cli app publish-info <appId> [--name] [--description] [--category]` | 改发布信息 |
+| `e10-cli app unpublish <appId>` | 取消发布 |
+| `e10-cli app lang get <appId>` | 查看应用名多语言 |
+| `e10-cli app lang set <appId> [--zh] [--en]` | 设置应用名多语言 |
+
+以上命令都支持全局 `--json`。
+
+## 关联
+
+- 应用本身的增删改查（`create` / `list` / `folder` / `read` / `edit` / `delete`）：
+  [`ref-cli-commands.md`](../common/ref-cli-commands.md) 的 app 段
+- 前台入口的可见范围（谁能看到这个应用）：`menu` / `menu-permission` 那套