@microi.net/cli 5.2.0 → 5.2.1

package/skills/module-engine/SKILL.md

@@ -135,9 +135,9 @@ PageTabs 通过 `TargetSysMenuId` 切换不同模块/表时，入口模块必须
 
 ### 重要模块的统计与信息层级
 
-- 待办、库存预警、未读、逾期、待收/待付等有行动含义的菜单，主动询问并配置
-  `MenuBadgeEnabled=1` 与 `MenuBadgeApiEngineKey`。接口统一返回
-  `{ Code:1, Data:{ Value: number } }`，并按当前用户权限统计。
+- 待办、库存预警、未读、逾期、待收/待付等有行动含义的菜单，主动询问并配置
+  `MenuBadgeEnabled=1`、`MenuBadgeApiEngineKey` 与说明统计口径的 `MenuBadgeTooltip`。接口统一返回
+  `{ Code:1, Data:{ Value: number } }`，并按当前用户权限统计。
 - `Scene=List` 的 `Layout.Hero` 用 `Eyebrow/Title/Description/Metrics` 建立模块标题与
   指标条。相同 `ApiEngineKey` 的指标必须由一个聚合接口批量返回，使用 `ValuePath`
   取值；禁止一个指标一次请求。

package/skills/module-engine/references/module-config.md

@@ -26,6 +26,7 @@
 | `DefaultOrderBy` | 默认排序 |
 | `MenuBadgeEnabled` | 左侧菜单统计角标开关 |
 | `MenuBadgeApiEngineKey` | 菜单统计接口引擎 Key，返回 `Data.Value` |
+| `MenuBadgeTooltip` | 鼠标移入菜单数字角标时显示的统计口径说明；应写清对象、用户范围及待办/未读/总数等含义 |
 
 默认隐藏 Id、外键、系统字段、布局字段、上传、富文本、地图和子表等重字段。
 默认搜索优先名称、标题、编号、状态、类型、分类、负责人和时间；统计优先金额、
@@ -40,6 +41,8 @@
 
 菜单角标只用于少量待办、未读、逾期、预警等重要入口；PageTabs 与按钮角标按业务价值
 选择。相同页面的一组指标/角标使用一个批量接口，不逐指标、逐按钮、逐行请求。
+配置菜单角标时应同时配置 `MenuBadgeTooltip`；历史菜单缺少该字段时，客户端回退显示菜单名
+和原始数字，不得因提示文案缺失影响角标本身。
 自动默认值只保证旧库和漏配模块不出现空白标题，不替代业务设计；严禁用随机数或静态演示
 数字伪造统计。没有可推断业务指标时只使用真实 `DataCount/PageCount` 兜底。
 

package/skills/v8-cache-pattern/SKILL.md

@@ -285,4 +285,5 @@ fire-and-forget；否则数千个 `SCAN/DEL/PUBLISH` 会同时进入同一个
 - 同一租户的失效广播要有界并发，短暂连接异常可做有限次数重试；
 - 持续故障的日志应按时间窗口汇总，但不得静默吞掉一致性告警；
 - 每个租户可能使用不同 Redis，订阅初始化状态不得用一个全局 `static bool` 共享；
+- 缓存实例必须保存创建时的准确 `OsClient`，按模式 `SCAN/DEL` 时直接使用该租户连接；禁止根据 Redis DB 编号反推连接，因为不同租户可能在不同服务器上使用相同 DB 编号；
 - 等待发布只解决回压，业务写入和缓存失效仍需保持 `OsClient` 隔离及可重试幂等。