YapToText 的语音标点:每个标点符号该怎么说

在 Mac 上用 YapToText 听写时,要输入标点,就在一句话说完时说出标点的名称:question mark(问号)、exclamation point、new line、new paragraph。comma、period 和 colon 这类单个词的名称,前面要加上 insert 这个词,所以要说 insert comma,因为 Require the word “insert” before a command 默认是打开的。

大多数句子用不到这些,因为 Whisper 会自己给普通的口语加标点。口述名称是给它猜不到的标点用的,每一个都列在 Commands 页面上,也都可以修改。我用手打字有困难,为了加一个逗号去够键盘,就失去了听写的意义。Apple 自带的听写有哪些命令,见 Mac 听写命令指南。

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

Mac 上 YapToText 的悬浮听写面板:实时波形、正在输入的句子,以及取消、暂停和停止按钮。
图1. 面板里实时显示的文字直接来自 Whisper,它会自己给普通的口语加标点。口述名称是给它猜不到的标点用的。

两个词的名称,在一句话末尾说

由两个或更多词组成的名称,在结束一句话时会自己触发,不需要 insert。只要名称在一句话的末尾,两个词的名称就不需要 insert。

说: 用标点的名称结束一句话。

is it working now, question mark

得到: “is it working now?”Whisper 放在名称前面的逗号会去掉,它紧接在名称后面加的标点也一样。

后面紧跟小写单词时,两个词的名称会保留为文字,所以“it put a question mark in the middle”会照你说的原样输入。后面紧跟大写字母或数字时,名称就会触发。new line 和 new paragraph 还会清理换行两侧的空格。这是听写常见的做法,YapToText 从 1.4 版起就是这样。

单个词的名称前面加 insert

Commands 页面上有一个开关 Require the word “insert” before a command,默认是打开的。它避免普通的口语变成符号,所以“that period of time”和“a dash of salt”仍然是文字。

YapToText 的 Commands 页面:Enable voice commands 已打开,Require the word insert before a command 已打开,还有 Snippets 标签页。
图2. Require the word insert before a command 位于 Commands 页面靠上的位置,默认是打开的,在 Snippets、Punctuation 和 Emoji 标签页的上方。

说: 开关打开时,在句子的任何位置都可以。

insert comma

结果: 输入一个逗号,贴在前一个词后面。

  • 单个词的标点名称。 period, comma, colon, semicolon, hyphen, dash, ellipsis, quote, apostrophe, slash, backslash, ampersand, hashtag, asterisk, tilde, underscore, bang 等都需要 insert。
  • 表情符号和文本片段。 它们全都需要 insert,再长的名称也一样:insert smiley face、insert today's date。
  • 两个词的标点名称。 它们从来不需要。

把开关关掉,所有名称不加 insert 也会触发。匹配按整个词进行,不区分大小写,所以“periodic”不会变成句号。insert 规则的作用,就是不让普通的词变成符号。

标点怎么落在你的文字里

  • 向前靠拢的标点。 period、comma、question mark、exclamation point、colon、semicolon 和 ellipsis 会吃掉前面的空格,所以“really question mark”得到“really?”。
  • 带在词前面的符号。 hashtag、at sign、dollar sign 和左括号会与后面的词连在一起:“dollar sign 50”得到 $50,开关打开时,“insert hashtag vibes”得到 #vibes。像 at sign 这样的两个词的名称,后面紧跟小写单词时,会保留为文字。
  • 换行。 new line 和 new paragraph 会吃掉两侧的空格。
  • 重复。 dot dot dot 会吸收多余的点,所以听到五个点,也只得到一个省略号。

标点在任何 AI 整理之前就已确定,所以整理用的模型看到的是写好的标点,而不是那几个词。表情符号和文本片段在整理之后才插入,所以改写不会把它们弄丢或挪位置。这一切在每种模式下都有效,包括 Raw Transcription。这些都在文字输入之前完成,所以在 YapToText 输入文字的任何 App 里都有效,从 Word 到 Google Docs。

