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
@@ -0,0 +1,261 @@
# v0.1 场景设计 — 城郊小街
> 本文档定义 v0.1 白盒场景的具体内容,供程序搭建白盒和美术制作资产参考。
---
## 场景概述
**场景名称**: 城郊小街
**一句话描述**: 一条连接家和外部世界的小街——小卖部、老居民楼、空地和水塘,千禧年前后城郊结合区的缩影。
**规模**: 约 80m × 60m 的可探索区域,步行走一圈约 2-3 分钟
**时间设定**: 夏日的下午(v0.1 固定时段,不做时间变化)
---
## 区域划分与地图
```
┌──────────────┐
│ 水塘边 │
│ (芦苇·青蛙) │
└──────┬───────┘
│ 小路
┌──────┴───────┐
│ 巷子(窄) │
│ (猫·纸箱·蛛网) │
┌─────────┴──────────────┴──────────┐
│ │
┌──────┴──────┐ 主 街 道 ┌────────────┴───┐
│ 我的家 │ (水泥路) │ 空地/操场 │
│ (小院·平房) │ ←────────→ │ (弹珠·大树·水坑) │
└──────┬──────┘ └────────────────┘
│ │
┌──────┴──────┐ ┌─────────┴────┐
│ 小卖部 │ │ 老居民楼 │
│ (零食·冰柜) │ │ (背景装饰) │
└─────────────┘ └──────────────┘
```
**流线**: 家 → 街道 → 各分支区域(小卖部/空地/巷子→水塘)
---
## 各区域详细设计
### 1. 家(Home)
**位置**: 场景西南角
**面积**: 约 8m × 6m(含小院)
**描述**:
带小院子的平房(或一楼的套房),主角住的地方。院子有铁皮门,院子不大但塞满了生活痕迹。
**环境细节**:
- 小院:晾衣杆(挂着衣服)、旧自行车靠墙、角落的杂物堆
- 外观:红砖墙或水泥外墙,窗户有铁栏杆,门是那种绿色铁门或木门
- 门口:一块小门垫,门旁可能有对联/福字的痕迹
**室内(v0.1 简化)**:
- 单间或小客厅即可,不需要完整户型
- 老式冰箱、大脑袋电视(搁在电视柜上)、一张书桌
- 墙上挂着日历
- v0.1 室内可以不实现,仅作为视觉背景(门打开看到内部但不可进入)
- 如果实现,最小空间:冰箱 + 电视 + 书桌 + 床
**可交互物体**: 冰箱、电视、书桌、日历、床(详见 interaction-system.md)
**氛围**: 熟悉、安全、有点乱但温馨
---
### 2. 小卖部(Corner Shop)
**位置**: 家旁边,沿主街道
**面积**: 约 6m × 4m
**描述**:
街角的小卖部,玻璃柜台里面摆着各种零食,墙上挂着卡片架。是孩子们放学后的"圣地"。
**环境细节**:
- 外观:蓝色或绿色的褪色招牌("XX百货"或手写的"小卖部")
- 门:卷帘门或玻璃推拉门(白天是打开的)
- 柜台:玻璃柜台,里面分层摆着零食
- 货架:靠墙的简易金属货架
- 冰柜:那种顶盖掀开的老式冰柜
- 角落:一台小电视,正在放动画片或电视剧
**可交互物体**: 零食货架、冰柜、卡片架、老板(NPC)
**时代物品参考**:
- 辣条(卫龙/大刀肉)
- 大大泡泡糖(送贴纸!)
- 小浣熊干脆面(集水浒卡!)
- 健力宝 / 北冰洋
- 袋装冰(冰块装在透明塑料袋里)
- 各种5毛钱的零食
**氛围**: 零食的诱惑、夏天的冰柜味、电视的声音
---
### 3. 主街道(Main Street)
**位置**: 场景中心,东西走向
**长度**: 约 50m
**宽度**: 约 5m(两侧有建筑/围墙)
**描述**:
一条水泥路面的街道,不宽,偶尔有自行车经过(v0.1 不需要动态车辆)。街道两侧有各种生活痕迹。
**环境细节**:
- 路面:灰色水泥,有些裂缝和修补的痕迹
- 两侧:围墙、居民楼底楼、零散的摊位痕迹
- 街边:公用电话亭、老式路灯、电线杆(电线交错)
- 生活痕迹:墙上贴着的小广告、褪色的标语、地上的落叶
**可交互物体**: 公用电话亭、老式自行车、晾衣杆、墙上的涂鸦、下水道盖
**氛围**: 千禧年城郊的日常——不精致但有人气
---
### 4. 空地/操场(Vacant Lot)
**位置**: 场景东侧
**面积**: 约 15m × 12m
**描述**:
一片开阔的空地,可能是拆迁后还没建设的地块。地面是硬土和杂草,是孩子们的主要活动场地。
**环境细节**:
- 地面:硬黄土 + 稀疏的杂草 + 几处低洼(下雨后积水坑)
- 中央:一棵大梧桐树(提供阴凉)
- 边缘:零散的砖块、废弃的建材
- 地面上隐约可以看到弹珠游戏的"圈"(画在地上的痕迹)
**可交互物体**: 散落的弹珠、水浒卡碎片、小石子、大树、水坑
**氛围**: 孩子们的领地——虽然简陋但充满可能
---
### 5. 巷子(Alley)
**位置**: 连接街道和水塘的窄通道
**长度**: 约 25m
**宽度**: 约 2-3m
**描述**:
两侧是居民楼或围墙的窄巷子,光线略暗,有种探险的感觉。走到尽头就是水塘。
**环境细节**:
- 两侧:斑驳的墙面、生锈的铁窗、窗外伸出晾衣杆
- 地面:青砖或石板,有些地方长了青苔
- 细节:墙角有蜘蛛网、窗台上有花盆、角落有废纸箱
- 声音:巷子里回声明显(v0.1 不需要,后续版本可加)
**可交互物体**: 流浪猫、老窗户、废纸箱、蜘蛛网
**氛围**: 安静、略带神秘、有种"大人不知道的地方"的感觉
---
### 6. 水塘边(Pond)
**位置**: 场景最北端
**面积**: 水塘约 15m × 10m,岸边约 3m 宽
**描述**:
城郊保留的小水塘,周边有芦苇和杂草。夏天的傍晚会有蛙叫。水面映着天空和周围的树。
**环境细节**:
- 水面:深绿色,有微微的波纹(简单材质动画即可)
- 岸边:泥土坡度,长着芦苇和杂草
- 细节:荷叶、青蛙、偶尔掠过的蜻蜓
- 远景:水塘对岸是模糊的田野/工地(场景边界)
**可交互物体**: 水塘、青蛙、芦苇、散落的糖纸和橡皮擦
**氛围**: 夏天的水边——有点危险但很吸引人
---
### 7. 老居民楼(背景装饰)
**位置**: 场景东南角
**状态**: v0.1 为纯背景装饰,不可进入
**描述**:
一栋5-6层的老式居民楼,灰白外墙,阳台上晒着衣服。作为场景背景提供"城郊居民区"的氛围。
**细节**:
- 外墙有些剥落和裂缝
- 阳台上有晾衣杆、花盆、杂物
- 底楼可能有杂物间或车库
- 楼梯间入口(v0.1 不可进入)
---
## 时代元素清单
以下元素应出现在场景各处,营造千禧年前后城郊的时代感:
### 静态物件
| 物件 | 位置 | 说明 |
|------|------|------|
| 褪色招牌 | 小卖部上方 | 蓝底白字或手写体 |
| 公用电话亭 | 街道边 | IC卡电话,可能有广告贴纸 |
| 老式自行车 | 家门口/街道边 | 永久牌/凤凰牌,后座有铁丝筐 |
| 晾衣杆 | 家院子/居民楼阳台 | 竹竿或铁管,挂着衣服被子 |
| 红砖墙 | 巷子/家外围 | 有爬山虎或剥落的墙皮 |
| 电线杆 | 街道边 | 木头或水泥杆,电线交错 |
| 工地围挡 | 场景边缘 | 蓝色铁皮围挡,写着标语 |
| 广告墙 | 街道边 | 手绘的移动/联通广告 |
| 菜市场棚子 | 街道某段 | 简易铁皮棚(v0.1 纯装饰) |
| 垃圾桶 | 街道角落 | 绿色铁皮垃圾桶 |
### 地面细节
- 水泥路裂缝
- 砖缝中的杂草
- 地面上的粉笔画痕迹
- 积水坑(反光材质)
- 散落的零食包装纸
### 环境氛围
- 夏日的暖色阳光(下午3-4点的光线)
- 微微的热气蒸腾感(v0.1 用简单的后处理热浪效果?可选)
- 远处模糊的蝉鸣声(v0.1 不做声音,后续版本)
---
## 收集品分布(v0.1)
场景中散落的 10 个可拾取收集品:
| # | 物品 | 位置 | 稀有度 |
|---|------|------|--------|
| 1 | 彩色弹珠(蓝色) | 空地地面 | 普通 |
| 2 | 彩色弹珠(红色花纹) | 巷子深处 | 普通 |
| 3 | 小石子 | 空地水坑旁 | 普通 |
| 4 | 水浒卡碎片(鲁智深) | 空地砖块旁 | 稀有 |
| 5 | 糖纸(大白兔) | 水塘岸边 | 普通 |
| 6 | 橡皮擦(半透明) | 水塘岸边 | 普通 |
| 7 | 水浒卡碎片(武松) | 巷子废纸箱内 | 稀有 |
| 8 | 弹珠(透明冰花) | 街道下水道盖旁 | 普通 |
| 9 | 小浣熊调料包 | 小卖部门口 | 普通 |
| 10 | 玻璃弹珠(猫眼) | 家院子角落 | 稀有 |
拾取后物品消失(oneShot),收集计数 +1。
---
## 场景边界处理
- 场景边缘用自然元素围合:围墙、居民楼、水塘、工地围挡
- 不可到达的区域用物理碰撞阻挡
- 不需要加载屏幕或过渡区域(v0.1 单一关卡)
- 场景边缘可放置远景(简单面片 + 天空盒)暗示更大的世界