产品简介
story-shot-agent PenShot是一个基于LangGraph和LLM的智能剧本分镜工具，能自动解析任意格式剧本，生成Sora、Veo等AI视频模型可用的连贯提示词。它解决了剧本过长、角色一致性难保、手动提示工程耗时等痛点，适合电影、动漫、短剧创作者和AI视频生成用户。
核心功能
- 智能剧本解析：自动识别场景、对话和动作
- 精确时间规划：按AI模型限制智能分段时长
- 连续性保证：多级记忆和向量检索确保跨片段一致
- 高质量提示词输出：生成中英双语视觉描述和负面提示词
- 多模型兼容：支持OpenAI、Qwen等多种LLM
快速开始
- 第一步：使用命令 `pip install penshot` 安装工具
- 第二步：复制 `.env.example` 为 `.env` 文件并配置LLM和Embedding参数
- 第三步：通过Python SDK导入API并调用函数生成分镜提示词
界面预览
与其他方案对比
| 对比项 | story-shot-agent | 同类方案 |
|---|---|---|
| 剧本长度处理 | 智能分块，严格遵守AI视频模型时长限制 | 手动分割，易出错且耗时 |
| 角色一致性维护 | 多级记忆和向量检索自动维护上下文 | 依赖人工检查，效率低且易不一致 |
| 提示词工程效率 | 自动生成双语描述、负面提示词和音频提示 | 手动编写，费时费力 |
适合谁用
- 电影导演，需要将剧本转换为AI视频分镜
- 动漫创作者，制作动画分镜时保持角色一致性
- 短剧编剧，快速生成AI视频提示词用于预览
下载与版本
当前最新版本为 v0.3.6，发布于 2026-07-23。支持 Windows、macOS、Linux。
⚠️ 注意：本项目仅提供源代码下载，不包含可直接运行的安装包（exe/dmg/apk 等。下载后需要自行编译构建才能使用，适合有一定开发经验的用户。如果你不熟悉编译流程，建议寻找同类开箱即用的替代方案。
注意事项
- 本工具仅供学习和研究使用，请遵守相关法律法规。
- 请尊重内容创作者版权，勿将下载内容用于商业或非法传播。
- 项目源码地址：https://github.com/neopen/story-shot-agent