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

docs(architecture): approve controlled trial SKU entry

Browse Source
This commit is contained in:
QiuSW
2026-08-04 10:59:40 +08:00
parent d81fc722dc
commit 82f57c7233
8 changed files with 198 additions and 100 deletions
Download Patch File Download Diff File Expand all files Collapse all files
docs/03-tech-stack.md
+18 -15
View File
@@ -43,7 +43,7 @@
| 调用位置 | 采购工具 | 已定 | PC 有算力；改 prompt 不需要重新打包 |
| provider | 待定 | **待定** | 需先确认预算与合规；不得由 agent 自行选定 |
| 凭据存储 | 采购工具本机配置文件，不入库、不上传 | 已定 | 采购服务不保存、不代理、不下发任何模型凭据 |
| 输入 | 完整节点树 XML + 页面截图 | 已定 | `dump_hierarchy(compressed=False)` 不丢节点 |
| 输入 | 自动复检通过的脱敏派生 XML + 页面截图 | 已定 | 原始证据只允许本机确定性脱敏器消费，AI/agent 不读取原始地址或手机号 |
## 四、决策记录与演进
@@ -125,7 +125,7 @@ D:\Portable\adb\adb.exe devices -l
证据不得提交 Git。T-102 已由人确认 goods_id `958756616606` 对应目标商品并完成截图/XML 隐私检查，
设备、版本、证据路径与 SHA-256 已记录到任务执行记录。
### T-103 规格面板三状态只读取证（真机结论：no-go）
### T-103 规格面板三状态只读取证（T-110 边界调整后待重新验证）
`client/scripts/capture_sku_panel_spike.py` 只采集人已在手机上准备好的规格面板截图和完整 XML。
它不打开链接或规格面板，不识别面板，不点击、滑动、输入或选择规格，也不读取价格；接口只暴露
@@ -134,24 +134,27 @@ D:\Portable\adb\adb.exe devices -l
不得将其当作自动识别结果。运行拼多多版本必须精确为 `8.17.0`，前台 package 必须是拼多多，否则
fail closed；目标目录已存在、截图/XML 无效或超时均不得覆盖已有内容或发布半成品。
人工只能通过商品页上独立且安全的「规格/已选」入口打开面板。不得点击或借用「单独购买」「免拼购买」
「直接拼成」「现在买」「先用后付」「0 元下单」等购买、下单或支付入口；没有独立入口即记录 no-go。
三种状态分别使用一个全新证据目录：
T-103 已证明当前衣服商品没有独立「规格/已选」入口。T-110 只批准拼多多 `8.17.0`、goods_id
`937122477375` 上经真机确认的精确唯一 `快要抢光` 作为可逆的受控规格面板入口；“免拼购买 / 单独购买 /
直接拼成”等其他文案不能凭人工经验复用，必须分别重新取证。只读取证 CLI 本身仍不执行点击；三种状态
分别使用一个全新原始证据目录：
```powershell
.\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
.\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>\raw" --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>\raw" --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>\raw" --timeout 10 --adb D:\Portable\adb\adb.exe
```
原始截图/XML 只能留在本机。人先核对三次截图的声明状态并完成隐私检查，再回报 manifest 路径、精确
选择值和面板可见价格文本；agent 在此之前不得读取原始页面内容或编写任何规格面板判据。
PDD 规格面板不可避免显示收货区域和掩码手机号。原始截图/XML 只能留在
`%LOCALAPPDATA%\cmbuyer\artifacts\...\raw` 隔离目录，不供 agent、fixture、业务或 HTTP 上传读取；
T-103 必须实现本机确定性脱敏器，把隐私区域从 screenshot/XML 同时移除并在 sibling `derived` 目录
原子发布。脱敏器必须绑定 PDD 版本、设备分辨率与页面结构，派生 XML 仍命中手机号模式、隐私区域无法
确认、版本/分辨率/结构失配或哈希不一致时拒绝发布。只有派生 manifest 和人工状态确认完成后，agent
才能从派生物提取最小 fixture、编写判据。
2026-08-04 的 PKG110 / Android 16 / 拼多多 8.17.0 真机验证中，人确认衣服商品
goods_id `937122477375` 的规格面板只能从详情页右下角“快要抢光”等购买语义按钮进入；通常同类入口
还包括“免拼购买 / 单独购买 / 直接拼成”。这满足任务预设的 no-go 条件：第一趟不能点击进入下单流程
的入口，因此本轮 XML 未读取、fixture 与选择器未生成，T-103 转 `BLOCKED`。只读取证脚手架保留用于
后续重新验证，但不能被解释为规格面板自动化可行。解除阻塞必须先完成新的架构决策和安全边界评审。
2026-08-04 的首轮证据只用于确认上述入口事实；其中 `initial` 不是规格面板，另两张原始截图含隐私
区域，因此 XML 未读取、fixture 与选择器未生成。T-110 完成受控入口与脱敏契约后，T-103 重新取证；
该边界调整不授权第一趟调整数量、进入确认页、点击“提交订单”或触碰任何支付控件。
Windows 的标准入口是仓库根 `./init.ps1`。它要求 Go、两端目录及其哨兵文件存在；已有合规
`client/.venv` 时，所有采购工具检查与 validator 都使用该解释器。只有 venv 不存在时，才从 `py -0p`