@microi.net/cli 5.8.5 → 5.8.7

package/skills/module-engine/SKILL.md

@@ -1,255 +1,255 @@
----
-name: module-engine
-description: Microi 模块引擎与 sys_menu 配置指南。用于创建或修改后台菜单、菜单统计角标、模块标题指标、复合列表列、移动端业务卡片、查询列、接口替换、跨端 ViewSchema、动态按钮、PageTabs、树形加表格布局和 MicroService 菜单。
----
-
-> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
-
-# Microi 模块引擎
-
-模块引擎决定同一张表在某个菜单、角色和终端中“如何查询、展示和操作”。
-配置实体是 `sys_menu`，不是 `sys_module`；表结构与字段仍属于
-`diy_table/diy_field`。
-
-导入、导出按钮显示条件分别使用 `sys_menu.ImportCodeShowV8`、`ExportCodeShowV8`，
-与新增、编辑、删除条件一样用 `V8.Result=true/false`。通过模块设计“按钮”分组维护，
-或使用 `microi_update_module`；旧后端需先升级模块引擎应用。它们只控制按钮显示，不能代替后端权限。
-代码字段是否显示按钮由各字段 `Config.CodeEditor.DisplayMode` 决定，禁止按 `sys_menu` 表名强制覆盖；
-未配置时默认 `Inline`，需要紧凑按钮的字段显式保存 `Dialog`。
-
-## 必读参考
-
-- 字段、打开方式、查询配置、ViewSchema 和接口替换：
-  `references/module-config.md`
-- 动态按钮 JSON 与后台任务：`../v8-menu-buttons/SKILL.md`
-- 树形+表格：`../microi-left-right-layout/SKILL.md`
-- 表单控件：`../microi-form-engine/SKILL.md`
-- 表单平铺、CollapseGroup 与 Tabs 决策：`../microi-form-layout/SKILL.md`
-- MicroService 菜单：`../microi-microservice/SKILL.md`
-
-## 创建/修改标准流程
-
-1. `microi_get_db_schema` 读取真实 `diy_table`、字段、已有菜单和父菜单。
-2. 绑定表的菜单使用 `microi_create_module`/Manifest，不直接写 `sys_menu`。
-3. 明确 `openType`、父菜单、路由、PC/移动端显隐和角色范围。
-4. 用字段名配置 `listFields/searchFields/sortFields/hiddenFields/mobileFields`；
-   MCP 解析为字段 Id 和 `SelectFields/SearchFieldIds/...`。
-5. 同一次创建配齐业务按钮、FormBtns、PageTabs 和批量按钮。
-6. 写后回读模块，检查字段映射、按钮 JSON、路由和目标页面。
-
-### 菜单图标必须可辨识（强制）
-
-- 每个新建或修改的菜单都必须设置与业务相关的图标；根目录、分类及子菜单不能批量使用同一个默认图标。优先按名称和实际功能选择，例如客户用 `UserFilled`、日程用 `Calendar`、仓储用 `Box`、办公用 `OfficeBuilding`。
-- 主后台侧栏读取 `sys_menu.IconClass`（CSS/组件图标），不是图片字段 `Icon`。优先填写当前前端已注册的 Element Plus 图标名；使用 FontAwesome/CSS 名称时先核对兼容映射，不能填入不存在的类名后让全部菜单回退为 `Document`。
-- 没有贴切图标时，从实际可用图标集合中随机选一个，并将选择结果保存；可以按稳定菜单 Id 生成确定的随机分配，避免每次刷新或重新发布都变图标。同组菜单应有适当差异，不强求不同业务绝对不重复。
-- 通过 `microi_create_module` / `microi_update_module` 或 Manifest 的模块配置写入，并把图标纳入应用包。只修改图片字段、只检查数据库字符串或只改本地 Manifest 不算完成；必须回读 `IconClass`，在真实侧栏检查图标可见且有区别。
-
-### 新模块表单打开方式（强制默认）
-
-- AI 新建 `diy_table` / 业务模块时，`FormOpenType` 默认写 `Dialog`，`FormOpenWidth`
-  默认写 `80%`；缺省值也必须按这组语义处理，不能再把所有模块统一生成为 Drawer。
-- 只有表单确实非常庞大时才使用 `Drawer`：通常是 36 个以上业务字段、至少 2 个
-  `TableChild`、28 个以上字段且含大型子表，或 7 个以上子表/富文本/代码编辑/上传/地图等
-  重型控件。达到阈值仍应先用 `diy_table.Tabs` 与 CollapseGroup 整理信息架构。
-- 用户显式指定 `Dialog/Drawer/Page` 或宽度时以用户配置为准。Drawer 是贴边直角容器；
-  Dialog 使用平台统一大圆角、可拖动、居中弹层，遮罩服从正向开关 `sys_config.FormMaskBlur`，缺失或 `0/false` 默认关闭毛玻璃。
-7. 为管理员/目标角色分配菜单权限，并以真实登录用户验收。
-
-## 绑定表菜单不能只写两个字段
-
-除 `Name` 和 `DiyTableId` 外，至少配置或允许平台推断：
-
-- `TableDiyFieldIds`
-- `SelectFields`
-- `SearchFieldIds`
-- `SortFieldIds`
-- `NotShowFields`
-- `StatisticsFields`
-- `MobileListFields`
-- `CardTitleTagFields`
-- `CardBottomTagFields`
-- `DefaultOrderBy`
-
-普通状态、开关等低基数字段不能机械创建单列索引。只有真实查询、关联、唯一约束
-或扫描需要的索引才进入 Manifest 并通过 MCP 创建、回读。
-
-Manifest 中按字段名声明统计列，使用 `statFields` 或 `statisticsFieldNames`，例如
-`statFields: ['Amount', 'Quantity']`；MCP 会解析目标租户的字段 Id。
-`statisticsFields` / `StatisticsFields` 表示已经转换好的原生 JSON，元素为
-`{ Id: '真实 diy_field.Id', Type: 'Sum' }`，不能填字段名称字符串。发布前用有记录的
-实际列表检查 `DataAppend.StatisticsFields` 及页面汇总，再以无权限账号检查汇总范围；
-HTTP 成功或菜单字段非空不足以证明统计有效。
-
-## AI 模块视觉交付门禁（强制）
-
-对每个 `Display=1` 或 `AppDisplay=1` 且绑定业务表的 Diy 模块，AI 不能只依赖 CRUD
-默认页，也不能只写 `Name/DiyTableId` 后结束。至少完成以下设计和回读：
-
-1. 每个列表字段都给出符合内容长度的 `TableWidth`；标题/名称/地址较宽，日期/编码居中，
-   金额/数量/状态较紧凑。PC 复合列必须另给合理的 `MinWidth`，不得让末列自适应覆盖它。
-2. 每个模块都配置紧凑 Hero 的业务标题、简短副标题和 2~4 个动态指标。优先统计待处理、
-   逾期、金额、容量、风险、完成率等当前表真正有意义的业务数据，不能全部退化为总记录数。
-3. 指标只能来自 `StatisticsFields`、当前列表 `DataCount/PageCount` 或一个批量聚合接口。
-   禁止随机数、伪统计、静态演示数字和没有口径的“看起来好看”数值。无法推断时允许用
-   `DataCount + PageCount` 做诚实最低兜底，并在后续由业务人员补充口径。
-4. 左侧菜单角标只给少量有行动含义的重要菜单，例如待办、未读、逾期、低库存；禁止每个
-   菜单都加。`PageTabs` 的状态数量、`MoreBtns/PageBtns/FormBtns/BatchSelectMoreBtns/
-   ExportMoreBtns` 的有用数量也应设计角标，但同页统计必须批量返回，禁止 N+1。
-5. PC 至少设计一个 `Field + Lines + TrailingFields` 复合主列。已放入次要行或右侧图标/
-   状态的字段必须从普通独立列去重；主字段、次要行、右侧字段及其 `RequiredFields` 都要
-   进入查询结果，宽度必须足以容纳多行和尾随标签。一般情况下每个复合列最多两行，即
-   一个主字段加一个 `Lines` 次要字段；可以配置多个各自两行的复合列，但不要在同一列放
-   两个 `Lines` 形成三行高表格。确有特殊层级价值时才允许三行，并必须完成桌面视觉验收。
-6. 移动端卡片按真实字段规划图片/头像、标题、副标题、顶部标签、状态、右侧金额、正文、
-   Meta、底部区域；同一字段不得在多个区域机械重复，空区域应隐藏而不是留下占位。
-7. `EnableViewSchema` 只控制 Detail/Edit 自定义表单。Hero、指标、列表密度、PC 复合列、
-   移动端卡片只要有配置就始终生效；设计器必须提供独立的“自定义表单”Tab。
-
-平台自动生成的 List/Card 配置只是防止空白界面的最低值，不能替代 AI 对业务状态、金额、
-时效和操作路径的分析。显式配置优先于自动值；写后用 `microi_get_module` 回读 ViewSchema、
-列宽、统计列、卡片区域和角标配置。
-
-## 打开方式
-
-| OpenType | 用途 |
-|---|---|
-| `Diy` | 标准表单引擎列表/表单 |
-| `Component` | 主前端已注册 Vue 组件 |
-| `Iframe` | 受控外部页面 |
-| `SecondMenu` | 仅作为父菜单 |
-| `Report` | 虚拟报表 |
-| `MicroService` | 已发布前端微服务页面 |
-| `CodeForm` | 表单设计器生成并在已发布微服务中运行的独立 Vue 3 页面；必须绑定 `DiyTableId` |
-| `WorkFlow` | 审批工作流模块；必须绑定 `DiyTableId` 和已启用流程的 `FlowDesignId` |
-
-`WorkFlow` 模块的 `DiyTableId` 必须等于 `wf_flowdesign.TableId`。完整 Manifest
-可填写 `flowName` 引用同一份 `workflows` 定义，生成器保存流程后回填
-`sys_menu.FlowDesignId`；引用已存在流程时填真实 `flowDesignId`。
-使用 `microi_get_module` 回读 `OpenType/FlowDesignId/DiyTableId`，再从模块
-实际发起并检查审批待办。流程节点人员、坐标和拓扑详见 `v8-workflow`。
-
-`CodeForm` 复用 MicroService 宿主与菜单权限上下文。先在表单设计器生成源码，保存至 `microi-generated-forms`，构建并发布微服务；再配置 `MicroServiceKey + MicroServiceRoutePath`（以及当前租户真实的 `MicroServiceId + MicroServicePageId`），保留原表的 `DiyTableId`。Manifest 生成器可解析可移植的 Key/RoutePath；`microi_create_module` 必须传实际 Id。不能把只保存私有源码当作已发布运行产物。
-
-Iframe 不把长期 Token、密码或连接串放 URL。第三方单点登录使用短期、一次性、
-可撤销的服务端交换票据，限制 redirect/scope，并在落地后清理地址栏。
-
-## 数据与业务逻辑
-
-- 单表 CRUD 已由绑定表菜单提供，不额外创建重复接口引擎。
-- 后端 V8 可用 `V8.ModuleEngine.GetTableData({...})`，通过
-  `ModuleEngineKey` 应用模块的关联表查询配置；标准前端 V8 不挂载
-  `V8.ModuleEngine`。
-- 查询接口替换、导入/导出替换和跨表动作属于复杂逻辑时，使用接口引擎。
-- 前端按钮只做确认、收集少量参数、调用接口和刷新；事务与最终校验在后端。
-- 预计超过 2 分钟、500 条、1000 个扇出或 100 次外部调用时使用真实后台任务。
-- 不复制官网旧“Redis 文本进度 + 长事务循环”导入示例作为新实现；必须有稳定
-  幂等键、业务任务状态、真实 Current/Total、失败恢复和必要的 checkpoint 分片。
-
-### 原生 SQL 身份占位符与统计安全
-
-- 模块 SqlWhere/SqlJoin 及字段选项 SQL 中的 `$CurrentUser.Id$`、
-  `$CurrentUser.RoleIds$`、`$CurrentUser.Level$` 必须使用本次可信后端授权快照。
-  角色集合只包含当前有效 RoleId，不能按旧 Token、角色名称或请求中的同名属性授予权限。
-  `IN ($CurrentUser.RoleIds$)` 继续支持；角色撤销后即使仍拥有同表菜单，也须验证计数与汇总不越权。
-- SQL 替换使用局部克隆；部门等其它扩展保留兼容语义，不覆盖 `V8.CurrentUser`。
-  HTTP JSON 不能注入授权快照或可信调用标记，父用户与当前身份不符、用户禁用均失败关闭。
-- 用户访问密钥仍绑定有效 sys_user，沿“账号有效角色 + 密钥 scope/路由/表范围收窄”授权；
-  不把访问密钥伪装成无所属账号的独立角色身份，账号不存在或停用时拒绝查询。
-- Count、SUM 在逐行数据过滤之前执行，列表/计数/导出必须共享真正的查询范围；
-  不能以 DataFilter 已拒绝详情为由宣称统计安全。验收包含旧 Token 撤角、角色删除、
-  管理员降级但仍有菜单、不同父身份和用户对象未被修改。
-- 本能力依赖对应后端二进制；应用包无需复制用户角色数据。它不改变 DbRead 或父事务的隔离语义，
-  联查授权表的副本延迟与旧 RR 快照需要独立验证，不将 SQL 生成通过称为真实数据库验收。
-
-### 菜单启动查询与字段元数据兼容
-
-- 菜单树是登录后的启动控制面。读取 `sys_menu` 时，不能把浏览器传入的
-  `_SelectFields` 直接交给依赖 `diy_field` 的通用查询投影：旧库、空库或升级后缓存
-  未同步时，物理列仍存在但元数据可能不完整，查询结果会退化成只含固定字段 `Id`。
-- 服务端应先在已完成登录、租户与角色菜单范围校验的可信边界读取物理菜单行，再在内存中
-  按请求字段投影；构建树所需的 `Id/ParentId/Sort` 必须保留。可信标记不得由浏览器 JSON
-  绑定，不能借此绕过菜单、角色或数据权限。
-- 底层菜单查询失败必须原样返回失败，禁止把失败结果转换成 `Code=1` 的空菜单。回归测试至少
-  覆盖“不向表单引擎下传显式投影”“字段名大小写兼容”“投影仍保留树字段”“未指定字段时
-  保留物理行”。
-
-## 跨端 ViewSchema
-
-顶层 PC 数据列表默认使用紧凑的新模块标题样式；即使未启用自定义表单视图，也不能退回无标题的旧外观。无指标头部固定 `44px`、含指标头部固定 `62px`，连同间距总纵向占用约 `50px / 68px`。子表、关联表、嵌入表不重复显示，移动端由固定导航栏承载标题。`Scene=List/Card` 的个性化标题、指标、复合列和卡片配置存在时必须直接生效；`EnableViewSchema` 只控制 Detail/Edit 自定义表单视图。
-
-PC 列表的固定结构顺序是“模块 Hero（标题/副标题/动态指标）→ PageTabs → 查询与表格”，Hero 必须渲染在页面多 Tab 上方。头部只使用一次性入场和一次性轻量光效，禁止持续循环动画；`prefers-reduced-motion: reduce` 必须关闭动画和过渡。
-
-PageTabs 通过 `TargetSysMenuId` 切换不同模块/表时，入口模块必须作为稳定宿主：客户端在同一个 `diy-table` 实例内加载目标模块的菜单、表、字段与列表数据，只更新当前 URL 的 `Tab` 查询参数，不替换路由、面包屑、顶部访问标签或宿主 Hero。入口模块只配置一组 PageTabs；目标菜单可隐藏导航，但只需保留目标表格设计和角色权限，不得复制同一组 PageTabs。隐藏目标菜单统一设置 `ParentId=入口菜单Id、Display=0、AppDisplay=0、HasChild=0、PageTabs=[]`，入口菜单保持 `HasChild=0` 以继续作为可点击业务入口。模块设计器必须用可搜索菜单树显示 `TargetSysMenuId` 的模块名称，不能只在运行时 JSON 中保存不可见 Id。切换时必须中止旧请求并以模块上下文版本丢弃迟到响应，失败时回滚原模块。
-
-模块首屏或跨模块切换期间，Hero 标题/指标、PageTabs、工具栏与列表必须显示与最终布局同尺寸的主题化骨架屏；不能先渲染空白旧布局再整体位移。骨架屏同样遵守 `prefers-reduced-motion: reduce`，并在无指标或无 PageTabs 时按元数据提示隐藏对应占位。
-
-`ViewSchema` 是模块级视图，不写入已废弃的通用 `DiyConfig`。优先通过 sys_menu“跨端视图”的 `DiyModulePresentationDesigner` 配置；Detail/Edit 使用独立的“自定义表单视图 JSON”，需要完整协议、角色优先级或未知扩展字段时再使用高级 JSON。启用自定义表单视图后仍须：
-
-- 配置 `EnableViewSchema=1`；`ViewSchemaVersion/ViewConfigVersion` 可为空，分别按 `1.0/1` 处理并在后续变更时递增配置版本。
-- 按 Scene、Device、RoleIds、Priority 选择视图。
-- 配置损坏或客户端不支持时回退标准 `sys_menu + diy_table + diy_field`，不能白屏。
-- 小程序只消费声明式动作，不执行 PC 的任意 `V8Code`。
-- 声明式动作中的 ParamMap/VisibleWhen 只允许白名单字段，不使用 `eval`。
-
-### 重要模块的统计与信息层级
-
-- 待办、库存预警、未读、逾期、待收/待付等有行动含义的菜单，主动询问并配置
-  `MenuBadgeEnabled=1`、`MenuBadgeApiEngineKey` 与说明统计口径的 `MenuBadgeTooltip`。接口统一返回
-  `{ Code:1, Data:{ Value: number } }`，并按当前用户权限统计。
-- `Scene=List` 的 `Layout.Hero` 用 `Eyebrow/Title/Description/Metrics` 建立模块标题与
-  指标条。相同 `ApiEngineKey` 的指标必须由一个聚合接口批量返回，使用 `ValuePath`
-  取值；禁止一个指标一次请求。
-- PC Hero 有指标时采用“左侧标题说明约 25%~30% + 右侧指标区弹性占满”的信息层级，
-  中间只允许一条弱化渐变分隔；指标条容器和单个指标不得叠加多层描边。无指标时标题说明
-  自动占满整行，不保留空指标区。每个指标必须显式配置 `Icon`，并通过不同的 `Tone` 或
-  `Color` 形成可辨识的图标色块与轻背景；同一 Hero 内不得让全部指标使用相同图标和颜色。
-- Hero 指标可用 `Source=DataCount` 读取当前筛选总记录数、用 `Source=PageCount` 读取本页
-  已加载记录数；两者复用列表结果，不调用额外接口。字段汇总继续用 `Field`，跨表或复合
-  统计才用 `ApiEngineKey + ValuePath`。
-- `Layout.List.Columns[]` 用 `Field + Lines + TrailingFields` 配置复合列和右侧图标状态；
-  默认按 `Field + 1 个 Lines` 形成双行，多个信息组应拆成多个双行复合列，避免单列三行
-  抬高整张表。声明支持 `Tone/Color/Icon/ShowLabel/Prefix/Suffix`，引用字段必须进入查询列。
-- `Scene=Card, Device=Mobile` 用 `Layout.Card` 配置 `AvatarTextField/TitleField/TopFields/
-  SubtitleFields/RightFields/Fields/MetaFields/BottomFields`。未配置时继续兼容
-  `MobileListFields/CardTitleTagFields/CardBottomTagFields`。
-- `PageTabs/MoreBtns/PageBtns/BatchSelectMoreBtns/ExportMoreBtns/FormBtns` 需要数量时配置
-  `BadgeEnabled/BadgeApiEngineKey`；一个接口接收当前页 `Ids + ButtonKeys` 并一次返回
-  `Data.Buttons` 与 `Data.Rows`，禁止逐行调用。
-- 能直接用字段表达的信息优先配置复合列/卡片字段；只有确需 HTML 样式或组合逻辑时
-  才使用字段的 `V8TmpEngineTable`，且仍需遵守 DOMPurify 和查询字段范围。
-- 存量菜单没有 Hero.Metrics 时，客户端只允许根据真实后端汇总、当前筛选总数、本页加载数
-  和本页真实状态分布生成兜底指标；不得用随机值装饰页面。字段聚合缺少全量口径时必须明确
-  标注“本页”，不能把当前页求和冒充全表汇总。
-
-### 表单布局协同
-
-- `<=6` 个核心可见字段优先平铺；`7~29` 个字段按基础、业务、状态、附件等信息域使用
-  `CollapseGroup`；`30+` 个字段，或存在多个大型子表、扫码/代码编辑等强任务域时使用
-  表级 `diy_table.Tabs`。最终还要按有效表单行校正，避免产生只有少量字段的空洞 Tab。
-- 新增 `Tabs/CollapseGroup/Divider/Alert` 等布局节点必须走明确的“仅元数据”专用路径。
-  普通新增字段接口可能同步对业务表执行物理 DDL，不能把向 `diy_field` 新增一行误认为
-  仅保存布局配置；写入后要同时回读元数据并核对业务表结构未新增实体列。
-
-## 验收
-
-- `Display/AppDisplay` 除明确隐藏外为 1，父子菜单层级正确。
-- 路由刷新、直接访问、切换菜单均不 404/白屏。
-- 列表字段、筛选、排序、统计、移动端卡片与预期一致。
-- 权限用户可访问，未授权用户不能靠 URL、`_SysMenuId` 或前端字段绕过。
-- MoreBtns/FormBtns/PageTabs/BatchSelectMoreBtns 显隐、调用和刷新正确；PageTabs 数字角标使用稳定 Tab Id 取 `Data.Buttons`。
-- 菜单角标、模块指标和按钮角标按真实权限返回，零值/超限/接口失败降级正确且无 N+1。
-- Hero 在有指标、无指标、长标题和 3~5 个指标时均层级清晰；指标无多层线框，同一组图标与
-  语义色可区分，并在浅色/深色主题下保持可读。
-- PC 复合列和 Mobile Card 引用的附加字段均在查询结果中；长文本、空值、模板值不破版。
-- PC 和移动端分别验证；MicroService 还要验证运行时、页面路由和宿主上下文。
-### 多级表头与顶部 Banner
-
-- 字段权限使用模块 `FieldPermissions`（Manifest `fieldPermissions`），Version=1；按 Everyone/Roles/Users/Departments/Jobs 与 Fields 配置 Visible/Editable，授权对象数组保存 Id。多个匹配组限制取交集，隐藏同时不可编辑；普通用户按最终能力执行，超级管理员按原管理边界。岗位来自 `diy_job`（显示 `JobName`），匹配权威 `sys_user.Jobs` 中的岗位 Id；岗位与角色 `RoleIds` 分开，不得相互替代。
-- 不能只做前端隐藏：FormEngine 查询、隐藏字段条件/排序/统计、导出、写入和导入均须校验。生成代码使用服务端 `DataAppend.FieldAccess`；未传菜单的客户端不能绕过该表已启用的模块限制。验收应覆盖普通账号、直接请求、角色/人员/部门/岗位匹配与只读写入失败。
-- 树模块拖动排序配置 `TreeDragSortEnabled`、`TreeDragSortField`（Manifest 同名小驼峰），排序字段必须为已注册数值字段。业务由 Managed、非匿名接口引擎 `mci-tree-drag-sort` 执行，可信原子仅负责固定引擎的模块解析、权限和白名单写入。
-- 拖动前取全树快照，移动时核验快照；旧、新父级的所有同级记录按间隔 10 重排，同时维护父级、祖先链、HasChild。不得仅更新被拖动记录，也不得按当前分页重排；跨级、循环、过期快照、任一兄弟无权编辑或写入失败必须整次回滚。
-
-- 数据源【多级表头】使用现有 `sys_menu.TableHeaders`，填写 `[{"Label":"人数（人）","Fields":["Total","Male","Female"]}]`；`Fields` 必须引用可见、连续的查询列字段名。嵌套分组可使用 `Children`。缺省、非法 JSON、重复或不连续字段时客户端回退普通表头。
-- Manifest `modules[].tableHeaders` 接受同一数组，MCP 写入 `sys_menu.TableHeaders`；更新已有菜单可通过 `microi_update_module` 传同名字段并回读，不能把合并表头放入已废弃的 `DiyConfig`。
-- 模块的 `HideTableBanner`、`HideFormBanner` 分别关闭表格与表单顶部 Banner。未配置或 `0` 均显示；设为 `1` 后对应专属统计接口不执行，按钮角标接口不受影响。Manifest 使用 `hideTableBanner`、`hideFormBanner`。
-- 上述配置由模块引擎官方应用交付，验收应分别核对物理列、字段可见性、商城包哈希，以及普通表头、合并表头和两种 Banner 开关的真实页面与请求。
+---
+name: module-engine
+description: Microi 模块引擎与 sys_menu 配置指南。用于创建或修改后台菜单、菜单统计角标、模块标题指标、复合列表列、移动端业务卡片、查询列、接口替换、跨端 ViewSchema、动态按钮、PageTabs、树形加表格布局和 MicroService 菜单。
+---
+
+> **Microi吾码基础规范（强制）：** 任何 AI 模型与宿主每次新建或接续吾码任务，先完整读取 `../workspace-conventions/SKILL.md`，必须执行版本播报、`@microi.net/cli` 后台自动升级、Skills/MCP 同步和进度播报。安装与诊断读取 `../microi-codex-installer/SKILL.md`；更新失败延后重试，不阻断当前工作。
+
+# Microi 模块引擎
+
+模块引擎决定同一张表在某个菜单、角色和终端中“如何查询、展示和操作”。
+配置实体是 `sys_menu`，不是 `sys_module`；表结构与字段仍属于
+`diy_table/diy_field`。
+
+导入、导出按钮显示条件分别使用 `sys_menu.ImportCodeShowV8`、`ExportCodeShowV8`，
+与新增、编辑、删除条件一样用 `V8.Result=true/false`。通过模块设计“按钮”分组维护，
+或使用 `microi_update_module`；旧后端需先升级模块引擎应用。它们只控制按钮显示，不能代替后端权限。
+代码字段是否显示按钮由各字段 `Config.CodeEditor.DisplayMode` 决定，禁止按 `sys_menu` 表名强制覆盖；
+未配置时默认 `Inline`，需要紧凑按钮的字段显式保存 `Dialog`。
+
+## 必读参考
+
+- 字段、打开方式、查询配置、ViewSchema 和接口替换：
+  `references/module-config.md`
+- 动态按钮 JSON 与后台任务：`../v8-menu-buttons/SKILL.md`
+- 树形+表格：`../microi-left-right-layout/SKILL.md`
+- 表单控件：`../microi-form-engine/SKILL.md`
+- 表单平铺、CollapseGroup 与 Tabs 决策：`../microi-form-layout/SKILL.md`
+- MicroService 菜单：`../microi-microservice/SKILL.md`
+
+## 创建/修改标准流程
+
+1. `microi_get_db_schema` 读取真实 `diy_table`、字段、已有菜单和父菜单。
+2. 绑定表的菜单使用 `microi_create_module`/Manifest，不直接写 `sys_menu`。
+3. 明确 `openType`、父菜单、路由、PC/移动端显隐和角色范围。
+4. 用字段名配置 `listFields/searchFields/sortFields/hiddenFields/mobileFields`；
+   MCP 解析为字段 Id 和 `SelectFields/SearchFieldIds/...`。
+5. 同一次创建配齐业务按钮、FormBtns、PageTabs 和批量按钮。
+6. 写后回读模块，检查字段映射、按钮 JSON、路由和目标页面。
+
+### 菜单图标必须可辨识（强制）
+
+- 每个新建或修改的菜单都必须设置与业务相关的图标；根目录、分类及子菜单不能批量使用同一个默认图标。优先按名称和实际功能选择，例如客户用 `UserFilled`、日程用 `Calendar`、仓储用 `Box`、办公用 `OfficeBuilding`。
+- 主后台侧栏读取 `sys_menu.IconClass`（CSS/组件图标），不是图片字段 `Icon`。优先填写当前前端已注册的 Element Plus 图标名；使用 FontAwesome/CSS 名称时先核对兼容映射，不能填入不存在的类名后让全部菜单回退为 `Document`。
+- 没有贴切图标时，从实际可用图标集合中随机选一个，并将选择结果保存；可以按稳定菜单 Id 生成确定的随机分配，避免每次刷新或重新发布都变图标。同组菜单应有适当差异，不强求不同业务绝对不重复。
+- 通过 `microi_create_module` / `microi_update_module` 或 Manifest 的模块配置写入，并把图标纳入应用包。只修改图片字段、只检查数据库字符串或只改本地 Manifest 不算完成；必须回读 `IconClass`，在真实侧栏检查图标可见且有区别。
+
+### 新模块表单打开方式（强制默认）
+
+- AI 新建 `diy_table` / 业务模块时，`FormOpenType` 默认写 `Dialog`，`FormOpenWidth`
+  默认写 `80%`；缺省值也必须按这组语义处理，不能再把所有模块统一生成为 Drawer。
+- 只有表单确实非常庞大时才使用 `Drawer`：通常是 36 个以上业务字段、至少 2 个
+  `TableChild`、28 个以上字段且含大型子表，或 7 个以上子表/富文本/代码编辑/上传/地图等
+  重型控件。达到阈值仍应先用 `diy_table.Tabs` 与 CollapseGroup 整理信息架构。
+- 用户显式指定 `Dialog/Drawer/Page` 或宽度时以用户配置为准。Drawer 是贴边直角容器；
+  Dialog 使用平台统一大圆角、可拖动、居中弹层，遮罩服从正向开关 `sys_config.FormMaskBlur`，缺失或 `0/false` 默认关闭毛玻璃。
+7. 为管理员/目标角色分配菜单权限，并以真实登录用户验收。
+
+## 绑定表菜单不能只写两个字段
+
+除 `Name` 和 `DiyTableId` 外，至少配置或允许平台推断：
+
+- `TableDiyFieldIds`
+- `SelectFields`
+- `SearchFieldIds`
+- `SortFieldIds`
+- `NotShowFields`
+- `StatisticsFields`
+- `MobileListFields`
+- `CardTitleTagFields`
+- `CardBottomTagFields`
+- `DefaultOrderBy`
+
+普通状态、开关等低基数字段不能机械创建单列索引。只有真实查询、关联、唯一约束
+或扫描需要的索引才进入 Manifest 并通过 MCP 创建、回读。
+
+Manifest 中按字段名声明统计列，使用 `statFields` 或 `statisticsFieldNames`，例如
+`statFields: ['Amount', 'Quantity']`；MCP 会解析目标租户的字段 Id。
+`statisticsFields` / `StatisticsFields` 表示已经转换好的原生 JSON，元素为
+`{ Id: '真实 diy_field.Id', Type: 'Sum' }`，不能填字段名称字符串。发布前用有记录的
+实际列表检查 `DataAppend.StatisticsFields` 及页面汇总，再以无权限账号检查汇总范围；
+HTTP 成功或菜单字段非空不足以证明统计有效。
+
+## AI 模块视觉交付门禁（强制）
+
+对每个 `Display=1` 或 `AppDisplay=1` 且绑定业务表的 Diy 模块，AI 不能只依赖 CRUD
+默认页，也不能只写 `Name/DiyTableId` 后结束。至少完成以下设计和回读：
+
+1. 每个列表字段都给出符合内容长度的 `TableWidth`；标题/名称/地址较宽，日期/编码居中，
+   金额/数量/状态较紧凑。PC 复合列必须另给合理的 `MinWidth`，不得让末列自适应覆盖它。
+2. 每个模块都配置紧凑 Hero 的业务标题、简短副标题和 2~4 个动态指标。优先统计待处理、
+   逾期、金额、容量、风险、完成率等当前表真正有意义的业务数据，不能全部退化为总记录数。
+3. 指标只能来自 `StatisticsFields`、当前列表 `DataCount/PageCount` 或一个批量聚合接口。
+   禁止随机数、伪统计、静态演示数字和没有口径的“看起来好看”数值。无法推断时允许用
+   `DataCount + PageCount` 做诚实最低兜底，并在后续由业务人员补充口径。
+4. 左侧菜单角标只给少量有行动含义的重要菜单，例如待办、未读、逾期、低库存；禁止每个
+   菜单都加。`PageTabs` 的状态数量、`MoreBtns/PageBtns/FormBtns/BatchSelectMoreBtns/
+   ExportMoreBtns` 的有用数量也应设计角标，但同页统计必须批量返回，禁止 N+1。
+5. PC 至少设计一个 `Field + Lines + TrailingFields` 复合主列。已放入次要行或右侧图标/
+   状态的字段必须从普通独立列去重；主字段、次要行、右侧字段及其 `RequiredFields` 都要
+   进入查询结果，宽度必须足以容纳多行和尾随标签。一般情况下每个复合列最多两行，即
+   一个主字段加一个 `Lines` 次要字段；可以配置多个各自两行的复合列，但不要在同一列放
+   两个 `Lines` 形成三行高表格。确有特殊层级价值时才允许三行，并必须完成桌面视觉验收。
+6. 移动端卡片按真实字段规划图片/头像、标题、副标题、顶部标签、状态、右侧金额、正文、
+   Meta、底部区域；同一字段不得在多个区域机械重复，空区域应隐藏而不是留下占位。
+7. `EnableViewSchema` 只控制 Detail/Edit 自定义表单。Hero、指标、列表密度、PC 复合列、
+   移动端卡片只要有配置就始终生效；设计器必须提供独立的“自定义表单”Tab。
+
+平台自动生成的 List/Card 配置只是防止空白界面的最低值，不能替代 AI 对业务状态、金额、
+时效和操作路径的分析。显式配置优先于自动值；写后用 `microi_get_module` 回读 ViewSchema、
+列宽、统计列、卡片区域和角标配置。
+
+## 打开方式
+
+| OpenType | 用途 |
+|---|---|
+| `Diy` | 标准表单引擎列表/表单 |
+| `Component` | 主前端已注册 Vue 组件 |
+| `Iframe` | 受控外部页面 |
+| `SecondMenu` | 仅作为父菜单 |
+| `Report` | 虚拟报表 |
+| `MicroService` | 已发布前端微服务页面 |
+| `CodeForm` | 表单设计器生成并在已发布微服务中运行的独立 Vue 3 页面；必须绑定 `DiyTableId` |
+| `WorkFlow` | 审批工作流模块；必须绑定 `DiyTableId` 和已启用流程的 `FlowDesignId` |
+
+`WorkFlow` 模块的 `DiyTableId` 必须等于 `wf_flowdesign.TableId`。完整 Manifest
+可填写 `flowName` 引用同一份 `workflows` 定义，生成器保存流程后回填
+`sys_menu.FlowDesignId`；引用已存在流程时填真实 `flowDesignId`。
+使用 `microi_get_module` 回读 `OpenType/FlowDesignId/DiyTableId`，再从模块
+实际发起并检查审批待办。流程节点人员、坐标和拓扑详见 `v8-workflow`。
+
+`CodeForm` 复用 MicroService 宿主与菜单权限上下文。先在表单设计器生成源码，保存至 `microi-generated-forms`，构建并发布微服务；再配置 `MicroServiceKey + MicroServiceRoutePath`（以及当前租户真实的 `MicroServiceId + MicroServicePageId`），保留原表的 `DiyTableId`。Manifest 生成器可解析可移植的 Key/RoutePath；`microi_create_module` 必须传实际 Id。不能把只保存私有源码当作已发布运行产物。
+
+Iframe 不把长期 Token、密码或连接串放 URL。第三方单点登录使用短期、一次性、
+可撤销的服务端交换票据，限制 redirect/scope，并在落地后清理地址栏。
+
+## 数据与业务逻辑
+
+- 单表 CRUD 已由绑定表菜单提供，不额外创建重复接口引擎。
+- 后端 V8 可用 `V8.ModuleEngine.GetTableData({...})`，通过
+  `ModuleEngineKey` 应用模块的关联表查询配置；标准前端 V8 不挂载
+  `V8.ModuleEngine`。
+- 查询接口替换、导入/导出替换和跨表动作属于复杂逻辑时，使用接口引擎。
+- 前端按钮只做确认、收集少量参数、调用接口和刷新；事务与最终校验在后端。
+- 预计超过 2 分钟、500 条、1000 个扇出或 100 次外部调用时使用真实后台任务。
+- 不复制官网旧“Redis 文本进度 + 长事务循环”导入示例作为新实现；必须有稳定
+  幂等键、业务任务状态、真实 Current/Total、失败恢复和必要的 checkpoint 分片。
+
+### 原生 SQL 身份占位符与统计安全
+
+- 模块 SqlWhere/SqlJoin 及字段选项 SQL 中的 `$CurrentUser.Id$`、
+  `$CurrentUser.RoleIds$`、`$CurrentUser.Level$` 必须使用本次可信后端授权快照。
+  角色集合只包含当前有效 RoleId，不能按旧 Token、角色名称或请求中的同名属性授予权限。
+  `IN ($CurrentUser.RoleIds$)` 继续支持；角色撤销后即使仍拥有同表菜单，也须验证计数与汇总不越权。
+- SQL 替换使用局部克隆；部门等其它扩展保留兼容语义，不覆盖 `V8.CurrentUser`。
+  HTTP JSON 不能注入授权快照或可信调用标记，父用户与当前身份不符、用户禁用均失败关闭。
+- 用户访问密钥仍绑定有效 sys_user，沿“账号有效角色 + 密钥 scope/路由/表范围收窄”授权；
+  不把访问密钥伪装成无所属账号的独立角色身份，账号不存在或停用时拒绝查询。
+- Count、SUM 在逐行数据过滤之前执行，列表/计数/导出必须共享真正的查询范围；
+  不能以 DataFilter 已拒绝详情为由宣称统计安全。验收包含旧 Token 撤角、角色删除、
+  管理员降级但仍有菜单、不同父身份和用户对象未被修改。
+- 本能力依赖对应后端二进制；应用包无需复制用户角色数据。它不改变 DbRead 或父事务的隔离语义，
+  联查授权表的副本延迟与旧 RR 快照需要独立验证，不将 SQL 生成通过称为真实数据库验收。
+
+### 菜单启动查询与字段元数据兼容
+
+- 菜单树是登录后的启动控制面。读取 `sys_menu` 时，不能把浏览器传入的
+  `_SelectFields` 直接交给依赖 `diy_field` 的通用查询投影：旧库、空库或升级后缓存
+  未同步时，物理列仍存在但元数据可能不完整，查询结果会退化成只含固定字段 `Id`。
+- 服务端应先在已完成登录、租户与角色菜单范围校验的可信边界读取物理菜单行，再在内存中
+  按请求字段投影；构建树所需的 `Id/ParentId/Sort` 必须保留。可信标记不得由浏览器 JSON
+  绑定，不能借此绕过菜单、角色或数据权限。
+- 底层菜单查询失败必须原样返回失败，禁止把失败结果转换成 `Code=1` 的空菜单。回归测试至少
+  覆盖“不向表单引擎下传显式投影”“字段名大小写兼容”“投影仍保留树字段”“未指定字段时
+  保留物理行”。
+
+## 跨端 ViewSchema
+
+顶层 PC 数据列表默认使用紧凑的新模块标题样式；即使未启用自定义表单视图，也不能退回无标题的旧外观。无指标头部固定 `44px`、含指标头部固定 `62px`，连同间距总纵向占用约 `50px / 68px`。子表、关联表、嵌入表不重复显示，移动端由固定导航栏承载标题。`Scene=List/Card` 的个性化标题、指标、复合列和卡片配置存在时必须直接生效；`EnableViewSchema` 只控制 Detail/Edit 自定义表单视图。
+
+PC 列表的固定结构顺序是“模块 Hero（标题/副标题/动态指标）→ PageTabs → 查询与表格”，Hero 必须渲染在页面多 Tab 上方。头部只使用一次性入场和一次性轻量光效，禁止持续循环动画；`prefers-reduced-motion: reduce` 必须关闭动画和过渡。
+
+PageTabs 通过 `TargetSysMenuId` 切换不同模块/表时，入口模块必须作为稳定宿主：客户端在同一个 `diy-table` 实例内加载目标模块的菜单、表、字段与列表数据，只更新当前 URL 的 `Tab` 查询参数，不替换路由、面包屑、顶部访问标签或宿主 Hero。入口模块只配置一组 PageTabs；目标菜单可隐藏导航，但只需保留目标表格设计和角色权限，不得复制同一组 PageTabs。隐藏目标菜单统一设置 `ParentId=入口菜单Id、Display=0、AppDisplay=0、HasChild=0、PageTabs=[]`，入口菜单保持 `HasChild=0` 以继续作为可点击业务入口。模块设计器必须用可搜索菜单树显示 `TargetSysMenuId` 的模块名称，不能只在运行时 JSON 中保存不可见 Id。切换时必须中止旧请求并以模块上下文版本丢弃迟到响应，失败时回滚原模块。
+
+模块首屏或跨模块切换期间，Hero 标题/指标、PageTabs、工具栏与列表必须显示与最终布局同尺寸的主题化骨架屏；不能先渲染空白旧布局再整体位移。骨架屏同样遵守 `prefers-reduced-motion: reduce`，并在无指标或无 PageTabs 时按元数据提示隐藏对应占位。
+
+`ViewSchema` 是模块级视图，不写入已废弃的通用 `DiyConfig`。优先通过 sys_menu“跨端视图”的 `DiyModulePresentationDesigner` 配置；Detail/Edit 使用独立的“自定义表单视图 JSON”，需要完整协议、角色优先级或未知扩展字段时再使用高级 JSON。启用自定义表单视图后仍须：
+
+- 配置 `EnableViewSchema=1`；`ViewSchemaVersion/ViewConfigVersion` 可为空，分别按 `1.0/1` 处理并在后续变更时递增配置版本。
+- 按 Scene、Device、RoleIds、Priority 选择视图。
+- 配置损坏或客户端不支持时回退标准 `sys_menu + diy_table + diy_field`，不能白屏。
+- 小程序只消费声明式动作，不执行 PC 的任意 `V8Code`。
+- 声明式动作中的 ParamMap/VisibleWhen 只允许白名单字段，不使用 `eval`。
+
+### 重要模块的统计与信息层级
+
+- 待办、库存预警、未读、逾期、待收/待付等有行动含义的菜单，主动询问并配置
+  `MenuBadgeEnabled=1`、`MenuBadgeApiEngineKey` 与说明统计口径的 `MenuBadgeTooltip`。接口统一返回
+  `{ Code:1, Data:{ Value: number } }`，并按当前用户权限统计。
+- `Scene=List` 的 `Layout.Hero` 用 `Eyebrow/Title/Description/Metrics` 建立模块标题与
+  指标条。相同 `ApiEngineKey` 的指标必须由一个聚合接口批量返回，使用 `ValuePath`
+  取值；禁止一个指标一次请求。
+- PC Hero 有指标时采用“左侧标题说明约 25%~30% + 右侧指标区弹性占满”的信息层级，
+  中间只允许一条弱化渐变分隔；指标条容器和单个指标不得叠加多层描边。无指标时标题说明
+  自动占满整行，不保留空指标区。每个指标必须显式配置 `Icon`，并通过不同的 `Tone` 或
+  `Color` 形成可辨识的图标色块与轻背景；同一 Hero 内不得让全部指标使用相同图标和颜色。
+- Hero 指标可用 `Source=DataCount` 读取当前筛选总记录数、用 `Source=PageCount` 读取本页
+  已加载记录数；两者复用列表结果，不调用额外接口。字段汇总继续用 `Field`，跨表或复合
+  统计才用 `ApiEngineKey + ValuePath`。
+- `Layout.List.Columns[]` 用 `Field + Lines + TrailingFields` 配置复合列和右侧图标状态；
+  默认按 `Field + 1 个 Lines` 形成双行，多个信息组应拆成多个双行复合列，避免单列三行
+  抬高整张表。声明支持 `Tone/Color/Icon/ShowLabel/Prefix/Suffix`，引用字段必须进入查询列。
+- `Scene=Card, Device=Mobile` 用 `Layout.Card` 配置 `AvatarTextField/TitleField/TopFields/
+  SubtitleFields/RightFields/Fields/MetaFields/BottomFields`。未配置时继续兼容
+  `MobileListFields/CardTitleTagFields/CardBottomTagFields`。
+- `PageTabs/MoreBtns/PageBtns/BatchSelectMoreBtns/ExportMoreBtns/FormBtns` 需要数量时配置
+  `BadgeEnabled/BadgeApiEngineKey`；一个接口接收当前页 `Ids + ButtonKeys` 并一次返回
+  `Data.Buttons` 与 `Data.Rows`，禁止逐行调用。
+- 能直接用字段表达的信息优先配置复合列/卡片字段；只有确需 HTML 样式或组合逻辑时
+  才使用字段的 `V8TmpEngineTable`，且仍需遵守 DOMPurify 和查询字段范围。
+- 存量菜单没有 Hero.Metrics 时，客户端只允许根据真实后端汇总、当前筛选总数、本页加载数
+  和本页真实状态分布生成兜底指标；不得用随机值装饰页面。字段聚合缺少全量口径时必须明确
+  标注“本页”，不能把当前页求和冒充全表汇总。
+
+### 表单布局协同
+
+- `<=6` 个核心可见字段优先平铺；`7~29` 个字段按基础、业务、状态、附件等信息域使用
+  `CollapseGroup`；`30+` 个字段，或存在多个大型子表、扫码/代码编辑等强任务域时使用
+  表级 `diy_table.Tabs`。最终还要按有效表单行校正，避免产生只有少量字段的空洞 Tab。
+- 新增 `Tabs/CollapseGroup/Divider/Alert` 等布局节点必须走明确的“仅元数据”专用路径。
+  普通新增字段接口可能同步对业务表执行物理 DDL，不能把向 `diy_field` 新增一行误认为
+  仅保存布局配置；写入后要同时回读元数据并核对业务表结构未新增实体列。
+
+## 验收
+
+- `Display/AppDisplay` 除明确隐藏外为 1，父子菜单层级正确。
+- 路由刷新、直接访问、切换菜单均不 404/白屏。
+- 列表字段、筛选、排序、统计、移动端卡片与预期一致。
+- 权限用户可访问，未授权用户不能靠 URL、`_SysMenuId` 或前端字段绕过。
+- MoreBtns/FormBtns/PageTabs/BatchSelectMoreBtns 显隐、调用和刷新正确；PageTabs 数字角标使用稳定 Tab Id 取 `Data.Buttons`。
+- 菜单角标、模块指标和按钮角标按真实权限返回，零值/超限/接口失败降级正确且无 N+1。
+- Hero 在有指标、无指标、长标题和 3~5 个指标时均层级清晰；指标无多层线框，同一组图标与
+  语义色可区分，并在浅色/深色主题下保持可读。
+- PC 复合列和 Mobile Card 引用的附加字段均在查询结果中；长文本、空值、模板值不破版。
+- PC 和移动端分别验证；MicroService 还要验证运行时、页面路由和宿主上下文。
+### 多级表头与顶部 Banner
+
+- 字段权限使用模块 `FieldPermissions`（Manifest `fieldPermissions`），Version=1；按 Everyone/Roles/Users/Departments/Jobs 与 Fields 配置 Visible/Editable，授权对象数组保存 Id。多个匹配组限制取交集，隐藏同时不可编辑；普通用户按最终能力执行，超级管理员按原管理边界。岗位来自 `diy_job`（显示 `JobName`），匹配权威 `sys_user.Jobs` 中的岗位 Id；岗位与角色 `RoleIds` 分开，不得相互替代。
+- 不能只做前端隐藏：FormEngine 查询、隐藏字段条件/排序/统计、导出、写入和导入均须校验。生成代码使用服务端 `DataAppend.FieldAccess`；未传菜单的客户端不能绕过该表已启用的模块限制。验收应覆盖普通账号、直接请求、角色/人员/部门/岗位匹配与只读写入失败。
+- 树模块拖动排序配置 `TreeDragSortEnabled`、`TreeDragSortField`（Manifest 同名小驼峰），排序字段必须为已注册数值字段。业务由 Managed、非匿名接口引擎 `mci-tree-drag-sort` 执行，可信原子仅负责固定引擎的模块解析、权限和白名单写入。
+- 拖动前取全树快照，移动时核验快照；旧、新父级的所有同级记录按间隔 10 重排，同时维护父级、祖先链、HasChild。不得仅更新被拖动记录，也不得按当前分页重排；跨级、循环、过期快照、任一兄弟无权编辑或写入失败必须整次回滚。
+
+- 数据源【多级表头】使用现有 `sys_menu.TableHeaders`，填写 `[{"Label":"人数（人）","Fields":["Total","Male","Female"]}]`；`Fields` 必须引用可见、连续的查询列字段名。嵌套分组可使用 `Children`。缺省、非法 JSON、重复或不连续字段时客户端回退普通表头。
+- Manifest `modules[].tableHeaders` 接受同一数组，MCP 写入 `sys_menu.TableHeaders`；更新已有菜单可通过 `microi_update_module` 传同名字段并回读，不能把合并表头放入已废弃的 `DiyConfig`。
+- 模块的 `HideTableBanner`、`HideFormBanner` 分别关闭表格与表单顶部 Banner。未配置或 `0` 均显示；设为 `1` 后对应专属统计接口不执行，按钮角标接口不受影响。Manifest 使用 `hideTableBanner`、`hideFormBanner`。
+- 上述配置由模块引擎官方应用交付，验收应分别核对物理列、字段可见性、商城包哈希，以及普通表头、合并表头和两种 Banner 开关的真实页面与请求。