听写模式：同样的话，按去向整理成合适的样子

作者 · 发布于

听写模式决定 Whisper 在你的 Mac 上听到你的话之后，YapToText 怎么处理它们。 Raw Transcription 原样输入，Clean Up、Note、Email、Message 和 Code Comment 则按各自的文体改写，但保留你的用词。默认打开的 Auto 模式每次都会替你选一个。

这些模式在 Modes 页面里。每一个都可以编辑，内置的也一样。你可以用普通的句子写自己的模式，任何 App 都可以有它自己的模式。一切都在你的 Mac 上运行，所以模式不会把你的话发到任何地方。

在 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, 繁體中文

每个模式做什么

App 自带六个模式，外加 Auto：

  • Auto。 读取每次听写，自己决定怎么处理。它有单独的指南： Auto 模式。
  • Raw Transcription。 快速、逐字地把语音转成文字，带基本标点，不用 AI。只要 Auto 关闭，它就是选中的模式，直到你选了别的。
  • Clean Up。 去掉语气词和说了一半的开头，修正语法、大小写和标点，并改正麦克风明显听错的字词。它保留你的用词、语气和语体，包括直白或带脏话的说法，不会删除、缩短或概括任何一句话。它还会把口述的网址和邮箱地址写成正确的格式，把口述的数字转成阿拉伯数字，但不添加单位。App 把它称为推荐的默认模式。
  • Note。 生成简短的标题和要点，把待办事项提取成列表，不添加任何你没说过的内容。
  • Email。 生成邮件正文，不写主题行。只有你提到了某个人的名字，才会加问候语，落款用 Settings、Advanced、Your name 里的名字，绝不会用 [Your Name] 这样的占位符。
  • Message。 为聊天做轻度整理：去掉语气词，改正明显的语法错误，保留随意的语气。
  • Code Comment。 为代码注释和提交信息生成简洁的技术性措辞，标识符和大小写完全照你说的保留，不加引号，也不加代码围栏。

除了 Raw Transcription，每个模式都会连同自己的指令，把文字记录交给整理模型，默认是 Phi-3.5 Mini Instruct。如果结果读起来像助手的回复，比你说的话长出很多，或者重复了参考文本，App 就会丢掉它，改为输入原始的文字记录。 Raw Transcription 从不使用 AI 模型。其他每个模式都保留你的用词，只修正其余部分。

YapToText 的 Switch Mode 列表：Auto、Raw Transcription、Clean Up、Note、Email、Message 和 Code Comment，编号为 1 到 7。
图1. 在 Switch Mode 列表里，Raw Transcription 是唯一标着 Verbatim 的模式。其他每个模式，包括 Auto，都标着 AI cleanup。

选一个模式，或者说到一半切换

选模式有四种方式：

  • 从菜单栏。 点按水豚图标，使用 Mode 选单。在那里选一个模式会关闭 Auto，而 Auto 会从选单里消失，直到你在 Home 页面或 Modes 页面的 Auto 一行把它重新打开。
  • 说话的时候。 按 1 到 9，或者点按展开面板上的模式标签。 Auto 打开时，这次选择只对当前这次听写有效。 Auto 关闭时，它会成为你选中的模式。
  • 从 Modes 页面。 右键点按一个模式，选择 Use This Mode。当前的模式带有 Current 标签。
  • 用快捷键。 Settings、General、Shortcuts 里的 Cycle mode 会按列表顺序逐个切换，任何模式也可以有自己的 Activation shortcut，用它开始的听写就使用那个模式。
Mac 上 YapToText 的悬浮听写面板：实时波形、正在输入的句子，以及取消、暂停和停止按钮。
图2. 说话时，展开面板上的模式标签和按键用的是同样的编号：点按其中一个，或者按它的数字。

数字按 Modes 列表的顺序编排，所以把一个模式向上或向下拖动，它的数字也会跟着变。关闭了 Show in the quick switcher 的模式没有数字。 模式上的数字，就是选中它的按键。 所有按键都在 YapToText 的按键里。

编辑一个模式，或者自己做一个

在 Modes 页面点按任何一个模式，就会打开它的编辑器。它的卡片有 Basics（名称、图标、说明、Show in the quick switcher、Activation shortcut）、Apps that use this mode、带 On battery 选项的 Speech model、Recording & language、AI cleanup、Dictionaries、Where the text goes 和 Try it out。

YapToText 的 Modes 页面：最上面是 Auto，然后是 Raw Transcription、Clean Up、Note、Email、Message 和 Code Comment，编号为 2 到 7。
图3. 在 Modes 页面点按任何一个模式，就会打开它的编辑器。右上角的加号按钮用来新建，Current 标签标出正在使用的模式。

第 1 步：从相近的模式开始

  • 操作: 右键点按一个模式，选择 Duplicate，或者按加号按钮，选择 New Mode。
  • YapToText: 打开新模式的编辑器。
  • 确认: 新模式出现在 Modes 页面的列表里。

第 2 步：写它的指令

  • 操作: 在 AI cleanup 卡片里，保持 Rewrite the transcript with AI 打开，在 Instructions 框里写下你想要的效果，或者按一个 Start from 按钮，从某个内置模式的指令开始。
  • YapToText: 边输入边保存。此后这个模式下的每次听写，整理模型都会照这些指令处理。
  • 确认: 指令里既写了要改什么，也写了要保留什么。

模式指令: 一个用于聊天 App 里简短回复的例子。

把我的听写改成一句简短、友好的回复。保留我的用词和意思。不要添加我没说过的内容。

结果: 整理模型会在你的 Mac 上，朝这个方向改写这个模式下的每次听写。

