chengmaandClaude Opus 4.8
541dfab967
建立 harness coding 文档体系并完成一致性修正： - 文档集：AGENTS.md/CLAUDE.md 入口，docs/00-05 规范文档， api.md/routes.md/current-state.md，根目录 tasks.md/progress.md。 - 一致性补丁：TaskStatus 中英映射、支付模式收敛为全局 PaymentConfig、 执行器级 RunnerState 暂停语义、progress 与 current-state 职责边界。 - 工程地基：新增 .gitignore，忽略运行产物/敏感数据与 .claude 本地设置。 - 合规留痕：02 需求新增平台规则与合规风险条目。 Co-Authored-By: Claude Opus 4.8 <noreply@anthropic.com>
97 lines
4.0 KiB
Markdown
97 lines
4.0 KiB
Markdown
# 界面结构
|
|
|
|
> 本项目是桌面 GUI，不使用 Web 路由。本文约定主窗口区域、页面职责和组件归属。
|
|
|
|
## 主窗口布局
|
|
|
|
```text
|
|
┌──────────────────────────────────────────────────────────┐
|
|
│ 顶部工具栏：导入 Excel | 开始 | 暂停 | 继续 | 取消 | 人工接管 | 支付模式 │
|
|
├──────────────────────────────┬───────────────────────────┤
|
|
│ 任务表格 │ 当前设备 / 当前截图 │
|
|
│ - 勾选 │ - 设备状态 │
|
|
│ - 序号 │ - 当前步骤 │
|
|
│ - 商品链接 │ - 手机截图 │
|
|
│ - SKU 信息 │ │
|
|
│ - 数量 │ │
|
|
│ - 状态 │ │
|
|
│ - 订单号 │ │
|
|
│ - 失败原因 │ │
|
|
├──────────────────────────────┴───────────────────────────┤
|
|
│ 日志区域 │
|
|
└──────────────────────────────────────────────────────────┘
|
|
```
|
|
|
|
## 页面 / 区域职责
|
|
|
|
### 顶部工具栏
|
|
|
|
- 导入 Excel。
|
|
- 开始执行选中任务。
|
|
- 暂停当前批次。
|
|
- 继续人工处理后的任务。
|
|
- 取消后续任务。
|
|
- 进入人工接管状态。
|
|
- 配置支付模式：人工确认支付（默认）或受控自动支付。
|
|
|
|
按钮状态必须跟随任务执行状态变化，避免重复启动或误操作。
|
|
|
|
### 任务表格
|
|
|
|
- 展示导入的 Excel 任务。
|
|
- 支持勾选/取消勾选。
|
|
- 按当前展示顺序执行选中任务。
|
|
- 实时更新状态、订单号、失败原因。
|
|
- 行状态要清晰区分：待执行、执行中、待人工、成功、失败、已取消。
|
|
|
|
### 当前设备 / 当前截图
|
|
|
|
- 展示 Android 设备连接状态。
|
|
- 展示当前执行任务和步骤。
|
|
- 展示最近截图。
|
|
- 设备断开或截图失败时显示明确错误。
|
|
|
|
### 日志区域
|
|
|
|
- 展示任务级日志。
|
|
- 每条日志包含时间、任务 ID、步骤、结果。
|
|
- 不展示支付密码、短信验证码、账号密码等敏感信息。
|
|
|
|
### 人工接管交互
|
|
|
|
- 当系统进入 `待人工` 时，GUI 应明确展示原因。
|
|
- 用户可以在真机上手动处理。
|
|
- GUI 提供继续、标记成功、标记失败、取消批次等操作。
|
|
- 自动化不得在安全校验节点自行尝试绕过。
|
|
|
|
### 支付模式配置
|
|
|
|
- 默认模式为人工确认支付。
|
|
- 受控自动支付必须由用户显式开启。
|
|
- 开启时必须填写单笔金额上限；建议填写批次金额上限。
|
|
- GUI 应显示当前模式，执行中不得悄悄切换。
|
|
|
|
## 组件建议
|
|
|
|
| 组件 | 归属 | 说明 |
|
|
| --- | --- | --- |
|
|
| `MainWindow` | 全局 | 主窗口和整体布局。 |
|
|
| `Toolbar` | 全局 | 导入、开始、暂停、继续、取消、人工接管、支付模式。 |
|
|
| `TaskTable` | 主区域 | 渲染任务列表和状态。 |
|
|
| `DevicePanel` | 侧栏 | 展示设备状态、当前步骤、截图。 |
|
|
| `LogPanel` | 底部 | 展示运行日志。 |
|
|
| `ManualActionDialog` | 弹窗 | 人工接管原因和后续动作。 |
|
|
|
|
## 导航规则
|
|
|
|
- 启动程序后直接进入主窗口，不做登录页。
|
|
- 未导入 Excel 时，开始按钮不可用。
|
|
- 未连接 Android 设备时，开始执行前给出明确提示。
|
|
- 执行中允许查看表格和日志，但不允许重新导入覆盖当前任务。
|
|
- 批次执行结束后，显示结果文件路径。
|
|
|
|
|
|
|
|
|
|
|