mori-ear

安裝路徑

兩種路徑,挑一個:預編譯 binary(快、不用 Rust 工具鍊)或從原始碼。

Windows · 預編譯

設 Groq key:setx GROQ_API_KEY gsk_xxxxx
從 Actions 抓最新 mori-ear-windows-x86_64.zip,解壓到固定路徑。
跑 install-autostart.ps1(會彈 UAC,點是)→ 登入後自動啟動。
立即啟動:Start-Process .\mori-ear.exe

從原始碼?→

Linux · 預編譯(X11)

設 key + paste-back deps:
export GROQ_API_KEY=gsk_xxxxx
sudo apt install xclip xdotool
從 Actions 抓 mori-ear-linux-x86_64.tar.gz,tar -xzf … 後 install -m 755 mori-ear ~/.local/bin/。
登入自動啟動:bash scripts/install-autostart.sh
立即啟動:mori-ear &

從原始碼?→

從原始碼建置

裝 Rust。Windows 加裝 MSVC C++ Build Tools(rustup-init 會提示);Linux 加 libasound2-dev libx11-dev xclip xdotool。
git clone https://github.com/yazelin/mori-ear && cd mori-ear
cargo install --path . — binary 進 ~/.cargo/bin/。
依平台跑 scripts/install-autostart.{ps1,sh} 設登入自動啟動。

完整 README →

使用

按住 Ctrl+Alt+E

開麥克風錄音

講話

繁中、英文、混講都可

放開

Whisper STT + cleanup LLM

字貼進焦點視窗

clipboard + Ctrl+V(terminal 自動切 +Shift)

特性

全域熱鍵

任何視窗按 Ctrl+Alt+E 就講話。可改 ~/.mori/ear.json 的 hotkey 欄位。

自動貼回焦點視窗

Win32 clipboard + SendInput,Linux 走 xclip + xdotool。Terminal 自動偵測切 Ctrl+Shift+V。

Groq Whisper 後端

快(~1.5s for 3s 音檔)、便宜、繁中支援良好。Groq key 跟 mori-desktop 共用。

繁中校正 LLM

Whisper 簡體輸出 + 偶爾幻覺出 YouTube 結尾語 — cleanup LLM 二次處理,清掉雜訊、轉繁體。

設定

~/.mori/ear.json(可選,partial merge — 沒寫的欄位從 ~/.mori/config.json / 預設補):

{
  "hotkey": "Ctrl+Alt+E",
  "groq_api_key": "gsk_...",
  "language": "zh",
  "raw": false
}

hotkey:任意組合,被其他程式佔用會 register 失敗 — 換一組(例 Ctrl+Shift+V / Ctrl+Alt+Y)。

groq_api_key:留空時 fallback ~/.mori/config.json 的 providers.groq.api_key,再 fallback 環境變數 GROQ_API_KEY。

language:空 = 自動偵測。zh / en / 其他 ISO 639-1。

raw:true = 跳過 cleanup LLM,直接送 raw Whisper 輸出。省 ~200ms / 一輪 token,但會有錯字 / 簡體。

平台支援

環境	hotkey	paste-back	備註
Windows	✓	✓	主要驗證環境;Win32 SetClipboardData + SendInput Ctrl+V
Linux X11	✓	✓	xclip + xdotool ctrl+v,Terminal 自動偵測切 +Shift
Linux Wayland	⚠ 部分	⚠ 部分	XWayland 兜底:只能跟 X11 視窗互動。完整支援要 `ashpd` + `ydotool/wtype`
macOS	✓(理論)	✓(理論)	第一次跑要授權 Accessibility;paste-back 走 enigo `text()` 逐字 fallback

環境

hotkey

paste-back

備註

Windows

✓

主要驗證環境;Win32 SetClipboardData + SendInput Ctrl+V

Linux X11

✓

xclip + xdotool ctrl+v,Terminal 自動偵測切 +Shift

Linux Wayland

⚠ 部分

XWayland 兜底:只能跟 X11 視窗互動。完整支援要 ashpd + ydotool/wtype

macOS

✓(理論)

第一次跑要授權 Accessibility;paste-back 走 enigo text() 逐字 fallback

快速開始