docs(design): 交互系统执行案与项目文档整理

- 新增交互系统执行案 (P-002a)，含层级状态模型、行为规则、边界情况 - 新增概念草案 concept.md、头脑风暴记录 - 新增 Agent 配置 (策划/PM/程序) 及角色记忆 - 新增 P-002 质量门审查报告、任务汇报、工作日志 - 更新路线图、current.md 等项目计划文档 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
2026-06-05 01:04:30 +08:00
parent 05d4e5ab9a
commit cdf7f68788
23 changed files with 3584 additions and 117 deletions
@@ -0,0 +1,149 @@
+# 任务归档 — 草案前工作
+
+> 归档时间：2026-06-04
+> 说明：这些任务在正式阶段流程建立之前完成，现从 current.md 归档。
+
+## 基础设施
+
+### **INF-001** Git 分支策略与提交规范
+
+- **类型**：基础设施
+- **实际产出**：`.claude/refs/GIT-GUIDE.md`、`.claude/refs/GIT-GUIDE-LITE.md`
+- **完成日期**：2026-06-01 前后
+- **备注**：含 UE5 特别注意事项、远程仓库配置
+
+---
+
+### **INF-002** 项目目录结构与协作体系设计
+
+- **类型**：基础设施
+- **实际产出**：项目目录结构、四角色协作体系
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **INF-003** 建立项目基础设施
+
+- **类型**：基础设施
+- **实际产出**：目录结构、规范文档、CLAUDE.md
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **INF-004** 开发流程重构
+
+- **类型**：基础设施
+- **实际产出**：四阶段框架、阶段目录、文档同步规范
+- **完成日期**：2026-06-03
+
+---
+
+## 头脑风暴
+
+### **D-000** Brainstorm 讨论记录
+
+- **类型**：头脑风暴
+- **实际产出**：`docs/design/prototype/brainstorm-2026-06-01-vision-pillars-world.md`
+- **完成日期**：2026-06-01
+- **备注**：阶段 1-5 全部完成（愿景探索、支柱深挖、场景世界观、范围优先级、共识总结）
+
+---
+
+## 设计文档（原型阶段前置产出）
+
+> 以下设计文档在草案阶段 concept.md 未正式产出前即已编写，作为素材保留于 `docs/design/prototype/`。
+
+### **D-PRE-001** 游戏愿景文档
+
+- **实际产出**：`docs/design/prototype/game-vision.md`
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **D-PRE-002** v0.1 范围定义
+
+- **实际产出**：`docs/design/prototype/v01-scope.md`
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **D-PRE-003** 玩家控制设计
+
+- **实际产出**：`docs/design/prototype/player-controller.md`
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **D-PRE-004** 交互系统设计
+
+- **实际产出**：`docs/design/prototype/interaction-system.md`
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **D-PRE-005** v0.1 场景设计
+
+- **实际产出**：`docs/design/prototype/scene-v01-suburban.md`
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **D-PRE-006** 修正项目时代设定
+
+- **实际产出**：更新 `CLAUDE.md` + `docs/art/style-guide.md`
+- **完成日期**：2026-06-01 前后
+
+---
+
+### **D-PRE-007** 收集系统设计
+
+- **实际产出**：`docs/design/prototype/collection-system.md`
+- **完成日期**：2026-06-02 前后
+
+---
+
+### **D-PRE-008** 场景与世界观详细设计
+
+- **实际产出**：`docs/design/prototype/scene-world.md`
+- **完成日期**：2026-06-02 前后
+
+---
+
+### **D-PRE-009** 小游戏系统设计
+
+- **实际产出**：`docs/design/prototype/minigame-system.md`
+- **完成日期**：2026-06-02 前后
+
+---
+
+### **D-PRE-010** 叙事框架设计
+
+- **实际产出**：`docs/design/prototype/narrative-framework.md`
+- **完成日期**：2026-06-02 前后
+
+---
+
+### **D-PRE-011** 主角角色设计
+
+- **实际产出**：`docs/design/prototype/protagonist-character.md`
+- **完成日期**：2026-06-02 前后
+
+---
+
+## 正式草案任务
+
+### **D-001** 玩法概念草案
+
+- **类型**：草案文档
+- **实际产出**：`docs/design/concept.md`（保留在位）
+- **完成日期**：2026-06-04
+- **备注**：7 字段齐全（一句话描述、核心游玩内容与感受、核心受众画像、游戏核心循环、游戏元素、市场定位与三大卖点、参考）。进入原型阶段后冻结，不再修改。
+
+---
+
+### **D-002** 技术可行性评估
+
+- **类型**：草案文档
+- **实际产出**：`docs/technical/feasibility-assessment.md`（保留在位）
+- **完成日期**：2026-06-04
+- **备注**：10 系统逐一评估，总体结论"有条件通过"。包含技术栈推荐、单人开发资源瓶颈分析、原型阶段 v0.1-v0.3 技术路线。
@@ -1,83 +1,118 @@
 # 当前进度

-> 最后更新：2026-06-03
+> 最后更新：2026-06-05
 > 代理完成工作后汇报结果，由开发者确认后才勾选 ✔

-## 当前里程碑：v0.1 场景漫游与环境交互
+## 当前阶段

-**开发阶段**: 原型阶段
-**阶段路线图**: `docs/plans/prototype-roadmap.md`
-**设计目录**: `docs/design/prototype/`
+- **开发阶段**：原型阶段
+- **当前版本**：v0.1
+- **版本验证目标**："世界有味道" — 角色控制 + 交互系统 + 6 区域白盒 + 收集计数
+- **关注问题**：这个世界好玩吗？美术风格对吗？技术方案跑得通吗？

