新建项目

docs/DEMO_GUIDE.md

@@ -0,0 +1,66 @@
+# 藏猫猫计划 MVP：5 分钟演示脚本
+
+版本：0.1.0-mvp
+
+## 演示前准备
+
+1. 在微信开发者工具中导入项目并编译。
+2. 清除 Storage，重新编译，确认演示房间 `731204` 自动生成。
+3. 从首页开始录屏或讲解。
+
+## 0:00～0:40 产品定位
+
+- 展示首页和“怎么玩”。
+- 说明产品是线下真人追逃的数字主持人，强调安全、少看屏幕和模糊信息。
+- 打开安全规则，展示无身体接触、场地边界和安全退出原则。
+
+## 0:40～1:40 创建一局
+
+- 点击“创建一场游戏”。
+- 演示经典/感染模式切换及主要规则设置。
+- 勾选安全承诺并创建房间。
+- 在候场页展示房间码、分享入口、规则摘要和模拟玩家。
+
+## 1:40～2:30 候场与开局
+
+- 展示全员准备状态和至少 4 人的开局条件。
+- 点击“分配身份并开始”。
+- 讲解寻找者和躲藏者的身份任务差异。
+- 等待演示加速后的准备倒计时进入正式追逃。
+
+## 2:30～3:50 核心玩法
+
+- 使用一次雷达，展示技能使用状态会持久保存。
+- 在目标列表选择一名躲藏者。
+- 点击演示口令并提交抓捕。
+- 感染模式下指出目标会转为寻找者；经典模式下则进入被抓状态。
+- 展示实时事件、剩余人数和 30 秒动态口令机制。
+
+## 3:50～4:30 安全与房主管理
+
+- 演示暂停和继续，说明暂停期间倒计时冻结。
+- 打开“安全与退出”，展示联系房主和安全退出流程。
+- 强调正式版不会依靠身体接触完成抓捕。
+
+## 4:30～5:00 结算与复玩
+
+- 连续完成抓捕，或使用“提前结束”进入战报。
+- 展示胜负、实际用时、事件数、角色转化和稳定排名。
+- 点击“按原规则再来一局”，确认规则保留、本局状态清空。
+
+## 备用路径
+
+如果创建流程中的缓存状态影响演示：
+
+1. 返回首页。
+2. 点击“输入房间码加入”。
+3. 使用演示房间 `731204`。
+4. 演示房间会自动准备并允许当前用户代行房主操作。
+
+## 演示口径限制
+
+- 当前版本是本地模拟 MVP，不是真实多设备房间。
+- 雷达、位置线索和安全边界是模拟结果，没有采集真实位置。
+- 动态口令在本地按 30 秒变化，但没有服务端签名和距离校验。
+- 分享卡片可以携带房间码，但不同设备之间不会同步同一份本地数据。
+

docs/DEVICE_TEST_CHECKLIST.md

@@ -0,0 +1,63 @@
+# 第 6 天：微信开发者工具与真机验收清单
+
+执行状态：待连接微信开发者工具和真实设备执行。  
+代码侧检查：已完成。
+
+## 1. 基础环境
+
+- [ ] 使用微信开发者工具导入项目，编译无 JS、WXML、WXSS 错误。
+- [ ] 分别使用 iOS 和 Android 真机预览；如只有一台设备，记录设备型号和微信版本。
+- [ ] 清空缓存后首次进入首页，页面无白屏或布局跳动。
+
+## 2. 核心流程
+
+- [ ] 创建经典模式房间，完成候场、开局、抓捕、结算和复玩。
+- [ ] 创建感染模式房间，确认被抓玩家转为寻找者。
+- [ ] 使用演示房间 `731204` 可单人完成全流程。
+- [ ] 从分享卡片进入时能够自动带入房间码并加入。
+
+## 3. 页面与屏幕适配
+
+- [ ] 小屏设备上首页标题、倒计时、三个统计卡片不溢出。
+- [ ] 16 字房间名、10 字昵称在候场和战报中不挤压按钮。
+- [ ] 玩家列表达到人数上限时可以正常滚动。
+- [ ] 三个安全操作按钮布局完整，没有遮挡底部安全区。
+- [ ] 空事件、无效房间和战报丢失时显示可返回首页的恢复页。
+
+## 4. 微信能力
+
+- [ ] 复制房间码成功，并显示成功反馈。
+- [ ] 候场分享卡片标题和路径正确，接收方可进入加入页。
+- [ ] 战报分享卡片标题正确，接收方进入首页。
+- [ ] 阶段开始、线索广播、技能和抓捕的震动反馈符合预期。
+- [ ] 用户关闭系统震动时，操作不会报错或阻塞流程。
+
+## 5. 生命周期与弱网模拟
+
+- [ ] 准备阶段切到后台 10 秒后返回，按原时间进入正式游戏。
+- [ ] 正式游戏切到后台后返回，倒计时没有重新开始。
+- [ ] 暂停游戏后切换前后台，剩余时间保持冻结。
+- [ ] 连续快速点击创建、加入、开始、抓捕和复玩，不产生重复数据。
+- [ ] 开发者工具切换离线后，本地原型核心流程仍可运行。
+
+## 6. 安全与权限
+
+- [ ] 非房主界面不显示暂停和提前结束按钮。
+- [ ] 安全退出确认后返回首页，不能继续进入已退出的当前房间。
+- [ ] 联系房主显示原型能力边界说明。
+- [ ] 躲藏者只能看到自己的口令。
+- [ ] 非演示模式下寻找者不显示自动填入口令入口。
+
+## 7. 结果记录
+
+测试完成后记录：
+
+- 测试日期：
+- 开发者工具版本：
+- 微信基础库版本：
+- iOS 设备与微信版本：
+- Android 设备与微信版本：
+- 阻塞缺陷：
+- 其他问题：
+- 是否允许进入第 7 天交付回归：
+

docs/ONE_WEEK_MVP_PLAN.md

