同福客栈 · 美术资源总览 v2
整理日期：2026-07-31（v2 首发）· 2026-08-03（v2.1 增量更新） 适用版本：v1.19.0+ 本版本关键变更（v1.19.0 → v2）：
- 整合"系统场景 6 张 + 28 张 Year 1 精选 + P0 21 张 + P1 136 件 + P2 500+ + 视频 50 段"全量缺口
- 拆出 三个视图（v1 总览 / v2 批次 / v3 时间线），单页 HTML 含 tab 切换
- 主索引文档化，所有视图统一从本表进入
v2.1 增量更新（2026-08-03）：
- 现场快照：扫描
public/实际落地数 +src/运行时引用 + 资产回归，更新 LANDED / WIRED / REGRESSION 数据- 新增强项：
- P0-06 二批 icon 6 个：6/6 ✓（菜品/奖励/锁定/告示/治安/清洁）
- Year 1 28 张：28/28 ✓（月 02-12 运行时场景资产全解析；含 month11-12 当前路径）
- 月 04 节点 6 张：6/6 ✓（双轨旧名 + 当前节点均有回归）
- Buff 62 件：64/62 ✓（超额落地；53/53 运行时 Buff 定义有最终图标）
- attr 经营属性：7/7 ✓；地图卡面：5/5 ✓；事件图：5/5 ✓
- P0 经营底图：5/5 ✓（已接入
BG_SCENE+FACILITY_ZONE_IMAGES）- 跨剧情立绘 C1-C8：8/8 ✓；D1-D30：30/30 ✓（数据层注册 + 路径回归）
- 新增 v4 完成度视图：HTML 第 4 个 tab，按"已 100% / 部分 / 未开始"3 段分组
- 实际完成度：关键 P0/P1 接入项已收敛；剩余缺口见 §3 / §5
§0 TL;DR
| 维度 | 数据 | |---|---| | 已落地资源 | ~260 文件 / 56.97 MiB | | 总缺口 | ~700+ 张 / 段 | | P0 缺口 | 已关闭：经营底图 5/5、Year1、P0-06 icon、地图、事件图均已接入并有回归 | | P1 缺口 | 核心已落盘接入；剩余为 cross portraits / D1-D30 的正式剧情或 UI 消费挂点 | | P2 缺口 | 支线 B7-B21 高光与 M1-M6 批量模板仍待产品拍板 | | 视频缺口 | ~50 段（5 类待拍板） | | 当前完成度 | Year1 / Buff / attr / 地图 / 事件图：已落盘、已接入、有回归；剩余见 §5 |
§1 三个视图入口
| 视图 | 用途 | 入口 |
|---|---|---|
| v1 总览视图 | KPI + 进度条 + 全量 25 组缺口卡片 | 单页 HTML 顶部 tab [v1 总览] |
| v2 批次视图 | 28 张 Year 1 按"经营打底 / 经营转折 / 擂台线 / 年终收束"4 批排列 | 同 HTML 顶部 tab [v2 批次] |
| v3 时间线视图 | 28 张 Year 1 按"月 02 → 月 12"11 个月份时间线排列 | 同 HTML 顶部 tab [v3 时间线] |
单页整合 HTML：
docs/art/美术资源总览可视化-v1.html（含 v1/v2/v3 tab 切换 · localStorage 持久化 · 一处落地三视图） 任何视图改动自动同步另外两个（共享 ASSETS 数据池）。
§2 已落地资源（按目录 · 现状快照）
§2.1 系统场景 · 6 张 ✅ 已接入 BG_SCENE
| 路径 | 用途 | key | 大小 |
|---|---|---|:-:|
| public/bg/scenes/account_empty.png | 账号空槽 / 启动引导 | accountEmpty | 358KB |
| public/bg/scenes/save_empty.png | 存档空槽 / 多周目引导 | saveEmpty | 329KB |
| public/bg/scenes/status_good.png | 经营繁荣 / 胜利场景 | statusGood | 366KB |
| public/bg/scenes/status_danger.png | 状态恶化 / 破败警示 | statusDanger | 330KB |
| public/bg/scenes/gameover_pressure.png | 失败 · 财务崩盘 | gameoverPressure | 333KB |
| public/bg/scenes/gameover_warning.png | 失败 · 官府查封 | gameoverWarning | 354KB |
共同点：7.2 一批裁切自
pic/素材7.3号/...png 3×2 网格；统一暖木色 + 灯笼调性。
§2.1.1 经营分区底图 · 5 张 ✅ 已接入 BG_SCENE / FACILITY_ZONE_IMAGES
| 路径 | 用途 | key |
|---|---|---|
| public/bg/scenes/mainhall_empty.png | 大堂 / 设施总览 | mainHallEmpty |
| public/bg/scenes/kitchen_empty.png | 后厨分区 | kitchenEmpty |
| public/bg/scenes/backyard_empty.png | 后院分区 | backyardEmpty |
| public/bg/scenes/ledger_empty.png | 账房 / 二楼经营分区占位 | ledgerEmpty |
| public/bg/scenes/storage_empty.png | 库房 / 房间分区占位 | storageEmpty |
src/utils/scenes/backgroundAssetLogic.regression.ts已验证 5 张底图在BG_SCENE与FACILITY_ZONE_IMAGES均有引用，且 public 文件存在。
§2.2 Year 1 月度场景 · 28 张 ✅ 已落盘 / 已接入 / 有回归
public/story/year1/month01-12/original/*.png 与当前 month11-12/original/*.png 路径均已覆盖，详情见 §4。运行时 scene.src 已解析到实际文件，并通过 year1ShowcaseData.regression.ts。
当前 month11 / month12 运行时使用
public/story/year1/month11-12/original/{farewell_guest,year_end_dinner,final_settlement,new_year_prep}.png；旧文档里的day330/day350/day355/day360-*.png也已落在对应月目录，但不是当前运行时主引用。
§2.3 角色立绘 · 32 + 21 张
- 6 主角主图：
public/portraits/{tong,bai,guo,lu,li,mobei}.png - 5 缩略：
public/portraits/thumbs/{tong,li,bai,guo,lu}.webp - pack-02 21 张：
public/portraits/tongfu-pack-02/*.webp（NPC / 稀客 / 普通顾客） - 跨剧情立绘 8 张：
public/portraits/cross/c1_single_focus.png→c8_farewell.png（已注册CROSS_STORY_PORTRAIT_SOURCES） - 跨剧情道具 v2 30 张：
public/story/icons/d1_01_guanzhong_bill.png→d4_10_ledger.png（已注册STORY_PROP_ICON_SOURCES；旧d1_letter.png等保留为 legacy）
§2.4 同福图标 · 113 个
| 子目录 | 数量 | 接入状态 | 用途 |
|---|:-:|---|---|
| func/ P0-06 | 6 | ✅ 已映射 | 菜品 / 奖励 / 锁定 / 告示 / 治安 / 清洁 |
| func/ 早期 | 8 | ⚠ 旧包待归档 / 复用决策 | 系统入口 / 设置 / 帮助 / 关于 |
| attr/ | 7 | ✅ 已接入 + 回归 | 经营属性（卫生 / 治安 / 库存 / 现金流 / 员工 / 客流 / 口碑） |
| buff/ | 64 | ✅ 已接入 + 回归 | 53 个运行时 Buff 定义均能解析到最终图标 |
| wulin/ | 12 | ✅ 已接入 | 江湖人物关系 / 阵营 / 声望 |
| 根目录早期 | 16 | ⚠ 旧包待归档 / 复用决策 | 铜钱 / 算盘 / 账本 / 欠条 / 令牌 / 招牌等 |
通用规格：48×48 PNG 透明底，256×256 画布，墨金酒馆色板。
§2.5 对白语音 · 262 段
public/audio/voice/year1/storyline_y1_mXX_nYY/*.ogg · 24kHz / 64kbps / Ogg Vorbis · 约 27 分钟
状态：✅ 技术验证通过 / ⏳ 听感验收待人工 / ✅ 运行时已接线 / ✅ 旧存档兼容
§2.6 启动视频 · 1 段
public/videos/landing-bg.mp4 · 1920×1080 · 6s 循环 · H.264 · 1.26 MB
状态：✅ v1.19.0 修复后已上架
§3 缺口总表（按优先级）
§3.1 P0 · 系统必备（已关闭）
A. 经营场景 · 5 张 ✅ 已落盘 / 已接入 / 有回归
- 大堂空场景 →
public/bg/scenes/mainhall_empty.{png,webp} - 后厨灶台 →
public/bg/scenes/kitchen_empty.* - 后院柴垛 / 水井 →
public/bg/scenes/backyard_empty.* - 账房算盘 →
public/bg/scenes/ledger_empty.* - 行囊 / 库房 →
public/bg/scenes/storage_empty.*
B. 二批 icon pack · 6 个 ✅ 已落盘 / 已接入 / 有回归
菜品 / 奖励 / 锁定 / 告示 / 治安 / 清洁 → public/icons/tongfu/func/
C. 地图卡面 · 5 张 ✅ 已落盘 / 已接入 / 有回归
官道 / 山寨 / 七侠镇街巷 / 雪山 / 江南水乡 → public/story/maps/
当前 runtime 采用
map_road.png/map_fortress.png/map_qixia_town.png/map_jiangnan.png/map_snow_mountain.png命名。
D. 事件插图 · 5 张 ✅ 已落盘 / 已接入 / 有回归
治安 / 卫生 / 供货 / 抢客 / 作业风波 → public/images/events/
当前 runtime 采用
event_security.png/event_hygiene.png/event_supply.png/event_competition.png/event_kitchen_accident.png命名。
E. Year 1 精选场景 · 28 张 ✅ 已落盘 / 已接入 / 有回归
已关闭旧 P0 盲区。运行时节点与 public 文件均已通过回归；后续只保留风格/替换优化，不再计为缺图。
§3.2 P1 · 可玩性阻塞（核心已关闭，剩余待挂点 / 拍板）
| 子类 | 数量 | 路径 | 备注 |
|---|:-:|---|---|
| Buff 图标 · 客栈级 | 8 | public/icons/tongfu/buff/ | ✅ 已落盘 / 已接入 / 有回归 |
| Buff 图标 · 角色级 | 54 | public/icons/tongfu/buff/ | ✅ 已落盘 / 已接入 / 有回归 |
| 主线月 04 节点 | 6 | public/story/year1/month04/original/ | ✅ 双轨旧名 + 当前节点均有回归 |
| 支线 B1-B6 高光 | 18 | public/story/scenes/branches/ | 已有代表素材；后续按支线实际消费挂点 |
| 主线月 11-12 节点 | 4 | public/story/year1/month11-12/original/ | ✅ 当前运行时 4 张已接入；与 28 张 Year 1 去重 |
| 跨剧情立绘 C1-C8 | 8 | public/portraits/cross/ | ✅ 已落盘 / 数据层注册 / 路径回归；待正式剧情或 UI 消费 |
| 跨剧情道具 D1-D30 | 30 | public/story/icons/ | ✅ 已落盘 / 数据层注册 / 路径回归；待正式剧情或 UI 消费 |
⚠️ 注意：P1 现在不再包含 Year1 / Buff / attr / 地图 / 事件图的“未接入”旧项；剩余只保留正式展示挂点、P2 批量和视频拍板。
§3.3 P2 · 远期累积（500+）
- 主线月 5-10 补图：30 张（大部分已被 28 张 Year 1 覆盖）
- 支线 B7-B21：70 张高光
- M1-M6 模板复用：400 张
§3.4 视频 · 5 类待拍板（~50 段）
| 类型 | 用途 | 估量 | |---|---|:-:| | A. 启动页视频变体 | 黄昏 / 雨夜 / 雪夜 / 晴天 | 4 段 | | B. 剧情入场动画 | 月 1-12 关键节点入场 | 28 段 | | C. 客栈日常循环 | 大堂 / 后厨 / 后院 / 账房 | 4 段 | | D. 战斗 / 擂台关键帧 | 出招 / 对擂 / 封条 / 收势 | 10 段 | | E. 节气氛围 | 春 / 夏 / 秋 / 冬 | 4 段 |
§4 28 张 Year 1 精选场景 · 详情
来源：
docs/art/2026-07-24-year1-missing-asset-list-v2.md§3-§4 节点 ID 与正式路径：src/data/storyEvents/year1Showcase/month02-12.ts构图与生成约束：docs/art/2026-07-24-year1-month02-12-scene-generation-kit-v1.md批 prompt（4 次八宫格 + 7 次四宫格）：docs/art/2026-07-24-year1-missing-scene-batch-prompts-v1.md
批次 A · 经营打底（11 张 · 月 02-04）
| ID | 月 | Day | 节点 | 路径 |
|---|:-:|:-:|---|---|
| y1-A-01 | 02 | 35 | 子曰账法 | public/story/year1/month02/original/day35-ledger-hall-v1.png |
| y1-A-02 | 02 | 48 | 小贝逃学 | public/story/year1/month02/original/day48-truancy-hall-v1.png |
| y1-A-03 | 02 | 58 | 秋分试菜 | public/story/year1/month02/original/day58-tasting-hall-v1.png |
| y1-A-04 | 02 | 60 | 两月小结 | public/story/year1/month02/original/day60-closeout-hall-v1.png |
| y1-A-05 | 03 | 63 | 食安风波 | public/story/year1/month03/original/day63-foodsafe-hall-v1.png |
| y1-A-06 | 03 | 72 | 门口镇场 | public/story/year1/month03/original/day72-guard-hall-v1.png |
| y1-A-07 | 03 | 90 | 季末落款 | public/story/year1/month03/original/day90-closeout-hall-v1.png |
| y1-A-08 | 04 | 95 | 堂中加桌 | public/story/year1/month04/original/day95-newtable-hall-v1.png |
| y1-A-09 | 04 | 100 | 百日捧场 | public/story/year1/month04/original/day100-hundred-hall-v1.png |
| y1-A-10 | 04 | 115 | 厨房扩建 | public/story/year1/month04/original/day115-kitchen-hall-v1.png |
| y1-A-11 | 04 | 120 | 四月落款 | public/story/year1/month04/original/day120-closeout-hall-v1.png |
批次 B · 经营转折（6 张 · 月 05-07）
| ID | 月 | Day | 节点 | 路径 |
|---|:-:|:-:|---|---|
| y1-B-01 | 05 | 140 | 商队午歇 | public/story/year1/month05/original/day140-caravan-hall-v1.png |
| y1-B-02 | 05 | 150 | 五月落款 | public/story/year1/month05/original/day150-closeout-hall-v1.png |
| y1-B-03 | 06 | 155 | 半年结算 | public/story/year1/month06/original/day155-halfyear-hall-v1.png |
| y1-B-04 | 06 | 180 | 半年大结 | public/story/year1/month06/original/day180-closeout-hall-v1.png |
| y1-B-05 | 07 | 200 | 两百日记 | public/story/year1/month07/original/day200-twohundred-hall-v1.png |
| y1-B-06 | 07 | 210 | 七月落款 | public/story/year1/month07/original/day210-closeout-hall-v1.png |
批次 C · 擂台线（7 张 · 月 08-10）
| ID | 月 | Day | 节点 | 路径 |
|---|:-:|:-:|---|---|
| y1-C-01 | 08 | 215 | 喜挂红绸 | public/story/year1/month08/original/day215-redsilk-hall-v1.png |
| y1-C-02 | 08 | 240 | 八月落款 | public/story/year1/month08/original/day240-closeout-hall-v1.png |
| y1-C-03 | 09 | 250 | 初擂报名 | public/story/year1/month09/original/day250-arena-hall-v1.png |
| y1-C-04 | 09 | 270 | 擂鼓将响 | public/story/year1/month09/original/day270-closeout-hall-v1.png |
| y1-C-05 | 10 | 275 | 决擂之日（风格锚点） | public/story/year1/month10/original/day275-arena-hall-v1.png |
| y1-C-06 | 10 | 278 | 擂台余波 | public/story/year1/month10/original/day278-aftermath-hall-v1.png |
| y1-C-07 | 10 | 300 | 三百日总结 | public/story/year1/month10/original/day300-threehundred-hall-v1.png |
批次 D · 年终收束（4 张 · 月 11-12）
| ID | 月 | Day | 节点 | 路径 |
|---|:-:|:-:|---|---|
| y1-D-01 | 11 | 330 | 十一月落款 | public/story/year1/month11/original/day330-closeout-hall-v1.png |
| y1-D-02 | 12 | 350 | 岁末团圆饭（风格锚点） | public/story/year1/month12/original/day350-reunion-hall-v1.png |
| y1-D-03 | 12 | 355 | 元年总录 | public/story/year1/month12/original/day355-annual-hall-v1.png |
| y1-D-04 | 12 | 360 | 跨年之夜 | public/story/year1/month12/original/day360-newyear-hall-v1.png |
风格锚点优先级
Day 275 决擂之日 + Day 350 岁末团圆饭已不再作为待生成 blocker。若后续重绘，只按风格升级处理，不影响当前运行时完整性。
§5 推进计划
按 紧迫性 + 权威性 排序：
| 顺序 | 类别 | 数量 | 估时 | 备注 |
|:-:|---|:-:|:-:|---|
| 1 | cross portraits + D1-D30 消费挂点 | 38 | 1-2d | 文件已落且已注册；需决定在哪些剧情 / UI 正式消费 |
| 2 | pack-02 NPC 头像消费决策 | 21 | 0.5d | 等 NPC / 稀客 / 普通顾客界面或支线剧情挂点 |
| 3 | P2 支线与模板批量 | 470+ | — | B7-B21 高光 + M1-M6 mass 批量，需产品拍板 |
| 4 | 视频 5 类 | ~50 | — | 目前仅 landing-bg.mp4 已上架，其余待拍板 |
| 5 | 旧 icon 包归档策略 | 24 | 0.3d | 早期 func 8 + 根目录 16，降低库存噪音 |
已关闭：Year1 28/28、P0 经营底图 5/5、P0-06 icon、Buff、attr、地图、事件图、C1-C8 注册、D1-D30 注册。后续不要再把这些列入“缺图 / 无入口”。
§6 关联文档
§6.1 项目内规范
- 风格指南：
docs/art/tongfu-art-style-guide-v1.md（13 节 / 539 行） - UI 美术规范：
docs/art/tongfu-ui-art-spec-v1.md - Prompt 库：
docs/art/prompt-library.md（场景 / 角色 / 图标 / Buff 4 类前缀） - 资产库总览：
docs/art/美术资产库-v1.md（武林周报美术专刊卷一）
§6.2 缺口 / 库存
- 已核验资源：
docs/art/2026-07-24-verified-resource-inventory-v1.md - 缺口清单：
docs/art/asset-gap-list.md - Year 1 缺失 v2：
docs/art/2026-07-24-year1-missing-asset-list-v2.md - 剧情插画总清单：
docs/art/剧情插画素材总清单-v1.md
§6.3 28 张 Year 1 专项
- 逐节点构图：
docs/art/2026-07-24-year1-month02-12-scene-generation-kit-v1.md - 批 prompt（4 八宫格 + 7 四宫格）：
docs/art/2026-07-24-year1-missing-scene-batch-prompts-v1.md - 月 1 来源验收：
docs/art/2026-07-23-month1-empty-hall-intake-v1.md - Owner 风险确认：
docs/art/2026-07-23-month1-owner-asset-clearance-v1.md
§6.4 历史专项
- 7.2 UI 生图待办：
docs/plans/backlog/2026-07-02-ui-art-backlog.md - 7.28 今日生图清单：
docs/art/2026-07-28-today-asset-generation-prompts-v1.md
§7 视图使用说明
§7.1 v1 总览视图
适合：日常补图入口，看"全量缺口 + 进度 + KPI" 显示：25 组缺口卡片，每张可点开 prompt 抽屉 过滤：全部 / P0 / P1 / P2 / 视频 / 已完成 / 未完成 勾选：localStorage 持久化，自动算进度
§7.2 v2 批次视图
适合：批量补 Year 1 场景，按"经营打底 → 经营转折 → 擂台线 → 年终收束" 4 批推进 显示：28 张 Year 1 卡片，按批次分组（A 11 / B 6 / C 7 / D 4） 节奏：先做 A 批，验收后做 B，再 C，再 D 风格锚点：批次 C 的 Day 275 + 批次 D 的 Day 350 是锚点，先做这两张确认调性
§7.3 v3 时间线视图
适合：按月 02 → 12 顺序看全年节奏，看节点密度分布 显示：28 张 Year 1 卡片，按月分组（月 02: 4 / 月 03: 3 / 月 04: 4 / 月 05: 2 / 月 06: 2 / 月 07: 2 / 月 08: 2 / 月 09: 2 / 月 10: 3 / 月 11: 1 / 月 12: 3） 关键节点：Day 100 百日 / Day 200 两百日 / Day 275 决擂 / Day 300 三百日 / Day 350 团圆 / Day 360 跨年 —— 6 个里程碑
武林周报 · 美术专刊 · 卷二 · 同福客栈挂机游戏 · v1.19.0+ 七侠镇刊印 · 2026-07-31