产品操作手册 | CrossBorder AI

适用站点：https://skuplusai.com/（https://www.skuplusai.com/ 会自动跳转到主域名）
适用版本：V2 线上公开演示版
更新日期：2026-09-01

1. 产品简介

CrossBorder AI Content Studio 是一个跨境商品内容工作台，可以完成商品图片分析、详情页规划、AI 图片生成、批量生产、小红书图文制作和结果导出。

主要工作流：

flowchart LR
    A[上传商品图] --> B[完善商品信息]
    B --> C[AI 商品分析]
    C --> D[设置输出规格]
    D --> E[AI 页面规划]
    E --> F[生成头图与详情图]
    F --> G[预览、编辑与版本切换]
    G --> H[ZIP / JSON 导出]

2. 使用前须知

2.1 公开站点的数据边界

当前线上版本不要求登录，所有访客进入的是同一个公开工作区。因此：

商品项目、上传素材、生成图片和项目历史保存在服务器中，其他访客可能看到或修改。
不要上传身份证、合同、客户隐私、未发布商业机密等敏感资料。
历史记录中的“删除项目”会同时删除关联素材、生成结果和版本记录，而且不可恢复。
正式商业使用时，建议部署独立实例并增加账号、权限和数据隔离。

2.2 AI 服务模式

线上站点已启用共享演示 AI：

访客通常可以不填 API Key，直接体验商品分析、自动规划和 AI 生图。
共享演示额度有每日和每小时频率限制，繁忙或额度用完时需要稍后重试。
你也可以在“AI 配置”中填写自己的 Provider；个人凭证优先于共享演示额度。
个人 API Key 只保存在当前浏览器的 localStorage，不会写入项目数据库。
换电脑、换浏览器、清除浏览器数据或更换域名后，需要重新填写个人 API Key。

2.3 推荐准备的素材

素材	是否必需	建议
主商品图	必需	商品完整、清晰，背景干净，尽量无水印和遮挡
多角度图	推荐	正面、侧面、背面、俯视等不同角度
细节图	推荐	材质、接口、纹理、鞋底、五金或工艺细节
参考图	选填	用来约束构图、色彩和视觉风格
竞品证据	对比场景推荐	真实竞品图片、规格和可验证参数，避免无依据对比

支持常见的 JPG、PNG、WEBP 等浏览器可识别图片格式。

3. 页面导航

菜单	用途
快速开始	上传一张主商品图，自动创建项目并启动商品分析
批量创建	多张商品图分别创建项目，可自动完成规划和模块图生成
历史记录	查看已有项目，并返回分析、规划或编辑页面
小红书图文	完成选题规划、提示词调整、图片生成和单页修改
高级创建	创建项目时填写平台、风格、备注，并分类上传多种素材
API 监控	查看调用次数、模型、耗时、失败、限流和额度状态
AI 配置	查看共享演示状态，或配置个人 Provider、API Key 和模型

页面左下角按钮可以切换浅色、深色或跟随系统主题。

4. 标准商品详情页流程

4.1 第一步：创建商品项目

方式 A：快速开始

适合第一次体验或只有一张商品图时使用。

打开“快速开始”。
点击上传区域，选择一张清晰的主商品图。
确认预览正确后，点击“开始分析”。
系统会自动创建一个“未命名商品项目”、上传主图并运行首轮 AI 商品分析。
完成后自动进入“项目信息与商品分析”页面。

如果分析请求超时，主图和项目仍会保存；系统会进入分析页自动重试，或者显示可继续处理的提示。

方式 B：高级创建

适合需要更准确控制商品资料和参考素材时使用。

打开“高级创建”。
填写项目名称。
选择目标平台：通用电商、淘宝/天猫、拼多多、小红书或抖音电商。
选择视觉风格：通用简洁、高级质感、柔和生活方式、转化导向或科技感。
在备注中填写目标人群、价格带、投放目标、品牌限制和平台要求。
至少上传一张“主商品图”。
按需上传“多角度图”“细节图”和“参考图”。
点击“创建项目并上传素材”。

