Mori

DOCS

Hotkeys

GLOBAL · MAIN WINDOW · PICKER

Mori 雙模式架構:前綴鍵選模式,數字鍵選 profile。共 23 個全域熱鍵 (toggle + cancel + picker + 10 voice slot + 10 agent slot)+ picker / chat / tray 內熱鍵。

基本操作流程(日常用法 4 個鍵打天下):

Alt+0~9 或 Ctrl+Alt+0~9 — 選 mode + profile slot(每按一次就鎖在那個 mode)
- Alt+0 = VoiceInput 預設極簡聽寫
- Alt+1 = VoiceInput 預設「朋友閒聊」(starter)
- Ctrl+Alt+0 = Agent 預設 Mori 角色
- Ctrl+Alt+1 = Agent 預設「翻譯助手」(starter)
Ctrl+Alt+Space — 開始錄音 / 再按一次停止 + 自動送 STT + LLM
Ctrl+Alt+Esc — 錄音中丟音檔 / 思考中 abort LLM
Ctrl+Alt+P — 不記 slot 數字就開 picker overlay 選

全新安裝時 slot 0~5 都有 starter(v0.4.1+ 預設 deploy 6 個 voice + 6 個 agent),slot 6~9 用同檔名格式自建(見 Profile 範本)。

Linux 啟動時自動偵測 session 走哪條 path:

X11 session(XDG_SESSION_TYPE=x11)→ tauri-plugin-global-shortcut(XGrabKey 直接 grab,Ubuntu 24.04 + X11 可用)
Wayland / XWayland → xdg-desktop-portal GlobalShortcuts (第一次跑會跳權限對話框 — 需要 xdg-desktop-portal ≥ 1.19,Ubuntu 26.04+)

全域熱鍵 · Toggle

Ctrl + Alt + Space

開始 / 結束錄音(兩個模式共用)

Ctrl + Alt + Esc

中斷錄音 / 中斷 Mori 思考

Ctrl + Alt + P

開啟 Profile Picker overlay(↑↓ / Tab / Enter)

VoiceInput 模式 · `Alt+N`

切到 voice profile N(~/.mori/voice_input/USER-NN.*.md)。按完接著按 Ctrl+Alt+Space 錄音,STT → 單輪 LLM cleanup → 貼到游標。

Alt + 0 ~ 9

切到對應編號的 voice_input profile

Agent 模式 · `Ctrl+Alt+N`

切到 agent profile N(~/.mori/agent/AGENT-NN.*.md)。按完接著按 Ctrl+Alt+Space 錄音,STT → Mori agent loop → chat 回應 / 執行動作。

Ctrl + Alt + 0 ~ 9

切到對應編號的 agent profile

Picker Overlay · `Ctrl+Alt+P`

↑ / ↓ 或 k / j

上下選 profile(3-item carousel)

Tab 或 ← / →

切 VoiceInput / Agent 兩組

Enter

確認切換

Esc

取消(picker 關閉)

主視窗 Chat Panel

Ctrl + Enter

送出 textarea 訊息(textarea 內)

Tray Menu

系統匣右鍵點 Mori icon:

三個 mode 切換:對話模式 / 語音輸入模式 / 休眠(關麥克風)
Voice profile 子選單:列全部 USER-*.md
Agent profile 子選單:列全部 AGENT-*.md
顯示主視窗 / 退出

UI 內小按鈕

Sidebar 左下角 ☀ / 🌙 — quick toggle dark ↔ light theme
主視窗 sidebar 6 tab — Chat / Profiles / Config / Memory / Skills / Deps
Chat panel 右上 — 休眠 toggle / 重置對話 / status modal
雙擊 Floating sprite — 切顯示主視窗
拖曳 Floating sprite — 移動桌面位置

Linux 系統熱鍵衝突

如果 Ctrl+Alt+Esc 註冊不上,GNOME 預設綁了 cycle-panels:

gsettings set org.gnome.desktop.wm.keybindings cycle-panels "[]"

細部 troubleshoot 見 Troubleshooting。

自訂熱鍵

編輯 ~/.mori/config.json 的 hotkeys 子樹:

