Onvilo
简体中文
免费试用
Onvilo 帮助

从首次启动到排查问题。

了解初始设置、两种录音方式、选中文本翻译、模型准备和本地数据管理。

Onvilo 本身不会将录音、转写结果、整理后的文字、待翻译原文、译文或登记的术语发送到运营者的服务器。

初始设置与权限

按照首次启动向导，完成录音和文字插入所需的准备。看不到 Onvilo 窗口时，可从菜单栏的 Onvilo 图标打开“设置”。Onvilo 不会显示在 Dock 或 Command-Tab 中。帮助也可从同一菜单打开。

  1. 启动 Onvilo

    从“应用程序”文件夹启动。首次启动时会显示初始设置窗口。

  2. 允许使用麦克风

    在 macOS 提示中允许访问。没有此权限便无法录制语音。

  3. 允许使用辅助功能

    从设置向导打开“系统设置”，然后在“隐私与安全性”>“辅助功能”中启用 Onvilo。

  4. 准备语音识别模型

    下载当前语音输入语言的模型。安装完成前无法开始语音输入。

  5. 检查文字整理状态

    确认 Apple Intelligence 的状态，然后在最后的测试输入框中试用语音输入。即使无法使用 AI 整理，语音输入仍可工作。

  6. 自动开始免费额度或激活许可证

    首次启动时，Onvilo 会自动开始无需银行卡的 20 分钟累计免费额度，可使用全部功能，且不会自动转为付费方案。如果首次自动开始失败，请在“通用”设置中选择“免费试用 20 分钟”重试。免费额度用完后，录音面板和“通用”设置会显示打开购买页面的链接，该链接会打开与显示语言对应的专用购买页面。产品介绍页面不会链接到该购买页面，因此请从应用内的这个链接开始购买。已购买或收到运营者提供的许可证密钥时，请输入密钥进行激活。试用和许可证凭据以及免费额度使用量会存储在此 Mac 的钥匙串中；音频和转写文本不会发送到认证 API。

各项权限的用途

麦克风
在录音时采集你的语音。
辅助功能
检查输入框，并直接插入转写结果或译文。
输入监控
当应用不支持直接插入时，发送 Command + V。

完成初始设置不需要“输入监控”权限。只有应用需要 Command + V 备用粘贴方式时，才从错误提示打开“系统设置”并授权。

可购买 Onvilo 的国家与地区

Onvilo 仅在已完成法律与税务对应的国家和地区销售。增加界面语言并不等于增加可销售的国家。

哪些人可以购买

购买仅面向以本人名义并由本人承担责任签订合同的自然人。本人可以在自己的工作场所、个体经营、商业或专业活动中使用 Onvilo。以公司、组织或团队名义购买、代他人或其他实体购买、共享许可证、转售或再分发均不提供。

目前可购买的国家与地区

您可以从以下国家和地区购买。请在 Stripe Checkout 中填写包括国家或地区在内的账单地址。最终销售判定会在付款后进行。

  • 澳大利亚
  • 菲律宾
  • 韩国
  • 马来西亚
  • 美国
  • 日本
  • 泰国
  • 新加坡
  • 新西兰
  • 印度尼西亚
  • 中国香港特别行政区

正在确认的国家与地区

以下国家和地区仍在进行消费者保护、个人信息保护与税务确认。Stripe Checkout 可能仍会接受付款，但我们会暂缓发放许可证并通过电子邮件通知您。我们无法承诺开放销售的时间。

  • 文莱

整个国家或地区均不在销售范围内

以下国家或地区在 v1.0 中是全域不适用，并非只排除其中的某个省、州或地区。如果付款已被接受，我们不会自动发放许可证，而会通过电子邮件通知您确认情况。我们无法承诺何时恢复销售。

  • 加拿大（全域不提供购买）
  • 台湾（全域不提供购买）

国家内部分地区不在范围内时

部分国家或地区可能会排除特定的省、州或地区。如果您在 Stripe Checkout 中填写的账单地区属于排除范围，我们不会自动发放许可证，而会通过电子邮件通知您确认情况。

  • 美国: American Samoa, California, Guam, New Jersey, Northern Mariana Islands, Puerto Rico, U.S. Virgin Islands, United States Minor Outlying Islands

