VoiceInk 的 Context Awareness：它从你的 Mac 读取什么，这些文字又去了哪里

作者 · 发布于

Context Awareness（上下文感知）让 VoiceInk 的 Mode（模式）给它的 AI 模型提供的不只是你说的话。它可以加上你选中的文字、剪贴板里的文字，以及从屏幕上读出的文字，所以回复能贴合你正在回的那封邮件，名字也能按屏幕上的写法拼出来。它只在配合 AI Enhancement 时才起作用，而且它附加的文字会发给该 Mode 所用的 AI 服务商。后面这一点，建议在打开它之前先读一读。

我做了 YapToText，一款不同的 Mac 听写 App，所以请带着这一点来看我对 VoiceInk 的说法。这里关于 VoiceInk 的每一个事实，都来自它自己的文档，我在2026年10月10日读过。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

用其他语言阅读： English, العربية, Čeština, Dansk, Deutsch, Ελληνικά, Español, Suomi, Français, עברית, हिन्दी, Magyar, Bahasa Indonesia, Italiano, 日本語, 한국어, Norsk, Nederlands, Polski, Português, Română, Русский, Slovenčina, Svenska, ไทย, Türkçe, Українська, Tiếng Việt, 繁體中文

三种来源

出自 VoiceInk 的文档 Context Awareness，2026年10月10日查阅。没有授予权限时，那一种来源会被跳过。

来源VoiceInk 怎么获取权限
Selected Text通过 macOS 的辅助功能读取当前的选中内容辅助功能
Clipboard在开始录音时读取剪贴板里的文字无需额外权限
Screen截取当前窗口，并在 Mac 上用 OCR 读出其中的文字屏幕录制

给某个 Mode 打开它

  1. 打开 Modes。
  2. 编辑一个已经打开 AI Enhancement 的 Mode。
  3. 展开 Context Awareness。
  4. 打开 Selected Text、Clipboard 或 Screen。
  5. 保存这个 Mode。

在自定义提示词里，可以用标签指向每一种来源：<CURRENTLY_SELECTED_TEXT>、<CLIPBOARD_CONTEXT> 和 <CURRENT_WINDOW_CONTEXT>。文档建议的用法有：口述一条指令来改写选中的内容，或者针对选中的邮件往来起草回复。

发送了什么，发给了谁

  • 发给 AI 服务商。上下文随 AI Enhancement 的请求一起发送，目的地是该 Mode 所用的服务商和模型。本机转写并不会让云端增强也变成本机处理。
  • 发送的是屏幕上的文字，不是图片。OCR 用 Apple 的 Vision 框架在 Mac 上运行，发送的是提取出来的文字，而不是截图。
  • 快照仍然会拍。实时录音开始时，VoiceInk 会在内存里准备一份上下文快照。这些开关决定的是请求里包含什么，而不是 VoiceInk 在本机上读不读。
  • 保存在 History 里。History 里保存的 AI 请求，可能包含发送出去的上下文文字。
  • 不是每个 Mode 都有。没有开启增强的 Mode 不发送任何上下文。VoiceInk Refine 会忽略它，导入的文件也不会采集上下文。

什么时候该关着

VoiceInk 自己的建议是，只打开任务需要的来源，并且想一想哪个服务商会收到这些文字。在邮件 App 里运行的 Mode 如果用了 Screen 来源，就会把当前打开的那封邮件的可见文字发出去。如果这很要紧，就只在一个针对一个 App 的 Mode 里打开上下文，日常用的 Mode 则不要打开。服务商的情况见 VoiceInk 的隐私页面，每个 App 怎么选 Mode 见 Modes 页面。

YapToText 怎么处理上下文

VoiceInk 的内容出自它的文档，2026年10月10日查阅。YapToText 的内容出自它自己的设置和源代码。

VoiceInkYapToText
选中的文字有，通过辅助功能有
剪贴板有有
你所在的 App通过 Mode 的匹配有，而且 Auto 模式会按 App 倾向于某种风格，例如在“邮件”里偏向 Email
用 OCR 读屏幕文字有，需要屏幕录制权限没有。它不会截取屏幕
AI 在哪里运行该 Mode 的服务商，本机或云端在你的 Mac 上

YapToText 的每个模式都有各自的开关，分别控制来自 App、你的选中内容和你的剪贴板的上下文，而且它的整理模型在你的 Mac 上运行，所以这些文字不会发给 AI 服务商。除此之外，它读不到屏幕上的内容，如果你想要根据一个没有选中的窗口来起草回复，这就是个实实在在的限制。这些开关见 模式帮助页。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

小结

  • 它是什么。随听写一起发给 AI 的额外文字。
  • 来源。选中的文字、剪贴板、用 OCR 读出的屏幕文字。
  • 需要。打开 AI Enhancement，再加上辅助功能或屏幕录制权限。
  • 发往。该 Mode 的 AI 服务商，并且可能保存在 History 里。
  • 建议。只打开任务需要的来源。

如果 VoiceInk 改了 Context Awareness 的工作方式，请在 GitHub 上提交 issue，我会更新这一页。每一条我都会看。

在 Mac App Store 下载 YapToText免费下载。无需账号，没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。

关于作者。 Ryleigh Newman 从事软件开发，用手打字有困难，每天都用本站介绍的 YapToText 听写。本页译自英文。App 的界面和网站的其他页面是英文的。 进一步了解这个项目（英文）。

指南

更多指南（英文）

资料来源

常见问题

VoiceInk 的 Context Awareness 有什么用？

它会把你选中的文字、剪贴板文字，或从当前窗口读出的文字，加进 AI Enhancement 的请求里，让 AI 据此调整输出。

VoiceInk 会把截图发给 AI 吗？

不会。它在 Mac 上用 OCR 读出窗口里的文字，发送的是文字，不是图片。

为什么 VoiceInk 的屏幕上下文不起作用？

屏幕上下文需要屏幕录制权限，选中的文字需要辅助功能权限。没有权限时，这些来源会被跳过。此外，该 Mode 还需要打开 AI Enhancement。

VoiceInk 的 Context Awareness 私密吗？

上下文会发给该 Mode 所用的 AI 服务商。用云端服务商的话，这些文字就离开了你的 Mac。

YapToText 会读取我的屏幕吗？

不会。模式可以使用你所在的 App、你的选中内容和你的剪贴板，而它的整理在 Mac 上完成。