合并 main 的合并前复核修复到镜牢选队分支

Browse Source
分支从 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:
yws
2026-11-14 03:19:53 +00:00
co-authored by Claude Opus 5.5
14 changed files with 490 additions and 182 deletions
+76 -19
View File
@@ -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)