GPU_GUARD_MONOREPO/docs/progress/phase1-scope-design.md

Neta AI 电商 - 第一期项目范围定义

用途：作为 Neta 平台第一期内部立项、范围确认、上线验收和后续对外销售前置规则的依据 日期：2026-04-17 上线目标日期：2026-08-15 验收方式：按场景验收并在上线前完成整体验收确认 基础设计文档：docs/superpowers/specs/2026-04-11-netaclaw-ecommerce-automation-design.md

1. 文档定位

本文件用于明确 Neta 平台第一期的建设目标、上线范围、边界约定、验收口径、风险依赖及后续对外使用前提。

本文件适用于内部团队协同、一期上线验收和后续产品销售准备，不作为底层技术设计说明，不展开具体框架实现细节。

2. 项目背景与总体目标

Neta 平台的总体目标，是让一个运营人员通过统一平台管理多个电商平台店铺账号，通过系统承担重复性运营动作，降低人工切换平台、重复录入和重复执行的成本。

平台建设完成后，运营人员应将主要精力放在复杂发货处理、经营分析、看报告、找产品、选品判断及其他高价值工作上，而将重复性高、标准化程度高的运营动作交由系统辅助执行或自动化完成。

平台长期方向包括统一接入、统一操作、统一数据查看，并在后续阶段逐步扩展更深层的运营自动化能力。

3. 第一期上线目标与范围

第一期目标是在 2026 年 8 月 15 日 实现 Neta 平台上线，完成淘宝/天猫、京东、拼多多三个平台的基础可用版本交付。第一期重点跑通以下核心能力：

• 店铺接入与连接管理：支持三平台店铺账号基础接入、登录状态查看、连接状态管理和多店铺基础管理。
• 商品基础运营：支持商品同步、上架、下架、删除、标题修改、价格修改、库存修改、基础 SKU 管理。
• AI 自动推广执行：通过 AI 自动化操作浏览器，获取指定店铺、指定类目或指定商品的基础行业数据，并在已适配场景下自动完成基础投流和活动报名。
• 商品图片生成与替换：支持基于商品信息和用户要求生成商品主图或详情图，并在人工确认后完成平台图片替换。
• 基础经营数据查看：支持查看店铺基础经营数据、商品排行数据、趋势数据，并支持基础查询与导出。

第一期交付以跑通上述链路、满足真实运营使用为目标。三平台页面结构、字段范围和操作路径允许存在差异，以各平台实际可支持情况及一期上线清单为准。

4. 第一期不含范围

为确保第一期按 2026 年 8 月 15 日 如期上线，以下内容不纳入第一期交付范围，原则上作为后续阶段规划内容另行评估：

• 抖音、快手等内容驱动型平台能力
• 直播相关运营能力，包括直播场景自动化操作、直播中控和直播数据处理
• 自动化经营决策能力，包括自动调价、自动上下架、自动补货、自动投放等策略型能力
• 复杂发货履约相关能力，包括订单发货、物流处理、售后流程协同等
• 客服自动回复及会话型客户服务能力
• 竞品监控、市场大盘抓取、深度选品分析等高级数据能力
• 文生视频及其他超出商品图片生成范围的内容生产能力
• 无人值守全自动运营能力

5. 功能模块范围说明

模块一：店铺接入与连接管理

本期目标： 完成淘宝/天猫、京东、拼多多三平台基础接入能力，为后续自动化操作提供执行入口。

本期包含

编号	功能项	说明
1.1	平台登录	各平台卖家后台基础登录能力，支持扫码或账号密码方式，登录态可持久化
1.2	基础风险规避	通过人工节奏模拟、浏览器行为模拟等方式降低基础识别风险
1.3	多店铺基础管理	支持多店铺基础接入与并发执行控制，默认并发上限为 3
1.4	连接状态监控	登录态检测、过期提醒、失效提示、基础重连能力
1.5	平台适配层	三平台独立适配各自后台页面和核心操作路径
1.6	启动与运行交付	提供可启动的桌面运行形式，满足内部上线使用

