Problem
Original text(父 issue #110):
「Pin bump 0.15.4 → 0.15.5(處理 ModelHub API 變更),全測試綠。」
Package.swift:16 pin exact: "0.15.4"(6/16),上游 0.15.5(7/7)。這是 #110 拆解後的
第一個子項,也是 B/C/E 的 blocker——新模型都在 0.15.5 才有。
Type
feature
已查證:風險比父 issue 描述小得多
#110 把 DownloadUtils → ModelHub 標為破壞性變更。但本 repo 對該層零使用:
grep -rn "DownloadUtils" Sources/ → 零命中
- 本 repo 對 FluidAudio 的 API 面全是高階的:
AsrModels.download(version:) /
AsrModels.load(from:version:)(ParakeetEngine.swift:116-118)、
AsrManager(config:models:)(:119)、ASRResult.text/.confidence/.duration/.tokenTimings、
DiarizerManager()(DiarizationEngine)
DownloadUtils → ModelHub 是下載層內部重寫,我們不碰下載層。所以 pin bump 的實際
待驗面只有兩點,都比「破壞性變更」聽起來小:
AsrModels.download / .load 的 signature 在 0.15.5 有沒有變
- 0.15.3 移除的實驗性 zh-CN CTC / Qwen3 後端,本 repo 是否有依賴(
ChineseFamilyEngine 需確認)
Expected
Package.swift pin → 0.15.5,swift build 綠、全套件測試綠
- 上述兩個待驗面實際確認(非假設)
- 升級前後各跑一輪 release sweep 作為 before/after 證據——依 global
common-ocr-toolchain-freshness 例外 2:新版本=新 condition,舊測量不得與新測量混排
進同一 ranking
Impact
Package.swift、Package.resolved、可能 ParakeetEngine.swift / ChineseFamilyEngine.swift(若 API 面有變)、測試。
⚠️ 已知的 schema 缺口(承 #110 Residue)
measurement schema 沒有記錄 FluidAudio 版本——只有 app_version(bestASR 自己的版本)。
升級前後的 sweep row 若 bestASR 版本未變,在資料上無法區分。這使「before/after 證據」
的可比性打折。屬 #111/#118 family 的 schema 缺口,非本 issue 可獨力解;執行 sweep 時需
以其他方式(時間戳 / 手動標記)區隔兩批。
Source: decomposed from #110(2026-08-01)。API-面事實由本機 code 探勘查證。
Problem
Package.swift:16pinexact: "0.15.4"(6/16),上游 0.15.5(7/7)。這是 #110 拆解後的第一個子項,也是 B/C/E 的 blocker——新模型都在 0.15.5 才有。
Type
feature
已查證:風險比父 issue 描述小得多
#110 把
DownloadUtils → ModelHub標為破壞性變更。但本 repo 對該層零使用:grep -rn "DownloadUtils" Sources/→ 零命中AsrModels.download(version:)/AsrModels.load(from:version:)(ParakeetEngine.swift:116-118)、AsrManager(config:models:)(:119)、ASRResult.text/.confidence/.duration/.tokenTimings、DiarizerManager()(DiarizationEngine)DownloadUtils → ModelHub是下載層內部重寫,我們不碰下載層。所以 pin bump 的實際待驗面只有兩點,都比「破壞性變更」聽起來小:
AsrModels.download/.load的 signature 在 0.15.5 有沒有變ChineseFamilyEngine需確認)Expected
Package.swiftpin →0.15.5,swift build綠、全套件測試綠common-ocr-toolchain-freshness例外 2:新版本=新 condition,舊測量不得與新測量混排進同一 ranking
Impact
Package.swift、Package.resolved、可能ParakeetEngine.swift/ChineseFamilyEngine.swift(若 API 面有變)、測試。measurement schema 沒有記錄 FluidAudio 版本——只有
app_version(bestASR 自己的版本)。升級前後的 sweep row 若 bestASR 版本未變,在資料上無法區分。這使「before/after 證據」
的可比性打折。屬 #111/#118 family 的 schema 缺口,非本 issue 可獨力解;執行 sweep 時需
以其他方式(時間戳 / 手動標記)區隔兩批。
Source: decomposed from #110(2026-08-01)。API-面事實由本機 code 探勘查證。