-### 流水线状态
- 当前阶段：④执行案（①②③基本就绪）
- 阻塞点：执行案缺失，需先补齐执行案
+## 原型阶段退出标准

-### 进行中
+- [ ] 用户主观判断核心玩法已验证通过
+- [ ] `prototype/` 最终版复制到 `production/`

-> 按流水线阶段和优先级排列
+> 原型阶段使用版本开发流水线（③-⑦），执行质量门审查。
+> 原型阶段灵活性：⑤⑥允许交替推进，不必严格串行。

- [ ] 整理全局设计文档，按规范放置 — ①全局设计
- [ ] 产出 v0.1 版本设计文档（v01-design.md）— ③版本设计
- [ ] 产出玩家控制器执行案（player-controller-execution.md）— ④执行案
- [ ] 产出交互系统执行案（interaction-system-execution.md）— ④执行案
- [ ] 产出收集系统 v0.1 执行案（collection-system-execution.md）— ④执行案
+## v0.1 流水线进度

-### 待开始
+| 步骤 | 状态 | 说明 |
+|------|------|------|
+| ① 设计案 | ✅ 已有素材 | `docs/design/prototype/` 下 10 份设计文档 |
+| ② 阶段路线图 | ✅ 已有 | `docs/plans/prototype-roadmap.md` |
+| ③ 执行案 | 🔴 质量门未通过 | 审查报告 `docs/plans/reviews/P-002-review.md`，需创建独立执行案并修正 |
+| ④ 程序设计 | ⬜ 未开始 | 依赖 ③ 完成并通过质量门 |
+| ⑤ 美术产出 | ⬜ 未开始 | 白盒场景 + 占位资产 |
+| ⑥ 程序实现 | ⬜ 未开始 | 原型阶段允许与 ⑤ 交替推进 |
+| ⑦ 版本复盘 | ⬜ 未开始 | -- |

- [ ] 执行案质量门审查 — PM
- [ ] 玩家控制器程序设计（player-controller-tech.md）— ⑤程序设计
- [ ] 交互系统程序设计（interaction-system-tech.md）— ⑤程序设计
- [ ] 收集系统程序设计（collection-system-tech.md）— ⑤程序设计
- [ ] 程序设计质量门审查 — PM
- [ ] v0.1 美术资产产出 — ⑥美术产出（v0.1 允许开发者自行处理占位资源）
- [ ] 美术资产验收门审查 — PM
- [ ] 清理引擎模板变体代码 — ⑦实现（无流水线依赖，可并行）
- [ ] 角色控制器实现 — ⑦实现
- [ ] 交互系统实现 — ⑦实现
- [ ] v0.1 场景白盒搭建（6个区域）— ⑦实现
- [ ] 收集计数系统实现 — ⑦实现
- [ ] v0.1 验收测试
- [ ] 文档同步（更新设计案/执行案匹配实现）
+## 进行中

-### 已完成
+> 按优先级排列，建议从上到下依次完成

- [x] Git 分支策略与提交规范
- [x] 项目目录结构与协作体系设计
- [x] 建立项目基础设施（目录结构、规范文档）
- [x] 游戏愿景文档（game-vision.md）
- [x] v0.1 范围定义（v01-scope.md）
- [x] 玩家控制设计（player-controller.md）
- [x] 交互系统设计（interaction-system.md）
- [x] v0.1 场景设计（scene-v01-suburban.md）
- [x] 修正项目时代设定（CLAUDE.md + style-guide.md）
- [x] 收集系统设计（collection-system.md）
- [x] Brainstorm 讨论记录（brainstorm-2026-06-01）— 阶段 1-5 全部完成
- [x] 场景与世界观详细设计（scene-world.md）
- [x] 小游戏系统设计（minigame-system.md）
- [x] 叙事框架设计（narrative-framework.md）
- [x] 主角角色设计（protagonist-character.md）
- [x] 开发流程重构：四阶段框架 + 阶段目录 + 文档同步
+- [x] **P-001** 原型阶段启动准备 ✔ 2026-06-05
+  - ✅ 全面重新评估并更新 `prototype-roadmap.md`（3→4 版本）
+  - ✅ 同步更新 `roadmap.md`
+  - ✅ 建立角色汇报机制（`docs/plans/reports/`）
+  - ✅ 归档草案阶段文档

---
+- [ ] **P-002** v0.1 ③执行案 — 质量门未通过，需修正后重新提交
+  - 审查报告：`docs/plans/reviews/P-002-review.md`
+  - 以下 3 个子任务按顺序完成，全部完成后重新提交质量门

-## 设计文档状态
+  - [ ] **P-002a** 交互系统执行案
+    - 产出：`docs/design/prototype/interaction-system-execution.md`
+    - 依赖素材：`docs/design/prototype/interaction-system.md`（原始设计案）
+    - 参考范围：`docs/design/prototype/v01-scope.md`
+    - **阻塞问题**（必须修正）：
+      1. 创建独立执行案文件（含迭代记录表头）
+      2. 移除技术越界内容：JSON 数据结构定义（原文件第170-193行）、程序实现注释（原文件第1行）、白盒占位模型需求（原文件第255-282行）
+      3. 补充边界情况：交互中断行为、多交互物重叠键位冲突、推镜目标不可达、快速连续按键防护
+    - **建议修正**：
+      - 交互取消行为链补完
+      - 废纸箱翻找结果的随机机制明确化
+      - 交互中角色可移动范围/速度限制明确化

