Skip to content

本版只解决安装/启动环节的问题,笔记与复习资料功能与 v1.8.10 相同。

Choose a tag to compare

@yxyusage yxyusage released this 15 Oct 13:24
· 12 commits to main since this release

如果你是"依赖安装失败"的那位用户

先看报错关键词,对症处理:

你看到的报错 原因 怎么办
ResolutionImpossible / no matching distribution found for ctranslate2 Python 版本太新(3.15 等预发布版还没有预编译包) 装 Python 3.12,并在「设置 → 应用 → 已安装的应用」里卸载那个预发布版本
did not find executable at '...\Python3xx\python.exe' 系统里残留了已卸载的 Python 路径 装 Python 3.12(勾选 Add python.exe to PATH);把旧 Python 卸载干净再装更稳妥
下载超时 / 连接被重置 真的是网络 换网络或挂代理后重试

注意:这不是网络问题。 以前这类失败一律显示"请检查网络连接",把人引到了错误方向 —— 本版改掉了。

🔧 本版做了什么

1. 启动前先检查 Python 版本(新增 launcher/pycompat.py)

  • 支持 Python 3.10 ~ 3.14,推荐 3.12
  • 3.15 及以后的预发布版本直接拦住,并说明原因与下载地址,而不是让用户等到 pip 报一堆看不懂的冲突
    (查过 PyPI:ctranslate2 4.x 与 av 12~18 都已提供 cp314 轮子,所以 3.14 是能装的;cp315 一个都没有)
  • start.ps1 / start.sh 启动前同样检查

2. 自动跳过"幽灵 Python"

PATH 里残留的、已被卸载的 Python 路径,过去会被当成可用解释器(于是 venv 报
did not find executable at ...)。现在启动器会逐个真跑一次确认,不能用就换下一个,并告诉你原因。

3. 依赖安装失败分类

  • 是"版本太新导致没有预编译包" → 明确写出缺哪个包、建议装 3.12
  • 是"网络超时/连接失败" → 才提示检查网络
  • 只有拿不准时才回退到原来的通用提示

4. 新版 Python 也能用(轻量模式)

av / faster-whisper 改为条件依赖(python_version < "3.15"):3.15+ 上会跳过本地语音转写,
核心功能照常可用(有 CC 字幕的视频照样能生成笔记)。

5. 「环境自检」新增「Python 版本」

设置页点一下就能看到当前版本是否受支持;「离线语音转写」也会说明"当前是轻量模式"。

6. 日志乱码

启动器创建虚拟环境时强制子进程用 UTF-8,修掉日志里中文系统错误变成 ?????? 的问题。