ShadowBuster v1.6.10

ShadowBuster v1.6.10

更新内容

• 宽度旋钮语义修订（授权增长）：0–100% 授权比例直接授权新增 Side 的能量增长（100% = +12dB Side 增益），废除 reshape 与独立母带两层的固定增长阶梯（旧阶梯在默认档位就封顶，向上调整无响应）；单声道兼容占比上限放宽并成为唯一固定保护（120–300Hz 0.40、300–2k 0.60、2k–8k 0.75、8k+ 0.70，全局 0.70）。120Hz 以下不生成宽度、鼓攻击段收紧、变窄回退保护不变。
• 试听饱和度对齐正式链路：草稿 DSP 饱和项改为与 bass_enhance.soft_clip(drive=1.6) 同形（小信号增益 1.74），试听与导出的低频提升与谐波特征一致；试听宽度去掉旧 0.4 硬盖（默认档即饱和的死区），全程单调响应。
• 移除内置流派选择：参考曲目受版权约束无法分发，风格只来自用户参考音频；参考音频入口移入母带面板，响度改为与 EQ 风格一致的分段组件，母带面板两行与声场面板行位逐像素对齐。无参考即无风格母带（off/eq_only）。
• 采样器式参数预设（9 槽）：输出目录右侧固定 9 个方形槽位，均分占满整行；左键空槽保存当前面板参数（含面板 bypass 开关，不含路径类设置）、左键已存槽一键应用、右键进入待确认（✕）后再右键移除或左键覆盖，4 秒未确认自动取消；空槽凹陷/已存点亮/待确认反色的拟物质感。参数持久化快照升版 v2（宽度 dB → 授权比例自动迁移）。
• 修复主题切换后声场扇形颜色不跟随：改为监听主题模块的 sb-theme 同步事件直接重画一帧，不再依赖动画帧（窗口被遮挡/节流时旧 rAF 路径会停在旧主题色的最后一帧）。
• 试听播放器与正式导出的参数语义保持一致；宽度/声场/饱和的试听近似与导出预算同步修订。

安装

关闭旧客户端后覆盖安装。安装包未签名，请核对 SHA-256。安装器为 per-user，默认安装到 %LOCALAPPDATA%\Programs\ShadowBuster，无需管理员权限；历史装在 Program Files 的 per-machine 版本不会自动卸载，需先手动卸载旧版或在安装向导中明确选择目标目录。

GPU 环境版本继续使用 1.5.0，已有环境复用。本 Release 不重复上传 GPU 环境；新安装由客户端获取 v1.5.0 GPU 资源。

验证范围

• 源码全量回归：695 项通过、11 项跳过、29 项子测试通过（宽度授权语义、UI 预设槽位、母带面板对齐、试听 DSP 合同为本次新增/修订项）。
• 宽度语义数值验证：默认档（50%）典型素材 Side 兑现约 +4dB（旧版 +2–3dB 且到顶）；12dB 请求在窄素材上兑现至占比上限；constrain_width_delta 新增 growth_db 授权参数并通过越界校验测试。
• 试听 DSP 契约（Node）：默认以上宽度仍有响应（满档 ≈ 3× 半档）、默认饱和可闻、预设参数实时同步、流式连续性、Δ 监听与循环节回归通过。
• 真机 DOM 校验：母带面板与声场面板控件行逐像素对齐（577.5–613.5 / 653.5–689.5）；主题连续切换扇形逐次同步重绘；预设存/取/移除/覆盖端到端通过。
• 三步构建全部重跑：PyInstaller 外壳、CPU 运行时装配（torch 2.7.1+cpu 真实导入链 OK、htdemucs/htdemucs_6s 权重离线预置并实跑分轨验证）、Inno 安装器。
• install_test.ps1 -Version 1.6.10 静默安装通过（EXIT=0）；安装后运行时依赖导入探针通过（numpy 2.5.2）。
• GPU 环境包未改动、未重建、未上传，继续使用 1.5.0。
• 不包含私人音频、缓存、repo.bundle 或本地实验结果。

安装包校验

