chengma/cmbuyer
2
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

feat(client): add T-103 manual SKU evidence capture

Browse Source
This commit is contained in:
QiuSW
2026-08-04 10:08:49 +08:00
parent ec8257ba8b
commit a92b8f6be0
5 changed files with 667 additions and 6 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/current-state.md
+24 -6
View File
@@ -19,8 +19,9 @@
详见 [`03-tech-stack.md`](03-tech-stack.md)
- 生产代码：`admin/` 已有最小 Go 服务、健康检查、核心领域模型、SQLite 迁移与任务状态机；
`client/` 已有 Python 包、PySide6 最小入口、运行目录与日志脱敏策略，以及显式 serial 的 ADB
连接边界、本地基线取证 CLI 和受限商品链接打开取证 CLI；尚无规格选择、价格读取或下单流程
- 测试：采购服务已覆盖健康检查、核心模型、迁移与状态机等离线包级测试；采购工具 46 项离线单元测试
连接边界、本地基线取证 CLI、受限商品链接打开取证 CLI 和人工声明规格面板状态的只读取证 CLI；
尚无规格选择、价格读取或下单流程
- 测试：采购服务已覆盖健康检查、核心模型、迁移与状态机等离线包级测试；采购工具 55 项离线单元测试
（全部 mock，不连接真机）
- 数据：SQLite 核心表与迁移已落成；无业务实例数据
- 标准启动路径：Windows PowerShell 运行 `./init.ps1`，Unix shell 运行 `./init.sh`。Windows 入口
@@ -28,19 +29,20 @@
并且不覆盖低版本环境；成功后打印真实启动命令。
- 标准验证路径：`./init.ps1` 已实际跑通 admin 的 mod download / test / vet / build、client 的
editable install / 包导入 / unittest / compileall，以及仓库上下文校验。可单独运行两端命令诊断。
- 当前 blocker：无外部 blocker。T-102 已证明 canonical 链接可在拼多多 8.17.0 打开到目标商品并完成
人工隐私验收；下一步落成 T-103 的规格面板证据与试选验证。T-103 通过前 Phase 2 仍不能抢跑。
- 当前设备门禁：T-102 已证明 canonical 链接可在拼多多 8.17.0 打开到目标商品并完成人工隐私验收；
T-103 的只读取证脚手架已落成，等待人工分别把安全的独立规格面板停在初始、已选一个维度、已选全部
维度三种状态并采集证据。T-103 通过前 Phase 2 仍不能抢跑。
## 当前目录要点
| 路径 | 状态 | 说明 |
| --- | --- | --- |
| `docs/` | 已有 | 项目规范化文档，本次已完整生成 |
| `docs/tasks/` | 已有（T-001～T-004、T-005～T-009、T-101～T-102） | T-001～T-004、T-101～T-102 已完成；下一任务为 T-103 |
| `docs/tasks/` | 已有（T-001～T-004、T-005～T-009、T-101～T-103） | T-001～T-004、T-101～T-102 已完成；T-103 正在执行 |
| `docs/design/` | 已有（6 个原型） | web 登录 / 建单 / 工作台 / 详情，desk 采购执行 / 配置；均已人工确认 |
| `scripts/` | 已有 | 上下文门禁、Vikunja 单向导出与 MCP 启动包装 |
| `admin/` | 已初始化 | Go 1.23+ / gin / SQLite，含核心模型、迁移与状态机；无真机采购执行 |
| `client/` | 已初始化 | Python 3.11+ 包、依赖源、PySide6 最小入口、显式 serial 的基线/商品打开取证、离线测试与 wheel 元数据检查；无规格选择、价格读取或下单流程 |
| `client/` | 已初始化 | Python 3.11+ 包、依赖源、PySide6 最小入口、显式 serial 的基线/商品打开/规格面板只读取证、离线测试与 wheel 元数据检查；无规格选择、价格读取或下单流程 |
| `init.ps1` / `init.sh` | 已完成 | 统一安装与离线验证入口；PowerShell 优先复用合规 venv，缺失时自动选择最高的 Python 3.11+，Unix 缺工具链明确失败 |
## 任务状态
@@ -133,6 +135,22 @@ D:\Portable\adb\adb.exe devices -l
检查无地址、手机号、支付信息或其他无关隐私；只回报 manifest 路径及截图/XML SHA-256，原始证据
不得提交 Git。T-102 已由人确认 goods_id `958756616606` 的目标商品及截图/XML 隐私，并完成验收。
T-103 的规格面板只读取证命令要求人先在手机上打开**独立且安全的规格/已选入口**，并手工停在待采集
状态。不得点击或借用「单独购买」「免拼购买」「直接拼成」「现在买」「先用后付」「0 元下单」等购买、
下单或支付入口来打开规格面板；商品没有独立规格入口时必须报告 no-go，不得绕过。脚本本身不打开链接、
不识别面板、不点击或选择规格，也不读取价格；`--state` 只是人工声明，不能作为自动判据：
```powershell
# 仓库根目录；三次采集使用三个全新的 output-dir
.\client\.venv\Scripts\python.exe client\scripts\capture_sku_panel_spike.py --serial <SERIAL> --url "https://mobile.yangkeduo.com/goods.html?goods_id=<GOODS_ID>" --state initial --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-initial-<GOODS_ID>" --timeout 10 --adb D:\Portable\adb\adb.exe
.\client\.venv\Scripts\python.exe client\scripts\capture_sku_panel_spike.py --serial <SERIAL> --url "https://mobile.yangkeduo.com/goods.html?goods_id=<GOODS_ID>" --state one-dimension-selected --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-one-dimension-<GOODS_ID>" --timeout 10 --adb D:\Portable\adb\adb.exe
.\client\.venv\Scripts\python.exe client\scripts\capture_sku_panel_spike.py --serial <SERIAL> --url "https://mobile.yangkeduo.com/goods.html?goods_id=<GOODS_ID>" --state all-dimensions-selected --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-all-dimensions-<GOODS_ID>" --timeout 10 --adb D:\Portable\adb\adb.exe
```
每次成功后，人必须本地核对截图确为所声明状态，并检查截图/XML 不含地址、手机号、支付信息或其他无关
隐私，再只回报三个 manifest 路径、人工选择的精确规格值及面板可见价格文本；原始证据不得提交 Git。
三组证据均通过人工检查后，agent 才能读取它们并提取经脱敏的测试 fixture、编写页面判据与精确选择逻辑。
## 关键背景
本项目是 `cmroubao`（Go 后端 + Android AccessibilityService）与 `cmpdd`