美术素材 · 接入 vs 生成进度分析 · 2026-08-03
分析日期：2026-08-03 15:59；2026-08-03 状态修订 方法：扫描
public/实际文件 + grepsrc/引用路径 + 资产回归 承接：美术资源总览-v2.md§0 TL;DR 关系：本表跟踪“接入率”，跟 LANDED “完成度”是两个独立维度
§0 TL;DR
| 维度 | 数 | |---|---| | 生成进度 | 现场已修正：Year1 28/28、Buff、attr、地图、事件图、P0 经营底图 5、C1-C8、D1-D30 均已落盘 | | 接入进度 | 关键路径 100%：Year1 / Buff / attr / 地图 / 事件图 / 经营底图均已接入并有回归；C1-C8 / D1-D30 已有数据层注册和路径回归 | | 已生成未接入 / 待决策 | pack-02 NPC 21；早期 func/root 旧包；C1-C8 / D1-D30 待正式剧情或 UI 消费挂点；B7-B21 / M1-M6 需产品拍板 | | 未生成未接入 | P2 批量 + 视频 | | 断链风险 | 当前已检查路径 0；旧 month11-12 broken 引用已关闭 |
§1 分类扫描结果（8-03 现场修订）
§1.1 /bg/scenes/ 系统场景
| 文件 | 生成 | src 引用 | 状态 |
|---|:-:|:-:|:-:|
| account_empty.png | ✓ | BG_SCENE.accountEmpty | ✓ |
| save_empty.png | ✓ | BG_SCENE.saveEmpty | ✓ |
| status_danger.png | ✓ | BG_SCENE.statusDanger | ✓ |
| status_good.png | ✓ | BG_SCENE.statusGood | ✓ |
| gameover_pressure.png | ✓ | BG_SCENE.gameoverPressure | ✓ |
| gameover_warning.png | ✓ | BG_SCENE.gameoverWarning | ✓ |
| 合计 | 6/6 | 6/6 | 100% ✓ |
§1.1.1 /bg/scenes/ 经营分区底图
| 文件 | 生成 | src 引用 | 状态 |
|---|:-:|:-:|:-:|
| mainhall_empty.png | ✓ | BG_SCENE.mainHallEmpty + FACILITY_ZONE_IMAGES.lobby | ✓ |
| kitchen_empty.png | ✓ | BG_SCENE.kitchenEmpty + FACILITY_ZONE_IMAGES.kitchen | ✓ |
| backyard_empty.png | ✓ | BG_SCENE.backyardEmpty + FACILITY_ZONE_IMAGES.backyard | ✓ |
| ledger_empty.png | ✓ | BG_SCENE.ledgerEmpty + FACILITY_ZONE_IMAGES.second_floor | ✓ |
| storage_empty.png | ✓ | BG_SCENE.storageEmpty + FACILITY_ZONE_IMAGES.staff_room | ✓ |
| 合计 | 5/5 | 5/5 | 100% ✓ |
§1.2 /story/year1/ 剧情场景
| 月份 | 生成 | 接入（src 引用）| 命名 | 状态 |
|---|:-:|:-:|---|:-:|
| month01 | 4 | 4 + 4 dialogue | dayNN-hall-v1.png | ✓ |
| month02 | 4 | 4 | dayNN-hall-v1.png | ✓ |
| month03 | 3 | 3 | dayNN-hall-v1.png | ✓ |
| month04 | 10 | 10 | 双轨制：4 dayNN-hall + 6 P1-03 旧名 | ✓ |
| month05 | 2 | 2 | dayNN-hall-v1.png | ✓ |
| month06 | 2 | 2 | dayNN-hall-v1.png | ✓ |
| month07 | 2 | 2 | dayNN-hall-v1.png | ✓ |
| month08 | 2 | 2 | dayNN-hall-v1.png | ✓ |
| month09 | 2 | 2 | dayNN-hall-v1.png | ✓ |
| month10 | 3 | 3 | dayNN-hall-v1.png | ✓ |
| month11 | 1 | 1 | 当前运行时：month11-12/original/farewell_guest.png；旧 day330-closeout-hall-v1.png 也已落盘 | ✓ |
| month12 | 3 | 3 | 当前运行时：year_end_dinner.png / final_settlement.png / new_year_prep.png；旧 day350/day355/day360 也已落盘 | ✓ |
| 合计 | 28/28 | 28/28 + 月 04 旧名 6 | | 100% |
旧结论“month11-12 4 个 broken 引用”已关闭。当前运行时以
src/data/storyEvents/year1Showcase/month11.ts、month12.ts为准，并通过year1ShowcaseData.regression.ts。
§1.3 /portraits/ 立绘
| 文件 | 生成 | src 引用 | 状态 |
|---|:-:|:-:|:-:|
| tong/bai/guo/lu/li/mobei.png | 6 | 6（多文件）| ✓ |
| thumbs/{tong,li,bai,guo,lu}.webp | 5 | 5（staffVisuals.ts）| ✓ |
| tongfu-pack-02/*.webp | 21 | 0 | ⚠ 待剧情 / NPC 系统消费决策 |
| cross/c1_single_focus.png → c8_farewell.png | 8 | CROSS_STORY_PORTRAIT_SOURCES | ✓ 数据层注册 + 路径回归；待正式展示挂点 |
| story/icons/d1_01_guanzhong_bill.png → d4_10_ledger.png | 30 | STORY_PROP_ICON_SOURCES | ✓ v2 正式索引 + 路径回归；旧 d1_letter.png 系列保留为 legacy |
§1.4 /icons/tongfu/ 图标
| 子目录 | 生成 | 接入 | 状态 | |---|:-:|:-:|:-:| | func/ P0-06 二批 | 6 | 6（tongfuIcons.tsx 完整映射）| ✓ 100% | | func/ 早期 8 张 | 8 | 0 | ⚠ 旧包，待归档或复用决策 | | attr/ 经营属性 | 7 | 7（attributeIconSources + UI 消费）| ✓ 100% | | buff/ Buff | 64 | 53/53 运行时 Buff 定义有最终图标 | ✓ 100% | | wulin/ 江湖 | 12 | 12（jianghu 模块 + opsAtomic）| ✓ 100% | | 根目录 16 张早期 | 16 | 0 | ⚠ 旧包，待归档或复用决策 |
attr / Buff 的旧缺口结论已关闭。当前回归：
attributeIconAssets.regression.ts、buffIconAssets.regression.ts通过。
§1.5 /images/ landing 与事件图
| 文件 | 生成 | src 引用 | 状态 |
|---|:-:|:-:|:-:|
| landing-bg.png | ✓ | LANDING_BG_IMAGE | ✓ |
| landing-logo-full.png | ✓ | LANDING_LOGO_FULL | ✓ |
| landing-logo-narrow.png | ✓ | LANDING_LOGO_NARROW | ✓ |
| landing-save-card.png | ✓ | LANDING_SAVE_CARD_IMAGE | ✓ |
| landing-reunion.png | ✓ | LANDING_REUNION_IMAGE | ✓ |
| /images/events/*.png | 5 | 5 | ✓ |
事件图当前 runtime 命名：
event_security.png/event_hygiene.png/event_supply.png/event_competition.png/event_kitchen_accident.png。
§1.6 /banners/ 横幅
| 文件 | 生成 | src 引用 | 状态 |
|---|:-:|:-:|:-:|
| tongfu-main-banner.png | ✓ | BG_SCENE.mainHallBanner + FACILITY_ZONE_IMAGES.lobby | ✓ |
| tongfu-reunion.png | ✓ | BG_SCENE.reunionBanner | ✓ |
| 合计 | 2/2 | 2/2 | 已接入 |
banners 的旧孤立资源结论已关闭。
§1.7 /story/maps/ 地图卡面
| 文件 | 生成 | src 引用 | 状态 |
|---|:-:|:-:|:-:|
| map_road.png / map_fortress.png / map_qixia_town.png / map_jiangnan.png / map_snow_mountain.png | 5 | ADVENTURE_MAPS.coverSrc 5/5 | ✓ |
mapCoverAssets.regression.ts已验证所有coverSrc均指向 public 中存在的文件。
§1.8 /audio/voice/ 配音
| 文件 | 实际数 | 接入 | 状态 |
|---|:-:|:-:|:-:|
| year1/storyline_y1_mXX_nYY/*.ogg | 262 | src/data/audio/year1Voice.ts 全部预接线 | ✓ 技术验证；听感验收待人工 |
§1.9 /videos/ 视频
| 文件 | 生成 | 接入 | 状态 |
|---|:-:|:-:|:-:|
| landing-bg.mp4 | ✓ | LANDING_VIDEO_SRC | ✓ |
| 其它剧情 / 日常 / 战斗 / 节气视频 | 约 50 | 0 | 待拍板 |
§2 接入率汇总（8-03 修订）
| 类别 | 生成 | 接入 | 接入率 | 状态 | |---|:-:|:-:|:-:|---| | /bg/scenes/ | 6 | 6 | 100% | ✓ 关键路径 | | /bg/scenes/ 经营底图 | 5 | 5 | 100% | ✓ 设施分区背景 | | /story/year1/month01-12/ | 28 | 28 | 100% | ✓ 已关闭旧 broken | | /story/year1/month04 P1-03 旧名 | 6 | 6 | 100% | ✓ 双轨制 | | /story/maps/ | 5 | 5 | 100% | ✓ | | /images/events/ | 5 | 5 | 100% | ✓ | | /portraits/ 主角 | 6 | 6 | 100% | ✓ | | /portraits/ thumbs | 5 | 5 | 100% | ✓ | | /portraits/ pack-02 NPC | 21 | 0 | 0% | ⚠ 待消费决策 | | /portraits/cross/ | 8 | 8 registered | 100% 注册覆盖 | ⚠ 展示挂点待定 | | /icons/tongfu/func/ P0-06 | 6 | 6 | 100% | ✓ | | /icons/tongfu/wulin/ | 12 | 12 | 100% | ✓ | | /icons/tongfu/buff/ | 64 | 53/53 runtime Buff | 100% 运行时覆盖 | ✓ | | /icons/tongfu/attr/ | 7 | 7 | 100% | ✓ | | /icons/tongfu/func/ 早期 8 | 8 | 0 | 0% | ⚠ 旧包 | | /icons/tongfu/ 根目录 16 | 16 | 0 | 0% | ⚠ 旧包 | | /story/icons/D1-D30 | 30 | 30 registered | 100% 注册覆盖 | ⚠ 展示挂点待定 | | /images/ landing | 5 | 5 | 100% | ✓ | | /banners/ | 2 | 2 | 100% | ✓ | | /audio/voice/year1/ | 262 | 262 | 100% | ✓ 技术验证，听感待人工 | | /videos/ | 1 | 1 | 100% | ✓ landing only |
注：不再把 Year1 / Buff / attr / 地图 / 事件图 / P0 经营底图列入“缺/未接”。剩余清单收敛为：cross portraits + D1-D30 展示挂点、pack-02 NPC 消费决策、P2 B7-B21 / M1-M6、视频拍板。
§3 关键发现
3.1 月 04 双轨制是有意设计而非断链
month04.ts用day95-newtable-hall-v1.png风格（Year 1 视觉锚定）year1ShowcaseData.regression.ts覆盖construct_start.png等 P1-03 旧命名- 10 张文件全部存在 ✓
- 不需要修复
3.2 month11-12 旧 broken 已关闭
| 项 | 当前状态 |
|---|---|
| month11.ts | 使用 /story/year1/month11-12/original/farewell_guest.png，文件存在 |
| month12.ts | 使用 year_end_dinner.png / final_settlement.png / new_year_prep.png，文件存在 |
| 旧 day330/day350/day355/day360 路径 | 文件也已落到 month11/original、month12/original；不是当前主引用 |
| 回归 | year1ShowcaseData.regression.ts 通过 |
3.3 当前真实缺口
| 类别 | 状态 | 下一步 | |---|---|---| | cross portraits C1-C8 | 已落 8 文件，已注册 | 定义剧情 / UI 的正式展示挂点 | | D1-D30 story icons | 已落 30 文件，已注册 | 定义剧情 / UI 的正式展示挂点 | | P2 B7-B21 + M1-M6 mass | 部分代表素材已落，批量仍待拍板 | 先定产品使用面，再批量生成 | | 视频约 50 | 仅 landing-bg.mp4 已上架 | 拍板是否进入本阶段 |
pack-02 NPC 头像、早期 func 8 + root 16 归为“素材池 / 旧包待决策”，不再和 Year1 / Buff / attr / 地图 / 事件图一起列为当前缺口。
3.4 资源-接入协同度
- 关键路径：Year1 / 系统场景 / Buff / attr / 地图 / 事件图 / 江湖 / 配音 / landing 视频已接入。
- 待决策资源：pack-02、cross portraits、D1-D30、早期 icon 包不再按“缺图”处理，改按“是否消费 / 在哪里挂点”处理。
- 真实未落资源：P2 批量 + 视频。
§4 推进优先级（按“已落 + 接入”二维矩阵）
4.1 第一象限 · 已落 + 已接入（无需动）
- Year1 28/28
- P0 经营底图 5/5（设施分区背景）
- Buff runtime 覆盖 53/53
- attr 7/7
- 地图 5/5
- 事件图 5/5
- 系统场景、banners、江湖图标、主角立绘、缩略图、配音、landing 视频
4.2 第二象限 · 已落 + 未接入 / 待挂点
| 类别 | 数量 | 建议 |
|---|:-:|---|
| pack-02 NPC 头像 | 21 | 等 NPC / 稀客 / 普通顾客界面或支线剧情消费 |
| cross portraits C1-C8 | 8 | 已有数据层注册；下一步建立展示消费规则 |
| D1-D30 story icons | 30 | 已有数据层注册；下一步建立剧情事件道具 / 凭证 / 信物消费规则 |
| 早期 func 8 + 根 16 | 24 | 归档 _legacy 或标注为可复用素材池 |
4.3 第三象限 · 未落 + 未接入
- P2 支线 B7-B21 高光与 M1-M6 mass 批量
- 视频约 50 段
4.4 第四象限 · 未落 + 已接入
- 当前已检查路径：无。
§5 行动建议（按投入产出比排序）
| 顺序 | 行动 | 投入 | 产出 | 影响 | |:-:|---|:-:|---|:-:| | 1 | 为 cross portraits + D1-D30 定义展示挂点 | 1-2d | 已注册素材进入剧情 / UI | 消化 38 张已落资源 | | 2 | pack-02 21 张消费决策 | 0.5d | 决定保留、归档或接 NPC 系统 | 避免头像包长期漂浮 | | 3 | P2 B7-B21 + M1-M6 批量拍板 | — | 支线和模板素材路线明确 | 后续批量生产前置 | | 4 | 视频 5 类拍板 | — | 明确是否进入本阶段 | 控制范围 | | 5 | 早期 func/root 旧包归档策略 | 0.3d | 降低库存噪音 | 不影响功能 |
§6 配套工具
docs/art/美术资源总览-v2.md— v2 主索引（含推进计划）docs/art/美术资源总览可视化-v1.html— v2.4 三视图 + v4 完成度docs/art/2026-07-24-verified-resource-inventory-v1.md— 7-24 资源核验（历史快照，部分状态已被本文件修订）docs/uirefactor/剩余UI缺口清单-v1.md— UI 缺口（8 月非目标 + checklist + 设计缺口）
武林外传 · 七侠镇刊印 · 美术素材接入 vs 生成进度分析 v1 2026-08-03 15:59