From 6a8ba0e4bcd008a127e2e9296ff1e4bc54c80b34 Mon Sep 17 00:00:00 2001 From: Codex Agent Date: Fri, 16 Oct 2026 12:11:59 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=88=E6=88=90:=20=E4=BF=AE=E6=8E=89?= =?UTF-8?q?=E4=B8=80=E4=B8=AA=E4=BC=9A=E8=AF=AF=E8=A7=A6=20Inventory=20?= =?UTF-8?q?=E7=9A=84=E5=9D=90=E6=A0=87,=20=E5=B9=B6=E6=8A=8A"=E8=83=BD?= =?UTF-8?q?=E7=82=B9=E5=88=B0=E5=93=AA=E9=87=8C"=E9=92=89=E6=AD=BB?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 这轮做静态审计: 把脚本里所有输入调用列出来逐个确认安全(用户的两条硬约束就靠 这几个坐标)。全脚本只有 7 处, 审查面很小, 结果查出第 383 行有问题: click(800, 830) # wait_main_menu 里推进标题/剧情/公告用的 对照之前 dump 的底栏 OCR: Inventory @(759,834) w=91 -> 跨度 759~850 (800,830) 正好落在 Inventory 按钮里。wait_main_menu 每轮虽然都先检查"是不是主界面" 再点击, 但画面恰在这一瞬切过去的话, 这一下就点在 Inventory 上了 —— 后果不重 (只是开个背包), 却会让循环卡在一个预期之外的界面上, 白等一轮。 改成 (800, 450)(屏幕中央): 任何界面上都无害, 一样能推进剧情。 并加 SafeClickTargetsTest 钉死这件事: * 裸坐标的 click/long_press 必须在白名单里(目前只有两个), 新增的会被拦下 * 推进用的点击 y 必须 < 780, 不能落在底栏区 验证: 故意把坐标改回 (800,830), 两条测试分别报 "830 not less than 780: line 387 的点击落在底栏区" 和 "出现了未经审查的裸坐标点击: line 387: click(800, 830)"; 还原后通过。 全套 313/313 通过。 --- scripts/convert_modules.py | 8 +++-- tests/test_convert_modules.py | 64 +++++++++++++++++++++++++++++++++++ 2 files changed, 70 insertions(+), 2 deletions(-) diff --git a/scripts/convert_modules.py b/scripts/convert_modules.py index 09e824b..9ab43d1 100644 --- a/scripts/convert_modules.py +++ b/scripts/convert_modules.py @@ -379,8 +379,12 @@ def wait_main_menu(timeout_s=300): if 'DOWNLOADING' in txt.upper(): time.sleep(10) continue - # 标题/剧情/公告: 先点一下再按 Enter, 覆盖两种推进方式 - click(800, 830) + # 标题/剧情/公告: 先点一下再按 Enter, 覆盖两种推进方式。 + # ⛔ 位置选屏幕中央而不是下方: 底栏 (800,830) 正好落在 Inventory 按钮里 + # (实测 OCR: Inventory @(759,834) w=91, 跨度 759~850)。上面虽然每轮都先 + # 查过"是不是主界面", 但画面恰在这一瞬切过去的话, 这一下就点在 Inventory + # 上了 —— 后果不重(只是开个背包), 却会让循环卡在一个预期之外的界面上。 + click(800, 450) time.sleep(1.2) keypress('enter') time.sleep(2.0) diff --git a/tests/test_convert_modules.py b/tests/test_convert_modules.py index dcadbdd..6b6eaa4 100644 --- a/tests/test_convert_modules.py +++ b/tests/test_convert_modules.py @@ -514,6 +514,70 @@ class NoRealReportPollutionTest(unittest.TestCase): + ', '.join(offenders)) +class SafeClickTargetsTest(QuietLogMixin, unittest.TestCase): + """脚本能点到的地方必须逐个安全 —— 用户的两条硬约束就靠这几个坐标。 + + 整个脚本只有 7 处输入调用(其余全在合成面板内部或底栏模组图标上), 所以这个 + 审查面很小, 值得把它钉死: 任何新增的裸坐标点击都要有明确的理由。 + """ + + SAFE_LITERALS = { + (800, 450): '屏幕中央, 推进标题/剧情/公告 —— 任何界面上都无害', + (656, 670): 'BTN_CANCEL, 只关面板', + } + + def _calls(self): + import ast + src = (Path(__file__).resolve().parents[1] / 'scripts' / 'convert_modules.py') \ + .read_text(encoding='utf-8') + out = [] + for node in ast.walk(ast.parse(src)): + if isinstance(node, ast.Call): + name = getattr(node.func, 'id', None) or getattr(node.func, 'attr', None) + if name in ('click', 'long_press'): + out.append(node) + return out + + def test_literal_click_coordinates_are_whitelisted(self): + import ast + bad = [] + for node in self._calls(): + if len(node.args) != 2: + continue # click(*CONST) 形式, 由常量保证 + vals = [] + for a in node.args: + if isinstance(a, ast.Constant) and isinstance(a.value, int): + vals.append(a.value) + else: + vals = None + break + if not vals: + continue + if tuple(vals) not in self.SAFE_LITERALS: + bad.append('line %d: click(%d, %d)' % (node.lineno, *vals)) + self.assertFalse(bad, + '出现了未经审查的裸坐标点击, 请先确认它不会误触:\n ' + + '\n '.join(bad)) + + def test_advance_click_is_not_on_the_bottom_bar(self): + """推进用的点击不能落在底栏 —— 那里有 Inventory 等按钮。 + + ⛔ 曾经用 (800,830), 而 Inventory 按钮实测是 @(759,834) w=91(跨度 759~850), + 正好把它包住。画面恰在检查与点击之间切到主界面时就会误触。 + """ + import ast + for node in self._calls(): + if len(node.args) != 2: + continue + try: + x = node.args[0].value + y = node.args[1].value + except AttributeError: + continue + self.assertLess(y, 780, + 'line %d 的点击在 y=%d, 落在底栏区(>=780)' % (node.lineno, y)) + + class NoDeadConstantsTest(unittest.TestCase): """顶层的全大写常量必须真的被用到。