From ce35d6191e18cfc3752dd5c1daa782e7f6445df1 Mon Sep 17 00:00:00 2001 From: Codex Agent Date: Fri, 16 Oct 2026 12:08:38 +0800 Subject: [PATCH] =?UTF-8?q?=E5=90=88=E6=88=90:=20=E5=88=A0=E6=8E=89?= =?UTF-8?q?=E4=B8=80=E4=B8=AA=E6=AD=BB=E5=B8=B8=E9=87=8F,=20=E5=B9=B6?= =?UTF-8?q?=E5=8A=A0=E6=B5=8B=E8=AF=95=E9=98=B2=E6=AD=A2=E5=86=8D=E6=94=92?= =?UTF-8?q?=E5=87=BA=E6=9D=A5?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit MODULE_ICON 之外还有个 TAB_USE_BOXES(界面上的第三个页签"用体力箱"), 从来没被引用过 —— 本项目只走 Modules 页签。留着它的坏处不是占地方, 而是会让人以为某条代码路径 处理了它。死代码比没有更糟, 这和前几轮那批"看起来在查、实际查不到"是同一种病。 处理: * 删掉 TAB_USE_BOXES 常量, 把"三个页签的位置和用途"写进源码注释, 知识不丢 * 新增 NoDeadConstantsTest: 顶层全大写常量必须真的被引用(统计范围含测试文件, 因为 USE_LUNACY_TAB 这类常量是故意只被测试引用的 —— 它给"绝不许点"提供锚点) * 顺带修正那条锁页签布局的测试(它引用了被删的常量), 改成锁我们会点的两个 验证: 临时插一个 UNUSED_PROBE 常量, 测试准确报出"这些常量从没被引用过: UNUSED_PROBE"; 还原后通过。实机复验脚本仍能正常 import。 全套 311/311 通过。 --- scripts/convert_modules.py | 6 ++++- tests/test_convert_modules.py | 49 +++++++++++++++++++++++++++++++++-- 2 files changed, 52 insertions(+), 3 deletions(-) diff --git a/scripts/convert_modules.py b/scripts/convert_modules.py index 728f256..09e824b 100644 --- a/scripts/convert_modules.py +++ b/scripts/convert_modules.py @@ -37,10 +37,14 @@ PYW = os.path.join(REPO, 'vendor', 'aalc', '.venv', 'Scripts', 'pythonw.exe') SERVER_PORT = 8765 # --- 坐标(1600x900 基准; lc_ui 会换算到真实客户区) --- +# 合成面板有三个页签, 从左到右: Modules / Use Lunacy / Use Boxes +# Modules (619,283) 免费合成, 本项目只走这条 +# Use Lunacy(797,283) ⛔ 花狂气, 绝对不许点 +# Use Boxes (957,283) 用体力箱, 本项目不用 —— 不定义常量: 定义了却没人用 +# 会让人以为某条路径处理了它, 死代码比没有更糟 MODULE_ICON = (390, 805) # 主界面底栏, 绿胶囊图标(点开合成面板) TAB_MODULES = (619, 283) # 免费合成页签 USE_LUNACY_TAB = (797, 283) # ⛔ 绝对不许点 -TAB_USE_BOXES = (957, 283) # 用体力箱, 本项目不用 BTN_MAX = (1019, 413) # »: 取当前能合成的最大数量 BTN_CONFIRM = (943, 671) # 确认合成 BTN_CANCEL = (656, 670) # 取消 / 关闭面板 diff --git a/tests/test_convert_modules.py b/tests/test_convert_modules.py index 52c9f80..dcadbdd 100644 --- a/tests/test_convert_modules.py +++ b/tests/test_convert_modules.py @@ -514,6 +514,47 @@ class NoRealReportPollutionTest(unittest.TestCase): + ', '.join(offenders)) +class NoDeadConstantsTest(unittest.TestCase): + """顶层的全大写常量必须真的被用到。 + + 删过一个 TAB_USE_BOXES(界面上的第三个页签, 本项目不用) —— 它从来没被引用过。 + 留着它的坏处不是占地方, 而是**会让人以为某条代码路径处理了它**。 + 死代码比没有更糟, 这条测试把口子堵上。 + + 统计范围包含测试文件: 有些常量(比如 USE_LUNACY_TAB)只被测试引用, 那是有意的 + —— 它的存在就是为了让"绝不许点"这件事有个可断言的锚点。 + """ + + def test_every_module_level_constant_is_referenced(self): + import ast + root = Path(__file__).resolve().parents[1] + src = (root / 'scripts' / 'convert_modules.py').read_text(encoding='utf-8') + tree = ast.parse(src) + + names = [] + for node in tree.body: + if isinstance(node, ast.Assign): + for t in node.targets: + if isinstance(t, ast.Name) and t.id.isupper(): + names.append(t.id) + + others = ((root / 'scripts' / 'convert_modules.py').read_text(encoding='utf-8'), + (root / 'tests' / 'test_convert_modules.py').read_text(encoding='utf-8')) + dead = [] + for n in names: + uses = 0 + for text in others: + for line in text.splitlines(): + s = line.strip() + if s.startswith(n + ' =') or s.startswith(n + '='): + continue # 定义行本身不算 + if n in line: + uses += 1 + if uses == 0: + dead.append(n) + self.assertFalse(dead, '这些常量从没被引用过, 请删掉或说明理由: ' + ', '.join(dead)) + + class ForbiddenCoordinateTest(QuietLogMixin, unittest.TestCase): """Use Lunacy 页签的坐标只能用于"确认没点到它", 不能出现在任何点击路径上。 @@ -549,10 +590,14 @@ class ForbiddenCoordinateTest(QuietLogMixin, unittest.TestCase): self.assertFalse(offenders, 'click() 用到了 Use Lunacy 页签坐标: ' + ', '.join(offenders)) def test_the_constant_still_exists_and_is_where_we_think(self): - """万一布局变了, 这条会提醒重新量坐标, 而不是让上面那条静静地失效。""" + """万一布局变了, 这条会提醒重新量坐标, 而不是让上面那条静静地失效。 + + 只锁"我们会点的那个"和"绝不能点的那个"。Use Boxes 的坐标只写在源码注释里 + —— 本项目不用它, 所以不定义常量(定义了却没人用, 会让人以为某条路径处理了它)。 + """ self.assertEqual(cm.USE_LUNACY_TAB, (797, 283)) self.assertLess(cm.TAB_MODULES[0], cm.USE_LUNACY_TAB[0]) # Modules 在左 - self.assertLess(cm.USE_LUNACY_TAB[0], cm.TAB_USE_BOXES[0]) # Use Boxes 在右 + self.assertAlmostEqual(cm.TAB_MODULES[1], cm.USE_LUNACY_TAB[1], delta=5) if __name__ == '__main__':