Skip to content

ShadowBuster 1.6.8 · macOS(Apple Silicon)

Choose a tag to compare

@AngleNaris AngleNaris released this 10 Sep 14:23
· 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(三步构建全流程)