文件：ShadowBuster-Setup-1.6.10.exe

大小：898,429,628 bytes（约 857 MB）

SHA-256：836507bdac8d8ca7c06edaed548aa59e29d1db7fe96246b4a830a6e72b6b96a4

ShadowBuster 1.6.8 · macOS（Apple Silicon）

ShadowBuster v1.6.8 · macOS（Apple Silicon）

基于 v1.6.8 的 macOS 原生移植首个发布版本：功能与 Windows 版对齐，GPU 走 Apple GPU（MPS），全部依赖自包含，安装后离线可用。

下载

• ShadowBuster-1.6.8-macOS-arm64.dmg（882 MB）：打开后拖入 Applications 即完成安装

系统要求

• Apple Silicon（M1/M2/M3/M4）Mac
• 无需安装 Python / ffmpeg / 任何模型；DMG 内含推理解释器、Apollo、Soren、ffmpeg 与全部离线权重

首次启动（重要）

安装包未签名（开源项目），首次打开会遇 Gatekeeper 提示：

• 提示 "已损坏，无法打开" → 打开终端执行 xattr -cr /Applications/ShadowBuster.app 后重新打开
• 提示 "无法验证开发者" → 系统设置 → 隐私与安全性 → 底部点"仍要打开"
• 首次读取"桌面/下载"里的歌曲或写入输出目录时，如弹出"文件与文件夹"授权请点允许（已内置 TCC 加固：即使拒绝也会得到明确的中文提示，而不是 ffmpeg 退出码）

macOS 版特性

• GPU 加速：Lew 与 Demucs 走 Apple GPU（MPS）。Lew 在 MPS 上默认 FP16 autocast（与 Windows 版 CUDA FP16 思路一致；实测 30 秒音乐全链路 74 秒；对 FP32 输出 SNR≈58.7dB、相关 0.9999994。--precision fp32 可退回全精度）
• 单实例守卫：重复启动自动唤起已有窗口；关闭多余窗口不会误终止后台处理任务
• TCC 加固：桌面/下载里的文件直接处理（子进程只访问系统临时目录）
• Dock 图标：红边直角设计原样显示（绕过 Tahoe 系统圆角模板化）
• 处理缓存、贝斯自动清晰、无头 CLI（processing_cli.py）等 v1.6.7/1.6.8 功能全部可用

性能参考（M2 Pro 16GB / macOS 26.6）

• 30 秒双声道音乐全链路约 74 秒（FP16）；同文件 CPU 推理需 40 分钟以上
• 接收者首次处理会多几十秒（MPS 着色器编译），处理缓存可复用历史结果

验证范围

• 309 项测试通过、69 项跳过（Windows 专属 GPU 机制用例按平台跳过）、29 项子测试通过
• 安装版实测：桌面来源 MP3 端到端处理成功；30 秒音乐 74 秒（FP16）；输出峰值 0.95 无削波
• 安装包未做签名/公证（开源项目）；单实例、TCC 拒绝路径均已实测

安装包校验

文件：ShadowBuster-1.6.8-macOS-arm64.dmg

大小：924,526,806 bytes
SHA-256：bd040908c52a8fddc05bba8be9053a904c9046632ce0a009d655aaff1e5d399b

源码

• macOS 移植提交：3b908c3（分支 fix/runtime-numpy-validation），对应 v1.6.8 + macOS 适配层
• 构建文档：仓库 docs/BUILD_MACOS.md（三步构建全流程）

ShadowBuster v1.6.8

ShadowBuster v1.6.8

更新内容

