Agent无限创作 · 本地全链路漫剧/短视频创作 Agent 解决方案

一、项目介绍

把小说/剧本全自动生成带语音的漫剧/短视频成片，不限时长。本地跑通「ComfyUI（MiniMax H3 视频 + Qwen-Image 2.1 文生图/图生图 + Krea2 + Qwen3-TTS）+ Agent + Skill」的全链路。

核心流程（也是本方案可复刻的方法论）：

小说/剧本/想法
  → 剧本 + 大纲
  → 人物圣经（bible）+ 风格指南（style）   ← 一致性锚点
  → 人物/场景/道具/语音资产生成
  → 分镜脚本（长镜头聚合，不拆碎）
  → 逐镜视频（MiniMax H3 Ref2VA，参考图 + 参考音 → 带语音视频）
  → 自审重试
  → ffmpeg 合并成片

核心能力：无限视频时长、自动分镜、项目隔离、人物一致性（canonical 参考图跨镜复用）、技能系统、自迭代技能工厂（工作流 → 技能）、断点续跑、分镜级审查/重生成、分阶段运行、显存维护、在线预览。

技术栈：Node.js（Next.js 自定义 server）+ node:sqlite + ComfyUI REST/WebSocket + ffmpeg；Agent 自研 ReAct 循环；前端 Next.js 15 + React 18。

二、快速启动（启动本项目）

前置要求

安装 / 配置 / 启动 / 验证

git clone https://github.com/SwotAtmk/infinite-creation.git
# 国内加速使用：https://gitcode.com/SwotAtmk/infinite-creation.git
cd infinite-creation
pnpm install            # 自动构建 Agent 内核（首次较慢，需 bun）
pnpm run install:skills # 可选：拉取 MiniMax-H3 官方技能（仓库已含离线快照）

cp config.example.json config.json   # 填 llm.apiKey 与 comfyui.baseUrl
pnpm run dev                          # 单端口 4600，打开 http://127.0.0.1:4600
pnpm test                             # 单元测试
curl http://127.0.0.1:4600/api/health # 期望 {"ok":true}

常见问题

• 「未检测到 bun」→ 先装 Bun（https://bun.sh）
• Agent 内核构建失败 → pnpm run build:agent
• 生成不了图片/视频 → 确认 ComfyUI 已启动且 comfyui.baseUrl 正确
• 端口占用 → 改 config.json 的 server.port 或设 PORT

三、全链路流程（可脱离本项目复刻的方法论）

本节是核心方案。不启动本项目时，Agent 可照此流程 + skills/ 技能库，在任意环境实现同样的「小说 → 视频」。

四阶段调度（本项目内由生成页勾选；复刻时按同样顺序编排）：

分步约定（与 skills/novel-to-video/SKILL.md 一致）：

1. 剧本/大纲：输入小说或想法 → 产出 title/logline/characters/scenes/props/storyboard 大纲 JSON。
2. 一致性锚点：bible.md（每个角色唯一外貌/配色/声音 + 衣橱）+ style.md（统一画风/光线/色调/镜头语言）。
3. 资产生成：先加载 image-prompt-writing 写图片提示词、tts-voice-design 写音色参数，再统一批量提交（文生图人物/场景/道具，图生图换装/年龄变体，TTS 音色）。
4. 分镜脚本：加载 story-pipeline-cn 按「长镜头聚合」拆分（同一场景连续动作+多句对白合并，禁止一句一镜），字段含景别/运镜/光线/画面/对白/sub_shots 时间轴。
5. 视频提示词：加载 h3-prompt-writing，逐镜写 __MINIMAX_H3_REF_N__ 参考标签 + 英文平铺提示词，再整章批量生成。
6. 自审重试：逐镜自审、失败重试。
7. 合并导出：ffmpeg 合并成片。

四、技能库与使用规范

技能发现与加载

