@microi.net/cli 4.9.5 → 4.9.7

package/skills/microi-microservice/SKILL.md

@@ -3,7 +3,7 @@ name: microi-microservice
 description: Microi 前端微服务 MicroService 开发与交付指南。用于创建、读取、修改、构建、发布或修复 Vue3 微应用，维护 microi.routes.json，绑定 sys_menu，使用 V8.OpenAppDialog，或通过 MCP 管理 Web、UniApp、MicroService 应用源码和运行时。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi 前端微服务
 
@@ -180,6 +180,13 @@ AI 生成菜单微服务时，应优先封装一个 `callMicroiHost(action, data
 吾码宿主独立预览时的回退值。不得直接写死 `min-height: 100vh`、`calc(100vh - 100px)` 等
 只适配浏览器视口或某个主站布局的高度，否则嵌入 TagsView、弹窗或移动端时会被裁剪或产生双滚动。
 
+菜单型微服务必须只有一个纵向滚动所有者：宿主外层隐藏溢出，`<micro-app>` 边界提供默认
+`overflow-y:auto` 兜底。普通长页面保持自然高度即可；子应用若需要 sticky 工具栏、虚拟列表等
+内部滚动，则自己的滚动容器必须具有基于 `--micro-app-available-height` 的确定高度和
+`overflow-y:auto`。真实子滚动容器会把内容约束在边界内，框架兜底条自动不出现；只给自动高度
+根节点写 `overflow:auto` 不算自滚动容器。验收需分别覆盖框架兜底和子应用自滚动，断言任一时刻
+只有一个 `scrollHeight > clientHeight` 的纵向滚动所有者。
+
 加载/协议/运行时异常只由宿主兜底显示；子应用业务错误标记 `handled=true` 后宿主不得重复提示。
 加载失败页至少显示 AppKey、PageKey、路由、版本、入口、HTTP 状态、发布状态、资产来源、挂载状态和安全原因码，并提供重试、返回与复制诊断。
 

package/skills/microi-microservice/references/runtime-delivery.md

@@ -171,6 +171,10 @@ const host = window.microApp?.getData?.() || {};
 移动端共享宿主实测高度；不要在嵌入模式直接固定 `100vh`。宿主高度变化时还会通过
 `host:resize` 数据事件下发 `hostViewport`，画布、图表等需精确像素的组件据此重新布局。
 
+菜单页采用单一纵向滚动所有者：自然增高的长页面由 `<micro-app>` 边界兜底滚动；需要内部
+sticky/虚拟列表时，子应用以宿主可用高度约束自己的滚动容器并设置 `overflow-y:auto`，框架边界
+因不再发生内容溢出而不显示滚动条。不要同时让宿主外层、微服务边界和自动高度根节点都承担滚动。
+
 子应用通过模板 SDK 调用接口，不自行发明认证协议。关闭/结果使用宿主约定的
 success、cancel、error/close 事件；业务写入成功后再报告 success。
 

package/skills/microi-mobile-app-quality/SKILL.md

@@ -3,7 +3,7 @@ name: microi-mobile-app-quality
 description: Microi 移动端质量门禁，适用于 UniApp/H5/微信小程序。用于创建、重设计、修复、测试或交付任何 Microi 移动端项目，覆盖登录、底部导航、快捷入口、按钮、动效、菜单层级与移动端视觉验收。
 ---
 
-> **Codex 强制前置：** 当前宿主为 Codex 时，在使用本 Skill 前必须先完整读取 `../microi-codex-installer/SKILL.md`，完成“Codex 每任务最新版硬门禁”；门禁未通过不得继续本 Skill。非 Codex 宿主跳过此项。
+> **Codex 非阻塞自动更新：** 当前宿主为 Codex 时，吾码 CLI、Codex 插件与工作区 AI/MCP 由后台自动更新；需要诊断时读取 `../microi-codex-installer/SKILL.md`。更新失败、等待空闲或尚未重载均不得阻断当前、正在进行或新建任务。非 Codex 宿主跳过此项。
 
 # Microi 移动端质量门禁
 
@@ -11,6 +11,8 @@ description: Microi 移动端质量门禁，适用于 UniApp/H5/微信小程序
 
 自动触发：只要任务涉及 Microi 移动端应用、H5、微信小程序、App 构建、uni-app 项目、登录页、tabbar、首页、我的页、工作台、报告页、视觉重设计或移动端验收，即使用户没有明确点名，也要应用本 skill。
 
+<!-- microi-progressive:begin -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-000 sha256=9f83607349ba6e305c3d2993de8eeceab70c344557e5dfa2a5be964492ef4685 -->
 ## 1. 导航和快捷入口必须使用真实图标
 
 底部导航、首页快捷入口、会员中心快捷项、九宫格操作和悬浮操作，必须在文字上方或旁边显示可识别的图标。
@@ -37,6 +39,8 @@ description: Microi 移动端质量门禁，适用于 UniApp/H5/微信小程序
 - 主题切换后重新截图底部导航、首页快捷入口和个人中心快捷入口；任何一个图标在圆底上看不清，都算验收失败。
 - UniApp H5 桌面预览可以显示手机壳；真机和浏览器移动设备仿真必须自动去壳并铺满视口。自动化测试要分别断言桌面手机壳存在、移动端手机壳标题隐藏，同时检查所有底部菜单包含真实图标节点。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-001 sha256=4e1b247852aa9f235a26f756d415ebb9fb922f2fea0569bda1bdc8e0b91c4d1c -->
 ## 1.1 包体资源必须按用途分层
 
 - 构建前扫描图片、音频、视频、字体和第三方资源；公开的大资源优先上传到当前租户 HDFS 公有桶并通过 `sys_config.FileServer`/CDN 引用，敏感资源使用私有桶。
@@ -46,6 +50,8 @@ description: Microi 移动端质量门禁，适用于 UniApp/H5/微信小程序
 - 微信小程序上传前增加硬门禁：扫描 `dist/build/mp-weixin` 的真实文件；单个非关键静态资源超过 `256 KB`、主包静态资源达到 `1.5 MB`，或主包距微信当前硬上限不足 `300 KB` 时，发布步骤必须失败并列出最大文件，不能等开发者工具上传后才发现超限。
 - 迁移到 HDFS/CDN 后必须从构建产物确认原大文件已经消失，并从业务记录/配置回读相对 `Path`；页面要先加载当前租户 `SysConfig.FileServer`，不得以源码硬编码 CDN 域名替代运行期配置。远程资源加载失败时只能回退到轻量本地占位，不得把原大图重新塞回主包。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-002 sha256=99bbb22068bb61d61a3fd20b1a21f421804857ce8da85a92390f64641e3f43fc -->
 ## 2. 不要猜测 Microi 前端 SDK 登录接口
 
 编写登录代码前，先检查本地项目 SDK 封装，例如 `src/utils/microi.v8.js`、`src/utils/api.js`，或标准 `microi.uniapp` 登录实现。
@@ -71,6 +77,8 @@ description: Microi 移动端质量门禁，适用于 UniApp/H5/微信小程序
 - 点击账号登录不会抛出 `V8.Login.Login is not a function`。
 - 使用真实系统账号登录后，必须验证“我的”页显示已登录角色，首页/工单/报告不再出现未登录提示，刷新页面或切换底部导航后仍保持一致。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-003 sha256=0a9274750cb6f507b87c417eb66e5f9aa60918c6ead87c7eb2855e209aa30e61 -->
 ## 2.1 登录验证码必须跟随 Sys_Config.EnableCaptcha
 
 PC 端、H5、App、微信小程序或任何自定义前端只要调用 `/api/SysUser/login`、`/api/SysUser/Login` 或 `V8.Login(param)`，都必须先读取 `Sys_Config` 的 `EnableCaptcha` 配置，并按配置决定是否展示和提交图形验证码。
@@ -95,6 +103,8 @@ PC 端、H5、App、微信小程序或任何自定义前端只要调用 `/api/Sy
 - 检查网络请求：`/api/Captcha/GetCaptcha` 返回后已保存 `captchaid`；登录请求体包含 `_CaptchaId/_CaptchaValue`。
 - 参考标准实现：`microi.uniapp/src/pages/login/index.vue`。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-004 sha256=22bdaf38588f251016e115f1ad15a433e827fb2191041d55ecad42cda94253d1 -->
 ## 3. OsClient 请求头不得重复
 
 Microi 请求只能发送一个不区分大小写的 OsClient 请求头。浏览器、代理或服务端运行时可能把 `OsClient` 和 `osclient` 这类大小写重复键合并成 `demo, demo`，导致租户识别失败。