-### 已完成（均位于 `docs/design/prototype/`）
+  - [ ] **P-002b** 收集系统执行案
+    - 产出：`docs/design/prototype/collection-system-execution.md`
+    - 依赖素材：`docs/design/prototype/collection-system.md`（原始设计案）
+    - 参考范围：`docs/design/prototype/v01-scope.md`、`docs/design/prototype/scene-world.md`（区域分布）
+    - **阻塞问题**（必须修正）：
+      1. 创建独立执行案文件（含迭代记录表头）
+      2. 扩展 v0.1 执行内容：10 个拾取品清单、计数 UI 位置/格式、区域分布规则、与交互系统的关联
+      3. 补充边界情况：一次性拾取确认、全部收集完表现、重启状态处理、拾取中断处理

- [x] `game-vision.md` — 游戏愿景
- [x] `v01-scope.md` — v0.1 范围定义
- [x] `player-controller.md` — 玩家控制设计
- [x] `interaction-system.md` — 交互系统设计
- [x] `scene-v01-suburban.md` — v0.1 场景设计
- [x] `collection-system.md` — 收集系统设计
- [x] `minigame-system.md` — 小游戏系统设计
- [x] `narrative-framework.md` — 叙事框架设计
- [x] `scene-world.md` — 场景与世界观详细设计
- [x] `protagonist-character.md` — 主角角色设计
+  - [ ] **P-002c** 角色控制执行案
+    - 产出：`docs/design/prototype/player-controller-execution.md`
+    - 依赖素材：`docs/design/prototype/player-controller.md`（原始设计案）
+    - 参考范围：`docs/design/prototype/v01-scope.md`、`docs/design/prototype/protagonist-character.md`
+    - **阻塞问题**（必须修正）：
+      1. 创建独立执行案文件（含迭代记录表头）
+    - **建议修正**：
+      - 明确 WASD 相对角色朝向还是相对摄像机方向
+      - 补充视角垂直角度限制
+      - 第1行注释移除"动画蓝图"技术术语

-### 待产出
+- [ ] **P-003** v0.1 ④程序设计
+  - 依赖：P-002 完成
+  - 基于执行案设计实现方案（类/组件架构、数据流、美术需求清单）
+  - 提交程序设计质量门

- [ ] `docs/plans/roadmap.md` 更新 — 路线图补全 v0.5-v0.7
- [ ] `economy-system.md` — 零花钱经济系统设计（v0.3 前产出即可）
- [ ] `time-system.md` — 一天时间循环系统设计（v0.3 前产出即可）
+- [ ] **P-004** v0.1 ⑤美术 + ⑥程序实现
+  - 依赖：P-003 完成
+  - 白盒场景 + 占位资产 → 编写代码实现
+  - 原型阶段允许⑤⑥交替推进
+
+- [ ] **P-005** v0.1 ⑦版本复盘
+  - 依赖：P-004 完成
+  - 程序汇报偏差 → PM 协调 → 策划更新文档
+
+## 可用素材
+
+> `docs/design/prototype/` 下的设计文档 + 草案阶段产出：
+
+| 文档 | 内容 | 用途 |
+|------|------|------|
+| `game-vision.md` | 愿景、核心情感、三大支柱 | 设计案参考 |
+| `brainstorm-2026-06-01-*.md` | 5 阶段讨论记录 | 素材来源 |
+| `scene-world.md` | 场景与世界观详细设计 | 执行案：场景白盒 |
+| `protagonist-character.md` | 主角角色设计 | 执行案：角色控制 |
+| `narrative-framework.md` | 叙事框架 | 后续版本参考 |
+| `minigame-system.md` | 小游戏体系设计 | v0.2 参考 |
+| `collection-system.md` | 收集系统设计 | 执行案：收集系统 |
+| `interaction-system.md` | 交互系统设计 | 执行案：交互系统 |
+| `player-controller.md` | 玩家控制设计 | 执行案：角色控制 |
+| `v01-scope.md` | v0.1 范围定义 | 范围界定 |
+| `../concept.md` | 玩法概念草案（7 字段齐全） | 核心概念参考 |
+| `docs/technical/feasibility-assessment.md` | 技术可行性评估（10 系统） | 程序设计参考 |
+
+## 已归档
+
+- 草案阶段全部工作 → `docs/plans/archive/draft/`
+  - 基础设施、头脑风暴、10 份设计文档 → `pre-draft.md`
+  - D-001 玩法概念草案 → `docs/design/concept.md`（保留在位，归档记录）
+  - D-002 技术可行性评估 → `docs/technical/feasibility-assessment.md`（保留在位，归档记录）
@@ -1,6 +1,7 @@
 # 原型阶段路线图

 > 定义原型阶段的版本迭代计划。每个版本验证一个核心假设。
+> 最后更新：2026-06-05

 ---

@@ -10,63 +11,291 @@

 ---

-## 版本规划
+## 版本列表
+
+| 版本 | 核心验证目标 | 预估工期 | 状态 |
+|------|-------------|---------|------|
+| v0.1 | 场景漫游与环境交互 — 探索感成立吗？ | 10-18 天 | 进行中 |
+| v0.2 | 弹珠小游戏 — 操作手感行不行？策略深度够吗？ | 18-28 天 | 待开始 |
+| v0.3 | 时间循环与NPC — 时间流动让世界活了吗？ | 15-25 天 | 待开始 |
+| v0.4 | 经济与叙事框架 — 目标感和方向感成立吗？ | 15-22 天 | 待开始 |
+
+---
+
+## 版本详细规划

 ### v0.1 — 场景漫游与环境交互

-**验证假设**：在场景中自由移动并与环境交互，这个基础体验成立吗？
+**验证假设**：在千禧年城郊场景中自由移动并与环境交互，玩家能感受到"探索的乐趣"和"时代的氛围"吗？

