📚 独家连环画创作系统
- 业界首个集成文本生成和图像生成的连环画创作解决方案
- 一键生成完整故事书，包含文字和图像
- 支持HTML内嵌预览、浏览器预览、PDF导出等多种方式
- 智能参考图像循环使用，保持风格一致性
🎨 强大的图像生成能力
- 支持1K/2K/4K多种分辨率
- 一次生成1-15张图像
- 支持最多10张参考图像（连环画模式）
- 多种图像风格：卡通、写实、动漫、水彩等
🎬 专业的视频生成功能
- 文本到视频生成
- 连续场景视频生成
- 多图参考视频生成
- 智能任务轮询，自动处理长时间任务
📝 灵活的文本生成
- 支持豆包大模型系列（doubao-seed-1-6）
- 多种模型选择：标准版、快速版
- 可调节温度、top_p等参数
- 适合故事创作、文案生成等场景
🔧 完善的工具链
- 12个专业节点，覆盖全流程
- 统一的"Ken-Chen/Doubao"分类
- 详尽的文档和示例
- 活跃的社区支持
⚡ 优秀的性能
- 优化的API调用机制
- 智能缓存和批处理
- 多镜像自动故障转移
- 内存优化，支持大规模生成

🎯 节点概览

本项目提供 12个专业节点，全部归类在 "Ken-Chen/Doubao" 类别下：

📸 图像生成节点（2个）

SeedReam4API (多图) - 支持最多5张参考图像的高质量图像生成
SeedReam4API (单图) - 单张图像生成和编辑，适合快速创作

🎬 视频生成节点（3个）

Doubao-Seedance视频生成 - 基础的文本到视频生成
Doubao-Seedance连续视频生成 - 支持连续场景的视频生成
Doubao-Seedance多图参考视频生成 - 基于多张参考图的视频生成

📝 文本生成节点（1个）

doubao-seed-1-6 - 豆包大模型文本生成，支持3种模型选择

📚 连环画创作节点（6个）

豆包连环画创作 - 一键生成完整连环画故事书（文本+图像）
连环画分页浏览 - 分页预览连环画，支持翻页和循环
连环画HTML浏览导出 - 生成可交互的HTML连环画文件
连环画HTML内嵌预览 - 在ComfyUI界面内直接预览连环画
连环画浏览器预览 - 在系统浏览器中打开连环画
连环画批量导出(PNG/JPG/PDF) - 批量导出图片和PDF文件

📚 连环画创作完整指南

🎨 连环画创作节点详解

1. 豆包连环画创作（DoubaoComicBookNode）

核心功能：一键生成完整的连环画故事书，集成文本生成和图像生成

主要参数：

故事设置：

story_prompt (STRING): 故事主题提示词
- 示例："一个关于小兔子冒险的温馨故事"
story_length (选择): 故事长度
- short: 3-5个场景
- medium: 6-8个场景（推荐）
- long: 9-12个场景
story_theme (STRING): 故事主题（可选）
- 示例："友谊、勇气、成长"

图像设置：

image_style (选择): 图像风格
- cartoon: 卡通风格（推荐）
- realistic: 写实风格
- anime: 动漫风格
- watercolor: 水彩风格
resolution (选择): 图像分辨率
- 1K: 1024x1024（快速）
- 2K: 2048x2048（推荐）
- 4K: 4096x4096（高质量）
aspect_ratio (选择): 宽高比
- 4:3: 适合连环画（推荐）
- 16:9: 宽屏
- 1:1: 正方形

参考图像（可选）：

reference_images: 主参考图像
reference_image_2 到 reference_image_10: 额外参考图像
智能循环使用: 系统会自动循环使用所有参考图片，为不同场景提供不同的视觉参考
最多支持10张: 可以同时使用最多10张参考图片来指导连环画创作

角色和场景（可选）：

character_description (STRING): 角色描述
- 示例："一只白色的小兔子，穿着蓝色背心"
background_style (STRING): 背景风格
- 示例："梦幻森林，充满魔法元素"

API设置：

mirror_site (选择): 镜像站选择
- comfly: ComFly镜像站（推荐）
- volcengine: 火山引擎官方API
text_model (选择): 文本生成模型
- doubao-seed-1-6-250615: 标准版（推荐）
- doubao-seed-1-6-flash-250615: 快速版
- doubao-seed-1-6-flash-250828: 最新快速版
image_model (选择): 图像生成模型
- doubao-seedream-4-0-250828: 最新版（推荐）
- doubao-seedream-4-5-251128: 4.5版本 (注意：不支持1K分辨率)
watermark (BOOLEAN): 是否添加水印（默认：True）

输出内容：

comic_images (IMAGE): 生成的连环画图像批次
story_text (STRING): 格式化的故事文本
story_structure (STRING): JSON格式的故事结构
generation_info (STRING): 生成信息统计

🔍 连环画预览和导出节点

2. 连环画分页浏览（ComicPageSelectorNode）

功能：从图像批次中按页选择一张，用于连环画翻页预览

参数：

images (IMAGE): 连环画图像批次
page_index (INT): 页码（从1开始）
loop (BOOLEAN): 是否循环（超出范围时回到第一页）

使用方法：

豆包连环画创作.comic_images → 连环画分页浏览.images
连环画分页浏览.page_image → Preview Image.images

输出：

page_image (IMAGE): 当前页的图像
page_info (STRING): 页码信息

3. 连环画HTML浏览导出（ComicHTMLViewerNode）

功能：生成可交互的HTML连环画文件，支持翻页动画

参数：

