
灿海星图指南--27个Agent生成韩漫,5分钟上手
它是一个"AI帮你管整个漫画生产线"的系统,不是"AI帮你画"的工具。
本文是一篇实操指南。已核实 GitHub 仓库存在(7月1日数据,213星,MIT协议)。
这是什么?
webtoon-harness 是一个用 AI Agent 自动制作韩漫的开源项目。27 个 Agent 分 4 队协作,覆盖从选题到出成品的全流程。
项目发布 3 天获 213 星,70+ fork。这不是又一个"AI绘画"玩具——它把漫画生产拆成一套可复现的工业流程:调研→剧本→视觉→组装,每步有专门的 Agent 团队+质检 Gatekeeper。
流水线:27个Agent分4队
调研: 趋势分析 → 剧本: 概念/世界/角色/系列 → 视觉: 50+格渲染 → 组装: 竖屏阅读器+QA
4 队分工:
| 团队 | Agent数 | 职责 | 关键输出 |
|---|---|---|---|
| 调研 | 5 | 流派趋势、平台排行、读者反应、钩子反推 | 企划简报 |
| 剧本 | 9 | 概念构建→世界→角色→系列弧→反转→大本 | 每话 50+ 面板完整脚本 |
| 视觉 | 8 | 风格圣经→参考表→面板渲染(并行5张)+6轴验证 | 50+ 面板 PNG(含气泡嵌入) |
| 组装 | 5 | 竖排阅读器、QA、连续性管理、最终签名 | RELEASE/ep{NN}/ 目录 |
核心操作
这个项目是一个 Claude Code harness,它的入口不是 python main.py,而是一个 .claude/ 目录。
1. 部署到你的项目
git clone https://github.com/revfactory/webtoon-harness
cp -r webtoon-harness/.claude /path/to/your-project/
cd /path/to/your-project
2. 启动 Claude Code
在项目目录下启动 Claude Code。然后在对话中输入:
"根据当前韩漫趋势,帮我生成一话 webtoon"
webtoon-orchestrator 技能会自动触发,调度 27 个 Agent 从调研到出成品。
3. 常用命令
| 你想做什么 | 在 Claude Code 中说 |
|---|---|
| 完整流程 | "根据当前趋势做一话 webtoon" |
| 续写下一话 | "接着上一话的世界观和风格,做第 2 话" |
| 重写部分 | "第 23 个面板重新渲染" |
| 改剧情 | "这一话的反转不够强,改一下" |
4. 需要什么
- Claude Code CLI:Agent + Skill 执行环境
- codex CLI:面板图像并行渲染用(需要 ChatGPT OAuth 登录)
- codex 的并发限制:全局最多 5 个并行会话
踩坑实录
坑 1:以为 pip install 就能跑
现象:README 没有 requirements.txt,没有 setup.py。
原因:项目不是 Python 应用,是 Claude Code harness。main.py 不存在。
解决:不要找入口脚本。cp .claude/ 到你的项目里,然后启动 Claude Code。
坑 2:codex CLI 不工作
现象:visual 团队渲染面板时卡住。
原因:codex CLI 需要 ChatGPT OAuth 登录,且并发不能超过 5 个。codex exec 的 image_generation tool 是新功能,不是所有人都开通了。
解决:先测试 codex exec 能否生成图片,确认 OAuth 有效。然后检查 .claude/skills/webtoon-panel-render/ 里的并发配置,把 batch size 降到 3。
坑 3:生成的角色前后不一致
现象:第 1 话的黑发角色,第 2 话变成棕发了。
原因:ref-sheet-artist 生成的参考表(character reference sheet)没有在后续 session 中被正确传递。
解决:确保每次开始新 session 前,把上一轮的 _workspace/ 目录保留。在 Claude Code 中指定:"使用之前的角色参考表,角色连续性从上一话继承。"
常见疑问
Q1:需要 GPU 吗?
不需要。渲染依赖 codex CLI 的云端图像生成,本地不需要显卡。调研和剧本走的是 Claude Code 的 LLM 调用。
Q2:生成一话要多久?
调研约 2-5 分钟,剧本约 3-5 分钟,50+ 面板并行渲染约 10-20 分钟(取决于 codex 并发和排队)。一话从启动到出成品大约 20-30 分钟。
Q3:中文/英文韩漫能做吗?
项目默认生成韩文,但 prompt 都是英文写的。把 trend-scout、scenario 等 Agent 的指令改成中文,渲染 prompt 里加上"Chinese text",就可以做中文条漫。英文同理。
能做什么,不能做什么
- 生成完整韩漫竖屏内容 ✅
- 从零开始全自动生产 ✅
- 27个Agent协作,含质检Gatekeeper ✅
- 替换专业漫画家 ❌(质量达不到人手画的标准,但适合快速原型和批量试错)
- 生成质量稳定的长篇连载 ❌(连续性管理还在完善中)
上手体验
我拿"神话修仙"题材试了一话。调研 Agent 给出了 Naver Webtoon 近期的 TOP10 趋势,分析说"修仙+系统流"目前在韩国有上升趋势。剧本生成了一个转世修仙的故事结构,4 章大纲。50+ 面板从 prompt 到渲染花了约 18 分钟,成品画面风格偏日韩系 webtoon,人物表情和对话气泡的 in-image 渲染效果不错。不过角色在不同面板的角度确实有轻微不一致,就是第 3 坑留的问题。
本文数据来源于 GitHub 公开仓库(revfactory/webtoon-harness,MIT协议),数据截至 2026-07-01。