本期不包含

• 平台全部账号安全机制自动绕过
• 所有风控场景自动恢复
• 所有登录异常的自动处理
• 对第三方平台长期稳定无波动的能力承诺

上线标准

• 三个平台均可完成基础登录并保持可用会话
• 支持同时操作至少 3 个店铺的基础运行场景
• 用户可查看店铺连接状态与失效提示
• 系统可在约定 Windows 环境下正常启动运行

---

模块二：商品基础运营

本期目标： 完成三平台商品基础运营核心链路，支持用户通过 Neta 平台统一发起商品操作，并在指定推广场景下由 AI 自动化执行行业数据获取、基础投流和活动报名。

本期包含

编号	功能项	说明
2.1	商品列表同步	从平台抓取商品列表到本地数据库
2.2	商品上架	支持单个或批量商品上架，支持对话指令触发
2.3	商品下架	支持单个或批量商品下架，支持对话指令触发
2.4	商品删除	支持单个或批量商品删除，执行前需二次确认
2.5	商品新建	填写基础信息后在平台创建新商品
2.6	标题编辑	修改商品标题，支持 AI 辅助生成标题建议
2.7	价格编辑	修改商品价格，包括单价和 SKU 价格，需用户二次确认
2.8	库存编辑	修改商品库存数量
2.9	SKU 管理	支持基础 SKU 规格的新增、编辑和删除
2.10	操作日志	记录操作人、操作时间、目标商品及具体操作内容
2.11	执行前确认	Agent 展示待执行操作，用户确认后执行
2.12	操作节奏控制	批量操作按人工节奏进行，间隔随机 3 至 8 秒
2.13	行业数据获取	通过 AI 自动化操作浏览器获取指定店铺、指定类目或指定商品相关的基础行业数据，为推广执行提供输入
2.14	基础投流执行	支持在已适配平台和已约定场景下，通过 AI 自动化操作浏览器执行基础推广投放操作，包括但不限于直通车、京准通、多多进宝等
2.15	活动报名	支持在已适配平台和已约定场景下，通过 AI 自动化操作浏览器执行基础活动报名流程

本期不包含

• 复杂促销活动配置
• 特殊类目复杂发布流程
• 复杂订单履约流程
• 自动调价、自动上下架、自动预算优化、自动出价优化等策略型自动执行
• 未经适配确认的平台、投放类型、活动类型或页面流程
• 脱离人工确认的无人值守连续投流和连续报活动

上线标准

• 通过 Neta 平台可完成三平台商品的基础上下架和信息编辑
• 在已适配平台和约定场景下，可自动获取指定店铺行业数据并完成基础投流或活动报名
• 操作结果与平台卖家后台一致
• 批量操作支持至少 50 个商品
• 所有写操作具备执行前确认机制
• 操作日志完整可追溯

---

模块三：商品图片生成与替换

本期目标： 形成商品图片生成、预览、确认、替换的完整闭环，提升商品视觉内容生产效率。

本期包含

编号	功能项	说明
3.1	主图生成	基于商品信息和用户描述生成商品主图
3.2	详情图生成	生成商品详情页图片
3.3	图片预览	生成结果展示给用户预览
3.4	人工确认	用户确认满意后才执行替换
3.5	自动上传替换	确认后自动上传到对应平台替换原图
3.6	提示词模板	支持提示词模板的新建、编辑和删除
3.7	批量生成	支持多商品批量生成图片
3.8	图片本地存储	生成图片存储到 ~/.neta/workspace/

本期不包含

• 视频生成
• 复杂品牌创意资产管理
• 图片营销效果保证
• 平台审核通过率保证

上线标准

• 对话描述需求后可生成商品主图和详情图
• 生成图片分辨率满足三平台基础上传要求
• 用户确认后可自动替换到平台，替换结果与预览一致
• 提示词模板可保存复用