images (IMAGE): 连环画图像批次
story_structure (STRING): 故事结构（推荐连接 story_text 输出）
title (STRING): 连环画标题（默认："我的连环画"）
output_filename (STRING): HTML文件名（默认："comic_story.html"）
transition_effect (选择): 翻页特效
- page-turn: 翻书效果（推荐）
- fade: 淡入淡出
- slide: 滑动
- flip: 翻转
- none: 无特效
transition_duration (FLOAT): 特效持续时间（0.1-3.0秒，默认1.5秒）

输出：

viewer_path (STRING): HTML文件路径
info (STRING): 生成信息

输出位置：web/exports/时间戳_comic_story.html

HTML特性：

✅ 左右翻页按钮
✅ 页码显示（第X页/共Y页）
✅ 键盘导航（←/→ 键翻页）
✅ 图片和文字同步显示
✅ 响应式设计
✅ 所有资源内嵌（单文件分享）

4. 连环画HTML内嵌预览（ComicHTMLPreviewNode）⭐ 推荐

功能：在ComfyUI界面内直接预览连环画，无需打开外部浏览器

参数：

viewer_path (STRING): HTML文件路径（从 ComicHTMLViewerNode 输出）
width (INT): 预览窗口宽度（100-2000，默认800）
height (INT): 预览窗口高度（100-2000，默认600）
scale (FLOAT): 缩放比例（0.1-2.0，默认1.0）

使用方法：

连环画HTML浏览导出.viewer_path → 连环画HTML内嵌预览.viewer_path

特点：

✅ 直接在 ComfyUI 界面内预览
✅ 无需打开外部浏览器
✅ 内置刷新按钮，可实时更新
✅ 可调整预览窗口尺寸
✅ 支持所有HTML交互功能

适用场景：快速预览、调试、小屏幕设备

5. 连环画浏览器预览（ComicBrowserViewerNode）

功能：在系统默认浏览器中打开HTML连环画文件

参数：

viewer_path (STRING): HTML文件路径
auto_open (BOOLEAN): 是否自动打开（默认：False）

使用方法：

连环画HTML浏览导出.viewer_path → 连环画浏览器预览.viewer_path

特点：

✅ 在系统默认浏览器中打开
✅ 节点上有"🌐 打开浏览器"按钮
✅ 完整的浏览体验
✅ 支持打印、分享等功能
✅ 可选自动打开或手动点击按钮

输出：

file_url (STRING): 文件URL（file://路径）
status (STRING): 状态信息

适用场景：最终查看、分享、打印

6. 连环画批量导出(PNG/JPG/PDF)（ComicBatchExporterNode）

功能：批量导出连环画为图片序列和PDF文件

参数：

images (IMAGE): 连环画图像批次
story_structure (STRING): 故事结构（可选，用于导出文字）
title (STRING): 连环画标题（默认："我的连环画"）
output_subdir (STRING): 输出子目录（默认："comic_export"）
filename_prefix (STRING): 文件名前缀（默认："page_"）
image_format (选择): 图像格式
- png: PNG格式（无损）
- jpg: JPG格式（较小）
jpg_quality (INT): JPG质量（10-100，默认92）
export_pdf (BOOLEAN): 是否导出PDF（默认：True）
pdf_with_text (BOOLEAN): PDF是否包含文字（默认：True）
pdf_filename (STRING): PDF文件名（默认："comic_story.pdf"）

输出内容：

图片序列：page_01.png、page_02.png...
文本文件：story_texts.txt（包含每页的文字）
PDF文件：comic_story.pdf（可选）

输出目录：web/exports/<时间戳_标题>/<output_subdir>/

输出：

export_path (STRING): 导出目录路径
info (STRING): 导出信息统计

适用场景：

需要单独编辑图片
需要打印或印刷
需要分享PDF文件
需要备份原始图片

🎯 推荐工作流

工作流 1：快速预览（推荐新手）

豆包连环画创作
    ↓ comic_images, story_text
连环画HTML浏览导出
    ↓ viewer_path
连环画HTML内嵌预览
    (在ComfyUI界面内直接查看)

工作流 2：完整浏览体验

豆包连环画创作
    ↓ comic_images, story_text
连环画HTML浏览导出
    ↓ viewer_path
    ├─→ 连环画HTML内嵌预览（快速预览）
    └─→ 连环画浏览器预览（完整浏览）

工作流 3：完整导出（推荐专业用户）

豆包连环画创作
    ↓ comic_images, story_text
    ├─→ 连环画HTML浏览导出 ─→ 连环画浏览器预览
    └─→ 连环画批量导出(PNG/JPG/PDF)

工作流 4：分页预览

豆包连环画创作
    ↓ comic_images
连环画分页浏览
    ↓ page_image
Preview Image
    (调整 page_index 翻页)

💡 使用技巧

故事文本连接：
- ✅ 推荐：DoubaoComicBookNode.story_text → ComicHTMLViewerNode.story_structure
- ⚠️ 也支持：DoubaoComicBookNode.story_structure → ComicHTMLViewerNode.story_structure
参考图像使用：
- 单张参考图：连接到 reference_images
- 多张参考图：连接到 reference_image_2 到 reference_image_10
- 系统会自动循环使用所有参考图片
预览方式选择：
- 快速调试：使用 连环画HTML内嵌预览
- 最终查看：使用 连环画浏览器预览
- 分页查看：使用 连环画分页浏览
导出格式选择：
- 需要编辑：导出PNG格式
- 需要分享：导出PDF格式
- 需要网页：使用HTML浏览导出

📸 功能展示

连环画创作示例

一键生成完整的连环画故事书，包含文本和图像

Doubao-Seed图像生成

高质量图像生成，支持多种风格和分辨率

Doubao-Seed视频生成

文本到视频生成，支持多种分辨率和时长

HTML内嵌预览

在ComfyUI界面内直接预览连环画

📦 安装指南

前置要求

