docs(architecture): allow internal raw evidence screenshots

docs/tasks/T-103.md

@@ -25,38 +25,39 @@ write_paths:
   - docs/current-state.md
 ---
 
-<!-- BEGIN VIKUNJA EXPORT id=23 synced=2026-08-04T06:56:08Z sha256=1f5f8b30076531a859c0cada576c91206cbe20471694a53690231fbb031e816e -->
+<!-- BEGIN VIKUNJA EXPORT id=23 synced=2026-08-04T07:46:08Z sha256=48f9e0a02fd330550ae8d749b142a05cb9d92b16c8ee795c6289ccaedde6bca9 -->
 ## 问题 / 背景
 
-T-102 已证明 canonical 链接可进入目标商品。T-103 随后在 PKG110 / Android 16 / 拼多多 8.17.0、衣服商品 goods_id `937122477375` 上确认：规格面板只能从详情页右下角精确文案“快要抢光”进入，面板固定显示收货区域和掩码手机号。T-110 经项目所有者批准，将该已取证点击定义为可逆、能力受限的规格面板导航；这不是通用购买入口豁免，不授权其他文案、数量、确认页、提交订单或支付。 项目所有者随后确认，面板刚打开时已自动选中目标颜色“黑色CHA(纯棉)”和尺码“M(建议100-115)”；因此本任务不再假设存在“未选择”或“只选择一个维度”的初始状态。
+T-102 已证明 canonical 链接可进入目标商品。T-103 在 PKG110 / Android 16 / 拼多多 8.17.0、goods_id `937122477375` 上确认：规格面板只能由详情页精确唯一的“快要抢光”打开；T-110 已把该入口批准为可逆、能力受限的第一趟导航。面板刚打开时目标颜色“黑色CHA(纯棉)”和尺码“M(建议100-115)”自动选中。
+
+真实 `t103-privacy-v5` 派生曾成功用于安全分析：顶部价格节点为“快卖完 ¥12.88”，并列原价为“¥29.88”；派生截图的整宽遮罩把顶部价格文字遮住一半。项目所有者确认 cmbuyer 是内部系统，要求停止遮罩返工：正式流程可以把包含页面地址/手机号的原始截图上传采购服务供已登录管理员查看。完整 XML 不上传，地址/手机号不解析为业务字段，支付凭据仍禁止处理。
 
 ## 关联需求与交互
 
-- 功能：F-006 第一趟试选；覆盖自动脱敏、`open_trial_sku_panel()`、`select_sku_options()`、`read_sku_unit_price()` 的真机 spike。
-- 用户故事：US-003、US-004、US-008；本任务无生产 GUI。
-- 架构 / API：`docs/04-architecture.md` 第三、四、5.4、六节；`docs/api.md` 证据上传和 `TrialSkuFlow`；T-104、T-105 与 Phase 2 的前置。
+- 功能：F-006 第一趟试选；覆盖 `open_trial_sku_panel()`、`select_sku_options()`、`read_sku_unit_price()` 和安全退出的真机 spike。
+- 用户故事：US-003、US-004、US-008；本任务无生产 GUI。T-103 先验证本机真机能力，T-204 接入原始截图 HTTP 上传与管理员查看。
+- 架构 / API：`docs/04-architecture.md` 第三、四、5.4、六节；`docs/api.md` 的 `TrialSkuFlow`；T-104、T-105 与 Phase 2 的前置。
 
 ## 方案
 
