This website requires JavaScript.
0
Issues
Pull Requests
Milestones
Explore
0
Create…
New Repository
New Migration
New Organization
public
Signed in as
public
Profile
Starred
Subscriptions
Settings
Help
Sign Out
yws
/
lc-mcp
Watch
1
Star
0
Fork
0
Code
Issues
Pull Requests
Actions
Packages
Projects
Releases
Wiki
Activity
Files
lc-mcp
/
lc_mcp
/
or
Cancel
Edit File
Preview
Preview Changes
Spaces
Tabs
2
4
8
Wrap
No wrap
# -*- 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)
Commit Changes
Add a Signed-off-by trailer by the committer at the end of the commit log message.
Commit directly to the
codex/feedback-unattended-setup-20261004
branch.
Create a
new branch
for this commit and start a pull request.
Commit Changes
Cancel