# 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` 一期版本
- 满足内部使用的安装或启动方式说明
- 第一期功能清单
- 第一期验收清单和验收场景
- 基础使用说明
- 上线问题跟踪与修复记录
