2026-07-02 UI 生图待办 v1.1 · 计划 Backlog

整理时间:2026-07-02 14:58 +08:00(v1.1 修订) 整理人:Mavis(PM 视角) 性质:backlog 候选池,不进 In-Flight Business Cards,不进 5 日计划 v1.1(7.6-7.10) 状态:pending(等 P1 用户决定是否今日派工 / 派多少) 本版本关键变更:v1.0 → v1.1 共 2 处应用修订(7.2 14:58):

α 新增 § 2.5 Buff 图标 62 件(8 客栈 + 54 角色 - 0 已有 = 62),从原 § 3.1 升级到 P1 候选

β 新增 § 11 Buff 系统集成状态盘点:BuffPanel 已被 SystemHubPanel 引用,summarizeBuffs 已接 App.tsx,实际集成 100%(原 v1.0 估的 60% 是错的);UI 素材 62 件仍是唯一缺口 背景:

今天 7.2(周四)在 5 日计划 v1.1 启动前 4 天,5 日计划里 UI 相关项全是 CSS 变量 + 组件渲染,不涉及 AI 生图

项目 3 份清单(uirefactor/素材清单.md / art/剧情插画素材总清单-v1.md / art/剧情故事生图素材清单.md)+ Buff 系统待生图标 = 合计 ~682 件生图待办,本表从中筛出今日可执行 + 留 W28+/W30+ 累积的子集 本文档作用:

让 P1 用户 1 分钟看清楚"今天能做什么生图"

让 PM 在 5 日计划 Day 5(7.10)收口时,知道"UI 生图 lane 候选有 19 件 P0 + 62 件 P1 没派"

跟 v1.1 5 日计划互不冲突(5 日计划不包含此 backlog)

0. TL;DR(60 秒版)

今日(7.2)可执行 P0:19 件 = 6 张背景图 + 6 个状态图标 + 7 个功能图标,合计 4-7h
W28+ P1 候选(v1.1 升级):~86 件 = 62 Buff 图标(8 客栈 + 54 角色 = 最高优先级) + 6 主线月 04 + 18 支线 B1-B6
留 W30+:跨剧情立绘 8 + 道具 30 + 主线 05-12 48 + 支线 B7-B21 ~70 + 批量 ~400
5 日计划 v1.1 范围内不涉及 AI 生图(全是 CSS 变量 + 组件渲染)
执行方式:matrix_generate_image(背景 16:9)+ SVG(优先 Buff / 状态 / 功能图标)
不做:不动 docs/uirefactor/pic/ 已有图 / 不改 3 份清单原文 / 不进 handoff in-flight / 不动 buff 系统 4 维度已完成的设计/数据/逻辑/UI

1. 范围与依据

1.1 三份上游清单(已存在)

| 清单 | 路径 | 状态 | 待生图总数 | | :--- | :--- | :---: | :---: | | 系统 UI 素材 | docs/uirefactor/素材清单.md | 14/96 已交付(2026-06-23) | 82 | | 剧情插画总清单 | docs/art/剧情插画素材总清单-v1.md | 22 节点已交付(2026-06-29) | ~526 节点 + 12 立绘 + 36 道具 | | 白佟羁绊清单(已并入) | docs/art/剧情故事生图素材清单.md | 12 场景 + 4 立绘 + 6 道具已交付 | 0(继承) |

1.2 不在本表里的事

❌ 5 日计划 v1.1(7.6-7.10)R1.2 T4 9 档色板(CSS 变量,不生图)
❌ 5 日计划 v1.1 R1.3-R1.4 装备卡 / BaggageTab 升级(组件渲染,不生图)
❌ 5 日计划 v1.1 Day 3 视觉对照(看图,不生图)
❌ 3 份清单原文修订(本表只引用,不修改)
❌ 重新设计美术风格基准(沿用 tongfu-art-style-guide-v1.md)

2. 今日(7.2)可执行 P0(19 件,4-7h)

2.1 核心插画与背景图(6 张,2-3h,16:9)

通用 Prompt 模板(待执行时拼接 prompt-library.md §2 场景前缀):

Interior of an ancient Chinese inn, [场景描述], warm wood interior,
semi-realistic Chinese illustration, ink brush line art with light watercolor wash,
parchment texture, warm brown and golden amber tones --ar 16:9

负面约束(全场通用,引自 剧情插画素材总清单-v1.md §4.4):

