Skip to content

v2.2.5 — 模型下载「CERTIFICATE_VERIFY_FAILED」修复

Choose a tag to compare

@Superce1l Superce1l released this 15 Oct 03:50
· 22 commits to main since this release

STTMiniTool v2.2.5

本版修复用户反馈的**「下载并加载模型」失败**。两张截图两个报错(CERTIFICATE_VERIFY_FAILED 与 'gbk' codec can't encode '\u26a0'),实为同一条链:

企业/校园网络里的 HTTPS 代理(深信服等)会用自己的根证书重签 TLS 连接。Python 的 ssl 模块不认代理的根证书 → 到 HuggingFace 的所有模型下载直接证书验证失败。

🔐 SSL 证书验证失败自动降级

下载遇证书验证错误时自动降级为不验证重试一次:

  • 模型来源全为固定可信主机(huggingface.co / github.com),风险可控
  • 降级时写入运行日志(logs/app-年月.log)留痕
  • 只针对证书错误——超时、DNS 失败等其他网络错误仍走原有的镜像/备援逻辑,行为不变

🖥️ GBK 控制台安全输出

第二张截图的 'gbk' codec can't encode character '\u26a0' 是这样来的:下载备援逻辑的提示 print 里有 ⚠✅❌ 等字符,简体中文 Windows 的 GBK 控制台打不出来,抛出的编码错误反而取代了原始的 SSL 错误——界面「加载失败」显示的正是这个编码错误。现改用安全输出:编码不了的字符替换为 ?,保证提示能出去、真实错误能上抛。


打包内容:STTMiniTool.exe(onefile,WebView2 界面)+ CrispASR 核心二进制。模型文件不随包附带,首次使用时按需下载。

受企业代理影响的用户升级后可直接下载模型;若你的网络有额外的白名单限制,也可在「设置 → HuggingFace 镜像」填 https://hf-mirror.com 走镜像站。

全部修复经 mock 与真实网络双重验证:SSL 降级重试、非证书错误不降级、GBK 控制台输出、真实下载回归、404 错误路径,全部通过。