-1. 先实现本机确定性脱敏器，不先写页面判据。原始 screenshot/XML 只保存到 `%LOCALAPPDATA%\cmbuyer\artifacts\T-103\...\raw`，只允许脱敏器消费；agent、fixture、业务、日志、HTTP sink、Vikunja 与 Git 均不得读取/上传原始内容。
-2. 脱敏器绑定 PKG110 分辨率、拼多多 8.17.0、goods_id、人工声明状态和本项目证据配置，同时从 screenshot/XML 移除收货区域、地址与手机号内容，在 sibling `derived` 目录原子发布派生物。派生 XML 仍命中手机号模式、隐私区域无法确认、结构/分辨率/版本失配、哈希不一致或目标目录存在时 fail closed，不发布半成品。服务端只接收派生截图哈希和 sanitizer 版本，不接收原始文件/哈希/路径/XML。
-3. 由人运行脱敏器并本地确认派生 screenshot/XML 的三种真实状态：panel-opened-target-preselected（刚打开且目标规格已自动选中）、alternate-all-dimensions-selected（人工把颜色和尺码都改成非目标值）、target-selection-restored（再把两个维度恢复为目标值）。主 agent 只在派生 manifest、每态实际选中值与人工确认齐全后读取派生证据，提取最小 fixture。首轮旧证据不得复用为 fixture。
-4. 实现 `TrialSkuFlow` 窄 capability。`open_trial_sku_panel()` 只允许拼多多 8.17.0、goods_id `937122477375` 上证据绑定、精确唯一的 `快要抢光`；缺失、重复、版本失配或打开后面板判据不唯一时零后续点击。`免拼购买 / 单独购买 / 直接拼成` 等其他文案必须分别取证，不能包含、前缀、同义、OCR 或坐标兜底。
-5. 第一趟 capability 只含打开商品、受控打开面板、在维度容器内精确选择、读面板单价、脱敏取证和返回。接口不得暴露通用 `click`、`set_quantity()`、`go_to_order_confirm()`、`submit_order()` 或支付能力；规格面板中的“提交订单”、微信支付、先用后付和 0 元下单只作为硬拒绝判据，静态调用链测试证明不可达。
-6. 在脱敏派生 XML 上按维度容器隔离候选，文本等值匹配并读回选中态；缺失、重复、禁用、维度不明或选中态不唯一均停止。纯函数测试覆盖 `红`/`粉红`、`1`/`10` 等前缀碰撞。
-7. 单价只从规格面板证据确定的唯一节点读取，以十进制字符串返回，禁止浮点。记录真实文本是否含优惠前缀、货币符号是否拆节点、是否并列原价/区间价；语义不唯一、节点缺失、候选冲突或只能从详情页读取时返回 unreadable。
-8. 人最终在真机先把两个维度改成一组明确记录的非目标值，再执行受控入口、精确选择和读价脚本恢复目标规格，确认实际选择颜色分类=黑色 CHA（纯棉）、尺码=M（建议100-115）（以派生 XML 精确文本为准）、面板单价语义、派生证据隐私与退出行为；agent 保持 DOING 直到人工验收。
+1. 停止修改或调用截图遮罩器。T-103 的截图先保存在 `%LOCALAPPDATA%\cmbuyer\artifacts\T-103\...` 完成本机验收；T-204 正式接入原始截图上传，资产标记 `privacy_tier=INTERNAL_RAW`，允许包含页面已显示的地址和手机号。
+2. 完整 XML 只留采购工具本机，不上传、不进日志、Vikunja 或 Git。以已确认的 v5 派生 XML 提取只含页面判据节点的最小 fixture；fixture 不含地址、手机号或支付凭据。
+3. 实现 `TrialSkuFlow` 窄 capability。`open_trial_sku_panel()` 只允许拼多多 8.17.0、goods_id `937122477375` 上证据绑定、精确唯一的 `快要抢光`；缺失、重复、版本失配或面板判据不唯一时零后续点击。其他购买文案不得复用。
+4. 第一趟只含打开商品、受控打开面板、在维度容器内精确选择、读回选中态、读取 SKU 单价、原始截图和退出。不得暴露通用 `click`、数量、确认页、提交订单或支付能力；“提交订单”、微信支付、先用后付和 0 元下单只作为硬拒绝判据。
+5. 规格选项按维度容器隔离后文本精确唯一匹配，防 `红`/`粉红`、`1`/`10` 前缀碰撞；缺失、重复、禁用、维度不明或选中态不唯一均停止。
+6. 单价只从已取证规格面板结构中的当前价角色读取，严格解析人民币两位小数字符串。促销前缀会变化，不能把“快卖完”作为主判据；必须限定 PDD package、面板结构/相对位置、非点击价格叶节点、唯一当前价，并排除原价及“提交订单/支付/优惠/预估”等语义。任一歧义返回 unreadable，不从详情页或底部提交区补值。
+7. 真机运行时在内存中读取当前页面树，只返回规格、选中态、价格和页面状态摘要；地址/手机号不解析为结构化字段。原始截图可由 T-204 显式上传，但截图上传器不得枚举目录或顺带上传 XML/manifest。
+8. 离线主审通过后，由人先把颜色和尺码改成明确记录的非目标值，再运行脚本恢复目标规格、读取 `12.88`、保存原始截图并安全退出。`needs_device=true`，agent 保持 DOING，等待人工验收。
 
 ## 验收要点
 
