藏猫猫计划

一个面向朋友聚会、校园活动、亲子活动和团队团建的线下真人捉迷藏微信小程序原型。

当前交付版本：0.1.0-mvp。该版本适合单设备产品演示和用户访谈，不适合直接组织真实多人户外活动。

当前版本使用微信小程序原生 JavaScript 开发，内置本地模拟数据，无需后端即可跑通：

• 创建游戏与配置规则
• 通过房间码加入游戏
• 候场与身份分配
• 准备阶段和游戏倒计时
• 模糊位置线索、雷达与静默技能
• 动态口令抓捕
• 游戏结算与战报

运行方式

1. 安装并打开微信开发者工具。
2. 选择“导入项目”，目录选择本仓库。
3. AppID 可使用测试号；仓库中的 project.config.json 默认使用游客 AppID。
4. 编译后从首页开始体验。

推荐使用演示房间码 731204，或创建房间后由系统自动补充模拟玩家。

自动检查

本项目不依赖 npm。安装 Node.js 后可直接运行：

node tests/run-all.js

自动检查覆盖本地游戏服务、页面事件绑定和发布文件完整性。微信特有能力仍需按照 真机验收清单 在开发者工具和真机上确认。

交付文档

• 一周实施规划
• 5 分钟演示脚本
• 测试报告
• 真机验收清单
• 版本说明与已知限制

原型中的房间、玩家和游戏状态保存在本机 wx.setStorageSync 中。创建房间后，候场页会自动加入模拟玩家，便于单人体验完整流程。

目录

.
├─ docs/
│  ├─ PRD.md                    产品需求文档
│  ├─ TECHNICAL_DESIGN.md       技术设计与后端演进方案
│  ├─ ONE_WEEK_MVP_PLAN.md      一周实施规划与完成记录
│  ├─ DEMO_GUIDE.md             5 分钟演示脚本
│  ├─ TEST_REPORT.md            自动回归报告
│  ├─ DEVICE_TEST_CHECKLIST.md  真机验收清单
│  └─ RELEASE_NOTES.md          版本说明与已知限制
├─ pages/
│  ├─ home/                  首页
│  ├─ create/                创建游戏
│  ├─ join/                  加入房间
│  ├─ lobby/                 游戏候场
│  ├─ game/                  游戏进行中
│  ├─ result/                游戏结算
│  └─ rules/                 安全规则
├─ services/
│  └─ game-service.js        本地模拟游戏服务
├─ tests/                     自动回归与发布检查
└─ utils/
   ├─ constants.js           模式与规则常量
   └─ format.js              通用格式化方法

下一阶段

进入真实多人测试前，需要将 services/game-service.js 替换为云开发或自有后端，并补齐：

• 微信登录和服务端身份校验
• WebSocket 房间状态同步
• 授权后的真实定位上报
• 服务端计时、口令签名和防作弊
• 内容安全、未成年人保护和数据删除机制

详细说明见 产品需求 和 技术设计。