创建完成后会进入分析页。高级创建不会替你省略商品分析确认步骤。

4.2 第二步：设置输出配置

分析页顶部的“输出配置”决定后续规划、生成和导出结果。

配置项	可选范围	说明
内容语言	简体中文、英语、日语、韩语、西班牙语、法语、德语、葡萄牙语、阿拉伯语、俄语	影响规划文案和图内文字
头图数量	3–5 张	头图固定按 1:1 规划和生成
详情页数量	4–10 张	决定详情页规划模块数量
详情图比例	9:16 或 3:4	影响详情图生成和导出

修改后必须点击“保存输出配置”。如果已经完成过页面规划，配置变化后需要重新运行 AI 自动规划，让模块数量与新配置保持一致。

4.3 第三步：完善项目信息

在“第 2 步：完善项目信息”中检查：

项目名称
平台
风格
备注

点击“保存项目信息”。这些信息会被后续分析、规划和图像生成共同使用。

4.4 第四步：管理素材并运行商品分析

在“素材与自动分析”区域可以：

使用上下箭头调整素材顺序。
将某张图片设为主图。
删除不需要的素材。
点击“重新运行 AI 商品分析”。

主图是商品外观和结构的主要锚点。换主图后建议重新分析并重新规划。

4.5 第五步：确认分析结果

AI 分析后会生成以下结构化字段：

商品名称、品类、子类目、材质、颜色
风格标签、目标人群、使用场景
核心卖点、差异化亮点
用户顾虑、推荐重点
其他信息补充

逐项核对并修改不准确内容，然后点击“保存分析结果”。

差异化描述应该写在哪里

优先填写在分析页的“差异化亮点”中，每行写一个可验证的差异点，例如：

鞋面使用大面积网眼结构，重点表现透气性
鞋底比普通休闲鞋更厚，重点表现缓震和增高效果
外底有明显分区纹路，重点表现抓地与防滑结构

如果要生成“对比说明”模块，还可以在规划页或编辑台进一步修改该模块的：

模块标题
模块目标
模块文案
双语视觉 Prompt

没有真实竞品资料时，不要编造竞品参数、评分或胜负结论。建议改成商品自身的结构证据拆解；如果有真实竞品，应上传参考图并在分析结果或模块文案中写明可核验差异。

其他信息补充为什么重要

建议点击“使用预置模板”，补充：

长、宽、高、直径或适配规格
重量、容量、功率
包装清单
安装和使用限制
安全、合规和耐温/防水信息
不可出现的错误物理现象

这些资料会降低尺寸错误、结构变化、悬浮、穿模和错误使用场景的概率。

确认后点击“进入页面规划”。

4.6 第六步：AI 页面规划

规划页分为三个步骤。

1. 检查输出配置

确认内容语言、头图数量、详情页数量和详情图比例。若结构与配置不一致，返回分析页修改并保存，然后重新规划。

“允许 SVG 兜底预览”默认关闭：

关闭：只接受真实图片模型输出；Provider 不支持时直接报错。
开启：真实图片端点不可用时，可以生成 SVG 结构预览。
SVG 兜底仅用于查看布局和流程，不应当作最终商品图交付。

修改该选项后点击“保存生成设置”。

2. 运行 AI 自动规划

点击“AI 自动规划”。AI 会按照商品分析和输出配置生成独立的头图和详情页规划卡片。

头图规划固定在详情页规划之前；价格区、用户评论、底部购买栏和 Powered by 属于页面壳层，不会作为单独图片生成或导出。

自动规划完成后，应检查每张卡片的：

模块类型
标题
模块目标
模块文案
双语视觉 Prompt

可以新增、删除、排序或更改模块类型。手工修改后点击当前卡片的“保存”。

