合并 main 的合并前复核修复到镜牢选队分支
分支从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>
This commit is contained in:
+76
-19
@@ -18,19 +18,25 @@
|
||||
默认 End(小键盘区右下角, 好按且不冲突), 可用环境变量 LCP_KILL_KEY 改成 pause / scrolllock / f11 等。
|
||||
⛔ 不要用 F12: 那是 Steam 的截图键(用户 2026-10-22 指出), 按下去会弹 Steam 截图
|
||||
覆盖层, 而且可能被 Steam 抢先消费。Esc / F11 也不合适 —— 游戏里分别是关菜单
|
||||
和切全屏。Pause 没有任何软件抢, 是最稳的选择。
|
||||
按下后直接 os._exit —— 任务本来就是子进程, 硬退出不留锁或半截状态, 这与
|
||||
aalc_task.py "停止 = 杀进程树" 的设计前提一致。监听器活在任务进程内,
|
||||
所以即使 MCP 服务出问题、用户联系不上调用方, 按热键仍然能停。
|
||||
和切全屏。
|
||||
|
||||
按下后终止任务子进程, 游戏保留。硬退出不会执行任务的 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 = {
|
||||
@@ -51,18 +57,28 @@ def resolve_vk(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(ctypes.windll.user32.GetAsyncKeyState(vk) & 0x8000)
|
||||
"""GetAsyncKeyState 的最高位 = 当前是否按下(低位只表示"按过", 不算)。"""
|
||||
return bool(_key_state_api()(vk) & 0x8000)
|
||||
|
||||
|
||||
class KillSwitch:
|
||||
"""轮询线程。按住热键会立刻退出, 不会重复触发。"""
|
||||
|
||||
def __init__(self, vk, log=print, key_name=DEFAULT_KEY):
|
||||
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,
|
||||
@@ -79,28 +95,54 @@ class KillSwitch:
|
||||
self._stopped.set()
|
||||
|
||||
def _run(self):
|
||||
# 先等一会儿, 避免把启动时按住的键当成急停
|
||||
time.sleep(0.3)
|
||||
if self._stopped.wait(START_DELAY):
|
||||
return
|
||||
while not self._stopped.is_set():
|
||||
if _pressed(self.vk):
|
||||
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
|
||||
time.sleep(POLL_INTERVAL)
|
||||
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:
|
||||
self.log('[lc_mcp] ⛔ 急停热键 %s 被按下, 立即终止任务'
|
||||
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())
|
||||
self.log('[lc_mcp] 游戏窗口会保留, 可用 run_task 重新开始')
|
||||
except Exception:
|
||||
pass # 日志坏了不能拦住急停
|
||||
finally:
|
||||
try:
|
||||
os._exit(EXIT_CODE)
|
||||
finally:
|
||||
timer.cancel() # 仅在测试替换 _exit 时才会走到
|
||||
|
||||
|
||||
def install(log=print, key=None):
|
||||
"""启动急停轮询线程。返回 KillSwitch, 失败返回 None(不抛异常)。"""
|
||||
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:
|
||||
@@ -108,21 +150,36 @@ def install(log=print, key=None):
|
||||
% (key, ', '.join(sorted(VK))))
|
||||
return None
|
||||
try:
|
||||
switch = KillSwitch(vk, log=log, key_name=key).start()
|
||||
_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 立即停止任务(键盘可用, 不需要鼠标, '
|
||||
'也不依赖 MCP 服务)' % key.upper())
|
||||
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)
|
||||
|
||||
Reference in New Issue
Block a user