@@ -0,0 +1,434 @@
+# 藏猫猫计划：一周 MVP 设计与实施规划书
+
+版本：1.0  
+周期：7 天  
+目标形态：微信小程序可演示 MVP  
+规划日期：2026-07-27
+
+## 1. 项目目标
+
+在一周内交付一个能够在微信开发者工具和真机上稳定运行的小程序，让一名用户无需后端、无需真实好友在线，即可完整体验：
+
+```text
+创建/加入房间 → 候场 → 身份分配 → 准备倒计时
+→ 正式追逃 → 技能/线索/口令抓捕 → 自动结算 → 再来一局
+```
+
+本周期的核心不是上线真实多人服务，而是完成一个流程闭环、规则清楚、状态可靠、适合演示和用户访谈的产品版本，为下一阶段熟人多人内测提供依据。
+
+### 1.1 成功标准
+
+- 新用户能在 2 分钟内创建或加入一局游戏。
+- 单人在模拟玩家辅助下可以走完全部游戏流程。
+- 经典模式和感染模式均能正确完成身份、抓捕与结算。
+- 页面刷新、前后台切换后，当前房间和游戏状态可以恢复。
+- 关键错误有明确提示，不出现无法继续操作的死路。
+- 安全规则在创建、候场和游戏过程中均有可见入口。
+- 核心流程通过开发者工具和至少 1 台真机验证。
+
+## 2. 本周范围
+
+### 2.1 必须交付（P0）
+
+1. 首页
+   - 创建游戏、加入房间、安全规则入口。
+   - 继续上一场未完成游戏。
+
+2. 创建游戏
+   - 房间名称、游戏模式、时长、准备时间、人数、寻找者数量、线索间隔、场地半径和技能开关。
+   - 基础参数校验和安全承诺。
+
+3. 加入与候场
+   - 六位房间码和演示房间。
+   - 昵称确认、房间预览、模拟玩家补充。
+   - 玩家准备、房主开局、规则摘要和邀请入口。
+
+4. 游戏主流程
+   - 准备阶段与正式游戏阶段。
+   - 寻找者/躲藏者差异化界面。
+   - 周期性模糊线索、雷达、静默和四位抓捕口令。
+   - 经典模式淘汰和感染模式转化。
+   - 超时或全部抓捕后的自动结算。
+
+5. 结算与复玩
+   - 获胜阵营、玩家表现、抓捕数和参与结果。
+   - 按原规则再来一局、返回首页和分享入口。
+
+6. 稳定性与体验
+   - 本地数据异常时的兜底处理。
+   - 防止重复开局、重复结算和重复抓捕。
+   - 页面卸载时清理计时器。
+   - 空状态、按钮禁用态和错误提示。
+
+### 2.2 尽量完成（P1）
+
+- 游戏暂停与继续。
+- 房主提前结束游戏。
+- 模拟玩家自动产生少量抓捕或事件，使躲藏者视角也能完成演示。
+- 技能冷却或剩余次数展示。
+- 结算称号根据实际数据生成。
+- 简单的游戏历史记录。
+
+### 2.3 本周不做
+
+- 微信正式登录和账号体系。
+- 多设备实时房间同步、WebSocket 和断线重连。
+- 真实地图选区、定位上报和地理围栏。
+- 服务端动态口令、距离验证及完整防作弊。
+- 附近陌生人组局、聊天、商城、积分和排行榜。
+- 运营后台、举报审核和复杂未成年人体系。
+- 正式发布所需的完整隐私合规与安全备案工作。
+
+上述能力不能用前端模拟结果包装为真实能力。界面中涉及位置和防作弊的内容应明确标注为原型演示。
+
+## 3. 用户与业务设计
+
+### 3.1 核心用户
+
+- 房主：配置规则、组织玩家、开始和结束游戏。
+- 普通玩家：加入房间、准备、获得身份并参与游戏。
+- 演示用户：单人使用模拟队友验证全部流程。
+
+### 3.2 核心状态机
+
+房间状态：
+
+```text
+waiting → preparing → playing → paused（可选） → finished
+```
+
+玩家状态：
+
+```text
+idle ↔ ready
+ready → hiding / seeking
+hiding → caught（经典模式）
+hiding → seeking（感染模式）
+```
+
+必须遵守的状态规则：
+
+- 只有 `waiting` 状态允许加入和切换准备。
+- 至少 4 名玩家且寻找者少于总人数时才允许开局。
+- 只有 `preparing` 可以进入 `playing`。
+- 只有 `playing` 可以使用技能和提交抓捕。
+- `finished` 后不再接受任何游戏操作。
+- 重开时清空角色、抓捕、技能和计时数据，但保留房间设置与玩家。
+
+### 3.3 胜负规则
+
+- 经典模式：全部躲藏者被抓，寻找者胜；倒计时结束仍有躲藏者，躲藏者胜。
+- 感染模式：被抓者转为寻找者；最后一个躲藏者被转化后寻找者胜；倒计时结束仍有人存活则躲藏者胜。
+
+## 4. 技术设计
+
+### 4.1 本周架构
+
+```text
+微信小程序页面 pages/*
+        ↓
+本地领域服务 services/game-service.js
+        ↓
+wx Storage（房间、玩家、事件、结果）
+```
+
+继续使用原生 JavaScript，不新增 npm 依赖，不在一周期限内引入后端。页面不得直接修改房间对象，所有业务状态变化统一经过游戏服务，以便后续替换为云函数或 HTTP API。
+
+### 4.2 模块职责
+
+- `pages/*`：页面展示、用户输入、导航和生命周期管理。
+- `services/game-service.js`：房间状态机、角色分配、技能、抓捕、结算和持久化。
+- `utils/constants.js`：模式、默认规则、演示数据和枚举。
+- `utils/format.js`：倒计时、时间和通用数据处理。
+- `wx Storage`：保存当前版本的房间快照和当前房间索引。
+
+### 4.3 本周重点改造
+
+1. 将所有操作增加房间状态和角色权限校验。
+2. 为房间增加数据版本或 schema 版本，避免旧缓存导致页面崩溃。
+3. 让线索间隔使用创建时配置；演示加速通过独立配置控制。
+4. 将技能使用次数保存到房间玩家数据，而不是只存在页面内存。
+5. 抓捕时明确目标，或在演示模式中明确提示“当前模拟目标”。
+6. 将动态口令绑定目标和时间窗口，至少在本地实现定时变化与重复使用限制。
+7. 统一使用 `phaseEndsAt` 计算倒计时，恢复页面时不重新开始计时。
+8. 结算形成稳定快照，防止当前时间变化造成排名变化。
+9. 限制事件数量，并区分全员、寻找者和个人可见事件。
+10. 为不存在、损坏或已经结束的房间提供恢复路径。
+
+### 4.4 为后端演进预留的接口
+
+页面层保持以下语义接口：
+
+- `createRoom(payload)`
+- `getRoom(code)`
+- `joinRoom(code, player)`
+- `toggleReady(code, playerId)`
+- `startGame(code)`
+- `useSkill(code, skill)`
+- `capture(code, credential)`
+- `pauseGame(code)` / `resumeGame(code)`
+- `finishGame(code, reason)`
+- `resetRoom(code)`
+
+下一阶段可将接口内部替换为云函数或网络请求，而无需重写页面流程。
+
+## 5. 一周实施排期
+
+### 第 1 天：范围冻结与主流程体检
+
+状态：**已完成（2026-07-27）**
+
+- [x] 冻结 P0 范围和验收清单。
+- [x] 按现有代码和模拟运行完整走查创建、加入、候场、开局、技能、抓捕、结算与复玩流程。
+- [x] 记录创建、加入、开局、技能、抓捕、结算和复玩的缺陷。
+- [x] 梳理房间与玩家状态字段，补充缺省值和兼容策略。
+- [x] 建立本地游戏服务基线测试。
+- [x] 产出缺陷清单、状态模型和可稳定启动的基线版本。
+
+第 1 天实施结果：
+
+- 房间数据初始新增 `schemaVersion`；第 4 天因技能和口令状态扩展已升级为 `schemaVersion: 2`。
+- 启动时自动补齐旧缓存中的房间设置、玩家字段、事件字段和时间字段。
+- 非对象顶层缓存、无效房间和非法房间码会被安全忽略或清理。
+- 缺失或非法的房间/玩家状态会回退到有效状态，避免页面直接崩溃。
+- 事件历史统一限制为最近 20 条。
+- 新增本地服务回归测试，覆盖旧数据迁移、损坏缓存、完整游戏流程和复玩重置。
+
+主流程体检缺陷清单：
+
+| 编号 | 优先级 | 模块 | 问题 | 计划处理 |
+| --- | --- | --- | --- | --- |
+| D1-01 | P0 | 创建/开局 | 创建时可能出现寻找者数量不小于人数上限 | **已完成（第 2 天）** |
+| D1-02 | P0 | 候场 | 普通房间开局未校验房主权限和全员准备状态 | **已完成（第 2 天）** |
+| D1-03 | P0 | 状态机 | 重复开局、重复结束等状态迁移保护不足 | **已完成（第 3 天）** |
+| D1-04 | P0 | 计时 | 线索固定为 15 秒，未使用房间配置 | **已完成（第 3 天）** |
+| D1-05 | P0 | 技能 | 技能使用状态只在页面内存中，重新进入后可重复使用 | **已完成（第 4 天）** |
+| D1-06 | P0 | 抓捕 | 口令不随时间变化，且无法选择明确目标 | **已完成（第 4 天）** |
+| D1-07 | P0 | 抓捕 | 抓捕发起者角色校验不足 | **已完成（第 4 天）** |
+| D1-08 | P1 | 结算 | 同分排名使用当前时间参与比较，结果可能变化 | **已完成（第 5 天）** |
+| D1-09 | P1 | 安全 | 安全退出弹窗未真正更新玩家或房间状态 | **已完成（第 5 天）** |
+| D1-10 | P1 | 演示 | 躲藏者视角缺少自动事件，单人演示难以自然结束 | 第 5 天（有余量时） |
+
+说明：微信开发者工具和真实设备上的视觉、震动、分享及前后台能力仍按第 6 天计划执行真机验收；第 1 天完成的是代码路径走查与本地服务模拟回归。
+
+### 第 2 天：创建、加入与候场
+
+状态：**已完成（2026-07-27）**
+
+- [x] 完善创建参数校验，处理寻找者数量与人数上限冲突。
+- [x] 完善无房间、房间已满、已开局、已取消和已结束提示。
+- [x] 修复准备状态、房主权限和开局条件。
+- [x] 确保分享参数和演示房间可进入。
+- [x] 扩充创建、加入与候场服务回归测试。
+- [x] 产出从首页到成功开局的稳定链路。
+
+第 2 天实施结果：
+
+- 创建房间由服务层统一校验名称、模式、游戏时间、准备时间、人数上限、寻找者数量、线索间隔和活动半径。
+- 寻找者数量必须小于人数上限；页面切换人数上限时会自动调整冲突选项。
+- 六位码格式错误、房间不存在、房间已满、游戏已开始、已结束或已取消分别显示明确提示。
+- 只有房主可以开始普通房间；演示房间保留当前用户代操作能力。
+- 开局前统一校验至少 4 人、寻找者少于当前玩家数以及所有玩家已准备。
+- 游戏开始后禁止继续修改准备状态或重复开始。
+- 通过分享卡片携带的 `code` 参数仍可直接预览并加入；演示房间加入者自动准备，保证单人演示链路可启动。
+
+### 第 3 天：游戏状态机与计时
+
+状态：**已完成（2026-07-27）**
+
+- [x] 加固 `waiting → preparing → playing → finished` 状态迁移。
+- [x] 统一阶段时间和页面恢复逻辑。
+- [x] 使用规则配置驱动正式线索间隔，同时保留独立的演示加速配置。
+- [x] 处理前后台切换、页面重复进入和重复结算。
+- [x] 扩充状态迁移及正式/演示计时回归测试。
+- [x] 产出可靠运行的准备阶段和正式游戏倒计时。
+
+第 3 天实施结果：
+
+- 开始、进入追逃、线索广播、技能使用和结束游戏均增加合法房间状态校验。
+- 禁止重复开局、重复进入追逃阶段、非游戏阶段广播线索以及重复结算。
+- 房间新增独立 `runtime` 配置；当前本地 MVP 明确启用演示加速，不再把加速数值散落在业务代码中。
+- 关闭演示加速后，准备时长、游戏时长和线索间隔均严格使用创建房间时的分钟配置。
+- 阶段切换以原定 `phaseEndsAt` 作为下一阶段开始时间；应用回到前台时可以补算真实经过时间，不会重新开始倒计时。
+- 游戏页进入后台时停止本地轮询，回到前台立即恢复并校准状态，避免重复计时器。
+- 演示模式保持准备分钟按秒压缩、正式游戏最长 180 秒、线索每 15 秒一次，便于单人快速走查。
+
+### 第 4 天：身份、技能与抓捕
+
+状态：**已完成（2026-07-27）**
+
+- [x] 验证不同人数和寻找者配置下的角色数量合法性。
+- [x] 完成经典/感染两种抓捕行为。
+- [x] 技能次数持久化，技能关闭时隐藏入口。
+- [x] 改造本地动态口令的目标绑定、时效与重复使用限制。
+- [x] 补充寻找者和躲藏者两种视角及权限走查。
+- [x] 扩充身份、技能、抓捕与模式分支回归测试。
+- [x] 产出可重复验证的核心玩法闭环。
+
+第 4 天实施结果：
+
+- 玩家新增持久化的 `skillsUsed` 和 `silentPending`；重新进入页面后仍能识别技能已使用，重开房间时统一清零。
+- 本局关闭技能时不展示技能入口；开启技能时每名玩家每局只能使用一次对应身份技能。
+- 寻找者只能使用雷达，仍在躲藏的玩家只能使用静默；被抓或状态异常的玩家不能使用技能。
+- 寻找者抓捕前必须明确选择一名仍在躲藏的目标；躲藏者页面只显示属于自己的口令。
+- 四位口令绑定房间、目标玩家和 30 秒时间窗，到期自动变化。
+- 已使用口令保存在房间数据中并限制最近 50 条，不能重复提交。
+- 抓捕接口校验发起者必须是 `seeking` 状态的寻找者，目标必须是 `hiding` 状态的躲藏者。
+- 经典模式下目标转为 `caught` 并进入观战提示；感染模式下目标转为 `seeker/seeking` 并继续参与。
+- 最后一名躲藏者被抓后仍自动结算为寻找者胜利。
+
+### 第 5 天：结算、安全与异常流程
+
+状态：**已完成（2026-07-27）**
+
+- [x] 固化胜负判断、排名和结果文案。
+- [x] 完善再来一局的数据重置。
+- [x] 补充暂停/继续、安全退出、提前结束及异常操作提示。
+- [x] 检查并收紧敏感信息在错误角色界面的展示。
+- [x] 扩充暂停、退出、权限、结算快照和重开回归测试。
+- [x] 产出可以收口的正常流程和主要异常流程。
+
+第 5 天实施结果：
+
+- 游戏结束时生成不可变 `resultSnapshot`，固定玩家排名、初始/最终身份、抓捕数、存活时间、实际用时和事件数量。
+- 排名依次按抓捕数、存活时间、加入时间和玩家 ID 排序，不再依赖打开结果页时的当前时间。
+- 感染模式战报可展示“躲藏者→寻找者”，避免只展示最终角色造成误解。
+- 再来一局会清理阶段计时、暂停信息、口令使用记录、技能、抓捕、角色和结算快照，同时保留房间规则与玩家。
+- 房主可以暂停和继续游戏；暂停期间游戏倒计时与下一次线索倒计时均冻结。
+- 房主可以确认后提前结束并生成战报；非房主不能执行暂停、继续或提前结束。
+- “安全退出”会实际把玩家标记为 `quit`、清除当前房间入口并记录安全事件；最后一名躲藏者退出时自动结算。
+- “联系房主”在原型阶段明确提示使用约定的电话或微信，不伪造即时通讯能力。
+- 静默事件不再公开具体使用者姓名；躲藏者仍只看到自己的口令，寻找者的演示口令入口仅在明确的演示加速模式展示。
+
+### 第 6 天：体验打磨与真机测试
+
+状态：**功能实现与代码检查已完成（2026-07-27）；真机人工验收待连接设备执行**
+
+- [x] 统一加载态、空状态、禁用态、Toast 和弹窗文案。
+- [x] 完成小屏、长昵称、人数上限和事件列表的代码侧适配。
+- [x] 增加页面 WXML 事件与 JS 方法绑定契约检查。
+- [x] 防止创建、加入、开局、抓捕和复玩重复提交。
+- [x] 形成震动、分享、剪贴板、前后台切换和本地缓存真机验收清单。
+- [ ] 在微信开发者工具和真机执行清单（需要人工连接真实设备）。
+- [x] 代码侧未发现阻塞级与高优先级缺陷。
+- [x] 产出候选演示版本代码。
+
+第 6 天实施结果：
+
+- 加入页会在输入完整房间码后展示明确的不存在、已满、已开始、已结束或已取消状态，并只在允许加入时启用按钮。
+- 创建、加入、开局、抓捕和复玩增加提交中状态，防止快速重复点击。
+- 候场、游戏和战报页面在房间数据丢失时不再白屏，统一显示说明和返回首页入口。
+- 游戏事件为空时展示空状态；已取消的当前房间不会继续出现在首页。
+- 房间码复制成功后提供明确反馈。
+- 候场玩家昵称和战报昵称增加单行省略，房间名允许安全换行；游戏头部增加小屏适配。
+- 三个安全管理按钮重新布局，避免第三个按钮挤压。
+- 新增页面绑定契约测试，自动检查 WXML 引用的事件处理函数是否在对应页面 JS 中存在。
+- 新增独立真机验收清单 `docs/DEVICE_TEST_CHECKLIST.md`，覆盖双端屏幕、震动、分享、剪贴板、前后台、快速点击和安全权限。
+
+限制说明：当前执行环境无法启动微信开发者工具或连接用户真机，因此不能把真机清单虚假标记为通过。完成清单后才可将第 6 天整体状态更新为“全部验收完成”。
+
+### 第 7 天：回归、演示与交付
+
+状态：**代码与交付材料已完成（2026-07-27）；微信开发者工具及真机发布门禁待人工执行**
+
+- [x] 按验收用例执行游戏服务、页面契约和发布就绪自动回归。
+- [x] 在模拟 Storage 中清理缓存并验证首次启动、演示数据补种和完整流程。
+- [x] 准备 5 分钟演示脚本和已知限制说明。
+- [x] 更新项目导入、自动检查和运行文档。
+- [x] 将 MVP 版本冻结为 `0.1.0-mvp`。
+- [x] 整理下一阶段多人化进入条件。
+- [x] 产出测试报告、演示说明、版本说明和后续清单。
+- [ ] 在微信开发者工具完成最终编译并执行真机发布门禁（需要人工连接设备）。
+
+第 7 天实施结果：
+
+- 新增统一自动回归入口 `node tests/run-all.js`。
+- 新增发布就绪检查，验证小程序页面注册、页面四件套文件、项目类型、版本号和交付文档完整性。
+- 自动回归结果为游戏服务、页面事件契约、发布就绪检查全部通过。
+- `app.globalData.version` 固定为 `0.1.0-mvp`，README 同步标注版本用途和安全边界。
+- 新增 5 分钟演示脚本，覆盖定位说明、创建、候场、核心玩法、安全管理、结算和复玩。
+- 新增测试报告，明确自动覆盖范围、未覆盖的微信运行时能力和发布判断。
+- 新增版本说明，集中记录已交付能力、已知限制和下一阶段进入条件。
+- 当前版本可用于单设备产品演示和用户访谈，不允许描述为可直接承载真实多人户外活动的生产版本。
+
+自动回归结果：
+
+```text
+game-service tests passed
+page contract tests passed
+release readiness tests passed
+all automated checks passed
+```
+
+最终发布门禁：完成 `docs/DEVICE_TEST_CHECKLIST.md` 后，才可将第 6、7 天的设备验收项标记为完成，并决定是否交付真机演示。
+
+## 6. 验收用例
+
+### 6.1 主流程
+
+1. 用户创建感染模式房间，模拟玩家补足至可开局人数。
+2. 房主开始游戏，系统正确分配指定数量的寻找者。
+3. 准备倒计时结束后自动进入正式追逃。
+4. 寻找者使用雷达并通过有效口令完成抓捕。
+5. 被抓躲藏者转化为寻找者，人数统计同步变化。
+6. 最后一名躲藏者被抓后自动进入寻找者胜利结算。
+7. 用户按原规则重开，所有本局数据正确清零。
+
+### 6.2 分支流程
+
+- 经典模式中被抓者保持被抓状态，不转为寻找者。
+- 游戏超时且仍有存活者时，躲藏者获胜。
+- 技能关闭时不能使用雷达或静默。
+- 错误、过期或已使用口令不能完成抓捕。
+- 非房主不能开始或提前结束普通房间。
+- 不足 4 人、寻找者数量非法时不能开始。
+
+### 6.3 恢复与异常
+
+- 关闭并重新进入小程序后可以继续当前房间。
+- 游戏页面退出再进入后倒计时基于原结束时间恢复。
+- 房间数据不存在或损坏时返回首页并给出提示。
+- 快速重复点击开始、抓捕和结束不会产生重复结果。
+- 房间结束后不能继续使用技能或提交抓捕。
+
+## 7. 质量要求
+
+- P0 流程无阻塞级缺陷。
+- 页面 JS 无未捕获异常，WXML 无明显渲染警告。
+- 核心按钮在常见手机尺寸下可见且易于单手点击。
+- 重要操作有文字反馈，关键阶段变化可配合震动。
+- 本地房间事件限制数量，避免数据无限增长。
+- 所有演示能力与真实能力边界清晰，不误导测试用户。
+
+## 8. 人力与协作建议
+
+按 1 名熟悉微信小程序的开发者估算，一周可完成本规划中的 P0；P1 仅在 P0 提前完成时进入。建议每天结束前进行一次 20～30 分钟的完整流程回归，不将全部测试集中到最后一天。
+
+如果有第二名成员，优先分工如下：
+
+- 开发者：状态机、页面逻辑、数据兼容和缺陷修复。
+- 产品/测试：规则确认、真机用例、文案、安全流程和演示材料。
+
+## 9. 风险与应对
+
+| 风险 | 影响 | 应对方式 |
+| --- | --- | --- |
+| 一周内加入真实多人同步 | 架构和联调工作不可控 | 本周固定使用本地模拟，下一阶段单独建设后端 |
+| 原型时间压缩与正式规则混杂 | 测试结果失真 | 增加明确的演示加速配置，不直接改业务规则 |
+| 页面直接依赖本地数据结构 | 后续迁移成本增加 | 状态变更统一收口到服务层 |
+| 动态口令被误认为安全机制 | 产生错误安全预期 | 明确标注本地演示，正式版必须服务端校验 |
+| 真机能力验证太晚 | 最后一天出现兼容问题 | 第 3 天开始至少每天一次真机回归 |
+| 持续增加玩法 | 核心闭环无法按时稳定 | P0 冻结，新增需求统一进入下一版本 |
+
+## 10. 交付物
+
+- 可导入微信开发者工具并正常编译的小程序源码。
+- 可单人完成全流程的经典模式与感染模式。
+- 演示房间和模拟玩家数据。
+- 产品需求、技术设计和本实施规划书。
+- 核心验收用例与测试结果。
+- 已知限制和下一阶段多人化改造清单。
+
+## 11. 下一阶段建议
+
+一周 MVP 完成后，用 3～5 场用户访谈或现场模拟验证规则是否易懂、线索节奏是否合理、玩家是否频繁看手机以及安全提示是否有效。确认玩法成立后，再进入 2～4 周的熟人多人版建设，依次接入微信登录、云端房间、实时同步、服务端倒计时、定位与抓捕校验。

