同福客栈 · 剩余 UI 缺口清单 v1 · 专题

整理日期：2026-08-03 承接：docs/uirefactor/2026-06-24-ui开发计划缺失表.md + docs/plans/active/2026-08-月开发计划-v1.md §6/§1.2 范围：8 月明确 Hold 的 UI · 8 月非阻塞 checklist · 6-24 设计缺口 · 关键素材接入状态 不进 in-flight：本表是 backlog 候选池，P1 拍板后升 task

§0 TL;DR

| 类别 | 数量 | 性质 | |---|:-:|---| | 8 月非目标 Hold UI | 4 | 主动搁置，等 P1 拍板重启 | | 8 月非阻塞 checklist | 3 | 已 verified 转显式保障债，8 月不抢 | | 6-24 设计缺口 | 3 | 缺独立设计文档 / 缺统一收口 | | UI 素材待接入 | ~5 项 | 美术已落，UI 接入要单独做 | | 总 UI 缺口 | ~15 项 | — |

§1 8 月非目标 · 明确 Hold UI

来自 2026-08-月开发计划-v1.md §6 8 月非目标：

| # | UI 模块 | 现状 | 8 月处置 | 重启条件 | |:-:|---|---|---|---| | 1 | 烛火音乐（BGM 接入）| music/bgm/ 1 个 MP3 不在 public/，且当前回归约束禁止 .mp3 / HTMLAudioElement 接入 | 明确 Hold | 移除回归约束 + 决策接入路径 | | 2 | 法务 3 modal（隐私 / 用户协议 / 版权） | 未实装，外部链接无 | 明确 Hold | P1 拍板文案 + 决策接入入口 | | 3 | i18n（多语言）| 未实装 | 明确 Hold | P1 拍板目标语言 + 文案预算 | | 4 | 游戏设置 modal | 未实装 | 明确 Hold | P1 拍板设置项 + 持久化策略 |

共同点：都需要 P1 拍板才能动。8 月不抢，不进 in-flight，不派 worker。

§2 8 月非阻塞 checklist · 显式保障债

来自 2026-08-月开发计划-v1.md §1.2 7 月剩余：

| # | 项 | 缺口 | 8 月处置 | 截止 | |:-:|---|---|---|:-:| | C-1 | R10 联机 UI owner review | 4 态截图 + 掉线/重连/房主转移 3 张 + 视觉规范 12 项 + auction 一致性 6 项 | P1 验收，非工程，8 月不抢 | 等 P1 验收窗口 | | C-2 | 第 360 日胜利页 owner review | 玩家路径与文案验收 | P1 验收，非工程，8 月不抢 | 等 P1 验收窗口 | | C-3 | N1 跨真实设备 / 复杂 NAT | 现有证据仅同机双浏览器 | 工程验证，需真实设备 | 8 月下旬如有设备再补 |

C-1 现状（来自 2026-07-02-ui-art-backlog.md）：R7 实时竞价 + R8 5s 流放 + 房主转移 7-17 W29 verified，UI owner review 待 P1。 C-2 现状：第 360 日胜利页（F1 失败链 v1.2 已实装），文案 + 路径待 P1 验收。 C-3 现状：N1 transport 已实装（同机双浏览器 verified），跨真实设备 / NAT 等环境。

§3 6-24 设计缺口 · 缺文档 / 缺收口

来自 docs/uirefactor/2026-06-24-ui开发计划缺失表.md：

| # | UI 模块 | 现状 | 行动 | |:-:|---|---|---| | 1 | 系统门厅 / 入口层 | 账号、多周目、存档、Buff 相关文档有分散描述；无独立系统门厅设计稿 | 按 6-24 UI 需求收口执行，设计规则后补 | | 2 | 江湖简报 / 消息中心 | 已有 docs/uirefactor/主页/江湖简报.png + 优化稿；缺统一设计文档 | 先按需求落地（MessageCenterPanel.tsx 已存在），设计规则后补 | | 3 | 事件表目录内容层 | 玩法逻辑在 剧情与随机事件结合玩法设计.md；EventTableDirectoryPanel.tsx 已实装完整 283 行（搜索/筛选/三栏），但缺独立设计收口 | 实装完成度 100%，待补设计收口文档 | | 4 | 竖版 / 横版壳统一收口 | 6-24 需求 + 账号 UIUX 历史稿；缺当前版本正式收口稿 | 双壳 UI 已按 8 月计划不主动拆；规则不补 |

§4 UI 素材待接入状态

关键事实：美术已落 ≠ UI 已接入。docs/art/2026-07-24-verified-resource-inventory-v1.md 区分**"已存在"** vs "已接入运行时"。

