feat(extension): 采集插件功能开发

2026-09-06 22:32:39 +08:00
parent 87db74fb89
commit 4c0f3a4a79
35 changed files with 790 additions and 20 deletions
@@ -0,0 +1,27 @@
+# M2.4：1688、淘宝、天猫解析器与采集数据测试页
+
+> 状态：已完成第一版页面状态解析与结果检查面（2026-09-06）。
+
+## 真实 SKU 证据规则
+
+| 来源 | 创建多 SKU 的唯一证据 | 禁止行为 |
+|---|---|---|
+| 1688 | `skuMapOriginal` 的实际组合行；优先使用行内 `skuId`，否则以来源组合键为稳定 key。 | 用 `skuProps` 的规格值排列组合制造 SKU。 |
+| 淘宝 / 天猫 | `skuBase.skus[]` 的 `skuId + propPath`；`propPath` 映射回 `skuBase.props`。 | 只有 `props` 时把颜色、尺码等规格轴展开成 SKU。 |
+
+`skuCore.sku2info[skuId]` 只补充已验证 SKU 的参考价格，不能单独证明一个 SKU 存在。来源未给出组合表时，服务端保留规格轴、创建默认 SKU，并让该记录进入 `needs_review`。
+
+## 测试页
+
+扩展的“编辑上架”在采集成功后打开 `/collection-test/{collectionItemId}`，而不是进入尚未完成的商品编辑模块。页面只读显示：
+
+- 采集来源、解析器版本、状态、SKU 数和素材任务数；
+- 实际创建的 SKU 草稿及其来源 key；
+- 每张候选素材的转存状态和失败原因；
+- 持久化的 `normalized_payload` 与 `raw_evidence` JSON。
+
+这让测试者能直接比对页面上的规格组合和服务端保存数据。它不是商品编辑页，也不会把来源价格、属性或媒体关系当作已确认发布数据。
+
+## 已知边界
+
+页面状态结构会随来源站灰度变动；当前解析器只读取已在页面脚本中可见的 JSON 对象。若页面数据仅存在于运行时内存或经签名接口延迟获取，本版会保留默认 SKU/规格轴而不猜测组合。后续需要使用允许的快照样本补充 MAIN world bridge 和针对站点版本的适配器测试。