diff --git a/docs/user-guide-assets/01-home.png b/docs/user-guide-assets/01-home.png new file mode 100644 index 0000000..0dd29bc Binary files /dev/null and b/docs/user-guide-assets/01-home.png differ diff --git a/docs/user-guide-assets/02-canvas-overview.png b/docs/user-guide-assets/02-canvas-overview.png new file mode 100644 index 0000000..c10dd2b Binary files /dev/null and b/docs/user-guide-assets/02-canvas-overview.png differ diff --git a/docs/user-guide-assets/03-node-menu.png b/docs/user-guide-assets/03-node-menu.png new file mode 100644 index 0000000..0a9e40d Binary files /dev/null and b/docs/user-guide-assets/03-node-menu.png differ diff --git a/docs/user-guide-assets/04-workflows-public.png b/docs/user-guide-assets/04-workflows-public.png new file mode 100644 index 0000000..5d36ce9 Binary files /dev/null and b/docs/user-guide-assets/04-workflows-public.png differ diff --git a/docs/user-guide-assets/05-workflows-my.png b/docs/user-guide-assets/05-workflows-my.png new file mode 100644 index 0000000..be7582f Binary files /dev/null and b/docs/user-guide-assets/05-workflows-my.png differ diff --git a/docs/user-guide-assets/06-api-settings.png b/docs/user-guide-assets/06-api-settings.png new file mode 100644 index 0000000..ca5c092 Binary files /dev/null and b/docs/user-guide-assets/06-api-settings.png differ diff --git a/docs/user-guide-assets/07-download-modal.png b/docs/user-guide-assets/07-download-modal.png new file mode 100644 index 0000000..88ac86b Binary files /dev/null and b/docs/user-guide-assets/07-download-modal.png differ diff --git a/docs/user-guide.html b/docs/user-guide.html new file mode 100644 index 0000000..2db5c82 --- /dev/null +++ b/docs/user-guide.html @@ -0,0 +1,552 @@ + + + + + + SKG 营销内容生产平台操作指南 + + + +
+
+
SKG 内部使用
+

营销内容生产平台操作指南

+

适用于使用 https://marketing.skg.com 进行文生图、图生图、文生视频、图生视频、工作流模板和素材沉淀的员工。本文截图为 2026-05-26 明亮模式界面，生产登录方式以飞书免登录为准。

+
+
+ 入口 + 线上访问 https://marketing.skg.com，从飞书授权进入。员工不需要配置个人 API Key。 +
+
+ 核心用途 + 在个人画布里组织提示词、参考图、图片生成、视频生成和可复用工作流。 +
+
+ 数据归属 + 项目、任务、素材和“我的工作流”按当前登录账号隔离，同一飞书账号可在多台设备看到自己的内容。 +
+
+
+ +
+

目录

+
    +
  1. 登录与账号
    2. +
  2. 首页与项目
    3. +
  3. 画布基础操作
    4. +
  4. 节点功能说明
    5. +
  5. 公共工作流与我的工作流
    6. +
  6. 常用生成流程
    7. +
  7. 素材下载与沉淀
    8. +
  8. 提示词写法
    9. +
  9. 常见问题与报错处理
    10. +
+
+ +
+

1. 登录与账号

+
    +
  1. 打开 https://marketing.skg.com。
    2. +
  2. 点击登录页上的“飞书免登录”，或在飞书内打开时按页面提示授权。
    3. +
  3. 授权成功后会进入个人画布首页。后续同一飞书账号在电脑、手机或其他浏览器登录，会看到自己的项目和工作流。
    4. +
+
+ 账号数据隔离：每个人只能看到自己账号下创建的项目、生成任务、素材和“我的工作流”。这不是浏览器缓存隔离，而是服务端按登录用户归属过滤。 +
+
+ 手机访问提示：如果手机在公司 Wi-Fi 下显示“无法加载网页”或类似错误，先切换到个人网络或用手机浏览器打开同一地址；如果电脑正常而手机飞书内异常，多半是当前网络或飞书内置浏览器限制。 +
+
+ +
+

2. 首页与项目

+

登录后默认进入首页。这里可以快速创建项目，也可以打开已有项目继续编辑。

+
+ 首页与我的项目列表 +
首页：顶部是创意输入框和推荐词，下面是“我的项目”。
+
+

首页主要区域