• 安装器改为 per-user：无需管理员权限，默认安装到 %LOCALAPPDATA%\Programs\ShadowBuster（可自选目录）。应用目录对当前用户可写，「设置 → GPU 环境」下载的 CUDA 运行时可就地安装；用户自选受限目录（如 Program Files）会被检测并提示。历史 per-machine 安装（v1.6.x 早期）不会被自动卸载，升级需手动卸载或向导中选回原目录。
• Lew 高频重建在 CUDA 上默认使用 FP16 计算（torch.autocast）：模型内 FFT 经守卫保持 FP32，规避 cuFFT 半精度仅支持 2 的幂长度的限制（20ms 窗口 882 点）。实测 RTX 5060 Ti、10 秒双声道片段：提速约 1.65 倍，显存峰值 6245 MB → 3966 MB，输出与 FP32 相关性 0.999999、分频段能量差 ≤ 0.01 dB。CPU 环境恒为 FP32，行为不变。
• Lew 脚本纳入处理缓存指纹：lew_upscale.py 变更后旧阶段缓存自动失效，不再出现旧精度结果被复用。
• 界面 logo 更新为当前红边设计。

安装

关闭旧客户端后覆盖安装。安装包未签名，请核对 SHA-256。本版起默认 per-user 安装，无需管理员。

GPU 环境版本继续使用 1.5.0，已有环境复用。本 Release 不重复上传 GPU 环境；新安装由客户端获取 v1.5.0 GPU 资源。

验证范围

• 371 项测试通过、1 项跳过、29 项子测试通过（版本号同步校验含在内）。
• 三步构建全部重跑：外壳 PyInstaller、运行时装配（runtime 导入 OK 2.7.1+cpu，关键文件 manifest 写入）、Inno 编译 ShadowBuster-Setup-1.6.8.exe；FP16 版 lew_upscale.py 已确认进入打包运行时。
• install_test.ps1 -Version 1.6.8 静默安装通过，安装目录 runtime 导入探针通过（13 个必需模块，numpy 2.5.2）。
• FP16 数值验证基于开发机 RTX 5060 Ti 单片段 A/B 实测；整首歌端到端与多 GPU 型号未验收，安装包 per-user 行为未做独立安装器交互验证。
• 不包含私人音频、缓存、repo.bundle 或本地实验结果。

安装包校验

文件：ShadowBuster-Setup-1.6.8.exe

大小：794,927,365 bytes

SHA-256：a749ef8416ed3b321469d3bbbb55052733e6094e5f4d70690a98edbcbfb4d098

ShadowBuster v1.6.7

ShadowBuster v1.6.7

更新内容

• 声场重塑新增自适应宽度控制：120 Hz 以下低频不再被拓宽，避免整体浑浊；分频段设置能量占比与增长上限；鼓瞬态（起音）降低拓宽、尾音与混响允许有限拓宽；总量保留 UI 滑杆控制。
• 贝斯饱和新增低中频预算：180–500 Hz 饱和增量按原曲低中频密度自动收敛，最多衰减 3 dB，全曲单一静态因子，不引入动态抽吸；自动清晰仍默认关闭。
• 母带 EQ 语义重做：Bright/Warm/Fusion 改用真实 RBJ 高架/峰形滤波器，修复旧 Bright 平行结构在 9–10 kHz 的实际衰减；Bright 现按含义提升 Mid/Side 高频，并移除旧的 500–600 Hz 中央提升。
• 开发工作流统一：新增 tools/make_dev_runtime.py，开发态 Soren 运行时由打包权威源生成并哈希校验，不再直接执行外部旧 DSP 目录；处理缓存指纹包含运行时清单，算法变更后旧缓存自动失效。
• runtime_sync.ps1 打包源与校验同步更新；补充声场/贝斯/EQ 语义、开发运行时的回归测试与分析文档。

实测对比（同一首歌曲，等响度）

• 新版相对旧处理版：12–16 kHz +3.5 dB、8–12 kHz +2.0 dB，中央声像高频同向增加；1–4 kHz −2.2 至 −3.3 dB。
• 声场收敛：Side/Mid 由 −8.6 dB 回到 −10.7 dB（原版 −12.0 dB）；60–120 Hz 相对旧版 +2.6 dB。
• 相同参数（Rock/精细重建/宽度 +6 dB/混合 80%）试听反馈改善明显；详见 docs/analysis/ 下 2026-09-09 分析文档。

安装

关闭旧客户端后覆盖安装。安装包未签名，请核对 SHA-256。

