Review changes batch 6 of 6

2026-07-20 06:52:33 +08:00
parent db97d3da27
commit 5a31a75da0
160 changed files with 9206 additions and 572 deletions
@@ -0,0 +1,94 @@
+# 模块基准页加速视觉审核设计
+
+## 目标
+
+今晚完成剩余活动页面的 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 长背景解码、切页与内存回收。
+- 系统字体放大、读屏和真实软键盘。
+- 无入口页面的产品入口补全，除非用户另行授权进入功能流程设计。