← 返回 VoicePaste
帮助
开始使用 VoicePaste 所需的一切。
快速入门
- 下载并安装 VoicePaste。打开下载的 DMG 文件，将 VoicePaste 拖入应用程序文件夹。
- 启动 VoicePaste。首次启动时，由于应用是从互联网下载的，macOS 可能会要求您确认。点击「打开」即可。VoicePaste 已由 Apple 公证，这意味着 Apple 已在分发前扫描过应用，确认没有恶意软件。
- 授予权限。VoicePaste 会请求麦克风和辅助功能访问权限。两者都是完整功能所必需的。请参阅下文的权限说明。
- 按下快捷键，开始说话。默认快捷键为 ⌘⇧V，并启用自动检测语言。按一下开始录音，说完后再按一下停止。文字会出现在您光标所在的位置。
VoicePaste 在 Cloud 模式下开箱即用，无需 API 密钥或账号。每月可享 30 分钟免费转写。
权限说明
麦克风
用于录制您的声音。没有此权限，VoicePaste 无法采集音频。首次尝试录音时，macOS 会弹出系统对话框。
辅助功能
用于自动粘贴：将转写文本直接键入您正在使用的应用。没有此权限，VoicePaste 仍可将文本复制到剪贴板，但您需要手动按 ⌘V 粘贴。
授予辅助功能权限：打开系统设置 → 隐私与安全性 → 辅助功能，并启用 VoicePaste。
VoicePaste 之所以在 Mac App Store 之外分发，是因为 App Store 的沙盒机制会阻止自动粘贴所需的辅助功能 API。Raycast、Alfred、BetterTouchTool 等同类应用也是出于这一原因采用直接分发。
快捷键
VoicePaste 最多支持 10 个全局快捷键。每个快捷键可定义：
- 语言：用哪种语言进行转写（或自动检测）
- 写作风格：可选地对转写内容进行重写（专业、随意、简洁、正式、友好、自然，或无）
- 输出语言：可选地在同一步骤中翻译为另一种语言
例如，您可以这样设置：
- ⌘⇧V：自动检测语言，不重写（默认）
- ⌘⇧E：英语，不重写
- ⌘⇧P：英语，专业风格
- ⌘⇧S：自动检测后翻译为西班牙语，专业风格
在设置 → 快捷键与写作中配置快捷键。您可以自由添加、删除和重新排序。
VoicePaste 历史记录
在 Mac 上的任何位置按下 ⌘⇧K，即可打开一个浮动窗口，展示您最近的转写。这是最快捷的方式：回想刚才说过的内容、翻译成另一种语言，或无需重新录音便能修正错误。
弹出窗口内
- 浏览：使用方向键在列表中移动。
- 粘贴：按 ↵ 将选中条目粘贴到您刚才所在的应用。
- 搜索：按 ⌘F 筛选列表，匹配内容会高亮显示。
- 收藏：按 F 给条目加星。收藏后可在历史标签页中轻松找到。
- 翻译或调整风格：选择目标语言和写作风格，即可就地改造任意条目。结果会作为嵌套子项显示在原条目下方。
- 重试：若转写失败或被取消，按 ↵ 即可重试。
- 播放音频：每个条目都保留了原始录音。可在弹窗内通过进度条直接回放。
如果 ⌘⇧K 与其他应用冲突，可在设置 → 通用中修改弹出窗口的快捷键。
历史记录完全在本地。您的转写文本和音频都保存在 Mac 上。即便翻译或重写需经 VoicePaste Cloud 处理，结果也只会写回您的本地历史。
VoicePaste Cloud 与 VoicePaste Local
VoicePaste Cloud
默认选项。无需 API 密钥，也无需创建账号。音频将发送至 VoicePaste 服务器进行转写。使用量按订阅套餐的每月配额计算。每月 30 分钟免费。
VoicePaste Local
VoicePaste Local 提供两种不经我们服务器的转写方式：
- 使用您自己的 API 密钥：VoicePaste 支持 OpenAI、ElevenLabs、Deepgram 和 AssemblyAI。音频直接发送给所选提供商，绝不经过 VoicePaste 服务器。
- Local Whisper：在本机运行的设备端转写，完全在您的 Mac 上完成。无需联网，无需 API 密钥，任何数据都不会离开您的电脑。可选择模型大小：tiny（最快）、base、small、medium，或 large-v3-turbo（最准确）。
VoicePaste Local 无需购买即可使用。每次转写后会附加一段简短的署名：「Transcribed by VoicePaste.」一次性支付 $40 即可移除该署名。无论是否付费，您的历史记录中始终保存的是干净的文本。
请在设置 → VoicePaste Local 中配置。
您的数据与隐私
留在您 Mac 上的内容
所有转写文本、音频录音、历史记录、设置和 API 密钥都保存在您 Mac 本地。VoicePaste 绝不会将您的转写内容或录音上传到我们的服务器。您说过的话，属于您自己。
VoicePaste Cloud 会存储什么
使用 Cloud 模式时，VoicePaste 仅存储运行订阅服务所必需的最少元数据：
- 经过散列处理的设备标识（对 Apple 设备 ID 的单向散列，即使有人取得了我们的数据库，也无法反推出您的设备）
- 每次转写的音频时长（用于配额计算）
- 所用语言，以及文本是否被重写或翻译
- 订阅与许可证状态
VoicePaste Cloud 不会存储：
- 您的转写文本（无论是原文还是重写、翻译后的内容）
- 您的音频录音（音频仅在内存中转发给 AI 提供商，随即丢弃）
- 任何超出账单所需的个人信息（账单由 Paddle 处理）
多台 Mac 之间的同步呢？
VoicePaste 目前不会在设备之间同步转写历史。由于我们不在服务器上存储您的转写内容，也就没有可同步的来源。您的历史完全保存在每一台 Mac 上。
这是出于隐私考虑的主动选择。若我们未来引入同步功能，将采用端到端加密，确保只有您自己的设备能够读取您的数据。
故障排查
按下快捷键没有反应
- 请确认 VoicePaste 正在运行（在菜单栏中查看图标）。
- 检查该快捷键是否已被其他应用占用。可在设置中尝试更换组合键。
文字没有自动粘贴
- 请确认已在系统设置 → 隐私与安全性 → 辅助功能中授予权限。
- 如果是刚刚授予的权限，可能需要重启 VoicePaste。
- 某些使用自定义文本控件的应用可能不支持模拟键盘输入。这种情况下文本仍会被复制到剪贴板，请按 ⌘V 粘贴。
- 不会有任何丢失。所有转写都保存在历史记录中，即便剪贴板被覆盖，您也总能在那里找回文本。
转写结果使用了错误的语言
- 如果您使用的是自动检测，但它一直选错语言（例如您说的是荷兰语，结果却转写成了英语），请改为创建一个指定输入语言的快捷键，这样会强制转写提供商使用该语言。
转写不够准确
- 请在系统设置 → 声音中检查麦克风的输入电平。
- 在设置 → 转写中，将经常被听错的词加入您的词典。
- 使用设置中的文本替换功能，自动修正反复出现的错误。
VoicePaste 听不到我的声音
- 请确认已在系统设置 → 隐私与安全性 → 麦克风中授予权限。
- 请检查系统设置 → 声音中是否选中了正确的输入设备。
报错：「无互联网连接」
VoicePaste 需要联网才能转写音频。如果您目前处于离线状态，录音会暂存在本地，待网络恢复后自动转写。