diff --git a/docs/03-tech-stack.md b/docs/03-tech-stack.md index 4492f80..48a8903 100644 --- a/docs/03-tech-stack.md +++ b/docs/03-tech-stack.md @@ -147,10 +147,21 @@ T-103 已证明当前衣服商品没有独立「规格/已选」入口。T-110 PDD 规格面板不可避免显示收货区域和掩码手机号。原始截图/XML 只能留在 `%LOCALAPPDATA%\cmbuyer\artifacts\...\raw` 隔离目录，不供 agent、fixture、业务或 HTTP 上传读取； -T-103 必须实现本机确定性脱敏器，把隐私区域从 screenshot/XML 同时移除并在 sibling `derived` 目录 -原子发布。脱敏器必须绑定 PDD 版本、设备分辨率与页面结构，派生 XML 仍命中手机号模式、隐私区域无法 -确认、版本/分辨率/结构失配或哈希不一致时拒绝发布。只有派生 manifest 和人工状态确认完成后，agent -才能从派生物提取最小 fixture、编写判据。 +T-103 已在 `client/src/cmbuyer_client/device/sku_evidence_sanitizer.py` 实现本机确定性脱敏器，并由 +`client/scripts/sanitize_sku_panel_evidence.py` 提供离线 CLI。当前 `t103-privacy-v1` 配置精确绑定 +PKG110 / Android 16 / 拼多多 8.17.0 / goods_id `937122477375` / 1080×2400，把截图的 +`[0,0,1080,540)` 整宽隐私带遮罩，并按相同几何边界递归移除 XML 节点；跨界容器只清空自身敏感属性， +保留下方子节点。地址依靠已确认的整块几何隔离而不是易漏的关键词表；完整、掩码、带分隔符或跨节点 +手机号残留会被自动复检拒绝。 + +```powershell +.\client\.venv\Scripts\python.exe client\scripts\sanitize_sku_panel_evidence.py --raw-dir "<证据目录>\raw" --output-dir "<证据目录>\derived" +``` + +脱敏器校验源 manifest 与文件哈希、设备/App/商品/人工状态、分辨率和 XML 隐私结构，只允许发布到 +同级且尚不存在的 `derived`；失败或发布竞态不覆盖已有目录、不留下 staging。派生 manifest 记录 +`privacy_tier=SANITIZED`、sanitizer 版本、清理计数及本机 source/derived 哈希，不记录原始路径、serial +或页面正文。只有自动复检通过并经人确认状态对应性的派生物，agent 才能读取并提取最小 fixture、编写判据。 2026-08-04 的首轮证据只用于确认上述入口事实；其中 `initial` 不是规格面板，另两张原始截图含隐私 区域，因此 XML 未读取、fixture 与选择器未生成。T-110 完成受控入口与脱敏契约后，T-103 重新取证； diff --git a/docs/current-state.md b/docs/current-state.md index 7fb3926..57b00e2 100644 --- a/docs/current-state.md +++ b/docs/current-state.md @@ -19,9 +19,9 @@ 详见 [`03-tech-stack.md`](03-tech-stack.md) - 生产代码：`admin/` 已有最小 Go 服务、健康检查、核心领域模型、SQLite 迁移与任务状态机； `client/` 已有 Python 包、PySide6 最小入口、运行目录与日志脱敏策略，以及显式 serial 的 ADB - 连接边界、本地基线取证 CLI、受限商品链接打开取证 CLI 和人工声明规格面板状态的只读取证 CLI； - 尚无规格选择、价格读取或下单流程 -- 测试：采购服务已覆盖健康检查、核心模型、迁移与状态机等离线包级测试；采购工具 55 项离线单元测试 + 连接边界、本地基线取证 CLI、受限商品链接打开取证 CLI、人工声明规格面板状态的只读取证 CLI， + 以及绑定 PKG110 / Android 16 / 拼多多 8.17.0 的规格证据确定性脱敏 CLI；尚无规格选择、价格读取或下单流程 +- 测试：采购服务已覆盖健康检查、核心模型、迁移与状态机等离线包级测试；采购工具 66 项离线单元测试 （全部 mock，不连接真机） - 数据：SQLite 核心表与迁移已落成；无业务实例数据 - 标准启动路径：Windows PowerShell 运行 `./init.ps1`，Unix shell 运行 `./init.sh`。Windows 入口 @@ -31,8 +31,9 @@ editable install / 包导入 / unittest / compileall，以及仓库上下文校验。可单独运行两端命令诊断。 - 当前设备门禁：人工已确认拼多多 8.17.0、goods_id `937122477375` 的衣服商品只能通过“快要抢光” 打开规格面板；T-110 已获项目所有者批准，只把该证据/版本绑定的精确唯一入口作为第一趟可逆导航， - 数量、确认页、提交订单、付款与通用点击能力仍不可达。T-103 下一步先实现原始证据本机隔离和自动 - 脱敏派生物，再重新采集三态证据；在此之前不写页面判据，Phase 2 仍不能抢跑。 + 数量、确认页、提交订单、付款与通用点击能力仍不可达。T-103 的原始证据本机隔离与确定性脱敏器 + 已完成离线实现；下一步重新采集三态 raw 并由人只核对 derived。在派生证据验收前不写页面判据， + Phase 2 仍不能抢跑。 ## 当前目录要点 @@ -43,7 +44,7 @@ | `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 缺工具链明确失败 | ## 任务状态 @@ -57,7 +58,7 @@ T-004（核心数据模型）、T-101（真机环境盘点与 USB/WiFi 双通道人工验收）、T-102（canonical 链接打开与目标商品/隐私人工验收）。 - 已完成 T-110（第一趟受控规格入口与隐私脱敏边界）。T-103 是当前最高优先级和 MVP 生死线， - 已补充 T-110 依赖并恢复 `DOING`；自动脱敏派生证据和新真机验收完成前不开发依赖真机可读字段的 + 已补充 T-110 依赖并恢复 `DOING`；脱敏器已完成，三态派生证据和新真机验收完成前不开发依赖真机可读字段的 Phase 2 生产页面。 - 已确认原型继续只作信息架构依据；原型假数据不调用真实接口、不驱动真机。真机结论改变 可读字段时必须先回修原型与交互清单。 @@ -139,8 +140,8 @@ D:\Portable\adb\adb.exe devices -l T-103 已确认当前衣服商品只能从精确文案“快要抢光”进入规格面板；T-110 只批准该证据/版本绑定入口， 不授权“免拼购买 / 单独购买 / 直接拼成”等其他文案。现有只读取证脚本本身仍不打开面板、不点击或选择 -规格，也不读取价格；`--state` 只是人工声明，不能作为自动判据。T-103 将先把以下原始目录接入本机 -确定性脱敏器，再使用派生证据： +规格，也不读取价格；`--state` 只是人工声明，不能作为自动判据。人先手工通过精确“快要抢光”进入 +面板并准备对应状态，再把三组原始证据采集到全新 `raw` 目录： ```powershell # 仓库根目录；三次采集使用三个全新的 output-dir @@ -149,8 +150,17 @@ T-103 已确认当前衣服商品只能从精确文案“快要抢光”进入 .\client\.venv\Scripts\python.exe client\scripts\capture_sku_panel_spike.py --serial --url "https://mobile.yangkeduo.com/goods.html?goods_id=" --state all-dimensions-selected --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-all-dimensions-\raw" --timeout 10 --adb D:\Portable\adb\adb.exe ``` +每组 raw 采集成功后分别运行离线脱敏器；`derived` 必须尚不存在： + +```powershell +.\client\.venv\Scripts\python.exe client\scripts\sanitize_sku_panel_evidence.py --raw-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-initial-\raw" --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-initial-\derived" +.\client\.venv\Scripts\python.exe client\scripts\sanitize_sku_panel_evidence.py --raw-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-one-dimension-\raw" --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-one-dimension-\derived" +.\client\.venv\Scripts\python.exe client\scripts\sanitize_sku_panel_evidence.py --raw-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-all-dimensions-\raw" --output-dir "$env:LOCALAPPDATA\cmbuyer\artifacts\T-103\sku-panel-all-dimensions-\derived" +``` + 原始 screenshot/XML 可能包含 PDD 固定展示的地址和掩码手机号，只能留在本机 `raw` 目录，不能由 -agent、fixture、业务或上传端消费。脱敏器在 sibling `derived` 目录原子发布 screenshot/XML 与 manifest， +agent、fixture、业务或上传端消费。脱敏器会校验源哈希、设备/App/商品/分辨率与隐私结构，在 sibling +`derived` 目录原子发布 screenshot/XML 与 manifest；任何不匹配、手机号残留或已有目标均拒绝发布。 自动复检通过且人确认三态对应性后，agent 才能读取派生物并提取最小 fixture、编写判据。 ## 关键背景 diff --git a/docs/tasks/T-103.md b/docs/tasks/T-103.md index 8df7a9c..511d519 100644 --- a/docs/tasks/T-103.md +++ b/docs/tasks/T-103.md @@ -25,7 +25,7 @@ write_paths: - docs/current-state.md --- - + ## 问题 / 背景 T-102 已证明 canonical 链接可进入目标商品。T-103 随后在 PKG110 / Android 16 / 拼多多 8.17.0、衣服商品 goods_id `937122477375` 上确认：规格面板只能从详情页右下角精确文案“快要抢光”进入，面板固定显示收货区域和掩码手机号。T-110 经项目所有者批准，将该已取证点击定义为可逆、能力受限的规格面板导航；这不是通用购买入口豁免，不授权其他文案、数量、确认页、提交订单或支付。 @@ -95,6 +95,18 @@ T-102 已证明 canonical 链接可进入目标商品。T-103 随后在 PKG110 / ### 2026-08-04T02:56:36Z · ila 2026-08-04：T-110 已获项目所有者授权并同步架构契约。T-103 方案已重写为“先自动脱敏派生证据，再实现受控 `快要抢光` 入口与精确规格/价格判据”；T-110 完成并转 Done 后，本任务恢复 Doing。 + +### 2026-08-04T03:20:51Z · ila + +2026-08-04 T-103 自动脱敏第一阶段实现与主审： + +- 提交 `9b2eb74` 新增离线确定性脱敏 CLI、实现模块和纯合成测试；仅允许 `raw` 到同级全新 `derived`，不连接设备。 +- 绑定 PKG110 / Android 16 / 拼多多 8.17.0 / goods_id `937122477375` / 1080×2400 / 人工声明三态；校验源 manifest 与文件哈希。 +- 截图整宽遮罩 `[0,0,1080,540)`；XML 递归删除隐私带节点、清空跨界容器并保留下方规格节点，完整/掩码/分隔/跨节点手机号残留均 fail closed。 +- 主审首轮发现手机号跨节点绕过、隐私结构未确认和发布竞态风险后退回；第二轮修复并补测，目标目录已存在或竞态出现均不覆盖且不留 staging。 +- 主 agent 独立验证：66 项 client 单测、compileall、CLI help、wheel metadata、完整 `init.ps1`、上下文校验与 diff-check 全部通过。 +- 实现与审查过程未读取、列举或打开任何真实 raw artifacts，也未实现 PDD 页面判据、点击、规格选择、价格、数量、确认页、提交或付款能力。 +- `needs_device=true`，T-103 保持 DOING；等待人重新采集三态 raw、运行脱敏器并只核对 derived 后，才能继续页面判据与真机选择/读价。 ## 边界