ComfyUI: 已安装并可正常运行
Python: 3.8 或更高版本
操作系统: Windows / Linux / macOS

方法一：Git克隆（推荐）

# 进入ComfyUI的custom_nodes目录
cd ComfyUI/custom_nodes

# 克隆项目
git clone https://github.com/Ken-Chen/ComfyUI_Doubao_Seed.git

# 进入项目目录
cd ComfyUI_Doubao_Seed

# 安装依赖
pip install -r requirements.txt

# 如果需要PDF导出功能（可选）
pip install -r requirements_face_restore.txt
# 或者运行批处理文件（Windows）
install_pdf_support.bat

方法二：ComfyUI Manager（最简单）

在ComfyUI中打开 Manager 面板
搜索 "Doubao" 或 "ComfyUI_Doubao_Seed"
点击 Install 安装
重启ComfyUI

方法三：手动下载

下载项目压缩包：GitHub Releases
解压到 ComfyUI/custom_nodes/ComfyUI_Doubao_Seed
安装依赖：

cd ComfyUI/custom_nodes/ComfyUI_Doubao_Seed
pip install -r requirements.txt

依赖说明

核心依赖（必需）：

requests - API调用
Pillow - 图像处理
numpy - 数值计算
torch - PyTorch（ComfyUI已包含）

可选依赖（增强功能）：

reportlab - PDF生成（连环画导出功能）
opencv-python - 视频处理
imageio - 图像序列处理

验证安装

重启ComfyUI
在节点列表中搜索 "Ken-Chen/Doubao"
应该能看到12个节点：
- SeedReam4API (多图)
- SeedReam4API (单图)
- Doubao-Seedance视频生成
- Doubao-Seedance连续视频生成
- Doubao-Seedance多图参考视频生成
- doubao-seed-1-6
- 豆包连环画创作
- 连环画分页浏览
- 连环画HTML浏览导出
- 连环画HTML内嵌预览
- 连环画浏览器预览
- 连环画批量导出(PNG/JPG/PDF)

🔧 配置设置

API密钥配置

在使用前，您需要配置相应的API密钥。项目支持多种服务端点。

方法一：配置文件（推荐）

在项目根目录创建 SeedReam4_config.json 文件：

{
  "doubao_api_key": "your_doubao_api_key",
  "doubao_endpoint": "https://ark.cn-beijing.volces.com/api/v3",
  "t8_api_key": "your_t8_api_key",
  "t8_endpoint": "https://api.t8.run/v1",
  "comfly_api_key": "your_comfly_api_key",
  "comfly_endpoint": "https://api.comfly.ai/v1"
}

配置说明：

doubao_api_key: 火山引擎豆包API密钥
doubao_endpoint: 火山引擎API端点
t8_api_key: T8镜像站API密钥
t8_endpoint: T8镜像站端点
comfly_api_key: ComFly镜像站API密钥
comfly_endpoint: ComFly镜像站端点

方法二：环境变量

您可以通过环境变量设置API密钥：

Windows (PowerShell):

$env:DOUBAO_API_KEY="your_doubao_api_key"
$env:T8_API_KEY="your_t8_api_key"
$env:COMFLY_API_KEY="your_comfly_api_key"

Linux / macOS:

export DOUBAO_API_KEY="your_doubao_api_key"
export T8_API_KEY="your_t8_api_key"
export COMFLY_API_KEY="your_comfly_api_key"

方法三：节点参数

在节点中直接输入API密钥（不推荐，安全性较低）

获取API密钥

1. 火山引擎豆包API（官方）

访问火山引擎控制台
注册并登录账号
创建API密钥
复制密钥到配置文件

优点：

✅ 官方服务，稳定可靠
✅ 完整功能支持
✅ 技术支持

缺点：

⚠️ 需要实名认证
⚠️ 可能需要付费

2. T8镜像站

访问 T8镜像站
注册账号
获取API密钥

优点：

✅ 注册简单
✅ 价格优惠
✅ 支持多种模型

3. ComFly镜像站（推荐）

访问 ComFly官网
注册账号
获取API密钥

优点：

✅ 注册简单
✅ 稳定性好
✅ 响应速度快
✅ 支持连环画创作

代理设置

如果需要使用代理，可以在配置文件中添加：

{
  "proxy": {
    "http": "http://proxy:port",
    "https": "https://proxy:port"
  }
}

或在节点参数中配置：

HTTP代理：http://proxy:port
SOCKS代理：socks5://proxy:port

高级配置

在 SeedReam4_config.json 中可以配置更多选项：

{
  "doubao_api_key": "your_api_key",
  "doubao_endpoint": "https://ark.cn-beijing.volces.com/api/v3",

  "default_model": "doubao-seedream-4-0-250828",
  "timeout": 60,
  "max_retries": 3,
  "retry_delay": 2,

  "performance": {
    "max_concurrent_requests": 3,
    "request_timeout": 60,
    "max_image_size": "4K",
    "video_quality": "high"
  },

  "proxy": {
    "http": "http://proxy:port",
    "https": "https://proxy:port"
  }
}

参数说明：

default_model: 默认使用的模型
timeout: API请求超时时间（秒）
max_retries: 最大重试次数
retry_delay: 重试延迟（秒）
max_concurrent_requests: 最大并发请求数
request_timeout: 请求超时时间
max_image_size: 最大图像尺寸
video_quality: 视频质量设置

📋 节点详细说明

🎯 Doubao-Seed节点系列

ComfyUI Doubao-Seed提供了7个专业节点，全部归类在"Ken-Chen/Doubao"类别下，为用户提供统一的Doubao生态体验。

📊 节点分类概览

图像生成节点（2个）

SeedReam4APINode - 多图像输入的图像生成
SeedReam4APISingleNode - 单图像生成和编辑

