Mori

DOCS

Getting Started

INSTALL · DEV · FIRST RUN

從 0 到 Mori 在你 Ubuntu 上跑起來 — 三步驟。

支援平台:Linux / Windows / macOS。

1. 系統需求

Ubuntu 26.04 一條龍 setup script: yazelin/ubuntu-26.04-setup 

./setup-rust.sh           # Rust toolchain
./setup-tauri-deps.sh     # WebKitGTK + ALSA + tray libs
./setup-wayland-input.sh  # wl-clipboard + ydotool daemon

Linux 裝完要重開機一次 讓 input group 生效(ydotool 需要)。 Windows / macOS 不必。

2. Clone + Build

git clone https://github.com/yazelin/mori-desktop.git
cd mori-desktop

npm install
npm run build             # 建 dist/ — tauri::generate_context!() 編譯時會檢查這路徑
cargo build --workspace   # workspace 才會 build mori-cli (Bash CLI proxy 需要)
順序不能換:cargo build 編 mori-tauri 時, tauri::generate_context!() 巨集會驗證 tauri.conf.json 的 frontendDist(../../dist)路徑存在,所以前端 dist/ 必須先建好。fresh clone 直接跑 cargo build 會炸 The `frontendDist` configuration is set to "../../dist" but this path doesn't exist。

3. 跑 Dev 模式

npm run tauri dev

第一次 build 在 Intel Ultra 上 ~3 分鐘。之後 incremental ~10 秒。

注意:npm run tauri dev 只 build mori-tauri。 mori CLI(Bash CLI proxy 用)要另外跑 cargo build -p mori-cli, binary 在 target/debug/mori。

主畫面截圖

主視窗 = sidebar shell(7 個 tab:Chat / Profiles / Config / Memory / Annuli / Skills / Deps / Logs)+ 桌面常駐 floating sprite + Ctrl+Alt+P picker overlay。

主視窗 Dark theme
主視窗 · Mori Dark theme — Whisper 收音不佳時 Mori 老實察覺(不假裝聽懂)
主視窗 Light theme
主視窗 · Mori Light theme(空 state)
Profile Picker
Ctrl+Alt+P Profile Picker
Floating Mori sprite
桌面常駐 sprite + chat bubble
Config Theme picker
Config · Theme picker
Recording state
Floating sprite · 錄音中(藍水波 + profile chip)
Thinking state
Floating sprite · 轉錄 / 思考中(綠雙環)

第一次啟動會發生的事

  1. 權限對話框:Linux GNOME Wayland 跳「全域熱鍵」對話框 — 點「新增(Add)」。 X11 / Windows / macOS 直接 grab 不會跳。誤點拒絕 / Wayland portal 太舊的修法見 Troubleshooting → 全域熱鍵
  2. ~/.mori/ 建立:
  3. 宿靈儀式(Quickstart):第一次啟動跳 modal,2 個模式擇一(詳見): 這版會問:使用者名 / Groq API key / LLM provider key / starter 語系(中文預設,可選英文 — 詳見 tokenizer 對比)。Direct mode 偵測到 OS env var 設好的 key 會自動彈 banner,讓 you 一鍵跳過手填。
  4. 主視窗顯示:sidebar shell + 桌面右下 floating sprite(160×160)
  5. 第一次按 Ctrl+Alt+Space:錄音 → STT → 走 active profile pipeline。 若 provider 沒設好會在 Logs tab 看到 spawn_error / llm_call ok=false 等 event。 除錯一律先看 Logs tab(v0.4.0+ 自動寫 ~/.mori/logs/mori-YYYY-MM-DD.jsonl)。

基本操作流程

裝完 + provider 設好以後,日常用法 4 個鍵打天下:

  1. 選 mode(每按一次就鎖在那個 mode 直到再切):
  2. 錄音 + 送出 Ctrl+Alt+Space:
  3. 中斷 Ctrl+Alt+Esc:
  4. 不記 slot 數字就用 picker overlay:Ctrl+Alt+P 開 picker,方向鍵在 voice / agent profile 中選。
  5. 「Hey Mori 待命」(v0.6.0+,Listening mode):不想按熱鍵 → 托盤右鍵選「Hey Mori 待命」進 Listening mode。對麥克風喊「Hey Mori」就自動觸發 錄音(Mori 會先回一句「嗯,我在聽」讓你知道可以講)。講完連續 1.5s 靜音就 自動送 STT。Tray menu 切回別的 mode 就退出待命。

自訂更多 profile slot(2~9):用同檔名格式 AGENT-NN.<display>.md / USER-NN.<display>.md 丟到 ~/.mori/agent/ / ~/.mori/voice_input/ 即可(範本見 Profile 範本頁)。

下一步

Mori Design Book · Getting Started