# ProductFlow 新手教程与参考说明 [中文](USER_GUIDE.md) | [English](USER_GUIDE.en.md) 这份文档分两部分： 1. **新手教程**：少术语，照着点、照着填，生成一张能用的商品图。 2. **参考说明**：完成一次流程后，可以继续了解工作台卡片、提示词配置、模型设置和常见问题。 产品内顶部导航提供 **帮助** 页面，适合在使用中快速查看流程、模板、支持边界和常见问题。这份 Markdown 文档保留为仓库内文字参考，内容应与产品内帮助页保持一致。 工作台当前是 **ProductFlow 工作台**：中间是可缩放、可拖动的节点画布，桌面端右侧是一个精简侧栏，侧栏用小导航在 **详情 / 日志 / 图库 / 模板** 之间切换；移动端保留画布为主界面，用底部工具栏切换运行、单节点、模板、详情、日志和图库。普通操作不需要理解内部 DAG，只要记住：商品、参考图、文案、生图都是卡片；连接线表示“下游生成时参考上游”。 顶部导航还提供 **画廊**，用于收藏文/图生图里已经满意的生成结果，方便之后集中浏览和下载。 --- ## 新手教程：从一张商品图开始 目标：上传一张商品图，补一点资料，生成文案，再生成一张满意的图片。 ### 1. 新建商品 1. 点顶部导航里的 **商品/工作台**。 2. 点 **新建商品**。 3. 上传一张清楚的商品主图。 4. 填商品名，例如：`奶油白通勤托特包`。 5. 选择一个画布模板。新手可以选 **商品主图**，想完全自己搭建时选 **空白画布**。 6. 点 **创建并继续**。 你应该看到：页面进入这个商品的工作台，中间有几张可点击的卡片。 ### 2. 补商品资料 1. 点击画布里的 **商品** 卡片。 2. 右侧会切到 **详情**。补充类目、价格、商品说明或本次想强调的方向。 3. 示例说明：`适合通勤和周末出门，轻便，大容量，奶油白配色。` 4. 点 **保存**，或等右侧状态显示 **已保存**。 你应该看到：表单保存成功。后面生成文案和图片时，会使用这些已保存资料。 ### 3. 生成第一版文案 1. 点击 **文案** 卡片。 2. 在生成要求里写一句话，例如： ```text 突出通勤、轻便、大容量，语气高级但不夸张。 ``` 3. 点 **运行当前节点**。如果你想从商品资料一路跑到图片，也可以点 **运行工作流**。 你应该看到：文案卡片生成一份可编辑的结构化文案。它可能是一段自由正文，也可能拆成短标签、文案块、布局分区和视觉建议。 如果不满意：只改一个方向再试，例如“更年轻一点”“更简洁一点”“少一点夸张词”。 文案详情里只会直接显示已有内容。空的可选字段会收起成“添加标签”“添加视觉建议”等按钮；长文本输入框会随内容自动增高。后续生图会读取这份结构化文案，不要求每次都填出标题、卖点、海报标题和按钮文案。 ### 4. 添加或连接参考图 如果你有想参考的风格图，可以这样做： 1. 选择或新增一个 **参考图** 卡片。 2. 上传一张参考图片，例如你喜欢的光线、背景、构图或风格；参考图上传同样支持点击选择和拖拽上传。 3. 从参考图卡片边上的连接点拖到 **文案** 或 **生图** 卡片。 你只需要记住：**连过去 = 生成时参考它**。 你应该看到：画布上出现一条线。之后运行被连接的卡片时，会参考这张图的标签和图片信息。连错了可以选中连接线并删除，再重新拖一条。 ### 5. 生成第一张图片 1. 点击 **生图** 卡片。 2. 确认 **生图** 卡片已经连到至少一个下游 **参考图** 卡片。生图卡片只负责触发生成，不自己展示/下载图片；生成结果会填进连过去的参考图卡片。 3. 写图片要求，例如： ```text 白色托特包放在通勤桌面，旁边有笔记本电脑和咖啡，干净自然光，适合电商主图。 ``` 4. 点 **运行当前节点** 或 **运行工作流**。 你应该看到：下游参考图卡片被填入新图片，并在参考图卡片上提供预览和下载。右侧 **图库** 里也会聚合这张图，点击缩略图可在应用内放大预览，点 **下载** 才会下载原图。 如果没有连接下游参考图卡片，系统会提示你先连接至少一个图片/参考图节点，不会把图片悄悄放在生图卡片上。 ### 6. 继续调整，直到满意 每轮只改一两个点，更容易判断哪句话有效。 常见调整方式： - 主体不清楚：加 `商品占画面中心，主体完整，纹理清晰`。 - 背景太乱：加 `干净背景，减少道具，只保留 1-2 个陪衬物`。 - 风格不对：加 `自然光`、`杂志感构图`、`极简电商`、`暖色生活方式`。 - 卖点没体现：把最重要卖点写进第一句话，例如 `大容量`、`轻便`、`可通勤`。 可复制的改写示例： ```text 背景更干净，只保留电脑和咖啡；包身纹理要清晰，阴影柔和。 ``` 满意后可以下载图片；如果还想连续微调，点顶部导航里的 **文/图生图**。如果这张图来自文/图生图，也可以保存到 **画廊**，后面集中浏览。 ### 画布基础操作 - **桌面缩放**：鼠标移到工作台画布区域后滚动滚轮，会以鼠标位置为中心缩放画布；右下角也有缩放按钮和百分比。 - **桌面平移**：按住画布空白处用左键拖动，可以移动视野；拖卡片、点按钮、上传、拖连接线时不会触发画布平移。 - **桌面移动卡片**：按住卡片主体或标题区域拖动，松手后位置会保存。刷新页面后仍会停在你放下的位置。 - **桌面连接卡片**：从卡片连接点拖到目标卡片，松手后生成连接线。连接线是工作流的一部分，不只是临时视觉效果。 - **桌面多选卡片**：在画布空白区域按住 Shift 拖出选择框，或按住 Ctrl / Cmd / Shift 点击多个节点。多选后可以一起拖动、删除，也可以保存为用户模板。 - **移动端浏览模式**：进入商品工作台时默认处于浏览模式。单指拖动画布空白处会平移视野，点按节点会选中节点，双指捏合会缩放画布。 - **移动端编辑模式**：底部模式切到 **编辑** 后，触控或触控笔可以拖动节点，也可以从输出连接点拖到目标节点创建连接。 - **移动端选择模式**：底部模式切到 **选择** 后，点按节点会加入或移出多选组；点按空白画布会退出临时选择模式。 - **移动端工具栏和面板**：底部工具栏提供运行工作流、单节点、模板、详情、日志和图库入口；这些侧栏内容在移动端从底部面板打开。 - **调整侧栏**：桌面端右侧侧栏负责详情、日志、图库和模板；它会尽量保持精简，不再用底部大面板占用画布空间。 ### 模板 右侧 **模板** 面板用于在已有商品工作台中继续添加同一套内置场景模板。内置场景模板和新建商品时可选的模板来自同一套后端 catalog： - **内置场景模板**：覆盖平台首图、详情说服、场景图册、内容种草和活动投放。添加到已有工作台时，模板里的商品资料节点会自动复用当前画布已有的商品节点。 - **用户模板**：多选两个或更多非商品资料节点后，可以把当前结构保存成自己的可复用模板。用户模板用于商品工作台内追加流程，当前不会出现在新建商品页。 保存用户模板时，只会保存可复用的节点配置和选中节点之间的内部连线，不会把已经生成的图片、文案产物或商品资料保存进模板。用户模板可以重命名和删除；删除模板不会影响已经插入到商品工作台里的节点。 ### 7. 用文/图生图做细节微调 1. 点顶部导航里的 **文/图生图**。 2. 选择一个商品，或先自由生成。 3. 第一张可以直接写描述生成；后续修改需要先点击历史记录里一张已完成图片作为基图。 4. 用对话方式提出修改，例如： ```text 保持包的角度不变，背景换成更明亮的办公室，减少桌面杂物。 ``` 5. 满意后，把图片回写到商品，后续工作台可以继续参考。 手机小屏上，文/图生图采用主视图、抽屉和底部面板组合： - **顶部栏**：左侧按钮打开会话抽屉，中间显示当前会话标题；点铅笔可重命名，右侧按钮打开历史抽屉。 - **左侧会话抽屉**：新建、选择和删除会话。会话卡片显示最近缩略图、轮数和更新时间；选择会话后主视图会切到该会话。 - **右侧历史抽屉**：按分支展示候选和生成中占位。点已完成图片会把它设为当前结果，并作为下一轮基图；点占位会查看该候选的排队、生成、失败或取消状态。 - **主视图**：生成状态、当前结果、失败原因和供应商提示保留可见。多候选任务提交后，历史里会先出现对应数量的占位；运行中页面只刷新轻量状态，任务结束后刷新完整会话详情。 - **底部快捷条**：始终提供“生成”入口。选中已完成结果后，快捷条还会显示下载和收藏到画廊。 - **底部生成面板**：包含生成设置和高级标签页。生成设置管理写回目标商品、会话参考图、画面描述、尺寸和候选数量；高级区域管理已启用的图片工具参数。底部提交按钮按当前候选数量发起生成。 ### 8. 收藏到画廊 文/图生图结果里可以把满意的生成图保存到 **画廊**。画廊会保留图片来源、提示词、尺寸和模型信息，并提供下载入口。 适合保存到画廊的内容： - 暂时不想挂回某个商品，但以后可能复用的背景/构图。 - 已经满意、需要集中给别人挑选的候选图。 - 调参过程中效果不错但不是当前商品最终稿的图片。 --- ## 参考说明：工作台里有哪些卡片 这些说明是给已经跑通过一次流程、想更准确控制结果的用户看的。 ### 商品 保存商品名、类目、价格和说明。下游生成会优先读取最新已保存的商品资料。 ### 参考图 一个参考图卡片只放当前一张图。你可以手动上传，也可以让生图卡片把新图填进来。新图会替换这个卡片里的当前图；旧素材仍保留在商品历史里。 选中参考图卡片时，右侧 **图库** 里的素材会出现填充动作。选择已有素材填充时，系统会复用已有素材记录，不会为了同一张图再创建重复上传。 ### 文案 生成可编辑的结构化文案。文案可以是自由正文、文案块或布局分区，并可附带视觉建议。生成后可以在卡片里继续编辑，编辑后的结构化文案会被后续生图使用。 历史记录里可能仍有标题、卖点、海报主标题和按钮文案；当前工作台会把结构化文案作为后续生图上下文，不需要为了固定字段编造不需要的 CTA 或卖点。 ### 生图 根据商品资料、文案、参考图和你写的图片要求触发图片生成。它不是图片槽位：生成出的图片会填入连接的下游参考图卡片；如果没有连接下游参考图卡片，运行会失败并提示先连接至少一个图片/参考图节点。 生图卡片现在会区分“只看商品资料直接生图”和“带文案/参考图上下文生图”：当你连接了上游文案或参考图，生成会读取这些上下文；没有连接文案时，也可以根据商品资料和节点里的图片要求直接尝试生成。 --- ## 参考说明：连接和运行 - 把 A 连到 B：B 生成时会参考 A。 - 只想试一个卡片：选中卡片后运行当前节点。 - 想从商品资料一路生成到图片：运行整个工作流。 - 运行前建议确认右侧表单已经保存；如果选中卡片还有未保存草稿，当前运行按钮会先尝试保存，再开始运行。 - 工作流运行中可以继续整理画布位置，但不要重复点击运行或做结构变更。 - 图片生成结果不在生图卡片上下载；请去下游参考图卡片或右侧 **图库**。 - 运行中的工作流可以在包含该节点的详情或日志区域取消；失败且可重试的运行会提供重试入口。 - 失败提示会尽量区分供应商配额/限流、内容策略、网络中断、请求超时、服务异常和参数不支持。 --- ## 参考说明：提示词配置 进入顶部导航 **配置**，找到 **提示词** 分组，可以调整长期默认提示词配置项： - `prompt_brief_system`：商品理解默认提示词。 - `prompt_copy_system`：文案生成默认提示词。 - `prompt_poster_image_template`：工作台海报/图片生成模板。 - `prompt_poster_image_edit_template`：工作台带上游文案或参考图上下文的改图模板。 - `prompt_poster_image_reference_policy`：工作台生图模板中的视觉参考规则，用于 `reference_policy` 占位符。 - `prompt_image_chat_template`：文/图生图模板。 建议用法： - 单次想要什么效果：写在文案卡片或生图卡片里。 - 长期希望系统都保持某种口吻或格式：改配置页里的提示词。 - 不确定怎么改：复制默认值，少量调整后保存测试。 恢复默认会删除数据库里的自定义值，回到系统默认提示词。 常用占位符： - 工作台海报/图片生成模板：`product_name`、`category`、`price`、`source_note`、`instruction`、`context_block`、`reference_policy`、`size`、`kind`、`kind_label`、`kind_requirements`。 - 工作台改图模板：`product_name`、`category`、`price`、`source_note`、`instruction`、`context_block`、`reference_policy`、`size`、`kind`、`kind_label`、`kind_requirements`。 - 文/图生图模板：`prompt`、`size`、`history_block`。 如果占位符写错，系统不会因为未知占位符直接崩掉，但那一段可能不会按预期替换。建议小幅修改后测试。 --- ## 参考说明：模型与运行时设置 顶部导航 **配置** 里还可以管理： - 文案供应商和文案模型。 - 图片供应商和图片模型。 - 供应商档案，包括供应商类型、连接信息、API Key 和接口能力；Google Gemini 档案使用官方 SDK endpoint，不配置 Base URL。 - 默认图片尺寸。文/图生图和工作台生图都可以直接选择 1K / 2K / 4K 常用画框，也可以输入自定义宽高。 - 文/图生图进度闲置恢复阈值，默认 90 分钟；系统会按最近生成进度 heartbeat 判断运行中任务是否闲置。 - 上传文件大小限制。 供应商档案里的密钥不会回显。编辑档案时留空 API Key 会保留旧值；输入新值才会写入数据库。 ## 参考说明：运行中状态 文案、海报、工作流和文/图生图都是后台任务。页面运行中会刷新状态，但不会反复下载完整历史数据： - 文/图生图运行中会更新队列位置、已完成候选数、最近进度时间、供应商状态、失败/成功状态和失败原因。 - 商品工作流运行中会更新节点状态、运行状态和失败原因。 - 任务结束后，页面再刷新完整详情，显示新图片、新文案或新的商品历史。 - 可重试的失败任务会保留重试入口。重试会复用本次任务的提示词、尺寸、参考图和高级参数。 - 运行中的文/图生图任务可以取消；取消后的任务不会继续写入新候选。 如果页面长时间没有变化，可以先看运行状态和错误提示，再刷新页面确认后台结果。 --- ## 常见问题 ### 直接运行下游卡片，没有用上新资料？ 先确认右侧表单已经保存。运行使用的是已保存内容，不是还没保存的输入框草稿。 ### 生图卡片必须连接参考图卡片吗？ 必须至少连接一个下游参考图卡片。生图卡片只负责触发和配置生成，图片预览/下载在被填充的参考图卡片上完成；一个生图卡片连接多个参考图卡片时，会并发生成并分别填充这些卡片。 ### 图片效果不好，应该怎么改？ 不要一次改很多句。每轮只改背景、构图、光线或主体细节中的一项。这样更容易知道哪句话让结果变好。 ### 模板保存失败？ 确认已经多选至少两个节点，并且不要把 **商品** 节点一起保存。用户模板只保存可复用流程片段，不能包含商品资料节点，也不会保存已经生成的图片或文案结果。 ### 配置保存失败？ 看页面错误提示里的字段名。常见原因是图片尺寸格式不对，例如应该写 `1024x1024`；自定义宽高不需要提前加入任何允许列表，但宽高必须为正且单边不能超过系统的 `3840` 安全上限。生图尺寸会按供应商要求自动校准到接近的 16 像素倍数。 ### 会不会在日志里记录完整提示词？ 不应该。后端只保存必要的节点摘要和产物引用，不应记录完整提示词、密钥、上传字节或 provider payload。