Trie 命令行原生的离线语音输入法

Install

安装手册

当前版本 0.5.0。整个过程在「终端」里完成，一条命令，按提示回答两三个问题。

开始之前

Mac
Apple Silicon（M 系列芯片），macOS 14 或更新版本。
内存
至少 16 GB 内存。两个模型载入后约占 8 GB，8 GB 内存的 Mac 会整机失去响应；内存不够时安装脚本在下载任何东西之前就会停下。
空间
约 8 GB：两个模型合计约 7 GB，Python 依赖几百 MB。
网络
只在安装时需要：下载 Trie、Python 依赖和模型。装好之后听写不联网。
权限
不需要管理员密码。

安装

  1. 打开「终端」

    按 Command + 空格，输入「终端」或 Terminal，回车。

  2. 粘贴这条命令，回车

    curl -fsSL https://trie.ai/install.sh | sh

    脚本会依次：检查系统；下载 Trie 并校验（文件指纹与开发者签名都要对上，否则中止）；装到「应用程序」；建立独立的 Python 环境。

  3. 按提示回答

    如果电脑上没有 uv（用来建立 Python 环境的工具），脚本会问是否安装它。

    接着会问是否下载两个模型，约 7 GB。回答 y 后等待下载完成；也可以先跳过，之后重新运行同一条命令补上。

  4. 允许三项权限

    装完后 Trie 会自动打开。第一次使用时系统会请求下面三项权限，请都允许。错过了弹窗，可以到「系统设置 → 隐私与安全性」里手动打开。

    麦克风
    听你说话。
    辅助功能
    把文字贴进当前输入框。
    输入监控
    识别「单独按一下右 Command」。

  5. 试一下

    点到任意一个能输入文字的地方，单独按一下右 Command（⌘），说一句话，再按一下。文字会贴进输入框。

回退到上一版

升级时脚本会把被替换的那一版保留在 ~/Library/Application Support/Trie/previous/（只保留一版）；再次安装同一版本不会覆盖真正的上一版。新版本用起来有问题时，运行：

curl -fsSL https://trie.ai/install.sh | sh -s -- --rollback

脚本会把保留的上一版换回来，按那一版自带的依赖清单重建 Python 环境，再重新检查模型。升级或回退中途失败时，应用和 Python 环境会一起放回操作前的位置，两者都放回才说「已恢复」；环境没能放回时会如实说明「Python 环境可能不完整，请重新运行安装命令」。回退中环境建立失败会回到回退前的状态，说明「回退没有完成」，可以再次运行 --rollback 重试；模型没通过只警告，不影响回退。回退完成后会自动打开换回来的那一版；设置 TRIE_NO_OPEN=1、或这台 Mac 的内存低于要求时不打开，脚本会说明应用的位置。没有上一版时脚本会说明并停下，现有的安装不受影响。回退之后重新运行安装命令即可升级到最新版。

常见情况

模型下载很慢
模型来自 huggingface.co。访问困难时，先设置镜像地址再运行安装命令：export HF_ENDPOINT=镜像地址。下载中断后重新运行即可继续。
浮层显示「不可用」
多半是模型还没下载完，或麦克风权限没有允许。重新运行安装命令会再检查一遍模型。
按右 Command 没反应
检查「辅助功能」和「输入监控」里 Trie 是否已打开；改过权限后退出并重新打开 Trie。
为什么不提供直接下载
Trie 已用 Apple 的 Developer ID 签名，公证仍在 Apple 处理中。公证完成之前，从浏览器下载的应用会被系统拦下，所以目前只提供命令行安装。
文字没有自动贴进去
结束后切换了窗口，或正在密码框中输入，文字只复制到剪贴板，不自动粘贴；粘贴后会恢复原来的剪贴板。Trie 不会替你按回车。
想取消这次听写
按 Command + 句号（⌘ .）或 Esc，收音、整理期间都有效。开始后 8 秒没有说话会自动取消；每段最长 3 分钟。
升级
重新运行同一条安装命令。模型与个人设置都会保留，权限不需要重新授予。
卸载
curl -fsSL https://trie.ai/install.sh | sh -s -- --uninstall
日志
~/Library/Logs/Trie/。只有事件与字数，没有你说的内容。

回到首页