Skip to content

fix(transcriber): 修复 large-v3-turbo 因仓库 404 无法下载 (#402)#413

Closed
JefferyHcool wants to merge 1 commit into
developfrom
fix/whisper-turbo-repo-404
Closed

fix(transcriber): 修复 large-v3-turbo 因仓库 404 无法下载 (#402)#413
JefferyHcool wants to merge 1 commit into
developfrom
fix/whisper-turbo-repo-404

Conversation

@JefferyHcool

Copy link
Copy Markdown
Owner

问题

Issue #402:在「音频转写设置」点击 large-v3-turbo 的下载按钮后,无进度转圈、状态一直显示「未下载」、前端也没有任何错误提示。

根因

内置映射 large-v3-turboSystran/faster-whisper-large-v3-turbo,但该仓库已从 HuggingFace 下架:

GET https://huggingface.co/api/models/Systran/faster-whisper-large-v3-turbo → 401 (Repository Not Found)

下载在后台执行,snapshot_download 立即抛错被 _do_download_whisper 吞掉并把 _downloading 置为 failed;但 /transcriber_models_status 只回传 downloading / downloaded 两个布尔,failed 状态被丢弃 —— 于是前端表现为「点了没反应、永远未下载、也不报错」。这与 issue 评论里 AdySnowflake 抓到的后端日志一致。

修改

large-v3-turbo 改指向社区维护的 CT2 转换版 deepdml/faster-whisper-large-v3-turbo-ct2

  • HF API 直链可达(200无重定向 → 保证 snapshot_download 落盘目录名与 _check_whisper_model_exists 的存在性检测一致,不会出现「下好了仍显示未下载」);
  • model.bin / config.json / tokenizer.json / preprocessor_config.json / vocabulary.json,恰好覆盖下载器的 allow_patterns
  • 与 faster-whisper 的 large-v3-turbo 等价(faster-whisper 1.1.1 内置映射的 mobiuslabsgmbh 仓库已 307 跳转到第三方 dropbox-dash,重定向会带来缓存目录名歧义,故选直链 200 的 deepdml)。

其余档位(tiny~large-v3)仍用 Systran 官方转换版,经校验均存活;MLX 路径的 mlx-community/whisper-large-v3-turbo 也仍存活,无需改动。

测试

新增回归测试 test_large_v3_turbo_resolves_to_live_repo,断言解析结果为存活仓库、且不再是已失效的 Systran 仓库。

$ pytest tests/test_whisper_models.py -q
14 passed

备注(非本 PR 范围):/transcriber_models_status 目前不回传 failed 状态,任何下载失败(网络等)都会静默。可作为后续改进,把失败态透出到前端以便给出错误提示。

Closes #402

🤖 Generated with Claude Code

Systran/faster-whisper-large-v3-turbo 已从 HuggingFace 下架(API 返回
401/404,仓库不存在)。用户点击下载后,后台 snapshot_download 立即抛错
被吞掉,_downloading 置为 failed 但状态接口只回传 downloading/downloaded
两个布尔,于是表现为:无进度转圈、状态一直「未下载」、前端无错误提示。

改用社区维护的 CT2 转换版 deepdml/faster-whisper-large-v3-turbo-ct2:
HF 直链可达(200,无重定向,保证缓存目录名与存在性检测一致),含
model.bin 等全部所需文件,与 faster-whisper 的 large-v3-turbo 等价。

附回归测试,断言 large-v3-turbo 解析到存活仓库而非已失效的 Systran 仓库。

Closes #402

Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com>
@JefferyHcool

Copy link
Copy Markdown
Owner Author

已通过 hotfix v2.4.3 合并进 master 与 develop(cherry-pick 自 commit 3841719),故关闭此 PR。详见发布说明。

@JefferyHcool JefferyHcool deleted the fix/whisper-turbo-repo-404 branch June 23, 2026 02:55
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant