# 藏猫猫计划：产品需求文档 版本：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. 游戏结束后精确位置按策略完成删除。