本工单是大工单 #1 的首个可交付版本，先完成 Client 的可运行骨架、本地任务管理、Admin Mock 闭环和安全的自动化演练基础。
#3 拆分 PDD 与设置页面 UI 模�����
#4 实现 PDD 任务列表 UI
#5 实现设置页设备管理 UI 与事件接口
#6 为当前设备增加保存与设备号生成
#7 实现 SQLite 初始化与 v1 迁移
#8 定义任务数据模型与 SQLite Repository
#9 PDD 任务列表接入 SQLite Repository
#10 定义 Admin Gateway 并实现 Mock 契约
#11 保存当前设备并登记 Client
#21 实现 Android 设备搜索
#22 保存当前使用的 Android 设备
#25 将勾选的 USB Android 设备转为 Wi-Fi ADB
#26 启动时自动恢复已保存的 Android 设备
#27 修复 Wi-Fi ADB 拔线后刷新丢失
#12 Admin：新增幂等 Client 登记接口（Client 联调依赖）
#13 优化 Admin Windows 启动脚本并增加热重载
#29 设置页显示 PDD 安装状态并调整设备提示布局
#28 实现 uiautomator2 设备连接与 PDD 商品采集基础服务
#30 Client：领取 Admin 创建的采集任务
#32 Client：执行采集任务，把结果提交给 Admin
#71 实现采购任务演练执行与结果回传
#72 安全领取并分派 Admin 采购任务
#73 完善采购任务崩溃恢复与安全门禁验证
MVP 集成与打包：待拆分
#44 优化 PDD 颜色采集等待时间
#45 让获取任务按钮支持持续自动运行和安全停止
docs/client/
每个单元任务独立提交；出现回归时按工单提交回退，不回退用户无关改动。
���窗口可启动，并只显示“PDD 任务”和“设置”两个顶级模块；
任务列表支持本地查询、筛选、排序和详情入口；
Admin Mock 领取与结果提交闭环可重复验证；
采集任务能生成结构化结果���进入 Outbox；
采购演练能选择目标规格并在不可逆动作前安全停止；
线程、崩溃恢复、凭据和采购红线测试通过；
干净 Windows 环境可运行打包产物。
#63 为选中的采集任务增加重新执行入口
#66 修复旧 Wi-Fi 设备恢复失败时无法搜索 USB 设备
#70 允许等待重试的采集任务手动重新执行
#75 接入正式 uiautomator2 采购演练 Adapter
#82 优化重新执行提示、弹窗与取消交互
#84 采集采购前检查 Android 设备连接状态
#87 任务错误提示调整为窗口顶部居中
#89 PDD 任务表增加批量勾选和重新上报
#91 修复重新上报导致任务状态与 Outbox 不一致
#92 Client：建立 Windows 打包与发布清单基础
#170 任务失败不自动重试并继续下一条
#173 正式采购下单前更新地址采购编号标记
#175 兼容底部提交提示的非滚动规格面板
Client Android 设备阶段的 #21、#22、#25、#26、#27 已由用户验收通过并关闭；本地归档状态更新提交为 a6e3fe0。同时修正 #10 已关闭但父清单未勾选的问题。父工单继续保持开启，后续未拆分工作不受影响。
a6e3fe0
子工单 #32 已完成代码与文档提交（2d1fdbe、51c2292），Client 采集→SQLite/Outbox→Admin 提交主链已接通；143 项 Client 测试和 Admin 全量测试通过。工单仍 open，等待稳定真机完成最终联调验收。
新增缺陷子工单 #35：修复 #32 真机联调发现的 PDD 商品页误判超时、失败响应缺少 result_id、超时无 XML 证据及误报 Admin 拒绝。现已开始实施。
子工单 #35 已完成代码与归档提交（c59b4b0、09b27ce）：修复 PDD 页面焦点误判、失败回执缺 result_id、超时无 XML 证据和误报拒绝。Client 150 项及 Admin 全量测试通过；工单保持 open 等待真机验收。
新增缺陷子工单 #36：参考 demo1/auto_v1.py，把正式采集顺序调整为首页立即点击规格入口，评价/店铺不再阻塞，并增加规格面板打开等待。现已开始实施。
??? #36 ??????????:?????????????????,??????????;153 ?????,?????????????????? e65cc2a,???? e08fd89?????? PDD_DATA_PRICE_MISSING ?????????????????
e65cc2a
e08fd89
PDD_DATA_PRICE_MISSING
???????????????? #:????????????????,????????????;?????? color,???????#36 ????,??????????????????
更正上一条缺少编号的评论：关联工单已成功创建为 #37。规格面板将按动态行蛇形逐色点击采价，颜色完成后只收集尺码文字；价格粒度保持 color，不按尺码采价。#36 保持开启，等待端到端复验。
关联工单 #37 已完成代码和自动测试：蛇形逐色采价、同价颜色、空 selected_text 降级、尺码只读及 SQLite/Outbox 顺序均已覆盖，156 项测试通过。实现 9562da9，归档 6c12e05。真机复验被三星支付安全提示阻塞，未绕过安全提示；#36 和 #37 都保持开启等待人工处理提示后验收。
新增 Client 单元工单 #39：实现只读任务详情窗口，颜色在上并显示逐色价格、尺码在下，连接现有详情/双击/Enter 入口。
MVP 子工单 #39 已实现并归档，当前等待用户验收。已接通任务详情入口并完成颜色价格/尺码分区展示；Client 162 项测试全部通过。
新增 MVP 单元工单：- [ ] #40 商品详情页滚动采集评价数量和店铺名。完成后采集结果中的店铺与评价可在任务详情中展示。
MVP 子工单 #40 已实现并归档，状态待真机验收；商品页现在先补采评价和店铺，再进入原规格流程。Client 166 项回归通过。
新增单元工单 #42：允许颜色缺价并继续采集尺码提交结果。范围仅为解除缺价阻断、补测试与文档；不调整遍历算法和接口结构。
单元工单 #42 已实现并完成自动化验证：颜色缺价不再阻断尺码采集和结果提交。提交 5aaf0a9、归档 033bef0；当前等待真机验收，工单保持打开。
5aaf0a9
033bef0
单元工单 #44 已实现并归档：颜色采价改为状态驱动短间隔等待，水平滑动减少固定等待；31 项专项、172 项 Client 全量测试通过。提交 ed72e62、7b104e3、cbb03fa，当前等待真机耗时与数据完整度验收。
ed72e62
7b104e3
cbb03fa
#45 已完成代码实现与本地归档，当前等待用户真机验收。实现提交 5fd7198，归档提交 7fb137f，Client 全量测试 176 项通过。父工单清单暂保持未完成，验收通过后再勾选并关闭 #45。
5fd7198
7fb137f
598c808
用户明确验收通过 43 个 Client 单元工单。本地归档状态已更新，验收记录提交为 eca9289，对应单元工单均已关闭。
eca9289
本父工单中存在的对应清单已更新为完成；此前未进入父清单的历史采集链路 #35、#36、#37、#39、#40、#42 已补录为完成。父工单仍有其他未完成范围，因此保持打开。
任务进度同步：#103、#136、#143 已由用户验收通过并关闭；父工单清单已更新。验收记录提交：cc595c1。
cc595c1
2679106
e96cbca
47a59a2
a4f420c
两个父清单暂保持未勾选，用户验收通过后再关闭子工单并同步父工单。
#162 已实现并归档，状态为待用户真机验收。实现提交 bd1d095，归档提交 f859b58，Client 完整 410 项测试通过。父清单暂保持未勾选，验收通过后再关闭并同步。
bd1d095
f859b58
进度更新：#163 与 #164 已进入待验收。#163 全量 410 项测试通过；#164 全量 414 项测试、语法检查和离屏 UI 冒烟通过。未执行真机采购、下单或付款；用户验收后再勾选父工单清单。
#166 已进入待验收：款式映射为 color、套餐映射为 size，默认套餐取消和采购面板识别已覆盖；Client 全量 420 项测试通过。未执行真机采购、下单或付款。
color
size
#167 已完成代码与自动化验证，当前待用户真机验收。实现提交 18678e1，归档提交 6984e06；Client 完整 422 项测试通过。父工单清单暂不勾选，验收通过后再同步关闭。
18678e1
6984e06
#168 已完成实现和自动化验证，当前待真机验收。实现提交 94793ab，归档提交 1730c57；Client 完整 423 项测试通过。父工单清单暂不勾选，验收通过后再同步关闭。
94793ab
1730c57
#168 已根据真机失败 XML 完成第二次修订：6ed2305，归档更新 c61a028。已兼容“套餐名称 + 尾部价格”和接近全宽的长套餐，Client 423 项测试通过，当前再次等待真机验收。
6ed2305
c61a028
#170 已完成实现并待验收：任务自身失败上报后继续下一条，不自动重试；全局阻塞仍停止。实现 8b8a542，归档 88d59e4，Client 429 项测试通过。父工单清单暂不勾选。
8b8a542
88d59e4
用户于 2026-08-13 批量验收通过相关单元工单，已关闭并同步勾选：#131、#137、#138、#145、#147、#148、#149、#154、#155、#159、#160、#161、#162、#163、#164、#166、#167、#168、#170、#173、#175、#176、#177、#178、#179、#180、#187、#189、#190、#191。本地归档状态提交：ad44f83。父工单仍按其余未完成范围保持打开。
ad44f83
新增单元工单 #221：在正式采购地址流程六类关键状态改变操作后增加统一 1 秒稳定等待，同时保留页面状态轮询、唯一目标、单次保存和不可逆安全门禁。
新增单元工单 #230：采购规格面板打开后，若正式颜色区域不可见，则在可靠容器中有界归位到顶部，再复用现有颜色和尺码选择逻辑。
No dependencies set.
The note is not visible to the blocked user.
背景
本工单是大工单 #1 的首个可交付版本，先完成 Client 的可运行骨架、本地任务管理、Admin Mock 闭环和安全的自动化演练基础。
MVP 目标
MVP 不包含
阶段
单元任务
#3 拆分 PDD 与设置页面 UI 模�����
#4 实现 PDD 任务列表 UI
#5 实现设置页设备管理 UI 与事件接口
#6 为当前设备增加保存与设备号生成
#7 实现 SQLite 初始化与 v1 迁移
#8 定义任务数据模型与 SQLite Repository
#9 PDD 任务列表接入 SQLite Repository
#10 定义 Admin Gateway 并实现 Mock 契约
#11 保存当前设备并登记 Client
#21 实现 Android 设备搜索
#22 保存当前使用的 Android 设备
#25 将勾选的 USB Android 设备转为 Wi-Fi ADB
#26 启动时自动恢复已保存的 Android 设备
#27 修复 Wi-Fi ADB 拔线后刷新丢失
#12 Admin：新增幂等 Client 登记接口（Client 联调依赖）
#13 优化 Admin Windows 启动脚本并增加热重载
#29 设置页显示 PDD 安装状态并调整设备提示布局
#28 实现 uiautomator2 设备连接与 PDD 商品采集基础服务
#30 Client：领取 Admin 创建的采集任务
#32 Client：执行采集任务，把结果提交给 Admin
#71 实现采购任务演练执行与结果回传
#72 安全领取并分派 Admin 采购任务
#73 完善采购任务崩溃恢复与安全门禁验证
MVP 集成与打包：待拆分
#44 优化 PDD 颜色采集等待时间
#45 让获取任务按钮支持持续自动运行和安全停止
依赖和风险
docs/client/基线。回退策略
每个单元任务独立提交；出现回归时按工单提交回退，不回退用户无关改动。
MVP 验收标准
���窗口可启动，并只显示“PDD 任务”和“设置”两个顶级模块；
任务列表支持本地查询、筛选、排序和详情入口；
Admin Mock 领取与结果提交闭环可重复验证；
采集任务能生成结构化结果���进入 Outbox；
采购演练能选择目标规格并在不可逆动作前安全停止；
线程、崩溃恢复、凭据和采购红线测试通过；
干净 Windows 环境可运行打包产物。
#63 为选中的采集任务增加重新执行入口
#66 修复旧 Wi-Fi 设备恢复失败时无法搜索 USB 设备
#70 允许等待重试的采集任务手动重新执行
#75 接入正式 uiautomator2 采购演练 Adapter
#82 优化重新执行提示、弹窗与取消交互
#84 采集采购前检查 Android 设备连接状态
#87 任务错误提示调整为窗口顶部居中
#89 PDD 任务表增加批量勾选和重新上报
#91 修复重新上报导致任务状态与 Outbox 不一致
#92 Client：建立 Windows 打包与发布清单基础
PDD 任务列表交互完善（2026-08-10）
PDD 规格面板标题兼容（2026-08-11）
PDD 批量人工执行（2026-08-11）
历史采集链路验收补录（2026-08-11）
PDD 任务详情复制（2026-08-11）
Client 窗口启动体验（2026-08-11）
Client 正式地址与内置 ADB（2026-08-11）
PDD 非滚动规格面板兼容（2026-08-11）
PDD 非滚动规格面板颜色节点兼容（2026-08-11）
PDD 售罄页识别（2026-08-11）
PDD 默认尺码与商品页补采优化（2026-08-11）
PDD 规格面板瞬态空树稳定性（2026-08-11）
PDD 补采速度与任务订单可读性（2026-08-11）
PDD 款式与套餐规格兼容（2026-08-11）
PDD 第二规格完整遍历（2026-08-11）
PDD 纵向第二规格续页
自动任务失败后继续队列
#170 任务失败不自动重试并继续下一条
#173 正式采购下单前更新地址采购编号标记
#175 兼容底部提交提示的非滚动规格面板
PDD 任务当前行快捷操作（2026-08-12）
PDD 非滚动尺码采集兼容（2026-08-12）
PDD 非滚动图片颜色采购兼容（2026-08-12）
PDD 收货地址编辑页稳定导航（2026-08-12）
PDD 地址保存与系统浮层兼容（2026-08-12）
PDD 多地址面板兼容（2026-08-12）
PDD 多地址异步加载稳定性（2026-08-12）
PDD 快速购买确认页兼容（2026-08-12）
PDD 地址保存点击稳定性（2026-08-12）
PDD 地址操作稳定等待（2026-08-14）
PDD 采购规格面板顶部归位（2026-08-14）
PDD 采购规格繁简体安全匹配（2026-08-17）
Client Android 设备阶段的 #21、#22、#25、#26、#27 已由用户验收通过并关闭；本地归档状态更新提交为
a6e3fe0。同时修正 #10 已关闭但父清单未勾选的问题。父工单继续保持开启，后续未拆分工作不受影响。子工单 #32 已完成代码与文档提交（2d1fdbe、51c2292），Client 采集→SQLite/Outbox→Admin 提交主链已接通；143 项 Client 测试和 Admin 全量测试通过。工单仍 open，等待稳定真机完成最终联调验收。
新增缺陷子工单 #35：修复 #32 真机联调发现的 PDD 商品页误判超时、失败响应缺少 result_id、超时无 XML 证据及误报 Admin 拒绝。现已开始实施。
子工单 #35 已完成代码与归档提交（c59b4b0、09b27ce）：修复 PDD 页面焦点误判、失败回执缺 result_id、超时无 XML 证据和误报拒绝。Client 150 项及 Admin 全量测试通过；工单保持 open 等待真机验收。
新增缺陷子工单 #36：参考 demo1/auto_v1.py，把正式采集顺序调整为首页立即点击规格入口，评价/店铺不再阻塞，并增加规格面板打开等待。现已开始实施。
??? #36 ??????????:?????????????????,??????????;153 ?????,??????????????????
e65cc2a,????e08fd89??????PDD_DATA_PRICE_MISSING????????????????????????????????? #:????????????????,????????????;?????? color,???????#36 ????,??????????????????
更正上一条缺少编号的评论：关联工单已成功创建为 #37。规格面板将按动态行蛇形逐色点击采价，颜色完成后只收集尺码文字；价格粒度保持 color，不按尺码采价。#36 保持开启，等待端到端复验。
关联工单 #37 已完成代码和自动测试：蛇形逐色采价、同价颜色、空 selected_text 降级、尺码只读及 SQLite/Outbox 顺序均已覆盖，156 项测试通过。实现 9562da9，归档 6c12e05。真机复验被三星支付安全提示阻塞，未绕过安全提示；#36 和 #37 都保持开启等待人工处理提示后验收。
新增 Client 单元工单 #39：实现只读任务详情窗口，颜色在上并显示逐色价格、尺码在下，连接现有详情/双击/Enter 入口。
MVP 子工单 #39 已实现并归档，当前等待用户验收。已接通任务详情入口并完成颜色价格/尺码分区展示；Client 162 项测试全部通过。
新增 MVP 单元工单：- [ ] #40 商品详情页滚动采集评价数量和店铺名。完成后采集结果中的店铺与评价可在任务详情中展示。
MVP 子工单 #40 已实现并归档，状态待真机验收；商品页现在先补采评价和店铺，再进入原规格流程。Client 166 项回归通过。
新增单元工单 #42：允许颜色缺价并继续采集尺码提交结果。范围仅为解除缺价阻断、补测试与文档；不调整遍历算法和接口结构。
单元工单 #42 已实现并完成自动化验证：颜色缺价不再阻断尺码采集和结果提交。提交
5aaf0a9、归档033bef0；当前等待真机验收，工单保持打开。单元工单 #44 已实现并归档：颜色采价改为状态驱动短间隔等待，水平滑动减少固定等待；31 项专项、172 项 Client 全量测试通过。提交
ed72e62、7b104e3、cbb03fa，当前等待真机耗时与数据完整度验收。#45 已完成代码实现与本地归档，当前等待用户真机验收。实现提交
5fd7198，归档提交7fb137f，Client 全量测试 176 项通过。父工单清单暂保持未完成，验收通过后再勾选并关闭 #45。PDD 批量人工执行进度（2026-08-11）
598c808Client 工单批量验收同步（2026-08-11）
用户明确验收通过 43 个 Client 单元工单。本地归档状态已更新，验收记录提交为
eca9289，对应单元工单均已关闭。本父工单中存在的对应清单已更新为完成；此前未进入父清单的历史采集链路 #35、#36、#37、#39、#40、#42 已补录为完成。父工单仍有其他未完成范围，因此保持打开。
任务进度同步：#103、#136、#143 已由用户验收通过并关闭；父工单清单已更新。验收记录提交：
cc595c1。PDD 默认尺码与商品页补采优化进度（2026-08-11）
2679106，归档e96cbca。47a59a2，归档a4f420c。两个父清单暂保持未勾选，用户验收通过后再关闭子工单并同步父工单。
PDD 规格面板瞬态空树稳定性进度（2026-08-11）
#162 已实现并归档，状态为待用户真机验收。实现提交
bd1d095，归档提交f859b58，Client 完整 410 项测试通过。父清单暂保持未勾选，验收通过后再关闭并同步。进度更新：#163 与 #164 已进入待验收。#163 全量 410 项测试通过；#164 全量 414 项测试、语法检查和离屏 UI 冒烟通过。未执行真机采购、下单或付款；用户验收后再勾选父工单清单。
#166 已进入待验收：款式映射为
color、套餐映射为size，默认套餐取消和采购面板识别已覆盖；Client 全量 420 项测试通过。未执行真机采购、下单或付款。#167 已完成代码与自动化验证，当前待用户真机验收。实现提交
18678e1，归档提交6984e06；Client 完整 422 项测试通过。父工单清单暂不勾选，验收通过后再同步关闭。#168 已完成实现和自动化验证，当前待真机验收。实现提交
94793ab，归档提交1730c57；Client 完整 423 项测试通过。父工单清单暂不勾选，验收通过后再同步关闭。#168 已根据真机失败 XML 完成第二次修订：
6ed2305，归档更新c61a028。已兼容“套餐名称 + 尾部价格”和接近全宽的长套餐，Client 423 项测试通过，当前再次等待真机验收。#170 已完成实现并待验收：任务自身失败上报后继续下一条，不自动重试；全局阻塞仍停止。实现
8b8a542，归档88d59e4，Client 429 项测试通过。父工单清单暂不勾选。用户于 2026-08-13 批量验收通过相关单元工单，已关闭并同步勾选：#131、#137、#138、#145、#147、#148、#149、#154、#155、#159、#160、#161、#162、#163、#164、#166、#167、#168、#170、#173、#175、#176、#177、#178、#179、#180、#187、#189、#190、#191。本地归档状态提交：
ad44f83。父工单仍按其余未完成范围保持打开。新增单元工单 #221：在正式采购地址流程六类关键状态改变操作后增加统一 1 秒稳定等待，同时保留页面状态轮询、唯一目标、单次保存和不可逆安全门禁。
新增单元工单 #230：采购规格面板打开后，若正式颜色区域不可见，则在可靠容器中有界归位到顶部，再复用现有颜色和尺码选择逻辑。