Toonany - AI漫剧创作助手#

Toonany helps anyone turn any story into an AI-generated short drama through a guided production pipeline.

核心理念: Any story, any style, anyone.

快速开始（新手推荐）#

从未用过？只需两步：

1. 创建项目: /toonany new 我的漫剧
2. 快速出片: /toonany quick（跟随引导完成全部流程）

命令列表#

通用命令#

命令说明/toonany new <name>创建新项目，交互式配置/toonany config检查/配置 API 密钥，缺失时自动引导/toonany validate运行全量校验（结构 + 一致性）/toonany export导出完整项目

快速模式#

命令说明/toonany quick单命令交互式全流程，30分钟出片

专业模式（分阶段精细控制）#

命令说明/toonany story生成/修改故事线/toonany outline [ep]生成/修改分集大纲/toonany assets提取/生成角色、场景、道具资产/toonany style-sample生成风格样张，确认后再批量生产/toonany script [ep]生成剧本/toonany storyboard [ep]生成分镜/toonany storyboard-image [ep]生成分镜图/toonany video [ep]生成视频/toonany audio [ep]生成配音和字幕/toonany finalize [ep]后期合成（拼接+混音+字幕烧录）

前置检查（自动执行）#

执行任何命令前，Toonany 会自动检查：

1. 项目存在: 是否在有效的 toonany 项目目录中？

2. API 配置: 当前步骤所需的模型 API Key 是否已配置？

   • 未配置 → 自动引导: 告诉用户去哪里申请、怎么设置

3. 上游依赖: 当前步骤所需的输入文件是否存在？

   • 不存在 → 提示用户先完成上游步骤

4. 变更传播: 上游文件是否已更新？

   • 已更新 → 提示用户下游产物可能已过期，建议重新生成

生产流程#

text

小说原文 → 故事线 → 大纲 → 资产 → 风格样张 → 剧本 → 分镜 → 分镜图 → 视频 → 音频/字幕 → 成片
   1)       2)      3)     4)       5)          6)      7)       8)         9)       10)          11)

快速模式流程#

text

/toonany quick
  → 询问小说内容
  → 询问风格/比例/集数
  → 自动生成故事线 + 大纲（第1集）
  → 自动生成资产
  → **生成风格样张 → 用户确认**
  → 批量生成分镜图
  → 生成视频
  → 生成音频/字幕
  → 后期合成输出成片

专业模式流程#

用户逐步控制每个阶段，每步可审、可改、可回退。

数据模型#

Project#

json

{
  "name": "项目名称",
  "type": "都市/古风/悬疑/科幻",
  "artStyle": "2D动漫风格/真人写实/吉卜力",
  "videoRatio": "16:9/9:16/1:1",
  "episodeCount": 12,
  "styleReference": "assets/style-sample.jpg",
  "versions": {},
  "models": {
    "text": { "provider": "deepseek", "model": "deepseek-chat", "apiKey": "${DEEPSEEK_API_KEY}" },
    "image": { "provider": "volcengine", "model": "doubao-seedream-4-5", "apiKey": "${VOLC_API_KEY}" },
    "video": { "provider": "kling", "model": "kling-v1-pro", "apiKey": "${KLING_API_KEY}" },
    "audio": { "provider": "volcengine", "model": "...", "apiKey": "${VOLC_TTS_API_KEY}" }
  },
  "characters": [
    {"name": "角色名", "seed": 12345, "voiceType": "...", "consistencyId": "..."}
  ]
}

项目结构#

text

output/{project-name}/
├── project.json              # 项目元数据
├── storyline.md              # 故事线
├── outline/
│   ├── outline-01.md         # 第1集大纲
│   └── ...
├── assets/
│   ├── characters.md         # 角色资产（详细描述）
│   ├── props.md              # 道具资产
│   ├── scenes.md             # 场景资产
│   ├── data.json             # 资产数据（程序格式）
│   ├── images/
│   │   ├── characters/       # 角色四视图 + 单张
│   │   ├── props/            # 道具图
│   │   └── scenes/           # 场景图
│   └── style-sample.jpg      # 风格样张
├── script/
│   ├── script-01.md          # 第1集剧本
│   └── ...
├── storyboard/
│   ├── storyboard-01.md      # 第1集分镜
│   └── images/               # 分镜图
├── video/
│   └── ep01-*.mp4            # 生成的视频片段
├── audio/
│   └── ep01/                 # 音频文件
├── subtitle/
│   └── ep01.srt              # 字幕文件
└── final/
    └── episode01.mp4         # 最终成片

新手引导#

第一次使用？#

1. 执行 /toonany new 我的项目
2. 系统会创建项目并检查 API Key
3. 如果缺少 API Key，会自动显示引导信息：
   • 告诉你需要哪些 provider
   • 提供申请链接
   • 告诉你怎么设置环境变量
4. 配置完成后，执行 /toonany quick 开始创作

缺少 API Key 时的引导示例#

text

检测到缺少图像生成 API Key（火山引擎）。

请按以下步骤配置：
1. 访问 https://console.volcengine.com/ark/ 注册账号
2. 开通方舟大模型服务
3. 创建 API Key
4. 在终端执行: export VOLC_API_KEY=你的密钥

配置完成后，请告诉我"已配置"，我会继续。

质量保障#

自动化检查#

• 结构校验: 检查项目目录和必需字段
• 一致性校验: 检查角色名、场景名、道具名在全文中是否一致
• 风格漂移检测: 对比不同阶段的风格描述是否一致

风格锚定#

每部漫剧必须有1张 风格样张 作为视觉锚点。所有后续生成强制引用该样张，确保风格统一。

角色一致性#

每个角色生成 四视图参考图（正面、侧面、背面、特写），记录 seed 值。后续生成时复用 seed 和参考图，最大限度保持角色外观一致。

模型配置#

支持的 provider：

类型Provider用途textdeepseek, openai, anthropic, gemini故事线、大纲、剧本imagevolcengine, kling, gemini资产图、分镜图videokling, volcengine, vidu, gemini视频生成audiovolcengine, aliyun, edge-tts配音

在 project.json 的 models 字段中配置。API Key 推荐使用环境变量： ${ENV_VAR_NAME}。

参考资料#

• 详细教程 - 完整使用指南
• 数据模型 - 完整数据结构
• 生产流程 - Pipeline详解
• 模型配置 - AI模型配置指南
• 命令参考 - 完整命令说明