全键盘最后一公里warpd

文章目录

• [一、 前言](#一、 前言)
• • [1. 如何安装](#1. 如何安装)
• [二、 基本使用方法](#二、 基本使用方法)
• [warpd 中文使用说明](#warpd 中文使用说明)
• • 项目简介
  • 本机安装信息
  • 快速开始
  • • [1. 启动守护进程](#1. 启动守护进程)
    • [2. 常用默认热键](#2. 常用默认热键)
  • 三种核心模式
  • • [1. 普通模式](#1. 普通模式)
    • [2. Hint 模式](#2. Hint 模式)
    • [3. Grid 模式](#3. Grid 模式)
  • 拖拽与文本选择
  • 命令行单次使用
  • 配置文件
  • [Wayland 使用说明](#Wayland 使用说明)
  • 常用建议
  • 卸载

一、 前言

ubuntu想要使用全键盘进行日常事物操作的时候，浏览器的使用其实还是没有办法完全摆脱键盘的，所以就有了这个项目。

1. 如何安装

https://github.com/rvaiya/warpd

网址如上，把这个网址发给codex，她可以给你装好。

二、 基本使用方法

warpd 中文使用说明

项目简介

warpd 是一个"用键盘操作鼠标"的模态工具。它可以让你在不离开键盘的情况下完成下面这些操作：

• 移动鼠标指针
• 左键 / 中键 / 右键点击
• 拖拽选择
• 滚轮滚动
• 在屏幕上打标签后快速跳转到目标位置

它比较适合已经习惯 vim / hjkl 操作方式的用户。

本机安装信息

本次安装结果如下：

• 源码目录：/home/yzh/warpd
• 可执行文件：/home/yzh/.local/bin/warpd
• man 手册：man warpd
• 已确认版本：warpd v1.3.5 (built from: 01650ea)
• 当前桌面会话：X11

说明：

• 由于本机 sudo 需要密码，这次没有安装到 /usr/local/bin。
• 目前安装在 ~/.local/bin，而这个目录已经在你的 PATH 中，所以可以直接运行 warpd。

快速开始

1. 启动守护进程

在 X11 环境下，先执行：

warpd

程序启动后会在后台等待热键。

A-M 的意思是 Alt + Meta。在大多数 Linux 桌面里，Meta 通常就是 Super/Win 键。

2. 常用默认热键

功能	默认热键	说明
普通模式	Alt + Super + c	进入键盘控制鼠标的主模式
Hint 模式	Alt + Super + x	屏幕打标签，输入标签后跳转
二阶段 Hint 模式	Alt + Super + Shift + x	更适合精细定位
Grid 模式	Alt + Super + g	通过不断缩小网格来定位
历史模式	Alt + Super + h	只显示之前选中过的位置
屏幕选择模式	Alt + Super + s	多屏之间切换
Hint 单次模式	Alt + Super + l	选中后立刻退出

三种核心模式

1. 普通模式

普通模式是 warpd 最常用的模式，适合做短距离移动和点击。

默认按键：

• h / j / k / l：左 / 下 / 上 / 右移动鼠标
• H / M / L：快速移动到屏幕上方 / 中间 / 下方
• 0 / $：快速移动到最左 / 最右
• m：左键
• ,：中键
• .：右键
• e：向下滚动
• r：向上滚动
• v：开始或结束拖拽
• c：复制并退出，适合和拖拽配合
• esc：退出当前会话

补充：

• 支持数字前缀，例如 10j 表示向下移动 10 个单位。
• n、-、/ 默认是单次点击键，点击后会退出当前模式。

2. Hint 模式

Hint 模式会在屏幕上生成很多标签。你输入对应标签后，鼠标会直接跳到目标附近，然后进入普通模式继续微调。

适合场景：

• 快速移动到某个按钮、链接、菜单项
• 文本选择前先定位到起点
• 多窗口之间快速切换焦点

补充：

• 在普通模式里按 x 可以进入 Hint 模式。
• 在普通模式里按 X 可以进入二阶段 Hint 模式，适合更精细的定位。
• 在普通模式里按 ; 可以进入历史模式，只显示之前操作过的位置。

3. Grid 模式

Grid 模式默认把屏幕分成 2x2 网格，每次按键都会继续缩小目标区域，直到把鼠标定位到足够精确的位置。

默认常用按键：

• u / i / j / k：选择四个象限
• m / , / .：点击
• c：退出 Grid 并回到普通模式

如果你更习惯"不断缩小搜索区域"的操作方式，Grid 模式会很顺手。

拖拽与文本选择

warpd 很适合做键盘拖拽：

1. 先用 Hint 或 Grid 把鼠标移动到拖拽起点。
2. 进入普通模式后按 v，开始拖拽。
3. 继续用 hjkl、x、X、g 等方式移动到目标位置。
4. 再按一次 v，或者直接按鼠标按钮键结束拖拽。

如果是复制文字，可以在拖拽完成后使用默认的 c。

命令行单次使用

除了常驻后台，warpd 也支持命令行一次性调用。

常用示例：

# 查看帮助
warpd --help

# 直接进入普通模式
warpd --normal

# 直接进入 Hint 模式
warpd --hint

# 直接进入 Grid 模式
warpd --grid

# 启动普通模式并直接进入拖拽
warpd --normal --drag

# 把鼠标移动到指定坐标
warpd --move '100 200'

# 移动后执行左键点击
warpd --move '100 200' --click 1

# 使用二阶段 Hint 选择目标后左键点击
warpd --hint2 --click 1

补充：

• --oneshot 适合脚本调用。模式完成后，warpd 会立即退出，而不是继续停留在普通模式。
• --query 可以从标准输入读取自定义标签列表，适合高级脚本场景。

配置文件

配置文件路径按下面顺序查找：

1. $XDG_CONFIG_HOME/warpd/config
2. ~/.config/warpd/config

配置格式是：

option: value

例如：

hint_activation_key: A-M-x
activation_key: A-M-c
grid_activation_key: A-M-g
speed: 300
hint_size: 24
indicator: topright
indicator_color: #00ff00

查看全部可配置项：

warpd --list-options

查看可用按键名称：

warpd --list-keys

Wayland 使用说明

warpd 在 Wayland 下可以工作，但限制比 X11 多，而且仓库明确说明：

• 只支持基于 wlroots 的环境，例如 sway
• 不支持 GNOME

Wayland 下不能像 X11 那样由 warpd 自己全局监听热键，所以要在 compositor 里绑定命令。例如 sway：

bindsym Mod4+Mod1+x exec warpd --hint
bindsym Mod4+Mod1+c exec warpd --normal
bindsym Mod4+Mod1+g exec warpd --grid

Wayland 下的已知限制：

• 不能像 X11 那样作为常驻 daemon 全局抓热键
• 光标隐藏功能不可用
• 某些必须先获得焦点的输入框 / UI 元素可能无法正常选择

常用建议

• X11 下推荐直接运行一次 warpd，然后长期驻留后台使用。
• 如果你最常做的是"从一个区域跳到另一个区域"，优先用 Hint 模式。
• 如果你最常做的是"逐步逼近某个位置"，Grid 模式更稳。
• 如果你已经接近目标，普通模式加 hjkl 微调最快。
• 多屏用户在更改显示器连接状态后，最好重启一次 warpd。

卸载

这次安装在用户目录下，可以直接执行：

rm -f ~/.local/bin/warpd ~/.local/share/man/man1/warpd.1.gz

如果你还想删除源码目录，再手动删除 /home/yzh/warpd 即可。