可用模块包括：头图主视觉、卖点模块、场景展示、细节特写、规格参数、材质工艺、对比说明、送礼场景、品牌信任、总结收口和自定义模块。

3. 生成图片

有两种生成方式：

单张生成：在某个规划卡片中点击“生成当前头图”或“生成当前详情页”。
全部生成：点击“一键生成全部模块图”。系统按照规划顺序逐张调用图片模型。

批量生成区域会显示成功数、失败数、SVG 兜底数、总数和当前处理模块。生成图片会消耗 Provider 额度，模块越多，耗时和成本越高。

全部生成完成后会进入预览与编辑台。也可以点击“直接进入预览与编辑”，先检查结构再逐张生成。

4.7 第七步：预览与编辑

编辑台分为三栏：

左侧“模块结构树”：选择头图或详情页模块，查看生成状态。
中间“手机商品页预览”：切换头图并查看详情页长图衔接效果。
右侧“模块编辑面板”：修改内容、生成图片、重绘、增强、翻译和切换版本。

选择一个模块后，可以编辑：

类型
标题
模块目标
模块文案
双语视觉 Prompt
额外参考图

主商品图会自动作为商品锚点；“参考图”复选框选择的是额外参考图片。

生成、重新生成、重绘和增强的区别

操作	适用情况	结果
生成当前模块图	当前模块尚未出图	按规划和参考素材首次生成
重新生成当前图	当前结果方向不满意	重新请求图片模型，产生新版本
基于当前图重绘	想改变构图或画面方案	以当前图片为输入重新绘制
基于当前图增强	构图可用，只想改善质感	尽量保留构图并提升画面表现

先修改字段并点击“保存”，再生成或重绘，避免最新文字要求没有进入请求。

“AI 真图”是什么意思

“AI 真图”是界面中的生成状态标签，表示图片来自真实图片生成/编辑端点；它不是导出图片上的水印。“SVG 兜底”表示仅生成了结构预览。

版本历史

每次重新生成、重绘、增强或翻译会产生新版本。可以在“版本历史”中查看版本号，并点击“设为当前”恢复某个历史版本。

4.8 第八步：详情页语言转换

当项目已有详情页图片时：

在编辑台右侧找到“详情页语言转换”。
选择目标语言。
点击“一键转换整页”。
系统使用图片编辑能力逐张替换图内文字，并尽量保留商品、构图和视觉风格。

翻译会创建新版本。完成后逐张检查文字拼写、品牌名、数字、单位和排版，必要时切回旧版本或单张重绘。

4.9 第九步：导出

在编辑台右上角点击“进入导出中心”，或者直接点击“一键导出详情页图像”。

导出中心提供：

“一键导出详情页全部图像 ZIP”
“导出项目 JSON”

ZIP 中包含：

00-头图/
01-详情页/
export-manifest.json

导出数量以当前输出配置为准。导出前检查：

每个目标模块是否已经生成图片
当前生效版本是否正确
图内文字是否正确
图片比例和数量是否符合投放平台要求
是否仍存在 SVG 兜底图

5. 批量创建

批量创建适合多 SKU 快速生产。

打开“批量创建”。
点击上传区域，一次选择多张商品主图。
系统会把每张图片作为一个独立商品项目。
根据需要勾选“规划后自动生成全部模块图”。
点击“批量创建详情页”。
在右侧查看每个文件的待开始、运行中、完成或失败状态。
完成后进入“历史记录”打开各项目检查结果。

注意事项：

自动生成会逐项目、逐模块调用图片模型，费用和耗时明显增加。
建议先用 1–2 张图验证 Provider、规划和视觉效果，再扩大批量。
点击“请求取消”后，正在执行的当前单步可能仍会先完成。
不同 SKU 的主图应当清晰独立，避免拼图或一张图包含多个不同商品。

6. 小红书图文流程

