mori-ear

全域熱鍵 → 錄音 → STT → 焦點視窗

Mori 宇宙的「耳朵」器官 — 極簡 CLI。獨立於 mori-desktop(身體 / GUI), 身體重啟時耳朵還在聽。

快速開始

已經有 Rust + Groq API key?一行裝完跑起來。

cargo install --path . && 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 →

Linux 便利:`ear` 一鍵 wrapper

把「裝 / 啟 / 停 / 解除」收成一個指令 + GNOME 全域 toggle 快捷鍵。Linux + GNOME 主測;KDE / XFCE / Sway 自動 skip keybind 層,其他層照常 work。

git clone https://github.com/yazelin/mori-ear
cd mori-ear
ln -s "$PWD/scripts/ear.sh" ~/.local/bin/ear
ear install

ear install 自動跑 cargo install + XDG autostart + GNOME 快捷鍵 + 啟動 四層,idempotent — 已裝的會跳過。

ear(無參數) — toggle on/off,等同按 Ctrl+Shift+Alt+E
ear on / off / status / log — 明確開關、看 process + 各層安裝狀態、tail log
ear autostart on|off — 只動開機自動啟用(不動 binary / 快捷鍵)
ear keybind on|off — 只動 GNOME Ctrl+Shift+Alt+E 快捷鍵(不動其他層)
ear uninstall — 反過來全套拆(會確認;--yes 跳過 prompt)

使用

按住 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,
  "cleanup_prompt_file": "~/.mori/voice_input/USER-00.純文字輸入.md",
  "paste_back": true
}

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,但會有錯字 / 簡體。
cleanup_prompt_file:cleanup LLM 的 system prompt 來源 .md / .txt 路徑(支援 ~/)。空 / 檔不存在 → fallback 內建。每次 cleanup live-read,改 prompt 不必重啟。指向 mori-desktop 的 USER-00.純文字輸入.md 可共用同一份。
paste_back:true(預設)同時印 stdout + 貼焦點視窗;false 只印 stdout,不碰 clipboard。pipe / headless 場景設 false。

Batch / pipe 模式

不按熱鍵,直接餵音檔(wav / mp3 / m4a / flac / webm / ogg)轉文字到 stdout。跟 daemon 模式互不衝突。

mori-ear --input recording.wav > out.txt
mori-ear --input clip.wav | translate -t en

平台支援

環境	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