modern, neon, 3D render, photorealistic, cartoon, anime, flat vector,
text, letters, numbers, watermark, signature, people in modern clothing,
sci-fi, cyberpunk, fantasy armor, glossy fashion makeup, modern studio photography,
exaggerated beauty filter, horror, monster, deformed, bad anatomy, extra limbs

2.2 客栈状态维度图标(6 个,1-2h,1:1 SVG 优先)

图标 Prompt 前缀(引自 prompt-library.md §4):

Single ancient Chinese tavern item illustration on a transparent background,
hand-drawn ink brush style with light watercolor wash, centered single isolated object
--ar 1:1 --no background

SVG 优先说明:Buff / 属性 / 功能图标项目惯例用 SVG(素材清单.md §2.3),先出 SVG 矢量版,如工具不支 SVG 再降级 PNG(512×512)。

2.3 功能图标(7 个,1-2h,1:1 SVG 优先)

2.4 验收口径(19 件共同)

✅ 风格对照 docs/art/tongfu-art-style-guide-v1.md §12 验收清单
✅ 命名严格按 素材清单.md §七规则:[类别]_[序号]_[名称].png 或 .svg
✅ 落档到 public/bg/scenes/ 或 public/icons/ 子目录
✅ 不动 docs/uirefactor/pic/ 已有 14 张图
✅ 出图后不自动改 3 份清单状态(清单维护由 PM 走单独流程)

2.5 Buff 图标(62 件,模板批量,8-12h)— 7.2 v1.1 新增(原 v1.0 § 3.1 升级)

背景:Buff 系统 4 维度 100% 完整(设计 7 文档 / 数据 15 核心 + 54 模板 / 逻辑 944 行 buffEngine / UI 集成到 SystemHubPanel + App.tsx,详见 § 11),唯一缺口是 62 件 Buff UI 图标 = 玩家"看到 Buff 文字但认不出 Buff 类型"。

2.5.1 客栈级 Buff 图标(8 件,1:1 SVG,1-2h)

来源:src/data/buffs/catalog.ts 客栈级 8 个

| # | Buff ID | 名称 | 描述 | 状态 | | :-: | :--- | :--- | :--- | :---: | | 1 | inn_peak_hour | 高朋满座 | 圆章 + 客流涌动 + 灯笼高挂 | 📝 | | 2 | inn_half_business | 半营业状态 | 圆章 + 半门半掩 + 灯暗 | 📝 | | 3 | inn_sanitation_crisis | 垃圾堆积 | 圆章 + 垃圾堆 + 飞虫 | 📝 | | 4 | inn_security_crisis | 门户大开 | 圆章 + 破门 + 阴影 | 📝 | | 5 | inn_hygiene_suspend | 临时卫生整顿 | 圆章 + 封条 + 扫帚 | 📝 | | 6-8 | 客栈增益/减益(2 件) | 厨艺/卫生/治安 | 圆章 + 厨房/扫帚/腰牌 | 📝 |

2.5.2 角色级 Buff 图标(54 件,1:1 SVG,6-9h)

来源:src/data/buffs/buff-config-template.ts 46 角色 Buff + 素材清单.md §一 28 角色减益(部分重叠)

| 类别 | 文件名模式 | 数量 | 状态 | | :--- | :--- | :---: | :---: | | 角色增益 | buff_char_inspired ~ buff_char_outstanding | 27 | 📝 | | 角色减益 | buff_char_exhausted ~ buff_char_given_up | 28 | 📝 | | 已生成 | buff_23_char_energy(精力充沛) | 1 | ✅ | | 客栈 8 + 角色 54 - 1 已生 = 61 + 1 已生 = 62 总 | | 62 | |

2.5.3 Buff 图标 Prompt 前缀(沿用 `prompt-library.md` §5)

Circular badge icon for a Chinese tavern game, hand-drawn ink brush style,
[Buff 描述], centered single object within a circular frame
--ar 1:1 --no background

色彩建议(跟 5 日计划 v1.1 T4 9 档色板对齐):

增益:翠绿 / 金色 / 暖红
减益:暗红 / 灰紫 / 冷蓝
特殊:中性灰 + 边框色

2.5.4 验收口径(62 件共同)

✅ 风格对照 tongfu-art-style-guide-v1.md §12
✅ 命名严格按 素材清单.md §七:buff_[序号]_[类型]_[名称].svg
✅ 落档到 public/icons/buffs/(新目录,跟 public/icons/ 状态/功能图标并列)
✅ 增益/减益配色按 2.5.3 区分
✅ 不动 buff_23_char_energy.png 已有图(可保留 PNG 或后续转 SVG)

