jiapuapp/docs/superpowers/plans/2026-07-16-g01-list-background-assets.md

G01 List Background Assets Implementation Plan

For agentic workers: 当前会话内执行；禁止 worktree、多代理和任何 Git 写操作。

Goal: 保存三个 G01 背景母版，并建立可在另一台电脑确定性重建候选输出的 Python＋Node 流水线。

Architecture: ImageGen 输出作为受控母版；候选清单是生成提示、源路径和处理模式的唯一所有者。Python 进行像素处理，Node 校验路径并编排，生成结果只进入可再生的忽略目录。

Tech Stack: Node.js 22+、Python 3、Pillow 12.3.0、JSON、PNG。

Global Constraints

• 不修改 G01 页面滚动结构或运行资产引用。
• 不覆盖现有 footer-mountain-bamboo.png。
• 不把候选写入 handoff 截图目录。
• 不执行 Git 暂存、提交、推送、重置或检出。

---

Task 1: 候选母版与机器清单

Files:

• Create: design-pipeline/manifests/g01-background-candidates.json

• Create: design-pipeline/tests/g01-background-candidates.test.mjs

• 先写清单合同测试并确认缺少清单时失败。

• 写入三个母版、完整提示、源尺寸、处理模式和输出路径。

• 运行 Node 测试并确认清单通过。

Task 2: 确定性像素构建

Files:

• Create: design-pipeline/scripts/build_g01_backgrounds.py

• Create: design-pipeline/scripts/build-g01-backgrounds.mjs

• Create: design-pipeline/tests/test_build_g01_backgrounds.py

• Modify: design-pipeline/package.json

• 先写纯绿、抗锯齿绿边和不透明母版测试并确认失败。

• 实现绿幕转 Alpha、去绿污染、透明 RGB 清零和不透明母版标准化。

• 添加 Node 编排入口和 npm 命令。

• 运行 Python/Node 测试与实际候选构建。

Task 3: 交接与清理审计

Files:

• Modify: docs/design/设计资产生产流水线规范.md

• Modify: docs/design/P00_页面结构与资产清单.md

• Modify: docs/交接记录.md

• Create: docs/design/G01_列表背景候选与换机重建.md

• 记录三母版、构建命令、依赖、不可逐像素重新生成的边界和页面滚动待讨论事项。

• 扫描截图、候选和未跟踪文件的文档引用，生成精确清理清单。

• 不删除历史 handoff 证据；任何含糊项留给用户确认。