-- 三组原始证据分别对应 panel-opened-target-preselected、alternate-all-dimensions-selected、target-selection-restored，且仅在本机 raw 目录；脱敏器离线测试覆盖地址/手机号移除、截图与 XML 同步处理、状态/版本/分辨率/结构失配、手机号残留、原子性、异常脱敏和已有目录不覆盖。
-- 派生 manifest 记录 source/derived 本机哈希、sanitizer 版本、设备/App/goods_id/人工状态；原始页面正文、serial、地址和手机号不进入 manifest、日志、错误或上传。
-- 只从人工验收通过的派生证据编写页面判据与最小 fixture；判据绑定拼多多 8.17.0 和证据哈希。
-- `快要抢光` 精确唯一时才打开面板；其他文案、入口缺失/重复、面板不唯一、规格缺失/碰撞/禁用、价格不唯一均 fail closed。
-- 静态 API/导入测试证明 T-103 第一趟无通用点击、数量、确认页、提交订单或支付能力，“提交订单”及资金控件不可达。
-- 从规格面板可靠读取选中 SKU 单价为十进制字符串；无法唯一解释优惠价/原价/区间价时返回 unreadable。
+- 最小 fixture 只来自本项目拼多多 8.17.0、goods_id `937122477375` 的已验收 v5 派生 XML，不含地址、手机号或支付凭据。
+- `快要抢光` 精确唯一时才打开面板；其他入口、版本失配、面板不唯一、规格碰撞/禁用、选中态或价格不唯一均 fail closed。
+- 价格读取不依赖可变促销文案，能区分当前价 `12.88`、原价 `29.88` 和硬拒绝区“提交订单 ¥12.88”；金额只用十进制字符串。
+- 静态 API/导入测试证明第一趟无通用点击、数量、确认页、提交订单或支付能力。
+- T-103 不再开发遮罩；T-204 原始截图上传必须限制为显式截图文件、设备鉴权、SHA-256 校验和管理员会话读取，不上传完整 XML 或支付凭据。
 - client 全部单测、compileall、wheel metadata、上下文校验、完整 `init.ps1` 与 diff-check 通过。
-- `needs_device=true`：只有人完成受控入口、精确选择、单价读取、派生证据对应性/隐私和安全退出验收后才能 DONE。
+- 只有人完成受控入口、精确规格选择、单价读取、页面对应性、原始截图与安全退出验收后才能 DONE。
 
 ## 执行记录
 
@@ -147,14 +148,29 @@ T-103 sanitizer v2 坐标修正与主审：提交 44c027a 将 screenshot space
 ### 2026-08-04T06:55:52Z · ila
 
 2026-08-04 项目所有者用同一第一态 raw 运行 v4，脱敏器按设计 fail closed：跨界价格节点文本不匹配，未发布 derived；raw 与已保留的 derived-v3-reviewed 未受损。提交 ef1ac60 增加最小安全诊断：失败只输出两个固定价格槽位和受控 reason 枚举，不回显原文、金额、数字串、字符码点、长度或原始属性，v4 成功白名单与原子不发布语义不变。主 agent 独立复跑 78 项 client 单测、compileall、CLI help 与 diff-check，全部通过。等待项目所有者用同一 raw 重跑并反馈 slot/reason；T-103 保持 DOING。
+
+### 2026-08-04T07:17:10Z · ila
+
+2026-08-04 项目所有者重跑安全诊断，固定当前价槽 [396,503][712,570] 返回 reason=known_prefix_missing，证明 raw 文本以“快”开头但不是 v4 假设的精确“快卖光”；该原因不足以证明具体前缀，成功白名单未放宽。提交 6e001b2 仅细分一个已人工观察过的安全枚举：若该槽精确以“快要抢光”开头则返回 observed_prefix_kuaiyaoqiangguang，其余“快”开头仍为 generic；不回显后缀、金额、长度、码点或 raw 属性。主 agent 独立复跑 79 项 client 单测、compileall 与 diff-check 通过。等待项目所有者用同一 raw 再次重跑；T-103 保持 DOING。
+
+### 2026-08-04T07:19:42Z · ila
+
+2026-08-04 项目所有者在手机 live 规格面板人工确认：固定顶部当前价槽的完整非敏感文字为“快卖完 ¥12.88”；底部购买按钮“快要抢光”是另一控件。主 agent 未读取 raw。该事实解释了 v4 对未经验证“快卖光”假设的两次安全拒绝。下一步升级 v5：删除“快卖光”成功假设，只允许证据绑定的精确“快卖完”当前价；坐标、遮罩、结构、PDD package、非点击叶节点、唯一性与原价限制全部不变。T-103 保持 DOING。
+
+### 2026-08-04T07:42:53Z · ila
+
+2026-08-04 范围调整：`t103-privacy-v5` 已在真实第一态成功生成，人工确认派生 XML 无实际地址/手机号、目标规格保留；顶部当前价为“快卖完 ¥12.88”、原价为“¥29.88”，底部“提交订单 ¥12.88”继续属于第一趟硬拒绝区。派生截图的整宽遮罩把顶部价格遮住一半。项目所有者要求停止遮罩返工并加速 MVP：T-103 不上传规格页截图，以安全最小 XML fixture 继续选择/读价；正式管理员证据截图归 T-204，上传端仍不得接收地址、手机号或支付凭据。未完成真机选择/读价验收，T-103 保持 Doing。
+
+### 2026-08-04T07:45:57Z · ila
+
+2026-08-04 最终范围澄清：上一条“正式截图仍需脱敏/裁剪”的记录已被项目所有者新决定取代。cmbuyer 是内部系统，正式第一趟允许把包含页面已显示地址/手机号的原始截图上传采购服务，不做遮罩或裁剪；T-204 负责设备鉴权上传、SHA-256 校验与管理员会话访问。完整 XML、普通日志、Git、Vikunja 和支付凭据仍不接收。T-103 立即停止遮罩开发，继续受控规格选择与 SKU 读价，任务保持 Doing。
 <!-- END VIKUNJA EXPORT -->
 
 ## 边界
 