GPU 环境版本继续使用 1.5.0，已有环境复用。本 Release 不重复上传 GPU 环境；新安装由客户端获取 v1.5.0 GPU 资源。

验证范围

• 358 项测试通过、1 项跳过、29 项子测试通过（含声场自适应宽度、贝斯饱和预算、EQ 频响正弦实测、开发运行时生成/校验等新测试）。
• 三步构建全部重跑：外壳 PyInstaller 构建、运行时装配（runtime 导入 OK 2.7.1+cpu，关键文件 manifest 写入）、Inno 编译 ShadowBuster-Setup-1.6.7.exe。
• install_test.ps1 -Version 1.6.7 静默安装通过，安装目录 runtime 导入探针通过（13 个必需模块，numpy 2.5.2）。
• 开发版 CLI 已用真实歌曲完成新版处理并完成等响度测量对比；未对安装包做整首歌端到端处理验收，自适应宽度/饱和预算量值为启发式，未经大样本听感验证。
• 不包含私人音频、缓存、repo.bundle 或本地实验结果。

安装包校验

文件：ShadowBuster-Setup-1.6.7.exe

大小：794,913,289 bytes

SHA-256：4513e5f28c5c8e0986d2845018d807481e2a66906c18d951cb317c816f12b319

ShadowBuster v1.6.6

ShadowBuster v1.6.6

更新内容

• 新增持久处理缓存：按输入文件 MD5、阶段输入及参数复用分轨和其他中间结果，反复调整后段参数时可跳过未变化的前段计算。
• 设置新增缓存容量与已用空间显示，默认 5 GiB，支持关闭、容量限制和二次确认清空；原始歌曲和最终成品不受清空影响。
• 新增可选 Bass「自动清晰」：在低频增强之前进行保守的清晰度 EQ；默认关闭，不保证所有音色均有改善。
• 新增无窗口 CLI：ShadowBuster.exe --cli，支持 Agent 调用、JSON 结果报告和 --no-cache；默认拒绝覆盖已有成品。
• 母带 .mastering / .mastering.json 中间报告不再堆积在成品目录；已有历史文件不自动删除。
• 更新硬件风格开关和简明帮助说明，明确软件不提供实时试听或应用内播放。

安装

关闭旧客户端后覆盖安装。安装包未签名，请核对 SHA-256。

GPU 环境版本继续使用 1.5.0，已有环境复用。本 Release 不重复上传 GPU 环境；新安装由客户端获取 v1.5.0 GPU 资源。

验证范围

• 314 项测试通过、1 项跳过、29 项子测试通过；缓存设置和自动清晰开关 JavaScript 测试通过。
• v1.6.6 外壳及安装包重新构建，打包 CLI 版本与 JSON 错误报告检查通过，7 个阶段运行时脚本与源码哈希一致。
• 本轮运行时重新装配，依赖导入及离线 Demucs 短音频分轨检查通过；相同功能的 1.6.5 本地重建包已覆盖安装并启动验证。
• 尚未对 v1.6.6 安装包进行独立安装或整首歌曲端到端验收，未测量真实歌曲的缓存加速幅度。
• 不包含私人音频、缓存、repo.bundle 或本地实验结果。

安装包校验

文件：ShadowBuster-Setup-1.6.6.exe

大小：794,883,235 bytes

SHA-256：6136bcdd700bb23a285d969a938d97b59ebb3cb3564f722caa0edc9f35abff7e

ShadowBuster v1.6.5

ShadowBuster v1.6.5

声场与母带错误修正

• 修正 styled 母带链在 4x 过采样域中错误使用内部采样率设计 Side 滤波器的问题。
• 修正 Side 低架实现方向：低频 Side 温和收束，高频不再被错误削减。
• 修正频率相关混合曲线被错误应用到时域样本索引的问题，改为在频域应用。
• 母带目标响度、压缩、限幅和 styled soren_original 响度路径保持不变。
• 母带前声场仍使用 broadband 全域拓宽；仅对新增 Side 增量施加保守的约 70 Hz / −2 dB 低频保护，以保留鼓和 Bass 的低中频包裹感。

