修复 v0.5 审查问题: platform 改名, 协议健壮性, CJK 匹配, VBS 引号, interception API

Browse Source
Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
This commit is contained in:
yws
2026-10-02 01:39:06 +00:00
co-authored by Claude Opus 5.5
parent 176570e7cd
commit 809a7fb017
12 changed files with 667 additions and 360 deletions
+104 -65
View File
@@ -1,94 +1,133 @@
# -*- coding: utf-8 -*- # -*- coding: utf-8 -*-
"""Linux uinput 物理输入后端(虚拟内核 evdev 设备,需 root 或 uinput 组权限)。 """Linux uinput 物理输入后端(虚拟内核 evdev 设备,需 root 或 uinput 组权限)。
比 xdotool 更接近硬件:内核层面人为物理设备,无 X 层痕迹。 比 xdotool 更接近硬件:内核层面人为物理设备,无 X 层痕迹。
依赖: python3-uinput 或手工 ioctl。 依赖: python-uinput (pip install python-uinput)。
鼠标用绝对坐标轴(ABS_X/ABS_Y): 相对位移(REL_X/REL_Y)会被 libinput 指针加速放大, 点不准。
""" """
import os import time
import struct
from ._util import parse_combo
try: try:
import uinput import uinput
HAVE_UINPUT = True HAVE_UINPUT = True
except ImportError: except ImportError:
uinput = None
HAVE_UINPUT = False HAVE_UINPUT = False
ABS_MAX = 65535
# 键名 -> python-uinput 常量名
_NAMED = {
'enter': 'ENTER', 'esc': 'ESC', 'space': 'SPACE', 'tab': 'TAB', 'backspace': 'BACKSPACE',
'ctrl': 'LEFTCTRL', 'rctrl': 'RIGHTCTRL', 'alt': 'LEFTALT', 'ralt': 'RIGHTALT',
'shift': 'LEFTSHIFT', 'lshift': 'LEFTSHIFT', 'rshift': 'RIGHTSHIFT', 'lwin': 'LEFTMETA',
'up': 'UP', 'down': 'DOWN', 'left': 'LEFT', 'right': 'RIGHT',
'home': 'HOME', 'end': 'END', 'pageup': 'PAGEUP', 'pagedown': 'PAGEDOWN',
'insert': 'INSERT', 'delete': 'DELETE',
',': 'COMMA', '.': 'DOT', '/': 'SLASH', ';': 'SEMICOLON', "'": 'APOSTROPHE',
'[': 'LEFTBRACE', ']': 'RIGHTBRACE', '-': 'MINUS', '=': 'EQUAL', '`': 'GRAVE', '\\': 'BACKSLASH',
}
_NAMED.update({c: c.upper() for c in 'abcdefghijklmnopqrstuvwxyz0123456789'})
_NAMED.update({'f%d' % i: 'F%d' % i for i in range(1, 13)})
# US 布局下需要 Shift 的符号 -> 基础键
_SHIFTED = {'!': '1', '@': '2', '#': '3', '$': '4', '%': '5', '^': '6', '&': '7', '*': '8',
'(': '9', ')': '0', '_': '-', '+': '=', '{': '[', '}': ']', ':': ';', '"': "'",
'<': ',', '>': '.', '?': '/', '~': '`', '|': '\\'}
def _key_event(name):
const = _NAMED.get(name)
return getattr(uinput, 'KEY_' + const) if const else None
def _x_screen_size():
try:
from Xlib import display
s = display.Display().screen()
return s.width_in_pixels, s.height_in_pixels
except Exception:
return 1920, 1080
class UinputBackend: class UinputBackend:
def __init__(self): def __init__(self, screen=None):
if not HAVE_UINPUT: if not HAVE_UINPUT:
raise RuntimeError('python3-uinput not installed') raise RuntimeError('python-uinput not installed (pip install python-uinput)')
self._ctx = None self._scr_w, self._scr_h = screen or _x_screen_size()
events = [getattr(uinput, 'KEY_' + c) for c in sorted(set(_NAMED.values()))]
events += [uinput.BTN_LEFT, uinput.BTN_RIGHT,
uinput.ABS_X + (0, ABS_MAX, 0, 0), uinput.ABS_Y + (0, ABS_MAX, 0, 0)]
self._dev = uinput.Device(events, name='lc-mcp-uinput')
time.sleep(0.5) # 等 udev / 显示服务器识别新设备
def _ensure(self): def set_screen(self, w, h):
if self._ctx is None: self._scr_w, self._scr_h = int(w), int(h)
from uinput import Device, KEY_A, KEY_Z, KEY_ENTER, KEY_ESC, KEY_SPACE, KEY_TAB, KEY_F4, KEY_LEFTCTRL, KEY_LEFTSHIFT, KEY_LEFTALT, KEY_BACKSPACE, REL_X, REL_Y, BTN_LEFT, BTN_RIGHT
events = (
# 全键盘范围(够用): A-Z + 数字 + 常用
*[key for key in range(KEY_A, KEY_Z + 1)],
KEY_ENTER, KEY_ESC, KEY_SPACE, KEY_TAB, KEY_F4,
KEY_LEFTCTRL, KEY_LEFTSHIFT, KEY_LEFTALT, KEY_BACKSPACE,
REL_X, REL_Y, BTN_LEFT, BTN_RIGHT,
)
self._dev = Device(events)
return self._dev
def _key(self, code): def _abs(self, v, size):
dev = self._ensure() v = min(max(int(v), 0), max(size - 1, 0))
dev.emit(code, 1) return int(round(v * ABS_MAX / max(size - 1, 1)))
dev.emit(code, 0)
time.sleep(0.03)
def move(self, x, y): def move(self, x, y):
# uinput 只有相对位移; 需要知道当前位置。先简单相对 0 通过 xdotool 定位, 或 https 轮询 self._dev.emit(uinput.ABS_X, self._abs(x, self._scr_w), syn=False)
# 简化: 用 python-xlib 查指针位置 -> 计算 delta self._dev.emit(uinput.ABS_Y, self._abs(y, self._scr_h))
try: time.sleep(0.03)
from Xlib import display return {'ok': True, 'backend': 'uinput'}
d = display.Display()
root = d.screen().root
qp = root.query_pointer()
curx, cury = qp.root_x, qp.root_y
dx, dy = int(x) - curx, int(y) - cury
dev = self._ensure()
dev.emit(REL_X, dx)
dev.emit(REL_Y, dy)
d.sync()
except Exception:
return {'ok': False, 'error': 'uinput move needs python-xlib'}
return {'ok': True}
def click(self, x, y, button='left', times=1): def click(self, x, y, button='left', clicks=1):
self.move(x, y) self.move(x, y)
dev = self._ensure() time.sleep(0.03)
btn = BTN_LEFT if button == 'left' else BTN_RIGHT btn = uinput.BTN_LEFT if button == 'left' else uinput.BTN_RIGHT
for _ in range(times): for _ in range(max(1, int(clicks))):
dev.emit(btn, 1) self._dev.emit(btn, 1)
time.sleep(0.05) time.sleep(0.05)
dev.emit(btn, 0) self._dev.emit(btn, 0)
time.sleep(0.05) time.sleep(0.05)
return {'ok': True} return {'ok': True, 'clicked': [int(x), int(y)], 'backend': 'uinput'}
def _tap(self, ev, hold=0.03):
self._dev.emit(ev, 1)
time.sleep(hold)
self._dev.emit(ev, 0)
def keypress(self, key): def keypress(self, key):
mapping = {'enter': KEY_ENTER, 'esc': KEY_ESC, 'space': KEY_SPACE, try:
'tab': KEY_TAB, 'f4': KEY_F4, 'ctrl': KEY_LEFTCTRL, parts = parse_combo(key)
'shift': KEY_LEFTSHIFT, 'alt': KEY_LEFTALT, 'backspace': KEY_BACKSPACE} except ValueError as e:
k = key.lower() return {'ok': False, 'error': str(e)}
if k in mapping: evs = [_key_event(p) for p in parts]
self._key(mapping[k]) if None in evs:
return {'ok': True}
if len(k) == 1 and 'a' <= k <= 'z':
from uinput import KEY_A
self._key(KEY_A + (ord(k) - ord('a')))
return {'ok': True}
return {'ok': False, 'error': 'unsupported key %s' % key} return {'ok': False, 'error': 'unsupported key %s' % key}
for ev in evs[:-1]:
self._dev.emit(ev, 1)
time.sleep(0.03)
self._tap(evs[-1], 0.04)
for ev in reversed(evs[:-1]):
time.sleep(0.03)
self._dev.emit(ev, 0)
return {'ok': True, 'key': str(key), 'backend': 'uinput'}
def type_text(self, text): def type_text(self, text):
for ch in text: plan = []
if 'a' <= ch.lower() <= 'z': for ch in str(text):
self.keypress(ch.lower()) if ch == ' ':
elif ch == ' ': plan.append(('space', False))
self.keypress('space') elif ch == '\n':
plan.append(('enter', False))
elif ch.lower() in _NAMED and len(ch) == 1:
plan.append((ch.lower(), ch.isupper()))
elif ch in _SHIFTED:
plan.append((_SHIFTED[ch], True))
else: else:
return {'ok': False, 'error': 'unsupported char %r' % ch} return {'ok': False, 'error': 'unsupported char %r (uinput 只支持 US 布局 ASCII)' % ch}
time.sleep(0.05) shift = uinput.KEY_LEFTSHIFT
return {'ok': True} for name, need_shift in plan:
if need_shift:
self._dev.emit(shift, 1)
self._tap(_key_event(name))
if need_shift:
self._dev.emit(shift, 0)
time.sleep(0.03)
return {'ok': True, 'typed': str(text), 'backend': 'uinput'}