Files
jiapuapp/docs/superpowers/specs/2026-07-16-g01-list-background-assets-design.md
T
2026-07-16 18:13:03 +08:00

2.1 KiB

G01 列表背景资产设计

当前决定

先生成并保留三个 G01 列表背景母版,不修改页面滚动结构,也不替换现有运行资产。下一轮先由用户选择方向,再创建唯一正式运行资产并接入页面。

已生成方向

  • A:上方远山、左下亭台、右侧竹影,纯绿幕背景,适合提取透明叠加层。
  • B:上下远山形成纵向框景、左中亭台、右侧竹影,纯绿幕背景,适合提取透明叠加层。
  • C:云气、树枝、亭台、竹影和山水从上到下连续分布,带完整暖宣纸底,适合直接作为不透明列表背景。

三个母版都只作为候选,不等于用户已选择,也不进入页面引用。母版位于 docs/design/assets/g01-background/masters/

生产合同

  1. ImageGen 只负责艺术母版;准确提示词、母版路径和处理模式写入 design-pipeline/manifests/g01-background-candidates.json
  2. Python/Pillow 负责解码、绿幕转 Alpha、去绿边、清理透明 RGB、sRGB 输出和确定性压缩。
  3. Node 负责校验清单路径与源尺寸、调用 Python,并把结果写入已忽略的 design-pipeline/generated/g01-background/
  4. 另一台电脑使用仓库内母版构建时应得到相同像素结果;再次调用模型只能得到同方向的新母版,不能保证逐像素一致。
  5. 用户选择方向前,不创建 static/assets/ 正式输出,不修改 G01 页面。

下一轮页面结构待讨论

用户提出 G01 应只滚动下方列表:红色标题栏、当前家谱大卡片、四个快捷入口和分隔线固定;从“我创建的”开始独立滚动。新背景预计固定在列表滚动窗口背后,而不是作为列表末尾内容。该结构尚未批准实施,下一轮继续讨论并进行四档尺寸验证。

质量与仓库边界

  • 候选生成结果不写入 docs/design/screens/handoff/,避免扩大交接截图合同。
  • generated/、虚拟环境、Node 依赖和 tmp/ 不进入 Git。
  • 三个母版是当前选择尚未完成时的必要设计输入;选定正式方向后,再由用户决定是否保留未选母版。