狗屎Minimax坏我代码

docs/小型游戏完善计划.md

@@ -0,0 +1,416 @@
+# Cielonos 小型游戏完善计划
+
+## 一、目标定位
+
+### 游戏定位
+将当前Demo完善为一个**流程精悍、体验完整**的Roguelike动作游戏，包含：
+- **核心循环**: 战斗 → 获得奖励 → 升级强化 → 挑战更强的敌人
+- **目标**: 完成3-5个精心设计的关卡，体验完整的游戏流程
+- **时长**: 单次通关约30-45分钟
+
+### 核心体验
+1. **爽快的战斗**: 强调动作感和打击反馈
+2. **策略性Build**: 有限的武器/技能选择，但搭配有深度
+3. **成长感**: 每次游玩都有明显的进步
+4. **挑战性**: 难度曲线合理，有成就感
+
+---
+
+## 二、游戏流程设计
+
+### 2.1 章节结构（简化版）
+
+```
+┌─────────────────────────────────────────┐
+│              主菜单                      │
+│         开始游戏 / 设置 / 退出           │
+└────────────────┬────────────────────────┘
+                 │
+                 ▼
+┌─────────────────────────────────────────┐
+│           区域选择界面                   │
+│    [关卡1] [关卡2] [关卡3] [Boss]       │
+│         ✓ 完成    ○ 锁定    ○ 锁定      │
+└────────────────┬────────────────────────┘
+                 │
+                 ▼
+┌─────────────────────────────────────────┐
+│              战斗场景                    │
+│                                         │
+│    玩家 ←─────────────────→ 敌人        │
+│                                         │
+│    [UI: 生命 | 能量 | 武器技能]          │
+└────────────────┬────────────────────────┘
+                 │
+        ┌────────┴────────┐
+        ▼                 ▼
+┌───────────────┐  ┌───────────────┐
+│    胜利        │  │    失败        │
+│  奖励选择      │  │   重新开始     │
+└───────────────┘  └───────────────┘
+```
+
+### 2.2 关卡设计
+
+#### 关卡1: 新手教学（可选跳过）
+- **目标**: 熟悉基本操作
+- **敌人**: 1-2种基础敌人
+- **奖励**: 无需选择
+
+#### 关卡2: 基础战斗
+- **目标**: 学习闪避和格挡
+- **敌人**: 3-4种敌人混合
+- **奖励**: 选择1个被动技能
+
+#### 关卡3: 精英挑战
+- **目标**: 考验连招和反应
+- **敌人**: 精英敌人 + 小怪
+- **奖励**: 选择1个武器强化 或 1个被动技能
+
+#### Boss关: 机械心脏
+- **目标**: 综合考验所有技巧
+- **敌人**: 1个精心设计的Boss
+- **胜利奖励**: 通关结算
+
+---
+
+## 三、核心系统实现计划
+
+### 3.1 第一阶段：完善战斗系统（优先级P0）
+
+#### 3.1.1 完善玩家操作
+**需要实现**:
+- [ ] 基础移动（走、跑、跳跃）
+- [ ] 基础攻击（轻攻击、重攻击）
+- [ ] 闪避系统（无敌帧）
+- [ ] 格挡系统（完美格挡）
+- [ ] 武器切换
+- [ ] 输入缓冲优化
+
+**当前状态**: 部分实现，需要完善
+
+#### 3.1.2 完善打击反馈
+**需要实现**:
+- [ ] 击中停顿（Hitstop）
+- [ ] 屏幕震动（ScreenShake）
+- [ ] 动作延迟（Hitlag）
+- [ ] 伤害数字显示优化
+- [ ] 特效触发时机
+- [ ] 音效配合
+
+#### 3.1.3 完善格挡系统
+**需要实现**:
+- [ ] 普通格挡（减伤）
+- [ ] 完美格挡（完美时机，无伤+反击机会）
+- [ ] 格挡动画和特效
+- [ ] 格挡消耗（能量）
+- [ ] 格挡打断机制
+
+### 3.2 第二阶段：完善武器系统（优先级P0）
+
+#### 3.2.1 完善Polychrome武器
+**需要实现**:
+- [ ] 完成所有连招分支
+- [ ] 架势切换机制
+- [ ] 特殊攻击（Air Attack）
+- [ ] 武器VFX完整实现
+- [ ] 音效配合
+
+#### 3.2.2 开发第二把武器
+**建议**: 设计一把差异化的武器
+- **武器类型**: 双刃 / 法杖 / 拳套
+- **战斗风格**: 速攻型 / 蓄力型 / 召唤型
+
+#### 3.2.3 武器成长系统
+**需要实现**:
+- [ ] 武器等级提升
+- [ ] 武器技能解锁
+- [ ] 武器强化选项
+
+### 3.3 第三阶段：完善敌人AI（优先级P0）
+
+#### 3.3.1 完善LegionCenturion（百夫长）
+**需要实现**:
+- [ ] 完整的攻击模式
+- [ ] AI行为树完善
+  - [ ] 巡逻状态
+  - [ ] 追击状态
+  - [ ] 攻击状态
+  - [ ] 撤退状态
+  - [ ] 特殊攻击触发
+- [ ] 死亡动画和效果
+
+#### 3.3.2 开发新敌人
+**需要开发**:
+- [ ] **Scout（侦察兵）**: 快速、远程攻击
+- [ ] **Heavy（重装兵）**: 缓慢但强力
+- [ ] **Boss: Nexus Core（核心枢纽）**: 多阶段Boss
+
+#### 3.3.3 敌人生成系统
+**需要实现**:
+- [ ] 波次生成配置
+- [ ] 敌人类型组合
+- [ ] 生成位置控制
+- [ ] 难度缩放
+
+### 3.4 第四阶段：完善奖励系统（优先级P1）
+
+#### 3.4.1 被动技能系统
+**需要实现**:
+- [ ] 技能数据库
+- [ ] 技能效果实现
+- [ ] 技能图标和描述
+- [ ] 技能选择UI
+
+**示例技能**:
+```
+1. 生命汲取: 攻击时恢复生命
+2. 铁壁: 格挡减伤+20%
+3. 疾风: 移动速度+15%
+4. 暴击强化: 暴击伤害+25%
+5. 能量涌动: 能量恢复+20%
+```
+
+#### 3.4.2 奖励选择UI
+**需要实现**:
+- [ ] 奖励卡牌显示
+- [ ] 鼠标悬停显示详情
+- [ ] 确认选择
+- [ ] 动画过渡
+
+### 3.5 第五阶段：完善UI系统（优先级P1）
+
+#### 3.5.1 HUD界面
+**需要完善**:
+- [ ] 生命值条（带动画）
+- [ ] 能量条（带动画）
+- [ ] 武器技能图标
+- [ ] 状态效果图标
+- [ ] 小型地图（可选）
+
+#### 3.5.2 暂停菜单
+**需要实现**:
+- [ ] 暂停/继续
+- [ ] 重新开始
+- [ ] 返回主菜单
+- [ ] 音效/画质设置
+
+#### 3.5.3 主菜单
+**需要实现**:
+- [ ] 开始游戏按钮
+- [ ] 设置按钮
+- [ ] 退出按钮
+- [ ] Logo和背景
+
+#### 3.5.4 结算界面
+**需要实现**:
+- [ ] 通关时间显示
+- [ ] 击杀统计
+- [ ] 获得奖励预览
+- [ ] 再次挑战按钮
+
+### 3.6 第六阶段：完善场景和关卡（优先级P1）
+
+#### 3.6.1 场景设计
+**需要实现**:
+- [ ] 场景1: 废弃工厂（教学）
+- [ ] 场景2: 城市废墟（基础战斗）
+- [ ] 场景3: 研究所（精英挑战）
+- [ ] 场景4: Boss战场
+
+#### 3.6.2 场景过渡
+**需要实现**:
+- [ ] 场景淡入淡出
+- [ ] 玩家传送
+- [ ] 敌人清理
+
+#### 3.6.3 环境交互
+**可选实现**:
+- [ ] 可破坏物体
+- [ ] 危险区域
+- [ ] 掩体系统
+
+---
+
+## 四、内容制作清单
+
+### 4.1 敌人配置清单
+
+| 敌人名称 | 类型 | 难度 | 特殊能力 | 所需资源 |
+|---------|------|------|----------|---------|
+| Scout | 远程 | 易 | 射击、翻滚 | 动画/模型 |
+| LegionCenturion | 近战 | 中 | 格挡、冲锋 | 已有 |
+| Heavy | 重装 | 中 | 践踏、投掷 | 动画/模型 |
+| Drone | 小型 | 易 | 自爆 | 简化模型 |
+| Nexus Core | Boss | 难 | 多阶段 | 新制作 |
+
+### 4.2 武器配置清单
+
+| 武器名称 | 风格 | 攻击方式 | 连招数量 | 状态 |
+|---------|------|----------|----------|------|
+| Polychrome | 剑士 | 斩击 | 8+ | 部分完成 |
+| 双刃 | 速攻 | 连续斩击 | 6 | 待开发 |
+| FutureWand | 法术 | 射击 | 4 | 待完善 |
+
+### 4.3 技能配置清单
+
+| 技能名称 | 类型 | 效果 | 稀有度 |
+|---------|------|------|--------|
+| 生命汲取 | 被动 | 攻击回复5%伤害的生命 | 普通 |
+| 铁壁 | 被动 | 格挡减伤+20% | 普通 |
+| 疾风腿 | 被动 | 移动速度+15% | 普通 |
+| 暴击精通 | 被动 | 暴击伤害+25% | 稀有 |
+| 能量涌动 | 被动 | 能量恢复+20% | 普通 |
+| 荆棘护甲 | 被动 | 反弹10%伤害 | 稀有 |
+
+### 4.4 特效清单
+
+| 特效类型 | 数量 | 优先级 |
+|---------|------|--------|
+| 攻击命中 | 4-6 | P0 |
+| 格挡 | 2-3 | P0 |
+| 闪避 | 2 | P1 |
+| Buff/Debuff | 6-8 | P1 |
+| 死亡 | 3 | P1 |
+| 环境 | 3-5 | P2 |
+
+---
+
+## 五、技术实现优先级
+
+### 阶段一：核心体验（1-2周）
+1. 完善玩家操作手感
+2. 完善打击反馈
+3. 完善Polychrome武器
+4. 完善1-2个敌人AI
+
+### 阶段二：完整内容（2-3周）
+1. 开发第二把武器
+2. 开发3-5种敌人
+3. 开发Boss战
+4. 开发被动技能系统
+
+### 阶段三：游戏体验（1-2周）
+1. 开发UI系统
+2. 开发关卡流程
+3. 开发奖励选择
+4. 完善场景
+
+### 阶段四：打磨优化（1周）
+1. 平衡性调整
+2. Bug修复
+3. 性能优化
+4. 测试反馈
+
+---
+
+## 六、关键里程碑
+
+### M1: 可玩Demo（2周）
+**目标**: 完成基础战斗循环
+- ✅ 玩家可以完整操作
+- ✅ 至少1把武器可用
+- ✅ 至少2种敌人
+- ✅ 基本的打击反馈
+- ✅ 简单的UI
+
+### M2: 核心完成（4周）
+**目标**: 完成核心游戏循环
+- ✅ 3个关卡
+- ✅ 4-5种敌人
+- ✅ 2把武器
+- ✅ 被动技能系统
+- ✅ 基本的UI和菜单
+
+### M3: Alpha版本（6周）
+**目标**: 功能完整的游戏
+- ✅ 完整的游戏流程
+- ✅ Boss战
+- ✅ 奖励系统
+- ✅ 存档系统
+- ✅ 基本音效和音乐
+
+### M4: 正式发布（8周）
+**目标**: 打磨完成
+- ✅ 所有内容完善
+- ✅ 平衡性调整
+- ✅ 性能优化
+- ✅ Bug修复
+- ✅ 测试完成
+
+---
+
+## 七、开发建议
+
+### 7.1 聚焦核心
+- 先完成**核心战斗体验**，其他都可以后续添加
+- 每次迭代聚焦一个系统，不要同时做太多
+
+### 7.2 玩家反馈
+- 尽早让其他人测试
+- 根据反馈调整手感
+- 收集具体的问题和改进建议
+
+### 7.3 技术债务
+- 在时间允许的情况下，重构而非凑合
+- 好的架构可以加速后续开发
+- 记录需要改进的地方
+
+### 7.4 内容优先级
+1. **必须**: 核心战斗流畅、敌人有挑战性、有成就感
+2. **重要**: UI清晰、有成长系统、Boss战精彩
+3. **可选**: 复杂机制、随机事件、多结局
+
+### 7.5 质量控制
+- 每个功能完成后测试
+- 保持代码整洁
+- 及时修复Bug
+- 注意性能表现
+
+---
+
+## 八、风险与应对
+
+### 风险1: 范围蔓延
+**问题**: 不断添加新内容，无法完成
+**应对**: 
+- 严格控制范围
+- 使用优先级矩阵
+- 每个里程碑结束后重新评估
+
+### 风险2: 技术难题
+**问题**: 某些系统实现困难
+**应对**:
+- 预留时间缓冲
+- 提前研究关键技术
+- 必要时简化方案
+
+### 风险3: 玩家反馈不佳
+**问题**: 核心体验不够有趣
+**应对**:
+- 尽早测试
+- 关注核心循环
+- 快速迭代
+
+---
+
+## 九、总结
+
+将Demo完善为小型游戏的关键在于：
+
+1. **明确范围**: 聚焦核心战斗体验，不贪多
+2. **分阶段**: 按优先级逐步实现
+3. **快速迭代**: 根据反馈及时调整
+4. **质量优先**: 核心体验要打磨到位
+
+建议的开发顺序：
+```
+核心战斗 → 武器系统 → 敌人AI → 技能系统 → UI/菜单 → 关卡流程 → Boss战 → 打磨优化
+```
+
+保持每次迭代都有**可玩的产出**，而不是长时间闭门造车后再展示。
+
+---
+
+*文档生成日期: 2026-04-17*  
+*生成者: Game Designer Agent*