From 187b66095eb15fdf298436476c859a4a69f4f75c Mon Sep 17 00:00:00 2001 From: "DESKTOP-2K5TJI4\\admin" Date: Mon, 1 Jun 2026 18:25:27 +0800 Subject: [PATCH] =?UTF-8?q?docs(design):=20=E4=BA=A4=E4=BA=92=E7=89=A9?= =?UTF-8?q?=E5=88=86=E9=98=B6=E6=AE=B5=E5=AE=9E=E7=8E=B0=E8=AE=A1=E5=88=92?= =?UTF-8?q?=E4=B8=8E=E7=99=BD=E7=9B=92=E6=A8=A1=E5=9E=8B=E5=AF=B9=E9=BD=90?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit --- docs/design/systems/interaction-system.md | 137 +++++++++++----------- 1 file changed, 67 insertions(+), 70 deletions(-) diff --git a/docs/design/systems/interaction-system.md b/docs/design/systems/interaction-system.md index 5e4e76a..418542d 100644 --- a/docs/design/systems/interaction-system.md +++ b/docs/design/systems/interaction-system.md @@ -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 高） | ---