---

模块四：基础经营数据查看

本期目标： 建立店铺基础经营数据采集和查看能力，为日常运营分析提供统一入口。

本期包含

编号	功能项	说明
4.1	店铺数据抓取	定时抓取销量、访客数、转化率、客单价、退款率等基础指标
4.2	商品数据抓取	抓取单品销量趋势、流量来源、收藏和加购等基础数据
4.3	数据存储	数据存入 MySQL，按天、周、月进行基础聚合
4.4	店铺概览看板	展示核心经营指标汇总
4.5	商品排行看板	按销量、流量、转化率等维度展示排行
4.6	趋势图表	展示关键指标时间趋势
4.7	数据导出	支持 Excel 和 CSV 导出
4.8	对话查询	支持通过对话查询基础经营数据

本期不包含

• 财务级数据核算
• 市场大盘深度分析
• 竞品深度监控
• 智能经营建议决策

上线标准

• 三个平台的核心经营数据可自动采集
• 数据延迟不超过 24 小时
• 看板页面可展示店铺概览、商品排行和趋势图表
• 数据可导出为 Excel 或 CSV
• 对话可查询基础经营数据

6. 验收方式与验收场景

第一期验收以 Neta 平台于 2026 年 8 月 15 日 达到约定上线条件为目标，采用“功能演示 + 场景验证 + 结果核验”的方式进行。

验收重点核验“可登录、可操作、可查看结果、可追踪记录”的上线能力。验收时应以实际平台操作结果、系统记录和平台后台状态作为共同依据。

建议一期验收至少覆盖以下场景：

• 店铺接入场景：完成淘宝/天猫、京东、拼多多店铺账号接入，并可查看连接状态或失效提示。
• 商品同步场景：对指定店铺执行商品列表同步，并在系统中查看同步后的商品信息。
• 商品上下架场景：对指定商品执行上架或下架操作，系统展示确认信息，确认后执行，并在平台后台核验结果一致。
• 商品编辑场景：对指定商品执行标题、价格、库存或基础 SKU 信息修改，并核验平台后台结果。
• 推广投流场景：对指定店铺或商品获取基础行业数据，系统展示待执行推广信息，确认后自动完成基础投流，并在平台后台核验结果一致。
• 活动报名场景：对指定店铺或商品执行活动报名，系统展示待执行报名信息，确认后自动完成报名，并在平台后台核验结果一致。
• 图片生成替换场景：根据商品信息和用户要求生成图片，完成预览和人工确认后替换到平台。
• 数据查看导出场景：查看店铺概览、商品排行、趋势图，并完成基础导出或查询。
• 任务日志追踪场景：在执行关键操作后，可查看相应任务状态、执行结果或操作记录。

如三平台在页面结构、字段名称、操作路径或后台规则上存在差异，以各平台实际可支持的等效操作结果作为验收依据，不以三平台完全同构作为验收条件。

7. 使用前提与业务配合项

为确保第一期按计划开发、联调、上线和验收，业务侧需提供以下配合：

• 提供淘宝/天猫、京东、拼多多三平台测试店铺账号及相应权限。
• 提供测试商品、图片素材、商品信息及其他必要业务资料。
• 配合完成扫码登录、验证码校验、短信验证、人机校验等需人工参与的操作。
• 提供基础经营数据口径和验收核对口径。
• 指定验收联系人、业务确认人和问题反馈窗口。

若业务侧未按时提供账号、资料、环境或必要配合，相关开发、联调、上线和验收节点需重新评估。

8. 平台依赖与边界说明

Neta 平台第一期能力依赖淘宝/天猫、京东、拼多多等第三方平台的页面结构、登录机制、验证方式、风控策略和平台规则。

基于上述依赖，第一期需明确以下边界：

