superwhisper 的上下文感知:它获取什么、什么时候获取,以及为什么有时什么都没获取到
作者 Ryleigh Newman · 发布于
上下文感知(Context awareness)让 superwhisper 的模式给它的 AI 模型提供的不只是你说的话,还有你选中的文字、你所在窗口里的文字,以及剪贴板里的内容。它让回复和修改更贴合你正在看的东西。这三种各自在不同的时刻获取,大多数问题都出在这个时机上,所以这一页会逐一讲清楚。
我做了 YapToText,一款不同的 Mac 听写 App,所以请带着这一点来看我对 superwhisper 的说法。这里关于 superwhisper 的每一个事实,都来自它自己的文档,我在2026年10月10日读过。
免费下载。无需账号,没有锁定的功能。需要搭载 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, 繁體中文
三种上下文
出自 superwhisper 的文档 Context awareness,2026年10月10日查阅。
| 上下文 | 它是什么 | 什么时候获取 |
|---|---|---|
| 选中的文字 | 当前窗口里高亮选中的文字 | 你开始录音的那一刻 |
| App | 当前输入框里的文字、名称,以及当前窗口的标题 | 转写之后,AI 步骤之前 |
| 剪贴板 | 你拷贝的内容 | 开始录音前三秒之内,或者听写期间。以最后一次拷贝为准 |
哪些模式会用到
- Super Mode。内置模式里唯一默认把三种全部打开的。
- 其他内置模式。大多数把上下文关着。
- 自定义模式。可以任意组合,编辑页的 Context 一行里有三个复选框。文档说这些复选框需要 Pro 许可证。
superwhisper 自己的建议是,只打开模式需要的,因为多余的上下文会把更多信息发给 AI,还可能让结果变差。History(历史记录)里的 Prompt 字段会准确显示发送了哪些上下文。
不起作用的时候
出自 superwhisper 的文档 Context awareness,2026年10月10日查阅。
| 问题 | 检查什么 |
|---|---|
| 选中的文字被忽略 | 开始录音时,让焦点留在有选中内容的 App 上,并且使用打开了选中文字的模式 |
| App 上下文不对或为空 | 处理结束前不要切换窗口,并检查“系统设置”,“隐私与安全”里的辅助功能 |
| 剪贴板被忽略 | 在开始前三秒之内拷贝,或者在听写期间拷贝 |
| 从 shell 用深度链接启动 | 用 -g 标志在后台打开链接,这样焦点会留在你的 App 上 |
上下文去了哪里
上下文会连同你的转写文字一起,发给该模式的语言模型。superwhisper 允许每个模式使用本地语言模型或云端语言模型,所以这些文字会不会离开你的 Mac,取决于该模式用的模型。这个选择见 superwhisper 隐私页面,Super Mode 和自定义模式见模式页面。
YapToText 里的上下文
superwhisper 的内容出自它的文档,2026年10月10日查阅。YapToText 的内容出自它自己的设置。
| superwhisper | YapToText | |
|---|---|---|
| 选中的文字 | 有 | 有 |
| 剪贴板 | 有,在之前或期间 3 秒内拷贝 | 有 |
| App 或窗口 | 当前窗口的文字和标题 | 你正在向其中听写的那个 App |
| 价格 | 自定义模式需要 Pro 许可证 | 免费 |
| AI 在哪里运行 | 该模式的模型,本机或云端 | 在你的 Mac 上 |
YapToText 的每个模式都有各自的开关,分别控制来自 App、你的选中内容和你的剪贴板的上下文,而且它的整理模型在你的 Mac 上运行。如果想把三者都比一比,VoiceInk 的同一项功能还会读取屏幕上的文字。
免费下载。无需账号,没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
小结
- 选中的文字。在你开始时获取,所以让焦点留在那个 App 上。
- App。在转写之后获取,所以不要切换窗口。
- 剪贴板。在三秒之前或听写期间拷贝。
- 模式。Super Mode 里是开着的。自定义模式要用它需要 Pro。
- 自己查看。History 的 Prompt 字段会显示发送了什么。
如果 superwhisper 改了上下文的工作方式,请在 GitHub 上提交 issue,我会更新这一页。每一条我都会看。
免费下载。无需账号,没有锁定的功能。需要搭载 Apple 芯片的 Mac 和 macOS 14 或更高版本。 源代码在 GitHub 上。
指南
资料来源
- https://superwhisper.com/docs/common-issues/context (查阅于 2026年10月10日)
- https://superwhisper.com/docs/modes/custom (查阅于 2026年10月10日)
- https://github.com/ryleighnewman/YapToText (查阅于 2026年10月10日)
- https://apps.apple.com/us/app/yaptotext/id6786382289 (查阅于 2026年10月10日)
常见问题
superwhisper 的上下文感知(context awareness)是什么?
模式可以把你选中的文字、当前窗口里的文字和你的剪贴板交给它的 AI,让输出贴合你正在做的事。
为什么 superwhisper 忽略了我选中的文字?
它在你开始录音的那一刻获取,所以那时有选中内容的 App 必须拥有焦点,而且该模式必须打开了选中文字上下文。
superwhisper 的哪个模式会用上下文?
Super Mode 默认打开全部三种。自定义模式可以使用其中任意一种,文档说这需要 Pro 许可证。
怎么查看 superwhisper 发送了什么上下文?
在 History 里打开那条听写。Prompt 字段会显示发给 AI 的内容。
superwhisper 会把我的屏幕发到云端吗?
上下文会发给该模式的语言模型。用本地模型时留在你的 Mac 上,用云端模型时则发给那家服务商。