# -*- coding: utf-8 -*- """全局急停热键。 为什么需要: 驱动级点击是闭环定位的 —— 手一动,下一次点击前会读到新位置、 算出偏差、再把你推回目标点。所以任务运行期间鼠标和人是"拔河"状态,用户没法 用鼠标去点停止按钮。键盘不受影响,所以用键盘热键做急停。 ⛔ AALC 自带的 pause_hotkey 帮不上忙: 那个配置项只在 GUI(app/farming_interface.py) 里注册, lc_mcp 走的是命令行子进程, 那条路径上没有热键监听。 默认 F12, 可用环境变量 LCP_KILL_KEY 改(取 pynput 的键名, 如 f11 / pause / esc)。 按下后直接 os._exit —— 任务本来就是子进程, 硬退出不会留下锁或半截状态, 这正是 aalc_task.py 的设计前提("停止 = 杀进程树")。 """ import os import threading DEFAULT_KEY = 'f12' EXIT_CODE = 130 # 与 SIGINT 一致, 便于上层识别"被用户中止" def _key_spec(name): """'f12' -> '',pynput 的 GlobalHotKeys 要求尖括号形式。""" name = (name or DEFAULT_KEY).strip().lower() if name.startswith('<') and name.endswith('>'): return name return '<%s>' % name def install(log=print, key=None): """启动急停监听线程。返回监听器对象(可用于测试), 失败返回 None。 任何异常都不向外抛 —— 急停装不上不该让任务起不来, 但必须把原因说清楚。 """ key = key or os.environ.get('LCP_KILL_KEY') or DEFAULT_KEY spec = _key_spec(key) try: from pynput import keyboard except Exception as e: # pynput 缺失/无显示环境 log('[lc_mcp] 急停热键不可用(pynput 加载失败: %s: %s), 请用 Ctrl+Alt+Del 强制停止' % (type(e).__name__, e)) return None state = {'fired': False} def on_activate(): if state['fired']: return state['fired'] = True log('[lc_mcp] ⛔ 急停热键 %s 被按下, 立即终止任务' % key.upper()) try: log('[lc_mcp] 游戏窗口会保留, 可用 run_task 重新开始') finally: os._exit(EXIT_CODE) try: listener = keyboard.GlobalHotKeys({spec: on_activate}) listener.daemon = True listener.start() except Exception as e: log('[lc_mcp] 急停热键注册失败(%s: %s), 请用 Ctrl+Alt+Del 强制停止' % (type(e).__name__, e)) return None log('[lc_mcp] 急停热键已就绪: 按 %s 立即停止任务(键盘可用, 不需要鼠标)' % key.upper()) listener._lc_state = state return listener def stop(listener): """停止监听(任务正常结束时调用, 免得线程残留)。""" if listener is None: return try: listener.stop() except Exception: pass