cmroubao/docs/tasks/T-004.md

id, title, phase, deps, status, created, context_ref, work_branch, write_paths

id	title	phase	deps	status	created	context_ref	work_branch	write_paths
T-004	导入本机蝦皮订单验证样本	0	T-001	TODO	2026-07-25	null	null	docs/tasks/T-004.md android-buyer/tools/** android-buyer/app/src/debug/** android-buyer/app/src/test/** .gitignore docs/03-tech-stack.md docs/04-architecture.md docs/05-coding-rules.md docs/current-state.md

问题 / 背景

第一层技术探针需要使用用户已有的蝦皮订单资料，而不是在 Android 代码里硬编码虚构 需求。本机目录中一份文本和一份参考图以蝦皮订单号同名；文本包含自己的店铺名、 待采集商品标题、SKU 和数量。Android 设备不能直接读取 Windows 绝对路径，需要一个 Debug/测试专用导入边界。

首份同名样例已在 2026-07-25 完成非业务内容核实：文本是可按 UTF-8 解码的无 BOM 四行格式，标签为 店铺名：、商品标题：、SKU：、数量：；参考图是可解码的 JPEG。正式私有目录、额外图片类型和一单多 SKU 规则仍未固定。

关联需求与交互

• 功能：为 F-004 提供第一层原始输入，不改变正式 F-001 创建任务流程。
• 用户故事：US-004。
• 交互：无生产 UI；导入失败通过开发命令和测试报告返回。
• 架构/API：04-architecture.md 3.1；不调用正式后台 API。

方案

1. 将当前根目录样例迁移或配置到明确的私有样本目录，保持 Git 忽略。
2. 以已核实的 UTF-8 四行标签和 JPEG 为首版契约；一单多 SKU 不明确前拒绝导入。
3. 实现开发机导入工具，按文件主名精确配对文本和唯一参考图。
4. 校验订单号、店铺名、标题、SKU、正整数数量、图片存在且可解码。
5. 生成与未来 HTTP TaskSource 同构的 ProbeTask，输出到被 Git 忽略的 .local/ 目录，供 Debug 构建和测试装载。
6. 为有效样本、缺图、多图、重复订单号、未知编码/格式、非法数量和敏感日志编写测试。

验收要点

• 一组合法脱敏文本和参考图能稳定生成一个 ProbeTask。
• source_order_no 来自文件主名；标题、SKU 和数量与原文完全一致。
• 缺失或匹配到多张参考图、必填字段缺失、数量非法时导入明确失败。
• Android workflow 通过 TaskSource 消费结果，不依赖 Windows 路径或导入器类型。
• 真实订单文件、图片、生成物和本机绝对路径均未进入 Git。
• 日志不包含完整订单号、店铺名或原图绝对路径。
• 普通自动化测试不调用真实付费 VLM。

边界

• 不实现 Go-Gin、SQLite、任务领取、鉴权或管理 Web。
• 不实现拼多多自动化和 VLM 供应商调用。
• 不把模糊文本解析结果当成成功，不静默选择重名图片。
• 不处理未经确认的一单多 SKU 格式。

执行记录

尚未开始，等待 T-001 完成。前置检查已确认一组同名文本/JPEG 存在，文本字段结构和 图片解码有效；未记录或提交实际订单号、店铺名、商品内容及图片。实现时仍需确定正式 私有目录和一单多 SKU 规则。