-**范围**：
- 第三人称角色控制器（移动 + 摄像机）
- 交互系统（观察 + 拾取）
- v0.1 场景白盒（6 个区域）
- 收集计数系统（基础版）
+**核心目标**：建立"世界有味道"的基础体验
+
+**范围概述**：
+- 第三人称角色控制器（WASD 移动 + 摄像机跟随 + Shift 跑步）
+- 交互系统核心框架（观察 + 拾取 + 操作 + NPC简化版，4 种交互类型）
+- 推镜相机系统（观察类交互的特写镜头）
+- 交互提示 UI + 叙事文本 UI（打字机效果）
+- v0.1 场景白盒（6 个区域：家、小卖部、街道、空地、巷子、水塘边，~80m x 60m）
+- 收集系统基础版（拾取 + 计数，无分类无图鉴）
+
+**涉及的系统**（引用设计案中的系统名）：
+- 角色控制器（`player-controller.md`）
+- 交互系统（`interaction-system.md`）
+- 收集系统 v0.1 简化版（`collection-system.md` v0.1 范围）
+- 场景白盒（`scene-world.md` v0.1 范围）
+
+**内容完成度**：
+| 内容类型 | 完成度 | 说明 |
+|----------|--------|------|
+| 角色控制 | 初版 | 走/跑/交互，无蹲下无跳跃 |
+| 交互系统 | 初版 | 4 种交互类型框架，25+ 交互点 |
+| 收集系统 | 占位 | 仅拾取+计数，无分类图鉴 |
+| 场景 | 白盒 | 简单几何体 + 颜色区分，固定下午光影 |
+| UI | 初版 | 交互提示 + 叙事文本 + 收集计数 |
+| 动画 | 占位 | 简单占位动画或无动画 |
+| 音效 | 无 | v0.1 不含音效 |

 **验收标准**：
- 6 个区域均可探索
- 25+ 交互点可正常触发
- 10 个收集品可拾取
- 整体帧率稳定 30+
+1. **基础运行**：游戏正常启动，角色出现在家门口，无崩溃，稳定 30 帧
+2. **移动体验**：WASD 响应流畅，摄像机跟随平滑不穿墙，跑步/步行速度差异明显
+3. **交互体验**：靠近可交互物体正确显示提示（1.5m 触发），按 E 触发交互，叙事文本打字机效果正常，离开范围提示消失
+4. **场景体验**：6 个区域均可到达和探索，每个区域至少 3 个可交互物体，10 个收集品可全部拾取
+5. **氛围体验**（主观）：走在街上能感受到"千禧年城郊"的时代感，交互文本能唤起共鸣，整体让人想继续探索
+6. **多交互物不冲突**：多个交互物在范围内时只显示最近的，切换流畅
+
+**与 feasibility-assessment.md 的对齐**：
+- 角色控制器：基于已有 ChildHoodCharacter 框架，1-2 天
+- 交互系统核心框架：3-4 天（Interface + Component + 检测 + UI）
+- 推镜相机：1-2 天
+- 场景白盒（6 区域）：2-3 天
+- 交互物数据填充（25+）：2-3 天
+- 收集系统基础（拾取+计数）：1-2 天
+- 调试打磨：2-3 天
+- 合计：10-18 天

 ---

-### v0.2 — 第一个完整小游戏
+### v0.2 — 弹珠小游戏

-**验证假设**：小游戏好不好玩？操作手感行不行？
+**验证假设**：弹珠四维策略系统（规则 x 场地 x 弹珠 x 手法）操作手感成立吗？策略深度足够让人玩十几把不腻吗？

-**范围**：
- 弹珠小游戏完整实现
- NPC 对话基础版
- 基础音效（脚步、交互、环境）
- 家和小卖部的室内空间
+**核心目标**：验证小游戏可玩性——游戏三大支柱之一"好玩"是否成立

-**验收标准**：（待 v0.1 完成后详细定义）
+**范围概述**：
+- 弹珠操作手感 Throwaway 原型（先验证操作方案再正式实现）
+- 弹珠物理系统（Chaos Physics，材质参数配置）
+- 四维策略数据框架（规则/场地/弹珠属性/手法 DataAsset）
+- 弹珠独立 GameMode + PlayerController
+- 弹珠与收集系统联动（赢弹珠/输弹珠）
+- NPC 基础框架（静态站位 + 作为弹珠对手的简单 AI 决策）
+- 蹲下系统（角色控制扩展）
+- 弹珠场地标识（空地大树下的区域标记）
+
+**涉及的系统**：
+- 弹珠小游戏（`minigame-system.md` 弹珠部分）
+- 角色控制器扩展（`player-controller.md` 蹲下部分）
+- 收集系统扩展（`collection-system.md` v0.2 弹珠关联部分）
+- NPC 基础（`narrative-framework.md` 角色列表，取死党 B 作为弹珠对手）
+
+**内容完成度**：
+| 内容类型 | 完成度 | 说明 |
+|----------|--------|------|
+| 弹珠小游戏 | 初版 | 1 种规则（画圈弹），1-2 种场地，验证核心操作 |
+| 弹珠策略 | 初版 | 四维数据框架，弹珠属性差异可感知 |
+| NPC | 占位 | 1-2 个 NPC 静态站位作为对手，无对话树 |
+| 蹲下系统 | 初版 | 蹲伏移动 + 蹲伏待机 |
+| 收集联动 | 初版 | 弹珠作为收集品 + 小游戏道具 |
+| 场景扩展 | 微调 | 空地增加弹珠场地标识，不新建区域 |
+| 动画 | 占位 | 弹珠操作动画占位，蹲下动画占位 |
+
+**验收标准**：
+1. **操作手感**：弹珠的"弹射"操作（角度+力度）直觉流畅，手柄/键鼠方案至少一种体验良好
+2. **物理表现**：弹珠在不同材质地面（水泥/泥土）的滚动、碰撞表现合理
+3. **策略深度**：不同弹珠属性（大小/材质）在游戏中能感知到差异，NPC 选择不同规则/场地时需要调整策略
+4. **收集联动**：赢比赛获得弹珠、输比赛失去弹珠（有保底），弹珠库存与收集系统同步
+5. **可重复性**（主观）：连续玩 5 把以上不觉得无聊，想尝试不同弹珠/手法组合
+6. **蹲下体验**：蹲下/站起过渡自然，蹲下移动速度降低，视角降低
+
+**关键风险**（来自 feasibility-assessment.md）：
+- 操作手感是核心难题。必须先做 Throwaway 原型（2-3 天）验证操作方案，验证不通过则需调整方案（可能增加 5-10 天）
+- 物理参数对微小物体（弹珠半径约 1cm UE 单位）数值敏感，需反复调参
+
+**与 feasibility-assessment.md 的对齐**：
+- 操作手感原型：2-3 天
+- 弹珠物理系统：3-5 天
+- 四维策略数据框架：3-4 天
+- 弹珠 GameMode + PC：3-5 天
+- NPC 基础框架（静态+简单AI）：3-5 天
+- 蹲下系统：1-2 天
+- 弹珠与收集联动：2-3 天
+- 调试打磨：3-5 天（含物理调参）
+- 合计：18-28 天

 ---

