Qumanit Boss Keys — 更新日志
ATOMIC Soundcore / Qumanit Labs 诠漫实验室

说明
本日志按正式版本和重要开发阶段整理。同为 1.0.0 的内部测试构建曾持续更新，
不代表每一份旧安装包都包含这些测试功能；1.1.0 将其统一纳入发布版本。
未单独发布的开发阶段不补造版本号。音色编辑器是开发工具，不包含在公开安装包中。

======================================================================
1.1.0 — 2026-10-06（含预设切换修订构建）
======================================================================

演奏与音色切换
• 严格采用以下换音色逻辑：在 A 按住音符后切换 B，只对 A 尚未松开的键发送松键，
  保留 A 的采样、音高、声部滤波和包络参数，按 A 的原包络释音；已经释音的声部
  保持原有进度，不重新触发、不重新起音。切换后按下的新音符使用 B。
• 取消旧测试构建中换音色时强制 5 ms 截断旧声部的处理，避免长释音被突然切短。
• 修订构建撤回此前增加的输出边界补偿，不再向混音输出叠加额外的 5 ms 修正波形。
• 松键与新参数生效统一在同一音频块边界处理；不再在“提出切换请求”和“切换完成”
  两处重复触发松键，避免旧音先被新参数修改或新按键被第二次松键打断。
• 同一音色工程内更换采样组时复用原卷积器，不因映射变化重建效果器。
• 混响、IR、DAC 和饱和直接使用新预设参数，不因预设切换或旁通而调用 reset。
  旁通的模块保留内部状态并暂停处理；显式停止/重新准备音频设备仍可正常初始化。
• IR 选择保留连续输入历史，不清空目标 IR，也不额外插入切换淡化。
  近/远选择共用每条 IR 的卷积历史，减少重复的近/远卷积实例。
• 清理切换时等待触发的旧音符，并保持旧采样资源到相关声部释音结束后再回收。
• 后级混响、扬声器卷积和 DAC 等仍采用共享效果链；本功能并非每个旧声部
  各保留一套完整后级效果器，也不表示兼容完整 GM 音色表。

音色与试听（合并此前内部 Demo 构建）
• 加入 Model X2 Line Out 线路输出预设及中、英、日介绍，内置音色总数增至 12。
• 预设浏览器增加方形 Preview 播放按钮和环形进度显示。
• 为 Childhood Core、Model B 短视频音色及 Model X2 配置专用 MIDI 试听；
  尚未配置 MIDI 的预设禁用 Preview，避免播放不对应的内容。
• Model X2 与 Model X2 Line Out 共用同一份 MIDI Preview，共 4 个预设可试听、
  3 份预设试听 MIDI。线路版试听仍使用线路版音色，不自动换回扬声器版。
• Preview 仅在对应预设的浏览页面播放；换预设或离开预设浏览器时自动停止。
• 关于页的红色演示曲署名可播放内置 MIDI Demo，不覆盖用户当前调好的参数；
  Demo 播放过程中可以切换音色，乐曲时间线继续前进。
• 点击演示曲后先退出关于页，等待 0.5 秒再开始；再次点击可暂停，恢复同样延迟。
• Preview 接管正在播放的 Demo 时，间隔由 0.2 秒改为 0.5 秒。
• 响应宿主运行到停止的状态变化及 MIDI 全部停止信号，避免内部播放遗留音符。

包络与编辑工具（合并此前内部曲度构建）
• 音量包络及滤波器包络增加指数曲度调节，范围 0–20；0 为线性极限，
  原有指数曲度默认值 5 保持不变。线性/指数段模式继续独立可选。
• 同步音色编辑器、工程保存及产品音频内核，使旧工程默认声音保持兼容。
• 正式演奏界面不开放采样组和 IR 编号等制作数据的直接编辑。

界面与多语言
• 为机架钢琴面板上排中间模式键补充红色指示灯，与矢量按键位置对应。
• 修复日语致谢的富文本跨行定位：演示曲的红色文字与点击区域不再落到 UI 设计行。
• 核对三种语言中作者姓名、职责、排列顺序及主页链接。
  霓桔衣桔 / Nikiyiki / 霓衣千彩音列在 IR 采样支持之后，标注项目灵感、
  创作思路支持及演示曲创作。既有贡献者的署名与主页继续保留。
• 英语正文保留略增的行间距，分隔线按实际正文高度匹配；两枚底部标志保持对齐。
• 关于页加入隐藏互动彩蛋；离开页面即清除，不保存至预设或宿主工程。
• 补齐特殊符号的内嵌字体回退，避免化学式下标等字符依赖系统字体安装情况。