@@ -115,6 +125,8 @@ Microi 请求只能发送一个不区分大小写的 OsClient 请求头。浏览
 - 确认目标租户请求头正好是一个运行期值（例如 `osclient: demo`），没有被逗号合并。
 - 微信/支付宝/飞书/抖音等小程序授权登录接口也必须检查，例如 `/apiengine/miniprogram-login`，不得出现 `osclient: demo, demo` 这类合并值。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-005 sha256=1394c7fb8e59b25553e2f9b71ab7f8cf03290b6930c8d8436123bc6048ad2435 -->
 ## 3.1 小程序授权登录必须可追踪、可读错误
 
 微信开发者工具的模拟授权与体验版真机调用不是同一条真实链路。手机号授权登录接口必须按阶段诊断，不能只返回“手机号登录失败”。
@@ -132,6 +144,8 @@ Microi 请求只能发送一个不区分大小写的 OsClient 请求头。浏览
 - 模拟 `uni.request` 域名未配置、超时、HTTP 500、接口 `Code=0`，前端均显示具体原因，loading 在 `finally` 中恢复。
 - 体验版真机复测授权登录；不能只以开发者工具模拟成功作为上线依据。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-006 sha256=feb9ba3267bdf1f6394c425b45dd71e19ac4382ae05549d6e1b6b664c6517a19 -->
 ## 3.1.1 手机号快速验证前置页不得混淆腾讯官方
 
 - 调用手机号快速验证组件前展示的登录页、弹窗、按钮、说明、分享标题和失败提示中，禁止出现“微信”“微信官方”“微信登录”“一键登录”等可能让用户误认为腾讯官方功能或官方产品的文案。
@@ -139,6 +153,8 @@ Microi 请求只能发送一个不区分大小写的 OsClient 请求头。浏览
 - 推荐统一使用“手机号快捷登录”“手机号快速验证”“验证中”等中性文案。底层仍按平台要求保留 `open-type="getPhoneNumber"`、`provider:'weixin'` 等技术实现，不能为改文案破坏真实授权链路。
 - `build:mp-weixin` 后必须扫描登录页源码和 `dist/build/mp-weixin/pages/login/` 产物中的可见文案，并对手机号快速验证前置页截图；发现混淆词、官方 Logo 或近似元素时阻止上传和提审。
 
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-007 sha256=7598db1fdabfe127c2be7593b83dc3a246b1db852d9c0d4001f849d3e97aa273 -->
 ## 3.2 微信小程序每个页面默认支持分享
 
 小程序项目必须默认支持转发给朋友和分享到朋友圈，不能只给首页或公开页添加分享。登录和权限控制属于访问阶段，不得用来隐藏分享能力。
@@ -155,293 +171,11 @@ Microi 请求只能发送一个不区分大小写的 OsClient 请求头。浏览
 - 执行 `build:mp-weixin`，逐页检查编译后的页面 JS 存在 `onShareAppMessage`、`onShareTimeline`，不能只检查源码或只确认构建成功。
 - 在微信开发者工具和体验版各抽测公开页、登录页、一个需登录详情页：朋友转发和朋友圈入口都存在，接收者路径参数正确；未登录接收者看到登录提示而不是白屏或 404。
 
-## 4. 重要按钮必须带图标
+<!-- /microi-progressive:chunk -->
+## 详细参考路由（渐进披露）
 
-醒目的主操作必须使用打磨过的图标加文字按钮。
+仅在当前任务涉及对应主题时读取；下列文件合计保留了原 SKILL.md 的全部详细知识。
 