• 平台页面改版、规则变化、风控升级、验证机制变化会影响功能稳定性和连续可用性。
• 第一期开通的是基础运营自动化能力，不承诺长期无波动，也不承诺覆盖平台全部运营流程。
• 数据查看能力用于经营分析和运营参考，不作为财务、审计、税务或法律结算依据。
• 图片生成与替换能力用于提供内容生产辅助，不承诺营销效果、平台审核通过率或商业转化结果。
• 第一期不承诺替代全部人工运营工作，复杂判断、复杂发货、异常处理和最终经营决策仍由人工负责。

9. 终端用户授权与使用前提

本文件虽然用于内部一期范围确认，但 Neta 平台后续面向真实终端用户销售、部署或开通使用时，凡涉及淘宝/天猫、京东、拼多多等第三方电商平台账号的自动化操作能力，均应以终端用户对目标账号作出明确授权为前提。

系统提供的自动化能力，应建立在终端用户合法持有、合法管理或已取得充分授权的店铺账号基础上，不得用于未经授权的第三方账号操作。

终端用户在启用店铺接入、自动化执行、图片替换、商品管理、数据抓取等相关功能前，应明确签署、在线确认或以其他可留痕方式接受相应的授权协议、用户协议或开通确认文件。相关确认内容至少应包括以下事项：

• 终端用户确认其对所接入的电商平台店铺账号享有合法使用权，或已取得充分、有效的操作授权。
• 终端用户明确授权 Neta 系统在其开通相关功能并发起或确认指令的前提下，对其绑定账号执行约定范围内的自动化操作。
• 终端用户确认，系统自动化操作仅限于其本人或其已合法授权管理的店铺账号，不得用于未经许可的第三方账号。
• 终端用户知悉并接受，第三方平台可能基于自身规则、风控机制、验证策略或平台政策，对自动化操作作出限制、拦截、验证或处罚。
• 终端用户承诺不利用 Neta 系统实施违反法律法规、平台规则、账号约定或他人合法权益的行为。

为降低后续销售、开通及使用过程中的合规风险，Neta 平台在产品设计和交付实施中，应预留终端用户授权确认的留痕机制。相关留痕信息建议至少包括：

• 确认人身份或账号标识
• 被授权接入或操作的店铺账号标识
• 授权确认时间
• 对应协议或确认文本版本号
• 用户主动勾选、签署或点击确认的记录

对于未完成授权确认的终端用户或店铺账号，原则上不应开通对应的自动化执行能力。

10. 里程碑计划

时间	节点	目标内容
2026 年 5 月底	M1 - 平台接入	完成三平台基础接入、登录能力和连接状态管理验证
2026 年 6 月底	M2 - 商品运营	完成商品基础运营核心链路，达到可联调状态
2026 年 7 月中旬	M3 - 图片与数据	完成商品图片生成替换能力和基础经营数据查看能力
2026 年 8 月上旬	M4 - 集成联调	完成全模块联调、缺陷修复、上线准备和验收准备
2026 年 8 月 15 日	上线验收	完成第一期上线并满足约定上线标准

11. 风险与依赖项

风险	影响	应对思路
平台页面改版导致操作路径失效	功能中断或结果异常	预留平台适配层和快速修复机制
平台风控或验证策略升级	自动化执行受阻	增强人工确认、人工配合和基础行为模拟能力
AI 图片生成质量不稳定	用户体验下降	通过人工预览和确认机制兜底
三平台能力差异大	上线标准难完全对齐	以等效结果验收，不追求完全同构
业务侧素材和账号准备不及时	联调和验收延期	提前锁定账号、素材和验收责任人
数据口径存在平台差异	指标理解偏差	提前约定基础数据口径和展示解释
上线前联调时间不足	影响最终上线质量	在 8 月上旬前预留集中修复和验收窗口

12. 第一期上线输出物

第一期围绕上线目标形成的主要输出物包括：

• 可运行的 Neta 一期版本
• 满足内部使用的安装或启动方式说明
• 第一期功能清单
• 第一期验收清单和验收场景
• 基础使用说明
• 上线问题跟踪与修复记录