YapToText 里的 Switch Mode 列表,显示 Auto、Raw Transcription、Clean Up、Note、Email、Message 和 Code Comment,每个模式都有各自的数字键
图3. 口述标点在这个列表里的每种模式下都有效,包括 Raw Transcription。

所有标点名称

这是 YapToText 自带的 45 条标点命令。当 Require the word “insert” before a command 打开时,单个词的名称前面要加 insert。由两个或更多词组成的名称则不需要。pound sign 输入的是井号。想输入英镑货币符号,请说 sterling sign。

说得到
period, full stop句号 (.)
comma逗号 (,)
question mark问号 (?)
exclamation point, exclamation mark, exclamation, bang感叹号 (!)
colon冒号 (:)
semicolon, semi colon分号 (;)
hyphen, dash, minus sign连字符 (-)
ellipsis, dot dot dot省略号 (…)
open paren, open parenthesis, left paren左圆括号
close paren, close parenthesis, right paren右圆括号
open bracket, left bracket, open square bracket左方括号
close bracket, right bracket, close square bracket右方括号
open brace, left brace, open curly brace左花括号
close brace, right brace, close curly brace右花括号
quote, double quote, quotation mark直双引号 (")
apostrophe, single quote撇号 (')
slash, forward slash斜杠 (/)
backslash, back slash反斜杠 (\)
ampersand和号 (&)
at sign, at symbol艾特符号 (@)
hashtag, hash sign, pound sign, number sign井号 (#)
percent sign, percent symbol百分号 (%)
asterisk, star symbol星号 (*)
plus sign加号 (+)
equals sign, equal sign等号 (=)
dollar sign美元符号 ($)
euro sign欧元符号 (€)
pound sign symbol, sterling sign英镑符号 (£)
cent sign美分符号 (¢)
bullet point, bullet symbol项目符号 (•)
degree sign, degrees symbol度数符号 (°)
caret symbol脱字符 (^)
tilde波浪号 (~)
underscore下划线 (_)
vertical bar, pipe symbol竖线 (|)
less than sign, left angle bracket小于号 (<)
greater than sign, right angle bracket大于号 (>)
copyright sign, copyright symbol版权符号 (©)
registered sign, registered trademark注册商标符号 (®)
trademark sign, trademark symbol商标符号 (™)
section sign章节符号 (§)
paragraph sign, pilcrow段落符号 (¶)
tab key一个制表符
new line, line break一个换行
new paragraph一个空行,即两个换行

这张表里的每个名称都可以改名、关闭,或者加上更多说法。

表情符号和文本片段

158 个表情符号开箱即有口述名称,几乎都以 emoji 一词结尾:fire emoji, heart emoji, laughing emoji, thinking emoji, party emoji, rocket emoji, check mark emoji, skull emoji。少数名称更短:smiley face, thumbs up, thumbs down。

说: insert 开关打开时,这也是默认状态。

insert smiley face

结果: 笑脸表情符号会出现在你说出名称的位置。

自带五个可以直接使用的文本片段:

  • today's date。 它输入今天的日期。
  • current time。 也可以说 the time right now。它输入当前时间。
  • paste my clipboard。 它输入剪贴板里的文字。
  • shrug face。 它输入用键盘字符组成的耸肩表情。
  • my email signature。 它输入“Best,”和一个换行。请改成你自己的结束语。

在 Commands 页面底部,Suggestions 提供五个起始项:Phone number, Work email, Personal email, Home address 和 Website。点一个,填上你的真实内容,然后说 insert phone number 就会输入。它们是供你填写的起始项,不是内置命令。有三个实时占位符可用于任何命令的 Inserts 框,分别是 {date}、{time} 和 {clipboard},会在你听写的那一刻被填入。文本片段可以是你选的任何说法,输入你写的任何文字。

App Store 海报,标题为 Teach it your words,并排显示 Dictionaries 页面和 Commands 页面。
图4. 右边是 Commands 页面:先填好 Phone number 这样的起始项,之后说 insert phone number 就会输入。左边是 Dictionaries 页面,用来修正名字的拼写。

在 Commands 页面修改任何名称

Commands 页面有三个标签页,Snippets、Punctuation 和 Emoji,还有一个搜索框。每一行列出你说的短语(用逗号分隔)、它输入的内容,以及一个 On 开关。

添加你自己的短语

  • 操作: 打开一个标签页,按列表下方的 Add 按钮,然后在 Say this 下输入你的短语,在 Inserts 下输入要输入的文字。
  • YapToText: 边输入边保存。在 Inserts 框里,\n 代表一个换行。
  • 确认: 听写这个短语,开关打开时前面要加 insert,文字就会出现。
  • 多个短语。 可以给一条命令设置多个说法,例如“exclamation point, exclamation, bang”。较长的短语优先匹配,所以 exclamation point 不会被 exclamation 截断。
  • Restore Defaults。 它只重置你当前所在的标签页。
  • Export All 和 Import。 它们把全部命令作为一个文件导出和导入。
  • Enable voice commands。 这个开关一次关闭所有命令。

把任何命令改成你自然会说的词。 总是被拼错的词,应该交给 Dictionaries 页面 处理。

限制

  • insert 规则。 它打开时,单个词的名称不加 insert 就会被当作文字输入。
  • 一句话的结尾。 两个词的名称后面如果紧跟小写单词,会保留为文字,这是有意设计的。
  • 没有 delete 或 backspace 命令。 要撤回刚输入的一段听写,在 30 秒内把 scratch that 作为单独的一次听写说出来。依次说 replace、错的词、with、对的词,可以改正一个词。这两种都属于 Corrections by voice,详见 Quick Edit 指南。
  • Whisper 听到什么。 只有当 Whisper 写出的恰好是这些词时,名称才会触发。YapToText 会用两个词的名称给 Whisper 做提示,但嘈杂的环境仍可能让它把其中一个听成别的东西。

标点变成了文字时

  1. 加上 insert。 开关打开时,单个词的名称需要它。
  2. 结束这句话。 在一句话结束的地方说两个词的名称。如果后面紧跟小写单词,它会保留为文字。
  3. 检查开关。 在 Commands 页面,Enable voice commands 必须打开,这一行的 On 开关也必须打开。
  4. 查看原始转写。 在 History 里,Show pipeline details 会显示 Whisper 听到了什么。如果它把名称写成了别的样子,就把那种写法作为另一个短语加到这一行里。
  5. 告诉我。 打开一个 GitHub issue,写明你说的原话和输入的结果。

简短版

  • 两个词的名称。 直接说,放在一句话的末尾。
  • 单个词的名称。 前面加上 insert。
  • 表情符号和文本片段。 这些前面也要加上 insert。

在标点要出现的地方说出名称,名称是单个词时再加上 insert。 如果某个名称的表现和本页所说的不一样,请在 GitHub 上告诉我。每一条我都会看。

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

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

指南

更多指南(英文)

常见问题

在 Mac 上听写时怎么加标点?

用 YapToText 时,在一句话说完时说出标点的名称,比如 question mark 或 new paragraph。像 comma 这样的单个词的名称,在该设置打开时要先说 insert,这也是默认状态。

每个标点前都要说 insert 吗?

不用。只有 period、comma 或 dash 这样的单个词的名称才需要,而且只在 Require the word insert before a command 打开时需要。由两个或更多词组成的名称从来不需要。

在 Mac 上听写时怎么换行?

在一句话说完时,说 new line 是换行,说 new paragraph 是空一行。两者都不需要 insert,说 tab key 会输入一个制表符。

在 Mac 上听写时怎么删掉一个词?

听写的内容刚输入后,在 30 秒内把 scratch that 作为单独的一次听写说出来,YapToText 就会把它删除。要改正一个词,依次说 replace、错的词、with、对的词。

为什么 period 变成了单词而不是句点?

period 是单个词,所以在 insert 设置打开时,要说 insert period。如果想直接说,可以在 Commands 页面把这个设置关掉。

在 Mac 上可以听写表情符号吗?

可以。YapToText 有 158 个口述的表情符号名称,比如 fire emoji 和 thumbs up。insert 设置打开时,说 insert fire emoji,表情符号就会出现。