• 技能库在 skills/ 目录：每个子目录一份 SKILL.md（YAML frontmatter：name + description）+ 可选 references/（细分规范）。
• 本项目内加载：skill(name) 读技能正文，skill_reference(name, ref) 读单个参考文件。
• 脱离本项目时：直接把 skills/ 当作可移植技能包使用（每个 SKILL.md 自带触发条件与执行步骤）。
• 路由规则：按任务关键词路由到对应技能；未命中时默认走 novel-to-video（总流水线）。

核心流程技能（5 个，必读）

其余技能库（按类别）

• 剧本/编剧：0715-scriptwriter、script-master、novel-to-skitscreenplay、novel-to-storyboard、hf-drama-storyboard-script。
• 漫剧创作：manga-drama-generator、manju-director-agent、ai-manga-planner、comic-drama-generator、manga-full-stack、script-to-manga、cinematic-ai-comic-director、micro-drama-creator。
• 一致性/其它类型：era-consistency-optimizer（年代一致）、3d-animation-short-generator、papercraft-stop-motion-explainer、paper-collage-explainer-generator、music-video-subtitle-generator、minimalist-product-ad-generator、handdrawn-live-video-generator、co-op-game-intro-generator、brand-promo-video-generator。

（完整 27 个技能以 skills/ 目录实际为准，每个 SKILL.md 的 frontmatter description 是权威触发条件。）

五、自定义工作流接入

用户若有自己的 ComfyUI 工作流，可按四类 kind 接入，替代默认工作流：

工作流规格（Workflow Spec）

每个工作流用一个「规格」描述如何往 ComfyUI JSON 里写参数。核心字段：

• roles：语义角色 → { node, field, map? }。常见角色：positive_prompt/negative_prompt/width/height/seed/seconds/resolution/aspect_ratio/image/text/voice_description/filename_prefix；map 用于枚举值翻译（如 '16:9' → '16:9 (Widescreen)'）。
• media（可选，r2v 必需）：参考素材绑定 —— targetNode + mediaField/fieldsByType + loaders（LoadImage/LoadAudio/LoadVideo）+ reusePool + maxImages(≤9)/maxAudioVideo(≤3)。
• outputs：产物节点类（SaveImage/SaveVideo/SaveAudio/SaveAnimatedWEBP…）。
• prune：需删除的节点 id（模板自带硬编码占位参考图/音、被覆盖的 LLM 改写链）。

参考示例见 lib/core/workflow-specs.js 的 DEFAULT_SPECS（内含 MiniMax H3 r2v、Qwen-Image 2.1/Krea2 t2i、Qwen-Image-Edit i2i、Qwen3-TTS tts 的完整规格）。

两种接入方式

方式 A · 启动本项目（推荐，自动）：工作流页粘贴 ComfyUI 工作流 JSON → 「分析节点/角色」→「注册工作流 + 生成技能」。系统会：解析节点（加载器/提示词/尺寸/种子/保存）→ 推导规格 → 注册到 workflows/ + DB → 调用 LLM 起草 SKILL.md 并安装为可路由技能 → Agent 立即可当新「工作模式」调用。

方式 B · 不启动本项目（Agent 手工映射）：Agent 按上方「工作流规格」字段，把用户提供的 ComfyUI JSON 手动整理成规格（roles/media/outputs/prune），再复刻 workflow-runner 的「克隆模板 → 写 roles 参数 → 绑定 media 参考 → prune 无效节点 → 提交 ComfyUI」流程。解析逻辑参考 analyzeWorkflow()（识别 LoadImage/LoadAudio/LoadVideo、Save*、KSampler、prompt/text 字段、seed、尺寸）。

六、使用方式小结

• 要跑本项目：见「二、快速启动」。
• 要脱离本项目、在自己 Agent 里实现同样方案：读「三、全链路流程」+ 用「四」的 skills/ 技能库，按五接入自己的工作流。
• 要用自己的文生图/图生图/视频/语音工作流：见「五、自定义工作流接入」。