這是 fork。 原作 nick1ee/ZeroType 自 2026-03 起未再更新,PR 也無人審查,故另行維護。以下連結皆以本 repo 為準。
Windows-only:目前維護者只有 Windows 環境,
macos/平台程式碼已於 2026-08 移除(git 歷史可尋回),Release 只提供 Windows build。需要 macOS 支援請回頭參考原作 repo。
一個繁體中文語音輸入工具。按下快捷鍵講話,文字直接貼到游標所在的地方。
辨識可以走雲端 API,也可以完全在自己的 GPU 上跑。
- 全局快捷鍵錄音 — 在任何程式裡按
Alt + Z開始,再按一次結束。另有精簡模式(Alt + X):講完安靜 1.5 秒自動結束並補Enter送出。錄音中有浮動音波提示,Esc取消。 - 多種辨識後端 — OpenAI、Azure OpenAI、Google Gemini、OpenRouter(一把 Key 通吃多家模型),以及本機辨識:不需要 API Key、不產生費用,音檔與文字都不出這台電腦。
- 只錄到噪音就不送辨識 — 用動態範圍(最大聲的一成 ÷ 最安靜的一成)判斷有沒有人在講話。沒人聲的錄音送給 AI,它不會回「沒聽到」,而是憑空編一整段內容出來。
- 轉錄,不代寫 — 只做最小限度的整理:剔除停頓詞、自動標點、中英混用保留原文不翻譯。規則沒明講要改的一律照原話輸出。命令詞只有「更正」與「換行」兩個。
- 自訂字典 — 人名、品牌、術語寫進字典,以拼寫校正的方式套用(發音相同且字數相同才替換),不會被憑空插入輸出。
- 常用詞彙選擇器 — 同一句話不必再講第二次:按
Alt + C叫出浮窗,打字過濾、Enter直接貼上。 - 設定 — 深色/淺色、開機自動啟動、快捷鍵自訂、提示音、辨識紀錄與費用統計。關閉鍵等於縮到系統匣,程式在背景待命。
- 系統:Windows 10/11。自行 build 需要 Flutter 3.x。
- 權限:麥克風。
- API Key(用雲端辨識才需要):OpenAI、Google AI Studio 或 OpenRouter。Azure OpenAI 另外要填資源端點,模型名稱要和部署名稱相同。
- 本機辨識:需要另外安裝辨識端點(見下方安裝本機辨識)與一張 NVIDIA 顯示卡,模型常駐會佔用 VRAM。
- 到 Releases 下載最新版 zip
- 解壓縮後執行
zero_type.exe(DLL 與data資料夾要留在同一層) - 依提示授予麥克風權限
- 在「模型設定」選服務商並填 API Key
git clone https://github.com/DaveTseng2019/ZeroType.git
cd ZeroType
flutter pub get
flutter run -d windows # 開發模式
flutter build windows --release # 正式版專案不使用任何程式碼產生器(無 build_runner),
pub get完直接跑。
只用雲端 API 的話跳過這一節。
本機辨識靠一個獨立的辨識端點 LocalSTT,它把 MOSS-Transcribe-Diarize 0.9B(Apache-2.0)包成 OpenAI 相容的轉寫 API。這個端點不隨 ZeroType 一起發布,模型權重與 Python 環境合計數 GB,要自己裝。
需要:NVIDIA 顯示卡、Python 3.12、uv、git。
cd $env:USERPROFILE
git clone https://github.com/DaveTseng2019/LocalSTT.git
cd LocalSTT
git clone https://github.com/OpenMOSS/MOSS-Transcribe-Diarize.git repo
cd repo
uv venv --python 3.12
uv pip install torch --index-url https://download.pytorch.org/whl/cu129
uv pip install -e .
uv pip install fastapi uvicorn python-multipart opencc裝好之後回到 ZeroType 的「模型設定 → 本機」,按「啟動」。首次啟動會自動從 Hugging Face 下載權重,之後每次載入模型約 10 秒。
幾件事值得先知道:
- 放在
%USERPROFILE%\LocalSTT就不必填任何設定。 ZeroType 也會找執行檔旁邊與%LOCALAPPDATA%。放在別處的人用「啟動設定(進階)」自己指定程式路徑。 - 偵測的依據是資料夾裡有沒有
shim.py,直譯器固定取repo\.venv\Scripts\python.exe。 - 端點預設監聽
http://127.0.0.1:8123,只聽本機。 - 不用的時候按「停止」就把 VRAM 收回來。
- 每個本機模型各有一份啟動設定。「模型」選單換了模型,就改用那個模型的設定;端點正在執行時會自動重新啟動(重新載入約 20 秒)。第一次用某個模型時,先在「啟動設定(進階)」填好它的程式與參數。
詳細說明與熱詞行為看 LocalSTT 的 README。
到 Releases 下載新版覆蓋舊的執行檔,或在 App 內「設定 → 關於」點「下載更新」。設定與歷史紀錄存在使用者資料目錄,覆蓋不會遺失。
每一版改了什麼,看 Releases 頁面。
- 主要針對台灣使用情境設計,輸出以繁體中文與英文為主。
- 有問題或建議歡迎在 本 repo 發 Issue 或 Pull Request。