-要求：
-- 登录、去登录、提交、保存、确认、接单、报修、生成报告、上传照片以及首屏主操作必须包含图标。
-- 按钮必须有可见的按下态、加载态、禁用态，并有足够触控高度。
-- 主按钮应使用项目品牌渐变或品牌纯色，阴影克制，文字对比度安全。
-- `open-type="getPhoneNumber"` 这类小程序原生按钮必须样式化为 `mci-btn`，并移除默认边框。
-
-禁止：
-- 首屏、空状态、登录页或固定底栏里出现纯文字主按钮。
-- 按钮文字没有垂直居中。
-- 异步操作按钮没有加载反馈。
-
-验收：
-- 截图检查空状态、登录页和表单提交页。
-- 确认主操作有图标、合适的加载文案和按下反馈。
-
-## 4.1 模块列表优先使用声明式业务卡片
-
-Microi.Client 的标准模块移动端不应把 PC 表格字段机械纵向堆叠。优先在
-`sys_menu.ViewSchema` 配置 `Scene=Card, Device=Mobile`：
-
-- `AvatarTextField`：头像首字或业务简称；没有头像时才显示序号。
-- `TitleField`：唯一主标题，最多两行，不能被右侧金额挤成单字列。
-- `TopFields/StatusFields`：顶部状态、分类、阶段标签，使用少量语义色。
-- `SubtitleFields`：客户、负责人、供应商等一至两项关联信息。
-- `RightFields`：金额、未付、库存等高辨识度数值，支持 `Prefix/Suffix/Tone/Color`。
-- `Fields/MetaFields`：正文和编号、创建人、日期等弱化信息。
-- `BottomFields`：联系人、跟进、合同、附件等可行动的计数或标签。
-
-要求：
-
-- 卡片内边距通常 12 至 14px，标题、弱信息、金额形成清晰三级层次；不能全卡同字号同颜色。
-- 选择框、更多、底部操作和浮动主按钮的触控区域至少 40 至 44px。
-- 选中态用边框/底色/勾选状态表达，不通过 `transform` 位移导致列表跳动。
-- 只配置字段值和样式时使用 ViewSchema；复杂 HTML 才使用字段 `V8TmpEngineTable`，仍须净化。
-- 未配置 Card 视图时兼容 `MobileListFields/CardTitleTagFields/CardBottomTagFields`，不得白屏。
-- 卡片引用字段必须进入查询列；关联计数由列表接口批量返回，禁止每张卡片再次请求。
-
-验收：
-
-- 以 375x812、390x844、430x932 至少三种视口检查长标题、空值、大金额、多标签和选中态。
-- 检查顶部/右侧/底部多字段与模板字段均能显示，滚动到底后浮动按钮不遮挡最后一张卡。
-- 批量选择后出现底部操作条；取消选择、执行按钮、更多菜单均可单手点击。
-
-## 5. 首屏文字和浮层不得重叠
-
-移动端首屏常组合大首屏区域和悬浮快捷面板。这个布局必须视觉检查，因为过大的中文标题和激进的负边距容易造成难看的换行或遮挡主按钮。
-
-要求：
-- 首屏标题必须使用能适配真实中文文案的字号，在常见 375px 和 430px 手机宽度下都要可读。
-- 两行中文标题要有足够行高；紧凑业务首屏内不要使用过大的展示字。
-- 使用悬浮快捷面板时，首屏底部要给操作区预留内边距，负边距只能轻微覆盖装饰空间。
-- 首屏主按钮必须完整可见且可点击，包括阴影和圆角底边。
-
-禁止：
-- 首屏标题换行成难看的单字或双字第二行。
-- 悬浮面板覆盖登录、报告或提交按钮。
-- 通过隐藏按钮或缩小触控区域来解决重叠。
-
-验收：
-- 在 375px 和 430px 宽度截图首屏。
-- 检查首屏标题、主/次按钮和后续悬浮面板是否裁切或重叠。
-
-## 5.1 未登录/授权提示必须在可用内容区居中
-
-未登录、未授权、无权限等提示模块不能贴在页面顶部。页面上方有 hero/header，下方有 tabBar 或固定底栏时，提示卡片和“立即登录/去授权”按钮必须在剩余可用内容区上下左右居中。
-
-要求：
-- 复用统一组件，例如 `MciAuthPrompt` / `mci-auth-prompt`，不要每个页面复制一套未登录提示样式。
-- 页面容器使用 `flex-direction: column` 时，未登录提示外层必须 `flex: 1`、`display:flex`、`align-items:center`、`justify-content:center`，并考虑底部安全区。
-- 如果组件放在自定义组件根节点内，业务页仍要提供外层居中 wrapper，避免小程序自定义组件根节点不参与父级 flex 导致卡片贴顶。
-- 未登录提示的按钮文字和图标必须在按钮内上下左右居中。
-
-禁止：
-- 未登录提示卡片紧贴 header 下方，只在横向居中、纵向不居中。
-- 因 tabBar、刘海屏、安全区或固定底栏导致提示卡片视觉中心偏上。
-
-验收：
-- 截图检查工作台、消息、我的等未登录态页面，卡片和主按钮必须在 header 与 tabBar/底栏之间的可用区域居中。
-- 375px、430px、iOS 刘海屏/灵动岛和 Android 状态栏场景均不得出现贴顶或按钮文字偏移。
-
-## 5.2 自定义导航页面必须通过安全区与微信胶囊门禁
-
-`navigationStyle: custom` 代表应用接管了系统导航区域，页面壳必须同时负责状态栏、刘海/灵动岛、微信右上角胶囊和底部手势区，不能把这一责任留给业务页面自行估算。
-
-要求：
-- 统一页面壳读取 `uni.getWindowInfo()`，旧运行时回退 `uni.getSystemInfoSync()`；顶部至少使用 `statusBarHeight`，底部使用 `safeAreaInsets.bottom` 或 `screenHeight - safeArea.bottom`。
-- CSS `env(safe-area-inset-*)` 只能作为 H5 兜底，不能作为微信小程序唯一实现。真实值应注入 `--mci-safe-top`、`--mci-safe-bottom` 等共享变量。
-- 微信小程序必须读取 `getMenuButtonBoundingClientRect()` 并为顶部栏预留胶囊右侧宽度；标题、登录、分享、状态按钮与返回按钮都不能和胶囊相交。
-- 全屏弹层或工作台的多按钮头部必须纳入同一门禁。若按钮组不能完整放在胶囊左侧，标题和按钮组整体布局到胶囊底边以下；不得让关闭按钮被原生“更多/关闭”覆盖。
-- 底部导航、fixed 提交栏、底部弹层和正文滚动区必须消费同一个底部安全变量，正文还要预留完整固定栏高度。
-- 审计 `pages.json` 的全部页面：每一个自定义导航路由都必须使用统一安全页面壳。首页通过不代表详情页、表单页、管理页已经通过。
-
-自动化验收：
-- 在微信开发者工具至少选择一台 iPhone 刘海/灵动岛机型和一台 Android 机型，逐页访问 `pages.json` 全路由并截图。
-- 断言首个可交互元素位于状态栏下方，逐个读取顶部按钮与胶囊的矩形并确认不相交，底部导航/按钮位于手势条上方，最后一条滚动内容可完整显示。
-- 发现任意页面被遮挡时，必须修复共享页面壳并重跑全路由；禁止只给当前截图页面增加固定 padding。
-
-## 5.3 全屏工具页必须遵守返回状态栈
-
-- AI 助手、扫码工作台、全屏预览等独占视口功能需要手机侧滑返回时，优先使用独立路由承载；普通 `position:fixed` 蒙层不能冒充页面历史。
-- 返回事件按“键盘/确认框 -> 内部抽屉/筛选 -> 当前全屏页 -> 底层业务页”的顺序消费。关闭按钮与手机返回手势必须得到一致结果。
-- 从 Tab 页进入后，第一次返回只能关闭全屏工具页并回到原 Tab；路由栈异常或分享直达时才兜底回首页，禁止退出小程序或跳过原页面。
-- 自动化至少覆盖关闭按钮、Android 返回键/`onBackPress`、微信侧滑返回三条路径，并验证返回后原页面和滚动状态仍然可用。
-
-## 5.4 微信浮动入口必须通过真实事件桥门禁
-
-- UniApp 自定义组件中的浮动按钮、拖拽助手和悬浮客服不得只做 H5 点击测试。必须在微信运行时找到真实组件节点，派发 `touchstart/touchend`，并断言页面栈、弹层状态或业务动作确实变化。
-- `touch* / tap` 上的 `.stop/.prevent` 会编译成 `catchtouch* / catchtap`；禁止在可拖拽组件上整组滥用。若出现“看得见但点不动”，先检查生成 WXML 是 `catch*` 还是 `bind*`，再检查事件方法与路由，不要用构建成功替代交互验收。
-- 短触与拖动应通过明确位移阈值区分。短触在 `touchend` 完成主动作，拖动只更新位置并持久化，导航失败必须给用户可见反馈。
-- 自动化需增加对照按钮：同页普通按钮可点击、浮动入口也可点击，才能确认不是自动化连接或页面整体失效。
-
-## 6. 后台菜单必须规划为至少两级
-
-真实业务系统的后台菜单不能简单堆成一批一级菜单。
-
-要求：
-- 先创建父级菜单分组，再把子级 CRUD 模块放到对应分组下。
-- 相关页面超过三个的业务模块必须有父级目录菜单。
-- 建议分组示例：
-  - 客户中心：客户、站点、联系人、客户账号绑定。
-  - 设备中心：设备台账、设备模板、维保参数。
-  - 维保运营：计划、工单、服务记录、维修申请。
-  - 报告中心：巡检报告、阅读日志、打印/分享模板。
-  - 系统配置：字典、任务、集成设置。
-- 使用 Manifest/MCP 时，必须显式包含父模块和子模块。子模块必须设置 `ParentId`。
-- dry-run 计划必须列出最终菜单树，不能只列平铺菜单名。
-- 如果用户要求通过 MCP 修复已有后台，要真正执行远端工作：读取 `sys_menu`，创建缺失的父级 `SecondMenu` 行，更新现有子菜单 `ParentId` / `Sort`，给管理员角色授权新父菜单，然后回读菜单树。
-- 当用户明确要求修改当前 MCP 租户时，不要只把规则写进 skill 就停下。
-
-禁止：
-- 把所有生成模块直接创建到根菜单。
-- 把客户主数据、工单、报告、日志和设置混在同一级。
-
-验收：
-- MCP 生成后回读 `sys_menu` 并确认菜单深度。
-- 最终回复必须说明通过 MCP 写入的真实菜单树，以及执行过的权限刷新。
-
-## 7. 移动端页面需要动效，但动效必须有用
-
-移动端产品不应像静态后台表单。
-
-要求：
-- 页面首屏、面板、卡片和重要操作区使用克制的入场动画。
-- 点击目标要有按下反馈。
-- 骨架屏应有轻微流光或脉冲。
-- 装饰动效幅度要小，不能干扰任务完成。
-- 支持时尊重减少动态效果偏好。
-
-禁止：
-- 整个应用没有交互反馈。
-- 在密集业务列表上使用重度循环动画。
-- 动效导致布局位移或文字重叠。
-
-验收：
-- 浏览器或设备检查确认卡片、面板、按钮或骨架屏有可见但克制的动效。
-- 没有动画导致横向溢出、文字裁切或固定栏抖动。
-
-## 8. 登录页必须是直接登录界面
-
-登录页不能强迫用户先在两个身份标签之间切换才能登录。
-
-要求：
-- H5/App 提供一个账号或手机号 + 密码表单。除非后端明确支持并要求第二条路径，否则不要把独立手机号客户登录表单和账号密码表单并列展示。
-- 微信小程序默认使用 `<button open-type="getPhoneNumber">` 的手机号授权登录。账号密码登录可以作为次级兜底，但必须折叠或弱化，不能和手机号授权并列成第二套完整登录系统。
-- 微信小程序手机号快捷登录必须把返回的手机号 `code` 传给后端；当后端需要 OpenId/UnionId 时，还必须调用 `uni.login()` 获取新的 `LoginCode`。
-- H5/App 兜底只有在后端支持手机号登录时才提供手动手机号输入。
-- 登录文案要清楚：账号/手机号 + 密码是一条路径；微信手机号授权是小程序默认路径。
-- 登录页不要展示当前租户、OsClient、移动端构建版本、API host、调试版本块等内部实现信息。
-
-禁止：
-- 除非用户明确要求，否则把员工/客户身份标签作为主登录模型。
-- 同屏展示两套完整登录系统，例如“账号 + 密码”和“手机号输入登录”并列。
-- 假设前端可以从 `getPhoneNumber` 直接读取微信手机号；现代微信返回的是 code。
-- 目标是微信小程序时，只把手机号登录实现成文本输入。
-- 向终端用户展示租户、版本或调试块。
-
-验收：
-- 实现前检查标准参考 `microi.uniapp/src/pages/login/index.vue`。
-- 测试账号登录路径和手机号登录按钮渲染。
-- 构建 H5 和微信小程序目标。
-
-## 9. 主题切换必须真实且全局生效
-
-当客户要求增加另一种视觉风格时，除非用户明确要求删除，否则要把当前已认可设计保留为一个命名主题，而不是直接覆盖。
-
-要求：
-- 主题命名要表达视觉意图，不要沿用临时客户措辞。例如：`清新绿红`、`品牌经典`、`专业深色`。
-- 用 `uni.setStorageSync` 或项目主题运行时持久化主题选择。
-- 如果产品有未登录也可打开的我的/个人中心/设置页，主题切换必须在登录前可用。
-- 主题切换应是紧凑的“切换主题”操作，打开弹窗或底部面板；除非页面明确是完整设置页，否则不要把所有主题选项直接堆在我的/个人中心首页。
-- 主题状态要作用到每个页面根节点、固定底部导航、空状态、骨架屏、加载过渡、按钮、卡片、报告详情和 H5 桌面手机壳。只改变当前页的主题是不完整的。
-- 小程序构建不能只依赖 `document.documentElement`；应使用页面根类、CSS 变量或跨端主题服务。
-- H5 uni-app 主题服务只能修改安全外壳：`html`、`body` 的 `data-*` 属性、主题 class 和 CSS 变量。不要通过 `querySelectorAll('.mci-page')`、`MutationObserver` 或定时扫描去改 `.mci-page`、`uni-page-body`、`uni-page`、`RouterView` 下的 Vue/uni 托管节点 class，否则容易触发 Vue 内部只读字段和空 vnode 错误。
-- 固定底部导航、固定提交栏、悬浮操作条等 fixed 组件在 H5 中优先继承 `html/body` 上的 `--mci-*` 主题变量，避免因为组件自己订阅 theme store 或动态绑定 `bottom-nav--theme` class 导致导航时重渲染。小程序端可在组件根节点绑定稳定主题 class，但不要在 H5 路由切换过程中改变 Vue 托管根节点结构。
-- 如果页面局部 scoped CSS 写死颜色，要增加主题覆盖或重构为 `--mci-*` 变量；骨架屏、加载流光、页面过渡遮罩、报告封面、英文小标题、印章/水印、摘要卡和富文本容器也必须使用主题变量。
-- H5 主题变化不能破坏 uni-app 路由补丁。如果切主题后点击导航出现 `Cannot assign to read only property '_'`、`Cannot read properties of null (reading 'type')`、`parentNode`、`scheduler flush`、`updateSlots` 等错误，必须先移除对 Vue/uni 托管节点的 DOM 改写，保持页面 class 稳定，并改用 `html/body` 变量驱动主题。
-- 底部导航必须防止重复点击当前路由、对连续点击做防抖，并在主题切换后略微延迟路由跳转，确保 DOM/主题更新先于 `uni.reLaunch` 完成。
-
-禁止：
-- 新增客户偏好主题时删除此前已认可设计。
-- 主题切换效果在导航或重启后消失。
-- 主题卡片/选项使用纯文字假图标。
-- 主题切换破坏底部导航或产生 Vue scheduler 错误。
-- 为了补主题而直接改 `.mci-page`、`uni-page-body`、`uni-page` 等运行时节点 class。
-- 只让首页和列表页换主题，详情页、骨架屏、加载过渡或报告页仍残留旧主题。
-
-验收：
-- 在未登录的我的/个人中心页切换主题，并导航到首页、登录页、列表页、详情页和表单页。
-- 确认底部导航、主按钮、卡片、空状态和页面背景都一致变化。
-- 刷新 H5 页面或重启小程序后确认已选主题恢复。
-- 对 `pages.json` 中每个路由、每个命名主题做截图验证。重点检查文字对比度，尤其是快捷卡片、报告卡片、空状态、底部导航、首屏文字和弹窗/底部面板内容。
-- 主题切换后必须额外截图或断言：底部导航容器背景、未选中项文字、选中项文字、选中图标圆底、首页快捷入口图标颜色都已经切到当前主题，而不是残留旧主题。
-- 主题切换后必须继续点击每个底部导航项，并打开至少一个详情路由（例如报告详情），断言控制台没有 `read only property '_'`、`null (reading 'type')`、`parentNode`、`scheduler flush` 等错误。
-- 骨架屏和加载过渡要在切换主题后重新触发一次；颜色、流光、遮罩和空态不能残留上一个主题。
-- 报告详情页必须逐主题截图，检查 `INSPECTION REPORT`、状态胶囊、封面标题、摘要卡、报告正文和富文本在当前主题下都有足够对比度。
-
-## 10. 报告/列表详情必须保留用户身份
-
-从列表进入详情时必须保留调用者身份模型。即使打开的是同一个视觉报告详情页，员工、客户和公开/分享路线也可能需要不同接口。
-
-要求：
-- 如果员工通过已鉴权 FormEngine 或后台账号接口能看到报告列表，报告详情必须使用同样的员工鉴权路径或传有效员工 token。
-- 客户打开报告时，使用客户 token 或感知绑定关系的接口引擎。
-- 外部用户打开分享报告时，使用分享 token 路由，不要求员工/客户登录。
-- 不要给员工用户发送空 `CustomerToken`，然后把后端响应解释为“未登录”。
-- 打开详情页前保留当前会话；除非员工鉴权端点真实返回登录过期码，否则不要清除员工 token。
-
-禁止：
-- 员工列表点击时，直接复用客户匿名报告详情引擎且没有员工凭证路径。
-- 登录用户点击已经可见的报告/列表项后被重定向到登录页。
-
-验收：
-- 分别测试员工列表 -> 报告详情、客户列表 -> 报告详情、分享 token 详情。
-- 确认点击可见卡片后不会发生意外登录跳转。
-
-## 11. 角色与权限必须基于 sys_user.RoleIds 建模
-
-移动端和后台不能只区分“已登录/未登录”。企业应用通常至少有内部员工、售后师傅、客服、客户账号等角色，必须在建模阶段明确角色、菜单权限和数据权限。
-
-要求：
-- 内部账号统一使用 `sys_user` 登录，身份可从 `RoleIds`、`_Roles`、`Roles`、`RoleName` 和 `Level` 推导展示能力；只有服务端已确认的 `Level>=9999` 才视为平台超级管理员。角色名和前端 `_IsAdmin` 不能代替接口授权。
-- 角色能力要在统一 session/capability store 中计算，例如 `isTechnician`、`isServiceAgent`、`isCustomerAccount`、`canAcceptOrders`、`canManageCustomers`、`canViewReports`。一个人有多个角色时取能力并集。
-- 客户账号角色要精确判断，不能把“客户管理”这类内部后台角色误判为客户账号。建议只把“客户”“客户账号”“客户用户”或明确包含“客户账号”的角色当作客户侧账号。
-- 后台通过 `sys_role` + `sys_rolelimit` 建角色和菜单权限。售后师傅通常能看维保计划、工单、维保记录、报修和检测报告；客服通常能看客户中心、工单、报修、报告和资讯；客户账号默认不直接授予后台菜单，客户侧数据通过绑定关系和接口数据过滤提供。
-- 移动端按钮和数据必须按 capability 控制：接单按钮只给售后师傅/超级管理员，客户资料管理只给客服/超级管理员，客户账号只能看自己绑定客户的数据。
-- 菜单权限只是粗粒度入口控制，接口引擎和 FormEngine 查询仍必须按角色、`V8.CurrentUser`、客户绑定关系做行级过滤。
-- 微信小程序手机号授权登录后，如果当前 OpenId/小程序用户还没有绑定客户或内部 `sys_user` 身份，移动端不能只显示“联系管理员”。必须提供“申请绑定身份”入口，允许用户申请绑定客户、售后师傅或客服等角色，并把申请写入独立审核表；后台审核通过后才写客户绑定表或 `Sys_User.MiniProgramOpenId` 等正式身份字段。
-- 身份绑定申请必须显示审核状态：待审核、已通过、已驳回。待审核期间不要提前开放客户数据、接单、工单处理等能力；已驳回要展示原因或允许重新提交。
-- 后台审核必须由有权限的内部账号执行。审核客户申请时应由后台选择真实客户 Id 后再写绑定关系，不能只相信用户填写的客户名称；审核售后师傅/客服申请时应由后台选择真实 `sys_user.Id` 后再绑定 OpenId。
-- 使用 MCP 建角色前先回读 `sys_role` 和 `sys_menu`。如果 `microi_save_role` 或通用 `add_form_data('sys_role')` 因 `UpdateTime cannot be null` 等系统字段问题失败，要使用平台修复后的专用角色工具；临时迁移可用一次性接口引擎和参数化 `V8.Db` 补建角色，但必须回读验证并删除或禁用临时入口。
-
-禁止：
-- 只做前端显示区分，后台角色和菜单权限不落库。
-- 把客户账号当作普通后台用户直接开放客户、报告、工单全量菜单。
-- 客户授权手机号登录后没有绑定关系时，只提示“联系管理员”，却没有申请、审核、状态回显闭环。
-- 审核绑定时只按用户填写的客户名或姓名自动匹配，未由后台确认真实 `CustomerId` / `Sys_User.Id`。
-- 多角色用户只按第一个角色判断，导致能力丢失。
-- 登录状态、角色文本和页面权限由多个页面各自读取缓存，造成互相矛盾。
-
-验收：
-- 用超级管理员、售后师傅、客服、客户账号分别登录截图，确认姓名、角色、按钮和数据范围一致。
-- 用多角色账号登录，确认能力取并集。
-- 回读 `sys_role`、`sys_rolelimit`、关键接口返回数据，确认角色存在、菜单授权正确、客户数据没有越权。
-- 使用真实账号登录后刷新 H5 或重启小程序，不能出现缓存用户名但状态未登录的半登录状态。
-- 用未绑定的小程序手机号账号登录，截图确认“我的”页出现申请绑定身份入口；提交申请后后台能看到待审核记录；通过审核前数据权限不提前开放，通过审核后对应客户数据或内部工作台能力才出现。
-
-## 最终交付清单
-
-移动端项目标记完成前必须确认：
-- 图标：底部导航、首页快捷入口、个人中心快捷项、主按钮。
-- 登录：H5/App 只有一条账号/手机号 + 密码路径；微信手机号授权是小程序默认路径；没有并列重复登录系统，没有租户/版本/调试块；SDK 接口已核验。
-- 登录状态：成功登录必须同时有 token 和用户 `Id`；刷新、切换导航和进入“我的”页后，不得出现缓存用户名但仍提示未登录。
-- 按钮：图标 + 文字、按下态、加载态。
-- 菜单：后台规划为至少两级树。
-- 请求头：`osclient` 是唯一标准请求头值，没有因大小写重复。
-- 未登录态：授权/登录提示卡片和主按钮在可用内容区上下左右居中，不贴顶部。
-- 首屏：首屏文字和悬浮快捷面板已截图检查，无裁切或重叠。
-- 动效：入场、点击、骨架屏动画存在且克制。
-- 主题：命名主题可持久化，未登录可切换，并影响所有页面和底部导航。
-- 主题质检：每个 `pages.json` 路由在每个命名主题下都截图检查；切换主题再导航后，没有低对比文字，也没有 Vue scheduler/router 错误。
-- 图标对比：首页快捷入口、底部导航、我的快捷入口在每个主题下都清晰可见；不得出现绿色圆底配绿色图标、灰色圆底配低对比图标等情况。
-- 鉴权质检：列表到详情路由保留员工/客户/分享身份，不会把已可见项目重定向回登录页。
-- 分享：`pages.json` 中每个页面都已注册好友转发和朋友圈生命周期；登录/受保护页面也可分享，接收者进入后再鉴权。
-- 登录诊断：体验版手机号登录失败时显示阶段、原因和追踪号；后台系统日志可按追踪号查到脱敏错误上下文。
-- 角色权限：`sys_user.RoleIds`、`sys_role`、`sys_rolelimit`、前端 capability 和接口行级过滤已联动验证。
-- 验证：脚本存在时运行 `build:h5`、`build:mp-weixin` 和 `build:app`；执行 H5 路由冒烟测试和控制台检查。
+- [references/progressive-01-4-重要按钮必须带图标.md](references/progressive-01-4-重要按钮必须带图标.md)：4. 重要按钮必须带图标；4.1 模块列表优先使用声明式业务卡片；5. 首屏文字和浮层不得重叠；5.1 未登录/授权提示必须在可用内容区居中；5.2 自定义导航页面必须通过安全区与微信胶囊门禁；5.3 全屏工具页必须遵守返回状态栈；5.4 微信浮动入口必须通过真实事件桥门禁；6. 后台菜单必须规划为至少两级；7. 移动端页面需要动效，但动效必须有用；8. 登录页必须是直接登录界面
+- [references/progressive-02-9-主题切换必须真实且全局生效.md](references/progressive-02-9-主题切换必须真实且全局生效.md)：9. 主题切换必须真实且全局生效；10. 报告/列表详情必须保留用户身份；11. 角色与权限必须基于 sys_user.RoleIds 建模；最终交付清单
+<!-- microi-progressive:end -->