-### v0.3 — 一天时间循环
+### v0.3 — 时间循环与NPC

-**验证假设**：时间流动带来的日常节奏感成立吗？
+**验证假设**：四时段的时间流动 + NPC 按时段切换位置，能让玩家感受到"这个世界是活的"吗？日常节奏感成立吗？

-**范围**：
- 一天四时段的时间系统
- 时段与光照变化联动
- 零花钱经济系统
- 时段与 NPC 位置/行为联动
+**核心目标**：验证世界的活性——时间推动世界变化，NPC 有自己的生活

-**验收标准**：（待 v0.2 完成后详细定义）
+**范围概述**：
+- TimeManager 核心框架（四时段枚举 + 推进逻辑 + 事件广播）
+- 光影联动（Directional Light 旋转角度/强度 + Skybox + 四时段渐变过渡）
+- NPC 位置调度系统（NPCScheduleComponent，时段-位置映射表）
+- 3 个核心 NPC 的时段行为配置（死党 B、小卖部老板儿子、小霸王）
+- NPC 基础活性（Idle 动画 + 小范围巡逻，非纯静态站位）
+- 简单对话系统（JSON 对话数据 + 打字机文本显示，无分支无选择）
+- 时段与活动可用性联动（小卖部下午开、晚上在家看电视）
+- 基础音效（脚步声、环境音、时段过渡音效）
+- 学校操场区域扩展
+
+**涉及的系统**：
+- 时间循环系统（`scene-world.md` 时段光影 + concept.md 日常循环）
+- NPC 系统（`narrative-framework.md` 角色列表 + `scene-world.md` NPC 常驻地）
+- 场景氛围（`scene-world.md` 声音景观 + 光影变化）
+- 场景扩展（`scene-world.md` v0.3 学校操场）
+
+**内容完成度**：
+| 内容类型 | 完成度 | 说明 |
+|----------|--------|------|
+| 时间系统 | 初版 | 四时段推进 + 事件广播，非真实时间流逝 |
+| 光影变化 | 初版 | 四时段渐变过渡，Warm/Nostalgic 色调 |
+| NPC 调度 | 初版 | 3 个核心 NPC 的时段-位置表 |
+| NPC 活性 | 初版 | Idle 动画 + 小范围移动 |
+| 对话系统 | 初版 | 单线对话文本显示，无分支选择 |
+| 音效 | 初版 | 脚步声 + 环境音 + 时段过渡音 |
+| 场景扩展 | 微调 | 新增学校操场区域 |
+
+**验收标准**：
+1. **时间推进**：时段可通过事件或玩家行为推进，推进时所有注册系统收到通知
+2. **光影过渡**：四时段之间的光影切换平滑自然（无突兀跳变），下午金黄/傍晚橙红/夜晚深蓝各有辨识度
+3. **NPC 调度**：时段切换时 3 个 NPC 正确移动到新位置（可接受 Fade In/Out 过渡），每个 NPC 至少 2 个时段有不同的常驻地
+4. **时段活动**：小卖部有开门/关门状态，晚上在家有"看电视"的状态表现
+5. **音效氛围**：不同时段有可区分的音效环境（下午蝉鸣、傍晚蛙叫、夜晚虫鸣）
+6. **节奏感**（主观）：时间流逝感觉自然、不催促，玩家有"一天过去了"的感觉
+
+**与 feasibility-assessment.md 的对齐**：
+- TimeManager 核心：2-3 天
+- 光影联动：3-5 天
+- NPC 位置调度：2-3 天
+- 时段与活动联动：2-3 天
+- 简单对话框架：3-4 天
+- 基础音效：3-5 天
+- NPC 活性微调：1-2 天
+- 学校操场场景：1-2 天
+- 调试打磨：2-3 天
+- 合计：15-25 天
+
+---
+
+### v0.4 — 经济与叙事框架
+
+**验证假设**：零花钱系统 + 事件驱动的叙事框架，能让玩家产生"目标感"和"方向感"吗？多路径达成的设计成立吗？
+
+**核心目标**：验证游戏的持续驱动力——玩家有理由继续探索、收集、玩小游戏
+
+**范围概述**：
+- EconomyManager 核心框架（零花钱计数 + 获取/消费/换币逻辑）
+- 小卖部购买流程 UI（商品列表 + 价格 + 购买确认）
+- 事件管理系统框架（EventManager，基于事件条件触发）
+- 第一个情感事件链（"帮死党准备送别礼物"的简化版）
+- 链式任务框架（QuestManager，任务条件-目标-奖励数据结构）
+- 多路径达成逻辑（弹珠赢/收集换/零花钱买，OR 条件）
+- 2-3 个核心角色的对话扩展（死党 A/B + 小霸王，条件触发对话）
+- 收集系统扩展（四类分类 + 基础图鉴 UI）
+
+**涉及的系统**：
+- 经济系统（`collection-system.md` 获取方式设计 + `minigame-system.md` 经济循环）
+- 叙事系统（`narrative-framework.md` 事件设计模式 + 结局系统）
+- 收集系统扩展（`collection-system.md` v0.2 范围）
+- NPC 对话扩展（`narrative-framework.md` 角色列表）
+
+**内容完成度**：
+| 内容类型 | 完成度 | 说明 |
+|----------|--------|------|
+| 经济系统 | 初版 | 零花钱管理 + 小卖部购买 UI |
+| 事件系统 | 初版 | 事件触发 + 条件判断 + 广播 |
+| 任务系统 | 初版 | 链式任务 + 多路径完成条件 |
+| 叙事内容 | 占位 | 1 条简化版事件链（验证框架） |
+| NPC 对话 | 初版 | 2-3 个角色条件对话，无分支 |
+| 收集扩展 | 初版 | 四类分类 + 基础图鉴，无 3D 展示 |
+| 场景扩展 | 微调 | 小卖部室内可进入 |
+
+**验收标准**：
+1. **经济循环**：能通过小游戏（弹珠）赢零花钱，能在小卖部花零花钱买东西，收支有感知
+2. **事件触发**：满足条件时事件自然触发（不弹窗不强制），触发时机符合叙事逻辑
+3. **多路径达成**：同一个目标至少有 2 种不同路径可完成（如赢弹珠 vs 攒钱买），路径切换不影响进度
+4. **链式任务**：任务有明确的前后依赖关系，前一步完成自动推进下一步
+5. **收集图鉴**：拾取的物品按四类分类展示，有进度可视化
+6. **目标感**（主观）：玩家有"我想做这件事"的内在驱动力，不是因为系统奖励而是因为故事/情感
+
+**与 feasibility-assessment.md 的对齐**：
+- EconomyManager 核心：3-5 天
+- 购买 UI：3-4 天
+- 事件系统框架：3-4 天
+- 链式任务框架：3-4 天
+- 多路径逻辑：2-3 天
+- NPC 对话扩展：2-3 天
+- 收集系统扩展：3-4 天
+- 小卖部室内：1-2 天
+- 调试打磨：2-3 天
+- 合计：15-22 天

 ---

 ## 递进关系

 ```
-v0.1 场景漫游 → v0.2 小游戏 → v0.3 时间循环
-     │              │               │
-     └─ 验证"世界有味道"  └─ 验证"游戏好玩"  └─ 验证"世界是活的"
+v0.1 场景漫游+交互          v0.2 弹珠小游戏          v0.3 时间循环+NPC          v0.4 经济+叙事
+     │                          │                        │                         │
+     └─ "世界有味道"            └─ "游戏好玩"            └─ "世界是活的"            └─ "有理由继续"
+                                                                                    
+探索感基础 → 玩法深度 → 世界活性 → 持续动力
 ```

