From d052583607d047cd853a159e1dd823ab1606c546 Mon Sep 17 00:00:00 2001 From: QiuSW <105186638@qq.com> Date: Mon, 3 Aug 2026 12:35:54 +0800 Subject: [PATCH] feat(prototype): add MVP web interaction flows --- docs/design/web-login.html | 247 ++++++++++++++++++++ docs/design/web-task-create.html | 347 ++++++++++++++++++++++++++++ docs/design/web-task-detail.html | 334 ++++++++++++++++++++++++++ docs/design/web-task-workbench.html | 274 ++++++++++++++++++++++ docs/tasks/T-005.md | 42 +++- 5 files changed, 1242 insertions(+), 2 deletions(-) create mode 100644 docs/design/web-login.html create mode 100644 docs/design/web-task-create.html create mode 100644 docs/design/web-task-detail.html create mode 100644 docs/design/web-task-workbench.html diff --git a/docs/design/web-login.html b/docs/design/web-login.html new file mode 100644 index 0000000..c0a31fc --- /dev/null +++ b/docs/design/web-login.html @@ -0,0 +1,247 @@ + + + + + + 登录 · cmbuyer 原型 + + + + +
PROTOTYPE - 仅供枚举交互，非实现依据
+
+ + + cmbuyer + + 采购管理端 · 原型环境 +
+ +
+
+
+

采购任务管理

+

登录后处理需要人决定的任务

+

网页端负责建单、查看证据与人工决策；桌面端负责驱动手机执行。两端身份隔离。

+
+ 系统只创建待付款订单，不会自动付款 + 付款始终由人在拼多多核对后完成。任何验证码、风控或结果不明都会停止并转人工。 +
+
+ +
+

管理端登录

+

请使用采购管理员账号。原型不会保存或发送输入。

+

登录成功后将返回站内页面：/tasks/T-20260803-018

+ + +
+
+ + +

仅允许管理端账号登录。

+

+
+
+ + +

原型数据可随时复位，不连接真实账号。

+

+
+
+ +
+
+ + + + +
+
+
+ + + + diff --git a/docs/design/web-task-create.html b/docs/design/web-task-create.html new file mode 100644 index 0000000..080fa24 --- /dev/null +++ b/docs/design/web-task-create.html @@ -0,0 +1,347 @@ + + + + + + 新建采购任务 · cmbuyer 原型 + + + + +
PROTOTYPE - 仅供枚举交互，非实现依据
+
+ cmbuyer + + 采购管理员 · caigou_admin +
+ +
+ +
+

新建采购任务

把商品链接与精确规格交给机器执行，一次只建一条。

+ 价格上限是必填资金边界 +
+ +
+ +
+
+

采购要求

所有内容均为可复位假数据，本页不会提交到服务器。

+
+ + +
+ 任务与商品 +
+
+ + +

用于工作台查询，不会发送给拼多多。

+

+
+
+ + +

MVP 只接受任务自带商品链接；无法解析商品标识时保留全部输入。

+

+
+
+
+ +
+ 规格与资金边界 +
+
+ + +

按维度精确填写，不写“差不多”的替代项。

+

+
+
+ + +

例如 XL；执行时必须等值匹配。

+

+
+
+ + +

必须是大于 0 的整数。

+

+
+
+ +
+

十进制金额；留空或格式错误都不能建单。

+

+
+
+
+ +
+ 取消并返回 + +
+
+
+ + +
+
+ + + + diff --git a/docs/design/web-task-detail.html b/docs/design/web-task-detail.html new file mode 100644 index 0000000..9e31fc3 --- /dev/null +++ b/docs/design/web-task-detail.html @@ -0,0 +1,334 @@ + + + + + + 任务详情 · cmbuyer 原型 + + + + +
PROTOTYPE - 仅供枚举交互，非实现依据
+
+ cmbuyer + + 采购管理员 · caigou_admin +
+ +
+ +
+

8 月仓库工作服补货

任务 T-20260803-018 · 假数据

