安装指南

当前支持平台

当前对外首发目标是 Windows 桌面端。

| 平台 | 当前状态 | |---|---| | Windows 10 22H2+ / Windows 11 x64 | 当前首发目标 | | macOS | 未来平台，当前不提供正式签名、公证和分发 | | Linux | 未来平台，当前不提供正式安装包 | | Android / iOS | 未来 App 轨道，当前不是可用产品入口 |

Windows 安装

1. 从 下载页面 下载 VoSonar-0.3.0-setup.exe 或页面标注的更新版本。
2. 双击安装器。
3. 根据安装器提示准备运行资源。
4. 安装完成后启动 VoSonar。

每用户安装路径：

%LOCALAPPDATA%\Programs\VoSonar\VoSonar.exe

用户数据目录：

%APPDATA%\VoSonar\

该目录会保存本地数据库、设备标识、首次启动状态、设置、历史记录和 Rust Core 需要的本地加密/存储文件。

安装器会做什么

当前 Windows 安装器不是传统 MSI 文档口径。它会：

• 释放并校验内嵌的 core setup。
• 检查本地 ASR、标点、VAD 模型和 ffmpeg 等运行资源。
• 在资源缺失时下载、校验并写入 %APPDATA%\VoSonar\runtime-assets-ready.json。
• 安装主程序并启动首次使用引导。

如果资源下载或 SHA256 校验失败，请重新下载安装器，或稍后在网络稳定时重试。

更新检查

VoSonar 的更新是提示式更新，不是静默自动更新。

应用会读取 HTTPS release manifest，确认版本、下载 URL、SHA256 和安装包大小。下载的 Windows Setup 会保存到：

%LOCALAPPDATA%\VoSonarUpdates\

SHA256 校验通过后，VoSonar 才会启动安装器并退出当前应用。

常见安装问题

Windows 阻止未知发布者

如果 Windows 安全提示拦截安装，请确认安装包来源于 VoSonar 官方下载页，并检查文件名、版本号和 SHA256。代码签名和下载分发状态以下载页和发布验收记录为准。

启动后提示录音引擎未就绪

这通常表示 native library、模型资源或音频设备不可用。请先重启应用；如果仍然失败，检查安装器是否完整完成运行资源准备。

macOS 或 Linux 安装包在哪里

当前没有正式发布的 macOS/Linux 安装包。网站或旧文档中出现的 DMG、Deb、AppImage 口径不代表当前可用发行物。