Stripe 账单国家或地区需要确认时

LP 不提供国家或地区或付款路径选择框，所有购买都会通过 Stripe Managed Payments 开始。我们以 Stripe Checkout 中填写的完整账单地址作为最终判定依据。如果账单国家或地区不在销售范围内或仍在审核中，我们会暂缓发放许可证并通过电子邮件通知您，确认后发放许可证或退款。

无法购买时

如果您所在的国家或地区暂时无法购买 Onvilo，请联系支持，我们会说明当前情况。但我们无法承诺开放销售的时间。 support@onvilo.app

语音输入

首次启动时自动开始的累计 20 分钟免费额度或已购买许可证均可使用语音输入。免费额度用完后，录音面板和“通用”设置会显示购买页面链接。默认快捷键为 Option + Space。短按与按住约一秒以上会启动不同的录音模式。菜单栏 Onvilo 图标的菜单也可以打开设置和帮助。

短按进行免按键录音

短按后开始录音，松开按键仍会继续。无需一直按住按键，因此适合说较长的内容。说完后再次按下快捷键或按 Enter 或 Esc 确认。

按住进行按键说话

按住快捷键约一秒以上时，只在按住期间录音。说完后松开按键即可停止。按住期间也可以按 Enter 或 Esc 确认。

确认录音

录音过程中再次按下语音输入快捷键或按 Enter 或 Esc，会确认到该时刻为止的音频，并进入转写和整理。没有中途取消录音的操作。转写或整理开始之后，Esc 在 Onvilo 中不执行任何操作，会传递给最前面的应用。翻译窗口打开期间的语音输入，说出的内容会进入翻译窗口的原文栏，录音期间使用三种确认操作中的任一种都不会关闭窗口。

录音面板显示的内容

面板会实时显示转写文字、麦克风输入音量和经过时间。文字在最终确认前可能会发生变化。确认录音后，Onvilo 会优先保证准确度，对保存的完整音频重新转写。普通语音输入会整理并输入该结果；翻译窗口会将结果放入原文栏。如果最终转写失败、超时或结果为空，则使用录音期间已经确认的结果。包含 @ 文件路径的录音会使用录音期间的确认结果，以保留路径和语音的分段。

结果输入到哪里

Onvilo 会记住开始录音时位于前台的应用。处理完成后会返回该应用，并尝试将结果插入其输入框。前台应用还决定使用哪个配置和哪个按应用区分的术语列表。

录音时用 @ 插入文件路径（面向编程）

在设置的「编程」中注册 Git 仓库后，录音时按 @ 键即可打开文件搜索面板。面板打开期间，录音的音频输入会暂停（麦克风使用中指示灯保持点亮）。面板打开时首先显示更改的文件（staged / unstaged），输入即可筛选，用 ↑↓ 选择、Tab 预览、Enter 插入路径并立即恢复录音。按 Esc 则不插入并返回录音。插入的路径格式（默认：@相对路径）可在设置的「编程」中更改。文件路径与内容不会被发送到任何外部服务。

单次录音的时长上限

单次录音最长 10 分钟。达到上限后，Onvilo 会自动停止录音，并转写到此为止的内容。以这种方式结束时，录音面板会给出提示，你可以重新开始录音以继续。

Apple Speech 语音识别模型

Onvilo 使用设备端 Apple Speech。每种语音输入语言在首次使用前都需要准备对应模型。录音时会快速进行临时转写，停止后再优先保证准确度，对完整音频重新转写。

  1. 打开设置

    从菜单栏的 Onvilo 图标菜单打开“Settings”，然后选择“Engine”。

  2. 确认语言

    在“General”>“Speech Recognition Language”中选择你要说的语言。此设置与界面语言相互独立。

  3. 下载模型

    如果“Engine”显示语音模型尚未安装，请选择“Download”并等待完成。

离线时找不到模型

未安装的模型无法在离线状态下准备。请连接互联网，下载当前语言的模型后重试。模型安装完成后，使用该模型的转写可离线运行。

使用 Apple Intelligence 整理文字

