菜单栏听写图标：水豚，以及他在告诉你什么

作者 · 发布于

Mac 菜单栏里的水豚是 YapToText 的状态灯，点按他会打开一个小面板，不用打开窗口就能控制听写。从第一次启动起他就在那里，Home 页面上的 Icons 卡片可以把他换成更朴素的图标，也可以把他隐藏。当你的手已经放在鼠标上，或者想一眼看出 App 在做什么时，他最有用。

录音时他的对话气泡变红，你的话在转写和整理时气泡变成转圈，文字输入完成时闪一下绿色，出了问题则变成橙色。什么都没发生时，他安静地以菜单栏自己的颜色待着，每隔几秒眨一下眼，这是他唯一纯粹为了好玩而做的事。

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

YapToText 的菜单栏面板：Start Dictation、模式和麦克风选择、Transcribe file、Regenerate 和 Insert last。
图1. 点按水豚就会出现这个面板。周围是他的四种样子：空闲时是朴素的，录音时是红色，工作时是转圈，出错后是橙色。

看懂每种颜色的含义

只有对话气泡会变化，水豚本身始终是菜单栏自己的颜色。红色表示在听，转圈表示在处理，绿色表示文字已经输入。

  • 朴素，没有颜色。空闲。图标会像菜单栏里的其他项目一样，跟随浅色或深色菜单栏，每隔几秒眨一下眼。
  • 红色，一起一伏。正在录音。气泡在亮红和深红之间变化，他在听的时候三个点会跳动。
  • 原来气泡的位置出现转圈。正在转写，或者整理模型在工作。1.4 版让它在浅色菜单栏上也看得见，1.3.1 版修复了它倒着转的问题。
  • 绿色。你的文字刚刚输入完成。
  • 橙色。这次听写出了错，浮动面板会显示出了什么问题。

使用面板

点按水豚打开面板。从上到下依次是：

  • Start Dictation。和轻按你的听写键效果相同，默认是右 Command 键。录音时它会变成三个圆形按钮：取消、暂停或继续、停止并输入。App 还在处理你的话时，只剩下取消。
  • Mode。左边的药丸形按钮显示当前模式。它的菜单把你的模式从 1 到 9 编号，和听写过程中可以按的数字相同，超过九个的放在 More modes 下面。Post-transcription analysis 关闭时，药丸形按钮是灰色的，因为那时模式不起作用，点按它会说明原因，并提供重新打开分析的选项。
  • Input。右边的药丸形按钮选择 YapToText 听哪支麦克风。System Default 跟随 macOS，下面是 Mac 上的每一个输入设备。
  • Transcribe file。打开文件选择器，选任何音频或视频文件，用你当前的模式转写。文字会进入剪贴板和 History，Insert text automatically 打开时（默认就是打开的），还会输入到你选文件时正在使用的 App 里。
  • Regenerate。把你上一次的听写，或你选中的文字，按另一种模式重写。细节见下一节。
  • Insert last。把你最近一次的听写输入到你刚才使用的 App。History 里有内容之前它一直是灰色的。
  • Recent。你最近三次的听写，每次两行，每条旁边有一个拷贝按钮。See all 会打开 History。
Mac 上 YapToText 的浮动听写面板：实时波形、正在输入的句子，以及取消、暂停和停止按钮。
图2. 录音时 Start Dictation 会变成取消、暂停和停止，这和浮动面板显示的三个按钮相同。

最下面一排的按钮可以退出 App、打开打赏页、打开主窗口和打开 Settings。听写需要的一切都只差一次点按，主窗口可以一直关着。

从菜单栏使用 Regenerate

Regenerate 会重写你已有的文字。点按它，面板会问你要重写什么。Most recent dictation 重做你的上一次听写，Selected text 重写你选中的任何内容。

  • Most recent dictation。用任何开启了 AI 整理的模式重做你的上一次听写：一条口述的消息变成邮件，一段絮絮叨叨的笔记变成整洁的笔记。如果原文在最近五分钟内还显示在屏幕上，新文字会就地换进去。否则它会进入剪贴板。History 会保留新版本。
  • Selected text。用任何开启了 AI 整理的模式，重写你刚才使用的 App 里选中的内容，并把结果粘贴到选中内容上。这个列表还提供你的 AI Actions，作为一次性的编辑，例如 Summarize 或 Translate to English。

不提供 Raw Transcription，因为它没有用来重写的工具。你选好之后，面板会显示 Regenerating as，停留片刻，然后淡出，让 App 切换回去并粘贴。如果想用说话来描述改动并重写选中的内容，Quick Edit 一个键就能做到。

选一个图标样式

水豚是默认样式，但另有四种更朴素的样式，作用相同。Menu bar icon 选择器在 Home 页面的 Icons 卡片里，也在 Settings, General, System 里。