docs/PRD.md

@@ -0,0 +1,369 @@
+# 藏猫猫计划：产品需求文档
+
+版本：0.1  
+阶段：MVP 可交互原型  
+产品形态：微信小程序
+
+## 1. 产品概述
+
+### 1.1 产品定位
+
+“藏猫猫计划”是一款帮助用户快速组织线下真人追逃游戏的小程序。它通过房间邀请、身份分配、地图边界、模糊位置线索、抓捕确认和自动结算，承担线下游戏的主持人角色。
+
+产品不鼓励玩家持续盯着手机，而是利用语音、震动、倒计时和少量关键交互，让现实空间成为主要游戏场景。
+
+一句话表达：
+
+> 选择一块场地，邀请几个朋友，现实世界立刻变成游戏地图。
+
+### 1.2 目标用户
+
+- 朋友聚会：希望快速开始一场有互动感的户外游戏。
+- 校园社团：需要低成本组织多人活动。
+- 亲子家庭：希望进行范围可控的户外探索。
+- 企业团建：需要可配置、可复盘的团队项目。
+- 景区与营地：希望将场地包装成互动游戏内容。
+
+### 1.3 核心价值
+
+- 两分钟内完成组局，降低组织成本。
+- 自动处理分队、倒计时、线索和结算。
+- 通过有限位置信息保留躲藏和推理乐趣。
+- 用安全边界、越界提醒和紧急集合降低户外风险。
+- 通过战报和称号促进复玩与社交传播。
+
+### 1.4 产品原则
+
+1. 安全高于胜负。
+2. 模糊信息高于精确导航。
+3. 线下互动高于屏幕操作。
+4. 每位玩家尽量持续参与，减少被淘汰后的等待。
+5. 基础规则公平，付费内容不直接提供竞技优势。
+
+## 2. 游戏核心循环
+
+```text
+创建房间 → 邀请好友 → 候场确认 → 分配身份
+    ↓
+躲藏准备 → 正式追逃 → 线索与技能 → 抓捕确认
+    ↓
+阵营结算 → 趣味战报 → 分享/再来一局
+```
+
+一次标准游戏建议配置：
+
+- 人数：6～12 人
+- 场地：公园、校园、营地等低车流开放区域
+- 半径：300～800 米
+- 时长：30～45 分钟
+- 躲藏准备：3～5 分钟
+- 位置线索：每 5 分钟一次，只展示网格或大致区域
+
+## 3. 游戏模式
+
+### 3.1 MVP 模式
+
+#### 经典模式
+
+- 玩家分为寻找者和躲藏者。
+- 寻找者在规定时间内抓到全部躲藏者即获胜。
+- 任意躲藏者存活至倒计时结束，则躲藏阵营获胜。
+- 被抓玩家进入观战状态，不再显示其他躲藏者的实时信息。
+
+#### 感染模式
+
+- 初始仅有少量寻找者。
+- 躲藏者被抓后转化为寻找者并继续参与。
+- 最后一名未被抓的玩家获得“最终幸存者”称号。
+- 推荐作为默认模式，因为玩家被抓后无需长时间等待。
+
+### 3.2 后续模式
+
+- 占点模式：双方争夺地图中的虚拟据点。
+- 护送模式：护送目标到达终点，另一方负责拦截。
+- 宝藏模式：结合地图线索、二维码和现实任务点。
+- 暗号模式：通过线下对话或动作确认队友身份。
+- 伪装者模式：队伍中存在秘密身份和隐藏任务。
+- 亲子模式：小范围、短时长、监护人可见全员位置。
+- 自定义剧本：主办方配置角色、任务、道具与胜利条件。
+
+## 4. 角色和能力
+
+### 4.1 躲藏者
+
+- 目标：在时间结束前保持未被抓状态。
+- 可见信息：剩余时间、个人状态、安全边界、公开事件。
+- 基础技能“静默”：跳过一次周期性位置暴露。
+- 后续能力：假信号、分身、队友换位、紧急撤离提示。
+
+### 4.2 寻找者
+
+- 目标：在时间结束前完成抓捕。
+- 可见信息：剩余人数、周期性模糊线索、公开事件。
+- 基础技能“雷达”：检测附近是否存在未被抓的躲藏者，但不显示精确方向。
+- 后续能力：足迹、缩圈、虚拟封锁区、连续追踪奖励。
+
+### 4.3 房主
+
+- 配置场地、时长、模式和人数。
+- 开始、暂停或提前结束游戏。
+- 移除异常玩家。
+- 发起全员集合。
+- 处理抓捕争议和安全事件。
+
+## 5. 功能需求
+
+### 5.1 首页
+
+- 展示产品核心价值和主操作入口。
+- 提供“创建游戏”和“加入房间”。
+- 展示最近一场未结束的游戏，可继续进入。
+- 提供安全规则入口。
+- 后续增加历史战绩、常用队伍和附近活动。
+
+### 5.2 创建游戏
+
+房主填写：
+
+- 房间名称。
+- 游戏模式：经典或感染。
+- 游戏时长：15～90 分钟。
+- 准备时长：1～10 分钟。
+- 最大人数：4～30 人。
+- 初始寻找者人数。
+- 线索间隔：3～10 分钟。
+- 场地半径：200～1500 米。
+- 是否开启技能。
+
+校验规则：
+
+- 初始寻找者必须少于最大人数。
+- 游戏和准备时间必须在允许范围内。
+- 创建前必须勾选安全承诺。
+
+### 5.3 加入房间
+
+- 输入六位房间码加入。
+- 支持通过小程序分享卡片携带房间参数直接加入。
+- 展示房间名称、模式、房主和当前人数。
+- 玩家确认昵称和安全规则后进入候场。
+- 房间已满、已开始或已结束时给出明确提示。
+
+### 5.4 候场
+
+- 展示房间码、规则摘要和玩家列表。
+- 房主可以邀请好友、调整规则和开始游戏。
+- 玩家可以切换“已准备/未准备”状态。
+- 开始前进行定位、电量与网络提示。
+- 分配身份后，身份只对本人可见。
+- 开始游戏时先进入躲藏准备阶段。
+
+MVP 原型为便于单人演示，会自动加入模拟玩家。
+
+### 5.5 游戏进行中
+
+公共信息：
+
+- 当前阶段、倒计时、存活人数和边界状态。
+- 游戏事件流，如线索广播、技能使用和抓捕结果。
+- 安全按钮：暂停参与、紧急集合、联系房主。
+
+寻找者界面：
+
+- 模糊区域线索。
+- 雷达技能和冷却状态。
+- 输入动态口令完成抓捕。
+
+躲藏者界面：
+
+- 下次位置暴露倒计时。
+- 静默技能。
+- 供寻找者验证的动态四位数口令。
+- 自身是否越界或接近边界。
+
+### 5.6 抓捕确认
+
+推荐正式版流程：
+
+1. 寻找者在线下发现目标。
+2. 双方保持安全距离，不进行身体接触。
+3. 躲藏者展示周期性变化的二维码或四位数口令。
+4. 寻找者扫码或输入口令。
+5. 服务端验证双方距离、口令时效和玩家状态。
+6. 双方收到震动和结果提示。
+
+异常处理：
+
+- 口令错误时不泄露目标身份。
+- 相同口令不可重复使用。
+- 玩家可在短时间内发起争议。
+- 房主可查看事件记录并作出裁定。
+
+### 5.7 结算和战报
+
+- 展示获胜阵营和个人结果。
+- 展示存活时间、抓捕数、技能使用和移动距离。
+- 生成“最终幸存者”“最佳猎人”“极限逃脱”等称号。
+- 支持分享战报卡片。
+- 支持按原规则再来一局。
+
+### 5.8 安全中心
+
+- 游戏区域必须由房主明确设置。
+- 接近边界和越界时持续提醒。
+- 禁止将机动车道、水域、施工区和私人区域设为任务点。
+- 禁止身体冲撞、拉扯和强行进入封闭空间。
+- 提供一键退出、全员集合和紧急联系人。
+- 低电量、定位关闭或长时间失联时提醒本人和房主。
+- 未成年人参与公开活动时要求监护人同意。
+
+## 6. 隐私与合规
+
+### 6.1 数据最小化
+
+- 只在一局游戏期间采集实现玩法所需的位置数据。
+- 默认向其他玩家展示模糊区域，不展示精确坐标。
+- 游戏结束后删除精确轨迹，战报只保留聚合结果。
+- 陌生人房间隐藏真实姓名、微信号和完整头像信息。
+
+### 6.2 权限使用
+
+- 在用户开始需要定位的玩法前，再解释并请求定位授权。
+- 拒绝定位后仍可浏览规则，但不能进入正式游戏。
+- 相册和摄像头权限只在扫码或生成战报时按需申请。
+- 提供数据导出、历史清除和账号注销入口。
+
+### 6.3 风险提示
+
+- 小程序不是人身安全保障工具。
+- 房主必须确认场地合法、安全且适合活动。
+- 不建议在夜间、恶劣天气、高车流区域或陌生复杂地形进行游戏。
+- 发生危险时立即停止游戏并联系当地紧急服务。
+
+## 7. 状态模型
+
+房间状态：
+
+- `waiting`：等待玩家加入。
+- `preparing`：身份已分配，躲藏者准备中。
+- `playing`：正式游戏进行中。
+- `paused`：房主暂停。
+- `finished`：游戏结束。
+- `cancelled`：房主取消。
+
+玩家状态：
+
+- `idle`：未准备。
+- `ready`：已准备。
+- `hiding`：躲藏中。
+- `seeking`：寻找中。
+- `caught`：已被抓。
+- `spectating`：观战。
+- `offline`：暂时离线。
+- `quit`：退出游戏。
+
+## 8. 非功能需求
+
+- 房间关键事件同步延迟目标小于 1 秒。
+- 倒计时由服务端时间校准，客户端不得作为最终依据。
+- 弱网重连后能恢复身份、状态和剩余时间。
+- 精确坐标传输和存储必须加密并设置短生命周期。
+- 单局至少支持 30 人，后续活动版支持 100 人。
+- 关键按钮应适合户外单手操作，并提供震动或声音反馈。
+- 页面应在主流微信版本和常见屏幕尺寸下可用。
+
+## 9. MVP 范围
+
+### 9.1 本仓库已实现的原型
+
+- 首页、创建、加入、候场、游戏、结算和安全规则页面。
+- 本地房间和玩家模拟。
+- 经典/感染模式配置。
+- 准备与游戏倒计时。
+- 角色分配、模糊线索、雷达、静默和口令抓捕。
+- 基础战报与再来一局。
+
+### 9.2 真实多人版必须补齐
+
+- 微信服务端登录与用户体系。
+- 云数据库或自有后端。
+- WebSocket 实时同步。
+- 地图选区与地理围栏。
+- 后台定位策略和真机兼容性验证。
+- 服务端口令和技能校验。
+- 分享卡片、订阅消息和内容安全。
+- 埋点、崩溃监控、举报和客服流程。
+
+### 9.3 暂不进入 MVP
+
+- 附近陌生人公开组局。
+- 付费商城。
+- 用户自制剧本市场。
+- 景区和企业管理后台。
+- 赛季、段位和复杂成长体系。
+
+## 10. 数据指标
+
+北极星指标：
+
+- 每周成功完成的多人游戏局数。
+
+核心漏斗：
+
+- 首页访问 → 创建/加入房间。
+- 进入房间 → 完成准备。
+- 完成准备 → 正式开局。
+- 正式开局 → 正常结算。
+- 正常结算 → 分享或再来一局。
+
+质量指标：
+
+- 平均每局人数和时长。
+- 中途退出率、失联率和争议率。
+- 创建房间至开局的时间。
+- 位置授权成功率和弱网重连成功率。
+- 7 日内再次开局的房主比例。
+
+安全指标：
+
+- 越界事件数。
+- 紧急暂停和集合事件数。
+- 举报率及处理时长。
+
+## 11. 版本路线
+
+### V0.1 可交互原型
+
+- 验证规则、信息节奏和页面流程。
+- 用模拟玩家完成单人走查。
+
+### V0.2 熟人内测
+
+- 接入真实登录、房间同步和地理围栏。
+- 支持 6～12 人熟人局。
+- 完成隐私与安全流程。
+
+### V0.3 公测
+
+- 优化弱网、后台切换和耗电。
+- 增加分享战报、历史记录和常用队伍。
+- 上线感染模式完整技能和平衡参数。
+
+### V1.0 场景扩展
+
+- 增加宝藏、占点和亲子玩法。
+- 提供活动模板和主办方工具。
+- 探索营地、景区和团建商业合作。
+
+## 12. 验收标准
+
+MVP 进入熟人内测前至少满足：
+
+1. 6 名玩家可通过分享进入同一房间。
+2. 所有玩家看到一致的阶段、倒计时和抓捕结果。
+3. 身份信息不会错误地展示给其他阵营。
+4. 拒绝定位或越界时能阻止继续参与并清晰提示。
+5. 抓捕口令过期、重复或距离不符时无法通过。
+6. 短暂断网后能在 10 秒内恢复游戏状态。
+7. 房主可暂停、集合和结束游戏。
+8. 游戏结束后精确位置按策略完成删除。

