Repository navigation
ShadowBuster 1.6.8 · macOS(Apple Silicon)
·
20 commits
to fix/runtime-numpy-validation
since this release
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(三步构建全流程)