docs: 补充任务 #28 链接校验记录

This commit is contained in:
chengma
2026-08-07 16:14:44 +08:00
parent f1c2700fde
commit 77ec0d997b
@@ -18,6 +18,7 @@ Client 原来只有实验脚本和几个独立控件树工具,没有正式的
- `PddDeviceService.connect(serial)` 返回上下文管理的设备会话。
- 同一个服务同时只允许一个活动会话;Device 只能在创建会话的线程使用。
- `PddCollectService.collect(task)` 接收至少包含 `goods_url` 的任务对象,返回 `CollectResult`。
- 打开页面前校验 PDD 域名、数字商品编号以及任务编号与链接编号是否一致。
- 商品页滚动收集标题、店铺、已拼数量和评价数量;数量保留整数、原文和近似标记。
- 规格面板从当前位置横向、纵向分别扫描两个方向,不假设初始位置在列表起点。
- 规格使用通用 `dimensions`;颜色、尺码使用可读键,其他维度使用由名称生成的稳定键。
@@ -46,6 +47,7 @@ Client 原来只有实验脚本和几个独立控件树工具,没有正式的
| Device 单线程独占且会话可释放 | 通过 |
| 返回商品、店铺、数量、通用规格和 SKU 价格关系 | 自动测试通过 |
| 金额使用分整数,数量保留原文和近似标记 | 通过 |
| 校验 PDD 链接及商品编号一致性 | 通过 |
| 结构化区分主要设备、页面和数据错误 | 通过 |
| XML 解析和主要错误分支不依赖真机测试 | 通过 |
| 不接 Qt、SQLite、Admin、采购和下单 | 通过 |
@@ -62,11 +64,10 @@ C:/Python310/python.exe -m compileall -q src test
并在项目根目录对本任务文件执行 `git diff --check`。
- 结果:Client 全量 116 项测试通过,其中 #28 新增 14 项;语法编译和差异检查通过。
- 结果:Client 全量 118 项测试通过,其中 #28 新增 16 项;语法编译和差异检查通过。
- 使用工作区已有 XML 做了只读兼容性检查,能够解析三份商品页标题和销量,以及三份规格面板的当前价格和可见颜色/尺码;这些含真实页面信息的文件没有加入提交。
- **没验证到的部分**:尚未在真机执行完整 `collect`;因此未验证真实 PDD 版本中的滚动终点、店铺与评价所在位置、隐藏规格全集、动态库存、全部 SKU 组合价格、登录页和验证码页。未执行采购或下单。
## 相关提交
- `4aff22c` `feat: 实现 PDD 商品采集基础服务 (#28)`