跳转至
DRAFT

XiForge Stage · 调音工具搭建器 + MC 融合

范围:Phase 10-12(共 8 工作日)· 依赖:Phase 2 · 产出:3 mode chip + 动态 stageToolbar + 控件库画布 + master TuningTool 后端联通

特殊性:本 Stage 是唯一融合 MC 骨架的 Stage(用户 ADR-D4-03 决策)

Phase 列表

Phase 标题 工作日 关键产出 文档
10 XiForge mode-switcher 3 chips + 动态 stageToolbar 2d 🎨 工具布局 / 💻 源码设计 / 🧪 仿真验证 chip · layout/code → 4 按钮;simulation → 0 按钮 10-mode-switcher-dynamic-toolbar.md(占位)
11 调音工具搭建器 - 控件库 + 画布 3d TTSlider/TTKnob/TTToggle/TTLabel/TTMeter/TTButton 6 控件可拖入画布 · 属性面板编辑 20-toolbox-canvas.md(占位)
12 调音工具搭建器 - MC 骨架融合 + 源码生成 3d 画布 → JSON 序列化 · backend_csharp WebSocket 接通 · simulation mode 通过 pysidecar 仿真出图 30-mc-integration.md(占位 · 含 master 接口契约)

验收里程碑

  • ✅ Phase 10:mode 切到 simulation 时 stageToolbar 自动清空(用户原话"仿真验证 mode 不需要 stageToolbar")
  • ✅ Phase 11:6 类控件拖拽布局 + 选中后右 Drawer 显示属性 + 控件数据/event 属性可编辑
  • ✅ Phase 12:从 layout 画布生成 .json → backend_csharp write_link → DSP DLL 仿真 → pysidecar /analyze → 频响曲线显示

MC 骨架接口契约

复用 master work-{agent}/backend_csharp/ 已有能力:

操作 WebSocket 消息 后端处理
加载控件画布 read_link 返回当前 IP 工程的 layout.json
保存画布 write_link 写入 layout.json + 生成 .ipack
实时调参 set_param 通过 P/Invoke → DSP DLL
仿真启动 start_audio_engine + runMode: 'pc' 启动仿真模式(不烧录硬件)
仿真出图 HTTP POST /analyze (pysidecar) FFT/RMS/相位曲线返回

关联文档

占位说明:Phase 10-12 具体任务清单将在 Phase 2 完成 + 与后端约定 contract test 后细化。