这篇指南按第一次使用的顺序组织。准备好一个本地录音模型和可用麦克风后，无需登录，也不扣 AI 积分，即可完成语音输入。首次下载软件和模型需要联网；本地模型下载并可用后，转写可以离线进行。
下载与安装
入口： VokeLine 下载页。选择你的操作系统和设备架构，以页面实际提供的安装包为准。
- 下载对应的安装包。Windows 使用 Windows 安装程序；macOS 区分 Apple Silicon 和 Intel；Linux 使用下载页提供的 Linux 包。
- 按系统提示安装。macOS 如使用 DMG，将应用放入“应用程序”；Linux 如使用 AppImage，先允许该文件作为程序执行，再打开。
- 从系统应用列表或安装完成后的入口启动 VokeLine。首次启动先保留网络连接，准备下载模型。
结果： 主窗口显示首页和左侧导航。不要使用另一平台的安装包代替当前平台未提供的版本；安装或系统提示阻止启动时，见安装与更新问题。
截图为英文界面示例。“Home”对应“首页”，“Models”对应“模型”，“Settings”对应“设置”。
首次模型准备
入口与条件： 左侧“模型” → “本地模型”。下载需要网络和足够磁盘空间；模型卡片会显示下载大小、预计内存及支持的功能。
- 找到带“录音转写”能力的模型，核对语言和设备要求。仅支持文件转写的模型不能用于实时录音。
- 点击“下载”，等待下载、检查文件和安装完成。需要暂时中断网络时可“暂停下载”，恢复联网后“继续下载”。
- 点击已下载模型的“使用”。若模型支持两种任务，按需要将其设为录音、文件转写或两者的默认模型。
- 确认卡片显示“录音使用中”或对应的正在使用状态，再返回首页。
结果： 后续录音使用所选本地模型。下载完成不等于已经设为默认；首次下载后仍需点击“使用”。模型损坏、内存不足或下载失败时，见模型问题。
截图为英文界面示例。模型名称和当前可下载列表以你的页面为准。切换或删除模型的完整说明见模型管理。
检查麦克风
入口： 左侧“设置” → “语音与快捷键” → “输入设备”。录音需要一个已连接、未静音且获得系统麦克风权限的设备。
- 选择“系统默认设备”，或明确选择需要使用的麦克风。外接设备断开后，重新选择可用输入设备。
- 点击“测试麦克风”，说几句话。测试会在 10 秒内自动完成，不保存这次测试录音。
- 看到“已检测到声音”后继续；若没有检测到声音，检查设备静音、系统输入音量及距离，点击“重新测试”。
- 如提示权限不足，点击界面的麦克风权限设置入口；不能自动打开时，手动进入系统设置。
| 系统 | 权限检查位置 |
|---|---|
| Windows | 系统设置中的麦克风隐私权限，允许麦克风访问和桌面应用访问。 |
| macOS | 系统设置中的“隐私与安全性” → “麦克风”，允许 VokeLine 使用。 |
| Linux | 系统声音设置和桌面环境的设备权限，确认选中的输入设备可用。 |
结果： 麦克风测试检测到声音，输入设备没有不可用提示。只准备文件转写时不需要麦克风，直接使用文件转写流程。
截图为英文界面示例。“Voice and shortcuts”对应“语音与快捷键”，“Test microphone”对应“测试麦克风”。
第一次语音输入
入口与条件： 首页的麦克风按钮。先完成上述准备，并在“设置” → “语音与快捷键”中将“编辑模式”设为默认。
- 返回首页，确认按钮下方显示“点击使用：编辑模式”，点击麦克风按钮。
- 等待录音准备完成后，清楚说出一段短句。识别文字会出现在悬浮编辑框中。
- 点击录音控件结束录音，等待整理完成。不要在“正在整理”期间反复点击开始。
- 在编辑框中检查并修改文字，点击“复制”，再粘贴到目标应用。
结果： 你得到一段可以修改和复制的文字。编辑模式不会自动把文字写入其他应用；需要直接写入当前输入框时，使用直输模式。
若“保存本机记录”开启，完成后的记录可在本机历史中查看。录音文字不会因为完成转写就自动保存为云端记录。
基础设置
入口： 左侧“设置” → “常规”。
- 根据阅读习惯选择界面语言和浅色、深色或跟随系统主题。
- 按需设置开机启动和主窗口置顶。开机启动表示登录系统后在后台启动，并不表示会自动开始录音。
- 如悬浮窗不在可见位置，使用“悬浮窗位置”中的“恢复位置”。
- 如不想保存新的文字记录，在“数据与隐私”中关闭“保存本机记录”；已有记录保留；录音和文件转写的次数、音频时长及输出字符数仍会计入使用统计。
结果： 设置按当前选择生效。快捷键、麦克风和 AI 输出语言有各自的设置入口，详见功能使用；关闭记录或清空记录的区别见账户与数据。
更新与重新打开
更新入口： “设置” → “软件更新”。保持联网，查看当前版本和检查结果，再按照页面提供的更新提示操作；如没有可用更新，继续使用当前版本即可。更新受支持的平台和安装方式以当前界面为准。
关闭主窗口后，应用可能仍在后台运行。可以从系统托盘或菜单栏中的 VokeLine 菜单重新打开主窗口；悬浮工具条也可通过该菜单或已生效的语音快捷键打开。
要完全结束应用，先结束正在进行的录音或转写，再使用托盘或菜单栏中的“退出”。再次启动后，本机模型、设置和已保存记录仍可使用。录音、收起、隐藏和退出的区别见窗口与录音状态。