手动回滚指南¶
如果升级失败或导致问题，请按照以下步骤将 WhisperJAV 恢复到可用状态。
快速参考¶
| 场景 | 解决方案 |
|---|---|
| 升级中途失败 | 方案 A：重新安装指定版本 |
| 新版本有 bug | 方案 A：重新安装指定版本 |
| 环境完全损坏 | 方案 B：全新安装 |
| Python 完全无法运行 | 方案 B：全新安装 |
方案 A：重新安装指定版本¶
当 Python 仍可运行但 WhisperJAV 出现问题时使用此方案。
第 1 步：打开命令提示符¶
- 按
Win + R - 输入
cmd并按回车
第 2 步：导航到 WhisperJAV 目录¶
第 3 步：重新安装所需版本¶
重新安装最新稳定版：
安装特定版本（例如 v1.7.3）：
python.exe -m pip install --force-reinstall git+https://github.com/meizhong986/whisperjav.git@v1.7.3
可用版本标签：
- v1.7.4 - 最新版
- v1.7.3 - 上一个稳定版
- v1.7.2、v1.7.1、v1.7.0 - 更早版本
第 4 步：验证安装¶
方案 B：全新安装¶
当 Python 环境完全损坏时使用此方案。
第 1 步：卸载 WhisperJAV¶
- 打开 设置 → 应用 → 应用和功能
- 搜索 "WhisperJAV"
- 点击 卸载
或手动删除：
第 2 步：下载新安装程序¶
前往 WhisperJAV Releases 下载最新的 .exe 安装程序。
第 3 步：运行安装程序¶
安装程序将创建一个包含所有依赖的全新环境。
保留你的数据¶
AI 模型和缓存存储在独立位置，重新安装后仍会保留：
| 数据 | 位置 | 是否保留？ |
|---|---|---|
| Whisper 模型 | ~/.cache/whisper/ |
是 |
| HuggingFace 模型 | ~/.cache/huggingface/ |
是 |
| WhisperJAV 配置 | %LOCALAPPDATA%\WhisperJAV\whisperjav_config.json |
卸载时删除 |
卸载前备份配置：
常见问题¶
"pip is not recognized"¶
PATH 环境变量设置不正确。请使用完整路径：
"Permission denied"¶
关闭所有 WhisperJAV 窗口后重试。如果仍然失败：
1. 打开任务管理器（Ctrl+Shift+Esc）
2. 结束所有来自 WhisperJAV 的 python.exe 或 pythonw.exe 进程
3. 重新执行命令
"Network error"¶
检查网络连接。如果使用代理：
获取帮助¶
如果以上方法都无效：
- 前往 GitHub Issues 提交问题
- 请附上以下信息：
- 出现问题时你正在进行的操作
- 错误信息（截图或复制粘贴）
- Windows 版本
- 以下命令的输出：
python.exe --version