发布与兼容性
• 产品版本统一为 1.1.0，VST3 与独立版共用同一套音频内核和内置音色。
• Inno Setup 安装包继续允许只装 VST3、只装独立版或同时安装。
• 安装包加入本更新日志，继续排除开发工程、编辑器、调试符号和临时素材。
• 保留原有参数 ID、预设 ID 与宿主状态保存机制。按宿主音色序号编排的自动化
  在新增预设后仍建议逐项检查；更新前请先保存 DAW 工程并关闭旧插件实例。

======================================================================
1.0.0 — 首个正式版本及后续同版本测试构建（2026-10）
======================================================================

首个正式版本
• 基于 JUCE 的 Windows x64 VST3 软音源，以国产玩具琴、入门键盘的声音特征
  为主要方向；采用自研采样播放与 DSP 处理内核。
• 内置 Model X、Model X2、Model B 与 Classic Rack Piano 四类琴型，
  首版 11 个音色；按琴型分组显示预设及介绍。
• 支持完整键位映射、力度层、根音、音高微调、循环播放与释音段循环。
• 多复音上限 256；机架钢琴预设采用 64 复音；音量包络量化上限 512 级。
• 音量和滤波器包络支持各段独立线性/指数模式、分区 ADSR 倍率、
  释音最小电平及短平滑收尾；重复音截断与延迟触发可独立设置。
• 滤波器含力度跟随的线性/对数响应和截止频率包络；LFO 支持波形、速度、
  延迟、音高量化及 PMD/AMD 调制。
• 支持标准音的音分、赫兹和晶振单位换算。
• 采样位深处理与输出 DAC 降质分开；原采样与输出过渡独立控制，
  提供保持、线性及相关平滑处理，线性采样模式可调 FIR 阶数。
• 输出降采样支持整数采样率、自适应宿主采样率及可调后级高切。
• 双近/远 IR 按距离比例混合后卷积，独立混响位于 IR 前；
  滤波器、LFO、IR、混响、饱和等模块可分别启用。

产品界面与交互
• 1000 × 660 基准的可缩放原生矢量界面，保持字体、图形与控件的比例关系。
• BASIC 页集中标准音、力度与扬声器控制；高级页分区显示其余音频参数，
  页面切换时琴型图和上方布局平滑过渡。
• 三款键盘的琴键响应 MIDI 和鼠标演奏，按键动画采用 5 ms 按下、20 ms 松开过渡；
  鼠标按键位置影响力度。机架琴提供 MIDI 指示及 VOLUME 按钮试听。
• 自定义预设浏览器支持立即试听选择的音色，取消恢复进入页面前的音色及调节。
• 音量包络、滤波器包络和 LFO 显示实时声部追踪点；包络区分按键与离键两段。
• 同位置声部点保持重合，复音计数对齐稳定；数字支持双击输入与鼠标滚轮调节。
• 中、英、日三语言界面与预设介绍；关于页包含构建信息、项目介绍、署名主页、
  公司及工作室矢量标志。语言选项仅在关于页显示。

同版本后续内部测试
• 增加独立运行版本，以及音频设备、采样率、缓冲区和 MIDI 输入设置。
• 制作 VST3 / 独立版组件可选安装包。ASIO 尚待发布授权，未启用；不包含 AAX 或 AU。
• 增加指数包络曲度、Model X2 线路预设、预设 MIDI Preview 和关于页 Demo 彩蛋。
  这些功能在 1.1.0 中统一发布并完善播放/切换行为。

======================================================================
重要 Demo / 开发阶段回顾（未单独作为正式发布号）
======================================================================

一、采样与内核原型
• 建立 XMW 相对采样记录解码，支持动态采样率事件及原生 8 位样本。
• 建立普通 WMC 与种子混淆 EWMC 多采样容器，集中保存映射、根音及循环等元数据。
• 采样加载与播放分离，音频回调不执行磁盘读取；Windows VST3 与制作工具共用内核。
• 去除默认占位声音及不需要的离键采样，只有实际导入并完成映射的区域才发声。

二、音色制作工具
• 增加 WAV/XMW 导入、映射与力度层、区域参数、IR 导入、预设增删编辑及工程导入导出。
• 预设独立保存参数和映射，共用工程采样库；引入可新建、复制、保存、排序的采样组。
• 完善采样与 IR 重排时的稳定引用，避免顺序变化破坏音色映射。
• 增加 MIDI 设备输入、中文界面以及可直接输入的数值控件。

三、原生矢量 UI 与交互预览
• 从通用调试面板转为自定义界面，开发矢量 UI 制作与导出流程。
• 完成分组、节点、坐标、颜色、透明度、渐变、字体和元素备注等制作能力。
• 琴型示意图及标志使用矢量轮廓；正式插件无需 SVG 运行时，不将制作模式暴露给用户。
• 逐步完善四琴型展示、预设分类、可缩放排版、菜单动效、键盘动画和多语言关于页。

项目以非营利方式免费提供，不限制用户创作商业音乐作品。
安装包不自动关闭 DAW，也不删除用户的音色制作工程或宿主项目。