package/skills/microi-mobile-app-quality/references/progressive-01-4-/351/207/215/350/246/201/346/214/211/351/222/256/345/277/205/351/241/273/345/270/246/345/233/276/346/240/207.md

@@ -0,0 +1,209 @@
+# microi-mobile-app-quality 详细参考 1
+
+> 按需读取；本文件由 SKILL.md 的原章节无损拆分。
+
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-008 sha256=765335189d85b558ad29ba73c04d1cf078101ee94819f969195b50440a82106f -->
+## 4. 重要按钮必须带图标
+
+醒目的主操作必须使用打磨过的图标加文字按钮。
+
+要求：
+- 登录、去登录、提交、保存、确认、接单、报修、生成报告、上传照片以及首屏主操作必须包含图标。
+- 按钮必须有可见的按下态、加载态、禁用态，并有足够触控高度。
+- 主按钮应使用项目品牌渐变或品牌纯色，阴影克制，文字对比度安全。
+- `open-type="getPhoneNumber"` 这类小程序原生按钮必须样式化为 `mci-btn`，并移除默认边框。
+
+禁止：
+- 首屏、空状态、登录页或固定底栏里出现纯文字主按钮。
+- 按钮文字没有垂直居中。
+- 异步操作按钮没有加载反馈。
+
+验收：
+- 截图检查空状态、登录页和表单提交页。
+- 确认主操作有图标、合适的加载文案和按下反馈。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-009 sha256=e3c66bd92ca059235a7a3b0ece2fdfa598a41eaa149d0ee3a0d24d0d822a9f58 -->
+## 4.1 模块列表优先使用声明式业务卡片
+
+Microi.Client 的标准模块移动端不应把 PC 表格字段机械纵向堆叠。优先在
+`sys_menu.ViewSchema` 配置 `Scene=Card, Device=Mobile`：
+
+- `AvatarTextField`：头像首字或业务简称；没有头像时才显示序号。
+- `TitleField`：唯一主标题，最多两行，不能被右侧金额挤成单字列。
+- `TopFields/StatusFields`：顶部状态、分类、阶段标签，使用少量语义色。
+- `SubtitleFields`：客户、负责人、供应商等一至两项关联信息。
+- `RightFields`：金额、未付、库存等高辨识度数值，支持 `Prefix/Suffix/Tone/Color`。
+- `Fields/MetaFields`：正文和编号、创建人、日期等弱化信息。
+- `BottomFields`：联系人、跟进、合同、附件等可行动的计数或标签。
+
+要求：
+
+- 卡片内边距通常 12 至 14px，标题、弱信息、金额形成清晰三级层次；不能全卡同字号同颜色。
+- 选择框、更多、底部操作和浮动主按钮的触控区域至少 40 至 44px。
+- 选中态用边框/底色/勾选状态表达，不通过 `transform` 位移导致列表跳动。
+- 只配置字段值和样式时使用 ViewSchema；复杂 HTML 才使用字段 `V8TmpEngineTable`，仍须净化。
+- 未配置 Card 视图时兼容 `MobileListFields/CardTitleTagFields/CardBottomTagFields`，不得白屏。
+- 卡片引用字段必须进入查询列；关联计数由列表接口批量返回，禁止每张卡片再次请求。
+
+验收：
+
+- 以 375x812、390x844、430x932 至少三种视口检查长标题、空值、大金额、多标签和选中态。
+- 检查顶部/右侧/底部多字段与模板字段均能显示，滚动到底后浮动按钮不遮挡最后一张卡。
+- 批量选择后出现底部操作条；取消选择、执行按钮、更多菜单均可单手点击。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-010 sha256=2ddd560cf3620f8fb7f3cf64d62566206430ee14e6ac380a3023c5b9047b4f46 -->
+## 5. 首屏文字和浮层不得重叠
+
+移动端首屏常组合大首屏区域和悬浮快捷面板。这个布局必须视觉检查，因为过大的中文标题和激进的负边距容易造成难看的换行或遮挡主按钮。
+
+要求：
+- 首屏标题必须使用能适配真实中文文案的字号，在常见 375px 和 430px 手机宽度下都要可读。
+- 两行中文标题要有足够行高；紧凑业务首屏内不要使用过大的展示字。
+- 使用悬浮快捷面板时，首屏底部要给操作区预留内边距，负边距只能轻微覆盖装饰空间。
+- 首屏主按钮必须完整可见且可点击，包括阴影和圆角底边。
+
+禁止：
+- 首屏标题换行成难看的单字或双字第二行。
+- 悬浮面板覆盖登录、报告或提交按钮。
+- 通过隐藏按钮或缩小触控区域来解决重叠。
+
+验收：
+- 在 375px 和 430px 宽度截图首屏。
+- 检查首屏标题、主/次按钮和后续悬浮面板是否裁切或重叠。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-011 sha256=b599e047e6b7a3688e4264a4d4b334e220e9798cbc13326e85a06f52bf20ce12 -->
+## 5.1 未登录/授权提示必须在可用内容区居中
+
+未登录、未授权、无权限等提示模块不能贴在页面顶部。页面上方有 hero/header，下方有 tabBar 或固定底栏时，提示卡片和“立即登录/去授权”按钮必须在剩余可用内容区上下左右居中。
+
+要求：
+- 复用统一组件，例如 `MciAuthPrompt` / `mci-auth-prompt`，不要每个页面复制一套未登录提示样式。
+- 页面容器使用 `flex-direction: column` 时，未登录提示外层必须 `flex: 1`、`display:flex`、`align-items:center`、`justify-content:center`，并考虑底部安全区。
+- 如果组件放在自定义组件根节点内，业务页仍要提供外层居中 wrapper，避免小程序自定义组件根节点不参与父级 flex 导致卡片贴顶。
+- 未登录提示的按钮文字和图标必须在按钮内上下左右居中。
+
+禁止：
+- 未登录提示卡片紧贴 header 下方，只在横向居中、纵向不居中。
+- 因 tabBar、刘海屏、安全区或固定底栏导致提示卡片视觉中心偏上。
+
+验收：
+- 截图检查工作台、消息、我的等未登录态页面，卡片和主按钮必须在 header 与 tabBar/底栏之间的可用区域居中。
+- 375px、430px、iOS 刘海屏/灵动岛和 Android 状态栏场景均不得出现贴顶或按钮文字偏移。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-012 sha256=a363aaead9b632f3533e2f046f39cf7b579a91b92ef4e33d42f848d5a7538515 -->
+## 5.2 自定义导航页面必须通过安全区与微信胶囊门禁
+
+`navigationStyle: custom` 代表应用接管了系统导航区域，页面壳必须同时负责状态栏、刘海/灵动岛、微信右上角胶囊和底部手势区，不能把这一责任留给业务页面自行估算。
+
+要求：
+- 统一页面壳读取 `uni.getWindowInfo()`，旧运行时回退 `uni.getSystemInfoSync()`；顶部至少使用 `statusBarHeight`，底部使用 `safeAreaInsets.bottom` 或 `screenHeight - safeArea.bottom`。
+- CSS `env(safe-area-inset-*)` 只能作为 H5 兜底，不能作为微信小程序唯一实现。真实值应注入 `--mci-safe-top`、`--mci-safe-bottom` 等共享变量。
+- 微信小程序必须读取 `getMenuButtonBoundingClientRect()` 并为顶部栏预留胶囊右侧宽度；标题、登录、分享、状态按钮与返回按钮都不能和胶囊相交。
+- 全屏弹层或工作台的多按钮头部必须纳入同一门禁。若按钮组不能完整放在胶囊左侧，标题和按钮组整体布局到胶囊底边以下；不得让关闭按钮被原生“更多/关闭”覆盖。
+- 底部导航、fixed 提交栏、底部弹层和正文滚动区必须消费同一个底部安全变量，正文还要预留完整固定栏高度。
+- 审计 `pages.json` 的全部页面：每一个自定义导航路由都必须使用统一安全页面壳。首页通过不代表详情页、表单页、管理页已经通过。
+
+自动化验收：
+- 在微信开发者工具至少选择一台 iPhone 刘海/灵动岛机型和一台 Android 机型，逐页访问 `pages.json` 全路由并截图。
+- 断言首个可交互元素位于状态栏下方，逐个读取顶部按钮与胶囊的矩形并确认不相交，底部导航/按钮位于手势条上方，最后一条滚动内容可完整显示。
+- 发现任意页面被遮挡时，必须修复共享页面壳并重跑全路由；禁止只给当前截图页面增加固定 padding。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-013 sha256=207765d0398738f24566763a2481469f4fc63e8a0b5f00abd292fe8a1cdd225a -->
+## 5.3 全屏工具页必须遵守返回状态栈
+
+- AI 助手、扫码工作台、全屏预览等独占视口功能需要手机侧滑返回时，优先使用独立路由承载；普通 `position:fixed` 蒙层不能冒充页面历史。
+- 返回事件按“键盘/确认框 -> 内部抽屉/筛选 -> 当前全屏页 -> 底层业务页”的顺序消费。关闭按钮与手机返回手势必须得到一致结果。
+- 从 Tab 页进入后，第一次返回只能关闭全屏工具页并回到原 Tab；路由栈异常或分享直达时才兜底回首页，禁止退出小程序或跳过原页面。
+- 自动化至少覆盖关闭按钮、Android 返回键/`onBackPress`、微信侧滑返回三条路径，并验证返回后原页面和滚动状态仍然可用。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-014 sha256=1451e6ffbb0c0d29d8362e400540e3fa4f9f38a2402a9faf93de4cce7b1c9b4c -->
+## 5.4 微信浮动入口必须通过真实事件桥门禁
+
+- UniApp 自定义组件中的浮动按钮、拖拽助手和悬浮客服不得只做 H5 点击测试。必须在微信运行时找到真实组件节点，派发 `touchstart/touchend`，并断言页面栈、弹层状态或业务动作确实变化。
+- `touch* / tap` 上的 `.stop/.prevent` 会编译成 `catchtouch* / catchtap`；禁止在可拖拽组件上整组滥用。若出现“看得见但点不动”，先检查生成 WXML 是 `catch*` 还是 `bind*`，再检查事件方法与路由，不要用构建成功替代交互验收。
+- 短触与拖动应通过明确位移阈值区分。短触在 `touchend` 完成主动作，拖动只更新位置并持久化，导航失败必须给用户可见反馈。
+- 自动化需增加对照按钮：同页普通按钮可点击、浮动入口也可点击，才能确认不是自动化连接或页面整体失效。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-015 sha256=8377f92a7456bd68e83867e893f1c9e8eec9edf0bba2a3f434c5bce75a9e2d00 -->
+## 6. 后台菜单必须规划为至少两级
+
+真实业务系统的后台菜单不能简单堆成一批一级菜单。
+
+要求：
+- 先创建父级菜单分组，再把子级 CRUD 模块放到对应分组下。
+- 相关页面超过三个的业务模块必须有父级目录菜单。
+- 建议分组示例：
+  - 客户中心：客户、站点、联系人、客户账号绑定。
+  - 设备中心：设备台账、设备模板、维保参数。
+  - 维保运营：计划、工单、服务记录、维修申请。
+  - 报告中心：巡检报告、阅读日志、打印/分享模板。
+  - 系统配置：字典、任务、集成设置。
+- 使用 Manifest/MCP 时，必须显式包含父模块和子模块。子模块必须设置 `ParentId`。
+- dry-run 计划必须列出最终菜单树，不能只列平铺菜单名。
+- 如果用户要求通过 MCP 修复已有后台，要真正执行远端工作：读取 `sys_menu`，创建缺失的父级 `SecondMenu` 行，更新现有子菜单 `ParentId` / `Sort`，给管理员角色授权新父菜单，然后回读菜单树。
+- 当用户明确要求修改当前 MCP 租户时，不要只把规则写进 skill 就停下。
+
+禁止：
+- 把所有生成模块直接创建到根菜单。
+- 把客户主数据、工单、报告、日志和设置混在同一级。
+
+验收：
+- MCP 生成后回读 `sys_menu` 并确认菜单深度。
+- 最终回复必须说明通过 MCP 写入的真实菜单树，以及执行过的权限刷新。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-016 sha256=0c1632d28f986156f8d70b2710dc0219de4643b4b9c61771ac544a18f4c355ac -->
+## 7. 移动端页面需要动效，但动效必须有用
+
+移动端产品不应像静态后台表单。
+
+要求：
+- 页面首屏、面板、卡片和重要操作区使用克制的入场动画。
+- 点击目标要有按下反馈。
+- 骨架屏应有轻微流光或脉冲。
+- 装饰动效幅度要小，不能干扰任务完成。
+- 支持时尊重减少动态效果偏好。
+
+禁止：
+- 整个应用没有交互反馈。
+- 在密集业务列表上使用重度循环动画。
+- 动效导致布局位移或文字重叠。
+
+验收：
+- 浏览器或设备检查确认卡片、面板、按钮或骨架屏有可见但克制的动效。
+- 没有动画导致横向溢出、文字裁切或固定栏抖动。
+
+<!-- /microi-progressive:chunk -->
+<!-- microi-progressive:chunk id=microi-mobile-app-quality-017 sha256=2dcca5305da25f543181ae23550547cb3e3761aebae2843c5fc60e7848153176 -->
+## 8. 登录页必须是直接登录界面
+
+登录页不能强迫用户先在两个身份标签之间切换才能登录。
+
+要求：
+- H5/App 提供一个账号或手机号 + 密码表单。除非后端明确支持并要求第二条路径，否则不要把独立手机号客户登录表单和账号密码表单并列展示。
+- 微信小程序默认使用 `<button open-type="getPhoneNumber">` 的手机号授权登录。账号密码登录可以作为次级兜底，但必须折叠或弱化，不能和手机号授权并列成第二套完整登录系统。
+- 微信小程序手机号快捷登录必须把返回的手机号 `code` 传给后端；当后端需要 OpenId/UnionId 时，还必须调用 `uni.login()` 获取新的 `LoginCode`。
+- H5/App 兜底只有在后端支持手机号登录时才提供手动手机号输入。
+- 登录文案要清楚：账号/手机号 + 密码是一条路径；微信手机号授权是小程序默认路径。
+- 登录页不要展示当前租户、OsClient、移动端构建版本、API host、调试版本块等内部实现信息。
+
+禁止：
+- 除非用户明确要求，否则把员工/客户身份标签作为主登录模型。
+- 同屏展示两套完整登录系统，例如“账号 + 密码”和“手机号输入登录”并列。
+- 假设前端可以从 `getPhoneNumber` 直接读取微信手机号；现代微信返回的是 code。
+- 目标是微信小程序时，只把手机号登录实现成文本输入。
+- 向终端用户展示租户、版本或调试块。
+
+验收：
+- 实现前检查标准参考 `microi.uniapp/src/pages/login/index.vue`。
+- 测试账号登录路径和手机号登录按钮渲染。
+- 构建 H5 和微信小程序目标。
+
+<!-- /microi-progressive:chunk -->