藏猫猫计划

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

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

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

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

运行方式

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

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

自动检查

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

node tests/run-all.js

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

交付文档

原型中的房间、玩家和游戏状态保存在本机 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 房间状态同步
授权后的真实定位上报
服务端计时、口令签名和防作弊
内容安全、未成年人保护和数据删除机制

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

3.1 KiB Raw Permalink Blame History

藏猫猫计划

运行方式

自动检查

交付文档

目录

下一阶段

3.1 KiB

Raw Permalink Blame History