# 全模块长背景与 A 系列控件交接

## 当前决定

- A 系列现有按钮、弹窗、Toast 和对话框视觉已经由用户确认，作为全局唯一标准。
- G01 是 G 系列风格母体；9 个活动 G 页面继续共用 `GenealogyPageBackground.vue` 与既定 G01 长背景。
- T、F、R、N、M 各自保留模块性格，但共享浅色国风、楷体、宣纸、朱砂、古金与 A 系列控件。
- 本轮按用户要求不生成新的运行截图；页面仍需用户逐页审核和 Android/HBuilderX 复核。

## 公共组件

- `components/AppButton.vue`：A 系列主／次卷轴按钮。
- `components/AppDialog.vue`：A 系列单／双按钮卷轴对话框。
- `components/AppToast.vue`：A 系列卷轴轻提示。
- `components/AppLoading.vue`：项目自定义水墨加载。
- `components/PageHeader.vue`：普通页使用真实返回箭头，根页保留品牌头部。
- `components/ModulePageBackground.vue`：T、F、R、N、M 背景唯一映射入口。

## 可恢复输入与运行资产

| 模块 | ImageGen 原始输入 | APP 运行资产 | SHA-256 |
| --- | --- | --- | --- |
| T | `tree-page-background-imagegen-source.png` | `static/assets/modules/tree/opaque/tree-page-background-long.png` | `b4322e6d8294c1e30d03baa005aa77122dd49257504da2462db74bfe79e44b37` |
| F | `family-page-background-imagegen-source.png` | `static/assets/modules/family/opaque/family-page-background-long.png` | `9c65aa0526d392e6d03e6c0216e9f5f9f9f917aa539e15c045283195882b5fec` |
| R | `records-page-background-imagegen-source.png` | `static/assets/modules/records/opaque/records-page-background-long.png` | `a420ac3791acc13e25ae68f68782e07754c0040b7f9fbde037bf1588f2ff7007` |
| N | `notification-page-background-imagegen-source.png` | `static/assets/modules/notification/opaque/notification-page-background-long.png` | `7f707153f6ecf53183fc360e6a34b4312975babeb5ccb3f36e048f1f64c65ca5` |
| M | `profile-page-background-imagegen-source.png` | `static/assets/modules/profile/opaque/profile-page-background-long.png` | `c5adb199e5773582775f9f0bab1fef62e0948755c9f22aca647d236f8d4ef8b8` |

所有原始输入位于 `docs/design/assets/module-backgrounds/masters/`；运行资产统一为 `1440×3600` RGB PNG。

## 换机重建

```powershell
design-pipeline/.venv/Scripts/python.exe design-pipeline/scripts/build_module_page_backgrounds.py
powershell -NoProfile -ExecutionPolicy Bypass -File tests/global-heritage-visual-system-contract.ps1
```

清单：`design-pipeline/manifests/module-page-backgrounds.json`。

## 验证边界

- 当前静态合同和无截图 H5 运行 smoke 已覆盖主要页面状态、按钮事件、导航与自定义弹层。
- 尚未完成 Android/HBuilderX 字体、状态栏、返回手势、软键盘与不同面板亮度复核。
- 五张 `1440×3600` 图片在 4GB Android 上的解码、切页与回收仍需专项检查。
- 当前仅为全线基础样式候选，不表示 52 页已由用户正式验收或冻结。