+ 等待确认 +
+
只下单，不付款系统最多创建待付款订单。付款始终由人在拼多多核对后完成；待付款状态不是成功。
+
+
+
+ +
+

机器选对了吗？

确认前必须查看实际勾选结果、价格和规格面板证据。

+
+
+
可以授权机器所选规格与要求一致，合计未超过资金上限。
+ + + + + + + +
核对项你要的机器选到结论
颜色分类白色白色符合
尺码XLXL符合
金额总额不超过 ¥80.00¥32.50 × 2 = ¥65.00未超上限
+
+ + 规格面板截图假数据占位用于确认信息架构，不代表真实拼多多页面结构或字段位置。 + + 假数据证据占位 · 不代表真实 App 页面 + 颜色分类：白色（假） + 尺码：XL（假） + 规格面板读价：¥32.50（假） + 真实可读字段需等待 T-103 真机取证后复核 + +
规格面板证据 · 假数据 · 未包含地址、手机号或付款信息
+
+ +
+
+
+ + + + + + + + + + + + + + + + + + +
+ + +
+
+ +

确认退回，不买？

任务将结束为已取消，不会签发下单授权，也不会再自动执行。

 +

放弃当前授权？

当前确认尚未建立提交围栏，可以安全放弃。

放弃后必须重新跑第一趟取新价，不能复用旧授权或旧截图。

 + + + + diff --git a/docs/design/web-task-workbench.html b/docs/design/web-task-workbench.html new file mode 100644 index 0000000..5d2ca1d --- /dev/null +++ b/docs/design/web-task-workbench.html @@ -0,0 +1,274 @@ + + + + + + 任务工作台 · cmbuyer 原型 + + + + +
PROTOTYPE - 仅供枚举交互，非实现依据
+
+ cmbuyer + + 采购管理员 · caigou_admin +
+ +
+
+

任务工作台

按“谁持球”处理任务；第一条待决策任务默认展开。

+ 新建采购任务 +
+ +
+
+
+
+ +
+

各泳道计数只随关键词与时间范围变化，不随泳道选择变化。

+ +
+ 共 6 条假数据任务，其中 3 条等你决定。 +
原型状态：
+
+ +
+

正在加载任务，请稍候…

+
+
+

没有匹配的任务

调整关键词或时间范围，或者清除全部筛选条件。

+
+ + +
+
+

等你决定

3
+

确认试选、核对待付款或处理结果不明。

+
+
+
T-20260803-018

8 月仓库工作服补货

等待确认
+
要求
白色 · XL · 2 件
机器选到
白色 · XL
读到单价
¥32.50
上限 / 合计
¥80.00 / ¥65.00
+
已展开：机器选对了吗？

规格一致、金额未超上限。确认前仍需查看规格面板截图。

查看证据并决定
+ +
+
+
T-20260803-016

办公室收纳盒

结果不明
+
状态
可能已创建订单
提交记录
SUB-016-A
+ +
+
+
T-20260801-009

标签打印纸补货

待付款
+
规格
白色 · 50×30
授权金额
¥46.00
+ +
+
+
+ +
+

机器在跑

2
+

待领取、试选、授权后第二趟与围栏前执行。

+
+
+
T-20260803-019

新建的工作服任务

待领取
+
要求
深灰 · L · 1 件
价格上限
¥45.00
+ +
+
+
T-20260803-017

仓库防滑手套

第二趟 · 围栏前
+
锁定单价
¥12.80
授权到期
11:25
+ +
+
+
+ +
+

已结束

1
+

已付款完成、失败或已取消的归档任务。

+
+
+
T-20260731-042

打包胶带补货

