用途:该技能面向 PiKVM(KVM over IP)设备的远程管理,通过 HTTP API 对目标主机进行截屏、键鼠模拟与电源控制,适合用户提到“PiKVM”“KVM over IP”“远程服务器”或硬件管理时使用。
主要能力与用法:所有请求使用 curl,认证参数为 -u "$PIKVM_AUTH",地址为 $PIKVM_URL。 截屏:curl -k -s -o /tmp/screenshot.jpg -u "$PIKVM_AUTH" "$PIKVM_URL/api/streamer/snapshot" 输入文本:以 text/plain 原始正文 POST 到 /api/hid/print?limit=0。 鼠标移动:/api/hid/events/send_mouse_move?to_x=-500&to_y=-300,坐标以屏幕中心为原点 (0,0),负 X 左、正 X 右、负 Y 上、正 Y 下,1920x1080 时左上角为 (-960,-540)、右下角为 (960,540)。 鼠标点击:send_mouse_button?button=left&state=true 按下,state=false 释放。 滚轮:send_mouse_wheel?delta_x=0&delta_y=-50。 按键:send_key?key=Enter&state=true 后 state=false;组合键按顺序依次按下,再逆序释放(如 Cmd+Space 用 MetaLeft 和 Space)。 电源控制:/api/atx/power?action=on|off|reset_hard。 设备信息:GET /api/info(可用 jq 解析),ATX 状态:GET /api/atx。
常用键名:MetaLeft(Cmd)、ControlLeft、AltLeft、ShiftLeft、Enter、Space、Escape、Tab、Backspace、Delete、方向键、KeyA-KeyZ、Digit0-Digit9、F1-F12、PageUp、PageDown、Home、End、Equal、Minus。
限制:官方 API 文档见 https://docs.pikvm.org/api/;本资料未提供环境安装、鉴权配置、收费、价格与平台支持等细节,这些内容暂未提供。