常见问题

🎬 视频处理

下载视频失败怎么办？

常见原因：

• 网络问题：确保能正常访问 YouTube/Bilibili
• 链接格式错误：使用标准视频链接，不支持播放列表
• 版权限制：B站番剧、付费内容无法下载

解决方案：

1. 检查网络连接
2. 使用单个视频链接（非播放列表）

处理速度很慢？

可能原因：

• 使用的是 CPU 版 Whisper，速度较慢
• 网络延迟导致 API 调用缓慢

优化建议：

1. 使用较小的 Whisper 模型（Base 或 Small）
2. 配置 GPU 加速
3. 使用 Whisper API 而非本地模型

📝 字幕相关

字幕时间轴不准确？

解决方案：

1. 启用 强制对齐功能 获得毫秒级精度
2. 在编辑器中手动微调时间轴
3. 检查是否源视频音频有问题

翻译质量不理想？

优化建议：

1. 选择正确的场景预设：动漫、电影、科技等不同风格
2. 使用术语表：确保专有名词翻译一致
3. 尝试润色功能：选中字幕后使用"润色翻译"

🖥️ 软件使用

软件打不开/闪退？

1. 确认系统是 Windows 10 或更高版本
2. 尝试以管理员身份运行
3. 检查是否被杀毒软件误拦截
4. 重新下载完整安装包

如何更新软件？

v3.0 支持自动更新检测。当有新版本时，应用会提示你更新。

如果自动更新失败：

1. 访问 Releases 页面
2. 下载最新版本
3. 直接覆盖旧版本即可

v3.0 相关

从 v2.x 升级后配置丢失？

v3.0 的配置文件位置可能有变化。请查看 迁移指南 了解如何手动迁移配置。

macOS/Linux 版本在哪下载？

v3.0 新增了 macOS 和 Linux 支持。在 Releases 页面 下载对应平台的安装包：

• macOS: .dmg 文件
• Linux: .AppImage 文件

macOS 提示「无法打开，因为无法验证开发者」？

这是 macOS Gatekeeper 的安全提示。由于 MioSub 是开源软件，暂未购买 Apple 开发者证书进行签名。

方法一：右键打开（推荐）

1. 在 Finder 中找到 MioSub.app
2. 按住 Control 键并点击应用图标（或右键点击）
3. 在弹出菜单中选择「打开」
4. 在弹出的对话框中再次点击「打开」

首次打开后，系统会记住你的选择，之后可以正常双击打开。

方法二：系统偏好设置

1. 尝试打开应用（会被阻止）
2. 打开「系统偏好设置」>「安全性与隐私」>「通用」
3. 在底部会看到被阻止的应用，点击「仍要打开」

方法三：终端命令

打开终端，执行以下命令移除隔离（quarantine）属性：

# 移除 quarantine 属性（推荐）
xattr -d com.apple.quarantine /Applications/MioSub.app

# 或者清除所有扩展属性
xattr -cr /Applications/MioSub.app

📧 还有问题？

如果以上内容没有解决你的问题：

1. 查看 Issue：GitHub Issues 可能已有解答
2. 提交 Issue：描述问题 + 错误截图 + 日志文件
3. 加入社区：在 QQ群（群号：1082480420）中交流