# 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 证据；任何含糊项留给用户确认。