docs(tasks): plan inline desktop record detail
This commit is contained in:
+41
-4
@@ -5,8 +5,8 @@ phase: 0
|
|||||||
deps: []
|
deps: []
|
||||||
status: DOING
|
status: DOING
|
||||||
created: 2026-08-03
|
created: 2026-08-03
|
||||||
context_ref: 9c3c2b2
|
context_ref: 235abb4
|
||||||
work_branch: task/t-006-desk-workspace-revision
|
work_branch: task/t-006-desk-inline-detail-revision
|
||||||
needs_device: false
|
needs_device: false
|
||||||
needs_human_review: true
|
needs_human_review: true
|
||||||
write_paths:
|
write_paths:
|
||||||
@@ -40,6 +40,16 @@ desk 端将使用 PySide6 / Qt Widgets,但当前没有可确认的桌面应用
|
|||||||
可信证据”两种展示能力;不得为了填满预览区访问真实拼多多或猜测图片来源。执行记录详情只
|
可信证据”两种展示能力;不得为了填满预览区访问真实拼多多或猜测图片来源。执行记录详情只
|
||||||
展示原始文字、证据图片和结构化采购结果,不增加提交订单、重试提交或付款动作。
|
展示原始文字、证据图片和结构化采购结果,不增加提交订单、重试提交或付款动作。
|
||||||
|
|
||||||
|
### 2026-08-03 人工评审第三轮修订
|
||||||
|
|
||||||
|
人工评审认为执行记录属于高频只读核查,不应每次用模态窗口中断主工作区。双击右侧记录后,
|
||||||
|
改为在左侧原位显示记录详情;通过可见的“返回当前任务”按钮或 `Esc` 回到当前任务。详情态仍
|
||||||
|
保留顶部实时状态和宽屏右侧记录表,既能连续查看相邻记录,也不遮断轮询运行态。
|
||||||
|
|
||||||
|
本轮只改变详情呈现和导航,不改变执行状态机、数据契约或安全边界。历史详情只能展示已经
|
||||||
|
持久化且获准显示的文字与图片,界面不得为了补图直连拼多多;异步加载必须按记录 ID 与请求
|
||||||
|
代次丢弃过期结果,避免旧记录覆盖当前选择或已经恢复的当前任务视图。
|
||||||
|
|
||||||
## 关联需求与交互
|
## 关联需求与交互
|
||||||
|
|
||||||
- 功能:F-005、F-006、F-009、F-010、F-011、F-013、F-017
|
- 功能:F-005、F-006、F-009、F-010、F-011、F-013、F-017
|
||||||
@@ -81,6 +91,22 @@ desk 端将使用 PySide6 / Qt Widgets,但当前没有可确认的桌面应用
|
|||||||
8. 紧凑宽度按当前任务、日志、执行记录的顺序改为单列;图片落到文字下方,表格保持可用高度。
|
8. 紧凑宽度按当前任务、日志、执行记录的顺序改为单列;图片落到文字下方,表格保持可用高度。
|
||||||
不以浏览器原型证明 Qt 原生 DPI、窗口、虚拟化或无障碍已经验收。
|
不以浏览器原型证明 Qt 原生 DPI、窗口、虚拟化或无障碍已经验收。
|
||||||
|
|
||||||
|
### 第三轮左侧内联详情修订
|
||||||
|
|
||||||
|
1. 左侧工作区使用两个互斥视图:`LIVE_TASK` 显示当前任务与滚动日志,
|
||||||
|
`RECORD_DETAIL(record_id)` 显示所选执行记录的原始文字、证据图片与采购结果。切换整个左栏,
|
||||||
|
不把详情塞进当前任务卡片,也不再使用执行记录详情模态框。
|
||||||
|
2. 单击记录在当前任务态只选中;双击、聚焦后按 Enter、可见的“查看所选记录”命令和右键菜单
|
||||||
|
进入同一详情命令。详情态单击另一行应直接更新左侧详情,记录身份始终使用稳定 ID。
|
||||||
|
3. 详情头部提供可见的“返回当前任务”按钮,并标注 `Esc` 快捷键。返回后保留记录选择、排序和
|
||||||
|
滚动位置,焦点恢复到触发详情的记录行;不能把 `Esc` 作为唯一返回入口。
|
||||||
|
4. `Esc` 按层级处理:先关闭右键菜单等临时浮层;信息对话框打开时由对话框消费;没有更高层
|
||||||
|
浮层时才从记录详情返回当前任务,避免一个按键同时执行两次导航。
|
||||||
|
5. 顶部连接 / 会话状态条不属于左侧切换区,详情显示期间仍实时更新。详情加载中、加载失败、
|
||||||
|
无图片和记录不存在都有明确状态;加载失败可安全重试读取,但不得出现重新下单或付款动作。
|
||||||
|
6. 宽屏保留右侧记录表形成主从工作区;紧凑宽度进入详情时暂时隐藏记录表,返回后恢复原列表
|
||||||
|
状态,避免把详情和表格纵向堆叠成过长页面。
|
||||||
|
|
||||||
### Windows / Fluent 交互基线
|
### Windows / Fluent 交互基线
|
||||||
|
|
||||||
- 使用 `Segoe UI` 和语义 token,适合 Windows 生产力工具的中等偏紧密度;蓝色主操作、红色
|
- 使用 `Segoe UI` 和语义 token,适合 Windows 生产力工具的中等偏紧密度;蓝色主操作、红色
|
||||||
@@ -118,8 +144,10 @@ desk 端将使用 PySide6 / Qt Widgets,但当前没有可确认的桌面应用
|
|||||||
- 采购执行页没有底部轮询控制整行;轮询会话按钮固定在顶部状态区右侧,禁用时就近说明原因。
|
- 采购执行页没有底部轮询控制整行;轮询会话按钮固定在顶部状态区右侧,禁用时就近说明原因。
|
||||||
- 三块工作区符合“当前任务 + 滚动日志 / 右侧执行记录”;当前任务图片支持可信证据与空态,
|
- 三块工作区符合“当前任务 + 滚动日志 / 右侧执行记录”;当前任务图片支持可信证据与空态,
|
||||||
记录表格只有标题、状态两列并按时间倒序。
|
记录表格只有标题、状态两列并按时间倒序。
|
||||||
- 记录可由双击、Enter 和可见命令打开详情;详情按原始文字 / 图片 / 采购结果分区,关闭后恢复
|
- 记录可由双击、Enter 和可见命令打开详情;详情替换左侧当前任务 / 日志,不打开模态框;宽屏
|
||||||
原行焦点,且任何状态都没有下单、重试提交或付款操作。
|
右侧列表保持可见,详情态选择另一行会刷新详情。
|
||||||
|
- 详情按原始文字 / 图片 / 采购结果分区,具有加载中、加载失败、无图片与记录不存在状态;可见
|
||||||
|
返回按钮与 `Esc` 均能恢复当前任务和原行焦点,且任何状态都没有下单、重试提交或付款操作。
|
||||||
- 所列运行状态均可通过显式原型控制区切换;切换后主动作、说明和可用控件与 IX 一致。
|
- 所列运行状态均可通过显式原型控制区切换;切换后主动作、说明和可用控件与 IX 一致。
|
||||||
- 版本失配、服务端不可达、围栏响应不明、点击后结果不明、外部支付、安全校验均有明确
|
- 版本失配、服务端不可达、围栏响应不明、点击后结果不明、外部支付、安全校验均有明确
|
||||||
停止状态和下一步,且绝无重试提交或付款控件。
|
停止状态和下一步,且绝无重试提交或付款控件。
|
||||||
@@ -140,6 +168,15 @@ desk 端将使用 PySide6 / Qt Widgets,但当前没有可确认的桌面应用
|
|||||||
|
|
||||||
## 执行记录
|
## 执行记录
|
||||||
|
|
||||||
|
### 2026-08-03 · 第三轮内联详情待实现
|
||||||
|
|
||||||
|
- 任务保持 `DOING`。本轮拟将执行记录详情从模态对话框改为左侧双视图工作区;只修改 T-006
|
||||||
|
写路径内的原型与同步文档,不扩展 API、真机或生产 PySide6 范围。
|
||||||
|
- 计划验证双击 / Enter / 可见命令 / 右键入口、详情态连续选行、返回按钮、`Esc` 层级、焦点
|
||||||
|
恢复、紧凑宽度单视图,以及加载 / 失败 / 缺图 / 记录不存在状态。
|
||||||
|
- PySide6 交接将把左栏映射为 `QStackedWidget`,整体映射为 `QSplitter`,右侧继续使用
|
||||||
|
`QTableView` + 稳定 ID 模型;详情异步结果必须带请求代次并在 GUI 线程丢弃过期回调。
|
||||||
|
|
||||||
### 2026-08-03 · 第二轮采购工具工作区实现
|
### 2026-08-03 · 第二轮采购工具工作区实现
|
||||||
|
|
||||||
- 任务继续保持 `DOING`:第二轮自动验证已完成,但 `needs_human_review: true`,仍需人工确认
|
- 任务继续保持 `DOING`:第二轮自动验证已完成,但 `needs_human_review: true`,仍需人工确认
|
||||||
|
|||||||
Reference in New Issue
Block a user