Tidytalk 使用指南：Mac 语音输入从安装到进阶

安装和设置

Tidytalk 需要 macOS 26 或更高版本、Apple 芯片的 Mac。

在 GitHub Releases 下载最新的 Tidytalk-x.y.z.dmg，打开后把 Tidytalk 拖进 Applications 文件夹。
安装包目前没有经过苹果公证，第一次打开会被系统拦下。打开"系统设置 › 隐私与安全性"，在页面底部点"仍要打开"；或者在终端执行：
```
xattr -dr com.apple.quarantine /Applications/Tidytalk.app
```
按首次启动的引导完成：
- 授权麦克风：用于录音。
- 授权辅助功能：用于监听快捷键，并把文字粘贴到光标处。
- 配置 AI：填写 OpenAI 兼容接口的地址、API Key 和模型，默认 DeepSeek。可以跳过，跳过后直接输出识别结果。
- 下载语音识别模型：约 240 MB，只需下载一次，之后识别不用联网。

Tidytalk 平时只在菜单栏显示图标，只有打开引导或设置窗口时才会出现在 Dock 里。设置、最近记录和输出语言都在菜单栏图标里。

按住说话

在任意输入框里放好光标。
按住 Option + Command 说话。屏幕底部会出现一个玻璃质感的指示器，随音量跳动。
说完松开，稍等片刻，整理好的文字出现在光标处。

按住约 0.4 秒才开始录音，日常按 Option + Command + 某个键的快捷键不会误触发。
按住期间按下其他键、点击鼠标或按 Esc，会取消本次录音。
单次录音最长约 2 分钟，不足 0.5 秒的录音会被忽略。
快捷键可以在"设置 › 录音"里换成 Control、Option、Command、Fn（🌐）、右侧 Option 或右侧 Command。选 Fn 时，要在"系统设置 › 键盘"里把"按下 🌐 键时"设为"无操作"，否则会同时弹出表情或听写。
说话时指示器下方会显示实时文字，这只是预览，最终结果在松开后整段识别、整理再粘贴。
当前没有可以输入的地方时（例如焦点在桌面或网页正文上），结果会放进剪贴板，而不是模拟粘贴。
粘贴完成后，剪贴板会恢复成原来的内容，图片、文件和富文本也会完整恢复。

免按住录音

快速双击快捷键，开始录音后就可以松手，适合说较长的内容；再按一次快捷键结束，按 Esc 取消。录音期间打字、点击鼠标不会打断录音。可以在"设置 › 录音"里关闭。

语音改写选中的文字

先选中一段文字，按住右侧 Option说出修改要求，例如"改得正式一点""缩短到一句话""翻译成英文"，松开后选中的文字会被替换成改写结果。

需要配置 AI；选中的文字和修改要求会发送给 AI 服务。
没有选中文字时会提示先选中；改写失败时原文不会改动。
改写键可以在"设置 › 录音"里更换或关闭。

整理效果

整理只做删减和修正，不改变你说的内容：

删除没有实际含义的填充词，例如：嗯、呃、那个、就是说、um、uh、like。
删除重复的词句和口误；中途改口时，只保留改口后的说法。
补全标点，必要时断句。
不总结、不补充，保持原文的语气；句中的英文单词和术语原样保留。
即使你说的话听起来像指令（比如"帮我写一封邮件"），也只会被整理成文字，不会被执行。

你说的	输出
嗯那个我想问一下就是这个 API 的那个 rate limit 呃是多少	我想问一下这个 API 的 rate limit 是多少？
项目要延期到下周三，不对，是下周四	项目要延期到下周四。

在"设置 › 配置 AI"里关闭"整理文字"后，直接输出识别结果，应用完全离线工作。AI 服务超时、连不上或返回异常时，会粘贴识别原文并给出提示。

整理强度和模式

都在"设置 › 配置 AI › 整理方式"里切换。

强度	效果
轻度	只补全标点、删除"嗯、呃"这类语气词，其余原话保留
标准（默认）	删除填充词和口误，补全标点
深度	在标准基础上进一步精简啰嗦、重复的表达，但不改变原意

模式	效果
标准（默认）	删除填充词、修正口误、补全标点，保持原意
聊天（口语）	保持口语化的语气，保留句末语气词
邮件（书面）	使用书面表达，句子完整
代码（保留术语）	严格保留术语、命令、文件名和符号，不转换标点

输出语言

默认"与原文相同"。选择其他语言后，说中文或英文，整理时直接翻译，例如说中文、粘贴出英文邮件。支持英文、简体中文、繁体中文、日文、韩文、法文、德文和西班牙文。

