从 Snap Store 安装
Voxis 发布在 snap 的 stable 通道上。在任何支持 snapd 的发行版上，安装只需一条命令：
sudo snap install voxis
这就是完整的安装。无需添加软件源，无需下载 .deb，也没有构建步骤——snap 自带翻译引擎、它的 Python 运行时，以及绘制窗口所用的 GTK/WebKit 组件，因此您电脑上已有的任何东西都不必与我们选定的版本相匹配。
我们有意不在本页写出版本号。stable 通道会不断更新，写进文档的版本号在发布后的第二天就会过时。要查看通道此刻提供的确切版本，请运行 snap info voxis 并查看 stable: 一行；要查看您实际安装的版本，请运行 snap list voxis。这两条命令在您输入的那一刻都是准确的，这是一个页面无法保证的。
更新的方式与所有 snap 一样——snapd 会在后台刷新软件包，如果您不想等待，sudo snap refresh voxis 会立即拉取更新。这个通道上没有应用内更新器；应用商店就是更新机制。
连接音频权限——没有它，安装的应用就是“失聪”的
这是一个容易被跳过、却又无法绕过的步骤。snap 在严格的受限环境中运行：软件包声明它想要哪些接口，而系统决定其中哪些真正被连接。Voxis 需要 audio-record 接口，因为读取您的电脑正在播放的内容，与读取麦克风走的是同一条录音路径。
音频权限未连接的安装会一直“失聪”。应用能启动，窗口能打开，语言选择器能用，会话看起来也在运行——但没有任何音频到达翻译引擎，所以永远不会有译文返回。它不会表现为权限错误，而是表现为一片寂静。请显式连接它：
sudo snap connect voxis:audio-record
您可以在开始会话之前确认结果。snap connections voxis 会列出软件包的接口；audio-record 一行应当显示插头（plug）和插槽（slot）的名称，而不是在“已连接”一列显示短横线。如果显示短横线，说明上面的命令没有运行，或者它针对的是另一个安装。
- 运行
sudo snap install voxis。 - 运行
sudo snap connect voxis:audio-record。 - 运行
snap connections voxis，检查 audio-record 一行是否已连接。 - 启动 Voxis，登录，并在依赖真实会话之前先运行内置的“声音测试”。
如果您是从本地文件手动安装的软件包，而不是从应用商店安装，那么系统不会替您授予任何权限——在这种情况下，连接命令不是可有可无的附加项，而是安装的一部分。请运行它，然后重新启动应用。
Linux 上的音频捕获如何工作：PipeWire 与 Voxis 自己的 sink
Linux 端基于 PipeWire 运行。Voxis 不会试图截取您的扬声器，而是创建一个属于自己的 sink，把您想翻译的应用的音频移到其中，再读取该 sink 的监听端。它播放的译音会送到您常用的输出设备，因此永远不会进入 Voxis 正在收听的那个 sink。
由此带来的实际结果才是最重要的：Voxis 不会重新翻译自己的声音。这种分离是结构性的——译音根本不存在于被捕获的音频流中——而不是事后去猜哪个声音是哪个的过滤器。
这还意味着 Voxis 永远不会接管您系统的默认输出设备或默认输入设备。您的桌面会保持安装应用之前的行为，退出应用后也不会留下任何需要您撤销的东西。
在会议应用中选择音源：“Monitor of Voxis_Virtual_Mic”
双向会议模式还有另一半：您自己的讲话需要被翻译，并送达对方。在 Windows 上，这需要虚拟音频线驱动。在 Linux 上，Voxis 会为发出方向创建一个单独的 sink，以 Voxis_Virtual_Mic 为名发布，并把您声音的译音播放到其中。
然后，您的会议应用必须指向它。在 Zoom、Teams、Meet 或您正在使用的任何应用中，打开该应用自己的麦克风选择器，选择“Monitor of Voxis_Virtual_Mic”，而不是您的物理麦克风。其他应用能够录制的是 sink 的监听端，所以您选择的是监听端，而不是 sink 本身。
它不会做什么：Voxis 不会进入您的会议应用替您更改这项设置，也不会通过切换系统默认输入来自动把您路由到那里。您需要自己在会议应用中选择监听端，并在通话结束后把它切回您的真实麦克风。如果您忘了，对方听到的就是您未经翻译的声音——这就是应用会在双向会话开始和结束时发出提醒的原因。
转写记录写入哪里
转写记录保存在您自己的电脑上，位于您真实的主目录中，而不是 snap 的私有存储内，因此您可以用任何文件管理器打开、移动和删除它们：
~/Documents/Voxis/Transcripts
如果您的桌面使用了本地化或已迁移的“文档”文件夹，Voxis 会遵循 XDG 设置，而不是默认使用英文路径，因此该文件夹会出现在您的系统所指定的“文档”所在位置。每个会话都有自己的子文件夹，您在“翻译历史”视图中生成的任何导出文件，都会写在该会话记录的旁边。
访问您真实的主目录需要 snap 的 home 接口，通过应用商店安装时它通常已被连接。如果转写记录不在您预期的位置，请像检查 audio-record 那样，用 snap connections voxis 检查 home 一行。
您的账户和分钟数在这里的用法完全相同
Linux 版 snap 并不是一个单独计费的独立产品。您使用同一个 Voxis 账户登录，已购买的分钟数和每日免费时长同样适用于 Linux 版 snap——在 Windows 上购买的套餐可以在 Linux 上使用，每日免费时长也还是同一份，而不是并行运行的第二份。方案和余额请见价格页面。
在这个通道上无需粘贴 API 密钥，也无需管理密钥：翻译分钟数随账户提供，应用会在会话开始时获取所需内容。
Linux 版的已知限制
如实列出，以便您在安装之前而不是之后做出决定：
- 没有 AppImage 软件包。snap 是我们发布的 Linux 打包格式；我们并没有在它之外另行提供 AppImage。
- 没有自动的会议应用路由。会议的发出方向不会替您接入您的会议应用——您需要在该应用自己的麦克风选择器中选择“Monitor of Voxis_Virtual_Mic”，并在事后把它设回去。
- 您的系统默认设置不会被改动。这是设计上的选择，而不是缺失的功能，但后果是实实在在的：应用不会通过接管您的默认设备来修复路由错误的设置。
- 手动安装的本地软件包起初没有连接任何接口。在应用商店安装时会被授予的接口，在这里必须手动连接。
如果会话一直没有声音
Linux 上没有声音，几乎总能归结为少数几个原因之一，而且很快就能把它们区分开：
- 先检查权限：
snap connections voxis，查看audio-record一行。接口未连接恰好会产生这种症状，其他任何办法都解决不了。 - 运行应用内置的“声音测试”。播放和捕获是分别检查的，所以它能告诉您两半中哪一半没有声音。
- 确认确实有东西在播放。Voxis 翻译的是您的电脑正在播放的内容——暂停的视频或静音的标签页没有任何内容可供它处理。
- 在双向会议中，查看会议应用自己的麦克风选择器。如果它仍然是您的物理麦克风，对方听到的就是未经翻译的您。
- 如果仍然没有声音，请在应用内发送一份报告。报告附带一份经过脱敏的日志，其中会注明使用了哪条捕获路径，而这一点仅凭描述是没人能还原的。