转写后，Apple Foundation Models 会在 Mac 上保守地修正明显的识别错误和书写格式，不会总结或大幅改写你说的内容。不过，向翻译窗口的原文栏语音输入时不会经过整理，会直接放入转写结果，因为译文随后由窗口生成。录音时用 @ 插入的文件路径不在整理范围内，会原样输出。发音相近的片假名或拉丁字母词只在日语和英语听写中进行术语纠正，URL 会受到保护。日语听写会整理日文相邻处以及日文句号后的不必要空格，同时保留英文短语内部的空格和段落换行。

可以使用时

如果 Apple Intelligence 模型支持当前语言且已准备好，Onvilo 会先整理转写结果再输出。整理时会将登记的术语用作拼写提示。

无法使用时

如果 Mac 不支持、Apple Intelligence 已关闭、模型仍在准备或当前语言不受支持，Onvilo 会跳过 AI 纠正。转写结果不会丢失，仍会经过基本的标点与段落整理后粘贴或复制。

自动粘贴与剪贴板

在可能的情况下，Onvilo 会不经过剪贴板，将转写结果直接插入输入框。对于不支持直接插入的应用，会临时使用剪贴板粘贴，并自动恢复你原先复制的内容。使用文件提及的录音也会保持录音开始时的输入框作为粘贴目标。

使用 Auto-Paste

在“General”设置中启用“Auto-Paste”，处理完成后会返回开始录音时的应用，并将结果插入输入框。

只复制而不粘贴

关闭“Auto-Paste”后，Onvilo 不会向其他应用发送操作，只会复制结果。请在需要的位置按 Command + V。

在拒绝直接插入的应用中使用

终端等不接受直接插入的应用会改用 Command + V。粘贴完成后会自动恢复剪贴板原有的内容。此方式可能需要“输入监控”权限。

从翻译窗口插入

在翻译窗口中确认的译文，无论“Auto-Paste”是否开启，都会通过直接插入或 Command + V 插入到原来的应用中。若只想取得文字而不插入，请按窗口中的“拷贝”。

插入失败时，生成的文字会保留在剪贴板中。关闭错误提示，检查“辅助功能”和“输入监控”权限，然后手动按 Command + V。

文本翻译

累计 20 分钟免费额度或已购买许可证均可使用翻译。选中文字后按 Control + Option + T，会就地替换为译文；未选中文字时按同样的快捷键，则会打开翻译窗口，可以边输入边确认译文再插入。两种方式都由 Apple Translation 在 Mac 上处理，文字不会离开设备。

  1. 就地替换选中的文字

    选择想翻译的范围后按 Control + Option + T，不会打开窗口，只有所选范围会变成译文。快捷键可在“General”设置中更改。

  2. 不选中文字以打开翻译窗口

    未选中文字时按 Control + Option + T，屏幕中央偏上会打开翻译窗口。也可以在菜单栏中选择“打开翻译窗口”。只有语音输入的处理仍在进行时无法新打开窗口，并会提示“语音输入的处理正在进行，请完成后再打开”。

  3. 边输入边确认译文

    在上方输入原文后，下方的译文会随输入自动更新。翻译方向会根据输入内容自动判断，也可以随时用标题栏的互换按钮切换。

  4. 确认并插入译文

    确认后窗口会关闭，并将译文自动粘贴到原来的应用中。译文同时保留在剪贴板上。

翻译窗口的操作与翻译后的行为

确认键
默认为“Enter 插入（Shift+Enter 换行）”。若经常需要换行，可在“General”设置的“翻译窗口的确认键”中改为“⌘Enter 插入（Enter 换行）”。
拷贝与关闭方式
按“拷贝”只会把译文拷贝到剪贴板，不会粘贴。关闭窗口的方式有三种：Esc、确认（插入）以及窗口左上角的关闭按钮。点按其他应用或窗口不会关闭它，切换到其他桌面（空间）时也会跟随，因此可以一边查看资料一边翻译。用 Esc 关闭时，已输入的原文会在下次打开翻译窗口时恢复。
用语音输入原文
翻译窗口打开期间使用语音输入（默认 Option + Space），说出的内容会进入翻译窗口的原文栏，而不是最前面的应用。多次说话时会追加而不是替换，因此可以与手动输入混用。此路径不经过 Apple Intelligence 的文本整理，会将转写结果直接放入原文栏，因为译文随后由窗口生成。录音期间窗口上方会显示“录音中”，此时再次按下快捷键或按 Enter 或 Esc 会确认录音，不会关闭窗口。录音结束后再按一次 Esc 即可关闭。通过此路径录音时无法使用 @ 文件搜索。
输入框
有选择范围时优先翻译该范围并就地替换；未选择文字且 Onvilo 能确认输入框可编辑并含有文字时，会载入全文打开翻译窗口，确认后输入框全文会被替换为译文。
剪贴板
成功后只保存译文，不会同时保留原文。
无法替换时
录音面板区域会显示原因。若翻译前剪贴板中有文字，Onvilo 会恢复该文字；图片、文件等非文字内容不会恢复。