视频生成节点（3个）

DoubaoSeedanceVideoNode - 基础视频生成功能
DoubaoSeedanceContinuousVideoNode - 连续视频生成
DoubaoSeedanceMultiRefVideoNode - 多图参考视频生成

视频处理节点（2个）

VideoStitchingNode - 视频拼接处理
GetLastFrameNode - 视频尾帧提取

🌐 Doubao-Seed节点详解

1. SeedReam4API (多图) - SeedReam4APINode

专业的多图像输入图像生成节点

功能描述: 基于Doubao Seedream4模型的高质量图像生成，支持多张参考图像输入
核心特性:
- ✅ 多图像输入: 支持最多5张参考图像同时输入
- ✅ 多镜像支持: T8镜像站、ComFly、火山引擎等多种服务端点
- ✅ 自动故障转移: 主API失败时自动切换到备用服务
- ✅ 高分辨率支持: 1K/2K/4K多种分辨率选择
- ✅ 灵活比例: 支持9种预设比例和自定义尺寸
- ✅ 批量生成: 一次生成1-15张图像
- ✅ 种子控制: 支持固定种子获得可重现结果
主要参数:
- prompt: 图像描述提示词
- mirror_site: 服务端点选择
- resolution: 分辨率设置 (1K/2K/4K)
- aspect_ratio: 宽高比选择
- max_images: 生成图像数量 (1-15)
- image1-5: 参考图像输入
- seed: 随机种子控制
- watermark: 水印开关
输出内容: 生成的图像、响应信息、图像URL

2. SeedReam4API (单图) - SeedReam4APISingleNode

专业的单图像生成和编辑节点

功能描述: 专门用于单图像生成和基于参考图像的编辑变换
核心特性:
- ✅ 单图像专精: 专注于单张图像的生成和编辑
- ✅ 图像编辑: 基于输入图像进行智能编辑和风格变换
- ✅ 快速生成: 优化的单图生成流程，响应更快
- ✅ 多镜像支持: T8镜像站、火山引擎官方API
- ✅ 高质量输出: 支持1K-4K高分辨率输出
主要参数:
- prompt: 图像描述或编辑指令
- mirror_site: 服务端点 (t8_mirror, volcengine)
- image: 参考图像输入
- resolution: 分辨率设置
- aspect_ratio: 宽高比选择
- max_images: 生成数量
- seed: 种子控制
适用场景: 单图编辑、风格转换、图像优化、快速原型制作

3. Doubao-Seedance视频生成 - DoubaoSeedanceVideoNode

基础的文本到视频生成节点

功能描述: 基于Doubao Seedance模型的高质量视频生成功能
核心特性:
- ✅ 文本到视频: 根据文本描述生成高质量视频
- ✅ 多分辨率支持: 支持720p、1080p等多种分辨率
- ✅ 时长控制: 支持3-12秒的视频时长设置
- ✅ 多镜像支持: T8镜像站、火山引擎官方API
- ✅ 智能轮询: 自动任务状态检查和结果获取
主要参数:
- prompt: 视频描述提示词
- mirror_site: 服务端点选择
- resolution: 视频分辨率
- duration: 视频时长 (3-12秒)
- api_key: API密钥
- seed: 随机种子
输出内容: 生成的视频文件、任务信息

4. Doubao-Seedance连续视频生成 - DoubaoSeedanceContinuousVideoNode

连续场景视频生成节点

功能描述: 支持连续场景和长视频生成的高级视频节点
核心特性:
- ✅ 连续生成: 支持连续场景的视频生成
- ✅ 长视频支持: 支持更长时长的视频创作
- ✅ 场景连贯: 保持视频场景的连贯性和一致性
- ✅ 高级控制: 更多的视频生成参数控制
适用场景: 故事叙述、连续动画、长视频创作

5. Doubao-Seedance多图参考视频生成 - DoubaoSeedanceMultiRefVideoNode

多图像参考视频生成节点

功能描述: 基于多张参考图像生成视频，支持图像序列到视频的转换
核心特性:
- ✅ 多图输入: 支持多张参考图像输入
- ✅ 图像序列: 将图像序列转换为流畅视频
- ✅ 风格一致: 保持参考图像的风格和特征
- ✅ 智能插帧: 自动生成图像间的过渡帧
适用场景: 图像动画化、产品展示视频、艺术创作

6. doubao-seed-1-6 - DoubaoSeed16Node

豆包大模型文本生成节点

功能描述: 基于火山引擎豆包大模型的高质量文本生成和内容创作
核心特性:
- ✅ 三模型支持: 支持doubao-seed-1-6-250615、doubao-seed-1-6-flash-250615和doubao-seed-1-6-flash-250828模型
- ✅ 多镜像站支持: 支持Comfly、T8镜像站、火山引擎官方API
- ✅ 智能文本生成: 高质量的文章、对话、创意内容生成
- ✅ 灵活参数控制: 支持温度、top_p、token限制等参数调节
- ✅ 系统提示词: 可自定义系统角色和行为模式
- ✅ 流式输出: 支持实时流式文本生成
- ✅ 使用统计: 详细的token使用情况统计
- ✅ 自动故障转移: 主API失败时自动切换到备用服务
主要参数:
- prompt: 用户输入的提示词
- mirror_site: 镜像站选择 (comfly / t8_mirror / volcengine)
- model: 模型选择 (doubao-seed-1-6-250615 / doubao-seed-1-6-flash-250615 / doubao-seed-1-6-flash-250828)
- api_key: API密钥
- max_tokens: 最大生成token数 (1-4000)
- temperature: 温度参数，控制随机性 (0.0-2.0)
- top_p: 核采样参数 (0.0-1.0)
- system_prompt: 系统提示词
- stream: 是否流式输出
- presence_penalty: 存在惩罚 (-2.0到2.0)
- frequency_penalty: 频率惩罚 (-2.0到2.0)
输出内容: 生成的文本、响应信息、使用情况统计
适用场景: 内容创作、文章写作、对话生成、创意写作、代码生成
核心特性:
- ✅ 精确提取: 准确获取视频的最后一帧
- ✅ 高质量输出: 保持原视频的图像质量
- ✅ 格式兼容: 支持多种视频格式输入
- ✅ ComfyUI集成: 输出标准的ComfyUI图像格式
主要参数:
- video: 输入视频文件
输出内容: 视频最后一帧的图像
适用场景: 视频缩略图生成、关键帧提取、视频预览图制作

