docs: 更新任务 #4 筛选栏验收

This commit is contained in:
chengma
2026-08-06 14:36:57 +08:00
parent 8f6e657820
commit 3190d1ff78
+7 -2
View File
@@ -18,8 +18,9 @@
- `TaskTableModel` 使用 `QAbstractTableModel`,当前以内存数据模拟后续 Repository 查询结果。
- 表格使用 `qfluentwidgets.TableView`,默认按更新时间倒序,每页展示 50 条。
- 页面提供自动获取、搜索、刷新和详情信号,不执行数据库、网络或手机操作。
- 自动获取、任务类型、任务状态、关键词、搜索和刷新控件位于同一行,关键词输入框固定为 190 像素宽。
- 表格和表头始终显示;无真实任务时,根据表格高度使用不可交互的空行填满可视区域。
- 无任务、筛选无结果、加载中和加载失败提示显示在表格上方,不替换表格。
- 普通无任务状态不显示额外提示;筛选无结果、加载中和加载失败时仍在表格上方显示对应提示,不替换表格。
- 提供 `set_tasks()`、`set_auto_fetch_state()` 和 `set_engine_status()` 等更新入口。
测试中发现启用表格排序会覆盖默认排序列,最终增加了对“更新时间”列的显式降序设置。首次实现使用空状态页替换表格;用户验收时要求无数据也保留空表格,因此调整为动态占位空行,并避免产生没有意义的空数据滚动条。
@@ -40,6 +41,9 @@
| 操作列和激活行发出详情信号 | 通过 |
| 空数据与筛选无结果文案不同 | 通过 |
| 无数据时表格、表头和禁用空行保持显示 | 通过 |
| 三个筛选标签与开始自动获取按钮处于同一行 | 通过 |
| 关键词输入框缩短为 190 像素 | 通过 |
| 普通无任务状态不显示两行引导文字 | 通过 |
| Ctrl+F 和关键词 Enter 可用 | 通过 |
| 语法、分页和离屏装配测试通过 | 通过 |
| 未连接数据库、Admin 或 Android 设备 | 通过 |
@@ -59,10 +63,11 @@
Remove-Item Env:QT_QPA_PLATFORM
```
- 结果:语法检查通过;完整离屏测试输出 `PDD_UI_OK`;分页和快捷键测试输出 `PAGINATION_AND_SHORTCUT_OK`;无数据表格、动态空行、禁用状态和无空数据滚动条测试输出 `EMPTY_GRID_OK`。
- 结果:语法检查通过;完整离屏测试输出 `PDD_UI_OK`;分页和快捷键测试输出 `PAGINATION_AND_SHORTCUT_OK`;无数据表格、动态空行、禁用状态和无空数据滚动条测试输出 `EMPTY_GRID_OK`;单行筛选栏、关键词宽度和普通无任务状态测试输出 `COMMAND_ROW_AND_EMPTY_TABLE_OK`。
- **没验证到的部分**:未进行用户人工界面验收、真实 Windows 字体效果、深色/高对比度、200% 缩放和真机测试。离屏环境输出既存的 PyQt5 字体目录缺失警告,不影响模型和窗口断言。
## 相关提交
- `ad19700` 实现 PDD 任务列表 UI
- `2322b46` 无数据时保留任务表格和动态空行
- `8f6e657` 调整任务筛选栏布局并移除普通无任务提示