安装
正式版安装包内置了默认的识别和 AI 润色服务，安装完成即可听写。之后可以随时换成其他服务商或本地模型。
一条命令安装
Windows 10 或 11，在 PowerShell 中执行：
irm https://raw.githubusercontent.com/sunerpy/voltip/main/scripts/install.ps1 | iexLinux（x86_64）和 macOS（Apple 芯片或 Intel 芯片），在终端中执行：
curl -fsSL https://raw.githubusercontent.com/sunerpy/voltip/main/scripts/install.sh | sh脚本会为这台电脑选择合适的安装包，并连同发布附带的 SHA256SUMS 一起下载。校验不通过时不会安装任何内容。
- Windows：静默运行按用户安装的安装器，不需要管理员授权，安装完成后自动启动 Voltip。
- Linux：有 apt 的系统通过 apt 安装
.deb，会要求输入密码；否则把 AppImage 放到~/.local/bin，并添加到应用菜单。 - macOS：自动识别处理器类型（在 Rosetta 终端中同样适用），下载对应的 dmg，把应用放进
/Applications；没有写入权限时放进~/Applications。用这种方式安装的应用，打开时不会被 Gatekeeper 拦下。
选项
选项是传给 sh 的环境变量，写在管道之后：
| 变量 | 作用 |
|---|---|
VOLTIP_VERSION=0.0.7 | 安装指定版本，而不是最新版本 |
VOLTIP_PACKAGE=appimage | 在有 apt 的系统上改为安装 AppImage |
VOLTIP_INSTALL_DIR=<目录> | 把 AppImage 或 Mac 应用放到其他目录 |
例如 curl -fsSL … | VOLTIP_VERSION=0.0.7 sh。在 PowerShell 中，先执行 $env:VOLTIP_VERSION = "0.0.7"，再执行安装命令。
上面的命令从 main 分支读取安装脚本。如果要使用某个版本随附的脚本，把 main 换成它的标签，例如 v0.0.7。
安装包
每个发布版本都附带安装包、SHA256SUMS 和构建证明。
| 平台 | 安装包 | 说明 |
|---|---|---|
| Windows 10 和 11，x64 | *_x64-setup.exe，按用户安装；*_x64-portable.zip，解压后运行 voltip-desktop.exe，旁边的 DLL 需要保留 | 尚未进行代码签名，首次启动时 SmartScreen 会提示 |
| Linux，x64 | .deb、.AppImage | 在 Ubuntu 22.04 上构建，需要 glibc 2.34 或更高版本。.deb 依赖 libwebkit2gtk-4.1-0、libvulkan1 和 libblas3；AppImage 需要 FUSE 2（libfuse2）。支持 X11 和 Wayland |
| macOS 11 及以上，Apple 芯片 | *_aarch64.dmg | M1 及更新的芯片 |
| macOS 11 及以上，Intel 芯片 | *_x64.dmg | Intel 芯片的 Mac |
| Android | 尚未发布 | 见手机端 |
Windows
安装包尚未进行代码签名。首次启动时，SmartScreen 可能显示「Windows 已保护你的电脑」：选择「更多信息」，再选择「仍要运行」。
macOS
dmg 安装包使用项目自己的证书签名，但未经 Apple 公证。打开 dmg，把 Voltip 拖到「应用程序」。由于应用未经公证，macOS 会拦下首次启动：
- macOS 15 及更新版本：打开「系统设置 → 隐私与安全性」，选择「仍要打开」。
- macOS 11 至 14：在「应用程序」中按住 Control 点按 Voltip，选择「打开」。
- 也可以在终端中执行
xattr -dr com.apple.quarantine /Applications/Voltip.app，效果相同。
之后的更新在应用内完成。从 0.0.6 及更早版本更新时，各项权限还会再询问一次：钥匙串的提示选择「始终允许」；如果之后听写无效，在系统设置的「辅助功能」和「麦克风」中把 Voltip 关闭后再打开。
Linux
.deb：执行sudo apt install ./Voltip_0.0.7_amd64.deb，apt 会一并安装依赖。- AppImage：用
chmod +x设为可执行后运行，需要libfuse2。 - 在 Wayland 下，粘贴需要辅助工具，全局快捷键需要在系统设置中配置。见各平台说明。
核对下载的文件
把文件与 SHA256SUMS 中对应的一行比对（sha256sum，Mac 上用 shasum -a 256），再确认它出自这个仓库的发布流程：
gh attestation verify Voltip_0.0.7_amd64.deb --repo sunerpy/voltip \
--signer-workflow sunerpy/voltip/.github/workflows/release-candidate.yml从源码构建
见开发者。从源码构建的版本没有默认服务，需要在应用中选择服务商或本地模型。