From 7e0b2e8b6a363e342231745b0b92b4811255c1e9 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Mon, 3 Aug 2026 15:20:45 +0800 Subject: [PATCH] docs(tasks): plan desktop workspace revision --- docs/tasks/T-006.md | 51 +++++++++++++++++++++++++++++++++++++++++---- 1 file changed, 47 insertions(+), 4 deletions(-) diff --git a/docs/tasks/T-006.md b/docs/tasks/T-006.md index 751a211..963e813 100644 --- a/docs/tasks/T-006.md +++ b/docs/tasks/T-006.md @@ -5,12 +5,16 @@ phase: 0 deps: [] status: DOING created: 2026-08-03 -context_ref: dfe3d56 -work_branch: task/t-006-desk-prototype +context_ref: 9c3c2b2 +work_branch: task/t-006-desk-workspace-revision needs_device: false needs_human_review: true write_paths: - docs/tasks/T-006.md + - docs/06-tasks.md + - docs/08-interaction-checklist.md + - docs/routes.md + - docs/current-state.md - docs/design/desk-execution.html - docs/design/desk-device-settings.html --- @@ -25,12 +29,23 @@ desk 端将使用 PySide6 / Qt Widgets，但当前没有可确认的桌面应用 本任务不连接 ADB、web 服务或拼多多，不构成真机验收，也不证明 Qt 原生焦点、主题、 无障碍和性能；这些必须在生产实现中重新验证。 +### 2026-08-03 人工评审第二轮修订 + +人工评审确认桌面端产品名改为“采购工具”，采用顶部固定页签，默认打开“采购执行”， +“设备与参数”收敛为“配置”。采购执行页保留当前三块工作区，但重新分配职责：左上是带可选 +商品预览的当前任务，左下是滚动日志，右侧是按时间倒序的执行记录表格。原底部轮询控制整行 +删除，开始 / 停止轮询固定放在顶部状态区右侧。 + +本轮仍是 Phase 0 HTML 原型修订，不连接拼多多、ADB 或 web 服务。商品图片只演示“空态 / 已有 +可信证据”两种展示能力；不得为了填满预览区访问真实拼多多或猜测图片来源。执行记录详情只 +展示原始文字、证据图片和结构化采购结果，不增加提交订单、重试提交或付款动作。 + ## 关联需求与交互 - 功能：F-005、F-006、F-009、F-010、F-011、F-013、F-017 - 用户故事：US-003、US-005、US-008 - 交互：IX-007、IX-008、IX-011 -- 界面：采购执行、设备与参数两个固定页签 +- 界面：采购执行、配置两个固定页签 - 架构 / API：`04-architecture.md` 第四、五、六节；`api.md` 第二、三节 - 原型约定：`docs/design/README.md` @@ -45,6 +60,27 @@ desk 端将使用 PySide6 / Qt Widgets，但当前没有可确认的桌面应用 2. `desk-device-settings.html`：显式 serial、连接方式、ADB 路径、web 地址、假设备凭据占位、 轮询间隔、超时与连续失败阈值；校验错误、连接检查中、版本失配、保存成功、运行中冻结。 +### 第二轮工作区修订 + +1. 应用壳名称统一为“采购工具”。“采购执行”和“配置”是稳定 ID 的固定静态页签，不可关闭、 + 不可拖动；切换后保留各自页面状态，默认目的地是采购执行。 +2. 删除采购执行页底部 `poll-bar`。顶部就绪状态区增加会话状态与固定命令区，开始 / 停止轮询 + 始终位于右侧且只控制轮询会话；核查说明、导出诊断和前往配置等对象级动作留在状态提示区， + 不借用轮询按钮。 +3. 宽屏维持左约 65% / 右约 35% 的三块布局。左上当前任务内部使用文字约 2/3、商品预览约 + 1/3；无可信图片时显示明确空态，有图片时标注“商品原图 / 页面截图裁剪 / 规格证据”等来源 + 与采集时间。原型只能使用内联假证据。 +4. 左下改为可滚动事件日志，并吸收原会话概览和底部轮询栏释放的高度；倒计时、失败计数和 + 本次完成等会话指标压缩到日志标题区，不再占用独立卡片。 +5. 右侧改为“执行记录”表格并跨越左侧两块高度，数据按采集时间倒序。可见列仅“标题”和 + “状态”；任务编号与时间作为标题单元格次行，既保留两列密度，也让倒序可核对。 +6. 单击记录只设置当前行；双击非控件行区域、聚焦后按 Enter 或点击表头区“查看所选记录” + 打开同一详情命令。记录 ID 是稳定身份，不能使用视图行号；排序、刷新后按 ID 恢复当前行。 +7. 记录详情使用窗口级模态对话框：上部左侧显示原始文字和执行时间线，右侧显示可选证据图， + 下部显示结构化采购结果。关闭按钮、Esc 和窗口关闭走同一取消协议，关闭后焦点返回原表格行。 +8. 紧凑宽度按当前任务、日志、执行记录的顺序改为单列；图片落到文字下方，表格保持可用高度。 + 不以浏览器原型证明 Qt 原生 DPI、窗口、虚拟化或无障碍已经验收。 + ### Windows / Fluent 交互基线 - 使用 `Segoe UI` 和语义 token，适合 Windows 生产力工具的中等偏紧密度；蓝色主操作、红色 @@ -78,6 +114,12 @@ desk 端将使用 PySide6 / Qt Widgets，但当前没有可确认的桌面应用 ## 验收要点 - 两个 HTML 均可本地直接打开，页签入口互通，控制台无 error，除本地导航外无网络请求。 +- 两页产品名均为“采购工具”，固定页签为“采购执行 / 配置”，且默认入口为采购执行。 +- 采购执行页没有底部轮询控制整行；轮询会话按钮固定在顶部状态区右侧，禁用时就近说明原因。 +- 三块工作区符合“当前任务 + 滚动日志 / 右侧执行记录”；当前任务图片支持可信证据与空态， + 记录表格只有标题、状态两列并按时间倒序。 +- 记录可由双击、Enter 和可见命令打开详情；详情按原始文字 / 图片 / 采购结果分区，关闭后恢复 + 原行焦点，且任何状态都没有下单、重试提交或付款操作。 - 所列运行状态均可通过显式原型控制区切换；切换后主动作、说明和可用控件与 IX 一致。 - 版本失配、服务端不可达、围栏响应不明、点击后结果不明、外部支付、安全校验均有明确 停止状态和下一步，且绝无重试提交或付款控件。 @@ -89,7 +131,8 @@ desk 端将使用 PySide6 / Qt Widgets，但当前没有可确认的桌面应用 ## 边界 -- 只修改 frontmatter `write_paths` 所列文件，不改共享路线图、需求、IX、API 或生产目录。 +- 只修改 frontmatter `write_paths` 所列文件；共享任务表、IX、路由和当前状态只同步本轮已确认 + 的桌面信息架构，不扩大真机、API 或生产实现范围。 - 不实现 Python、PySide6、uiautomator2、ADB、HTTP、系统托盘、后台进程或安装包。 - 不从前序项目复制页面判据、选择器、常量或真机结论。 - 不提供任何点击支付、免密支付、先用后付或扣款相关控件；也不提供真实提交按钮。