准备翻译模型

在“General”设置中选择源语言和目标语言。设置中只显示此 Mac 可用的语言。如果语言对尚未安装，请通过 macOS 提示下载一次。在翻译窗口中，若模型尚未下载，窗口内会显示下载按钮，可直接在此完成准备。若目标文字是另一种已设置的语言，Onvilo 会自动反转翻译方向。

候选语言

  • 日语
  • 英语
  • 简体中文
  • 繁体中文
  • 韩语
  • 西班牙语

配置、术语与纠正学习

Onvilo 将这些整理提示保存在 Mac 上，不会与音频或文字一起发送给运营者。通用术语列表和应用专用列表分开管理，开始录音时会优先使用匹配应用的列表。开始录音时选定的术语列表也会传递给最终转写后的文字整理。

内置配置

Onvilo 内置 General、Engineer 和 Business 三种配置，并根据开始录音时的前台应用自动选择。目前没有创建、编辑或手动选择配置的界面。

术语

在“Vocabulary”设置中登记正确拼写。即使“Common Mishearing”留空，Onvilo 也会自动将发音相近的词替换为正确拼写，并将该条目用作识别和整理提示。填写后，则一定会替换该误听内容。基于发音的自动替换适用于日语和英语语音输入，且仅作用于被识别为片假名或拉丁字母的词。较短的术语以及 SQL 这类拼写与发音不一致的词不会被自动替换。

按应用区分的术语

在“Vocabulary”设置的“Apply to”中添加应用，即可为该应用创建专用术语列表。开始录音时，Onvilo 会将与前台应用匹配的列表和通用术语一起使用；术语较多时优先采用该应用的专用术语。删除某个应用的列表只会删除该应用专用的术语和替换规则，通用术语会保留。

纠正学习

要使用纠正学习，请先启用历史记录。在历史详情中保存正确的最终文字后，Onvilo 会将其作为相同配置、应用和语音语言下后续整理的示例。某个符合条件的术语纠正出现至少三次时，也可能建议加入“Vocabulary”；在选择“Add to List”前不会作为固定替换规则。

编程设置

文件提及所使用的仓库和路径格式在“编程”设置中管理。该设置与配置和术语列表相互独立。

术语同步与建议

在“Vocabulary”设置中，可以将通用和按应用区分的术语以及明确批准的纠正规则导出为 JSON 文件，再在另一台 Mac 上导入。文件不包含历史记录或音频。建议会结合 Prompt 和所选应用；开启“使用历史记录”后，才会加入相同目标和语言下明确纠正的历史记录。最多可生成 10 条建议，并会省略已经登记的术语提示；即使规范词已登记，尚未登记的替换规则仍可作为候选。请确认候选项后再保存。

历史记录与输入上下文

历史记录和输入上下文默认均为关闭。只在“Privacy”设置中启用你需要的功能。

保存历史记录

启用“Save History”后，转写和整理后的文字会保存在此 Mac 的 SQLite 文件中，音频文件不会保存到历史记录。向翻译窗口原文栏语音输入的内容也会同样保存；该路径不经过整理，因此转写与整理结果内容相同。录音时用 @ 插入的文件路径也会作为正文的一部分保存到同一历史记录中。历史记录建议只使用你明确纠正或批准的记录。

选择保留期限

可以选择 7 天、30 天、90 天或永久保留。超过期限的记录会在 Onvilo 下次启动时删除。

删除历史记录与纠正学习

在“Privacy”设置中选择“Delete History and Correction Learning Data”。这会删除保存的历史和学习数据，但不会关闭“Save History”，也不会删除你登记的术语（通用和按应用区分的均会保留）。

