docs(design): 交互物分阶段实现计划与白盒模型对齐

This commit is contained in:
DESKTOP-2K5TJI4\admin
2026-06-01 18:25:27 +08:00
parent cc54fecfce
commit 187b66095e
+67 -70
View File
@@ -194,60 +194,59 @@
## v0.1 交互对象清单
按场景区域划分(配合 scene-v01-suburban.md):
> 程序 Agent 按分阶段顺序实现。第一轮跑通系统,第二轮填充体验。
### 家
| ID | 名称 | 类型 | 描述 |
|---|---|---|---|
| fridge_home | 旧冰箱 | 观察 | 夏天的冰箱记忆 |
| tv_home | 老式电视 | 观察 | 大脑袋电视,天线要调 |
| bed_home | 我的床 | 观察 | 床底下的宝藏箱 |
| desk_home | 书桌 | 观察 | 没写完的暑假作业 |
| calendar_home | 日历 | 观察 | 圈着"开学的日期",被划掉了又画上 |
### 第一轮:系统验证(5 个,优先实现)
### 小卖部
| ID | 名称 | 类型 | 描述 |
|---|---|---|---|
| door_shop | 小卖部门 | 操作 | 进出小卖部 |
| shelf_snack | 零食货架 | 观察 | 辣条、泡泡糖、干脆面…… |
| shelf_drink | 冰柜 | 观察 | 健力宝、北冰洋、袋装冰 |
| owner_shop | 老板 | 观察(NPC) | 打瞌睡的老板和电视声 |
| card_rack | 卡片架 | 观察 | 水浒卡、数码宝贝卡片 |
覆盖全部 4 种交互类型,跨 3 个区域,验证核心流程。
### 街道
| ID | 名称 | 类型 | 描述 |
|---|---|---|---|
| phone_booth | 公用电话亭 | 观察 | IC卡电话的回忆 |
| bike_street | 老式自行车 | 观察 | 爸爸的永久牌 |
| laundry | 晾衣杆 | 观察 | 满院子飘着的衣服 |
| wall_graffiti | 墙上的涂鸦 | 观察 | 不知谁画的奥特曼 |
| manhole | 下水道盖 | 观察 | 弹珠掉进去的声音 |
| # | ID | 名称 | 类型 | 区域 | 验证目标 |
|---|---|---|---|---|---|
| 1 | fridge_home | 旧冰箱 | 观察 | 家 | 室内大件观察,相机推镜 + 内心独白文案 |
| 2 | door_home | 家的门 | 操作 | 家 | 最简操作交互,门开↔关状态切换 |
| 3 | ground_marble | 散落的弹珠 | 拾取 | 空地 | 拾取完整流程:提示→弯腰→消失→计数+1 |
| 4 | phone_booth | 公用电话亭 | 观察 | 街道 | 室外独立物体观察,户外推镜体验 |
| 5 | owner_shop | 老板 | NPC | 小卖部 | 走向人→推镜→场景描述文本 |
### 空地
| ID | 名称 | 类型 | 描述 |
|---|---|---|---|
| ground_marble | 散落的弹珠 | 拾取 | 彩色花纹弹珠 |
| ground_card | 水浒卡碎片 | 拾取 | 被踩脏的卡片 |
| ground_stone | 小石子 | 拾取 | 打水漂用的石头 |
| tree_empty | 大树 | 观察 | 爬不上去的梧桐树 |
| puddle | 水坑 | 观察 | 昨天下的雨还没干 |
**探索路线**: 家(冰箱→门)→ 街道(电话亭)→ 小卖部(老板)→ 空地(弹珠)
### 巷子
| ID | 名称 | 类型 | 描述 |
|---|---|---|---|
| cat_alley | 流浪猫 | 观察 | 巷子深处的猫 |
| window_alley | 老窗户 | 观察 | 窗台上的花盆 |
| box_alley | 废纸箱 | 操作(翻找) | 可能藏着好东西 |
| spider_alley | 蜘蛛网 | 观察 | 角落里的蛛网 |
### 第二轮:体验填充(5 个,系统跑通后追加)
### 水塘边
| ID | 名称 | 类型 | 描述 |
|---|---|---|---|
| pond_edge | 水塘 | 观察 | 水面倒映着天空 |
| frog_pond | 青蛙 | 观察 | 荷叶上的青蛙 |
| reed_pond | 芦苇 | 观察 | 风吹过的沙沙声 |
| ground_wrapper | 糖纸 | 拾取 | 彩色的糖纸 |
| ground_eraser | 橡皮擦 | 拾取 | 用了一半的橡皮 |
验证多交互物并存、不同物体形态的推镜差异。
| # | ID | 名称 | 类型 | 区域 | 补什么体验 |
|---|---|---|---|---|---|
| 6 | tv_home | 老式电视 | 观察 | 家 | 同区域第二件观察物,验证不冲突 |
| 7 | shelf_snack | 零食货架 | 观察 | 小卖部 | 矮物体推镜角度,近距离观察 |
| 8 | ground_card | 水浒卡碎片 | 拾取 | 空地 | 第二个拾取品,验证不互相干扰 |
| 9 | wall_graffiti | 墙上的涂鸦 | 观察 | 街道 | 墙面类物体,水平推镜方向 |
| 10 | box_alley | 废纸箱 | 操作(翻找) | 巷子 | 第二种操作类型,与门不同 |
### 后续版本(v0.1 可选,不阻塞验收)
以下交互物在第一轮 + 第二轮全部完成后,视开发进度按区域补充:
| 区域 | ID | 名称 | 类型 |
|------|---|---|---|
| 家 | bed_home | 我的床 | 观察 |
| 家 | desk_home | 书桌 | 观察 |
| 家 | calendar_home | 日历 | 观察 |
| 小卖部 | shelf_drink | 冰柜 | 观察 |
| 小卖部 | card_rack | 卡片架 | 观察 |
| 街道 | bike_street | 老式自行车 | 观察 |
| 街道 | laundry | 晾衣杆 | 观察 |
| 街道 | manhole | 下水道盖 | 观察 |
| 空地 | ground_stone | 小石子 | 拾取 |
| 空地 | tree_empty | 大树 | 观察 |
| 空地 | puddle | 水坑 | 观察 |
| 巷子 | cat_alley | 流浪猫 | 观察 |
| 巷子 | window_alley | 老窗户 | 观察 |
| 巷子 | spider_alley | 蜘蛛网 | 观察 |
| 水塘边 | pond_edge | 水塘 | 观察 |
| 水塘边 | frog_pond | 青蛙 | 观察 |
| 水塘边 | reed_pond | 芦苇 | 观察 |
| 水塘边 | ground_wrapper | 糖纸 | 拾取 |
| 水塘边 | ground_eraser | 橡皮擦 | 拾取 |
---
@@ -260,29 +259,27 @@ v0.1 使用近似占位模型而非纯不可见触发区域,以便调试相机
- 冰箱用方箱子、自行车用简单两轮模型,不要求贴图精确
- 后续美术阶段替换为正式资产
**交互物占位模型需求**:
**交互物占位模型需求**(按实现阶段排列):
| 区域 | 交互物 | 占位模型建议 |
|------|--------|------------|
| 家 | 旧冰箱 | 白色方箱子(~1.7m 高) |
| 家 | 老式电视 | 方箱 + 凸起背部(~0.5m 高) |
| 家 | 书桌 | 长方体桌面 + 四腿(~0.75m 高) |
| 家 | 日历 | 薄长方体贴墙(~0.4m 高) |
| 家 | 床 | 扁平长方体(~0.5m 高) |
| 小卖部 | 零食货架 | 多层架结构(~1.8m 高) |
| 小卖部 | 冰柜 | 矮宽方箱(~0.9m 高) |
| 小卖部 | 卡片架 | 窄薄立架(~1.2m 高) |
| 小卖部 | 老板(NPC) | 简单人形胶囊体,坐姿 |
| 街道 | 公用电话亭 | 窄高方柱(~2m 高) |
| 街道 | 老式自行车 | 简单车形(两轮 + 车架) |
| 街道 | 晾衣杆 | 长杆 + 几块平面(衣物) |
| 空地 | 大树 | 圆柱树干 + 球形树冠 |
| 空地 | 水坑 | 扁平圆形,反光材质 |
| 巷子 | 流浪猫 | 小型胶囊体,低矮 |
| 巷子 | 废纸箱 | 开口方箱(~0.5m 高) |
| 水塘 | 青蛙 | 极小胶囊体 |
| 水塘 | 芦苇 | 几根细圆柱簇 |
| 拾取品(通用) | 弹珠/卡片/糖纸等 | 小球/小片,+ 地面光斑 |
**第一轮(必须)**:
| ID | 交互物 | 占位模型建议 |
|---|--------|------------|
| fridge_home | 旧冰箱 | 白色方箱子(~1.7m 高) |
| door_home | 家的门 | 扁平方片,可绕轴旋转 |
| ground_marble | 散落的弹珠 | 小球体,+ 地面光斑 |
| phone_booth | 公用电话亭 | 窄高方柱(~2m 高) |
| owner_shop | 老板(NPC) | 简单人形胶囊体,坐姿 |
**第二轮(追加)**:
| ID | 交互物 | 占位模型建议 |
|---|--------|------------|
| tv_home | 老式电视 | 方箱 + 凸起背部(~0.5m 高) |
| shelf_snack | 零食货架 | 多层架结构(~1.8m 高) |
| ground_card | 水浒卡碎片 | 小方片,+ 地面光斑 |
| wall_graffiti | 墙上的涂鸦 | 墙面贴花/色块 |
| box_alley | 废纸箱 | 开口方箱(~0.5m 高) |
---