docs(design): 添加游戏愿景、系统设计与v0.1范围文档

新增: game-vision.md, v01-scope.md, brainstorm 记录,
player-controller/interaction-system/collection-system 设计,
scene-v01-suburban 场景设计
更新: CLAUDE.md 协作规范, style-guide 时代设定,
current.md/roadmap.md 进度追踪, design 命令模板
This commit is contained in:
2026-06-01 00:54:58 +08:00
parent b73a3ef098
commit 887b6e4485
12 changed files with 1444 additions and 36 deletions
+148
View File
@@ -0,0 +1,148 @@
# v0.1 范围定义 — 场景漫游与环境交互
> 本文档明确 v0.1 原型的功能边界,作为程序和美术 Agent 的需求基准。
---
## v0.1 目标
**验证核心问题**: 玩家能否在千禧年城郊场景中感受到"探索的乐趣"和"时代的氛围"?
**体验目标**:
1. 玩家能自由漫步在城郊小街场景中
2. 通过观察和交互,感受到千禧年前后城郊的生活气息
3. 每个可交互物体都提供一小段叙事文本,唤起怀旧感
4. 收集散落的物品,获得探索的满足感
**一句话**: "在一条千禧年的城郊小街上散步,翻翻冰箱、看看小卖部、捡起地上的弹珠。"
---
## In Scope(v0.1 包含)
### 玩家控制
- [x] 第三人称摄像机跟随
- [x] WASD 步行移动
- [x] Shift 跑步(速度切换)
- [x] E 键交互
### 场景
- [x] 城郊小街白盒场景(6个区域:家、小卖部、街道、空地、巷子、水塘边)
- [x] 基础地面和碰撞体
- [x] 简单的天空盒(夏日晴空)
- [x] 基础光照(午后阳光方向光 + 环境光)
### 交互系统
- [x] 靠近物体显示交互提示 UI
- [x] 观察类交互(25+ 个可观察物体,每个有叙事文本)
- [x] 拾取类交互(10 个收集品)
- [x] 操作类交互(开门)
- [x] 交互后叙事文本的显示 UI
### 收集系统(简化版)
- [x] 拾取物品的计数显示
- [x] 物品获得时的 UI 提示
### 视觉
- [x] Lowpoly 风格的白盒几何体(不需要最终美术资产)
- [x] 用简单颜色区分不同区域和物体
- [x] 基本的场景氛围(暖色调光照)
---
## Out of Scope(v0.1 不包含)
### 明确排除
- ❌ 完整的小游戏系统(弹珠、跳绳等)→ v0.2
- ❌ 时间循环系统(一天四个时段)→ v0.3
- ❌ NPC AI 和移动
- ❌ 对话树 / 对话选择
- ❌ 物品背包 UI(只做计数,不做界面)
- ❌ 物品使用 / 组合系统
- ❌ 任务系统
- ❌ 蹲下系统
- ❌ 跳跃 / 攀爬
- ❌ 手柄支持
- ❌ 音频系统(BGM、音效)→ 后续版本
- ❌ 存档/读档系统
- ❌ 设置菜单(画质、音量等)
- ❌ 多语言支持
- ❌ 过场动画 / 镜头演出
- ❌ 粒子效果(除了基础材质动画)
- ❌ 远景 / 天气系统
---
## 验收标准
### 基础运行
- [ ] 游戏能正常启动并加载场景
- [ ] 角色出现在"家"门口
- [ ] 无崩溃、无严重性能问题(目标:稳定30帧以上)
### 移动体验
- [ ] WASD 移动响应流畅,无延迟感
- [ ] 摄像机跟随平滑,不穿墙
- [ ] 跑步和步行速度差异明显
- [ ] 转身和停止有自然的过渡
### 交互体验
- [ ] 靠近可交互物体时正确显示提示
- [ ] 按E键能触发交互,显示叙事文本或拾取物品
- [ ] 叙事文本以打字机效果逐字显示
- [ ] 离开交互范围时提示自动消失
### 场景体验
- [ ] 6个区域均可到达和探索
- [ ] 每个区域至少有3个可交互物体
- [ ] 场景有基本的视觉辨识度(不同区域有不同感觉)
- [ ] 10个收集品可以全部找到并拾取
### 氛围体验(主观判断)
- [ ] 走在街上能感受到"千禧年城郊"的时代感
- [ ] 交互文本能唤起某种怀旧感或共鸣
- [ ] 整体体验让人想继续探索更多
---
## 与 v0.2 的衔接点
v0.1 完成后,v0.2 将在以下基础上扩展:
1. **新增小游戏**: 在"空地"区域加入弹珠小游戏
- v0.1 的空地已预留了弹珠游戏的位置(地面上的"圈")
- 交互系统可复用和扩展
2. **蹲下系统**: 在交互基础上增加蹲下探索
- 部分隐藏物品需要蹲下才能发现
3. **NPC 对话**: 从简单的观察文本升级为对话系统
- 小卖部老板可以交谈
- 可能出现小伙伴 NPC
4. **音效**: 为场景添加基础音效
- 脚步声、交互音效、环境音
5. **室内空间**: 扩展家的内部和小卖部内部
- v0.1 如果只做了室外,v0.2 补全室内
---
## 开发优先级(供程序 Agent 参考)
1. **P0 — 必须完成**: 角色控制 + 摄像机 + 交互系统核心 + 场景白盒
2. **P1 — 应该完成**: 全部25+观察交互 + 10个拾取品 + 收集计数
3. **P2 — 可以简化**: 叙事文本 UI 效果、光照细节、场景装饰
---
## 预估工作量(粗略)
| 模块 | 预估 | 说明 |
|------|------|------|
| 角色控制器 | 1-2天 | UE5 内置 Character + 摄像机设置 |
| 交互系统 | 2-3天 | 基类 + 检测 + UI 提示 + 文本显示 |
| 场景白盒 | 2-3天 | 6个区域的基础几何体搭建 |
| 交互内容填充 | 1-2天 | 配置25+交互对象的数据 |
| 调试打磨 | 1-2天 | 测试和修复 |
| **合计** | **7-12天** | 单人独立开发节奏 |