同福客栈已核验资源清单 v1
核验日期：2026-07-24 结论口径：只记录本地实际存在的文件、当前
src/**的静态路径调用和 Git 收录状态；不把设计需求、预览页、审计裁切或未接线素材写成“已上线”。 范围：视觉、视频与音频资源。docs-site/**为派生文档站产物，不在本清单范围内。
1. 快照结论
public/现有 260 个文件，约 56.97 MiB；其中图片与视频文件为 247 个。Vite 会把它们原样发布，但“位于public/”本身不代表页面正在使用。- 运行时代码已明确引用启动页 5 张 PNG、6 张系统背景、主厅横幅、3 张 UI 图集、12 张人物图、16 张道具图标、4 张月 1 场景和 1 张月 1 招牌 SVG。
- 月 1 四张无人场景已存在且通过既有运行时验收，但
public/story/year1/month01/original/*.png当前未被 Git 跟踪、也未被忽略：本地可显示，不等于可复现或可随下一次发布交付。 - 项目没有
public/audio/。music/bgm/中虽有 1 个 MP3，但没有当前运行时调用，不能列为已接入 BGM。 - 旧的
art-resource-list.md仍把若干已存在的背景列为缺失；本文件是当前现场快照，不改写旧文档的历史记录。
2. 已确认的运行时资源
| 资源组 | 实际路径与数量 | 当前调用证据 | Git / 使用状态 |
| --- | --- | --- | --- |
| 启动页静态图 | public/images/{landing-bg,landing-logo-full,landing-logo-narrow,landing-save-card,landing-reunion}.png，5 张 | src/data/landing/config.ts | 已跟踪；启动页配置资源 |
| 启动页视频候选 | public/videos/landing-bg.mp4，1 个，SHA-256 2DC6A1D35A663124304BA5D2F045F5498D2624675FD4B534ACD8134866DBF0FC | LANDING_VIDEO_SRC | 已跟踪；当前 v1.2 契约标为备用，不能表述为默认已播放 |
| 系统场景背景 | public/bg/scenes/{account_empty,save_empty,status_danger,status_good,gameover_pressure,gameover_warning}.png，6 张 | src/data/scenes/backgrounds.tsx 的 BG_SCENE | 已跟踪；可由 BackgroundImage 渲染 |
| 主厅横幅 | public/images/main-hall-banner.webp，1 张 | BG_SCENE.mainHallBanner | 已跟踪；主厅宽横幅 |
| UI 图集 | public/assets/ui/packed/{atlas_1,atlas_2,atlas_3}.png，3 张 | src/sprites.css | 已跟踪；运行时 CSS sprite 图集 |
| 员工缩略立绘 | public/portraits/thumbs/{tong,li,bai,guo,lu}.webp，5 张 | src/components/staffVisuals.ts | 已跟踪；员工界面使用 |
| 月 1 核心角色 | public/portraits/{tong,bai,guo,lu,li,mobei}.png，6 张；public/assets/avatars/01-xing-butou.png，1 张 | src/data/storyEvents/year1Showcase/characters.ts | 已跟踪；月 1 由 Owner 于 2026-07-23 确认可继续使用；保持 object-contain，不可把它们描述为透明半身素材 |
| 顾客头像包 | public/assets/avatars/01-20-*.png，20 张 | src/gameData.ts 的头像基路径与顾客数据链 | 已跟踪；数据链可解析，单张实际展示仍应随相应顾客流程验证 |
| 通用道具图标 | public/icons/tongfu/*.png，16 张 | src/components/tongfuIcons.tsx | 已跟踪；包含铜钱、算盘、账本、欠条、令牌、招牌等 |
| 月 1 场景 | public/story/year1/month01/original/day{01-opening,03-review,10-credit,30-closeout}-hall-v1.png，4 张，均为 1600x900 RGB PNG | src/data/storyEvents/year1Showcase/month01.ts | 未跟踪；当前代码会引用，发布前必须纳入版本控制 |
| 月 1 招牌 | public/icons/tongfu/wulin/01-plaque.svg，1 张 | month01.ts Day 1 道具位 | 已跟踪；其余 11 张武林 SVG 未见当前游戏代码静态调用 |
月 1 场景的来源与验收
四张场景由 Owner 提供的 pic/fdb549ff-e8da-4333-8d64-ae3378535006.png 四格源图切分、去分隔线并使用 Lanczos3 缩放得出；未重绘、未把现有角色图作为生成输入。
| 节点 | 运行时文件 | SHA-256 | 视觉焦点 |
| --- | --- | --- | --- |
| Day 1 | day01-opening-hall-v1.png | 7E8ED13064CDA5F65EA37EDCEFBBB11401C95D311C568DBB9EFAA30089678B71 | 红绸招牌，center top |
| Day 3 | day03-review-hall-v1.png | A3E0684E0577503A382DBD4A30251D3D652A23BCBD646690F4353782C8635C5C | 账本与算盘 |
| Day 10 | day10-credit-hall-v1.png | 84E16904E0905FC8C1A3A1AFFF390D65DAD2694AF6736679E036FEA67D4606E3 | 铜钱、令牌与空碗 |
| Day 30 | day30-closeout-hall-v1.png | AF2E3C859985120A658FCD3E891BA42E5B0301180A3AD67C3F84B2E145B35F1C | 合拢账本、灯火与杯盏 |
来源、裁切坐标和桌面/390px 竖屏验收记录见 docs/art/2026-07-23-month1-empty-hall-intake-v1.md；Owner 风险确认见 docs/art/2026-07-23-month1-owner-asset-clearance-v1.md。这两份记录是 Owner 决策，不替代第三方授权或法务意见。
3. 文件存在，但不能直接按“已接入”处理
| 资源组 | 现场数量 | 当前判断 |
| --- | ---: | --- |
| public/banners/ | 2 张 PNG | 旧横幅副本；未发现当前 src/** 对 /banners/ 的静态调用，不能替代 public/images/main-hall-banner.webp 的当前使用结论 |
| public/portraits/tongfu-pack-02/ | 20 张角色 WebP + 1 张 contact sheet | 存在但未见当前展示链调用；月 1 邢捕头使用的是 assets/avatars/01-xing-butou.png，不回退到该 WebP |
| public/icons/tongfu/{attr,func,buff}/ | 7 + 8 + 64 个 SVG | 资源与预览页完整存在；当前游戏代码未发现这些目录的静态路径调用，不能把“有图标库”写成“Buff/属性 UI 已接线” |
| public/icons/tongfu/wulin/ | 12 个 SVG | Day 1 仅使用 01-plaque.svg；其余 11 个目前是可复用库存 |
| public/assets/ui/packed/ 元数据 | 3 个 atlas JSON + viewer.html | PNG 图集已由 CSS 使用；JSON 和 viewer 未见当前应用调用 |
| public/assets/ui/{cropped,unpacked,slices/_archive}/ | 3 个裁切图 + 35 个解包 sprite + 9 个归档切片 | 生产资源加工物或归档件；当前应用的静态路径只命中 packed/*.png，不得把它们当作直接 UI 依赖 |
| public/assets/external/ | 2 张二维码 | 文件已跟踪，但未发现当前静态调用；群二维码文件名为 wechat-group-qr-2026-07-20.png，有效性需由运营重新确认后再对外展示 |
| music/bgm/*.mp3 | 1 个 MP3，约 1.88 MiB | 已跟踪但不在 public/，且当前回归约束禁止 .mp3/HTMLAudioElement 接入；只能作为本地参考，不是可发布 BGM |
4. 源素材与审计产物
这些文件可用于制作、核验或回溯，不能按运行时资源接入：
| 位置 | 数量 / 体积 | 状态与边界 |
| --- | --- | --- |
| pic/ | 108 个文件，约 310.64 MiB；其中 103 个未跟踪 | 原图、拼图、切片、提示词和检查材料。不得由“文件在 pic/”推导为运行时可用或可公开发布 |
| pic/剧情/ | 7 个文件，约 19.22 MiB | 历史剧情拼图/审计来源；月 1 正式运行时已改用 public/story/.../original/ 四张无人场景 |
| pic/素材7.3号/ | 2 个文件，约 232.92 MiB | 系统背景的原始拼图来源，不直接由浏览器加载 |
| outputs/story/year1/month01/ | 12 个文件，约 3.72 MiB | manifest、审计裁切、contact sheet 与生成资料；审计件持续为非运行时资源 |
| docs-site/** | 工作区未跟踪的派生静态站 | 文档渲染产物，不属于游戏资产包，也不纳入本清单的数量 |
5. 发布前必须处理的事实
- 将月 1 的四张
public/story/year1/month01/original/*.png及同目录说明文件纳入 Git，再进行下次构建/部署验收；当前它们既未跟踪也未被忽略。 - 不把
music/bgm/*.mp3接入或随发布物复制。若要加入音频，需先有独立的来源、授权、发布路径和运行时接线决策。 - 继续从
public/assets/ui/packed/atlas_*.png使用 sprite；slices/_archive/是归档，不作为新的运行时依赖。 - 新增资源时最少记录：稳定路径、调用点、尺寸/格式、来源、SHA-256、授权/Owner 决策、Git 状态和桌面/竖屏验收结果。
6. 核验方法
- 文件现场盘点：
public/、pic/、music/、outputs/story/year1/month01/。 - 调用核验：搜索当前
src/**中/images/、/bg/、/assets/、/portraits/、/icons/、/story/、/videos/路径。 - Git 核验：
git status --short --untracked-files=all -- public pic music outputs/story/year1/month01，并对月 1 场景使用git ls-files --error-unmatch和git check-ignore -v复核。
本清单是 2026-07-24 工作区快照。文件的存在、当前引用、Git 收录、Owner 风险确认和外部授权是五个不同状态，后续更新必须分别记录。