# 模块基准页加速视觉审核设计 ## 目标 今晚完成剩余活动页面的 H5 浅色国风视觉统一与用户审核，不再逐页逐状态实时展示。Android/HBuilderX、真实接口、真机性能和业务功能继续明确保留为未完成项。 ## 已确认基准 - A：现有 A 系列成果保持不变，本轮不返工。 - G：G01“我的家谱”已经完成全部适用状态与五档尺寸审核，作为 G 模块基准。 - T：T07“成员目录”作为常规页面基准。 - F：F01“家族动态”作为模块基准。 - R：R01“人物录”作为模块基准。 - N：N01“消息中心”作为模块基准。 - M：M01“我的”作为模块基准。 候选选择依据记录在： `docs/design/screens/runtime/2026-07-19/module-baseline-audit/audit.md` ## 执行顺序 1. 完整审核并完善 T07，确定 T 模块的标题、背景、搜索、列表、卡片、字体、间距和状态标准。 2. 完整审核并完善 F01，确定 F 模块基准。 3. 完整审核并完善 R01，确定 R 模块基准。 4. 完整审核并完善 N01，确定 N 模块基准。 5. 完整审核并完善 M01，确定 M 模块基准。 6. 五个新增基准页全部通过后，再完善 T01 世系树。T01 是特殊结构页，保留树画布、世代关系和成员操作结构，只继承 T07 的视觉令牌与公共状态组件。 7. T01 通过后，批量处理剩余页面。 8. 普通页面按以下顺序推进： - 按 G01 统一 G03、G05、G06、G08、G09、G10、G11、G12。 - 按 T07 统一 T03、T04、T05、T06、T08。 - 按 F01 统一 F02–F10。 - 按 R01 统一 R02–R11。 - 按 N01 统一 N02。 - 按 M01 统一 M02–M10。 ## 基准页负责的内容 每个模块基准页拥有该模块的： - 长背景与内容层透明度关系。 - 页面标题栏、返回入口和右侧操作。 - 主标题、说明文字、状态文字和正文的字号、字重与颜色。 - 页面水平边距、模块间距、卡片间距和底部安全区。 - 常规卡片、列表行、筛选／搜索区和主要操作的视觉语言。 基准页不拥有其他页面的业务结构。列表、表单、详情、设置、时间轴、树画布和编辑器继续保留各自适合任务的内容组织方式。 ## 全局组件规则 以下内容不随模块重新设计，统一使用已经建立的项目自定义组件和 A／G01 已确认标准： - `AppButton` - `AppDialog` - `AppToast` - `AppLoading` - 空态、失败态、无权限态的标题层级和恢复动作 禁止重新引入原生 Toast、Modal、Loading 或 ActionSheet。弹层允许根据内容伸缩，但必须沿用项目已经确认的宣纸、朱砂、古金与关闭图标体系。 ## 批量审核方式 - 基准页与 T01：仍由用户逐个查看关键状态和代表尺寸，明确通过后才能成为推广标准。 - 普通推广页：自动运行已有静态合同和 Chrome 运行检查，覆盖默认状态、适用关键状态、四档尺寸、横向溢出和基础交互。 - 每个模块生成一张联系表，包含全部页面的默认态和有视觉差异的关键状态。 - 用户按模块审核联系表；没有问题则整批通过，只有异常页才单独打开返工。 - 不使用单张默认态代替状态检查；联系表背后必须有真实渲染和自动验证证据。 ## 特殊页面与例外 - T01：树画布特殊页，不能机械套用 T07 列表 DOM。 - T03：必须从带成员上下文的入口或受控参数进入，不能把直达失败态当作默认态。 - 带 `⚠` 的无真实入口页面：可以按模块基准完成视觉候选，但必须继续标注流程入口缺口，不能宣称真实流程通过。 - 公共 `ModulePage` 当前存在页面介绍与面板标题重复的问题；推广时应消除重复层级，不把重复标题固化为基准。 ## 通过条件 页面或模块批次只有同时满足以下条件才能记为 H5 视觉通过： - 与所属模块基准一致，且保留自身任务结构。 - 适用状态完整，没有加载、空、失败、无权限或业务状态的明显断层。 - 320×568、360×640、360×800、412×915 无横向溢出、裁切、遮挡或不可达操作。 - 自定义弹层和反馈组件使用正确。 - 聚焦合同、运行检查和 `git diff --check` 通过；不放宽阈值换取绿灯。 - 用户通过基准页或模块联系表给出明确结论。 ## 明确不在本轮完成范围 - 真实接口与数据持久化。 - Android/HBuilderX 真机或模拟器验证。 - 4GB Android 长背景解码、切页与内存回收。 - 系统字体放大、读屏和真实软键盘。 - 无入口页面的产品入口补全，除非用户另行授权进入功能流程设计。