# -*- 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 也不合适 —— 游戏里分别是关菜单 和切全屏。Pause 没有任何软件抢, 是最稳的选择。 按下后直接 os._exit —— 任务本来就是子进程, 硬退出不留锁或半截状态, 这与 aalc_task.py "停止 = 杀进程树" 的设计前提一致。监听器活在任务进程内, 所以即使 MCP 服务出问题、用户联系不上调用方, 按热键仍然能停。 """ import ctypes import os import threading import time DEFAULT_KEY = 'end' EXIT_CODE = 130 # 与 SIGINT 一致, 便于上层识别"被用户中止" POLL_INTERVAL = 0.05 # 50ms 轮询, 人手按一下不会漏 # 常用键 -> 虚拟键码。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) def _pressed(vk): """GetAsyncKeyState 的最高位 = 当前是否按下。""" return bool(ctypes.windll.user32.GetAsyncKeyState(vk) & 0x8000) class KillSwitch: """轮询线程。按住热键会立刻退出, 不会重复触发。""" def __init__(self, vk, log=print, key_name=DEFAULT_KEY): self.vk = vk self.log = log self.key_name = key_name 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): # 先等一会儿, 避免把启动时按住的键当成急停 time.sleep(0.3) while not self._stopped.is_set(): if _pressed(self.vk): self._fire() return time.sleep(POLL_INTERVAL) def _fire(self): if self.fired: return self.fired = True try: self.log('[lc_mcp] ⛔ 急停热键 %s 被按下, 立即终止任务' % self.key_name.upper()) self.log('[lc_mcp] 游戏窗口会保留, 可用 run_task 重新开始') finally: os._exit(EXIT_CODE) def install(log=print, key=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: switch = KillSwitch(vk, log=log, key_name=key).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()) return switch def stop(switch): """停止轮询(任务正常结束时调用)。""" if switch is None: return try: switch.stop() except Exception: pass