docs(tasks): plan desktop workspace revision
This commit is contained in:
+47
-4
@@ -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、系统托盘、后台进程或安装包。
|
||||
- 不从前序项目复制页面判据、选择器、常量或真机结论。
|
||||
- 不提供任何点击支付、免密支付、先用后付或扣款相关控件;也不提供真实提交按钮。
|
||||
|
||||
Reference in New Issue
Block a user