@microi.net/cli 5.9.4 → 5.9.6

package/skills/module-engine/SKILL.md

@@ -55,6 +55,32 @@ description: Microi 模块引擎与 sys_menu 配置指南。用于创建或修
   Dialog 使用平台统一大圆角、可拖动、居中弹层，遮罩服从正向开关 `sys_config.FormMaskBlur`，缺失或 `0/false` 默认关闭毛玻璃。
 7. 为管理员/目标角色分配菜单权限，并以真实登录用户验收。
 
+## AI 开发菜单先行与占位切换（强制）
+
+完整系统需求分析和现状盘点结束后，先规划业务、老板经营、领导管理及统计报表的完整菜单树，
+用只含父菜单、可见占位叶菜单和必要权限的独立 Manifest 执行 `plan/dryRun`，
+在指定开发租户授权内先落地；不预绑定不存在的表、页面或微服务，最终资源随后分阶段生成。
+详细流程与验收读取
+[菜单先行与经营报表增补要求](../microi-system-delivery/references/progressive-01-标准工作流.md#菜单先行与经营报表增补要求强制)。
+局部修改只处理范围内新菜单；只读任务不写入。已有已完成功能不能改回占位页。
+
+- 父菜单为 `SecondMenu`；仅用户可见的新增业务/报表叶菜单保存独立稳定的 `Url`，使用
+  `OpenType=Component`、`ComponentPath=/ai-engine/developing`、`IsMicroiService=0` 复用共享页面。
+  隐藏 `TableChild` 等数据/授权载体仍使用原 `Diy`、真实表绑定及 `Display=0/AppDisplay=0`。
+  当前菜单 `route.meta.Id/title` 提供页面身份与标题。不能把全部菜单的业务 URL 都设为
+  共享组件路径，否则访问标签、缓存和菜单身份会混淆；不要复制一份占位 Vue 给每个菜单。
+- 目标框架前端必须实际包含该组件，旧版本先按授权升级；依赖未满足时先交付菜单规划，
+  记录版本限制并保留可用页面，不写不存在的组件路径，不擅自升级客户容器。占位页填满
+  可用内容区，持续动画表达等待，支持明暗主题、
+  窄屏及减少动态效果；没有真实任务状态时禁止伪造开发百分比、倒计时或完成量。
+- 候选真实页面先在已授权入口独立完成业务、权限、数据和截图预验收，回读真实资源 Id 后，
+  在同一 `sys_menu.Id` 更新最终 `OpenType/ComponentPath/IsMicroiService` 或已发布资源绑定；保持
+  `Id/ParentId/Url/Sort`、角色/按钮权限和其它关联。刷新菜单、移除旧占位缓存并回读，
+  从原菜单和原 URL 最终验收；失败仅恢复该菜单记录的占位/原正确绑定并列为未完成。
+  不要求仍占位的原 URL 提前展示候选页面。MicroService 绑定仍遵守四字段完整性。
+- 用 `microi_get_module` 回读，再用真实用户逐菜单点击、切换、刷新检查标题、访问标签、
+  权限与缓存；开发中或失败菜单列为未完成，不以占位页、隐藏菜单或修改状态文案冒充交付。
+
 ## 绑定表菜单不能只写两个字段
 
 除 `Name` 和 `DiyTableId` 外，至少配置或允许平台推断：

package/skills/ocr-engine/agents/openai.yaml

@@ -1,4 +1,4 @@
-interface:
-  display_name: "Microi OCR 引擎"
-  short_description: "集成、配置和验证 Microi 通用 OCR 能力"
-  default_prompt: "Use $ocr-engine to integrate and validate tenant-isolated OCR in Microi."
+interface:
+  display_name: "Microi OCR 引擎"
+  short_description: "集成、配置和验证 Microi 通用 OCR 能力"
+  default_prompt: "Use $ocr-engine to integrate and validate tenant-isolated OCR in Microi."

package/skills/page-engine/SKILL.md

@@ -9,6 +9,27 @@ description: 生成和审查 Microi 界面引擎 Page Engine 页面 JSON。用
 
 MCP 的生成/保存入口包含 `microi_build_page_design` 与 `microi_save_page_design`；版本治理入口见下文。保存工具写入后仍需回读 `mic_page`，不能把生成成功当作持久化成功。
 
+## 完整 AI 开发默认报表（强制）
+
+完整系统开发必须按需求主动设计基于界面引擎的业务统计、老板经营与领导管理报表，
+先把相应入口纳入菜单骨架，再接通真实数据并验收。详细范围与菜单切换流程读取
+[菜单先行与经营报表增补要求](../microi-system-delivery/references/progressive-01-标准工作流.md#菜单先行与经营报表增补要求强制)。
+局部修改只覆盖相关页面/指标，只读分析不创建页面。用户明确的范围优先。
+
+- 每个报表服务明确角色与决策任务；业务运营覆盖状态、趋势、效率与异常，经营视角覆盖
+  有真实来源的规模、收支/利润、回款及风险，管理视角覆盖部门/人员、任务进展、待办/逾期、
+  利用与达成。不存在数据来源的指标标为不适用并说明，不能编造成本、利润或业绩。
+- 每个指标定义来源、公式、单位/精度、状态、时间字段/时区/边界、比较基期、维度与角色。
+  当前租户真实数据通过服务端批量聚合，时间/维度筛选和用户数据权限必须在接口中生效。
+  禁止演示值、本页合计冒充全量或前端拉取全量明细再统计。
+- 页面包含周期/维度筛选、加载、零/空、无权限和失败状态；请求失败不能显示为正常零值。
+  指标/图表穿透到同一口径的授权明细并对账。界面引擎负责看板和图表，分页查询/导出明细
+  配合 `report-engine`；列表汇总、Hero 和角标不能替代决策报表。
+- 保存后回读 `mic_page`、菜单绑定、数据源/接口；以管理员、经营/管理角色、普通与无权限
+  角色验证时间边界、筛选、隔离、零/空/失败和明细对账，完成电脑/移动、明暗主题截图。
+  先从已授权候选入口独立预验收，再以回读后的真实页面 Id 切换同一菜单并按打开方式设置标记，
+  保留菜单身份与权限；从原 URL 最终验收，失败精确恢复本菜单原绑定并记录未完成。
+
 ## 紧凑报表与平台主题
 
 需要“主指标 + 多行次指标 + 图表 + 排行表 + 资讯”布局时，可读取 [examples/compact-dashboard.json](examples/compact-dashboard.json) 作为原生组件示例。示例数值仅用于视觉排版，交付业务报表前必须替换为当前租户的真实数据源。