安装指南

本指南帮助你在不同操作系统上安装声墨 VoiceInk。

下载

安装包体积较大（Windows 272 MB，macOS 790 MB），推荐通过国内云盘下载。

离线客户端 v3.0.0（推荐）

在本地运行 AI 模型，无需联网，数据不上传。

平台	渠道	链接
Windows x64	?? 阿里云盘	点击下载
Windows x64	?? 123云盘	点击下载
Windows x64	?? GitHub（v3.0.0）	直接下载
macOS (Apple Silicon)	?? 123云盘	点击下载
macOS (Apple Silicon)	?? GitHub（v3.0.0）	直接下载

云端客户端（轻量版）

安装包仅 21MB，联网调用服务器转写。需在服务器开放时段内使用。

平台	渠道	链接
Windows x64	?? 123云盘	点击下载
Windows x64	?? GitHub（latest）	直接下载

可用版本

平台	安装包格式	说明
Windows	.exe (NSIS)	标准安装程序
macOS	.dmg	v3.0.0 正式支持 Apple Silicon
Linux	.deb / .AppImage	规划中

Windows 安装

方式一：MSI 安装包（推荐）

说明：以下文件名为示例，请以 Release 页面实际文件名为准。

1. 下载 VoiceInk_vX.Y.Z_x64.msi 文件
2. 双击运行安装程序
3. 按照安装向导完成安装
4. 从开始菜单启动声墨 VoiceInk

方式二：NSIS 安装包

1. 下载 VoiceInk_vX.Y.Z_x64-setup.exe 文件
2. 双击运行安装程序
3. 选择安装目录，完成安装
4. 从桌面快捷方式或开始菜单启动

安全提示

首次运行时，Windows 可能会弹出安全警告：

这是因为应用尚未获得 Windows 签名认证。点击「更多信息」→「仍要运行」即可继续。 若你从非官方渠道获取安装包，请先确认来源可信。

macOS 安装

macOS 版本已于 v3.0.0 正式发布，支持 Apple Silicon（aarch64）机型，请从上方下载表格获取 .dmg 文件。

1. 下载 .dmg 文件
2. 双击打开 DMG 镜像
3. 将声墨 VoiceInk 拖入「应用程序」文件夹
4. 从启动台打开应用

首次运行

由于应用未经过 Apple 公证，首次打开时需要：

1. 打开「系统设置」→「隐私与安全性」
2. 找到被阻止的应用提示，点击「仍要打开」

麦克风权限

首次使用录音功能时，系统会请求麦克风权限，请点击「允许」。

Linux 安装

说明：Linux 版本规划中，以下步骤为发布后参考流程。

Ubuntu / Debian

# 将 vX.Y.Z 替换为实际版本号
# 下载 deb 包
wget https://github.com/FatalBlow-hub/voiceink-asr/releases/download/vX.Y.Z/VoiceInk_vX.Y.Z_amd64.deb

# 安装
sudo dpkg -i VoiceInk_vX.Y.Z_amd64.deb

# 安装依赖（如有缺失）
sudo apt-get install -f

AppImage

# 将 vX.Y.Z 替换为实际版本号
# 下载 AppImage
wget https://github.com/FatalBlow-hub/voiceink-asr/releases/download/vX.Y.Z/VoiceInk_vX.Y.Z.AppImage

# 添加执行权限
chmod +x VoiceInk_vX.Y.Z.AppImage

# 运行
./VoiceInk_vX.Y.Z.AppImage

验证安装

安装完成后，启动声墨 VoiceInk 进行验证：

1. 检查主界面是否正常显示
2. 点击录音按钮，说几句话
3. 查看是否有文字输出
4. 若弹出麦克风权限提示，请选择「允许」

如果一切正常，说明安装成功。

常见问题

应用无法启动

• 检查系统是否满足最低要求（Windows 10 及以上）
• 尝试以管理员身份运行
• 检查是否被杀毒软件拦截

录音没有反应

• 确认麦克风设备工作正常
• 在系统设置中确认麦克风权限已授予
• 检查是否有其他应用正在占用麦克风

安装包下载缓慢

• 尝试使用国内镜像或加速器
• 从官网下载页获取备用下载链接

下一步

安装完成后，请继续阅读 快速开始 了解基本操作。