在"设置 › 配置 AI › 整理方式"里修改，也可以在菜单栏图标的"输出语言"子菜单里快速切换。
翻译和整理在同一次请求里完成，速度和只整理差不多；词库和整理模式同样生效。
翻译需要开启"整理文字"，请求失败时粘贴原文。

更多例子见说中文，直接出英文。

本机大模型

Tidytalk 用 OpenAI 兼容协议连接 AI 服务，所以也能接本机运行的模型，文字不会离开电脑：

安装 Ollama 并下载一个模型，例如 ollama pull qwen2.5:7b；或者在 LM Studio 里下载并加载模型，打开本地服务。
在"设置 › 配置 AI"里点"预设"，选"Ollama（本机）"或"LM Studio（本机）"，确认模型名后保存。本机模型不需要 API Key，超时默认放宽到 60 秒。
点"测试连接"确认可用。

效果取决于模型大小。小模型对"只整理、不回答"和自定义规则的遵守不如云端模型稳定，建议用 7B 左右或更大的模型。详见完全离线的 Mac 语音输入。

词库

都在"设置 › 词库"里。

常用词

每行一个人名、产品名或专业术语，这些词最容易识别错。它们会放进 AI 整理的提示里，让模型把读音相近的错误识别改成正确写法，例如"森斯沃伊斯"改为"SenseVoice"。需要开启"整理文字"。

固定替换

识别结果里出现某个词时，总是替换成指定写法，例如"克劳德"总是替换成"Claude"。英文不区分大小写，只匹配完整单词。在本机处理，关闭整理时也生效。在菜单栏图标的"最近记录"里选一条，点"加入词库…"，可以直接把识别错的词加进来。

快捷短语

例如"我的邮箱"对应完整的邮箱地址。整句话只说这个短语时，直接输出设置好的内容；句子中间提到这个短语不会被替换。

自定义规则

每行写一条自己的写法要求，例如"金额一律用阿拉伯数字""产品名写作 Tidytalk"。AI 整理和语音改写时都会遵守；规则只影响写法，不会让 AI 补充原文没有的内容。最多 20 条。

中英文排版规范

在本机自动处理：中文与英文、数字之间加空格；中文后面的标点统一为全角；全角字母和数字转为半角。数字里的小数点、文件名、网址等不受影响。可以在"设置 › 通用"里关闭。

支持的语言

说话时不需要选择语言，识别会自动判断：

中文普通话，包括句中夹杂的英文单词和技术术语
英文
日文
韩文
粤语（识别结果用简体字，保留粤语的说法）

暂不支持其他语言和方言。需要输出法文、德文、西班牙文时，可以用中文或英文说，再设置输出语言。界面支持简体中文和英文，跟随系统语言。

常见问题

情况	原因和处理
提示"整理失败，已粘贴原文"	AI 服务连不上、超时或返回异常。检查网络，在"设置 › 配置 AI"里点"测试连接"。
提示"没有听到内容"	没有识别到内容。在"设置 › 录音"里检查麦克风。
按快捷键没反应	缺少辅助功能权限，在"设置 › 权限"里授权。
打开时提示无法验证开发者	安装包还没有公证，在"系统设置 › 隐私与安全性"里点"仍要打开"。

辅助功能一直显示未授权

系统设置里已经打开了 Tidytalk 的开关，应用却仍显示未授权，通常是列表里留着旧版本的条目。在"系统设置 › 隐私与安全性 › 辅助功能"里选中 Tidytalk 点"−"删除，再回到 Tidytalk 点"授权"重新添加；或者在终端执行：

tccutil reset Accessibility app.tidytalk.Tidytalk

所有设置都保存在 ~/.tidytalk.json，也可以直接编辑，字段说明见配置文件文档。

卸载

把 Tidytalk 拖进废纸篓只会删除应用本身，语音识别模型、配置和授权记录都会留在电脑上。完整卸载：先退出 Tidytalk（开启过开机自动启动的话先关掉），把应用拖进废纸篓，再在终端执行：

rm -rf ~/Library/Application\ Support/Tidytalk
rm -f ~/.tidytalk.json
rm -rf ~/Library/Caches/app.tidytalk.Tidytalk ~/Library/HTTPStorages/app.tidytalk.Tidytalk
defaults delete app.tidytalk.Tidytalk
tccutil reset All app.tidytalk.Tidytalk

这几行依次删除语音识别模型（约 240 MB）、配置文件（含 API Key）、联网缓存、系统偏好，以及麦克风和辅助功能授权。打算以后重装、想保留设置的话，可以不删 ~/.tidytalk.json。