🚀 快速开始

5分钟快速上手

步骤 1：安装插件

cd ComfyUI/custom_nodes
git clone https://github.com/Ken-Chen/ComfyUI_Doubao_Seed.git
cd ComfyUI_Doubao_Seed
pip install -r requirements.txt

步骤 2：配置API密钥

在项目根目录创建 SeedReam4_config.json:

{
  "comfly_api_key": "your_comfly_api_key",
  "comfly_endpoint": "https://api.comfly.ai/v1"
}

获取API密钥：

ComFly镜像站（推荐）: 访问ComFly官网注册
T8镜像站: https://api.t8.run
火山引擎官方: https://console.volcengine.com/ark

步骤 3：重启ComfyUI

配置完成后重启ComfyUI，在节点列表中搜索 "Ken-Chen/Doubao"

步骤 4：创建第一个连环画

添加节点：
- 右键 → Add Node → Ken-Chen/Doubao → 豆包连环画创作

配置参数：

story_prompt: "一个关于小猫咪学习飞翔的奇幻故事"
mirror_site: comfly
story_length: medium
image_style: cartoon
resolution: 2K
aspect_ratio: 4:3

添加预览节点：

添加 "连环画HTML浏览导出" 节点
添加 "连环画HTML内嵌预览" 节点

连接：

豆包连环画创作.comic_images → 连环画HTML浏览导出.images
豆包连环画创作.story_text → 连环画HTML浏览导出.story_structure
连环画HTML浏览导出.viewer_path → 连环画HTML内嵌预览.viewer_path

执行工作流：
- 点击 "Queue Prompt" 执行
- 等待生成完成（约2-5分钟）
- 在 "连环画HTML内嵌预览" 节点中查看结果

🎉 恭喜！ 您已经成功创建了第一个连环画！

🚀 使用示例

📚 连环画创作示例（推荐）

示例 1：基础连环画创作

目标：创作一个关于小兔子冒险的温馨故事

步骤：

添加连环画创作节点

豆包连环画创作:
  story_prompt = "一个关于小兔子在森林里寻找魔法胡萝卜的冒险故事"
  mirror_site = "comfly"
  text_model = "doubao-seed-1-6-250615"
  image_model = "doubao-seedream-4-0-250828"
  story_length = "medium"
  image_style = "cartoon"
  resolution = "2K"
  aspect_ratio = "4:3"
  watermark = False

添加HTML导出节点

连环画HTML浏览导出:
  images = 豆包连环画创作.comic_images
  story_structure = 豆包连环画创作.story_text
  title = "小兔子的魔法冒险"
  transition_effect = "page-turn"
  transition_duration = 1.5

添加预览节点

连环画HTML内嵌预览:
  viewer_path = 连环画HTML浏览导出.viewer_path
  width = 800
  height = 600
  scale = 1.0

执行工作流
- 点击 "Queue Prompt"
- 等待生成完成（约3-5分钟）
- 在预览节点中查看连环画

示例 2：带参考图片的连环画

目标：使用参考图片创作风格一致的连环画

步骤：

加载参考图片

Load Image:
  image = "character_reference.png"

Load Image (2):
  image = "background_reference.png"

创建连环画

豆包连环画创作:
  story_prompt = "小女孩和她的宠物狗在公园里的快乐时光"
  reference_images = Load Image.IMAGE
  reference_image_2 = Load Image (2).IMAGE
  character_description = "一个穿着黄色连衣裙的小女孩，扎着马尾辫"
  background_style = "阳光明媚的公园，有绿树和花朵"
  story_theme = "友谊、快乐、成长"
  story_length = "long"
  image_style = "cartoon"
  resolution = "2K"

导出和预览
- 连接HTML导出节点
- 连接预览节点
- 执行工作流

示例 3：完整导出工作流

目标：生成连环画并导出为多种格式

步骤：

创建连环画

豆包连环画创作:
  story_prompt = "勇敢的小猫咪学习飞翔的故事"
  story_length = "medium"
  image_style = "anime"
  resolution = "2K"

HTML导出

连环画HTML浏览导出:
  images = 豆包连环画创作.comic_images
  story_structure = 豆包连环画创作.story_text
  title = "飞翔的小猫咪"

批量导出

连环画批量导出(PNG/JPG/PDF):
  images = 豆包连环画创作.comic_images
  story_structure = 豆包连环画创作.story_text
  title = "飞翔的小猫咪"
  image_format = "png"
  export_pdf = True
  pdf_with_text = True

预览

连环画HTML内嵌预览:
  viewer_path = 连环画HTML浏览导出.viewer_path

连环画浏览器预览:
  viewer_path = 连环画HTML浏览导出.viewer_path
  auto_open = False

输出结果：

HTML文件：web/exports/时间戳_飞翔的小猫咪.html
PNG图片：web/exports/时间戳_飞翔的小猫咪/comic_export/page_01.png ...
PDF文件：web/exports/时间戳_飞翔的小猫咪/comic_export/comic_story.pdf
文本文件：web/exports/时间戳_飞翔的小猫咪/comic_export/story_texts.txt

