这是一个面向中文故事短视频生产的 Remotion 渲染器与 Agent Skill 项目，可将中文故事文案或按顺序上传的手绘/漫画图片转换为 3:4 竖屏手绘日记漫画动画。输出为静音 H.264 MP4 画面轨，默认包含手写体字幕、文字到黑白画稿再到彩色插画的左到右揭示动画，并支持右下角卷页翻书转场。项目重点不是完整视频发布系统，而是为后期配音、配乐、剪辑提供可复用的画面素材。
适用领域
AI 视频生成 / 中文故事可视化 / 短视频内容生产 / Remotion 动画渲染 / Agent Skill / 自动化工作流 / 漫画 / 手绘风格内容 / 教育、绘本、日记漫画、情感故事视频
配置难度
中等。对于熟悉 Node.js、npm、FFmpeg 和 Remotion 的开发者，上手难度不高；但对于纯内容创作者，需要先配置本地开发环境、Agent Skill 目录和可能的图片生成工作流，因此存在一定技术门槛。二次开发动画组件和渲染逻辑则需要掌握 React/Remotion 和视频渲染基础。
商业价值
该项目适合用于搭建中文故事短视频的半自动化生产流水线，尤其适合情感故事、儿童绘本、日记漫画、知识科普小故事等内容形态。它的商业价值在于降低从文案到可剪辑画面轨的制作成本，并通过 Agent 自然语言工作流提升批量生产效率。对于 MCN、自媒体团队、教育内容团队或 AI 视频工具开发者，可作为原型或内部生产工具进行二次开发。不过，它目前更像渲染器和工作流组件，而非完整 SaaS 产品，若要商业化还需补齐账号系统、任务队列、素材版权管理、音频生成、内容审核、云端渲染和成片发布等能力。
01
技术亮点
- 对中文故事场景友好，支持自动分句、动态分镜，并强调保留原文措辞。
- 提供自然语言驱动的 Agent Skill，用户不必直接理解和调用复杂脚本。
- 基于 Remotion，适合开发者二次定制动画、分镜、转场和渲染逻辑。
- 输出为静音画面轨，便于后期独立添加配音、音乐和音效。
- 支持两种输入模式：故事文本生成动画，以及有序图片合成动画。
- 动画风格明确，包括手写字幕、黑白画稿层、彩色插画层和左到右揭示效果。
- 提供正式版 1080×1440 和预览版 720×960，适合先审片再高质量导出。
- 支持右下角卷页翻书转场，适合漫画页、绘本页、日记本风格内容。
- MIT 协议，便于商业项目集成和二次开发。
- 随附字体和示例结构，项目目录清晰，包含 src、scripts、skill-package、examples、references 等模块。
02
目标用户
- 中文短视频创作者
- 需要批量生产故事类视频的自媒体团队
- 使用 Codex、Claude Code、Kimi Code 等 Agent 的开发者
- 希望用 Remotion 搭建自动化视频渲染流水线的前端/全栈开发者
- 绘本、漫画、儿童故事、情感故事类内容运营人员
- 需要把现有图片页制作成翻页动画或竖屏视频的内容团队
03
配置要求
- Node.js 20+
- Python 3.10+
- npm
- FFmpeg，且 ffmpeg、ffprobe 必须在 PATH 中可用
- Google Chrome 或 Remotion 管理的兼容浏览器
- 支持 Skill 的 Agent 运行时，如 Codex、Claude Code、Kimi Code 等
- 可选环境变量 STORY_VIDEO_PROJECT，用于指定渲染器项目绝对路径
- 默认使用 Codex Image2 工作流生成图片；如果明确选择 OpenAI API 工作流，则需要配置 OPENAI_API_KEY
- 输入文本建议使用 UTF-8 编码；如需精确控制节奏，可按句分行
- 输出目录默认为 out/，正式文本故事输出 out/picture_silent.mp4，预览输出 out/picture_silent-preview.mp4，上传图片模式输出 out/uploaded_picture_silent.mp4 或 out/uploaded_picture_silent-preview.mp4
04
适用场景
- 将一段中文故事文案自动拆句、分镜并生成竖屏手绘动画画面轨
- 把一组已生成或人工绘制的图片按顺序合成为静音 MP4
- 生成适合后期配音、加 BGM、加字幕包装的短视频底片
- 为抖音、快手、视频号、小红书等平台制作 3:4 竖屏故事漫画视频
- 通过 Agent 自然语言指令驱动视频生成流程，减少手动运行脚本的成本
- 制作带右下角卷页效果的漫画翻页视频
- 快速输出 720×960 预览版，确认节奏和画面后再渲染 1080×1440 正式版
05
部署与配置
- 安装 Node.js 20 或更高版本、Python 3.10 或更高版本、npm、FFmpeg，并确保 ffmpeg 和 ffprobe 可在终端直接调用。
- 安装 Google Chrome，或使用 Remotion 可管理的兼容浏览器。
- 克隆仓库：git clone https://github.com/gnipbao/story-to-handdrawn-video.git
- 进入项目目录：cd story-to-handdrawn-video
- 安装依赖：npm ci
- 执行检查：npm run check，该命令会进行 TypeScript 检查和分镜结构校验。
- 将 skill-package/story-to-handdrawn-video 复制到对应 Agent 的 skills 目录，例如 Codex 使用 ~/.codex/skills/，Claude Code 使用 ~/.claude/skills/，Kimi Code 使用 ~/.agents/skills/。
- 如果 Agent 不在项目根目录内运行，需要设置环境变量 STORY_VIDEO_PROJECT 指向该项目绝对路径。
- 通过支持 Skill 的 Agent 使用自然语言调用，例如“使用 $story-to-handdrawn-video 把这段故事生成可后期配音的手绘动画”。
06
风险与注意事项
- 项目依赖 Agent Skill 工作流，若使用者没有 Codex、Claude Code、Kimi Code 等支持 Skill 的环境，体验会打折。
- 图片生成质量取决于所使用的图像生成能力，例如 Codex Image2 或 OpenAI API，仓库本身主要负责渲染和编排。
- 默认输出无配音、无音乐，不能直接作为完整成片发布，仍需要后期音频制作。
- 涉及 Remotion、FFmpeg、Chrome、Node、Python 等多组件环境，对非技术用户有一定安装门槛。
- 中文故事自动分句和分镜可能在复杂叙事、时间跳跃、指代不明、医疗场景、年龄敏感角色等场景下需要人工审核。
- 正式渲染 1080×1440 视频可能消耗较多 CPU、内存和磁盘空间，批量生产时需要关注性能。
- 如果走 OpenAI API 工作流，需要额外承担 API 成本和密钥管理风险。
- README 中强调的是 Skill 约定和渲染流程，实际商业生产还需要补充素材审核、版权检查、内容安全和发布链路。
2026-07-28
第8名
新收录 · github_search
2026-07-27
第8名
新收录 · github_search
2026-07-26
第8名
新收录 · github_search
2026-07-25
第9名
新收录 · github_search
2026-07-24
第12名
新收录 · github_search
2026-07-23
第19名
新收录 · github_search
