# QNI 房间研究项目验收与剩余任务

更新时间：2026-08-18（HKT）

本清单按用户历次要求逐项核验，区分“已完成”“部分完成”“受客观条件限制”。“入口被看到”不计为深度完成；只有文案、状态逻辑、限制与证据被写入台账才计入覆盖。

## 一、总体结论

主体研究和本地 HTML 报告已经形成：创建链路、房型、三组菜单、14 项房间玩法、24 项玩法 Box 映射、单轮房间列表热度、六大模块、Wira/Laboo 差距与优先级均有结构化交付物。房间“游戏题库”也已按当前可见服务端目录完整滚动到底：6 类 56 条目录全部保存；海龟汤 20 条、看图猜词 4 类和谁是卧底 6 类完成深层答案采集，并拆出 90 组卧底词对。

当前仍需重点关注三类内容：11 张历史、动画页或诊断截图本身缺同名 XML，但所有用于题库正文结论的深层页面均有配对证据；PRD 精选图保留了原始账号/房间信息，尚不是可对外分发的脱敏版；4 款用户称已开发的游戏未出现在当前 GitHub 远端 `main`，另有 5 组 QNI/Wira 名称与规则映射仍需产品确认。

## 二、逐项验收

| 要求 | 状态 | 当前证据 | 说明 |
|---|---|---|---|
| 创建房间完整链路 | 已完成（有历史截图缺口说明） | 主报告第 2 章；截图 01–05、162 | 已记录“一步创建”、默认房名/房号、默认房型与席位；未为补图破坏性解散房间 |
| 房间类型全量遍历 | 已完成 | `data/room_types.csv`，14 条 | 记录用途、席位、启动条件、切换影响、权限与证据 |
| 基本功能逐项遍历 | 已完成 | `data/menu_coverage_matrix.csv` | 8/8 可见项有台账；滚动区域已检查 |
| 房间工具逐项遍历 | 已完成 | `data/menu_coverage_matrix.csv`、`data/management_tools.csv` | 8/8 可见项有入口、结果、限制或受限原因 |
| 房间玩法逐项深度遍历 | 已完成至安全边界 | `data/room_gameplay_activities.csv` | 14/14；均记录规则、角色、进入/启动、通用状态、商业化和证据；不启动正式多人对局 |
| 玩法 Box 24 项目录和映射 | 已完成 | `data/game_box_catalog.csv` | 24/24 有顺序、QNI 证据、Wira 目录或缺失说明 |
| 游戏题库全量保存 | 已完成（当前可见快照） | `data/question_bank_catalog.csv`，56 条 | 创意玩法 7、辩论 6、海龟汤 20、Pia戏 7、谁是卧底 6、情景模拟 10；全部滚动到“没有更多了” |
| 海龟汤题库深层采集 | 已完成 | `data/turtle_soup_question_bank.csv`，20 条 | 20/20 保存汤面、类型、难度、使用次数、主持手册、提示、汤底、截图和 XML |
| 看图猜词与卧底题库深层采集 | 已完成 | `data/creative_image_question_bank.csv`、`data/undercover_question_bank.csv`、`data/undercover_word_pairs.csv` | 4 类看图答案、6 类卧底主持规则、90 组标准化词对 |
| 玩法 Box 基本玩法整合 | 部分完成 | `data/game_box_basic_gameplay.csv` | 20 项有源码级核心循环；4 项远端 `main` 未发现，未按名称猜测 |
| 玩法 Box 房间化接入排序 | 已完成 | `data/game_integration_priority.csv` | 24 项逐项评分；区分用户热度与 Box 供给位置 |
| 房间列表单轮热度采样 | 已完成 | 原始 90 条、去重 66 条，7 个标签 | 明确为 11:09–11:16 HKT 单时点快照，不推断跨时段稳定热度 |
| 游戏/房间能力 P0–P3 | 已完成 | `data/feature_priority.csv`、`data/game_integration_priority.csv` | P0 留给房间底座；已有游戏按房间化接入价值分层 |
| 六大模块与能力结构 | 已完成 | 主报告第 9、12 章 | 包含模块树、数据模型、依赖顺序与通用状态逻辑 |
| 原始文案、细节、状态逻辑 | 已完成至可访问边界 | CSV 台账、214 份 UI XML、主报告 | 付费、邀请、踢人、管理员委派和正式开局只到安全边界 |
| 原始截图和截图索引 | 已完成 | 224 张 raw、`screenshot_manifest.csv` | 题库新增 47 张过程/结果截图；诊断截图也保留并标记，不纳入结论 |
| 每个关键状态有同名 XML | 已完成至可访问边界 | 214 份 XML | 截图清单中 213 张有同名 XML、11 张无同名 XML；题库逐题答案和目录结论页均按页面状态配对保存，动画恢复页 212 另有 164/177 等价配对证据 |
| PRD 精选截图 | 内部版完成，对外脱敏版未完成 | 44 张 `screenshots/prd/` | 新增 8 张题库精选图；当前保留第三方头像、昵称或房号以支持事实核验，不应直接公开分发 |
| 中文 Markdown 主报告 | 已完成 | `QNI房间功能与优先级研究报告.md` | 已含流程、房型、工具、玩法、热度、模块、映射、路线图和限制 |
| 中文本地 HTML 主报告 | 已完成 | `QNI房间功能与优先级研究报告.html` | 已按最终 Markdown 重新生成；离线 Mermaid、目录跳转、表格和全部本地链接通过浏览器验收 |
| 分板块业务优先级 | 已完成 | `data/business_priority_by_module.csv`、主报告第 11 章 | 29 项按六个板块排序，并区分业务第一、可立即开工、依赖阻塞和首期不做 |