§4.1 已落未完全接入

| 资源 | 状态 | UI 接入点 | 缺口 | |---|---|---|---| | 28 张 Year 1 精选场景 | 已落 28/28 | src/data/storyEvents/year1Showcase/month01-10.ts scene.src | 接入测试 + 月 11-12 节点 | | 6 张系统场景 | 已接入 BG_SCENE 7 键 | src/data/scenes/backgrounds.tsx | 6 主角 6 月份节点中的引用尚需扩 | | 32 主角立绘 | 已落 | src/data/storyEvents/year1Showcase/characters.ts | 6 主角 6 月份节点中的引用尚需扩 | | 107 同福图标 | 已落 107/107 | src/components/tongfuIcons.tsx | 16 个已接入，91 个仅预览存在 | | 262 段对白语音 | 已落 262 段 | src/data/audio/year1Voice.ts | 听感验收待人工（technical_verified_listening_pending） |

§4.2 美术缺口映射 UI 影响

| 美术缺口 | 数量 | UI 影响 | 优先级 | |---|:-:|---|:-:| | Year 1 月 11-12 场景 | 4 | StoryShowcaseVisual 回退 CSS 大堂 | P0（运行时已预接线） | | Buff 图标（客栈 8 + 角色 54）| 62 | 玩家看到 Buff 文字但认不出类型 | P0（可玩性阻塞） | | 月 04 节点（4 张被 Year 1 覆盖）| 2 | 需补：扩建动工 / 解锁祝无双 / 二楼开放 / 满月小结 | P1 | | 跨剧情立绘 C2-C8 | 8 | 角色支线高光节点缺图 | P1 | | 跨剧情道具 D1-D4 | 30 | 支线事件触发时无信物视觉 | P1 | | 经营底图 5 张（大堂 / 后厨 / 后院 / 账房 / 库房）| 5 | 经营页背景缺失 | P0（开发计划 M1 复用） |

完整美术缺口在 docs/art/美术资源总览-v2.md §3。

§5 推进建议（按"紧迫性 + 启动门槛"分层）

§5.1 主动搁置（不抢 8 月）

4 项 Hold + 3 条 checklist + 4 项设计缺口 = 11 项这些等 P1 拍板 / 验收窗口才能动，8 月不抢。

§5.2 可派生"轻量"任务（不占主线）

5 项美术 → UI 接入的工程活不在 8 月主计划内，但可在 M1-M8 之间并行（M1/M5/M6/M7/M8 空闲窗口）工时估算：每项 0.5-2 天

§5.3 推进优先级矩阵

| 顺序 | 任务 | 启动条件 | 估时 | 依赖 | |:-:|---|---|:-:|---| | 1 | Buff 62 图标补全 | 美术资源总览 P1-01/02 拍板 | 6-9h | 美术优先 | | 2 | Year 1 月 11-12 4 张场景 | 美术生成 + 接入 | 2-3h | 美术+工程 | | 3 | 月 04 节点补图 2 张 | 美术生成 + 接入 | 1-2h | 美术+工程 | | 4 | P0 经营底图 5 张接入 | 美术生成后接入 | 1-2h | 美术 | | 5 | 跨剧情立绘 C2-C8 接入 | 立绘生成后接入 | 4-5h | 美术 | | 6 | 跨剧情道具 D1-D4 接入 | 道具生成后接入 | 3-4h | 美术 | | 7 | R10 联机 UI 4 态截图 | P1 验收窗口 | 0.5-1d | 验收排期 | | 8 | 第 360 日胜利页 owner review | P1 验收窗口 | 1d | 验收排期 |

§5.4 联动工作流

美术补图（docs/art/美术资源总览-v2.md）→ 落档 public/ → 接入 src/ → 测试 → 报告
                                        ↑                           ↓
                                        └── 本表跟踪"接入状态" ─────┘

§6 关联文档

§7 缺口闭环检查

| 类别 | 闭环标志 | |---|---| | Hold UI（4 项） | P1 拍板重启条件 + 拍板日落 8 月计划 §6 | | Checklist（3 项） | C-1/C-2 等 P1 验收窗口 / C-3 等真实设备 | | 设计缺口（3 项） | 收口文档（独立 .md）落地后转"已实装" | | 素材接入（5 项） | verified-resource-inventory-v1.md 标"已接入运行时" | | 美术映射（6 类） | 美术资源总览-v2.md 缺口完成度 100% |

武林外传 · 七侠镇刊印 · 同福客栈挂机游戏 · 剩余 UI 缺口清单 v1 2026-08-03