mini-zmc/docs/PRD.md

藏猫猫计划：产品需求文档

版本：0.1
阶段：MVP 可交互原型
产品形态：微信小程序

1. 产品概述

1.1 产品定位

“藏猫猫计划”是一款帮助用户快速组织线下真人追逃游戏的小程序。它通过房间邀请、身份分配、地图边界、模糊位置线索、抓捕确认和自动结算，承担线下游戏的主持人角色。

产品不鼓励玩家持续盯着手机，而是利用语音、震动、倒计时和少量关键交互，让现实空间成为主要游戏场景。

一句话表达：

选择一块场地，邀请几个朋友，现实世界立刻变成游戏地图。

1.2 目标用户

• 朋友聚会：希望快速开始一场有互动感的户外游戏。
• 校园社团：需要低成本组织多人活动。
• 亲子家庭：希望进行范围可控的户外探索。
• 企业团建：需要可配置、可复盘的团队项目。
• 景区与营地：希望将场地包装成互动游戏内容。

1.3 核心价值

• 两分钟内完成组局，降低组织成本。
• 自动处理分队、倒计时、线索和结算。
• 通过有限位置信息保留躲藏和推理乐趣。
• 用安全边界、越界提醒和紧急集合降低户外风险。
• 通过战报和称号促进复玩与社交传播。

1.4 产品原则

1. 安全高于胜负。
2. 模糊信息高于精确导航。
3. 线下互动高于屏幕操作。
4. 每位玩家尽量持续参与，减少被淘汰后的等待。
5. 基础规则公平，付费内容不直接提供竞技优势。

2. 游戏核心循环

创建房间 → 邀请好友 → 候场确认 → 分配身份
    ↓
躲藏准备 → 正式追逃 → 线索与技能 → 抓捕确认
    ↓
阵营结算 → 趣味战报 → 分享/再来一局

一次标准游戏建议配置：

• 人数：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. 游戏结束后精确位置按策略完成删除。