4.6 KiB
4.6 KiB
模块基准页加速视觉审核设计
目标
今晚完成剩余活动页面的 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
执行顺序
- 完整审核并完善 T07，确定 T 模块的标题、背景、搜索、列表、卡片、字体、间距和状态标准。
- 完整审核并完善 F01，确定 F 模块基准。
- 完整审核并完善 R01，确定 R 模块基准。
- 完整审核并完善 N01，确定 N 模块基准。
- 完整审核并完善 M01，确定 M 模块基准。
- 五个新增基准页全部通过后，再完善 T01 世系树。T01 是特殊结构页，保留树画布、世代关系和成员操作结构，只继承 T07 的视觉令牌与公共状态组件。
- T01 通过后，批量处理剩余页面。
- 普通页面按以下顺序推进：
- 按 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 已确认标准：
AppButtonAppDialogAppToastAppLoading- 空态、失败态、无权限态的标题层级和恢复动作
禁止重新引入原生 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 长背景解码、切页与内存回收。
- 系统字体放大、读屏和真实软键盘。
- 无入口页面的产品入口补全，除非用户另行授权进入功能流程设计。