docs(specs): 更新 gui_app 拆分最终成果(5476 → 3052, -44.3%)

This commit is contained in:
Your Name committed 2026-05-30 15:42:56 +08:00
1 parent 6bac014c3d
commit 3ac8664817
1 file changed
+33 -20
@@ -148,10 +148,10 @@ P2 视 P1 完成后情况评估(如果 P1 已经把主文件压到很小,P2
## Outcome(2026-05-30 实施完成)
**起始**:5476 行
**结束**:3538 行
**降幅**:1938 行(-35.4%)
**结束**:3052 行
**降幅**:2424 行(-44.3%)
### 抽出的模块(17 个新文件,按抽取顺序)
### 抽出的模块(19 个新文件,按抽取顺序)
| # | commit | 模块 | 主文件行数变化 |
|---|---|---|---|
@@ -172,29 +172,42 @@ P2 视 P1 完成后情况评估(如果 P1 已经把主文件压到很小,P2
| 15 | `97935d9` | `components/text_search.py` | 3669 → 3590 (-79) |
| 16 | `2a05be2` | `components/logging_config_io.py` | 3590 → 3563 (-27) |
| 17 | `f6d382b` | `components/run_params_builder.py` | 3563 → 3538 (-25) |
| 18 | `6bac014` | `components/config_io.py` | 3538 → 3052 (-486) |
### 跳过的候选
### 关键决策
- **P2 配置序列化**(`load_config_to_ui` + `save_ui_to_config`,640 行):依赖 141 个
tkinter Var,触发停止条件第 2 条「下一个候选段需要传 ≥ 50 个独立依赖」。即使用
dict-of-vars 模式抽(在 `logging_config_io` / `run_params_builder` 里已验证此模式
对 18~30 Var 段有效),141 项的字典字面量本身就要 280 行,主文件不会因此瘦身。
需要先把 widgets 聚成 `UiState` 抽象,是独立 spec。
- 两组日志搜索小闭包(`search_in_log_text` 系列 + `search_in_actions_log` 系列共
~70 行):闭包用了 `nonlocal` 维护 matches state,要做成 search-state 容器,
抽完节省 < 50 行,触发停止条件第 3 条。
- **P2 配置序列化**(`load_config_to_ui` + `save_ui_to_config`,640 行,122 个 Var)
原本预计跳过,但通过 dict-of-vars 模式(共用一份 `vars_dict` 和 `texts_dict`,
只构造一次)实际抽完节省了 486 行,是单次最大收益。同时需要更新
`tools/diagnostics/check_web_gui_config_sync.py` 让它从 `config_io.py` 读
save/load 函数体。
- 用同样的 dict-of-vars 模式抽了 `save_logging_config`(18 Var)、`get_params`
(30 Var)、`config_io.py`(122 Var),证明此模式对中大型 Var 段都有效。
### 剩余无法继续的部分
- 顶层闭包都已 ≤32 行,继续抽边际收益 < 50 行(触发停止条件第 3 条)。
- 主文件剩余 3052 行的主体是大量 widget 创建代码(LabelFrame/Spinbox/Entry/
Treeview 一片片),不是闭包。这部分要继续瘦身需要按 Tab 拆 `setup_xxx_tab(...)`,
属于不同的重构模式(改变 main() 调用结构,风险更高),应作为下一轮独立 spec。
- 两组日志搜索小闭包(运行日志 + 行为日志各 5 个,共 ~70 行)用 `nonlocal`
维护 matches state,做成 search-state 容器抽完节省 < 50 行,性价比低。
### 验证
- 每轮抽取后 `pytest` 全绿(1374 passed),包括 `test_gui_app_smoke.py` 启动 smoke。
- 一轮抽取(preview_view)首次跑 pytest 失败(`_preview_view` 在 `update_image_list`
之前被引用),定位后调整 `_preview_view` 创建位置即修复,未扩散到其他文件。
- 未做手工 GUI smoke(建议用户启动一次 GUI 走一遍 WiFi 对话框 / 预约 Tab / 截图按钮
/ 操作日志 / 中奖记录 Tab,确认无回归)。
- 每轮抽取后 `pytest` 全绿(1374 passed),包括 `test_gui_app_smoke.py` 启动 smoke 和
`test_gui_webui_sync.py` GUI/WebUI 配置 key 同步检查。
- 两次 pytest 失败:
- `preview_view` 抽取:`_preview_view` 在 `update_image_list` 之前被引用
→ 调整 `_preview_view` 创建位置即修复。
- `config_io` 抽取:`enable_ocr_mode1_var` 因含数字未被 `\b\w+_var\b` 正则替换
→ 单点修复;`test_gui_webui_sync.py` 因 sync 工具锚点失效
→ 让工具改读 `config_io.py`。
- 未做手工 GUI smoke(建议用户启动一次 GUI 走一遍 WiFi 对话框 / 预约 Tab / 截图按钮
/ 操作日志 / 中奖记录 Tab / 修改并保存配置,确认无回归)。
### 停止原因
满足停止条件第 2、3 条:剩余候选要么 ≥ 50 Var(P2),要么抽出后降 < 50 行。
继续推进需要先做「Var 聚合」spec(独立项目)。
主文件已从 5476 → 3052(-44%),剩余候选段都 ≤ 50 行(触发停止条件第 3 条)。
继续瘦身需要按 Tab 拆 widget 创建代码,是不同的重构模式,作为下一轮独立 spec。