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/相位曲线返回 |
关联文档
- 上层契约:
v1.2-ide-architecture.md §3.2 - 协议改造:
../00-baseline-alignment.md - MC 系统架构:master
AlgoDepartment/05_system_integration/SYSTEM_ARCHITECTURE.md - v4.3 demo 参考:
layout-demo/stages/stage-xiforge.html
占位说明:Phase 10-12 具体任务清单将在 Phase 2 完成 + 与后端约定 contract test 后细化。