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