新建项目

README.md

@@ -0,0 +1,84 @@
+# 藏猫猫计划
+
+一个面向朋友聚会、校园活动、亲子活动和团队团建的线下真人捉迷藏微信小程序原型。
+
+当前交付版本：`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)。