换 Mac 听写 App：迁移与验收清单

换听写 App，稳妥的做法是保留旧配置，先迁移一小组有用词条，再到真正使用的地方验收。在备忘录里演示成功，不能证明终端、中英术语和剪贴板都会符合需求。

无论从 Wispr Flow、superwhisper、Typeless 还是其他工具切换，都可以用这份清单。Ducduc 步骤基于核对的源码版本，不承诺自动导入这些产品的数据。

卸载之前，保存会舍不得丢的内容

旧 App 还能打开时，保存一份可读资料：

内容	保存什么	在 Ducduc 怎样处理
词表	姓名、产品和术语的准确拼写	个人词典逐条添加
替换规则	错词 → 目标词，以及 App 范围	逐条审核后创建精确替换
片段或提示词	触发短语与完整内容	主动重建，不属于词典导入
工作流设置	按键、点按或按住、语言、麦克风、力度	在设置中重新配置
需要的历史	通过旧 App 支持的方法保存相关文字	不承诺竞品历史导入
账单	续费日期、购买渠道、许可证资料	与复制 App 数据分开处理

旧 App 支持导出就使用；否则保存可读的手动列表。不能因为有「导入」就假设也有导出。

格式并不通用。Wispr Flow 文档说明词典用 CSV 导入、片段用 JSON；VoiceInk 文档说明词汇和替换规则可导出为 JSON。这两种格式都不会自动成为 Ducduc 备份。

Ducduc **导入…**要求自己的词典备份结构。把竞品文件改名成 .json 不会转换格式。核对的词典界面没有通用 CSV 或批量粘贴导入。如果有几百个词，要预留手动录入时间，不能假设一键完成。

保存旧设置后，完全退出旧 App，测试期间暂停它的自动启动。两个工具监听同一个键，会让排查结果混乱。验收通过前保留安装与备份，方便回退。

先配置不冲突的触发键

Ducduc 支持点一下开始、再点结束，也支持按住录音。在设置 → 听写查看当前键，不要假设一定是 fn。

新安装以 fn 为默认候选；macOS 已把它分给表情、切换输入法或系统听写等动作时，Ducduc 可改选右 ⌘ Command。其他 App 和改键工具仍可能使用该键，要测试自己的键盘环境。

想用 fn，可在系统设置 → 键盘 → 按下 fn/🌐 键时按工作习惯选择不执行操作。Ducduc 还提供右侧修饰键和自定义快捷键。它会检查自己的按键冲突，但无法知道其他所有 App 的组合键。参见 fn 到底归谁。

授予权限，再验证识别

Ducduc 设置需要麦克风、语音识别、辅助功能，入口在系统设置 → 隐私与安全性。前两项支持识别，辅助功能支持全局触发和向其他 App 插入。

macOS 14–15 在键盘 → 听写 → 语言安装对应资源。经典 Ducduc 引擎要求本机处理，缺资源不会静默改走服务器；macOS 26 的新路径可以请求下载语音资源。系统入口参见 Apple 听写指南。

先在简单原生输入框测试。完全不开始录音，查按键和辅助功能；开始听但没有原稿，查麦克风、语音权限和语言资源；复制卡片已经有文字但粘不进去，先查插入，不要急着换识别模型。语言资源排查有具体顺序。

按含义迁移词表，不按扩展名迁移

菜单栏选词典，或设置 → 清稿 → 管理个人词典…。在新词输入后回车，先加入每天会用的姓名和技术术语。

三种机制要分开：

• 词典提供识别或清稿候选，不重新训练 Apple 引擎，也不保证每次正确。
• 精确替换是主动设置的本地整词、短语规则，可选所有 App或指定 App。
• 学习到的纠错来自符合条件的修改和口述纠正；是否能读取输入框、近音和上下文检查、App 范围都会影响结果，改过文字不等于一定保存成规则。

旧 App 的规则在新流程中可能太宽。例如假设有 stage → staging，它可能帮助项目笔记，却破坏「stage two」。应限制范围或不迁移，不能盲目复制全部规则。检查学错的纠错对并删除。词典指南说明具体保护机制。

词表整理好后，**备份 → 导出…**保存 Ducduc 词条和纠错记录；导入会合并已有内容。它不是包含历史、模型档案、API Key 和全部设置的完整备份，也不会建立账号自动同步。

先确定清稿路径，再比较质量

在设置 → 模型明确选择内置云端、自己的服务商，或本地 Ollama。

需要本地清稿时，核对真正下载的本地模型和回环地址，点使用本地模型并确认离线。只选 Hybrid 备用模型，云端仍开着。Ollama 自己也支持云模型，仅凭端点名称不够。按本地设置指南关闭云功能，并断网测试。

比较两款 App 时，使用同一麦克风、目标语言和大致相当的清稿力度。分别记录原始识别与成稿，否则很容易把识别错误和清稿改写混为一谈。

在真实 App 跑一组小验收

下面是样例输入，不是实测输出，也不表示所有模型都能通过：

情况	试什么	验收条件
口头反悔	「周四评审，不对，周五。不要发布。」	保留周五与否定
数字	「限额是 15，不是 50。」	不改数字和否定
中英混说	「我用 Claude Code 写了一个 component。」	保留英文术语和中文含义
自己的名称	用已添加词条说一句短句	拼写有用，不编额外内容
目标 App	备忘录、浏览器编辑器、聊天、智能体输入框	目标和格式正确，不意外提交

再用无敏感内容检查恢复路径：

1. 剪贴板：复制一个标记，自动插入听写，再到别处粘贴。没有中途复制新内容时，应恢复先前剪贴板；复制卡片上的复制是主动操作，会把听写留在剪贴板。
2. **切 App：**录音中切换 App，应提供复制文字，而不是贴到意外目标。
3. **安全输入：**测试日常终端。安全键盘输入可能阻止监听或自动粘贴；能开始录音但不能插入时，用复制卡片。参见 Apple 终端指南。
4. **离线：**所有资源装好后断开活动网络路径，确认本地清稿成功，或保留原稿并提示失败。这验证当次，不代表以后所有联网行为。
5. **清稿不可用：**离线模式下停止 Ollama，确认文字仍能取回，重启后再测恢复。

记录 App build、模型、设置和失败情况。一次只改一项设置再复测。这是支持自己选择的方法，不是通用准确率排行榜。

重要场景通过后，再完成切换

新 App 满足需求后，恢复它的自动启动；到旧服务的购买渠道核对续费或取消确认。订阅管理与移除 App 是两件事。备份保留到确认新词典和工作流完整为止。

Ducduc 免费使用无需账号，Pro 用许可证激活。内置免费清稿为每周 8,000 词，第一次内置云清稿开始 14 天试用。当前条款与成本见不订阅的成本指南。

没有账号不等于没有云处理。本机保留历史和词典，云清稿仍把相关文字发到所选服务，目标 App 也可能同步或提交。迁移敏感工作前，检查完整数据路径。