## 三、本轮直接完成的收口项

- 新增 `data/game_integration_priority.csv`：24 款游戏逐项给出热度、Box 位置、互动价值、Wira 复用度、成本效率、总分、分层和接入判断，公式已复算通过。
- 将游戏优先级改写为“房间化接入优先级”，避免把已开发游戏误列为重新建设。
- 通过 ADB 新增 171–177 成对证据：音乐杀、秘密通画、默契猜词确认层，房间支持顶部/中段/规则末尾和最终恢复状态。
- 回写 `screenshot_manifest.csv` 与 `截图索引.md`；当前为 224 张原始截图、214 份 UI XML、224 条截图清单。
- 验证最终状态：房间 30180581 保留，聊天交友 6 麦位；未切换房型、未消费、未邀请、未发送内容；系统三项动画倍率均为 1.0。
- 重新生成本地 HTML，并通过真实浏览器检查新增章节和离线 Mermaid；唯一控制台请求错误是无关的 `favicon.ico` 404。
- 新增视觉验收截图：`evidence/html-report-priority-preview.webp`。
- 新增 `data/business_priority_by_module.csv`：把 29 项能力拆成房间核心闭环、游戏内容、互动留存、增长召回、经营商业化、数据质量六个板块，并明确全局顺序、首期范围、依赖和是否可立即开工。
- 新增 `data/question_bank_catalog.csv`：保存 6 类 56 条当前可见题库目录、原始标题、使用次数和完整列表说明。
- 新增 `data/turtle_soup_question_bank.csv`：海龟汤 20/20 保存汤面、主持手册、可提示线索、汤底、截图/XML 和覆盖等级。
- 新增 `data/creative_image_question_bank.csv`、`data/undercover_question_bank.csv`、`data/undercover_word_pairs.csv`：保存 4 类看图答案、6 类卧底规则和 90 组词对。
- 新增题库证据 165–212，并回写截图清单、截图索引、Markdown 和本地 HTML；题库关闭后房间恢复聊天交友 6 麦位，未消费、未邀请、未发送内容、未启动正式多人对局。

## 四、当前客观限制

### 1. 当前远端主线缺少 4 款游戏

已核对本地 `wira-mini-games` 与 GitHub 远端：`origin/main` 和远端 `main` 指向同一提交，远端未公布其它分支或 tag。以下 4 项没有可审计源码，因此只保留 QNI 列表/预览事实，不臆测核心规则：

- 挖宝达人
- 剪影墙
- 成分鉴定瓶
- 雪战上海滩

完成条件：把实际实现推送到可访问分支，或提供对应目录/提交 SHA。

### 2. 五组规则映射待产品确认

- 击飞喵 ↔ 拦路喵
- 碰壁弹球 ↔ 打砖块
- 盖个摩天楼 ↔ 都市摩天楼
- 高雅企鹅下楼 ↔ 保持高雅
- 乌萨奇报到 ↔ 乌萨奇吃到

它们都有相近源码证据，但名称相似不能自动证明素材、数值和规则完全一致，故置信度保持“中”。

### 3. 安全边界内无法完整实测的功能

管理员委派、踢真实用户、付费、发礼物、发送邀请、公开广播和正式多人开局均未执行。报告只记录入口、确认层、限制文案或人数/角色条件，不把未执行动作标记为完成链路。

### 4. 题库是单时点服务端快照

本轮已将当前账号可见的六类公共题库全部滚动到“没有更多了”，所以对 **2026-08-18 当前版本可见目录** 可判定为全量；如果服务端后续增删、调序或替换题面，需要按题目 ID/版本再次做增量采集。Pia戏、辩论和情景模拟已保存全目录及列表全文，但未逐条激活可能影响房间看板的长文本内容；不能把目录保存等同于完整主持运行验证。

## 五、建议后续顺序

1. 研发先并行建设 P0 上线闸门：房间生命周期、角色治理、RTC/麦位、H5 房间 Bridge、统一开局/结算、公共列表、异常恢复和核心漏斗。
2. 不等待缺失源码，先用引力球、房间抽奖工具和 QniTI 验证操作型 H5、房间多人工具和低实时破冰三种接入形态。
3. 同步 4 款缺失游戏的真实源码，并确认 5 组同义/近义映射；挖宝达人源码就绪后作为业务热度最高的经营型样板接入。
4. P0 稳定后优先建设主持题库引擎、投票/答题/AI计分插件和图片 UGC 能力包，再扩复杂多人玩法。
5. 若报告需要外发，再制作严格脱敏截图包；当前 `screenshots/prd/` 仅建议内部使用。

## 六、证据判定规则

- **界面实测**：有 ADB 截图、动作结果和同状态 UI XML，置信度高。
- **源码证据**：从当前 Wira 仓库的页面、脚本、配置或数据文件抽取，置信度高；跨产品映射仍可能是中。
- **静态资源证据**：只证明存在文案、图标或入口，不证明运行时链路。
- **产品推断**：由名称、页面结构或相近实现推导，必须显式标注，不能代替实测。