~/spellkey — DETAILS.md EN ← 首页 [ 获取 ]
man spellkey

更多细节

一句话卖点在首页。这里是底层的全部:语音引擎、AI 怎么跑、每一处能调的地方,以及大家常问的问题。

spellkey --engines

三种语音引擎,按需求挑

识别全程在你的 Mac 上跑。先用内置那个,随时在设置里切换,不用重装。

引擎大小强项状态
SenseVoice 228 MB 最快(~0.06s)。中文优先,一句话里中 / 英 / 日 / 韩 / 粤混着说都行。 随包内置 · 默认
FireRed 约 740 MB 长录音、方言更稳。 可免费下载
Qwen3-ASR 约 1.8 GB 中英混读最准。覆盖 30 种语言 + 22 种中文方言口音。内存稳定不涨,你的词表还能当内置热词。 可免费下载
spellkey --ai

AI 整理:本地跑,或用你自己的 key

AI 模式(去口水词整理、写邮件、对选中文字动手、翻译)有两种跑法。

本地

本地模型 · Qwen3-4B

在你的 Mac 上跑,离线、免费。只在整理那几秒临时加载,空闲时不占内存。

按意图分流:快速整理约 1.7s;说「帮我写封邮件」会多想约 10s。

byok

自备 API key

填任意 OpenAI 兼容接口,速度和质量拉满。

密钥锁在 macOS 钥匙串里,不上传、也不写进日志。

后端逐级尝试:BYOK本地 Qwen正则兜底。哪级失败就往下退,绝不丢你说的话。

spellkey --settings

调成你顺手的样子

几乎处处能调,而且都用大白话写清楚,每个开关都告诉你「打开会发生什么」。

触发键
任意改键右 ⌥ / ⌘ / ⇧、右 Control、F1–F19,或你自己定。
录音中切模式快速键起录,点 AI 键结束,就按 AI 模式出字。
录音上限到你设的时长(30s–3m)自动结束,麦克风绝不一直开着。
出字管道
过滤水词去掉「呃 / 那个 / 就是」这类口头语。词表可编辑。
撤回检测说「算了不要了」整段作废。撤回短语可编辑。
高频错词表纠常被听错的名字(Claude、SpellKey…),还会喂给引擎当热词。
中文输出统一简体或繁体。中文数字归一成阿拉伯数字。
灵动岛与翻译
灵动岛皮肤四款:磨砂白、纯黑刘海、蓝白、紫白。可随手拖到任意位置。
翻译独立触发键,说一段直接翻成 30 种语言之一。
选中模式对选中文字动手,结果在灵动岛上停留时长可调。
Agent 终端
终端在 Terminal 或 iTerm2、你指定的工作目录里启动。
上下文可把选中的文字、或 Finder 选中的文件一并当上下文带上。
spellkey --faq

你可能想问的

要联网吗?
日常全程本地、断网照用,语音转写、AI 整理、翻译都在你的 Mac 上跑。只有购买后首次激活需要联网一次,验证激活码,之后离线也能用。
我的录音会上传吗?
不会。录音和识别全在这台 Mac 上完成,音频不出本机、也不落盘。最近记录只在内存里,关软件就没了。
支持哪些语言?
默认的 SenseVoice 引擎支持中、英、日、韩、粤五种,可以在一句话里混着说。想要更强可切 Qwen3-ASR,覆盖 30 种语言外加 22 种中文方言口音,中英混读也最准。另有独立翻译键,说一段直接翻成设定的目标语种,30 多种任选。
需要 API Key 吗?
不用。AI 整理、翻译可以一键下载本地离线模型来做,下好之后断网照样跑;也可以填自己的云端 API Key,密钥锁在 macOS 钥匙串里,开发者碰不到。
和系统自带听写比呢?
本地识别更快更准,中英混说没问题,点一下自动加标点落字。还能帮你写东西、翻译,而且全程不依赖网络。
Intel Mac 能用吗?
目前只支持 Apple Silicon(M 系列芯片)+ macOS 14 以上。本地模型需要 M 系列芯片来保证速度和流畅度。
退款政策是怎样的?
14 天无理由退款。不合适?原路退回,不问缘由,见退款政策

整台机器就这些。

一次买断、终身授权、14 天退款。

[ 获取 SpellKey ]