jiapuapp/docs/superpowers/plans/2026-07-16-genealogy-flagship-long-background-candidate.md

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。

• Step 1: 查看 C 母版并作为 ImageGen 编辑目标

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

• Step 2: 使用内置 ImageGen 生成 2.5:1 候选

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

• 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 和视觉检查结果。

• Step 1: 用 Pillow 检查尺寸、模式和边缘连续性

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

• Step 2: 打开候选检查视觉

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

• Step 3: 向用户展示候选

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

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

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