Buff 图标不做:

❌ 不改 src/data/buffs/** 数据(本表不触代码)
❌ 不改 BuffPanel.tsx 集成(已 100% 集成,详见 § 11)
❌ 不做"按 5 类 Buff 类型(客栈/员工/势力/特殊)分组展示"等 UI 改造
❌ 不动 src/components/SystemHubPanel.tsx 接线

3. 今日可做但建议留 W28+(~26 件)

3.1 主线月 04 扩建起步期(6 节点,2-3h,16:9)

来源:docs/art/剧情插画素材总清单-v1.md § A · 月 04

| # | 节点ID | 标题 | 状态 | | :-: | :--- | :--- | :---: | | 1 | node1 | 扩建动工 | 📝 | | 2 | node2 | 解锁祝无双 | 📝 | | 3 | node3 | 邢捕头燕小六正式拜山头 | 📝 | | 4 | node4 | 二楼住店开放 | 📝 | | 5 | node5 | 扩建风波 | 📝 | | 6 | node6 | 满月小结 | 📝 |

为何留 W28+:主线月 04 跟 Year 1 主线 B.3 道具投放接线(5 日计划 R1 收口后)对接,等 R1 收口再出图可避免"画完道具改动图作废"。

3.3 支线 B1-B6 高光场景(~18 张,模板批量,3-5h)

来源:docs/art/剧情插画素材总清单-v1.md § B · 通用模板 M1-M6 + B1-B6 高光各 3 个

模板 M1 夜袭屋顶剪影 / M2 巡夜更夫 / M3 暗巷追踪 / M4 客栈对质 / M5 客栈战斗 / M6 静夜独白
每模板 1 张出图后,变量替换(敌手描述/情绪/动作/道具)批量 3 张变体
6 模板 × 3 变体 = 18 张

为何留 W28+:模板 M1-M6 已在清单定义,等 P0 系统图标稳定后批量复用更省时。

4. 留 W30+(远期,~543 件)— v1.1 调整(移走 22 件 buff 已升 P1)

| 类别 | 数量 | 起点 | 理由 | | :--- | :---: | :--- | :--- | | ~~Buff 角色增/减益~~ | ~~55~~ | ~~W30+~~ | v1.1 升级 P1(详见 § 2.5.2) | | 跨剧情立绘 C2-C8 | 8 组 | W30+ | 涉及多角色组合,需先稳定 9 档色板 | | 跨剧情道具 D1-D4 | 30 件 | W30+ | 同上,色准优先 | | 主线月 05-12 | 48 节点 | W30+ | 累积补,每月 6 节点节奏 | | 支线 B7-B21 高光 | ~70 节点 | W32+ | 等 B1-B6 模板稳定后扩展 | | 支线批量 M1-M6 复用 | ~400 节点 | W32+ | 用模板批量,自动补 | | 远期合计 | ~543 | | |

5. 命名规范与落档路径

5.1 命名规范(沿用 `uirefactor/素材清单.md` §七)

[类别]_[序号]_[名称].png   或   [类别]_[序号]_[名称].svg

示例：
buff_23_char_energy.png
icon_8_heritage_point.png
icon_16_attr_hygiene.png
bg_7_system_hall.png

5.2 推荐落档路径

| 类别 | 路径 | 说明 | | :--- | :--- | :--- | | 背景图(16:9) | public/bg/scenes/ | 经营场景,长期复用 | | 系统图标(SVG) | public/icons/ | 状态/功能/Buff 图标,矢量优先 | | 剧情场景(16:9) | public/story/scenes/{故事线}/ | 主线 12 月 + 支线各分支 | | 双人 / 群像立绘(1:1) | public/story/portraits/ | 跨剧情复用 | | 道具 / 信物(1:1) | public/story/icons/ | 透明背景 PNG | | 月份节气氛围底图 | public/story/atmosphere/ | 跨年/月度背景 |

注意:补图前先用 pic/ 或 outputs/ 临时工作,最后按命名拷到 public/。

6. 执行口径

6.1 优先级矩阵

| 优先级 | 范围 | 理由 | | :--- | :--- | :--- | | P0(今日) | 6 背景 + 6 状态 + 7 功能 = 19 件 | 系统 UI 必备,缺失会让"空账本/空槽位/警报"等界面无图 | | P1(W28+) | 62 Buff 图标(8 客栈 + 54 角色) + 6 主线月 04 + 18 支线 B1-B6 = 86 件 | 跟 5 日计划 R1 收口 + 剧情线 3+ 预研对接;Buff 缺图是唯一可玩性阻塞(详见 § 11) | | P2(W30+) | 跨剧情立绘 8 + 道具 30 + 主线 05-12 48 = 86 件 | 累积补 | | P3(W32+) | 支线 B7-B21 + 批量 ~470 件 | 模板复用,自动补 |

6.2 风格基准(全部沿用,不重新设计)

风格基准:docs/art/tongfu-art-style-guide-v1.md
Prompt 库:docs/art/prompt-library.md(场景/角色/道具/Buff 4 类前缀)
验收清单:tongfu-art-style-guide-v1.md §12(10 条)

6.3 出图工具(本表建议)

AI 出图:matrix_generate_image (MCP matrix 工具,本会话可用)
本地工作目录:pic/ 或 outputs/,最后按命名拷到 public/
批量处理:同类(如同 6 张背景)用同一前缀 + 变量替换,提升一致性
验收 10 条(tongfu-art-style-guide-v1.md §12):
1. 角色形象一致性(对照 prompt-library §3)
2. 客栈环境一致性(暖木色 + 灯笼)
3. 时代感(古风,无现代元素)
4. 文字/数字/水印不入画
5. 表情/动作符合剧情描述
6. 16:9 比例正确(场景) / 1:1(图标)
7. 透明背景(图标)
8. 暖色基调为主
9. 笔触一致(半写实国风)
10. 文件大小合理(< 5MB / 张)

6.4 状态同步(出图后)

每完成一批出图:

不自动改 3 份清单的 📝 状态(由 PM 走单独流程维护)
在 git commit 信息中标注:art: complete {类别} {文件名}(参考 剧情插画素材总清单-v1.md §F5)
19 件 P0 全部完成后,本表升 v1.1:加 § 10 出图结果登记表(文件路径 + 验收签字)

7. 不做什么(明确划走)

❌ 不改 docs/uirefactor/素材清单.md 原文状态(等 PM 走单独流程)
❌ 不改 docs/art/剧情插画素材总清单-v1.md 原文状态
❌ 不改 docs/art/剧情故事生图素材清单.md(已并入 v1 总清单,白佟已交付)
❌ 不进 docs/handoff/index.md 的 In-Flight Business Cards(本表是 backlog 候选池)
❌ 不进 5 日计划 v1.1 任何 lane(7.6-7.10)
❌ 不派生新 worker(本表不是 in-flight task,只是 P1 用户今日参考)
❌ 不重做美术风格基准(tongfu-art-style-guide-v1.md 沿用)
❌ 不动 docs/uirefactor/pic/ 已有 14 张图
❌ 不出 9 档品质色板生图(T4 用 CSS 变量,不是 AI 生图)

8. 参考入口

9. 今日(7.2)执行选项

| 选项 | 范围 | 预计工时 | 工具 | | :---: | :--- | :---: | :--- | | α | 19 件 P0 全部 | 4-7h | matrix_generate_image(背景) + SVG(图标) | | β | 只出 6 张背景 | 2-3h | matrix_generate_image(16:9) | | γ | 只出 13 个图标 | 2-3h | matrix_generate_image(1:1) → 转 SVG | | δ | 19 件全不做,留 W28 | 0h | 什么都不动,本表留作 backlog | | ε | 19 件 + 62 件 Buff 图标 = 81 件(v1.1 升级) | 12-19h | 上述工具 + Buff 圆章 prompt(分 2-3 批) |

10. 状态与变更记录

| 版本 | 时间 | 整理人 | 关键变更 | | :---: | :---: | :--- | :--- | | v1.0 | 2026-07-02 14:22 | Mavis(PM 视角) | 首版:从 3 份上游清单筛出 19 件 P0(今日 7.2) + 32 件 P1(W28+) + ~600 件 P2/P3(远期);backlog 性质,不进 in-flight,跟 5 日计划 v1.1 互不冲突;附完整命名 / 落档 / Prompt / 验收口径;5 个执行选项 α-ε | | v1.1 | 2026-07-02 14:58 | Mavis(PM 视角) | 应用 α + β 修订,共 4 处实质修订:
① 头部新增 v1.1 修订说明 + 2 项变更要点(α + β)
② § 0 TL;DR 数字更新(P1 升 86 件 / 远期 543 / ε 选项扩到 81 件)
③ 新增 § 2.5 Buff 图标 62 件(原 § 3.1 升级,客栈 8 + 角色 54 = 62);§ 3 移走 Buff 8 件,标题改;§ 4 远期数字调整
④ § 6.1 优先级矩阵 P1 加 Buff 行(86 件)
⑤ 新增 § 11 Buff 系统集成状态盘点:设计/数据/逻辑/UI 4 维度 100% 完整(原 v1.0 估的 60% 是错的);唯一缺口是 62 件 Buff UI 素材 | | (待定) | — | — | P1 用户决定今日是否派工 / 派多少后,出图结果登记 + 升 v1.2 |

11. Buff 系统集成状态盘点(7.2 14:58 新增,β 修订)

背景:7.2 用户问"buff 系统进度",顺手盘点了一下,结果实际比 v1.0 估的好得多。

11.1 4 维度真实进度(纠正 v1.0 估的 60%)

| 维度 | v1.0 估 | 真实状态 | 证据 | | :--- | :---: | :---: | :--- | | 设计 | 100% | ✅ 100% | 7 份文档 6.22-6.25 完整 | | 数据 | 100% | ✅ 100% | 6 文件 63KB,15 核心 + 54 模板 | | 逻辑 | 100% | ✅ 100% | buffEngine 944 行 12 函数 + innStatusBuffBridge 509 行 | | UI | 60% | ✅ 100% | BuffPanel.tsx 194 行已接 SystemHubPanel.tsx(Line 19 + 229),summarizeBuffs 已接 App.tsx(Line 186) | | UI 素材 | 1.5% | ❌ 1.5% | 1/64 已生成,63 件待生图 |

11.2 UI 集成证据

src/components/SystemHubPanel.tsx:19  import { BuffPanel } from './BuffPanel';
src/components/SystemHubPanel.tsx:229 <BuffPanel buffSummary={buffSummary} />
src/App.tsx:186                     import { summarizeBuffs } from "./utils/buffEngine";

✅ BuffPanel → SystemHubPanel 集成完成(系统中枢面板)
✅ summarizeBuffs → App.tsx 集成完成(顶层状态聚合)
✅ 49 处 buff 引用分布在 5 文件 — 深度集成,不是"装个壳"

11.3 BuffPanel 实现细节(从代码 § 1-193)

| 能力 | 实现 | 行数 | | :--- | :--- | :---: | | 空态/未初始化 | 独立空态组件 | L11-23 | | 激活/悬挂统计 | totals grid 2 列 | L62-70 | | 系统标签池 | activeTags.map 渲染 | L88-101 | | 可见 Buff 列表 | visibleBuffs.map 渲染 | L110-160 | | 增/减益配色 | green-50 / red-50 区分 | L113-117 | | 堆叠数显示 | stacks > 1 标签 | L125-129 | | 倒计时 | remainingSlots 渲染 | L141-145 | | 触发原因 | reason 文本块 | L149-156 | | 分类/来源/持续类型 | 三列 grid 摘要 | L162-190 |

11.4 唯一缺口(已升 P1 候选)

62 件 Buff UI 图标 = 8 客栈(5 catalog 客栈级 + 3 增/减益) + 54 角色(27 增益 + 27 减益 + 1 已生图)

缺图后果:玩家看到 Buff 文字但认不出 Buff 类型(增益/减益/特殊)
修复路径:详见 § 2.5(今日 P0 候选外,留 W28+ 批出)

11.5 跟 v1.0 估的差距

| 维度 | v1.0 估 | v1.1 纠正 | 原因 | | :--- | :---: | :---: | :--- | | UI 集成 | 60% | 100% | v1.0 没看 SystemHubPanel.tsx,误以为 BuffPanel 没接主导航 | | UI 集成证据 | (无) | L19 + L229 + App.tsx L186 | v1.1 补查 grep 找到 |

纠正方法:buff 系统盘点不能光看"BuffPanel.tsx 194 行就估低",必须 grep 全项目引用 + 顶层 App.tsx 集成。

Backlog 性质声明:本表 current state: pending,不进 docs/handoff/index.md 的 In-Flight Business Cards,不构成派发授权;只有 P1 用户当前消息明确授权"按 α/β/γ/δ/ε 执行"后,本表才升级为可执行 task 卡进入当前执行面。