分支从8a9495b分出,缺 main 上a74fda0的急停与驱动复核修复。 两边都保留,不取单边: - 急停:沿用分支的 GetAsyncKeyState 轮询与 End 键(pynput 钩子在该 机器收不到键,F12 是 Steam 截图键);移植 main 的 on_stop 释放驱动 按住的鼠标键、250 毫秒强退兜底、listening() 管理监听生命周期。 按键状态改为独立绑定(SHORT 返回值),接口不可用时启动即报告。 - 驱动输入:同时保留句柄级前台校验、press_ms/settle 与 main 的 停止标志、输入锁和按键记录;点击经 down()/up() 以便急停释放。 前台校验改用本模块的类型化 _api 绑定。 - 代理每次点击按当前句柄重新 bind_window:代理复用时不再拿安装时 的旧句柄拒绝游戏重启后的全部点击。 - aalc_task:listening() 包住整个任务,内部安装两个选队补丁。 - 分支新增测试改为替换模块接口,不再直接 patch ctypes.windll (Linux 上 9 项报错);README 急停键改为 End。 验证:Linux / Python 3.12 全套 474 项通过;git diff --check 通过。 Windows 热键、驱动和选队仍需实机回归。 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
186 lines
7.1 KiB
Python
186 lines
7.1 KiB
Python
# -*- coding: utf-8 -*-
|
|
"""全局急停热键。
|
|
|
|
为什么需要: 驱动级点击是闭环定位的 —— 手一动, 下一次点击前会读到新位置、算出
|
|
偏差、再把你推回目标点。所以任务运行期间鼠标是"拔河"状态, 用户没法用鼠标去点
|
|
停止按钮。键盘不受影响, 所以急停必须走键盘。
|
|
|
|
⛔ 为什么不用 pynput / 全局钩子(2026-10-22 实测):
|
|
pynput 的 GlobalHotKeys 在这台机器上**收不到任何键盘事件** —— 静态注册成功、
|
|
线程也活着, 但 keybd_event 和 SendInput 两种注入都触发不了它。钩子依赖
|
|
WH_KEYBOARD_LL, 在当前会话下不工作。
|
|
改用 GetAsyncKeyState 轮询: 不装钩子、不需要消息循环, 实测能正确看到注入的
|
|
按键。用 0x8000 位判断"当前按下"。
|
|
|
|
另外 AALC 自带的 pause_hotkey 也帮不上忙: 那个配置项只在 GUI
|
|
(app/farming_interface.py) 里注册, lc_mcp 走命令行子进程, 那条路径上没有监听。
|
|
|
|
默认 End(小键盘区右下角, 好按且不冲突), 可用环境变量 LCP_KILL_KEY 改成 pause / scrolllock / f11 等。
|
|
⛔ 不要用 F12: 那是 Steam 的截图键(用户 2026-10-22 指出), 按下去会弹 Steam 截图
|
|
覆盖层, 而且可能被 Steam 抢先消费。Esc / F11 也不合适 —— 游戏里分别是关菜单
|
|
和切全屏。
|
|
|
|
按下后终止任务子进程, 游戏保留。硬退出不会执行任务的 finally; 临时配置由
|
|
TaskRunner 的恢复文件机制处理。退出前先给驱动释放按住的鼠标键(on_stop),
|
|
清理或日志卡住时 STOP_TIMEOUT 后仍强制退出。监听器活在任务进程内, 所以即使
|
|
MCP 服务出问题、用户联系不上调用方, 按热键仍然能停。
|
|
"""
|
|
import ctypes
|
|
import os
|
|
import threading
|
|
import time
|
|
from contextlib import contextmanager
|
|
from functools import lru_cache
|
|
|
|
DEFAULT_KEY = 'end'
|
|
EXIT_CODE = 130 # 与 SIGINT 一致, 便于上层识别"被用户中止"
|
|
POLL_INTERVAL = 0.05 # 50ms 轮询, 人手按一下不会漏
|
|
STOP_TIMEOUT = 0.25 # 释放鼠标/写日志最多等这么久, 然后强退
|
|
START_DELAY = 0.3 # 先等一会儿, 避免把启动时按住的键当成急停
|
|
|
|
# 常用键 -> 虚拟键码。f12 保留是为了兼容旧配置, 但**不推荐** —— Steam 占用它。
|
|
VK = {
|
|
'f1': 0x70, 'f2': 0x71, 'f3': 0x72, 'f4': 0x73, 'f5': 0x74, 'f6': 0x75,
|
|
'f7': 0x76, 'f8': 0x77, 'f9': 0x78, 'f10': 0x79, 'f11': 0x7A, 'f12': 0x7B,
|
|
'esc': 0x1B, 'escape': 0x1B,
|
|
'pause': 0x13, 'break': 0x13,
|
|
'end': 0x23, 'home': 0x24, 'delete': 0x2E, 'insert': 0x2D,
|
|
'scrolllock': 0x91, 'numlock': 0x90, 'capslock': 0x14,
|
|
}
|
|
|
|
|
|
def resolve_vk(key):
|
|
"""键名 -> 虚拟键码。认不出返回 None(调用方负责报错, 不要静默用默认值)。"""
|
|
name = (key or '').strip().lower().strip('<>')
|
|
if not name:
|
|
name = DEFAULT_KEY
|
|
return VK.get(name)
|
|
|
|
|
|
@lru_cache(maxsize=None)
|
|
def _key_state_api():
|
|
"""独立绑定 GetAsyncKeyState, 不改共用的 ctypes.windll 的类型声明。"""
|
|
fn = ctypes.WinDLL('user32', use_last_error=True).GetAsyncKeyState
|
|
fn.argtypes = [ctypes.c_int]
|
|
fn.restype = ctypes.c_short
|
|
return fn
|
|
|
|
|
|
def _pressed(vk):
|
|
"""GetAsyncKeyState 的最高位 = 当前是否按下(低位只表示"按过", 不算)。"""
|
|
return bool(_key_state_api()(vk) & 0x8000)
|
|
|
|
|
|
class KillSwitch:
|
|
"""轮询线程。按住热键会立刻退出, 不会重复触发。"""
|
|
|
|
def __init__(self, vk, log=print, key_name=DEFAULT_KEY, on_stop=None):
|
|
self.vk = vk
|
|
self.log = log
|
|
self.key_name = key_name
|
|
self.on_stop = on_stop
|
|
self.fired = False
|
|
self._stopped = threading.Event()
|
|
self._thread = threading.Thread(target=self._run, daemon=True,
|
|
name='lc_mcp-killswitch')
|
|
|
|
def start(self):
|
|
self._thread.start()
|
|
return self
|
|
|
|
def is_alive(self):
|
|
return self._thread.is_alive()
|
|
|
|
def stop(self):
|
|
self._stopped.set()
|
|
|
|
def _run(self):
|
|
if self._stopped.wait(START_DELAY):
|
|
return
|
|
while not self._stopped.is_set():
|
|
try:
|
|
pressed = _pressed(self.vk)
|
|
except Exception as e: # 接口失效: 说清楚后退出, 不刷满异常
|
|
try:
|
|
self.log('[lc_mcp] 急停热键失效(%s: %s), 请用 stop_task 或 Ctrl+Alt+Del 停止'
|
|
% (type(e).__name__, e))
|
|
except Exception:
|
|
pass
|
|
return
|
|
if pressed:
|
|
self._fire()
|
|
return
|
|
self._stopped.wait(POLL_INTERVAL)
|
|
|
|
def _fire(self):
|
|
if self.fired:
|
|
return
|
|
self.fired = True
|
|
# 释放驱动按键或写日志卡住时, 由计时器按时强退。
|
|
timer = threading.Timer(STOP_TIMEOUT, os._exit, args=(EXIT_CODE,))
|
|
timer.daemon = True
|
|
try:
|
|
timer.start()
|
|
try:
|
|
if self.on_stop is not None:
|
|
self.on_stop()
|
|
except Exception:
|
|
pass # 释放失败也必须退出
|
|
try:
|
|
self.log('[lc_mcp] ⛔ 急停热键 %s 被按下, 终止任务; 游戏窗口保留, 可用 run_task 重新开始'
|
|
% self.key_name.upper())
|
|
except Exception:
|
|
pass # 日志坏了不能拦住急停
|
|
finally:
|
|
try:
|
|
os._exit(EXIT_CODE)
|
|
finally:
|
|
timer.cancel() # 仅在测试替换 _exit 时才会走到
|
|
|
|
|
|
def install(log=print, key=None, on_stop=None):
|
|
"""启动急停轮询线程。返回 KillSwitch, 失败返回 None(不抛异常)。
|
|
|
|
急停装不上不该让任务起不来, 但必须把原因和应急手段说清楚。
|
|
"""
|
|
key = key or os.environ.get('LCP_KILL_KEY') or DEFAULT_KEY
|
|
vk = resolve_vk(key)
|
|
if vk is None:
|
|
log('[lc_mcp] 急停热键不可用: 认不出键名 %r(可用: %s), 请用 Ctrl+Alt+Del 强制停止'
|
|
% (key, ', '.join(sorted(VK))))
|
|
return None
|
|
try:
|
|
_key_state_api()
|
|
except Exception as e: # 非 Windows / user32 不可用
|
|
log('[lc_mcp] 急停热键不可用(读取键盘状态失败: %s: %s), 请用 Ctrl+Alt+Del 强制停止'
|
|
% (type(e).__name__, e))
|
|
return None
|
|
try:
|
|
switch = KillSwitch(vk, log=log, key_name=key, on_stop=on_stop).start()
|
|
except Exception as e:
|
|
log('[lc_mcp] 急停热键启动失败(%s: %s), 请用 Ctrl+Alt+Del 强制停止'
|
|
% (type(e).__name__, e))
|
|
return None
|
|
log('[lc_mcp] 急停热键已就绪: 按 %s 终止任务, 游戏窗口保留; 可用 run_task 重新开始'
|
|
'(键盘可用, 不需要鼠标, 也不依赖 MCP 服务)' % key.upper())
|
|
return switch
|
|
|
|
|
|
def stop(switch):
|
|
"""停止轮询(任务结束时调用, 免得线程残留)。"""
|
|
if switch is None:
|
|
return
|
|
try:
|
|
switch.stop()
|
|
except Exception:
|
|
pass
|
|
|
|
|
|
@contextmanager
|
|
def listening(log=print, on_stop=None):
|
|
switch = install(log=log, on_stop=on_stop)
|
|
try:
|
|
yield switch
|
|
finally:
|
|
stop(switch)
|