+ + + + + + +
创意输入框输入一句需求后点击发送，会创建一个新项目并进入画布。适合从一个想法快速开始。
推荐词点击推荐词可快速填入输入框；右侧刷新按钮会换一组推荐。
新建项目点击“新建项目”会创建空白项目，适合手动搭节点。
我的项目点击项目卡片进入画布。项目会按更新时间排序。
项目菜单项目卡片右上角菜单支持重命名、复制和删除。
+
+ 建议每个主题单独建一个项目，例如“新品主图测试”“母亲节短视频”“达人口播改图”。这样后续查找和复用更清楚。 +
+
+ +
+

3. 画布基础操作

+

画布是主要工作区。你可以把提示词、参考图、文生图、视频生成等能力连接起来，让图片和视频从上一步结果继续往下生成。

+
+ 画布总览 +
画布总览：左侧工具栏添加节点，中间是节点和连线，底部是对话式输入区。
+
+

顶部栏

+ + + + + + +
返回左上角箭头返回首页。
项目名称点击项目名旁边的小箭头，可重命名、复制或删除当前项目。
明暗模式右上角月亮/太阳图标切换明亮模式或暗色模式。
素材下载右上角下载图标打开当前画布素材列表。
API 设置右上角齿轮查看内部接口、模型配置和端点。普通员工一般不需要改。
+ +

左侧工具栏

+
+ 添加节点菜单 +
添加节点菜单：可以手动添加文本、LLM、文生图、视频生成、图片和视频节点。
+
+ + + + + + + + +
加号打开节点菜单，手动添加任意节点。
九宫格打开工作流模板面板。
文本快速添加文本节点。
图片快速添加图片节点，用于上传参考图或承接生成图。
文生图快速添加文生图配置节点。
视频快速添加视频生成配置节点。
撤销/重做回退或恢复最近的画布编辑。
+ +

底部输入区

+ +
+ +
+

4. 节点功能说明

+

节点之间通过左右两侧的小连接点相连。通常从左侧节点拖到右侧节点，表示“把左边的内容作为右边生成的输入”。

+ + + + + + + +
文本节点存放提示词、脚本、镜头描述或要求。可点击“AI 润色”优化文本。
LLM 文本生成用于先生成文案、分镜描述或提示词，再把输出连接给文生图或视频节点。
文生图配置选择图片模型、尺寸和质量，接收文本/参考图后点击“立即生成”。当前常用尺寸为 auto、1024x1536、1024x1024、1536x1024，质量为标准。
图片节点可上传图片、粘贴图片地址，或承接生成结果。图片节点可以作为图生图参考，也可以作为视频首帧、尾帧或参考图。
视频生成配置选择视频模型、比例、时长，接收提示词和图片后生成视频。常用比例包括竖屏、横屏、方形和 3:4；时长以页面可选项为准。
视频节点承接生成后的视频结果，后续可预览和下载。
+

连线规则

+ +
+ +
+

5. 公共工作流与我的工作流

+

工作流模板适合重复使用的创作链路。点击左侧九宫格图标打开工作流面板。

+
+ 公共工作流 +
公共工作流：点击任意模板，会把一组节点插入当前画布。
+
+

公共工作流

+ + +
+ 我的工作流 +
我的工作流：可以保存当前画布结构，在同一账号的其他设备上复用。
+
+

我的工作流

+
    +
  1. 在画布中搭好一套常用节点结构。
    2. +
  2. 打开工作流面板，切换到“我的工作流”。
    3. +
  3. 点击“保存当前”，填写名称并保存。
    4. +
  4. 以后打开同一账号时，可在“我的工作流”里点击模板插回画布。
    5. +
+
+ “我的工作流”保存的是节点结构、连线、配置和提示词，不保存一次性生成出来的图片、视频、进度和错误。这样模板不会被旧结果污染。 +
+
+ +
+

6. 常用生成流程

+ +

流程 A：快速文生图

+
    +
  1. 在首页或画布底部输入需求，例如“白底产品主图，颈部按摩仪悬浮展示，柔和自然光”。
    2. +
  2. 需要更专业时先点“AI 润色”。如果不希望系统改太多，就在原提示词里写清楚“保持主体和构图”。
    3. +
  3. 开启“自动执行”，点击发送。
    4. +
  4. 系统会创建文生图节点并开始生成。完成后图片会回填到画布。
    5. +
+ +

流程 B：手动文生图

+
    +
  1. 点击左侧加号，添加“文本节点”和“文生图配置”。
    2. +
  2. 在文本节点写提示词。
    3. +
  3. 从文本节点右侧连接点拖到文生图节点左侧连接点。
    4. +
  4. 在文生图节点里选择模型和尺寸，点击“立即生成”。
    5. +
