docs: 记录三段交付节奏与 R5 排序 (#2)
MVP1 商品同步 → MVP2 本地拿到视频 → MVP3 回传货憨憨。 R5 排最后是硬约束:唯一缺接口契约、唯一写真实数据、 且货憨憨图片空间仅剩约 26 GB。 Q1、Q2 的解决时机定为 MVP2 交付后使用者手动上传时抓包。 Co-Authored-By: Claude Opus 5 <noreply@anthropic.com> Claude-Session: https://claude.ai/code/session_01LbdtsD3ohhSMy3KPoCgARq
This commit is contained in:
@@ -2,8 +2,8 @@
|
||||
generated: true (请先修改 Gitea Wiki,禁止直接编辑本文件)
|
||||
wiki_page: Product-Requirements-Overview
|
||||
wiki_url: https://git.ilapage.cn/chengma/cmsp/wiki/Product-Requirements-Overview.-
|
||||
wiki_revision: dfc7d9b0abe116951c9f86c8877090e16556cb3c
|
||||
synchronized_at: 2026-09-02T07:59:06Z
|
||||
wiki_revision: a3a26399db6ba800b47955d0193867557e41081a
|
||||
synchronized_at: 2026-09-02T08:07:24Z
|
||||
<!-- gitea-wiki-mirror:end -->
|
||||
|
||||
# 需求总览
|
||||
@@ -31,13 +31,39 @@ synchronized_at: 2026-09-02T07:59:06Z
|
||||
| R2 | 专属 Chrome 与淘宝登录 | 启动固定 Profile 的专属 Chrome,由使用者手动登录,程序做两层登录检查 | 已确认,未实现 | [业务规则与术语](03-business-rules-and-glossary.md) | 待创建 |
|
||||
| R3 | 淘宝以图搜 | 用商品主图调用 MTOP 以图搜接口,解析同款商品列表 | 已确认,未实现 | [业务规则与术语](03-business-rules-and-glossary.md) | 待创建 |
|
||||
| R4 | 详情视频提取与下载 | 打开同款商品详情页,提取介绍视频地址,下载 MP4 并校验完整性 | 已确认,未实现 | [业务规则与术语](03-business-rules-and-glossary.md) | 待创建 |
|
||||
| R5 | 视频上传货憨憨 | 把本地视频上传到货憨憨素材空间并关联到对应商品,使 Shopee 可见 | **接口契约未确认** | [业务规则与术语](03-business-rules-and-glossary.md) 规则 19 | 待创建 |
|
||||
| R5 | 视频上传货憨憨 | 把本地视频上传到货憨憨素材空间并关联到对应商品,使 Shopee 可见 | **接口契约未确认,排在最后** | [业务规则与术语](03-business-rules-and-glossary.md) 规则 19 | 待创建 |
|
||||
| R6 | 桌面界面 | 左侧可折叠导航(商品列表 / 参数设置)+ 两行工具栏 + 商品表格 + 运行日志子窗口 | 原型已确认,未实现 | [架构与代码地图](02-architecture-and-code-map.md) | 待创建 |
|
||||
| R7 | 任务引擎与断点 | 批量任务的队列、并发、进度事件、断点续传与全局停止门 | 已确认,未实现 | [业务规则与术语](03-business-rules-and-glossary.md) | 待创建 |
|
||||
| R8 | 本地状态存储 | SQLite 保存商品、任务、视频、上传状态与货憨憨认证状态 | **表结构未确认** | [架构与代码地图](02-architecture-and-code-map.md) | 待创建 |
|
||||
|
||||
状态取值见下方「状态规则」。工单创建后把编号填入表格,不要另建第二份清单。
|
||||
|
||||
## 交付节奏
|
||||
|
||||
按 MVP 分三段交付。这个顺序是负责人于 2026-09-02 确认的,不要随意调整。
|
||||
|
||||
| 阶段 | 包含需求 | 交付后能做什么 | 阻塞条件 |
|
||||
|---|---|---|---|
|
||||
| MVP1 | R1 商品同步(含 R6 界面、R8 存储的基础部分) | 看到指定店铺的商品列表,数据落本地 | 无 |
|
||||
| MVP2 | R2 淘宝登录 + R3 以图搜 + R4 视频下载 | **本地拿到视频文件,人工上传即可使用** | 无 |
|
||||
| MVP3 | R5 回传货憨憨(含 R7 任务引擎完善) | 全自动,Shopee 商品页可见视频 | Q1、Q2 未解决前不能开始 |
|
||||
|
||||
把 R5 放在最后有三个理由,都是硬约束而不是偏好:
|
||||
|
||||
1. **只有它缺接口契约。** Q1 与 Q2 至今没有任何参考实现,负责人提供的商品页抓包中
|
||||
`uploadFiles`、`batchUpdateShopProductVideo`、`getMaterialSize` 出现 0 次。
|
||||
2. **只有它写真实数据。** R1~R4 全部是只读操作;R5 是第一个写入货憨憨并最终影响
|
||||
线上 Shopee 商品的环节,风险等级不同,必须等前面稳定。
|
||||
3. **图片空间只剩约 26 GB(已用 98.7%)。** 视频体积远大于图片,现在批量上传大概率
|
||||
触发「容量不足」。这段时间用于清理旧素材或扩容。
|
||||
|
||||
**MVP2 完成后工具已具备实用价值**:最耗时的「找同款、提取视频、下载」已自动化,
|
||||
剩余的人工上传只是在货憨憨后台点几下。即使 R5 长期阻塞,工具也不是半成品。
|
||||
|
||||
**顺带解决 Q1 与 Q2**:MVP2 交付后,使用者必然会在货憨憨后台手动上传视频,
|
||||
那次操作就是抓取上传接口的最佳时机,且是真实业务场景下的完整请求,
|
||||
比专门构造一次更可靠。
|
||||
|
||||
## 未决问题
|
||||
|
||||
这些问题在实现相关需求前必须先解决。它们是假设,不是事实,不得据此编码。
|
||||
@@ -51,7 +77,9 @@ synchronized_at: 2026-09-02T07:59:06Z
|
||||
| Q5 | SQLite 表结构与迁移方式 | R8 | 待设计 |
|
||||
| Q6 | 上传后 Shopee 侧的生效延迟与验证方式 | R5 | 待实测 |
|
||||
|
||||
Q1 与 Q2 是整条链路上唯一没有已验证参考实现的环节:仓库外的 Python 项目只实现了图片上传,视频上传接口没有代码。
|
||||
Q1 与 Q2 是整条链路上唯一没有已验证参考实现的环节:仓库外的 Python 项目只实现了图片上传,视频上传接口没有代码;负责人提供的商品页 HAR 中这三个接口也出现 0 次。
|
||||
|
||||
**解决时机**:MVP2 交付后,使用者手动上传视频时抓包。在此之前 MVP3 不启动。
|
||||
|
||||
## 已确认的界面决定
|
||||
|
||||
|
||||
Reference in New Issue
Block a user