小红书图文采用四步工作流。该工作流的草稿和图片主要保存在当前浏览器中，换浏览器或清理浏览器数据后可能无法继续原草稿。

6.1 规划

输入明确选题，例如“通勤鞋一周搭配”或“小户型桌面收纳怎么拍出高级感”。
设置图片数量，支持 3–8 张。
选择比例：1:1、3:4 或 9:16。
可上传参考图。
点击“生成图文规划”。

系统会生成目标人群、核心洞察、标题备选、分页脚本和发布文案。

6.2 调整

逐页检查并修改：

页面标题
正文要点
图像生成提示词
负面约束

点击保存后进入生成步骤。

6.3 生成

点击“生成整组图片”。生成期间会显示当前页码；结束后可以查看每页预览和使用模型。若只有部分页面失败，可以调整提示词、减少数量或稍后重试。

6.4 修改

选择不满意的页面，在修改要求中写清楚：

修改对象：标题、背景、构图、色彩或商品位置
期望位置和效果
必须保留的商品结构和品牌元素
明确禁止修改的内容

例如：

第 2 页标题改到上方居中，背景更干净；保留鞋子结构和蓝白配色，不要改变鞋底厚度。

点击“修改当前页”，检查新结果。

7. 历史记录与项目管理

“历史记录”展示所有服务器项目。每个项目可以：

进入“分析”修改商品资料和分析结果
进入“规划”修改结构或重新生成
进入“预览与编辑”继续处理图片和版本
删除项目

删除前会出现确认窗口。确认后会同时删除项目素材、生成结果和版本记录，无法恢复。

8. AI Provider 配置

8.1 直接使用共享演示 AI

如果页面显示“共享演示 AI 已启用”，通常无需填写任何 Key。共享额度受限，适合体验和小批量验证，不适合稳定的大规模生产。

8.2 使用自己的 Provider

打开右上角“AI 配置”。
填写服务名称。
如果页面显示 baseURL 输入框，填写 OpenAI-compatible API 根地址，通常以 /v1 结尾。
填写 API Key。
点击“一键配置”或“一键测试、探测并保存”。
等待系统完成连接测试、模型发现、能力识别和默认模型分配。
检查文本生成、图像识别、图像生成和图像编辑模型。
必要时点击“按 GPT 优先自动填充”，或手动选择各类型默认模型。

如果平台显示“已锁定专属 API 服务通道”，前端填写的 baseURL 会被服务器忽略，只需按页面提示使用允许的服务和 Key。

8.3 模型能力要求

功能	所需能力
商品分析	文本生成 + 图像识别/视觉理解
AI 自动规划	文本生成，最好支持稳定结构化输出
头图/详情图生成	真实图片生成端点
重绘、增强、语言转换	图片编辑端点

能生成文字不代表能生成图片；能生成图片也不一定支持图片编辑。应以“模型能力分组”和实际调用结果为准。

9. API 监控

右上角“API 监控”可用于排查失败和费用问题。

可按以下条件筛选：

最近 1 小时、6 小时、24 小时、3 天或 7 天
项目
模型列表、文本生成、结构化输出、图像生成、图像编辑等调用类型
成功或失败
额度已满、限流、鉴权异常、其他错误或正常

监控页会显示总调用、图像调用、失败次数、额度/限流告警、已记录费用、最终命中端点和内部重试明细。

代理商没有返回费用字段时，“已记录费用”不代表真实账单总额，应以 Provider 控制台账单为准。

10. 常见错误与处理方法