YapToText 的 Home 页面，Icons 卡片从底部开始：Menu bar icon 开关已打开，样式选择器设为 Capybara。
图3. Icons 卡片位于 Home 页面底部：Menu bar icon 开关可以隐藏水豚，旁边的选择器可以把他换成更朴素的样式。
  • Capybara。吉祥物，用他的对话气泡当状态灯。
  • Microphone。标准的麦克风符号：空闲时是轮廓，录音时是实心，App 工作时角上有转圈。
  • Mini waveform。九根小竖条，空闲时是静止的波形，录音时显示你真实的声音。它没有转圈，也没有绿色闪烁，所以你只需要看这些竖条。
  • Speech bubble。一个朴素的气泡，空闲时是轮廓，录音时是实心。
  • Minimal dot。一个小圆点，录音时随每次呼吸胀大。

面板顶部的图标会跟着变化，所以你点按的东西和打开的面板看起来是同一个 App。

打开或关闭彩色状态

Colored status in the menu bar 是 Settings, General, System 里的一个开关，默认打开。打开后，除 Mini waveform 之外的每种样式都会随听写状态变色：录音时红色，输入时绿色，出错时橙色。关闭后，图标在每种状态下都保持单色并跟随菜单栏，转圈和从轮廓变实心的变化仍然能显示发生了什么。

Mini waveform 的做法不同。彩色状态打开时，它的竖条只在听写进行中亮起，颜色是你的自定义强调色，或者你在开关下方选的 Visualizer 颜色，空闲时回到单色。Match accent 会把你选的颜色恢复回来。

隐藏图标，或在重启后保留它

Home 页面 Icons 卡片里的 Menu bar icon 开关可以把水豚从菜单栏拿掉。其他一切照常：你的听写键仍然能开始听写，浮动面板也仍然会出现。Dock 图标在同一张卡片里有自己的开关。如果两个都隐藏了，从“应用程序”文件夹再次打开 YapToText，它的窗口就会回来。

水豚只在 YapToText 运行时出现。想让他在每次重启后都在，就在 Settings, General, System 里打开 Launch YapToText at login。它默认是关闭的。

限制

  • Regenerate 需要整理模型。App Store 版本内置了一个。Homebrew 版本需要先到 AI Models 页面下载 Phi-3.5 Mini Instruct 或其他整理模型。
  • Selected text 需要辅助功能权限。没有它，听写仍然能用并拷贝到剪贴板，但 Regenerate 看不到你选中的内容。
  • 密码栏保持私密。Secure Input 打开时，通常意味着在密码栏里，读不到任何选中的内容，Regenerate 会这样提示。

出了问题时

如果看不到水豚，按下面的清单依次检查：

  1. 打开 YapToText。他只在 App 运行时出现。
  2. 把图标重新打开。在 Home 页面的 Icons 卡片里，打开 Menu bar icon。
  3. 给菜单栏腾出空间。在有刘海的 MacBook 上，菜单栏拥挤时，macOS 会隐藏放不下的项目。YapToText 会尝试一次把他移到可见的位置。移除其他几个项目就能给他腾出空间。

其他看起来不对的情况：

  • 模式药丸形按钮是灰色的。Post-transcription analysis 已关闭。点按这个按钮，App 会提供重新打开它的选项。
  • Regenerate 提示要先选中一些文字。先在另一个 App 里选中文字，再打开面板。
  • Insert last 是灰色的。History 是空的，当 Save dictation history 在 Settings, Advanced, History & audio 里关闭时就会这样。
  • 图标从不变色。Colored status in the menu bar 已关闭，或者你选了 Mini waveform，但没有设自定义强调色或 Visualizer 颜色。

听写本身的问题，请看排查页面，那里是一步一步的说明。

简短版

  • 看颜色。红色是录音，转圈是处理中，绿色是已输入，橙色是出错。
  • 点按他看控件。Start Dictation、模式、麦克风、Transcribe file、Regenerate、Insert last 和你最近的听写。
  • 更换或隐藏他。Home 页面的 Icons 卡片里有这两个开关。

看一眼就知道 App 在做什么，点一下就能拿到其余的一切。如果他显示了这一页没有解释的东西，请在 GitHub 上告诉我（英文）。每一条 issue 我都会看。

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

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

指南

更多指南（英文）

常见问题

为什么水豚的对话气泡是红色的？

红色表示 YapToText 正在录音。气泡会一起一伏，点会跳动，直到你停止，然后在转写你的话时变成转圈，文字输入完成后闪一下绿色。

橙色的菜单栏图标是什么意思？

橙色表示上一次听写出了错，浮动面板会显示出了什么问题。排查页面介绍了常见的原因。

可以把菜单栏图标换成比水豚更朴素的吗？

可以。Home 页面 Icons 卡片里和 Settings, General, System 里的 Menu bar icon 选择器提供 Capybara、Microphone、Mini waveform、Speech bubble 和 Minimal dot。

可以隐藏 YapToText 的菜单栏图标吗？

可以。关闭 Home 页面 Icons 卡片里的 Menu bar icon 开关。没有它，你的听写键、浮动面板和其他所有功能都照常工作。

Insert last 有什么用？

它会把你最近一次的听写输入到你上次使用的 App。History 里至少有一条听写之前，它一直是灰色的。

可以从菜单栏把一次听写按另一种模式重新生成吗？

可以。Regenerate 提供你最近的听写，或你在上一个 App 里选中的文字，然后列出每种开启了 AI 整理的模式。对于选中的文字，重写的结果会就地替换选中内容。