使用光标前的文字作为上下文

启用“Use Input Context for Cleanup”后，Onvilo 会读取光标前最多 300 个字符，用作本次整理的提示。这些文字只在 Mac 上处理，不会保存到历史记录，也不会发送给运营者的服务器。

复制和部分粘贴操作使用 macOS 通用剪贴板。为粘贴而进行的临时写入会带有标准的临时数据标记，完成后会恢复原有内容。根据设置，剪贴板历史、Universal Clipboard 或剪贴板管理器仍可能另行保存或同步文字。

常见问题与恢复步骤

请先检查与当前错误最接近的设置。切换到其他应用后，可从菜单栏的 Onvilo 图标返回 Onvilo 窗口。Onvilo 不会显示在 Dock 或 Command-Tab 中。如果停止后的重新转写失败，Onvilo 会自动使用录音期间确认的结果。如果术语替换出乎意料，请检查应用专用列表和其中的“常见误听”。

没有显示建议

开启“使用历史记录”时，需要开启保存历史记录，并且存在相同目标和语言下明确纠正的历史记录。关闭后仅使用 Prompt 和所选应用。建议最多显示 10 条，并会省略已经登记的术语提示。

  1. 在“Privacy”设置中开启“Save History”。
  2. 在历史详情中保存正确的最终文字，或明确批准整理结果。
  3. Apple Intelligence 不可用时不会显示 AI 建议。
说了很久，但只输入了一部分

当录音达到 10 分钟上限时，Onvilo 会自动停止录音，并转写到此为止的内容。

  1. 确认录音面板是否显示了“已达到录音上限（10 分钟）”。
  2. 超过 10 分钟的内容，请按话题分成多次录音。
按下快捷键没有反应

Onvilo 可能未运行，或者其他应用已经占用了相同快捷键。

  1. 从“应用程序”文件夹启动 Onvilo。若已经运行，请退出后重新启动。
  2. 检查 Onvilo 是否显示了无法注册快捷键的提示。
  3. 在“General”设置中换用不与 Alfred、Raycast、Spotlight、ATOK 或其他应用冲突的快捷键。
无法开始录音，或检测不到语音

请检查麦克风权限、所选输入设备和说话时长。

  1. 在“系统设置”中允许 Onvilo 使用麦克风。
  2. 在“General”设置中重新选择正确的输入设备。
  3. 使用按住录音时，请清楚说话至少 0.5 秒后再松开按键。
  4. 使用免按键录音时，说完后再次按下快捷键或按 Enter 或 Esc 确认。
如何确认免按键录音

再次按下语音输入快捷键或按 Enter 或 Esc。Onvilo 会确认到该时刻为止的音频，并进入转写和整理。

  1. 再次按下快捷键或按 Enter 或 Esc。
  2. 录音面板上也会显示用于确认的按键。
  3. 若只想在按住期间录音，请按住快捷键约一秒以上后再松开。
录音时按 @ 没有打开文件搜索面板

可能尚未注册仓库，或未能捕获 @ 键。

  1. 在设置的「编程」中注册至少一个 Git 仓库。
  2. 向翻译窗口进行语音输入时无法使用文件搜索。
  3. 确认已安装 Xcode Command Line Tools（git）。
提示尚未安装语音识别模型

当前语音输入语言尚未安装对应的 Apple Speech 模型。

  1. 连接互联网。
  2. 在“Engine”设置中下载该语言的模型。
  3. 状态变为已安装后再开始录音。
登记的术语没有被替换

基于发音的自动替换有适用条件。若要确保替换某个说法，请填写“Common Mishearing”。

  1. 基于发音的自动替换适用于日语和英语语音输入，且仅作用于被识别为片假名或拉丁字母的词。
  2. 较短的术语以及 SQL 这类拼写与发音不一致的词不在替换范围内。将实际的误听内容填入“Common Mishearing”即可确保替换。
  3. 按应用区分的列表中的术语，只在该应用中开始录音时使用。各处通用的术语请登记到通用（所有应用）列表。
文字没有插入输入框

输入框可能拒绝直接插入，同时也不允许发送 Command + V。显示错误时，生成的文字会保留在剪贴板中。

  1. 在“系统设置”中允许“辅助功能”和“输入监控”。
  2. 选择目标输入框，然后手动按 Command + V。
  3. 若该应用持续拒绝插入，请关闭“Auto-Paste”，改用只复制模式。
