文件转写

路径：设置 → 文件转写。App 内文件转写需要 试用 / Pro，即使选择 Apple 或 Free 可用的本机识别引擎也一样；所选引擎权限还会单独检查。

用法与文件限制

1. 点击 选择模型 准备文件专用的识别模型和密钥。它可以与实时语音输入的模型不同，但共享提供商密钥。
2. 将音频或视频拖入放置区，或点选文件导入。
3. 查看队列与进度。完成后复制纯文本、复制字幕，或导出字幕文件；结果会记入本机历史。

接受的扩展名为 mp3、wav、m4a、flac、opus、ogg、aac、aiff、aif、caf、mp4、mov、m4v、mkv、webm。源文件上限为 4 GiB，解码音频最长 4 小时。文件还必须包含可由 macOS 解码的音轨；扩展名受支持不代表容器内每一种编码都可读取。服务商限制与内存情况也可能使较短的文件失败。

队列中的任务可取消、重试或删除。实时语音输入、命令或翻译正占用录音、识别、处理或结果浮层时，文件转写会拒绝启动；先结束或取消当前会话。

字幕与时间戳

格式	用途与时间码
SRT	常用视频字幕；HH:MM:SS,mmm
VTT	网页视频字幕；HH:MM:SS.mmm
ASS	带样式字幕，默认 1920×1080 排版；H:MM:SS.cc
LRC	歌词或音频标记；[mm:ss.cc]，百分之一秒
带时间戳 TXT	阅读与笔记；显示到秒的时间标记

可单独导出或一次导出全部五种格式。时间码写法不代表识别对齐精度：词级、分段或无原生时间戳取决于引擎，页面会显示能力提示。没有原生字幕片段时，App 可从文本生成片段；使用前请检查时间与内容。

本机 MOSS-0.9B 支持说话人分离与起止时间结果。App 内转写为支持说话人分离的引擎保留整段处理，以减少跨分段的说话人身份断裂；实际识别与标记质量取决于录音和模型。

完成任务还可进行字幕 AI 优化和恢复原字幕。优化可能使用已配置的文本处理/意图模型或就绪的本机模型；使用云端模型会发送字幕文本。未能使用模型时，部分分句会回退到本地规则。优化结果仍需校对。

命令行转写

App 另含社区模式命令行转写工具，可在未激活 GUI 文件转写时运行。它与 App 内的试用 / Pro 功能门槛不同。

先在 App 中安装并准备所需本机模型。CLI 不会自动下载缺失模型。以下命令使用已安装 App 的可执行文件路径：

/Applications/VoiceHotkey.app/Contents/MacOS/VoiceHotkey --transcribe ~/Downloads/interview.mp3 --provider qwen
/Applications/VoiceHotkey.app/Contents/MacOS/VoiceHotkey --transcribe ~/Downloads/meeting.m4a --provider moss

语法为 VoiceHotkey --transcribe <文件路径> [--provider <名称>] [--language <代码>]。App 安装在其它位置时相应修改路径。--language 对支持语言约束的引擎生效，不保证所有引擎采用此参数。

当前 App 支持下载并使用 Fun-ASR-Nano 与 SenseVoice Small。详见输入模型。下表别名属于独立的社区 CLI。

模型	接受的 provider 名称
Qwen3 0.6B（默认）	qwen、qwen3、qwen3-asr、qwen0.6b、qwen3-0.6b
Qwen3 1.7B	qwen1.7b、qwen3-1.7b、qwen-1.7b
SenseVoice	sensevoice、sensevoice-small
Fun-ASR-Nano	funasr、funasr-nano、funasrnano
Whisper Turbo	whisper、whisper-turbo、whisper-large-v3-turbo
Whisper Small	whisper-small
Distil Whisper	whisper-distil、distil-whisper
Parakeet	parakeet、parakeet-tdt
FireRed	firered、fireredasr
Apple SpeechAnalyzer（macOS 26+）	apple、applespeech、apple-speech、apple-analyzer、analyzer
旧版 Apple Speech	apple-legacy、legacy
MOSS	moss、moss-0.9b、moss0.9b

未知名称会回退到 Qwen3 0.6B；此参数不是通用云端提供商选择器。CLI 在源文件旁写入同名 .srt 和 .vtt，会覆盖已有同名文件，并保存任务供 App 显示。

仅本地模式

仅本地模式下可使用已准备的 Apple 或内置本机模型；旧版 Apple 被强制为本机识别。公网文件识别请求会被拦截，回环自建端点仍需满足引擎权限。模型安装与系统语言资源准备可能需要先联网。