# -*- coding: utf-8 -*- """急停热键。 背景(2026-10-22, 用户提问"你执行脚本的时候我鼠标没法动,我怎么停止呢"): 驱动级点击是闭环定位 —— 手一动, 下一次点击前会读到新位置、算出偏差、再把你推回 目标点。所以任务跑起来时鼠标是"拔河"状态, 用户没法用鼠标去点停止按钮。键盘不受 影响, 所以急停必须走键盘。 实现上踩过一个坑: 先用了 pynput 的 GlobalHotKeys, 静态注册成功、线程也活着, 但 keybd_event 和 SendInput 两种注入都触发不了它 —— 钩子在当前会话下收不到键。 改成 GetAsyncKeyState 轮询后实测可用。这里的测试守住轮询方案的几个关键性质, 以及急停时"先放开鼠标、卡住也按时退出"的保证。 """ import sys import tempfile import threading import unittest from pathlib import Path from unittest import mock sys.path.insert(0, str(Path(__file__).resolve().parents[1])) from lc_mcp import killswitch # noqa: E402 PRESSED = -32768 # SHORT 0x8000: GetAsyncKeyState 的"当前按下"位 def key_state(value): return mock.patch.object(killswitch, '_key_state_api', return_value=lambda vk: value) class ResolveVkTest(unittest.TestCase): """键名解析必须严格: 认不出来要返回 None, 不能悄悄用默认值 —— 否则用户以为设成了 F11, 实际还在监听别的键。""" def test_common_keys(self): self.assertEqual(killswitch.resolve_vk('f12'), 0x7B) self.assertEqual(killswitch.resolve_vk('F11'), 0x7A) self.assertEqual(killswitch.resolve_vk('esc'), 0x1B) self.assertEqual(killswitch.resolve_vk('pause'), 0x13) def test_default_is_end_not_steam_screenshot_key(self): self.assertEqual(killswitch.DEFAULT_KEY, 'end') self.assertEqual(killswitch.resolve_vk(None), 0x23) def test_accepts_angle_brackets(self): self.assertEqual(killswitch.resolve_vk(''), 0x7B) def test_trims_whitespace(self): self.assertEqual(killswitch.resolve_vk(' F12 '), 0x7B) def test_empty_uses_default(self): for key in ('', None, ' '): self.assertEqual(killswitch.resolve_vk(key), killswitch.VK[killswitch.DEFAULT_KEY]) def test_unknown_returns_none(self): self.assertIsNone(killswitch.resolve_vk('nosuchkey')) class InstallTest(unittest.TestCase): """装不上不能把任务带崩,但必须说清楚怎么应急。""" def test_reports_unknown_key_and_suggests_fallback(self): lines = [] got = killswitch.install(log=lines.append, key='nosuchkey') self.assertIsNone(got) joined = '\n'.join(lines) self.assertIn('认不出键名', joined) self.assertIn('Ctrl+Alt+Del', joined, '必须给出应急手段') def test_reports_when_keyboard_api_is_unavailable(self): lines = [] with mock.patch.object(killswitch, '_key_state_api', side_effect=AttributeError('no user32')): got = killswitch.install(log=lines.append) self.assertIsNone(got) joined = '\n'.join(lines) self.assertIn('急停热键不可用', joined) self.assertIn('Ctrl+Alt+Del', joined) def test_installs_and_logs_the_key(self): lines = [] with key_state(0), mock.patch.object(killswitch.KillSwitch, 'start', lambda self: self): switch = killswitch.install(log=lines.append, key='f11') self.assertIsInstance(switch, killswitch.KillSwitch) self.assertEqual(switch.vk, 0x7A) joined = '\n'.join(lines) self.assertIn('F11', joined) self.assertIn('游戏窗口保留', joined) def test_env_var_overrides_default(self): with mock.patch.dict(killswitch.os.environ, {'LCP_KILL_KEY': 'esc'}), key_state(0), \ mock.patch.object(killswitch.KillSwitch, 'start', lambda self: self): switch = killswitch.install(log=lambda m: None) self.assertEqual(switch.vk, 0x1B) def test_start_failure_is_reported_not_raised(self): lines = [] with key_state(0), mock.patch.object(killswitch.KillSwitch, 'start', side_effect=RuntimeError('boom')): got = killswitch.install(log=lines.append) self.assertIsNone(got) self.assertIn('启动失败', '\n'.join(lines)) class PollingTest(unittest.TestCase): """轮询判断的核心:0x8000 位。测错位会导致"一直触发"或"永不触发"。""" def test_high_bit_means_pressed(self): for value in (PRESSED, PRESSED | 1): with self.subTest(value=value), key_state(value): self.assertTrue(killswitch._pressed(0x7B)) def test_low_bits_are_not_pressed(self): # 0x0001 表示"上次调用后被按过", 不代表当前按住 —— 不能当成按下 with key_state(0x0001): self.assertFalse(killswitch._pressed(0x7B)) def test_zero_is_not_pressed(self): with key_state(0): self.assertFalse(killswitch._pressed(0x7B)) def test_poll_thread_fires_on_press(self): sw = killswitch.KillSwitch(0x23, log=lambda m: None) exited = threading.Event() with key_state(PRESSED), mock.patch.object(killswitch, 'START_DELAY', 0), \ mock.patch.object(killswitch.os, '_exit', side_effect=lambda code: exited.set()): sw.start() self.assertTrue(exited.wait(2)) sw._thread.join(2) self.assertTrue(sw.fired) def test_broken_api_stops_polling_with_a_message(self): lines = [] sw = killswitch.KillSwitch(0x23, log=lines.append) with mock.patch.object(killswitch, '_key_state_api', side_effect=OSError('gone')), \ mock.patch.object(killswitch, 'START_DELAY', 0), \ mock.patch.object(killswitch.os, '_exit') as fake_exit: sw.start() sw._thread.join(2) self.assertFalse(sw.is_alive()) fake_exit.assert_not_called() self.assertIn('急停热键失效', '\n'.join(lines)) class FireTest(unittest.TestCase): def _switch(self, log=lambda m: None, on_stop=None): return killswitch.KillSwitch(0x23, log=log, key_name='end', on_stop=on_stop) def test_exits_with_user_abort_code_and_only_fires_once(self): sw = self._switch() with mock.patch.object(killswitch.os, '_exit') as fake_exit: sw._fire() sw._fire() sw._fire() fake_exit.assert_called_once_with(killswitch.EXIT_CODE) def test_logs_that_game_is_kept(self): lines = [] with mock.patch.object(killswitch.os, '_exit'): self._switch(log=lines.append)._fire() joined = '\n'.join(lines) self.assertIn('END', joined) self.assertIn('重新开始', joined) def test_releases_input_before_logging_and_exiting(self): calls = [] sw = self._switch(log=lambda m: calls.append('log'), on_stop=lambda: calls.append('release')) with mock.patch.object(killswitch.os, '_exit', side_effect=lambda code: calls.append(code)): sw._fire() self.assertEqual(calls, ['release', 'log', 130]) def test_broken_cleanup_or_log_cannot_disable_the_hotkey(self): def cleanup(): raise OSError('driver disconnected') log = mock.Mock(side_effect=OSError('closed log')) with mock.patch.object(killswitch.os, '_exit') as fake_exit: self._switch(log=log, on_stop=cleanup)._fire() fake_exit.assert_called_once_with(130) def test_hung_cleanup_cannot_block_exit_deadline(self): release, exited = threading.Event(), threading.Event() sw = self._switch(on_stop=release.wait) with mock.patch.object(killswitch.os, '_exit', side_effect=lambda code: exited.set()): worker = threading.Thread(target=sw._fire, daemon=True) worker.start() try: self.assertTrue(exited.wait(2), '清理卡住也必须触发强退') finally: release.set() worker.join(2) def test_real_emergency_exit_is_reported_as_stopped(self): from lc_mcp.tasks import TaskRunner child = """ import json, os, time from lc_mcp import killswitch from lc_mcp.aalc_task import RESTORE_ENV with open(os.environ[RESTORE_ENV], 'w') as f: json.dump({'set_mirror_count': 1}, f) killswitch._key_state_api = lambda: (lambda vk: -32768) killswitch.install(log=lambda msg: None) time.sleep(10) """ with tempfile.TemporaryDirectory() as tmp: runner = TaskRunner(tmp, argv_factory=lambda t, p: [sys.executable, '-c', child]) self.assertTrue(runner.start('mirror', {'count': 2})['ok']) self.addCleanup(runner.proc.kill) runner.proc.wait(timeout=5) status = runner.status() self.assertEqual((status['state'], status['exit_code']), ('stopped', 130)) self.assertTrue(status['pending_restore'], '强退保留配置恢复文件, 下次启动前由服务处理') class StopTest(unittest.TestCase): def test_stop_is_safe_on_none(self): killswitch.stop(None) # 不该抛 def test_stop_calls_switch(self): sw = mock.Mock() killswitch.stop(sw) sw.stop.assert_called_once() def test_stop_swallows_errors(self): sw = mock.Mock() sw.stop.side_effect = RuntimeError('boom') killswitch.stop(sw) # 不该抛 def test_stopped_switch_does_not_poll(self): sw = killswitch.KillSwitch(0x23, log=lambda m: None) with key_state(PRESSED), mock.patch.object(killswitch.os, '_exit') as fake_exit: sw.stop() sw.start() sw._thread.join(2) fake_exit.assert_not_called() def test_listening_passes_cleanup_and_stops_on_return_and_exception(self): cleanup = object() for failure in (False, True): switch = mock.Mock() with self.subTest(failure=failure), \ mock.patch.object(killswitch, 'install', return_value=switch) as install: try: with killswitch.listening(on_stop=cleanup): if failure: raise RuntimeError('task failed') except RuntimeError: pass self.assertIs(install.call_args.kwargs['on_stop'], cleanup) switch.stop.assert_called_once() if __name__ == '__main__': unittest.main()