📸 图像生成示例

示例 4：基础图像生成

目标：生成一张高质量的图像

SeedReam4API (单图):
  prompt = "一只可爱的橘猫坐在阳光明媚的窗台上，温暖的光线，高质量摄影，4K，细节丰富"
  mirror_site = "t8_mirror"
  resolution = "2K"
  aspect_ratio = "16:9"
  max_images = 1
  watermark = False

Preview Image:
  images = SeedReam4API (单图).images

示例 5：多图参考生成

目标：基于多张参考图生成新图像

Load Image (1-5):
  image = "reference_1.png" ... "reference_5.png"

SeedReam4API (多图):
  prompt = "结合参考图的风格，创作一幅梦幻的风景画"
  image1 = Load Image (1).IMAGE
  image2 = Load Image (2).IMAGE
  image3 = Load Image (3).IMAGE
  image4 = Load Image (4).IMAGE
  image5 = Load Image (5).IMAGE
  resolution = "2K"
  aspect_ratio = "4:3"
  max_images = 4

Preview Image:
  images = SeedReam4API (多图).images

🎬 视频生成示例

示例 6：基础视频生成

目标：生成一段短视频

Doubao-Seedance视频生成:
  prompt = "一只小鸟在樱花树上歌唱，春天的微风轻抚花瓣，唯美画面"
  mirror_site = "t8_mirror"
  resolution = "1080p"
  duration = 6
  seed = 42

VHS_VideoCombine:
  images = Doubao-Seedance视频生成.video
  frame_rate = 24
  format = "video/h264-mp4"

示例 7：多图参考视频生成

目标：基于图像序列生成视频

Load Image (序列):
  image = "frame_01.png" ... "frame_10.png"

Doubao-Seedance多图参考视频生成:
  prompt = "将这些图像转换为流畅的动画视频"
  reference_images = Load Image.IMAGE
  resolution = "1080p"
  duration = 8

VHS_VideoCombine:
  images = Doubao-Seedance多图参考视频生成.video

📝 文本生成示例

示例 8：基础文本生成

目标：生成一篇文章

doubao-seed-1-6:
  prompt = "请写一篇关于人工智能在医疗领域应用的短文，包括现状、挑战和未来展望"
  mirror_site = "comfly"
  model = "doubao-seed-1-6-250615"
  max_tokens = 1000
  temperature = 0.7
  top_p = 0.9

Show Text:
  text = doubao-seed-1-6.generated_text

示例 9：创意写作

目标：创作一个科幻故事

doubao-seed-1-6:
  prompt = "创作一个关于未来人类移民火星的科幻短故事"
  system_prompt = "你是一个创意写作专家，擅长创作引人入胜的科幻故事"
  mirror_site = "comfly"
  model = "doubao-seed-1-6-250615"
  max_tokens = 2000
  temperature = 0.9
  presence_penalty = 0.6
  frequency_penalty = 0.3

Show Text:
  text = doubao-seed-1-6.generated_text

⚙️ 性能优化

图像生成优化

批量处理：

支持1-15张图像同时生成
自动批处理优化内存使用
并行处理提高生成速度

分辨率优化：

1K (1024x1024): 快速生成，适合预览
2K (2048x2048): 平衡质量和速度（推荐）
4K (4096x4096): 最高质量，适合打印

内存管理：

自动释放未使用的图像缓存
大图像分块处理
优化的张量操作

视频生成优化

任务轮询：

智能任务状态检查
自动重试失败的任务
实时进度反馈

质量控制：

多级质量设置
自适应码率
平衡速度与效果

格式兼容：

支持MP4、AVI等多种格式
自动格式转换
兼容ComfyUI视频节点

API调用优化

多镜像支持：

自动故障转移
负载均衡
智能路由选择

重试机制：

指数退避重试
最大重试次数限制
错误分类处理

连接优化：

HTTP连接池
Keep-Alive支持
SSL优化

连环画创作优化

并行生成：

文本和图像并行生成
多场景并发处理
智能任务调度

缓存策略：

参考图像缓存
模型响应缓存
减少重复API调用

内存优化：

流式处理大型连环画
自动清理临时文件
优化的图像编码

性能建议

推荐配置（中等性能）：

{
  "performance": {
    "max_concurrent_requests": 3,
    "request_timeout": 60,
    "retry_delay": 2,
    "max_image_size": "2K",
    "video_quality": "medium"
  }
}

高性能配置（高端设备）：

{
  "performance": {
    "max_concurrent_requests": 5,
    "request_timeout": 120,
    "retry_delay": 1,
    "max_image_size": "4K",
    "video_quality": "high"
  }
}

低配置优化（低端设备）：

{
  "performance": {
    "max_concurrent_requests": 1,
    "request_timeout": 30,
    "retry_delay": 3,
    "max_image_size": "1K",
    "video_quality": "low"
  }
}

🐛 故障排除

常见问题解决

1. 连环画预览窗口空白 ⭐ 重要

问题：连环画HTML内嵌预览节点显示空白

原因：

WEB_DIRECTORY 配置未正确加载
浏览器缓存问题
HTML文件路径错误

解决方案：

确认 __init__.py 中有 WEB_DIRECTORY = "./web" 定义
重启 ComfyUI 服务器
强制刷新浏览器（Ctrl+F5 或 Cmd+Shift+R）
清除浏览器缓存
检查 web/comic_html_preview.js 是否存在

验证：

在浏览器控制台（F12）查看是否有JavaScript错误
检查 viewer_path 输出是否正确
确认HTML文件确实生成在 web/exports/ 目录

2. API密钥配置问题