docs/RELEASE_NOTES.md

@@ -0,0 +1,34 @@
+# 藏猫猫计划 0.1.0-mvp 发布说明
+
+发布日期：2026-07-27  
+版本类型：本地可交互演示版
+
+## 已交付
+
+- 首页、创建、加入、候场、游戏、安全规则和结算页面。
+- 经典模式和感染模式。
+- 本地房间、模拟玩家、角色分配和阶段倒计时。
+- 配置化正式计时与独立演示加速。
+- 雷达、静默、目标选择和 30 秒动态抓捕口令。
+- 抓捕权限、口令时效与重复使用校验。
+- 暂停、继续、提前结束和安全退出。
+- 稳定战报快照、角色转化展示和按原规则复玩。
+- 旧缓存迁移、损坏数据恢复和异常页面兜底。
+- 游戏服务、页面契约和发布就绪自动检查。
+
+## 已知限制
+
+- 房间和玩家数据只保存在当前设备，无法跨设备实时同步。
+- 没有微信登录、云数据库、WebSocket 或服务端状态裁决。
+- 没有接入真实地图、定位、地理围栏或移动轨迹。
+- 雷达和模糊区域线索属于随机演示数据。
+- 本地动态口令不具备正式防作弊安全性。
+- 联系房主、紧急集合和分享战报仍是原型能力。
+- 微信真机上的震动、分享、剪贴板和不同屏幕兼容性需要按验收清单人工确认。
+
+## 下一阶段进入条件
+
+- 完成 `DEVICE_TEST_CHECKLIST.md` 并解决所有阻塞问题。
+- 通过至少 3～5 场现场模拟，验证规则理解、线索节奏和安全流程。
+- 冻结熟人多人版的数据模型和服务端状态机。
+

