用途:在本地 Linux 会话中操作真实的 Hyprland 合成器(Lua 配置,Hyprland 0.55+),是 windows-ui-inject 的 Linux 对应物,不等同于 Windows mstsc + GNOME/KDE 容器的 agent-workstation-drive。核心脚本为 scripts/hypr-drive,安装后位于 ~/.grok/skills/drive-hyprland/scripts/hypr-drive。
主要能力:列出窗口、工作区、显示器与当前活动窗口;按类名或标题聚焦窗口;切换工作区;按布局坐标移动光标并点击鼠标键(left 0xC0、right 0xC1、middle 0xC2);用 wtype 向当前聚焦客户端输入文字与按键组合;在已有 Chrome/Chromium 会话中打开 URL;用 grim 截图。
使用方式:主机需 Hyprland 会话、hyprctl、python3、grim;点击需 ydotool + ydotoold,输入需 wtype。安装脚本为 ./scripts/install.sh host 与 ./scripts/install.sh verify;需按提示用 sudo 配置 ydotool、wtype、grim 软件包,将用户加入 input 组,设置 /dev/uinput 为 0660 root:input,并启用 systemctl --user enable --now ydotool.service,套接字在 $XDG_RUNTIME_DIR/.ydotool_socket。装载到 harness 可用 ./scripts/install.sh harness(可选 grok)。常用命令:./scripts/hypr-drive windows、workspaces、monitors、active、focus-class、focus-title、focus-workspace、cursor、click、type、key、combo、open-url、screenshot-class。工作区切换须用 Lua 调度器,如 hyprctl dispatch 'hl.dsp.focus({ workspace = 1 })';hl.dsp.* 仅在 hl.dispatch(...) 后才生效。
限制与注意:hyprctl dispatch workspace 5 或 focuswindow address:0x… 在 Lua 配置下失败;不要用 change_id 切换工作区;不要从本技能编辑 ~/.config/hypr/。wtype/combo 无法触发合成器绑定(Hyprland 看不到 Super),此类绑定应改用调度器或 omarchy 菜单。光标切换请先移动再点击,不要用 ydotool mousemove --absolute。变更后应重新读取 active 确认焦点。其余细节暂未提供。