cmshoppe/docs/tasks/T-583.md at 5ac18ccc1c6147afc7fdc0054d4326d58cf88ef8

Files

T

chengmaandClaude Opus 4.8 5ac18ccc1c docs(tasks): add T-582/T-583 fix dialogs rendering half (hidpi+helper, import worker)

T-582：弹窗偶发半截修复——启动设 HiDPI 舍入策略 + 统一弹窗 helper
（通知类延迟到重绘冲刷后再 exec 治绘制竞态、几何钳制到可用屏幕治出屏），
先覆盖采集导入链路。T-583（治本）：①Excel 导入改 worker 线程，消除
GUI 阻塞与重绘积压，复用 CollectWorker 范式。

Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>

2026-07-10 10:48:40 +08:00

3.8 KiB

Raw Blame History

id, title, phase, deps, status, created

title

phase

deps

status

created

T-583

①Excel 导入改为 worker 线程执行，消除 GUI 阻塞与弹窗绘制积压（治本）

T-582

TODO

2026-07-10

问题 / 背景

①导入 Excel 目前在 GUI 线程同步执行（app/gui/tabs/collect.py:242 excel.import_tasks(file_paths, ...) 在 import_excel 按钮 handler 内直接调用）。解析+入库期间事件循环被阻塞：界面卡死、重绘积压，紧随其后的完成/错误弹窗容易在积压未冲刷时绘制，导致偶发只显示一半（T-582 分析的根因①之治本项）。

T-582 已用 HiDPI 策略 + 统一弹窗 helper（延迟冲刷 + 屏幕钳制）缓解症状；本任务把导入挪进后台 worker，从根上消除 GUI 阻塞与重绘积压，顺带解决"导入大文件时界面卡死"。

已有可复用范式：①采集本身就是 CollectWorker + run_worker 线程模型（collect.py 已有 _on_collect_finished/finished.connect/_forget_*_thread 一套），导入照搬即可。

方案（改哪个文件、改成什么）

新增 `ImportWorker`（`app/gui/workers.py`）

接收 file_paths + db_path，在 run() 里调 excel.import_tasks(...)，通过 finished 信号回传 result（stats/batch_id/errors）或异常信息；沿用现有 worker 基类/信号约定。
不在 worker 线程里碰 Qt 控件；只发信号，GUI 线程收信号后更新。

改 `collect.py` `import_excel`

选完文件后：置"导入中"状态（禁用导入按钮、状态栏提示"正在导入..."）→ 起 ImportWorker 线程（复用 run_worker/_forget_*_thread 模式）→ 立即返回，不阻塞。
新增 _on_import_finished(payload)：搬迁现同步路径里返回后的逻辑（写 run_log、has_import_result/last_import_stats/current_batch_id 赋值、file_errors/row_errors 落日志、refresh_tasks、_set_status、错误走 _show_error）。弹窗统一走 T-582 的 helper。
导入进行中：禁用「导入 Excel...」按钮，防重复导入并发写库；完成/失败后恢复。

线程安全 / 边界

run_log 的写入若在 worker 线程发生，确认 DB 访问与现有 worker 一致（各自连接、不跨线程共享 sqlite 连接）。
导入与①采集/删除批次等其它写库操作互斥或至少不并发同一批次（沿用现有 running 守卫思路）。

验收要点

点「导入 Excel...」选文件后：GUI 不卡死（导入在后台线程），按钮置为导入中/禁用，状态栏提示进行中。
导入完成：_on_import_finished 更新 stats/batch_id、刷新列表、状态栏汇总，与旧同步路径结果一致（单测：mock excel.import_tasks 返回固定 stats，断言完成回调产生同样的 UI 状态/日志）。
导入失败：走 _show_error（经 T-582 helper）、写失败 run_log/诊断日志，不吞异常。
导入进行中「导入 Excel...」按钮禁用，完成后恢复。
worker 线程内不触碰 Qt 控件（review + 单测 mock 校验信号路径）。
大文件导入期间界面可响应（人工验证点，记录到执行记录）。
验证命令（unittest，不引入 pytest）：
- py -3.10 -m unittest tests.test_gui
- python -m ruff check app tests main.py
- py -3.10 -m compileall app main.py
- py -3.10 -m unittest discover -s tests
- git diff --check

边界（不改什么）

不改 excel.import_tasks 解析/入库逻辑本身，只改调用它的线程。
不改导入结果的数据结构/stats 字段、批次生成逻辑。
不改①采集 CollectWorker、③更新、CDP/DB schema/AI/cmhub。
弹窗渲染修复本身属于 T-582，本任务只保证导入走 helper。

执行记录

（做完在这里写：改了什么文件、跑了什么验证命令及结果、遇到的阻塞、关键决策。）

3.8 KiB Raw Blame History Unescape Escape