diff --git a/docs/tasks/T-006.md b/docs/tasks/T-006.md index 8b76178..55cc73f 100644 --- a/docs/tasks/T-006.md +++ b/docs/tasks/T-006.md @@ -5,8 +5,8 @@ phase: 0 deps: [] status: DOING created: 2026-08-03 -context_ref: 9c3c2b2 -work_branch: task/t-006-desk-workspace-revision +context_ref: 235abb4 +work_branch: task/t-006-desk-inline-detail-revision needs_device: false needs_human_review: true 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 @@ -81,6 +91,22 @@ desk 端将使用 PySide6 / Qt Widgets,但当前没有可确认的桌面应用 8. 紧凑宽度按当前任务、日志、执行记录的顺序改为单列;图片落到文字下方,表格保持可用高度。 不以浏览器原型证明 Qt 原生 DPI、窗口、虚拟化或无障碍已经验收。 +### 第三轮左侧内联详情修订 + +1. 左侧工作区使用两个互斥视图:`LIVE_TASK` 显示当前任务与滚动日志, + `RECORD_DETAIL(record_id)` 显示所选执行记录的原始文字、证据图片与采购结果。切换整个左栏, + 不把详情塞进当前任务卡片,也不再使用执行记录详情模态框。 +2. 单击记录在当前任务态只选中;双击、聚焦后按 Enter、可见的“查看所选记录”命令和右键菜单 + 进入同一详情命令。详情态单击另一行应直接更新左侧详情,记录身份始终使用稳定 ID。 +3. 详情头部提供可见的“返回当前任务”按钮,并标注 `Esc` 快捷键。返回后保留记录选择、排序和 + 滚动位置,焦点恢复到触发详情的记录行;不能把 `Esc` 作为唯一返回入口。 +4. `Esc` 按层级处理:先关闭右键菜单等临时浮层;信息对话框打开时由对话框消费;没有更高层 + 浮层时才从记录详情返回当前任务,避免一个按键同时执行两次导航。 +5. 顶部连接 / 会话状态条不属于左侧切换区,详情显示期间仍实时更新。详情加载中、加载失败、 + 无图片和记录不存在都有明确状态;加载失败可安全重试读取,但不得出现重新下单或付款动作。 +6. 宽屏保留右侧记录表形成主从工作区;紧凑宽度进入详情时暂时隐藏记录表,返回后恢复原列表 + 状态,避免把详情和表格纵向堆叠成过长页面。 + ### Windows / Fluent 交互基线 - 使用 `Segoe UI` 和语义 token,适合 Windows 生产力工具的中等偏紧密度;蓝色主操作、红色 @@ -118,8 +144,10 @@ desk 端将使用 PySide6 / Qt Widgets,但当前没有可确认的桌面应用 - 采购执行页没有底部轮询控制整行;轮询会话按钮固定在顶部状态区右侧,禁用时就近说明原因。 - 三块工作区符合“当前任务 + 滚动日志 / 右侧执行记录”;当前任务图片支持可信证据与空态, 记录表格只有标题、状态两列并按时间倒序。 -- 记录可由双击、Enter 和可见命令打开详情;详情按原始文字 / 图片 / 采购结果分区,关闭后恢复 - 原行焦点,且任何状态都没有下单、重试提交或付款操作。 +- 记录可由双击、Enter 和可见命令打开详情;详情替换左侧当前任务 / 日志,不打开模态框;宽屏 + 右侧列表保持可见,详情态选择另一行会刷新详情。 +- 详情按原始文字 / 图片 / 采购结果分区,具有加载中、加载失败、无图片与记录不存在状态;可见 + 返回按钮与 `Esc` 均能恢复当前任务和原行焦点,且任何状态都没有下单、重试提交或付款操作。 - 所列运行状态均可通过显式原型控制区切换;切换后主动作、说明和可用控件与 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 · 第二轮采购工具工作区实现 - 任务继续保持 `DOING`:第二轮自动验证已完成,但 `needs_human_review: true`,仍需人工确认