# 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天** | 单人独立开发节奏 |