Vlow 完整使用手册
更新于 2026 年 6 月 · 适用 macOS 13+ / Windows 10·11 · 本页随版本更新
一句话上手：装好并激活后，设一个触发键（默认 F2），把光标放进任何输入框，按一下开始说话、再按一下结束——Vlow 在你的电脑本机把语音变成干净文字，按你选的模式整理好，自动落到光标处。它既是语音输入助手，也是语音速记/事件记录助手（说完即记 → 自动生成周报）。本页把每一步、每个功能、每个参数都讲清。
① 它是什么
② 安装 & 系统要求
③ 授权与激活
④ 首次设置（权限）
⑤ 30 秒快速上手
⑥ 触发键
⑦ 输出模式
⑧ 语音速记/周报
⑨ 润色后端
⑩ 热词 & 提示词
⑪ 菜单栏 & 面板
⑫ 设置项总表
⑬ 隐私
⑭ 排错
⑮ 卸载 & 数据
① 它是什么、能干嘛
Vlow 是一款 macOS 上的语音输入 + 事件记录 应用，两大身份：
- 语音输入助手：在任何 App 里按住触发键说话，口语即刻变成干净、结构化的文字，落到光标处。不只是「转写」——它能整理成 AI 指令、Git 提交、任务清单、文档等多种形态（见 §⑦）。
- 语音速记 / 事件记录助手：说一句「帮我记一下……」就存成一条带时间的事件，到周末/月底自动汇总成周报、月报，可导出 Word（见 §⑧）。
30 秒图景：按一下触发键 → 说话 → 再按一下结束 → 干净文字自动出现在你正在打字的地方。语音识别永远在本机离线完成，录音不上传。
② 安装 & 系统要求
系统要求
- macOS：macOS 13（Ventura）或更高；Apple 芯片（M 系列）与 Intel 均支持。
- Windows：Windows 10 / 11（64 位）；需 WebView2 运行时（Win11 与较新 Win10 通常已内置，缺则按系统提示安装）。
- 两端首次启动都需联网一次下载识别模型（约 1GB），之后永久离线。
安装步骤（macOS）
- 下载
.dmg：从官网下载安装包。 - 拖入「应用程序」：双击打开
.dmg，把 Vlow 图标拖到 Applications 文件夹。 - 首次打开：到「应用程序」双击 Vlow。安装包已签名并公证，正常情况下直接打开即可；若系统弹出「来自互联网/未验证开发者」提示，到 系统设置 → 隐私与安全性，找到 Vlow 点 「仍要打开」。
- 首启下载模型：第一次运行会自动下载约 1GB 的本地识别模型，请保持联网、耐心等待进度走完。下载完成后即可永久离线使用。
Vlow 走 官网直接分发，不上 Mac App Store（App Store 的沙盒不允许「自动把文字写到其它 App」这类能力）。所以从官网下载、按上面步骤放行是正常流程。
安装步骤（Windows）
- 下载安装包：从官网下载
Vlow-Setup.exe。 - 运行安装：双击
Vlow-Setup.exe，按向导完成安装。 - 若被 SmartScreen 拦：当前 Windows 安装包暂未做代码签名，系统可能弹「Windows 已保护你的电脑 / SmartScreen」——点 「更多信息」→「仍要运行」 即可。
- 首启下载模型：同样首次联网下载约 1GB 模型（缓存到
%USERPROFILE%\.cache\vlow-asr），之后永久离线。
③ 授权与激活
Vlow 是一次买断 + 授权码，没有订阅。
- 免费试用 7 天：首次启动即进入试用，功能完整，无需先付费。
- 购买拿授权码：在官网购买后会收到一串授权码。
- 粘码激活：打开 Vlow 的激活入口，把授权码粘进去 → 激活。离线验证、绑定本机，不需要一直联网。
Mac 与 Windows 共用同一套授权码体系（同一份授权码按许可设备数在两端通用）。
状态怎么看
| 状态 | 含义 |
|---|---|
trial 试用中 | 7 天试用期内，功能完整。 |
licensed 已激活 | 授权码已验证，永久使用。 |
expired 已过期 | 试用到期且未激活，需输入授权码。 |
unconfigured 未配置 | 尚未开始（极少见）。 |
授权采用 Ed25519 离线签名 + fail-open 设计：宁可放过也绝不误锁——正版用户不会因为网络问题被锁住。
④ 首次设置：权限（关键）
Vlow 要「听你说」并「把字写进别的 App」，需要授权。不给权限，按触发键会没反应或文字不上屏。下面先讲 macOS（两个权限），Windows 只需麦克风（见本节末）。
- 麦克风：首次说话时系统会弹窗请求「麦克风」，点允许。（事后可在 系统设置 → 隐私与安全性 → 麦克风 里确认 Vlow 已勾选。）录音只在本机用于识别，不上传。
- 辅助功能（Accessibility）：到 系统设置 → 隐私与安全性 → 辅助功能，把 Vlow 勾上。它用于全局触发键和把识别结果写到当前光标处。
- 授予辅助功能后重启 Vlow：macOS 通常要求重启应用后该权限才生效。
如果按触发键完全没反应、或能录音但文字不出现，90% 是这两个权限没给全。先回到这一节检查。
Windows：只需在 「设置 → 隐私和安全性 → 麦克风」 允许麦克风即可；Windows 不需要 macOS 那样单独的「辅助功能」授权（全局触发键与自动上字在 Windows 上无需特殊授权）。
⑤ 30 秒快速上手
- 设触发键：默认
F2，可改（见 §⑥）。 - 把光标放进任意输入框：备忘录、浏览器、聊天框、代码编辑器都行。
- 按一下触发键 → 说话：屏幕上会出现录音指示（悬浮胶囊/菜单栏状态）。
- 再按一下触发键 → 结束：Vlow 本机识别 → 按当前模式整理 → 文字自动落到光标处。
想要最干净的「原文直出」、零延迟？把润色后端设成「免润色」（见 §⑨）。想要 AI 整理成 Prompt/任务等结构？选对应模式（§⑦）。
⑥ 触发键（hotkey）
触发键就是「按一下开始说话、再按一下结束」的那个键。默认 f2。可选值：
| 类别 | 可选值 |
|---|---|
| 功能键（推荐） | f2（默认）· f3 · f4 · f8 · f9 |
| 修饰键 / 锁定键 | right ctrl · left ctrl · right shift · right alt · caps lock · scroll lock |
为什么推荐功能键（F2 等）：不分左右、好按、不容易和复制粘贴（Cmd/Ctrl+C/V）等常用快捷键冲突。若你常用 F 键调亮度/音量，可选一个不常用的，或改用
caps lock。⑦ 输出模式（mode）
同一段话，Vlow 能整理成不同形态。默认 清理口语，可在菜单栏随时切换（也可让它按前台 App 自动切）。
| 模式（设置值） | 做什么 | 适合 |
|---|---|---|
清理口语 clean（默认） | 去掉「呃/那个」、补标点、顺成通顺书面语 | 聊天、邮件、备忘、通用输入 |
AI 指令 prompt | 把口语整理成结构清晰的 Prompt / 需求 | 对 Cursor、Claude 等说话 |
Git 提交 commit | 整理成规范 commit message | 终端 / 编辑器里提交代码 |
任务清单 task | 整理成 - [ ] 复选清单 | 待办、会议行动项 |
技术文档 doc | 整理成带小标题的文档片段 | 写说明、纪要 |
自定义 custom | 用你自己的提示词整理（见 §⑩） | 有特定格式需求 |
同一句话，五种写法（示例对照）
你说：「那个登录页你帮我加个加载中的状态，然后密码错了的提示也写清楚点」
| 模式 | 输出 |
|---|---|
| 清理口语 | 帮我给登录页加一个「加载中」状态，并把密码错误时的提示写得更清楚。 |
| AI 指令 | 在登录页实现以下两点：1. 提交时显示「加载中」状态指示；2. 优化密码错误的提示文案，明确告知错误原因。 |
| Git 提交 | feat(login): 增加加载状态并优化密码错误提示 |
| 任务清单 | - [ ] 登录页增加「加载中」状态- [ ] 优化密码错误的提示文案 |
| 技术文档 | ## 登录页优化 —— 加载状态：提交时显示 loading；错误提示：密码错误时给出清晰、可操作的文案。 |
结构化整理（除「免润色」外）由润色后端完成（§⑨）。若选了「免润色」，则各模式都只做最基本的上屏，不做 AI 改写。
⑧ 语音速记 / 事件记录 → 周报
Vlow 的第二大身份：说完即记，到点自动成稿。
- 随口记：说一句「帮我记一下：明天上午跟某某开产品评审」，它存成一条带时间的事件，不打断你手头的事。
- 自动汇总：到周末/月底，把这段时间的记录自动整理成周报 / 月报。
- 导出 Word：把汇总报告导出为
.docx，直接发出去。
适合：会议待办、灵感、跟进事项。说出来就记下，到点自动成稿——不用打开任何记事本手敲。
⑨ 润色后端（联网与否在这里决定）
「润色后端」决定是否联网，以及用什么把识别结果整理得更好。四选一：免润色 / 本地 Ollama / DeepSeek / Claude。
| 后端 | 联网 / Key | 说明 |
|---|---|---|
| 免润色（原文直出） | 不联网 · 免 Key | 识别结果直接上屏，零延迟，识别已自带标点。 |
本地 Ollama local | 不联网 · 免 Key | 本机 127.0.0.1:11434，默认模型 qwen2.5:3b。断网也能 AI 整理。 |
DeepSeek deepseek | 需联网 · 自带 Key | 云端，deepseek-chat，中文质量好、国内支付方便。 |
Claude anthropic | 需联网 · 自带 Key | 云端，默认 claude-opus-4-8，质量顶级。 |
BYO-Key（自带密钥）：云端两档绝不内置开发者 Key，文本只走你自己的账号；Key 只存本机。改后端后需重启 Vlow 生效。
这部分的完整操作——怎么装 Ollama、怎么拉模型、怎么按机型选模型、怎么注册并获取 DeepSeek / Claude 的 API Key、怎么把 Key 填进 Vlow——已在专页讲透：👉 离线部署与模型配置说明。
⑩ 热词 & 自定义提示词
热词（hotwords）
提升专有名词、人名、术语的识别准确率。在设置里填一段逗号分隔的词：
佛山站, 黄主任, 中控室, Vlow, FireRedASR把容易被识别错的人名/产品名/行话加进去，识别时会更准。随时增删。
自定义润色提示词（prompt）
- 这段提示词仅对「清理口语」(
clean) 模式生效；其它结构化模式（prompt/commit/task/doc）用各自的内置模板。 - 想要清理口语时按你的口味来（比如「保留口语化语气」「一律改成书面正式」），就改这里；留空则用默认。
- 高级：
prompt_overrides可按模式分别覆盖提示词（字典形式）。
⑪ 菜单栏 & 悬浮面板
Vlow 常驻菜单栏（Windows 为系统托盘），并在录音时显示一个悬浮胶囊。
- 菜单栏图标：查看状态、切换输出模式、打开设置、查看授权状态等。
- 悬浮胶囊：录音时出现，波形随你的音量起伏，并显示当前模式；识别完成后消失。
- 遇到问题时，菜单栏/胶囊会给出提示（如「本地 Ollama 未运行……已用原文」）。
菜单栏菜单的具体项、悬浮胶囊的确切交互、Mac 端「设置」面板的布局与入口，以你实际安装的 App 为准（本节为功能性说明，UI 细节随版本可能微调）。
⑫ 设置项总表（参考）
设置写在数据目录的 vlow_settings.json（见 §⑮）。日常在设置界面里改即可，下表供查阅。
| 参数 | 取值 | 含义 |
|---|---|---|
hotkey | f2（默认）/ f3 / f4 / f8 / f9 / right ctrl / left ctrl / right shift / right alt / caps lock / scroll lock | 触发键，见 §⑥。 |
backend | 免润色 / local / deepseek / anthropic | 润色后端，见 §⑨。 |
mode | clean（默认）/ prompt / commit / task / doc / custom | 输出模式，见 §⑦。 |
hotwords | 逗号分隔字符串 | 热词，见 §⑩。 |
prompt | 一段文字 | 自定义润色提示词，仅对 clean 生效。 |
prompt_overrides | 字典 | 按模式覆盖提示词（高级）。 |
环境变量（高级，启动前设置）
| 变量 | 默认 | 作用 |
|---|---|---|
VLOW_ASR_ACCURACY | 视构建 | 识别精度：CTC（更快）/ AED（更准）。 |
OLLAMA_MODEL | qwen2.5:3b | 本地 Ollama 模型名。 |
DEEPSEEK_MODEL / ANTHROPIC_MODEL | deepseek-chat / claude-opus-4-8 | 云端模型名。 |
DEEPSEEK_API_KEY / ANTHROPIC_API_KEY | 无 | 云端 Key，优先级高于 secret.json。 |
VLOW_DATA_DIR | 见 §⑮ | 覆盖数据目录位置。 |
VLOW_NO_TELEMETRY | — | 设置后关闭匿名统计上报。 |
大多数人无需碰环境变量；默认值已经是好选择。它们主要给进阶用户/特殊机型微调用。
⑬ 隐私
- 录音永远在本机：语音识别（说话→文字）100% 在你的电脑离线完成，录音永不上传，断网也能识别。
- 只有云端润色才发「文本」：仅当你把润色后端选成 DeepSeek/Claude 时，才会把识别后的文本（不是录音）发到你自己的 API 账号；选「免润色」或「本地 Ollama」则全程不出本机。
- Key 只存本机：API Key 写在本机
secret.json，不外发。 - 想要 100% 全离线的完整配置，见 👉 离线部署说明。
⑭ 常见问题 / 排错
按了触发键完全没反应？
① 检查辅助功能权限（系统设置 → 隐私与安全性 → 辅助功能，勾上 Vlow），授予后重启 Vlow；② 确认触发键没被别的软件占用（换一个，如 F3 或 caps lock）；③ 确认 Vlow 正在运行（菜单栏有图标）。
能录音，但文字不出现在光标处？
多半是辅助功能权限没给——Vlow 靠它把文字写到当前 App。给权限并重启 Vlow；并确认你点的输入框真的有光标焦点。
提示没有麦克风权限 / 录不到音？
到系统设置 → 隐私与安全性 → 麦克风，勾上 Vlow；若之前误点了「不允许」，在这里手动打开。
首次启动模型一直下不好 / 卡住？
首启需联网下载约 1GB 模型。保持联网、留足磁盘空间；网络不稳可重试。下载完成后即永久离线。
激活失败 / 提示授权码无效？
确认授权码完整无空格、未用于超出许可的设备数；换机可解绑后重新激活。授权为 fail-open 设计，正版不会被网络问题误锁。
云端润色报错 / 提示未设置 API Key？
对应 Key 没填好：按 离线部署说明 §④ 填入 secret.json 或环境变量，确认 Key 完整（DeepSeek 以 sk-、Claude 以 sk-ant- 开头），并重启 Vlow。
本地 Ollama 提示「未运行 / 模型未拉取」？
打开 Ollama 应用（或终端 ollama serve）；缺模型则 ollama pull qwen2.5:3b。详见 离线部署说明。
改了设置不生效？
Vlow 的设置改动需重启应用后生效——退出再重新打开。
识别不太准 / 老把某个词听错？
把该词加进热词（§⑩）；也可把识别精度环境变量设为 VLOW_ASR_ACCURACY=AED（更准、略慢）。
⑮ 卸载 & 数据位置
- 数据目录（macOS 安装版）：
~/Library/Application Support/Vlow/，含secret.json（API Key）、vlow_settings.json（设置），以及缓存的识别模型。可用环境变量VLOW_DATA_DIR覆盖。 - 数据目录（Windows）：识别模型缓存在
%USERPROFILE%\.cache\vlow-asr；设置与密钥文件在你的用户目录下。 - 卸载（macOS）：退出 Vlow → 把「应用程序」里的 Vlow 拖到废纸篓。
- 卸载（Windows）：在「设置 → 应用 → 已安装的应用」里卸载 Vlow（或用安装目录的卸载程序）。
- 想彻底清理可再删数据目录；想保留设置/授权则先备份。