{
  "hotkeys": {
    "toggle": "Ctrl+Alt+Space",
    "toggle_mode": "toggle",
    "cancel": "Ctrl+Alt+Escape",
    "picker": "Ctrl+Alt+P",
    "voice_slot_modifier": "Alt",
    "agent_slot_modifier": "Ctrl+Alt",
    "voice_slot_overrides": {},
    "agent_slot_overrides": {}
  }
}

欄位

toggle / cancel / picker — 單一動作的完整 hotkey 字串
toggle_mode — "toggle"(預設,一按切換錄音)或 "hold"(按住錄、放開停, 像 push-to-talk)。兩種模式共用同一個 toggle chord, X11 / Wayland 都支援。Config UI 按「儲存」即時生效不必重啟。
voice_slot_modifier — 套用到 voice slot 0~9 的 modifier(預設 Alt, 產出 Alt+0、Alt+1 ... Alt+9)
agent_slot_modifier — 同上但用於 agent slot(預設 Ctrl+Alt)
voice_slot_overrides / agent_slot_overrides — 個別 slot 覆寫, key 是編號字串("0"~"9"),value 是完整 hotkey 字串。例: {"0": "F1", "1": "F2"} 把 Alt+0 / Alt+1 改成 F1 / F2

Toggle vs Hold 模式

X11 session 實機 demo(切模式 + hold 錄音 + 熱套用,29 秒):

都用同一個 chord(預設 Ctrl+Alt+Space),差別只在按下 / 放開的解讀:

toggle(預設)— 按一下開錄、再按一下停錄。Recording 中再按就停 + 送 STT;Transcribing / Responding 中按 = 忽略。
hold — 按住開錄、放開立刻停錄送 STT(0ms 延遲,像 Discord push-to-talk)。Press 時 phase 是 Idle / Done / Error 才開錄;Release 時 phase 是 Recording 才停錄,其他狀態當 no-op。

Config tab → Hotkey sub-tab 有 dropdown 可切。

為什麼不做「bare Alt 按住 1 秒」?xdg-desktop-portal 規範明確 reject 純 modifier trigger,Wayland 拿不到 bare Alt 事件,唯一跨 path 路徑是 evdev (/dev/input/event* + input group),代價過大。Chord-based hold 等價體感反而更順(0ms 起錄 vs 1s 等待),所以走 Ctrl+Alt+Space hold。

支援的鍵名

Modifier:Ctrl(或 Control) / Alt(或 Option) / Shift / Super(或 Meta / Cmd)
字母:A~Z(大小寫不分)
數字:0~9
功能鍵:F1~F24
命名鍵:Space、Escape、Return(或 Enter)、 Tab、BackSpace、Delete、Insert、 Home、End、PageUp、PageDown、 Left、Right、Up、Down
符號鍵:Comma、Period、Slash、 Semicolon、Quote、Backquote 等

改完什麼時候生效?

toggle_mode — Config UI 按「儲存」即時生效,下次按鍵就走新模式 (`config_write` 寫完 disk 後 Mori 重讀 mode 寫進 state)。直接編 config.json 沒走 UI 的話走重啟路徑。
X11 session 的鍵位字串(toggle / cancel / picker / slot)— 重啟 Mori 後生效,config 設定 100% 為準
Wayland session 的鍵位字串 — config 改了後要重啟 Mori 且刪掉 portal per-app 紀錄,Mori 才會用新值重新跟 portal 註冊:
```
rm -rf ~/.local/share/xdg-desktop-portal/permissions
```
否則 config 改了沒效。Wayland 上之後也可以直接去 GNOME Settings → Keyboard → 自訂快速鍵 調 Mori 的 binding(portal 規範:compositor 是最終決定者)。

衝突偵測

啟動時會檢查兩個 action 是否綁到同一個鍵(忽略 modifier 順序),衝突會在 log 出 hotkey conflict: ... both map to ... 並 abort 整批註冊 — 修 config 再重啟。

單鍵 grab 失敗

X11 path 上某條鍵被別的 app 先 grab(例如 GNOME 把 Ctrl+Alt+Esc 綁了 cycle-panels) ,Mori 只會 log warn 跳過那條,其他 22 條照常生效。