aboutsummaryrefslogtreecommitdiff
path: root/website/src/content/docs/zh-cn/keyboard.mdx
diff options
context:
space:
mode:
authorgithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2026-08-03 19:00:20 +0000
committergithub-actions[bot] <41898282+github-actions[bot]@users.noreply.github.com>2026-08-03 19:00:20 +0000
commit3642e67c7b9c1d8608d72f288e80b410c602e55c (patch)
tree31e956f8d0ce3ffa7ad06495c6523cc3c7b3a3a5 /website/src/content/docs/zh-cn/keyboard.mdx
parent346411fa21afd297f5ed3b3fa56f9e3fbf7654b7 (diff)
docs: update website manifest for v0.8.0
Diffstat (limited to 'website/src/content/docs/zh-cn/keyboard.mdx')
-rw-r--r--website/src/content/docs/zh-cn/keyboard.mdx112
1 files changed, 0 insertions, 112 deletions
diff --git a/website/src/content/docs/zh-cn/keyboard.mdx b/website/src/content/docs/zh-cn/keyboard.mdx
deleted file mode 100644
index 0dfea960..00000000
--- a/website/src/content/docs/zh-cn/keyboard.mdx
+++ /dev/null
@@ -1,112 +0,0 @@
----
-title: 键盘
-description: 前缀键是什么、应该先学哪些绑定,以及如何做到不用前缀键。
----
-
-:::tip[从 tmux 或 zellij 迁移过来?]
-这套模型你已经很熟悉了。直接跳到[按键绑定参考](/zh-cn/docs/configuration/#按键绑定)查看完整的默认键位和配置语法。
-:::
-
-Herdr 是鼠标原生的。你可以点击窗格、标签页、工作区和智能体,拖动分割边框,使用右键菜单,一个按键绑定都不用学。键盘操作是可选的一层,不是必需项。
-
-## 前缀键是什么
-
-终端复用器位于终端和其中运行的程序之间。这些程序已经占用了大多数按键组合: `ctrl+c` 中断,`ctrl+r` 搜索历史,编辑器几乎占用了剩下的一切。如果 Herdr 直接抢占常用按键,就会破坏其中运行的程序。
-
-前缀键解决了这个问题。按下前缀键 (默认 `ctrl+b`),下一次按键会发给 Herdr 而不是终端。`prefix+c` 的意思是: 按下 `ctrl+b`,松开,再按 `c`。只保留一个键,而不是几十个。
-
-随时按 `prefix+?` 可以查看所有生效的绑定。
-
-## 先学这五个
-
-| 动作 | 按键 |
-| --- | --- |
-| 新建标签页 | `prefix+c` |
-| 向右 / 向下分割 | `prefix+v` / `prefix+minus` |
-| 在窗格间移动 | `prefix+h/j/k/l` |
-| 工作区导航 | `prefix+w` |
-| 分离并让一切继续运行 | `prefix+q` |
-
-这些覆盖了日常的大部分移动操作。其余的都可以继续用鼠标。
-
-## 其余的,按任务分
-
-窗格:
-
-| 动作 | 按键 |
-| --- | --- |
-| 缩放聚焦的窗格 | `prefix+z` |
-| 关闭窗格 | `prefix+x` |
-| 交换窗格 | `prefix+shift+h/j/k/l` |
-| 调整大小模式 | `prefix+r` |
-| 复制模式 | `prefix+[` |
-
-标签页:
-
-| 动作 | 按键 |
-| --- | --- |
-| 下一个 / 上一个标签页 | `prefix+n` / `prefix+p` |
-| 跳转到标签页 1–9 | `prefix+1..9` |
-| 重命名标签页 | `prefix+shift+t` |
-| 关闭标签页 | `prefix+shift+x` |
-
-工作区与会话:
-
-| 动作 | 按键 |
-| --- | --- |
-| 新建工作区 | `prefix+shift+n` |
-| 重命名工作区 | `prefix+shift+w` |
-| 关闭工作区 | `prefix+shift+d` |
-| Goto 选择器 | `prefix+g` |
-| 切换侧边栏 | `prefix+b` |
-
-完整键位和绑定语法见[按键绑定参考](/zh-cn/docs/configuration/#按键绑定)。
-
-## 复制模式
-
-按 `prefix+[` 让聚焦的窗格进入复制模式。用 `h/j/k/l`、tmux 风格的 `w/b/e` 和 `{`/`}` 移动。按 `/` 或 `?` 向前或向后进行文本搜索,再用 `n` 或 `N` 按相同或相反方向重复搜索。查询包含大写字母时区分大小写,否则不区分。用 `v` 或空格开始选择,用 `y` 或回车复制,用 `q` 或 Esc 不复制直接退出。Esc 会先清除当前选择或搜索,然后才退出。复制模式不会暂停窗格进程:停留在底部时继续跟随输出,进入历史记录后保持当前位置。鼠标拖选可以直接复制,完全不用进入复制模式。
-
-## 一切都可以改
-
-每个绑定都可以配置,包括前缀键本身:
-
-```toml
-[keys]
-prefix = "ctrl+a"
-```
-
-## 不用前缀键
-
-你可以把 Herdr 动作绑定到完全不需要前缀的直接组合键。难点在于知道哪些组合键是安全的,因为终端、shell 和桌面环境已经占用了键盘的大部分。
-
-任何组合键都可以做绑定: `ctrl+j`、`alt+k`,顺手就行。但一个组合键要经过三层才能到达 Herdr: 操作系统、外层终端 (Ghostty、iTerm2 等都带有自己的默认键位),以及窗格内运行的程序。`ctrl+j` 能顺利到达 Herdr,但 shell 和编辑器把它当作回车。`alt+k` 在 Linux 上是空闲的,但在 macOS 的大多数终端里会被组合成特殊字符。如果你从这些键系里选组合键,请对照自己的终端和系统快捷键再确认一遍。
-
-我们梳理了 Ghostty、iTerm2、Terminal.app、kitty、WezTerm、Alacritty、Warp、Windows Terminal、GNOME Terminal 和 Konsole 的默认按键绑定,以及 GNOME 和 KDE 的全局快捷键。有一个修饰键系几乎在所有地方都没被占用: `ctrl+alt`。终端把它留空,它不受 macOS option 键组合行为 (会挡掉纯 `alt` 组合键) 的影响,而且即使在没有现代键盘协议的终端里也能正常传输。它是安全的默认推荐;选择权在你。
-
-下面的配置保留前缀绑定,并在其上叠加直接组合键:
-
-```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+arrows` | 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 里换一个。