-- 任何规格面板入口、维度容器、选项、选中态和价格判据都必须来自本项目新采集、自动复检通过的
-  拼多多 8.17.0 **脱敏派生** screenshot/XML；T-102 详情页证据只能证明已到目标商品，不能证明
-  规格面板结构。派生证据路径、SHA-256、goods_id、设备、Android、App 与 sanitizer 版本写入
-  执行记录之前，不得提交页面判据代码。
+- 任何规格面板入口、维度容器、选项、选中态和价格判据都必须来自本项目拼多多 8.17.0 真机证据；
+  T-102 详情页证据只能证明已到目标商品，不能证明规格面板结构。T-103 只使用已由人确认无实际地址/
+  手机号的 v5 派生 XML 提取最小 fixture；派生截图的上传适用性不再是本任务的代码门禁。
 - 第一趟只允许 T-110 批准的 `open_trial_sku_panel()` 窄能力点击证据/版本绑定、精确唯一的
   `快要抢光`；当前事实仅覆盖 goods_id `937122477375`、拼多多 `8.17.0`。不得把“免拼购买 /
   单独购买 / 直接拼成”等其他文案加入包含、前缀、同义或坐标兜底，分别取证前一律拒绝。
@@ -169,11 +185,11 @@ T-103 sanitizer v2 坐标修正与主审：提交 44c027a 将 screenshot space
   规格面板中的“提交订单”、微信支付、先用后付、0 元下单只可作为硬拒绝判据，不能返回可点击对象。
 - 不把 `/mnt/d/chengma/cmroubao`、`/mnt/d/chengma/cmpdd` 或任何旧版本的节点、Activity、选择器、
   坐标、文本形态和页面结论当作事实；前序项目只可用于理解为什么必须 fail closed。
-- 原始 screenshot/XML 只保存在 `%LOCALAPPDATA%\cmbuyer\artifacts\T-103\...\raw`，只允许本机
-  确定性脱敏器消费，不得由 agent、业务、fixture、HTTP sink、Vikunja 或 Git 读取/上传。脱敏器必须
-  校验设备分辨率、页面/App 版本和预期隐私区域，同时移除 screenshot/XML 中的地址与手机号内容；
-  派生 XML 仍命中手机号模式、结构/版本/分辨率失配或哈希不一致时不得发布 `derived`。
-- 只有自动复检通过的最小脱敏 fixture、派生路径/哈希、sanitizer 版本与非敏感结论可入库；服务端
-  不接收原始文件、原始路径或原始哈希。
+- 原始完整 XML 只保存在 `%LOCALAPPDATA%\cmbuyer\artifacts\T-103\...\raw`，不得由 HTTP sink、
+  Vikunja 或 Git 读取/上传。真机流程可在内存中读取当前页面树，但只返回规格、选中态、价格和页面
+  状态摘要；不得把地址、手机号或支付凭据解析成业务字段或写入日志。
+- T-103 不再扩展截图遮罩器；本任务先以本机原始截图完成真机验收。生产第一趟原始截图上传由 T-204
+  接入，允许截图包含页面已显示的地址和手机号，但只允许已认证设备上传、已登录管理员查看；完整 XML、
+  外部支付页和支付凭据不得上传。
 - `needs_device: true`：agent 只能完成离线实现并保持 `DOING`；只有人完成安全入口、精确规格选择、
-  SKU 单价语义、页面对应性与派生证据验收后才能标 `DONE`。
+  SKU 单价语义、页面对应性与安全退出验收后才能标 `DONE`。HTTP 截图上传实现不属于 T-103 验收。