# -*- coding: utf-8 -*- """急停热键。 背景(2026-10-22, 用户提问"你执行脚本的时候我鼠标没法动,我怎么停止呢"): 驱动级点击是闭环定位 —— 手一动, 下一次点击前会读到新位置、算出偏差、再把你推回 目标点。所以任务跑起来时鼠标是"拔河"状态, 用户没法用鼠标去点停止按钮。键盘不受 影响, 所以急停必须走键盘。 实现上踩过一个坑: 先用了 pynput 的 GlobalHotKeys, 静态注册成功、线程也活着, 但 keybd_event 和 SendInput 两种注入都触发不了它 —— 钩子在当前会话下收不到键。 改成 GetAsyncKeyState 轮询后实测可用。这里的测试守住轮询方案的几个关键性质。 """ import sys 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 class ResolveVkTest(unittest.TestCase): """键名解析必须严格: 认不出来要返回 None, 不能悄悄用默认值 —— 否则用户以为设成了 F11, 实际还在监听 F12。""" 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_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): self.assertEqual(killswitch.resolve_vk(''), killswitch.VK[killswitch.DEFAULT_KEY]) self.assertEqual(killswitch.resolve_vk(None), 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_installs_and_logs_the_key(self): lines = [] with 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) self.assertIn('F11', '\n'.join(lines)) def test_env_var_overrides_default(self): with mock.patch.dict(killswitch.os.environ, {'LCP_KILL_KEY': 'esc'}), \ 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 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): with mock.patch.object(killswitch.ctypes.windll.user32, 'GetAsyncKeyState', return_value=0x8000): self.assertTrue(killswitch._pressed(0x7B)) def test_low_bits_are_not_pressed(self): # 0x0001 表示"上次调用后被按过", 不代表当前按住 —— 不能当成按下 with mock.patch.object(killswitch.ctypes.windll.user32, 'GetAsyncKeyState', return_value=0x0001): self.assertFalse(killswitch._pressed(0x7B)) def test_zero_is_not_pressed(self): with mock.patch.object(killswitch.ctypes.windll.user32, 'GetAsyncKeyState', return_value=0): self.assertFalse(killswitch._pressed(0x7B)) class FireTest(unittest.TestCase): def _switch(self): return killswitch.KillSwitch(0x7B, log=lambda m: None, key_name='f12') def test_exits_with_user_abort_code(self): sw = self._switch() with mock.patch.object(killswitch.os, '_exit') as fake_exit: sw._fire() fake_exit.assert_called_once_with(killswitch.EXIT_CODE) def test_only_fires_once(self): sw = self._switch() with mock.patch.object(killswitch.os, '_exit') as fake_exit: sw._fire() sw._fire() sw._fire() self.assertEqual(fake_exit.call_count, 1, '重复触发不该重复退出') def test_logs_that_game_is_kept(self): lines = [] sw = killswitch.KillSwitch(0x7B, log=lines.append, key_name='f12') with mock.patch.object(killswitch.os, '_exit'): sw._fire() joined = '\n'.join(lines) self.assertIn('F12', joined) self.assertIn('重新开始', joined) class StopTest(unittest.TestCase): def test_stop_is_safe_on_none(self): killswitch.stop(None) def test_stop_swallows_errors(self): sw = mock.Mock() sw.stop.side_effect = RuntimeError('boom') killswitch.stop(sw) if __name__ == '__main__': unittest.main()