转写结果没有经过 AI 整理

Apple Intelligence 关闭、仍在准备，或设备／当前语言不受支持时，会跳过 AI 纠正。转写结果仍会经过基本标点与段落整理后输出。

  1. 在“Engine”设置中确认 Apple Intelligence 模型状态。
  2. 若显示已关闭，请在 macOS“系统设置”中启用 Apple Intelligence。
无法开始免费试用或激活许可证

请检查网络连接和产品版本。每台 Mac、每个主要产品版本仅可免费试用一次。

  1. 如果首次自动开始失败，请检查互联网连接，然后在“通用”设置中选择“免费试用 20 分钟”。免费额度用完后无法重新开始；请从录音面板或“通用”设置中的链接打开专用购买页面购买许可证，以继续使用语音输入和翻译。产品介绍页面不会链接到该页面，如果已关闭应用，请重新打开后从该链接进入。
  2. 已购买或收到运营者提供的密钥时，请在“通用”设置中输入许可证密钥，然后再次选择“激活许可证”。
  3. 如果问题仍未解决，请将购买邮箱和错误详情发送至 support@onvilo.app。
文本翻译失败

请检查目标文字、翻译模型以及输入框是否可编辑。只有 Onvilo 能确认可编辑的输入框，才支持载入并替换全文。替换失败时会恢复翻译前剪贴板中的文字。

  1. 若翻译一部分，请选择非空文字；若翻译全文，请将光标放在有内容的可编辑输入框中。
  2. 在“General”设置中选择语言对，并完成所需模型的准备。
  3. 若 Onvilo 无法识别输入框，请明确选择目标范围，或在翻译窗口中直接输入文字并用“拷贝”取回结果。
翻译窗口打不开，或看不到译文

仍选中文字时按下快捷键，会直接就地替换而不打开窗口。语音输入的处理仍在进行时，也无法新打开窗口。看不到译文时，请检查翻译模型和语言设置。

  1. 若提示语音输入的处理正在进行，请再次按下快捷键或按 Enter 或 Esc 确认录音，等待粘贴完成后再试。
  2. 想打开窗口时，请先取消选择再按 Control + Option + T，或在菜单栏中选择“打开翻译窗口”。
  3. 若窗口内显示下载按钮，请点按并完成模型准备。
  4. 若窗口提示无法确定翻译语言，请在“General”设置中重新选择源语言和目标语言。
在翻译窗口中按 Enter 就直接确认了

默认为按 Enter 确认、Shift+Enter 换行。若经常需要换行，请更改确认键。

  1. 在“General”设置中，将“翻译窗口的确认键”改为“⌘Enter 插入（Enter 换行）”。
  2. 更改会从下一次按键起生效，无需重新启动应用。

卸载并删除本地数据

只删除应用本体后，设置或历史记录可能仍留在 Mac 上。删除前请先从菜单栏 Onvilo 图标的菜单退出，然后根据需要完成以下步骤。

  1. 删除历史记录与纠正学习

    删除 Onvilo 前，在“Privacy”设置中选择“Delete History and Correction Learning Data”。

  2. 退出并删除应用

    退出 Onvilo，然后将“应用程序”文件夹中的 Onvilo 移到废纸篓。

  3. 删除其余本地数据

    如需同时删除设置和数据，请在 Finder 中选择“前往”>“前往文件夹”，逐一打开并删除下列位置。

  4. 检查术语同步文件

    如果导出过术语设置，JSON 文件仍会保留在你选择的位置。需要时请手动删除。

  5. 撤销 macOS 权限

    在“系统设置”>“隐私与安全性”中，撤销 Onvilo 的麦克风、辅助功能和输入监控权限。

本地数据位置

历史记录等数据
~/Library/Application Support/Onvilo
应用设置
~/Library/Preferences/com.latech.Onvilo.plist

Onvilo 无法删除 macOS 剪贴板历史、Universal Clipboard 或其他应用保存的副本。请在对应功能或应用中另行删除。

隐私设置

您可以按类别选择是否允许使用。选择会保存在此浏览器中，也可以随时从页脚更改。

Cookie和访问分析设置