-v0.1 是基础（场景 + 交互），v0.2 在此基础上加玩法深度，v0.3 加时间维度让世界活起来。
+**递进逻辑**：
+
+1. **v0.1 是地基**：没有场景漫游和交互，后续一切都无从谈起。验证最基本的"在千禧年场景中走动并交互"是否成立。如果这个假设失败，项目方向需要根本性调整。
+
+2. **v0.2 验证核心玩法**：小游戏是三大支柱之一（concept.md 定义）。弹珠作为第一个小游戏验证"操作手感成立"和"策略深度足够"，这是整个小游戏体系的风险前置。如果弹珠不好玩，后续拍洋画、四驱车等也需要重新评估。
+
+3. **v0.3 验证世界活性**：在"好玩"的基础上加时间维度，让世界有节奏感。NPC 调度让空旷的场景有生气。此版本依赖 v0.2 产出的 NPC 基础框架。
+
+4. **v0.4 验证持续驱动力**：经济系统给玩家"钱"的概念（要做选择），叙事框架给玩家"方向"（为什么要做这些事）。多路径达成是 concept.md 的核心设计原则，必须验证。此版本依赖 v0.2 的弹珠（经济来源之一）和 v0.3 的 NPC/时间系统。
+
+**为什么是 4 个版本而不是原来的 3 个**：
+- 原 v0.2 同时包含弹珠小游戏（20-32天最大工作量）和 NPC 对话+室内+音效，范围过大
+- 原 v0.3 同时包含时间循环、经济系统、NPC 联动、音效，范围过大
+- 拆为 4 个版本后，每个版本聚焦一个核心假设，工作量更均衡（10-28 天/版本 vs 原来 10-32 天），风险更低
+
+---
+
+## 设计文档深度评估
+
+以下评估基于 `docs/design/prototype/` 下各设计文档的当前状态，指导每个版本需要的设计补充工作：
+
+| 设计文档 | 当前深度 | v0.1 可用度 | 后续版本需要的补充 |
+|----------|---------|------------|-------------------|
+| `player-controller.md` | 深入 | 直接可用 | v0.2 需补充蹲下系统执行案 |
+| `interaction-system.md` | 深入 | 直接可用 | 无 |
+| `v01-scope.md` | 精确 | 直接可用 | 无 |
+| `scene-world.md` | 极详尽 | v0.1 白盒参考 | v0.3 补充学校操场、v0.4 补充小卖部室内 |
+| `collection-system.md` | 完整 | v0.1 拾取部分可用 | v0.2 补充弹珠关联、v0.4 补充四类分类+图鉴 |
+| `minigame-system.md` | 完整 | 不涉及 | v0.2 需补充弹珠执行案（操作方案、物理参数范围、NPC AI 规则） |
+| `narrative-framework.md` | 框架清晰 | 不涉及 | v0.3 补充对话数据格式、v0.4 补充事件链执行案 |
+
+---
+
+## 阶段退出标准
+
+原型阶段通过以下条件后，可由用户决定进入批量生产阶段：
+
+1. **核心假设验证**：v0.1-v0.4 的四个核心假设（探索感、可玩性、世界活性、持续动力）全部通过用户主观判断
+2. **核心循环可玩**：至少存在一个可玩的核心循环（起床-探索-小游戏-收集-推进目标-入睡）的完整原型
+3. **文档已同步**：所有通过验证的系统的执行案已更新至与实际实现一致（迭代记录标记为"已同步"）
+4. **技术风险可控**：无未解决的阻塞性技术问题
+5. **用户确认**：用户明确表示"核心玩法已验证通过"

 ---

