[v3+v4] 开发路线总览 — AVG 闭环 → Hacknet 扩展

[HeDaas-Code]

开发路线总览

基于 GAP-ANALYSIS.md 分析，从 v2-p0 到 Hacknet 式游戏分两个活跃阶段 + 一个暂不计划阶段。

---

v3 AVG 最小闭环（milestone #2）

目标：引擎"能玩"——对话框 + 选项 + 音频 + 立绘 + 存档截图。

Issue	内容	依赖
#91	v3-01 对话框 UI（打字机 + 名字标签 + 样式）	无
#92	v3-02 选项按钮 UI（PromptInputEvt -> 按钮）	v3-01
#93	v3-03 AudioManager 真实现（BGM/SE/Voice）	无
#94	v3-04 立绘 + 背景图渲染	v3-01
#95	v3-05 存档截图 + 存档列表 UI	v3-01
#96	v3-06 BackLog 历史回看	v3-01
#97	v3-07 跳过/快进	v3-01, v3-06
#98	v3-08 设置菜单	v3-01, v3-03
#99	v3-09 集成测试 + 文档同步	v3-01~08

关键路径：v3-01 -> v3-02 -> v3-04 -> v3-09（约 1.5 周）
可并行：v3-03（音频）、v3-05（存档截图）、v3-06（历史）独立开发

---

v4 开发工具台（milestone #4）

目标：引擎有自己的 IDE——节点编辑器 + DSL 双向同步 + 实时预览 + 调试器 + 导出。模仿 Unity 的可视化开发方式。

Issue	内容	依赖
#109	v4-01 节点图编辑器（剧情节点可视化 + 连线）	v3 完成
#110	v4-02 DSL 双向同步（节点图 <-> neon 代码互转）	v4-01
#111	v4-03 实时预览（编辑器内嵌引擎 + 断点调试）	v4-01, v4-02
#112	v4-04 资源管理器（图片/音频/字体统一管理）	v3-03, v3-04
#113	v4-05 章节管理器 UI（项目结构 + 章节排序 + 路由图）	v4-01, v4-02
#114	v4-06 调试器（变量检查器 + 事件流 + 调用栈）	v4-03
#115	v4-07 项目导出（打包独立可运行游戏）	v4-05
#116	v4-08 编辑器主框架（工作台布局 + 菜单 + 插件系统）	v4-01~07
#117	v4-09 集成测试 + 文档同步	v4-01~08

关键路径：v4-01 -> v4-02 -> v4-03 -> v4-08（约 2-2.5 周）
可并行：v4-04（资源管理）、v4-05（章节管理）、v4-06（调试器）独立开发

---

Hacknet 扩展（milestone #3 · 暂不计划）

状态：暂不计划。v4 开发工具台完成后重新评估排期。当前不分配版本号。

以下 issue 保留为设计参考，不在当前排期内：

Issue	内容
#100	hacknet-01 终端模拟器
#101	hacknet-02 命令解析器 + CommandRegistry
#102	hacknet-03 neon DSL 桥接
#103	hacknet-04 虚拟文件系统
#104	hacknet-05 虚拟网络
#105	hacknet-06 进程模拟（PortHack）
#106	hacknet-07 邮件系统
#107	hacknet-08 集成测试 + 文档同步

---

总估时

阶段	工时	产出
v3 AVG 闭环	~1.5 周	能在 PyQt6 窗口完整玩 chapter01
v4 开发工具台	~2.5 周	有自己的可视化 IDE，能拖拽做剧情
合计（当前排期）	~4 周	从测试框架到可玩+可编辑的完整引擎
Hacknet 扩展（暂不计划）	~2 周	v4 完成后重新评估

---

建议执行顺序

Week 1-2: v3 AVG 闭环
  ├─ v3-01 对话框 + v3-03 音频（并行）
  ├─ v3-02 选项 + v3-04 立绘 + v3-05 存档截图
  └─ v3-06~09 历史/快进/设置/收尾

Week 3-4: v4 开发工具台
  ├─ v4-01 节点图 -> v4-02 双向同步 -> v4-03 实时预览
  ├─ v4-04 资源管理 + v4-05 章节管理（并行）
  ├─ v4-06 调试器
  ├─ v4-07 项目导出
  └─ v4-08 主框架整合 + v4-09 收尾

（暂不计划）Hacknet 扩展
  └─ v4 完成后重新评估