# G 模块旗舰级连续长背景候选 Implementation Plan

> **For agentic workers:** 当前主代理内联执行；用户明确禁止多代理、worktree、git add、commit、push、reset 和 checkout。

**Goal:** 基于现有 C 方向生成连续长背景候选；用户确认后，将其固化为 1536×3840 母版、生成 1440×3600 运行图并接入共享组件。

**Architecture:** 使用内置 ImageGen 编辑现有 C 母版，生成完整不透明长图。候选先存入 `design-pipeline/generated/g01-background/`；用户确认后保留原稿，以锁定 Pillow/Lanczos 归一化母版并生成版本化运行图，由 `GenealogyPageBackground.vue` 单一接入。

**Tech Stack:** Built-in ImageGen、Pillow 12.3.0、现有 G01 资产流水线。

## Global Constraints

- 候选确认前不替换运行资产或页面引用；用户确认后只切换共享组件，不改 9 个页面业务结构。
- 目标母版 1536×3840，运行方向 1440×3600。
- 无文字、Logo、UI、卡片、红色、接缝和重复图案。
- 不删除、覆盖或清理现有母版、候选、截图和未跟踪文件。

---

### Task 1: 生成长图候选

**Files:**
- Read: `docs/design/assets/g01-background/masters/g01-list-background-direction-c-paper-master.png`
- Create: `design-pipeline/generated/g01-background/genealogy-page-background-long-flagship-candidate.png`

**Interfaces:**
- Consumes: C 母版的宣纸色、竹影、水墨山水、亭台和中央低对比构图。
- Produces: 一张未接入页面的长图候选 PNG。

- [x] **Step 1: 查看 C 母版并作为 ImageGen 编辑目标**

确认输入图无文字、无 UI，保持其暖宣纸和灰金水墨语言。

- [x] **Step 2: 使用内置 ImageGen 生成 2.5:1 候选**

提示中明确 2.5:1 连续纵向构图、顶部安全留白、中部低对比、下部山水、无接缝和禁止元素。

- [x] **Step 3: 将生成结果复制到被忽略的候选路径**

不覆盖现有 A/B/C 母版或 `genealogy-page-background.png`。

### Task 2: 候选验证与展示

**Files:**
- Inspect: `design-pipeline/generated/g01-background/genealogy-page-background-long-flagship-candidate.png`

**Interfaces:**
- Consumes: ImageGen 候选。
- Produces: 实际尺寸、文件字节数、SHA-256 和视觉检查结果。

- [x] **Step 1: 用 Pillow 检查尺寸、模式和边缘连续性**

确认不透明 RGB/RGBA、实际像素尺寸及没有异常透明边。

- [x] **Step 2: 打开候选检查视觉**

检查文字／Logo 污染、明显横向色带、重复竹枝、中央过密和亭台位置。

- [x] **Step 3: 向用户展示候选**

只报告候选事实，不宣称已接入、已验收或已完成 Android 验证。

### Task 3: 用户确认后的正式接入

- [x] 保留 793×1983 ImageGen 原稿，并生成 1536×3840 sRGB 归一化母版。
- [x] 先新增失败契约，再扩展 manifest、Python 构建器和 Node 包装器为四候选。
- [x] 生成 1440×3600 版本化运行图，更新共享背景组件；旧 C 文件不覆盖、不删除。
- [x] 完成 G01 五档 H5 截图、G 页面运行 smoke、Python/Node/PowerShell 契约和内部设计 QA。
- [ ] Android/HBuilderX 与 4GB Android 图片解码、切页、回收复核。
- [ ] G01 固定区／独立滚动结构继续与用户讨论，不在本次背景接入中擅自实施。