跳到主要内容

下载与安装

系统要求​

系统要求
WindowsWindows 10 / 11（64 位）
macOSmacOS 11.0 或更高（Intel 与 Apple Silicon）
Linux主流 x64 发行版（提供 deb 与 AppImage）
v3 起不再按显卡选安装包

旧版本需要按 CUDA 版本选择安装包，v3 起每个平台只有一个安装包。GPU 加速包在安装后由应用内按需下载（NVIDIA 用 CUDA、AMD / Intel 用 Vulkan、Apple 芯片自动启用 Core ML / Metal），无需手动安装 CUDA Toolkit。

选择安装包​

系统芯片安装包说明
Windowsx64windows-x64NVIDIA 用 CUDA，AMD / Intel 用 Vulkan，应用内下载
macOSApplemac-arm64自动启用 Core ML / Metal 加速
macOSIntelmac-x64仅 CPU，不支持 GPU 加速
Linuxx64linux-x64提供 deb 与 AppImage 两种格式

下载入口：下载页面 ｜ GitHub Releases ｜ 夸克网盘

macOS 安装​

推荐使用 Homebrew，会自动匹配芯片类型，升级也只需一条命令：

brew tap buxuku/tap          # 只需执行一次
brew install --cask smartsub # 安装
brew upgrade --cask smartsub # 升级

手动安装 DMG 后，如果提示**「应用程序已损坏，无法打开」**，在终端执行以下命令后重新打开即可（这是 macOS 对未上架应用的隔离机制，并非应用真的损坏）：

sudo xattr -dr com.apple.quarantine /Applications/SmartSub.app

Windows 安装​

下载 SmartSub_Windows_<版本>_x64.exe 双击安装。如遇 SmartScreen 提示，点「更多信息 → 仍要运行」。

Linux 安装​

  • deb（Debian / Ubuntu 系）：sudo dpkg -i SmartSub_Linux_<版本>_amd64.deb
  • AppImage（任意发行版）：chmod +x 后直接运行

首次启动​

第一次打开妙幕会进入新手引导：

  1. 下载一个语音模型——没有 GPU 或暂时不想下载模型，也可以先配置云端听写（联网转写，免模型免 GPU）
  2. 需要 GPU 加速的用户，安装后到「引擎」页面确认加速状态，应用会自动检测显卡并推荐加速方案，详见 GPU 加速
  3. 模型下载缓慢或失败时，可以手动下载后导入，见模型选择与导入

安装完成后，继续阅读快速上手跑通第一个任务。