Toonflow实战演练：导入小说、提取章节事件，5分钟开始你的第一次AI剧本改编-平芜编程栈

Toonflow实战演练：导入小说、提取章节事件，5分钟开始你的第一次AI剧本改编

【免费下载链接】Toonflow-appToonflow 是开源一站式 AI 短剧创作工具，将小说、剧本快速转化为动画短剧。集成 AI 编剧、智能分镜、角色与视频生成，跨平台桌面端轻量部署，助力创作者低成本批量产出视觉内容。Toonflow is an open-source AI tool that turns stories and scripts into animated short dramas. Features AI scriptwriting, storyboarding, character and video generation. A cross-platform desktop app for efficient content creation.项目地址: https://gitcode.com/gh_mirrors/to/Toonflow-app

Toonflow 是一款开源的一站式 AI 短剧创作工具，能把小说、剧本快速转化为动画短剧。本篇带你完成第一次实操：新建项目、导入小说原著、用 AI 提取章节事件，为后续的 AI 剧本改编打好地基。全程无需编写代码，跟着做大约 5 分钟即可跑通。

准备工作：安装并启动 Toonflow

先确认你的电脑已安装 Node.js（项目基于 TypeScript + Node.js + Electron 构建）。

一键安装步骤：

克隆仓库到本地：
git clone https://gitcode.com/gh_mirrors/to/Toonflow-app
进入目录并安装依赖、启动开发版（详见 package.json 中的 scripts 配置）：
yarn install yarn dev
启动后使用默认账号登录：admin/admin123。

💡 不想自己搭环境？也可以直接拉取官方 Docker 镜像运行，构建配置见 Dockerfile。

启动成功后，你会进入「我的项目」页面，看到已创建的项目卡片列表：

左侧导航栏包含「项目」「剧本」「素材」等入口，整个流程就是沿着这条主线走：项目 → 原著 → 事件 → 剧本 → 分镜 → 成片。

新建项目并导入小说章节

点击页面右上角「＋新建项目」，为项目取一个名字（例如小说书名），并选择一种美术风格（如realpeople_urban_modern现代都市真人风）。项目创建后会自动跳转到该项目的「原文管理」页签。

在原文页签中，你可以：

粘贴/上传小说章节文本：按「集数-卷-章节-正文」的结构录入内容
批量导入：一次性粘贴多章内容，系统会按章节自动切分入库
AI 正则识别：如果你的文本带「第X集」「第X章」这类分隔标记，工具可以借助 AI 自动学习出章节切分规则，实现智能拆分（相关逻辑见 getAiRegex.ts）

提交后，每章原文都会写入数据库并附带一个初始的eventState: 0状态位，等待事件提取——这是整个改编流程的关键起点，实现代码位于 addNovel.ts。

一键提取章节事件：AI 自动读懂你的小说

这是 Toonflow 最核心的功能之一——章节事件图谱驱动改编。它会把每一章的剧情自动归纳成结构化的「事件摘要」，之后生成剧本时，Agent 就按这张事件图谱精准调用上下文，避免长文本喂给大模型时出现的信息丢失。

在原文列表中选中章节，点击「生成事件」（也可勾选多章批量生成）。后台会：

读取事件提取的 Prompt 模板（可在设置中自定义，模板定义在 src/lib/vendor.json 的 prompt 区段）
以默认5 并发逐章调用大模型，把章节内容压缩成事件摘要
每完成一章，实时更新章节上的事件状态与摘要文本

核心处理逻辑在 cleanNovel.ts，这里用了一个信号量式的并发池，既保证多章同时处理的速度，又避免把 API 打爆：

⏳小贴士：章节较多时生成需要一些时间，你可以随时通过事件状态查询接口（getNovelEventState.ts）查看每章的完成进度；失败章节会记录errorReason，单独重试即可。

生成完成后，每章下方会展示一段精炼的事件摘要，例如「女主发现家产被侵占 → 连夜搜集证据 → 与管家摊牌」这样的关键剧情链。这些事件后续会在 getEvent.ts 中按名称聚合、分页检索，供剧本 Agent 按需取用。

下一步：让 ScriptAgent 开始改编剧本

事件提取完成后，你的小说已经变成了一张「剧情地图」。接下来切到项目顶部的「剧本」页签，进入 ScriptAgent 对话界面，依次让它完成：

故事骨架生成：确定整部短剧的集数结构与主线
改编策略规划：明确核心改编原则、要删除/保留的戏份
结构化剧本输出：按事件图谱逐集写出分场剧本

剧本阶段使用的智能体提示词都以 Markdown Skill 文件形式外化，方便你随时调整「导演风格」，例如叙事决策策略见 script_agent_decision.md、改编执行规范见 script_execution_adaptation.md。

剧本生成后，就进入 ProductionAgent 的无限画布：上传或生成角色、场景素材，编排分镜并批量生成视频——从文字到片子的完整闭环就打通了 🎬。

常见问题速查

问题	解决办法
章节切分不准	使用「AI 正则识别」功能，让模型学习你的章节标记格式
某章事件生成失败	查看失败原因后单独重跑该章，无需整批重试
事件摘要太长/太短	在设置-提示词管理中调整`eventExtraction`模板
首次运行慢	本地 ONNX 向量模型首次加载需要初始化，耐心等待即可