---
title: "04 - 日常操作：滑鼠與鍵盤"
type: note
specialty: Programming
tags: [herdr從0開始使用教學, 04-操作, keyboard, mouse]
created: 2026-08-04
updated: "2026"
modified: 2026-08-04
---

# 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 別攔滑鼠：

```toml
[ui]
mouse_capture = false
```

---

## Prefix 是什麼（給沒用過 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 都繼續跑。回來的時候：

```bash
herdr
```

真的要結束 session、停掉所有 pane process：

```bash
herdr server stop
```

> 🔑 **這是 Herdr 最實用的日常價值**：你可以在 Codex 跑到一半的時候關掉電腦上的終端機、去查房、回來 `herdr` 接回原狀。

---

## 換掉 prefix / 加上免 prefix 快捷鍵

所有綁定都可以改，包含 prefix 本身：

```toml
[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 鍵組字行為影響，在沒有現代鍵盤協定的終端機也送得出去。

```toml
[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*