Files
lc-mcp/tests/test_killswitch.py
T
Codex Agent 13c038a175 WindowGuard 补上窗口位置纠正(窗口出界会让抓图整体错位)
现象: 任务日志一直在动、进程正常,但几乎不点击 —— 实测 30 秒只点了 1 次。
      同时图像匹配相似度全在 0.2~0.5(AALC 阈值通常 0.8)。

排查: 游戏窗口位置是 (-8, 39) —— 左边 8 像素在屏幕外。

原因: 前台模式(background_click=false)下 AALC 从**屏幕**抓图(BitBlt 屏幕 DC),
      窗口一出界, 抓到的画面就整体偏移, 模板匹配自然全部失败; 而 AALC 的
      set_win_position=free 表示它不碰窗口位置, 所以没人管这件事。

      手动把窗口挪到 (0,0) 后, 30 秒内点击立刻恢复到 5 次 —— 确认因果。

修复: WindowGuard 原来只纠正客户区尺寸, 现在先纠正位置:
      用 monitor_info["Work"](工作区, 已扣任务栏)判断窗口是否完整落在里面,
      不在就用 SetWindowPos 夹回边界内(保留尺寸、不夺焦点)。
      位置放在尺寸检查之前 —— 出界时尺寸检查本身也没意义。

游戏每次启动都会恢复自己保存的位置, 所以这个纠正必须常驻, 不能只在启动时做一次。
2026-10-22 17:15:35 +08:00

142 lines
5.5 KiB
Python

# -*- 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('<f12>'), 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()