安装

关闭旧客户端后覆盖安装。

GPU 环境版本仍为 1.5.0，已安装环境继续复用，不重复下载。本 Release 不上传 GPU 环境；新安装由客户端获取 v1.5.0 GPU 资源。

验证

• 全量测试：277 passed、29 subtests passed。
• 低频保护与四项 DSP 修复回归测试通过。
• 运行时从源码重新同步，关键 manifest 已刷新。
• 1.6.5 安装包独立安装验证通过，安装后的 runtime imports OK（torch 2.5.2）。
• 安装包未签名，请核对 SHA-256。私人音频和实验结果不包含在发布内容中。

大小：797,307,477 bytes

SHA-256：f00ab8619272f0b6ff7ca60fdb703e0bc033b3f08ef953c36dae9b0781dc92b1

ShadowBuster v1.6.4

ShadowBuster v1.6.4

母带行为恢复

• 有风格母带恢复 Soren 原版处理链，撤掉自加的 1.5 dB 限幅驱动预算及相关风格处理干预，恢复原版限幅、峰值归一化和默认 18 kHz 低通。
• 进入有风格母带前验证输入有效性；超峰时仅整段、双声道同步衰减，不额外压缩或调整人声。
• 无风格及其 EQ 路径保持不变。
• 原版 loud 沿用原版增益行为，不承诺精确命中固定 LUFS。

错误信息复制

• 错误弹窗新增“复制错误信息”，位于“知道了”左侧；两按钮等宽，整组占底部内容区一半宽度。
• 复制完整错误摘要、产物目录和详细日志，提供成功与失败反馈，不关闭弹窗。

安装

关闭旧客户端后覆盖安装。本次正式包替代此前本地 1.6.4 测试包，版本号仍为 1.6.4。

GPU 环境版本仍为 1.5.0，已安装环境继续复用，不重复下载。本 Release 不上传 GPU 环境；新安装由客户端获取 v1.5.0 GPU 资源。

验证

• 270 项测试、29 项子测试通过；错误复制与 GPU 界面状态测试通过。
• 最终包已独立安装并验证启动；母带核心、界面资源与源码逐字节核对，原生复制接口已包含。
• 原版核心一致性测试通过；此前同一母带代码已通过 CPU 和复用 GPU 解释器的歌曲处理验证。
• 安装包未签名，请核对 SHA-256。私人音频和实验结果不包含在发布内容中。

大小：812,681,891 bytes

SHA-256：b94ef3afa7a29583389bed3cf1bba19ef812ad5515faffce0b50c8eaef0a0ed4

ShadowBuster v1.6.3

ShadowBuster v1.6.3

GPU 安装修复

• 修复首次安装 GPU 环境时，Windows 拒绝访问导致已验证的解压目录无法切换为正式环境的问题；重试仍失败时可直接启用已验证目录。
• 重试安装会校验并复用已缓存的环境包和完整解压目录，避免重复下载和解压。
• 已安装且校验通过的 GPU 环境优先本地复用，不需要联网获取清单，也不会因客户端版本升级重新下载。
• 设备探测与环境切换串行执行，避免应用内部并发访问。
• 修复 GPU 设置页检查、下载、取消、重启按钮的状态和隐藏样式。
• 保留已有环境更新失败时的回滚保护。

包含此前更新

• 补齐 soundfile / libsndfile 外壳依赖，修复启动缺失模块的问题。
• 母带支持“无风格”，新用户默认选中，EQ 和响度仍可使用，保留已保存设置。
• Lew 快速档改为 6 秒分块、0.5 秒重叠，降低峰值显存需求；仍使用 FP32，标准与精细档不变。

安装与 GPU 环境

下载 ShadowBuster-Setup-1.6.3.exe，关闭旧客户端后覆盖安装。

GPU 环境版本仍为 1.5.0（torch 2.7.1+cu128），未变化、未重复上传。已安装用户直接复用，新用户由客户端获取 v1.5.0 GPU 资源。遇到旧版安装失败的用户，升级后在设置中重试；请保留原缓存与解压目录。

