04 - 日常操作：滑鼠與鍵盤
← 03-核心概念 | 00-Index | 下一篇 → 05-Agent偵測與狀態機制
先講最重要的：滑鼠就夠了
Herdr 是 mouse-native 設計。所有功能都摸得到，一個鍵盤快捷鍵都不用學也能完整使用。鍵盤是選配層，不是必要條件。
滑鼠能做的事：
| 操作 | 效果 |
|---|---|
| 點 pane / tab / workspace / agent | focus 過去 |
| 拖曳分割線 | 調整 pane 大小 |
| 右鍵 | context menu（分割 pane、開 tab…） |
| 拖選文字 | 直接複製到剪貼簿（不用按 Ctrl+C） |
| 雙擊某個 token | 直接複製那個 token |
Ctrl + 點連結 | 開啟 pane 裡的連結（OSC 8 超連結或看得到的 http(s)://） |
💡 「拖選就複製」這件事，在讀 agent 輸出、抄 PMID / 檔案路徑時特別好用。
如果你偏好純鍵盤、或者想讓 Herdr 別攔滑鼠：
[ui]
mouse_capture = falsePrefix 是什麼（給沒用過 tmux 的人）
終端機多工器夾在「你的終端機」和「裡面跑的程式」之間。裡面的程式已經佔走了大部分按鍵組合：ctrl+c 中斷、ctrl+r 搜歷史、編輯器幾乎全包。如果 Herdr 直接搶這些鍵，就會弄壞裡面的程式。
Prefix 解決這個問題：按下 prefix 鍵（預設 ctrl+b），下一個按鍵就送給 Herdr 而不是終端機。
prefix+c的意思是：按ctrl+b、放開、再按c。 只犧牲一個保留鍵，換到幾十個功能。
隨時按 prefix+? 可以看到所有目前生效的綁定；在說明面板裡按 / 可以過濾。
先學這五個
| 動作 | 按鍵 |
|---|---|
| 新分頁 | prefix+c |
| 往右 / 往下分割 | prefix+v / prefix+minus |
| 在 pane 之間移動 | prefix+h/j/k/l |
| Workspace 導覽 | prefix+w |
| Detach（東西全部繼續跑） | prefix+q |
會這五個，日常移動就八成夠了。
其他按鍵（照用途分）
Pane
| 動作 | 按鍵 |
|---|---|
| 放大 focus 的 pane | prefix+z |
| 關掉 pane | prefix+x |
| 對調 pane | prefix+shift+h/j/k/l |
| Resize 模式 | prefix+r |
| Copy 模式 | prefix+[ |
Tab
| 動作 | 按鍵 |
|---|---|
| 下一個 / 上一個分頁 | prefix+n / prefix+p |
| 跳到第 1–9 個分頁 | prefix+1..9 |
| 重新命名分頁 | prefix+shift+t |
| 關閉分頁 | prefix+shift+x |
Workspace 與 session
| 動作 | 按鍵 |
|---|---|
| 新 workspace | prefix+shift+n |
| 重新命名 workspace | prefix+shift+w |
| 關閉 workspace | prefix+shift+d |
| Goto 快速跳轉 | prefix+g |
| 開關 sidebar | prefix+b |
| 看所有按鍵說明 | prefix+? |
Copy 模式（prefix+[）
用來在歷史輸出裡搜尋、選取、複製。移動鍵是 vim / tmux 那一套：
- 移動：
h/j/k/l、w/b/e、{/}、PageUp/PageDown、ctrl+b/ctrl+f、ctrl+u/ctrl+d - 搜尋：
/往前、?往後，n/N重複。查詢字串含大寫才會區分大小寫 - 選取：
v或空白鍵開始選、y或 Enter 複製 - 離開：
q或 Esc（Esc 會先清掉選取／搜尋，再按一次才離開）
重點特性：copy 模式不會暫停 pane 的 process。輸出照樣是即時的，你捲到歷史時畫面會固定住不被推走。
⚠️ 預設 prefix 是
ctrl+b，而ctrl+b在 copy 模式本來是「上一頁」。因為 prefix 在 copy 模式仍保有原意，所以你會進到 prefix 模式而不是翻頁。想要ctrl+b翻頁就得換 prefix。但講白了：滑鼠拖選根本不用進 copy 模式，這是更省事的路。
Detach 與回來
prefix+q 或直接關掉終端機視窗
Herdr server 和每一個 agent 都繼續跑。回來的時候：
herdr真的要結束 session、停掉所有 pane process：
herdr server stop🔑 這是 Herdr 最實用的日常價值：你可以在 Codex 跑到一半的時候關掉電腦上的終端機、去查房、回來
herdr接回原狀。
換掉 prefix / 加上免 prefix 快捷鍵
所有綁定都可以改，包含 prefix 本身：
[keys]
prefix = "ctrl+a"想要不用 prefix 的直接和弦？困難點在於哪些和弦是安全的——按鍵要穿過三層才會到 Herdr：作業系統 → 外層終端機 → pane 裡的程式。
官方比對了 Ghostty、iTerm2、Terminal.app、kitty、WezTerm、Alacritty、Warp、Windows Terminal、GNOME Terminal、Konsole 的預設值，以及 GNOME / KDE 的全域快捷鍵，結論是：ctrl+alt 這一族幾乎到處都是空的，而且不受 macOS option 鍵組字行為影響，在沒有現代鍵盤協定的終端機也送得出去。
[keys]
focus_pane_left = ["prefix+h", "ctrl+alt+h"]
focus_pane_down = ["prefix+j", "ctrl+alt+j"]
focus_pane_up = ["prefix+k", "ctrl+alt+k"]
focus_pane_right = ["prefix+l", "ctrl+alt+l"]
previous_tab = ["prefix+p", "ctrl+alt+["]
next_tab = ["prefix+n", "ctrl+alt+]"]
new_tab = ["prefix+c", "ctrl+alt+c"]
split_vertical = ["prefix+v", "ctrl+alt+d"]
split_horizontal = ["prefix+minus", "ctrl+alt+shift+d"]
zoom = ["prefix+z", "ctrl+alt+z"]⚠️ 這幾個 ctrl+alt 和弦已經被別人佔走，別用：
| 和弦 | 被誰佔走 |
|---|---|
ctrl+alt+方向鍵 | GNOME 工作區切換、Ghostty / Konsole 預設 |
ctrl+alt+t | Ubuntu / Fedora 的「開終端機」 |
ctrl+alt+l / ctrl+alt+a | KDE 鎖定畫面 / 注意視窗 |
ctrl+alt+s / ctrl+alt+u | Konsole |
ctrl+alt+f1..f12 | Linux 虛擬主控台切換 |
直接和弦沒反應 = 你的終端機或桌面環境在 Herdr 之前就把它吃掉了。兩邊擇一改：終端機設定裡放掉那個和弦，或在 Herdr 換一個。
Windows 特別注意
shift+enter只有在外層終端機把它回報成一個獨立的修飾 Enter 時才有效。如果 Windows 或終端機回報成普通 Enter，Herdr 就只能轉送普通 Enter。（這對 Claude Code 的多行輸入有影響。）- 貼上用 Windows Terminal 的
ctrl+shift+v。 - 按住
shift再右鍵 = 用外層終端機自己的貼上動作。
🔗 相關筆記
- 03-核心概念 — 四層模型
- 05-Agent偵測與狀態機制 — 下一步：sidebar 上的狀態是怎麼來的
- 12-設定檔-通知-Plugins-SocketAPI —
config.toml完整設定 - 13-疑難排解與術語速查表 — 按鍵沒反應時
最後更新：2026-08-04