问题: "Invalid API key" 或认证失败

解决方案：

// 检查 SeedReam4_config.json
{
  "comfly_api_key": "sk-xxxxxxxxxxxxxxxx",  // 确保格式正确
  "comfly_endpoint": "https://api.comfly.ai/v1"  // 确保URL正确
}

验证步骤：

确认API密钥没有多余的空格或换行
检查API密钥是否过期
验证镜像站选择与API密钥匹配
尝试在节点参数中直接输入API密钥测试

3. 网络连接问题

问题: "Connection timeout" 或网络错误

解决方案：

// 增加超时时间
{
  "timeout": 120,  // 从60秒增加到120秒
  "max_retries": 5,  // 增加重试次数
  "retry_delay": 3  // 增加重试延迟
}

其他方法：

切换到其他镜像站（comfly → t8_mirror → volcengine）
检查网络连接和防火墙设置
配置代理（如果需要）
检查API服务状态

4. 图像生成失败

问题：图像生成返回错误或空结果

常见原因：

❌ 提示词违反内容政策
❌ API配额不足
❌ 分辨率设置不支持
❌ 参考图像格式错误

解决方案：

检查提示词是否符合内容政策
验证分辨率设置（推荐使用2K）
确认API余额和配额
查看ComfyUI控制台的详细错误信息

5. 视频生成超时

问题: 视频生成任务长时间无响应

正常情况：

视频生成通常需要 5-15分钟
高分辨率视频可能需要 20-30分钟

解决方案：

减小分辨率（使用720p而不是1080p）
减少时长（使用4秒而不是8秒）
检查任务状态轮询日志
等待至少15分钟后再判断是否卡住

6. 内存不足

问题: 生成大图像或长视频时内存溢出

解决方案：

减小图像分辨率（使用1K而不是4K）
减少批量生成数量（max_images = 1）
减少连环画场景数量（story_length = "short"）
关闭其他占用内存的程序
定期清理 web/exports/ 目录

7. 节点不显示

问题: 安装后在ComfyUI中找不到节点

解决方案：

确认安装位置：ComfyUI/custom_nodes/ComfyUI_Doubao_Seed
安装依赖：pip install -r requirements.txt
检查 __init__.py 是否包含 NODE_CLASS_MAPPINGS
重启 ComfyUI
查看启动日志是否有 "[Doubao-Seed] Plugin loading completed!"

8. PDF导出失败

问题: 连环画批量导出时PDF生成失败

解决方案：

# 安装PDF支持
pip install reportlab

# Windows用户：系统会自动使用 C:/Windows/Fonts/msyh.ttc
# Linux用户：
sudo apt-get install fonts-noto-cjk

# Mac用户：
brew install font-noto-sans-cjk

调试技巧

1. 启用详细日志

在ComfyUI启动时添加 --verbose 参数：

python main.py --verbose

2. 浏览器控制台调试

按 F12 打开开发者工具
切换到 Console 标签查看JavaScript错误
切换到 Network 标签查看网络请求

3. 验证配置文件

使用Python验证JSON格式：

import json
with open('SeedReam4_config.json', 'r') as f:
    config = json.load(f)
    print("配置文件格式正确！")

获取帮助

如果问题仍未解决：

📖 查看文档：
- README.md - 完整使用文档
- 节点使用说明.md - 节点详细说明
- COMIC_BOOK_USAGE_GUIDE.md - 连环画使用指南
🔍 搜索Issues：
- GitHub Issues
📝 提交Issue：
- 提供详细的错误信息
- 包含复现步骤
- 附上ComfyUI控制台日志
- 说明系统环境（OS、Python版本等）
💬 社区支持：
- ComfyUI Discord服务器
- 相关QQ群或微信群

📄 许可证

本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情。

🤝 贡献

欢迎提交问题报告和功能请求！如果您想贡献代码，请：

Fork 本项目
创建功能分支 (git checkout -b feature/AmazingFeature)
提交更改 (git commit -m 'Add some AmazingFeature')
推送到分支 (git push origin feature/AmazingFeature)
创建 Pull Request

📞 支持

如果您遇到问题或需要帮助：

提交 GitHub Issue
查看项目文档和示例
参考故障排除指南

🔄 更新日志

v3.0.0 (最新) - 连环画创作完整解决方案 🎉

📚 连环画创作系统（新增）:

✅ 一键创作: 豆包连环画创作节点，集成文本生成和图像生成
✅ 多种预览: HTML内嵌预览、浏览器预览、分页浏览
✅ 批量导出: 支持PNG/JPG/PDF多种格式导出
✅ 参考图像: 支持最多10张参考图像，智能循环使用
✅ 交互HTML: 生成可翻页的HTML连环画文件
✅ 翻页特效: 支持5种翻页动画效果

🎨 连环画节点（6个新节点）:

✅ 豆包连环画创作: 一键生成完整连环画
✅ 连环画分页浏览: 分页预览连环画
✅ 连环画HTML浏览导出: 生成交互式HTML文件
✅ 连环画HTML内嵌预览: 在ComfyUI界面内预览
✅ 连环画浏览器预览: 在系统浏览器中打开
✅ 连环画批量导出: 批量导出图片和PDF

🔧 技术改进:

✅ WEB_DIRECTORY配置: 正确配置前端资源加载
✅ iframe预览: 完善的HTML内嵌预览功能
✅ 故事结构解析: 支持JSON和格式化文本双格式
✅ 旁白显示修复: 修复HTML中旁白显示问题
✅ 翻页特效优化: 修复参数传递错误

📝 文档完善:

✅ 完整README: 详尽的使用文档和示例
✅ 连环画指南: 专门的连环画创作指南
✅ 故障排除: 详细的问题解决方案
✅ 快速开始: 5分钟快速上手指南