@@ -74,4 +303,5 @@ v0.1 是基础（场景 + 交互），v0.2 在此基础上加玩法深度，v0.3

 | 日期 | 调整内容 |
 |------|----------|
-| 2026-06-03 | 初始版本规划 |
+| 2026-06-05 | 全面重新评估：3 版本扩展为 4 版本，补全验收标准/系统清单/内容完成度/设计文档深度评估/阶段退出标准，与 feasibility-assessment.md 工期数据对齐 |
+| 2026-06-03 | 初始版本规划（3 版本：v0.1 场景漫游、v0.2 小游戏、v0.3 时间循环） |
@@ -0,0 +1,37 @@
+# 美术汇报
+
+> 最后更新：—
+> 当前无活跃任务
+
+---
+
+## 基本信息
+
+- **日期**：—
+- **阶段**：原型阶段
+- **版本号**：—
+- **当前任务 ID**：—
+
+---
+
+## 本期完成内容
+
+—
+
+---
+
+## 遇到的问题 / 偏差
+
+—
+
+---
+
+## 下一步计划
+
+—
+
+---
+
+## 需要协调的事项
+
+—
@@ -0,0 +1,37 @@
+# 策划汇报
+
+> 最后更新：—
+> 当前无活跃任务
+
+---
+
+## 基本信息
+
+- **日期**：—
+- **阶段**：原型阶段
+- **版本号**：—
+- **当前任务 ID**：—
+
+---
+
+## 本期完成内容
+
+—
+
+---
+
+## 遇到的问题 / 偏差
+
+—
+
+---
+
+## 下一步计划
+
+—
+
+---
+
+## 需要协调的事项
+
+—
@@ -0,0 +1,37 @@
+# 程序汇报
+
+> 最后更新：—
+> 当前无活跃任务
+
+---
+
+## 基本信息
+
+- **日期**：—
+- **阶段**：原型阶段
+- **版本号**：—
+- **当前任务 ID**：—
+
+---
+
+## 本期完成内容
+
+—
+
+---
+
+## 遇到的问题 / 偏差
+
+—
+
+---
+
+## 下一步计划
+
+—
+
+---
+
+## 需要协调的事项
+
+—
@@ -0,0 +1,112 @@
+# P-002 审查报告
+
+**审查日期**：2026-06-05
+**审查对象**：v0.1 执行案质量门 -- 交互系统、收集系统、角色控制
+**宏观阶段**：原型阶段
+**审查文件**：
+- `docs/design/prototype/interaction-system.md`
+- `docs/design/prototype/collection-system.md`
+- `docs/design/prototype/player-controller.md`
+- `docs/design/prototype/v01-scope.md`（范围参考）
+
+---
+
+## 结构性问题
+
+| 检查项 | 结果 | 说明 |
+|--------|------|------|
+| 独立执行案文件 | ❌ | 三个系统均无独立执行案文件（应为 `<系统名>-execution.md`） |
+| 迭代记录表头 | ❌ | 无任何文件包含迭代记录表头 |
+
+---
+
+## 交互系统（interaction-system.md）
+
+| 检查项 | 结果 | 说明 |
+|--------|------|------|
+| 完整性 | ✅ | 4 种交互类型覆盖全，交互物清单完整 |
+| 清晰性 | ⚠️ | 基本清晰，有少量模糊点（移动范围限制、废纸箱随机机制） |
+| 边界情况 | ❌ | 缺失：交互中断、多交互物键位冲突、推镜不可达、快速按键防护、遮挡处理 |
+| 技术越界 | ❌ | 包含 JSON 数据结构、程序实现注释、白盒占位模型需求 |
+| 范围一致性 | ✅ | v0.1 范围控制良好，"不包含"清单明确 |
+
+**判定**：不通过
+
+### 问题清单
+
+1. [阻塞] 缺失独立执行案文件和迭代记录
+2. [阻塞] 技术越界：JSON 数据结构定义（第170-193行）、程序实现注释（第1行）、白盒占位模型需求（第255-282行）
+3. [阻塞] 边界情况缺失：交互中断行为、多交互物重叠键位冲突、推镜目标不可达、快速连续按键防护
+4. [建议] 交互取消行为链不完整
+5. [建议] 废纸箱翻找结果的随机机制未明确
+6. [建议] 交互中角色可移动范围/速度限制模糊
+7. [轻微] 打字机效果"每字"定义不清
+8. [轻微] v0.1 可选交互物清单可能造成优先级困惑
+
+---
+
+## 收集系统（collection-system.md）
+
+| 检查项 | 结果 | 说明 |
+|--------|------|------|
+| 完整性 | ❌ | v0.1 部分仅 4 行，缺少行为规则、拾取品清单、计数 UI 定义 |
+| 清晰性 | ❌ | v0.1 描述过粗，程序无法直接实现 |
+| 边界情况 | ❌ | 完全缺失：重复拾取、全部收集完、重启状态、拾取中断 |
+| 技术越界 | ✅ | 未涉及技术实现细节 |
+| 范围一致性 | ✅ | 版本划分清晰，v0.1 范围合理 |
+
+**判定**：不通过
+
+### 问题清单
+
+9. [阻塞] 缺失独立执行案文件和迭代记录
+10. [阻塞] v0.1 执行内容匮乏：缺少 10 个拾取品清单、计数 UI 位置/格式、区域分布、与交互系统的关联
+11. [阻塞] 边界情况缺失：一次性拾取确认、全部收集完表现、重启状态处理、拾取中断处理
+
+---
+
+## 角色控制（player-controller.md）
+
+| 检查项 | 结果 | 说明 |
+|--------|------|------|
+| 完整性 | ⚠️ | 核心行为覆盖好，缺少 WASD 相对方向、视角限制等细节 |
+| 清晰性 | ✅ | 行为描述清晰，数值标注合理 |
+| 边界情况 | ⚠️ | 原型阶段基本可接受，缺少场景边界、输入冲突处理 |
+| 技术越界 | ⚠️ | 基本合规，第1行注释含"动画蓝图"技术术语 |
+| 范围一致性 | ✅ | P0/可简化/不做三级清晰 |
+
+**判定**：有条件通过 -- 需创建独立执行案，补充少量遗漏项
+
+### 问题清单
+
+12. [阻塞] 缺失独立执行案文件和迭代记录
+13. [建议] WASD 相对角色朝向还是相对摄像机方向未明确
+14. [建议] 视角垂直角度限制未说明
+15. [轻微] 第1行注释含技术术语"动画蓝图"
+
+---
+
+## 总判定
+
+**不通过。**
+
+### 阻塞级问题汇总（必须修正）
+
+| # | 问题 | 归属 |
+|---|------|------|
+| 1 | 缺失独立执行案文件和迭代记录（3个系统） | 全部 |
+| 2 | 交互系统技术越界（JSON/程序注释/白盒需求） | 交互系统 |
+| 3 | 收集系统 v0.1 执行内容匮乏（缺行为规则/拾取品清单/UI定义） | 收集系统 |
+| 4 | 收集系统边界情况完全缺失 | 收集系统 |
+| 5 | 交互系统边界情况缺失（中断/冲突/不可达） | 交互系统 |
+
+### 修正后方可进入的下一步
+
+④ 程序设计
+
+### 修正方向建议
+
+1. 创建三个独立执行案文件（含迭代记录表头）
+2. 交互系统执行案：移除技术越界内容，补充边界情况
+3. 收集系统执行案：扩展 v0.1 行为规则至可实现的详细程度，补充边界条件
+4. 角色控制执行案：提取 v0.1 范围部分，补充少量遗漏项
@@ -9,11 +9,14 @@

 > 验证核心玩法可行性。详见 [prototype-roadmap.md](prototype-roadmap.md)