已完成
+
规格
透明 · 45mm
人工标记
采购管理员
+ +
+
+
+
+
+ + + + diff --git a/docs/tasks/T-005.md b/docs/tasks/T-005.md index cdd5387..27be795 100644 --- a/docs/tasks/T-005.md +++ b/docs/tasks/T-005.md @@ -3,7 +3,7 @@ id: T-005 title: 网页端 MVP 交互原型 phase: 0 deps: [] -status: TODO +status: DOING created: 2026-08-03 context_ref: dfe3d56 work_branch: task/t-005-web-prototype @@ -89,4 +89,42 @@ web 端尚无生产代码。若直接实现 SSR 页面，登录、建单、三 ## 执行记录 -开工后记录修改文件、浏览器检查尺寸、控制台 / 网络 / 可访问性结果、未验证范围和人工确认项。 +### 2026-08-03 · 第一阶段原型实现 + +- 任务状态保持 `DOING`：自动检查已完成，但 `needs_human_review: true`，未进行人工设计确认。 +- 新增四个自包含页面：登录、手工建单、三泳道工作台、任务详情。四页使用同一套语义颜色、 + 字体、间距和导航；全部假数据可由页内控件复位，不调用 API，不保存凭据，不加载外部资源。 +- 登录页覆盖站内返回、必填错误、提交中、会话过期和成功；建单页覆盖逐字段校验、链接解析 + 失败后保留输入、提交中和创建成功；工作台覆盖实时筛选、计数规则、第一条待决策展开以及 + 加载 / 空 / 错误；详情页覆盖试选不一致 / 超额 / 缺证据、授权、围栏前放弃后重新试选、 + 围栏后调和、结果不明、待付款核对、转人工和终态。 +- 安全表达已独立复核：全程固定说明不自动付款；围栏前放弃明确转 `PENDING_RETRIAL` 且不复用 + 旧价；围栏后只显示唯一 `submission_id` 与人工核查入口，没有重试、再次提交或放弃按钮； + `WAITING_PAYMENT` 需证据和四项人工核对才能标记完成。 +- `ui-ux-pro-max` 检索建议被用于焦点、触控尺寸、错误就近、恢复路径与响应式检查。其推荐的 + 红色主色和外部装饰字体与任务约束冲突，因此未采用；主操作保持蓝色，红色只用于错误或 + 破坏性动作，字体使用 `Segoe UI` / 系统字体。 + +**已运行验证** + +- `python scripts/validate_agent_context.py`：通过（6 个任务路由，18 个有效仓库路径）。 +- Node 静态脚本：四页均包含 doctype、viewport、固定原型横幅、`aria-live`、 + `prefers-reduced-motion`；每页唯一内联脚本均可编译；无外部脚本、字体或图片引用。 +- Chrome Headless + DevTools Protocol：逐页检查 375 / 768 / 1024 / 1440 px，16 个组合均无 + 页面级水平溢出、运行时异常或外部网络请求；登录错误、建单链接错误与输入保留、工作台空态 + 与复位、详情全部业务状态、规格不符禁用确认、核对完成后启用标记等状态切换均通过。 +- Chrome accessibility tree / 键盘抽查：可见交互控件都有可访问名称，Tab 顺序可到达页内 + 原型控件，未发现键盘陷阱；模拟 reduced-motion 时媒体查询生效。原生对话框均有明确的取消 + 和确认按钮。 +- 目视检查 Chrome 截图：1440 px 工作台 / 详情与 375 px 建单 / 详情的信息层级、换行和主操作 + 未见截断；证据图均明确标为假数据且不代表真实 App 页面。 +- `git diff --check`：通过。 + +**未验证与待人工确认** + +- Playwright MCP 因共享浏览器实例被占用而无法连接；上述浏览器检查改由独立 Chrome Headless + 与 DevTools Protocol 完成。未做真实读屏器、高对比度模式或人工键盘全流程验收。 +- 原型不证明 Go SSR、真实鉴权 / CSRF、接口并发、PySide6、真机页面字段或真实拼多多流程。 + T-103 真机取证后仍需复核实际可读字段，不能把占位图当成页面判据。 +- 待人确认：四页整体布局与信息密度、三泳道命名和默认展开、详情页各状态的唯一主动作、 + 「确认下单（不付款）」与围栏 / 调和文案、375 px 窄屏阅读体验。确认前任务不得标 `DONE`。