v2.0.0 - Doubao-Seed专注化重构

🎯 项目重构:

✅ 专注化定位: 100%专注于Doubao-Seed功能
✅ 品牌统一: 所有节点统一归类到"Ken-Chen/Doubao"
✅ 代码简化: 移除非核心模块，提升维护性
✅ 性能优化: 更快的启动速度和更少的资源占用

🎨 图像生成功能:

✅ 多图输入: 支持最多5张参考图像
✅ 高分辨率: 支持1K/2K/4K多种分辨率
✅ 批量生成: 一次生成1-15张图像
✅ 多镜像支持: T8镜像站、火山引擎官方API

🎬 视频生成功能:

✅ 基础视频生成: 文本到视频生成
✅ 连续视频生成: 支持连续场景视频
✅ 多图参考视频: 基于参考图像的视频生成
✅ 智能轮询: 自动任务状态检查

📝 文本生成功能:

✅ 豆包大模型: 支持doubao-seed-1-6系列模型
✅ 多模型选择: 标准版和快速版
✅ 灵活配置: 支持温度、top_p等参数调整

历史更新

v1.5.0 - 视频处理增强

新增视频拼接功能，支持8个视频输入
新增视频尾帧提取功能
支持多种拼接布局

v1.4.0 - 稳定性提升

优化视频生成节点
改进任务轮询机制
提升API调用稳定性

v1.3.0 - 多图参考视频

新增多图参考视频生成功能
支持图像序列到视频转换
优化参考图像处理

v1.2.0 - API优化

完善API故障转移机制
新增多镜像支持
改进错误处理

v1.1.0 - 连续视频生成

新增连续视频生成功能
支持场景连续性
优化视频质量

v1.0.0 - 初始版本

基础图像生成功能
基础视频生成功能
T8镜像站支持

📚 相关文档

连环画创作文档

COMIC_BOOK_USAGE_GUIDE.md - 完整使用指南
QUICK_START_COMIC.md - 快速入门
COMIC_TRANSITIONS_GUIDE.md - 翻页特效指南
连环画浏览器预览节点说明.md - 浏览器预览说明
连环画HTML内嵌预览节点说明.md - 内嵌预览说明

技术文档

STORY_STRUCTURE_PARSING_FIX.md - 故事结构解析修复
FORMATTED_TEXT_SUPPORT.md - 格式化文本支持
NARRATION_DISPLAY_FIX.md - 旁白显示修复
TRANSITION_FIX_SUMMARY.md - 翻页特效修复
新功能完成报告.md - 新功能完成报告

测试工具

# 测试JSON解析
python test_story_structure_parsing.py

# 测试格式化文本解析
python test_formatted_text_parsing.py

# 测试旁白显示
python test_narration_fix.py

# 测试HTML生成
python test_html_generation.py

# 诊断连环画解析
python diagnose_comic_parsing.py

🙏 致谢

感谢以下项目和开发者的贡献：

ComfyUI - 强大的AI工作流平台
火山引擎豆包 - 提供强大的Doubao Seedream4模型
FFmpeg - 视频处理核心库

🌟 特别说明

本项目专注于Doubao生态系统，致力于为用户提供：

🎯 专业品质: 基于火山引擎豆包大模型的高质量生成
🚀 高效稳定: 优化的API调用和任务处理机制
🔧 易于使用: 简洁的节点设计和清晰的参数配置
📈 持续优化: 专注于Doubao功能的持续改进和优化

⚠️ 重要提示:

使用本项目需要有效的Doubao API密钥
请遵守火山引擎豆包的使用条款和限制
建议在生产环境使用前进行充分测试
视频生成功能需要较长处理时间，请耐心等待

💡 提示: 如果您觉得这个项目有用，请给我们一个⭐星标支持！

🔗 相关链接:

💖 Support the Project

☕ Buy Me a Coffee

If you find ComfyUI Doubao-Seed helpful and it has made your AI content creation projects easier, consider supporting the development!

💝 Your support helps:

🚀 Accelerate new feature development
🧠 Enhance AI capabilities
🔧 Improve system stability
📚 Create better documentation
🌍 Support the open-source community

<div align="center"> <table> <tr> <td align="center" width="50%"> <h3>💬 WeChat Contact</h3> <img src="wechat_qrcode.png" alt="微信二维码" width="280"/> <p><em>Scan to add WeChat 扫码添加微信</em></p> <p><strong>WeChat ID: Kenchen7168</strong></p> </td> <td align="center" width="50%"> <h3>☕ Support Development</h3> <img src="wechat_pay_qrcode.png" alt="微信收款二维码" width="280"/> <p><em>Scan to buy me a coffee 扫码请我喝咖啡</em></p> <p><strong>💝 Every coffee counts! 每一杯咖啡都是支持！</strong></p> </td> </tr> </table> </div>

🙏 Thank you for your support!

Your contributions, whether through code, feedback, or coffee, make ComfyUI Doubao-Seed better for everyone!

谢谢您的支持！无论是代码贡献、反馈建议还是请我喝咖啡，都让ComfyUI Doubao-Seed变得更好！

🌟 贡献者

感谢所有为这个项目做出贡献的开发者！

<div align="center"> <p><strong>Made with ❤️ by Ken-Chen</strong></p> <p>© 2024 ComfyUI Doubao-Seed. All rights reserved.</p> <p> <a href="https://github.com/Ken-Chen/ComfyUI_Doubao_Seed">GitHub</a> • <a href="https://github.com/Ken-Chen/ComfyUI_Doubao_Seed/issues">Issues</a> • <a href="https://github.com/Ken-Chen/ComfyUI_Doubao_Seed/discussions">Discussions</a> </p> </div>