22 lines
1.2 KiB
Python
22 lines
1.2 KiB
Python
|
"""PDD 任务页的事件绑定。
|
|||
|
|
|
|||
|
|
把 `pdd_ui.py` 里控件的信号，接到查询、任务引擎等实际动作上。
|
|||
|
|
|
|||
|
|
改动本文件前必读 `client/AGENTS.md`。以下几条最容易踩：
|
|||
|
|
|
|||
|
|
- **禁止在 Qt 主线程做任何阻塞的事**：Admin 请求、uiautomator2/ADB 调用、
|
|||
|
|
`time.sleep()`、轮询、大 XML 解析、批量写文件。做了界面就会卡死转圈。
|
|||
|
|
- 长任务统一用 `QObject` + `moveToThread` 的 Worker 写法，
|
|||
|
|
模板照抄 `docs/client/02-architecture.md` §5.1。
|
|||
|
|
**不要**用 `QThread` 子类、`QRunnable` 或 Python 的 `threading`。
|
|||
|
|
- 后台结果只能通过**信号**回到主线程，Worker 里一行界面代码都不许有。
|
|||
|
|
- 窗口关闭时要断开信号并置标志位，否则迟到的后台结果会访问
|
|||
|
|
已经销毁的控件、直接崩溃。做法见同文档 §5.2。
|
|||
|
|
- 数据库读写走 Repository，**不要在这里拼业务 SQL**。
|
|||
|
|
- “开始自动获取”会真的去操作手机、可能下单；“搜索”只读本地数据库。
|
|||
|
|
两者必须分开，不得共用入口。
|
|||
|
|
- 普通成功不弹窗，更新界面即可；可恢复错误用 `InfoBar`
|
|||
|
|
（模板见 `docs/client/05-ui-specification.md` §9.1）；
|
|||
|
|
只有必须让用户当场做决定时才用模态对话框。
|
|||
|
|
"""
|