85 lines
3.1 KiB
Markdown
85 lines
3.1 KiB
Markdown
# 藏猫猫计划
|
|
|
|
一个面向朋友聚会、校园活动、亲子活动和团队团建的线下真人捉迷藏微信小程序原型。
|
|
|
|
当前交付版本：`0.1.0-mvp`。该版本适合单设备产品演示和用户访谈，不适合直接组织真实多人户外活动。
|
|
|
|
当前版本使用微信小程序原生 JavaScript 开发，内置本地模拟数据，无需后端即可跑通：
|
|
|
|
- 创建游戏与配置规则
|
|
- 通过房间码加入游戏
|
|
- 候场与身份分配
|
|
- 准备阶段和游戏倒计时
|
|
- 模糊位置线索、雷达与静默技能
|
|
- 动态口令抓捕
|
|
- 游戏结算与战报
|
|
|
|
## 运行方式
|
|
|
|
1. 安装并打开微信开发者工具。
|
|
2. 选择“导入项目”，目录选择本仓库。
|
|
3. AppID 可使用测试号；仓库中的 `project.config.json` 默认使用游客 AppID。
|
|
4. 编译后从首页开始体验。
|
|
|
|
推荐使用演示房间码 `731204`，或创建房间后由系统自动补充模拟玩家。
|
|
|
|
## 自动检查
|
|
|
|
本项目不依赖 npm。安装 Node.js 后可直接运行：
|
|
|
|
```bash
|
|
node tests/run-all.js
|
|
```
|
|
|
|
自动检查覆盖本地游戏服务、页面事件绑定和发布文件完整性。微信特有能力仍需按照 [真机验收清单](docs/DEVICE_TEST_CHECKLIST.md) 在开发者工具和真机上确认。
|
|
|
|
## 交付文档
|
|
|
|
- [一周实施规划](docs/ONE_WEEK_MVP_PLAN.md)
|
|
- [5 分钟演示脚本](docs/DEMO_GUIDE.md)
|
|
- [测试报告](docs/TEST_REPORT.md)
|
|
- [真机验收清单](docs/DEVICE_TEST_CHECKLIST.md)
|
|
- [版本说明与已知限制](docs/RELEASE_NOTES.md)
|
|
|
|
原型中的房间、玩家和游戏状态保存在本机 `wx.setStorageSync` 中。创建房间后，候场页会自动加入模拟玩家，便于单人体验完整流程。
|
|
|
|
## 目录
|
|
|
|
```text
|
|
.
|
|
├─ 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 房间状态同步
|
|
- 授权后的真实定位上报
|
|
- 服务端计时、口令签名和防作弊
|
|
- 内容安全、未成年人保护和数据删除机制
|
|
|
|
详细说明见 [产品需求](docs/PRD.md) 和 [技术设计](docs/TECHNICAL_DESIGN.md)。
|