4 实现 PDD 任务列表 UI

类型：需求
父级大工单：#1
所属 MVP / 版本：#2 / MVP
状态：已完成
日期：2026-08-06
Gitea 工单：#4

背景与目标

原来的 PDD 页面还是手工输入商品链接、颜色和尺码的旧占位页。本任务先实现可独立演示的任务列表 UI，为后续 SQLite Repository 接入提供明确的数据和事件入口。

最终方案

页面采用顶部命令区、中部任务表格、底部运行状态区。
TaskRow 只保存列表展示和搜索字段，不包含 pdd_data。
TaskTableModel 使用 QAbstractTableModel，当前以内存数据模拟后续 Repository 查询结果。
表格使用 qfluentwidgets.TableView，默认按更新时间倒序，每页展示 50 条。
页面提供自动获取、搜索、刷新和详情信号，不执行数据库、网络或手机操作。
自动获取、任务类型、任务状态、关键词、搜索和刷新控件位于同一行；关键词输入框使用 190–480 像素的伸缩范围，在 1280 像素主窗口中约为 298 像素。
表格和表头始终显示；无真实任务时，根据表格高度使用不可交互的空行填满可视区域。
普通无任务状态不显示额外提示；筛选无结果、加载中和加载失败时仍在表格上方显示对应提示，不替换表格。
提供 set_tasks()、set_auto_fetch_state() 和 set_engine_status() 等更新入口。

测试中发现启用表格排序会覆盖默认排序列，最终增加了对“更新时间”列的显式降序设置。首次实现使用空状态页替换表格；用户验收时要求无数据也保留空表格，因此调整为动态占位空行，并避免产生没有意义的空数据滚动条。

改了哪些

client/src/pdd_ui.py：完成 PDD 任务列表模型、页面布局、筛选、分页、空状态、状态更新接口和界面事件信号。

验收结果

验收标准	结果
包含自动获取、类型、状态、关键词、搜索和刷新控件	通过
表格列与界面基线一致	通过
使用 `TableView + QAbstractTableModel`	通过
模型不保存 `pdd_data`，使用稳定任务编号	通过
默认按更新时间倒序并支持组合筛选	通过
操作列和激活行发出详情信号	通过
空数据与筛选无结果文案不同	通过
无数据时表格、表头和禁用空行保持显示	通过
三个筛选标签与开始自动获取按钮处于同一行	通过
关键词输入框缩短为 190 像素	通过
关键词输入框在宽窗口约为原宽度的 150%，并随窗口宽度自适应	通过
普通无任务状态不显示两行引导文字	通过
Ctrl+F 和关键词 Enter 可用	通过
语法、分页和离屏装配测试通过	通过
未连接数据库、Admin 或 Android 设备	通过

测试

执行的命令：

C:/Python310/python.exe -m py_compile src/pdd_ui.py

$env:QT_QPA_PLATFORM="offscreen"
# 使用 QApplication 创建 PDDTaskPage 和 MainWindow，注入采集、采购模拟任务，
# 检查排序、筛选、金额、详情信号、空状态、120 条分页和 Ctrl+F。
Remove-Item Env:QT_QPA_PLATFORM

结果：语法检查通过；完整离屏测试输出 PDD_UI_OK；分页和快捷键测试输出 PAGINATION_AND_SHORTCUT_OK；无数据表格、动态空行、禁用状态和无空数据滚动条测试输出 EMPTY_GRID_OK；单行筛选栏、关键词宽度和普通无任务状态测试输出 COMMAND_ROW_AND_EMPTY_TABLE_OK；1040、1280、1600 像素主窗口的关键词框宽度分别为 190、298、480 像素，响应式测试输出 RESPONSIVE_KEYWORD_OK。
没验证到的部分：未进行用户人工界面验收、真实 Windows 字体效果、深色/高对比度、200% 缩放和真机测试。离屏环境输出既存的 PyQt5 字体目录缺失警告，不影响模型和窗口断言。

4.2 KiB Raw Blame History Unescape Escape

4 实现 PDD 任务列表 UI

背景与目标

最终方案

改了哪些

验收结果

测试

相关提交

4.2 KiB

Raw Blame History