v0.7.1 — Stable routing and verified live mixing

0.7.1 fixes problems observed while running reference reconstruction and mixing on FL Studio 24.2.1.

• Keep the unused same-name MIDI output on a separate spare port. Leaving it unassigned could auto-pair it back to the reply port after restarting FL.
• Accept FL's measured 1/64 stereo-separation quantization without weakening volume, pan or EQ readback checks. Out-of-bounds readback still restores the original settings.
• Support FLSTUDIO_MCP_FFMPEG so desktop MCP clients can decode MP3/FLAC through an explicit local executable path.
• Update the Chinese README with installation, restart troubleshooting, real-song verification and explicit fidelity limits.

Validation: 92 offline tests; packaged stdio exposes version 0.7.1 and 32 tools; a real FL process-capture loop recovered a known volume target; the packaged live mixer completed 11 evaluations against a real MP3. The complete song pipeline produced a 58-bar / 827-note project and 124.375-second native render. See docs/validation-v0.7.1.json for measurements and test-version attribution.

Feature-distance improvement is not a perceptual similarity score. Template instruments remain approximations; original vocals, lead instruments and effect chains are not automatically recovered. Full-song offline DSP and the live six-second mixer fit are separate outputs. Reference audio and projects are not distributed.

Windows x64 ZIP includes the EXE, README, examples and dependency notices. FFmpeg and FL Studio are separate installations. Check downloaded files against SHA256SUMS.txt.

v0.7.0 — Reference mixing and arrangement detail

0.7.0 — reference mixing and arrangement detail

• Adds fl_match_mix (32 MCP tools): persistent offline audio matching and experimental live FL mixer/FX parameter search.
• Offline matching writes real processed WAV audio, replayable EQ/dynamics/stereo/ambience recipes, before/after metrics and a level-matched reference/before/after comparison. A 4× oversampled peak guard limits output to −1 dBTP.
• Whole-song rendering enables reference mixing by default; dry render and editable FLP are retained. Offline DSP is not embedded into the FLP.
• Corrects a ~139 ms multiresolution analysis offset, improves percussion leakage rejection, and preserves each section occurrence's drum timing/velocity and bass instead of reusing the first section.
• Bridge v8 adds pan/stereo controls, full EQ state and FL process ID for targeted capture. Run install again and reload the FL bridge after upgrading.
• Includes detailed Chinese README, input examples and baseline/current note-level precision/recall/F1 data.

Verification and limits

85 offline tests passed in two dependency environments. Packaged stdio reports v0.7.0 and 32 tools. Detached packaged workers completed offline mixing after the parent exited and exported a 40-bar, 814-note FLP/MIDI arrangement. On an existing 80-second FL render, reference-mix descriptor distance improved from 4.905 to 2.919; this is not perceptual similarity.

Live mixing is experimental: simulated success/error/cancellation recovery passed, but new live FL mixing and v0.7 native song rendering were not verified because the development machine's MIDI outputs share a conflicting port and FL remains open. Original settings are saved before changes; success keeps the best settings, cancellation/errors attempt exact restoration. Inspect the recovery journal if connection is lost.

The engine still approximates 4/4 drums/triads/bass. It does not recover vocals, independent leads, stems or original plugin presets. House offbeat bass remains weak in the included benchmark. NCM encrypted player files are not decoded; provide readable WAV/FLAC/MP3 audio (non-WAV requires ffmpeg).

Assets include Windows x64 EXE bundle with dependency licenses, Python wheel and SHA-256 checksums. User projects, recordings and reference music are not included.

v0.6.0 - FL Studio MCP

FL Studio MCP 首个公开版本，采用 MIT 许可证。

功能

• 统一入口 fl_recreate_music 支持整曲近似重建与单音色参数搜索。
• 整曲输出可编辑 FLP、完整 MIDI、FL 原生 WAV、A/B 音频和验证报告。
• 音色匹配保存参考、调整前、最佳结果音频及可恢复的原参数。
• 后台任务支持跨 MCP 连接查询、取消，以及关闭 FL 后继续渲染。
• 共 31 个 MCP 工具；配套桥接 v7，包含实时编曲、试听、混音和连接诊断。
• 中文 README 详解安装、乐器模板、工具参数、工作原理、故障排查和开发方式。

下载与安装

一般用户下载 fl-studio-mcp-0.6.0-windows-x64.zip。解压后包含 EXE、README、配置示例、MIT 与第三方许可证，不需要单独安装 Python。

安装并运行 loopMIDI，保存并关闭 FL，然后执行 fl-studio-mcp.exe setup。打开 FL、重连 MCP 客户端后，可用 fl-studio-mcp.exe doctor 检查连接。完整说明见 README。

Python 用户可下载 wheel，通过 python -m pip install <wheel文件路径> 安装。SHA256SUMS.txt 提供 ZIP 和 wheel 的校验值。

升级已有客户端时，请确认 MCP 的 command 指向新 EXE；已加载的旧工具列表需要重新连接后才更新。

验证

• Windows CI：Python 3.10 / 3.12 均通过安装、74 项离线测试和 wheel 构建。
• 下载版 EXE 验证 stdio 初始化和全部 31 个工具，wheel 在全新环境中安装成功。
• 开发阶段实机验证：FL Studio 24.2.1；合成歌曲重建为 40 小节、901 个音符，原生渲染约 80.095 秒且无数字削波；FLEX 完成单音搜索并保存恢复参数。
• 对整曲任务验证了父 MCP 进程退出后的后台继续、跨连接状态读取、等待关闭 FL 和继续渲染。

使用边界

目前整曲重建针对 4/4 拍的鼓、三和弦、低音和段落，不含人声、独立主旋律转录或逐轨自动音色匹配，不保证一比一还原。FLP 模板只接受 FL 24 格式。乐器模板、插件及采样需要用户自行准备，发布包不包含商业音源。

整曲原生渲染前需关闭已有 FL；单音色匹配则需保持 FL 与桥接打开、停止播放。工具不会自动关闭用户原有的 FL 窗口。