docs/TECHNICAL_DESIGN.md

@@ -0,0 +1,229 @@
+# 技术设计
+
+## 1. 当前原型架构
+
+当前版本采用微信小程序原生 JavaScript，不依赖 npm 包和远程服务。
+
+```text
+页面层 pages/*
+    ↓
+本地游戏服务 services/game-service.js
+    ↓
+wx Storage（房间、玩家、事件和结果）
+```
+
+`game-service.js` 将页面与数据源隔离。接入真实后端时，页面调用接口可以尽量保持不变，只需将服务实现替换为网络请求和实时订阅。
+
+## 2. 推荐生产架构
+
+初期建议采用微信云开发，减少登录、部署和运维成本；验证规模后可迁移为自有服务。
+
+```text
+微信小程序
+├─ HTTPS API：创建、加入、抓捕、技能、结算
+├─ WebSocket：房间状态和事件推送
+└─ 定位模块：低频位置上报与边界判断
+        ↓
+应用服务
+├─ 身份与权限
+├─ 房间状态机
+├─ 游戏规则引擎
+├─ 位置模糊化
+├─ 口令与防作弊
+└─ 安全事件
+        ↓
+数据层
+├─ 持久数据库：用户、房间、结果
+├─ Redis：在线状态、口令、房间实时状态
+└─ 短期位置存储：设置自动过期时间
+```
+
+## 3. 核心实体
+
+### User
+
+```js
+{
+  id,
+  openId,
+  displayName,
+  avatarUrl,
+  safetySettings,
+  createdAt
+}
+```
+
+### Room
+
+```js
+{
+  id,
+  code,
+  hostId,
+  name,
+  mode,
+  status,
+  settings: {
+    maxPlayers,
+    durationMinutes,
+    prepareMinutes,
+    clueIntervalMinutes,
+    seekerCount,
+    radiusMeters,
+    skillsEnabled
+  },
+  center,
+  phaseEndsAt,
+  version,
+  createdAt
+}
+```
+
+### Player
+
+```js
+{
+  id,
+  roomId,
+  userId,
+  displayName,
+  role,
+  status,
+  ready,
+  caughtBy,
+  caughtAt,
+  joinedAt,
+  lastSeenAt
+}
+```
+
+### GameEvent
+
+```js
+{
+  id,
+  roomId,
+  type,
+  actorId,
+  targetId,
+  visibility,
+  payload,
+  createdAt
+}
+```
+
+### LocationPing
+
+```js
+{
+  roomId,
+  playerId,
+  latitude,
+  longitude,
+  accuracy,
+  capturedAt,
+  expiresAt
+}
+```
+
+生产环境中 `LocationPing` 不应作为永久战绩保存。
+
+## 4. API 草案
+
+- `POST /rooms`：创建房间。
+- `GET /rooms/:code`：读取可公开的房间摘要。
+- `POST /rooms/:code/join`：加入房间。
+- `POST /rooms/:id/ready`：切换准备状态。
+- `POST /rooms/:id/start`：房主开始游戏。
+- `POST /rooms/:id/location`：上报位置。
+- `POST /rooms/:id/skills/:skill`：使用技能。
+- `POST /rooms/:id/captures`：提交抓捕凭证。
+- `POST /rooms/:id/pause`：暂停游戏。
+- `POST /rooms/:id/assemble`：发起全员集合。
+- `POST /rooms/:id/finish`：结束游戏。
+- `GET /rooms/:id/result`：读取结算结果。
+
+所有改变游戏状态的接口都应：
+
+- 校验用户身份和房间成员关系。
+- 校验当前房间状态和角色权限。
+- 使用服务端时间。
+- 支持幂等键，避免弱网重试造成重复事件。
+- 更新房间版本号并广播事件。
+
+## 5. 实时同步
+
+WebSocket 消息建议仅发送必要状态变化：
+
+```js
+{
+  eventId,
+  roomId,
+  roomVersion,
+  type: "PLAYER_CAUGHT",
+  payload: {},
+  serverTime
+}
+```
+
+客户端策略：
+
+1. 进入候场或游戏页后建立连接。
+2. 按 `eventId` 去重。
+3. 检测版本跳跃时重新拉取房间快照。
+4. 退到后台后按微信能力选择保活或恢复时重连。
+5. UI 倒计时基于 `phaseEndsAt - serverTimeOffset` 计算。
+
+## 6. 位置和地理围栏
+
+- 客户端获取坐标并附带定位精度和采集时间。
+- 服务端校验坐标新鲜度、速度异常和精度阈值。
+- 使用服务端保存的场地中心和半径判断越界。
+- 向寻找者发送的线索由服务端完成网格化或随机偏移。
+- 不将躲藏者原始坐标发送给其他普通玩家。
+- 位置记录设置短期 TTL，游戏结束后触发删除任务。
+
+线索模糊化可采用：
+
+- H3/Geohash 网格降级。
+- 以真实点为中心生成受边界约束的随机圆。
+- 仅返回目标与玩家的距离档位，如“很近、附近、较远”。
+
+## 7. 抓捕防作弊
+
+动态口令建议由服务端生成：
+
+```text
+token = HMAC(roomSecret, targetPlayerId + timeWindow + nonce)
+```
+
+- 口令窗口建议 30 秒。
+- 提交时校验寻找者与目标的最近位置距离。
+- 校验双方都在线、角色正确且目标尚未被抓。
+- 使用事务写入抓捕结果，防止两个寻找者同时抓到同一目标。
+- 口令只作为相遇证明之一，不能替代安全规则。
+
+## 8. 安全设计
+
+- 房主开始前必须完成场地和规则确认。
+- 服务端保留暂停、集合和取消的高优先级事件通道。
+- 客户端进入后台、定位失效、低电量或离线时产生状态提示。
+- 精确位置访问纳入服务端审计，不允许普通运营后台随意查看。
+- 公开组局上线前必须具备举报、封禁、内容安全和年龄策略。
+
+## 9. 测试策略
+
+- 单元测试：房间状态机、身份分配、倒计时、抓捕和结算。
+- 属性测试：不同人数与寻找者数量下角色数量始终合法。
+- 集成测试：多人并发加入、重复抓捕、断线重连和版本冲突。
+- 真机测试：前后台切换、弱网、定位精度、耗电和不同微信版本。
+- 户外测试：边界提醒时机、线索节奏、屏幕使用时间和安全流程。
+
+## 10. 迁移顺序
+
+1. 保留页面与服务接口，先把本地房间读写替换为云函数。
+2. 接入微信登录并使每个玩家拥有稳定服务端 ID。
+3. 引入实时房间事件和服务端倒计时。
+4. 接入地图选区、定位上报和模糊线索。
+5. 将抓捕、技能和结算全部迁到服务端裁决。
+6. 增加日志、监控、隐私删除和运营安全能力。