+ +

流程 C：图生视频

+
    +
  1. 添加“图片节点”，上传或粘贴一张参考图。
    2. +
  2. 添加“视频生成配置”节点。
    3. +
  3. 从图片节点连接到视频生成节点。默认角色为“首帧”，需要时可切换为“尾帧”或“参考图”。
    4. +
  4. 在视频节点提示词里写动作和镜头，例如“产品缓慢旋转，镜头轻推近，背景干净”。
    5. +
  5. 选择比例和时长后点击“生成视频”。
    6. +
+ +

流程 D：一张图继续改图

+
    +
  1. 把参考图放进图片节点。
    2. +
  2. 连接到文生图配置节点。
    3. +
  3. 在文本节点或文生图节点里写明“保留哪些内容、调整哪些内容”。
    4. +
  4. 点击“立即生成”。
    5. +
+ +

流程 E：用工作流做复杂任务

+
    +
  1. 打开“公共工作流”，选择接近目标的模板。
    2. +
  2. 按模板节点提示补充角色、产品、场景、分镜或参考图。
    3. +
  3. 逐个点击节点里的生成按钮，或用底部自动执行辅助创建链路。
    4. +
  4. 得到满意结构后，切到“我的工作流”保存，后续复用。
    5. +
+
+ +
+

7. 素材下载与沉淀

+

生成出的图片和视频会保存在当前账号自己的项目里。当前画布里有可下载素材时，右上角下载图标会高亮。

+
+ 素材下载弹窗 +
素材下载：会汇总当前画布里可下载的图片和视频。
+
+ +
+ 数据库存的是项目、任务、索引和归属信息；生成的大图片、视频文件仍作为媒体文件保存。你换电脑后能看到项目和结果，是因为服务端按账号把任务和素材索引关联起来。 +
+
+ +
+

8. 模型与接口设置

+

平台默认使用 SKG 内部生成接口。普通员工不需要填写 API Key，也不需要改 Base URL。

+
+ API 设置 +
API 设置：默认渠道为 SKG 内部，生成调用走当前登录会话。
+
+ + + + +
API 配置查看当前渠道、Base URL、端点路径。一般保持默认即可。
模型配置查看问答、图片、视频模型。不要随意添加不存在的模型名。
API Key内部接口无需个人填写，页面提示“生成调用走当前登录会话”。
+
+ 如果生成按钮可点但连续失败，不要自行改 API 设置。先看节点里的中文错误提示，再联系管理员排查上游模型、额度或风控。 +
+
+ +
+

9. 提示词写法

+

基本原则

+ + +

推荐结构

+
+ 主体 + 场景 + 动作/镜头 + 风格 + 画幅/用途 + 必须保留/禁止事项 +
+

示例：SKG 颈部按摩仪，白底电商主图，产品悬浮展示，柔和自然光，高级产品摄影，竖版 1024x1536，保留产品真实外观，不要出现人物。

+

示例：AI 生成的虚拟女性角色站在明亮浴室中，手持护理产品，镜头缓慢推进，清爽自然光，短视频竖屏，人物为虚构角色，不对应任何真实人物。

+ +

使用 AI 人像素材时

+

平台允许你使用 AI 生成的人像素材继续做图生视频，但上游视频模型仍可能把清晰人脸误判为真实肖像或隐私信息。遇到这类报错时优先尝试：

+ +
+ +
+

10. 常见问题与报错处理

+ + + + + + + + + +
看不到别人项目这是正常的。平台按当前登录账号隔离数据，每个人默认只能看到自己的项目和生成结果。
换电脑后看不到内容确认是否用同一个飞书账号登录。如果以前用过旧密码账号，需联系管理员确认历史内容是否已归属到飞书账号。
登录过期重新从飞书进入或点击登录页授权。不要反复刷新生成中的页面。
视频一直排队视频生成通常较慢，且同一用户可能限制并发。保持页面打开，等待状态更新。
图片生成超时上游图片模型响应慢或不可用。缩短提示词、稍后重试，或联系管理员确认模型状态。
视频提示人脸/隐私风控参考图里有清晰人脸或疑似真实人物。按“AI 人像素材”建议处理，再重新生成。
素材下载为空当前画布没有完成的图片或视频节点。生成完成后再打开下载面板。
公司 Wi-Fi 手机打不开先切个人网络或浏览器访问。如果电脑同网络正常、手机飞书内不正常，通常是移动端网络或飞书内置浏览器限制。
+
+ +
+

11. 发布给团队时的使用建议

+ +
+
+ +