-| 版本 | 核心验证 | 状态 |
-|------|----------|------|
-| v0.1 | 场景漫游与环境交互 | 🔄 进行中 |
-| v0.2 | 第一个完整小游戏 | ⬜ 待开始 |
-| v0.3 | 一天时间循环 | ⬜ 待开始 |
+| 版本 | 核心验证 | 预估工期 | 状态 |
+|------|----------|---------|------|
+| v0.1 | 场景漫游与环境交互 | 10-18 天 | 进行中 |
+| v0.2 | 弹珠小游戏（操作手感+策略深度） | 18-28 天 | 待开始 |
+| v0.3 | 时间循环与NPC（世界活性+节奏感） | 15-25 天 | 待开始 |
+| v0.4 | 经济与叙事框架（目标感+持续动力） | 15-22 天 | 待开始 |
+
+**原型阶段总预估工期**：58-93 天（约 2-3 个月）

 ---

@@ -24,10 +27,9 @@

 | 版本 | 核心内容 | 状态 |
 |------|----------|------|
-| v0.4 | 叙事与收集 | ⬜ 待规划 |
-| v0.5 | 多小游戏 + 收集扩展 | ⬜ 待规划 |
-| v0.6 | 乡下章节 | ⬜ 待规划 |
-| v0.7 | 整合 + 多支线 + 结局 | ⬜ 待规划 |
+| v0.5 | 多小游戏（四驱车 + FC/街机）+ 收集扩展 | 待规划 |
+| v0.6 | 乡下章节（独立场景+乡村活动） | 待规划 |
+| v0.7 | 整合 + 多支线 + 结局系统 | 待规划 |

 ---

@@ -37,4 +39,4 @@

 | 版本 | 核心内容 | 状态 |
 |------|----------|------|
-| v1.0 | 全内容打磨 + 发布 | ⬜ 待规划 |
+| v1.0 | 全内容打磨 + 发布 | 待规划 |
@@ -0,0 +1,9 @@
+# 工作日志
+
+> 记录每日实际投入时间与工作内容
+
+| 日期 | 时长 | 内容 |
+|------|------|------|
+| 2026-06-03 | 2h | 初始化项目（仓库搭建、CLAUDE.md、工作流文档、Agent配置） |
+| 2026-06-04 | 2h | 尝试 AI 美术流程 |
+| 2026-06-05 | 2h | 建立草案阶段产出（概念案 + 技术可行性评估）、完成草案阶段收尾、进入原型阶段、设计与更新原型 roadmap（3→4版本） |