# Whisper vendor（whisper.cpp v1.9.1 自建 macOS xcframework）

- 来源：https://github.com/ggml-org/whisper.cpp tag v1.9.1（MIT；MAS 先例 Aiko）
- 配置：GGML_METAL_EMBED_LIBRARY=ON（沙盒/签名合规关键，见 docs/decisions.md）、
  CoreML ON + ALLOW_FALLBACK、arm64+x86_64、macOS 13.3+
- xcframework 不入 git（40MB）。重建：
  1. `git clone --depth 1 --branch v1.9.1 https://github.com/ggml-org/whisper.cpp ~/Daily/serifu-whisper-build`
  2. `bash build-xcframework-macos.sh`（本目录内脚本；需完整 Xcode + cmake）
  3. 合并静态库 + 打 xcframework（脚本尾部注释有完整命令），产物放 `xcframeworks/whisper.xcframework`
- 已知坑：ggml-metal 静态析构在 exit() 时 abort（上游 llama.cpp#17869）——App 在
  applicationWillTerminate 里 whisper 用过则 _exit 跳过；CLI harness 同款。上游修复后移除。
- 模型：prototype/data/models/ggml-small.bin（465MB，已在盘；B3 收敛 Paths 时迁 App Support）