docs/TEST_REPORT.md

@@ -0,0 +1,51 @@
+# 藏猫猫计划 0.1.0-mvp 测试报告
+
+测试日期：2026-07-27  
+测试范围：代码语法、本地领域服务、页面事件契约、发布文件完整性  
+测试结论：自动化检查通过；真机检查待执行
+
+## 自动化结果
+
+执行命令：
+
+```bash
+node tests/run-all.js
+```
+
+覆盖内容：
+
+- 旧缓存迁移和损坏数据恢复。
+- 创建参数、加入状态、房主权限和全员准备校验。
+- 房间状态迁移、演示计时和正式配置计时。
+- 角色数量、经典淘汰和感染转化。
+- 技能持久化、技能关闭、静默消费和身份权限。
+- 口令目标绑定、30 秒时效、重复使用和抓捕权限。
+- 暂停、继续、提前结束、安全退出和自动结算。
+- 结算快照及复玩数据重置。
+- WXML 事件处理函数与页面 JS 的绑定完整性。
+- `app.json` 页面文件、项目类型、版本号和交付文档完整性。
+
+结果：
+
+```text
+game-service tests passed
+page contract tests passed
+release readiness tests passed
+all automated checks passed
+```
+
+## 未自动覆盖
+
+- 微信开发者工具编译器特有的 WXML/WXSS 兼容提示。
+- iOS、Android 真机屏幕适配。
+- 震动强度、剪贴板授权和分享卡片效果。
+- 微信前后台调度差异和低电量行为。
+
+以上项目使用 `DEVICE_TEST_CHECKLIST.md` 人工验收。
+
+## 发布判断
+
+- 用于产品演示和用户访谈：可以。
+- 用于单设备流程验证：可以。
+- 用于真实多人户外活动：不可以，必须先完成服务端、定位、合规和真机验证。
+