第 3 步：试一试

  • 操作: 在 Try it out 卡片里输入一段示例，按 Preview with AI。
  • YapToText: 对示例运行这个模式，不需要真的听写。
  • 确认: Result 读起来是你想要的样子。如果不是，就修改指令再预览一次。

在 AI cleanup 下，你还可以选择 Cleanup model，另有三个开关设定模型可以看到哪些上下文。内置模式的右键菜单里有 Reset to Default，加号按钮下有 Restore Built-in Modes，Undo 按钮则退回上一次对模式的更改。 Export Mode 和 Import Mode 可以把模式作为文件转移。 模式只是你能读、也能改写的指令。

给一个 App 专属的模式

任何 App 都可以有自己的模式，这样在那里听写就会自动使用它，不用你去选。可以让 Mail 用 Email，让 Messages 用 Message，让你的编辑器用 Code Comment。

  • 操作: 在模式的编辑器里，找到 Apps that use this mode，按 Add app 并选一个正在运行的 App，其他 App 则用 Choose App。 Settings、Advanced、Per-app modes 编辑的是同一个列表。
  • YapToText: 听写开始时，只要那个 App 在最前面，就切换到那个模式。这不需要辅助功能权限。
  • 确认: Auto 模式关闭时，在那个 App 里听写，输出的文字会按它的模式整理。

Auto 模式打开时，由 Auto 决定每次听写怎么写，所以按 App 设定的模式只有在 Auto 关闭时才会影响写法。 如果你要在很多 App 里听写，在 Mac 上向任何 App 听写的指南会一个 App 一个 App 地讲。

对已有的文字运行模式

有三个地方可以对已经写好的文字运行模式：

  • 菜单栏里的 Regenerate。 点按水豚图标，再点 Regenerate： Redo it as 会用任意模式重新处理你上一次的听写， Rewrite it as 会用任意模式改写你选中的文字，一次性编辑则会应用一个 AI Action。
  • History。 每条记录都保留着它的原始文字记录，所以 Regenerate with AI 可以用另一个模式重新处理一次旧的听写。细节见 History 指南。
  • Utility。 Transform text 卡片接收粘贴进来的文字，用任意模式重新排版，比如把笔记变成一封邮件。那个页面的其余部分见 Utility 指南。
YapToText 的菜单栏面板：Start Dictation、模式和麦克风选单、Transcribe file、Regenerate 和 Insert last。
图4. 水豚面板里的 Regenerate 会用任意带 AI cleanup 的模式，重新处理你上一次的听写，或者你选中的文字。

改写选中的文字需要辅助功能权限，也就是让 App 能够输入文字的同一项权限。 模式适用于任何文字，包括你上周听写的内容。

限制

  • 需要整理模型。 除了 Raw Transcription，每个模式都需要一个。Homebrew 版本不带模型，所以在依赖 AI 模式之前，请先在 AI Models 页面下载 Phi-3.5 Mini Instruct，2.3 GB。
  • 转写后分析。 Home 页面上的这个总开关关闭时，任何模式都不会运行：每次听写都按你说的原样输入，Modes 页面也会这样提示。
  • 模型较小。 整理模型在你的 Mac 上运行，所以在依赖一个新模式之前，请先在 Try it out 里预览。
  • 听写中途切换。 新模式的整理会用于正在进行的听写，但它的语音模型和语言要从下一次听写起才生效。
  • 九个数字。 数字键能选到切换器里的前九个模式。

模式的表现不对劲时

  1. 看是哪个模式在运行。 在 History 里，对那次听写点按 Show pipeline details。 Mode 一行写着它的名称， Auto detected 则写着 Auto 选了什么。
  2. 检查总开关。 在 Home 页面的 After transcription 卡片里， Post-transcription analysis 必须是打开的。
  3. 用同样的话预览。 把你说的话粘贴到模式编辑器的 Try it out 里，对照一下。
  4. 修改指令。 写清楚要保留什么，也写清楚要改什么，或者对内置模式使用 Reset to Default。
  5. 换一个模型。 在模式的编辑器里选另一个 Cleanup model，或者这类文字就用 Raw Transcription。
  6. 告诉我。 在 GitHub 上提交 issue，写明模式、你说的话和输出的结果。

小结

  • Raw Transcription。 你说什么就原样输入什么，不用 AI。
  • Clean Up 和其他模式。 它们把你的话整理成适合邮件、笔记、聊天或代码注释的样子。
  • Auto。 默认打开，替你选。

按文字的去向选模式，或者让 Auto 来选。 如果你是从 superwhisper 转过来的，superwhisper 替代方案页面对比了两者。如果某个模式让你意外，请在 GitHub 上提交 issue。每一条我都会看。

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

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

指南

更多指南（英文）

常见问题

YapToText 应该用哪个模式？

默认打开的 Auto 会替你选。如果你自己选，Clean Up 会去掉嗯啊之类的语气词并修正语法，不改变你的意思，Raw Transcription 则原样输入你说的话。

Raw Transcription 用 AI 吗？

不用。它是快速、逐字的语音转文字，带基本标点：Whisper 听你说话，没有任何东西改写这些字词。

可以自己做听写模式吗？

可以。复制一个相近的模式，或者在 Modes 页面的加号按钮下选择 New Mode，然后用普通的句子写它的指令，并在 Try it out 里测试。

为什么 Email 模式不写主题行？

它的指令只写邮件正文。每个内置模式都可以编辑，所以你可以改掉这一点。

每个 App 可以用不同的模式吗？

可以。在模式的编辑器里，把 App 添加到 Apps that use this mode 下，或者在 Settings、Advanced、Per-app modes 里添加。Auto 模式打开时，改由 Auto 决定怎么写。

模式会把我的文字发到别处吗？

不会。语音模型和整理模型都在你的 Mac 上运行，你的话和指令也都留在那里。