本版替代存在问题的 1.6.0 / 1.6.1 发布及本地 1.6.2 测试包。

验证

• 266 项测试通过，29 项子测试通过；GPU 界面状态测试通过。
• 最终安装包已独立安装并验证正常启动，确认打包的环境检查代码识别已有 GPU 环境。
• 实际失败安装已使用原缓存与解压目录恢复，CUDA 可用，未重新下载或解压。
• 安装包未签名，请核对校验值；实验音频及私人分析结果不包含在发布内容中。

大小：812,583,091 bytes

SHA-256：50b05a8f7e657d86ac286030264a78c0babc4d59c95861881c6ae2b12310bb27

ShadowBuster v1.5.0

ShadowBuster v1.5.0

本次更新：分发方式重构

v1.5.0 起，安装包改为 CPU 版瘦身运行时（约 750 MB），GPU 加速改为应用内一键下载 CUDA 环境——彻底绕开 GitHub 单文件 2 GiB 上传上限。

安装与升级

• 安装包：ShadowBuster-Setup-1.5.0.exe
• 大小：787,889,228 bytes
• SHA-256：e975b13e17d45e86ea3817b7ea736fa459bfe98da7cc38a00510a4ce8603c389
• 覆盖安装即可升级（保留设置与队列参数）。

GPU 加速（可选，一步下载）

1. 打开应用 → 设置（齿轮）→「GPU 环境」
2. 点击「下载并安装」（约 3.4 GB，断点续传，进度可取消）
3. 完成后点击「立即重启」→ CUDA 加速自动生效

GPU 环境包（torch 2.7.1+cu128）分 3 卷随 release 发布，应用自动组装并校验 SHA-256，安装到用户目录（无需管理员权限）。未安装时以 CPU 推理运行，功能完全一致。

其他

• 仓库已公开，「软件更新」检查可直接访问 GitHub Releases
• 新增 35 项单元测试（下载/校验/安装链路，无网络依赖），共 167 passed

GPU 环境包整包 SHA-256：4e1afcf66adcfb3868b25199f88aac72389a111d3bcc8689f4cc8c45bf410338（分卷与清单见 gpu-env-1.5.0.json）

ShadowBuster v1.4.2

ShadowBuster v1.4.2

界面与体验

• 全新红色品牌 logo（shadowbuster.svg），顶栏、页面图标、窗口图标、安装器全部同步替换；安装包已按修复后的完整分辨率图标（16–256px 共 7 档）重新编译
• 默认主题色改为红色（embers 红），旧用户的紫色偏好一次性自动迁移
• 声场「宽度」正方形控件重做：
  • 顶部与「声场」滑轨严格对齐，「宽度」铭牌移到方块外左上角与「声场」标签同行
  • 扇形顶点贴底
  • hover 时单向雷达扫描：从左到右匀速扫过，拖尾末端最长、发射点渐隐，首尾淡入淡出
• 母带面板：流派 / 响度同行各占一半，EQ 风格独占一行，与声场面板等高对齐
• 输出目录 / 参考音频合并为双列卡片：文字入框、点击打开选择器、直接拖入（目录 / 音频按落点路由）
• 面板开关关闭时：整面板熄灭主题色高亮、整体变暗（旋钮、滑轨、扇形全部生效）
• 下拉菜单改为固定浮层：展开不再把页面撑高、不再触发滚动条
• 修复页面幽灵滚动条与底部空白（下拉面板参与滚动高度计算所致）
• 宽度默认值统一 +6.0dB

检查更新

• 设置弹窗「软件更新」已接入：后台线程查询 GitHub Releases 最新版本，发现新版本可一键打开下载页

安装包

• 文件名：ShadowBuster-Setup-1.4.2.exe
• 大小：2,747,639,857 bytes
• SHA-256：fdfbede8d399a2f037760d91695be098086f0277431819f805120bff2aa34cb6

注：应用内“检查更新”需要仓库允许匿名访问 Release 信息；当前仓库为私有，检查会返回“无法访问”，公开仓库后即可正常使用。