提示或现象	含义	处理方法
`No active provider config found`	没有激活的 Provider 配置	打开“AI 配置”，完成一键配置或切换已有服务；若共享演示开启但仍出现，刷新后重试
当前浏览器没有配置 API Key	浏览器无个人 Key，服务器也没有可用共享 Key	在“AI 配置”填写 Key；不同电脑需分别配置
API Key is not configured in this browser	当前域名的浏览器存储中没有 Key	在当前网站重新填写，不要依赖 localhost 或另一个浏览器中的配置
Access denied / Arrearage	Provider 账户欠费、冻结或权限异常	前往 Provider 控制台充值、恢复账户或更换 Key
请求超时或网络异常	Provider 响应过慢、代理中断或网络波动	稍后重试；减少批量数量；在 API 监控查看最终端点和失败摘要
401 / 403	Key 无效、权限不足或额度策略拒绝	检查 API Key、baseURL、模型权限和账户状态
429 / 限流	调用频率超过 Provider 或共享演示限制	降低频率、等待后重试或使用自己的 Key
当前 Provider 没有可用真实图片端点	配置的模型只能生成文本，或代理商未开放图片接口	换用支持图片生成的 Provider/模型；仅调试时可开启 SVG 兜底
没有可用真实图片编辑端点	Provider 不支持重绘、增强或翻译	选择支持图片编辑的模型；首次生图能力不能代替编辑能力
AI 自动规划没有反应	请求仍在处理、超时或结构化结果异常	等待进度提示；刷新后重试；检查 API 监控；必要时换更稳定的规划模型
每张图看起来一样	Prompt、参考图和模块目标过于相似	为每个模块写不同目标、场景、机位和视觉证据；减少重复参考图
差异化对比没有体现	只有“差异化对比”标题，没有具体证据	在分析页“差异化亮点”和对比模块文案中写可验证差异，必要时上传真实竞品资料
图片只有原图加字	图片模型遵循了保守编辑或缺少设计方向	强化场景、构图、镜头、层级、材质和版式要求；使用真实图片生成模型而非仅文本模型
生成图片未显示	当前版本未设为生效、生成失败或浏览器缓存未更新	查看版本历史并设为当前；刷新页面；检查 API 监控中的失败记录
`AI 真图` 出现在右上角	这是编辑台状态标签	只用于界面识别生成模式，不是导出图片水印

11. 提高生成质量的写法

推荐把每个模块写成“目标 + 证据 + 构图 + 文案 + 禁止项”。

示例：

模块目标：证明鞋底缓震与稳定性。
视觉证据：鞋底侧面厚度、分层中底、落地受力区域。
构图：低机位三分之二侧视角，商品占画面 65%，增加局部放大框。
图内文案：厚底缓震 / 稳定支撑。
禁止项：不要改变鞋底层数，不要生成悬浮鞋，不要编造实验数据。

不同模块应使用不同表达角度：

头图：商品主视觉和核心购买理由
卖点：三项核心优势
场景：真实使用环境
细节：材质或结构近景
规格：尺寸、容量、功率或适配信息
对比：真实证据或商品结构拆解
总结：核心价值和行动号召

12. 完整流程验收清单

交付或演示前逐项确认：

主图清晰，商品结构没有被 AI 改坏
项目名称、平台、风格和备注准确
分析结果中的材质、颜色、规格和卖点准确
“差异化亮点”包含可验证信息
输出语言、数量和比例正确
规划结构与输出配置一致
每个模块目标和 Prompt 具有明显差异
所有目标模块均已生成
没有把 SVG 兜底图作为最终结果
图内文字、品牌名、数字和单位正确
当前生效版本是最终选定版本
ZIP 中头图、详情页和清单文件齐全
使用自己的 Provider 时已核对实际账单和额度

13. 推荐的首次体验顺序

为了快速验证整个系统，建议第一次只处理一个商品：

使用“快速开始”上传一张清晰白底图。
在分析页补充真实尺寸和三个差异化亮点。
保持默认的 4 张头图、6 张详情页和 9:16 比例。
运行 AI 自动规划并检查每个模块目标。
先单独生成一张头图和一张详情图，验证模型质量。
确认风格正确后再一键生成全部模块。
在编辑台调整不满意的页面并检查版本历史。
最后进入导出中心下载 ZIP。

完成这条流程后，再使用批量创建扩大到多个 SKU。