# story-shot-agent

> 剧本分镜智能体（PenShot）：剧本→分镜→片段→prompt | 基于 LangGraph+LLM，自动解析任意格式剧本，生成 Sora/Veo/Runway 等模型可用的连贯text-to-video提示词。保持角色/剧情跨片段一致，支持 MCP/REST API/函数调用 | Python库 + A2A集成。（LLM-powered screenplay-to-video-prompt a

- **URL**: https://www.freshcrate.ai/projects/story-shot-agent
- **Author**: neopen
- **Category**: MCP Servers
- **Latest version**: `main@2026-05-21` (2026-05-21)
- **License**: NOASSERTION
- **Source**: https://github.com/neopen/story-shot-agent
- **Homepage**: https://pengline.cn/2026/02/7e6cd67dd5ee45248f2276ac145555f5/
- **Language**: Python
- **GitHub**: 52 stars, 11 forks
- **Registry**: github (`neopen/story-shot-agent`)
- **Tags**: `agent-to-agent`, `ai-filmmaking`, `ai-video-generation`, `character-consistency`, `function-calling`, `kling-ai`, `langgraph-agent`, `llm-agent`, `python`

## Description

剧本分镜智能体（PenShot）：剧本→分镜→片段→prompt | 基于 LangGraph+LLM，自动解析任意格式剧本，生成 Sora/Veo/Runway 等模型可用的连贯text-to-video提示词。保持角色/剧情跨片段一致，支持 MCP/REST API/函数调用 | Python库 + A2A集成。（LLM-powered screenplay-to-video-prompt agent. Break scripts into Sora/Veo-ready shots with character consistency. LangGraph + Chroma + MCP）

## Recent releases

| Version | Date | Urgency | Changes |
| --- | --- | --- | --- |
| `main@2026-05-21` | 2026-05-21 | High | Latest activity on main branch |
| `v0.2.4` | 2026-04-21 | High | Latest release: v0.2.4 |
| `main@2026-04-21` | 2026-04-21 | High | Latest activity on main branch |
| `v0.2.3` | 2026-04-06 | Medium | - langchain、LLM 及相关依赖版本升级，提高稳定性 - 优化工作流重试机制，避免无限循环 - 添加剧本ID，根据剧本分类记忆，节省token和内存 - 支持自定义视频风格参数 - 优化其他已知异常 - 解决一般标准性问题 |
| `v0.2.2` | 2026-04-01 | Medium | - 统一标准化客户端接口 - 优化工作流逻辑和基类接口 - 引入嵌入模型，支持长记忆 - 引入记忆分层架构的“记忆管理”，解决各个阶段涉及的一致性问题 - 优化状态管理机制 - 修复 MCP Server 相关问题，并优化 客户端示例 - 优化统一环境变量 - 细粒度任务池进度，实时跟踪流程进度 - 提供 HTTP 服务，支持命令启动 - 其他相关问题的优化 |
| `v0.2.1` | 2026-03-29 | Medium | - 增强质量审查智能体功能，修复 各个阶段 智能体的存在的问题 - 修复增强工作流逻辑和相关功能 - 修复 function_calls ，解决已知异常问题 - 添加连续性守护节点，完善其检测功能 - 修复任务池响应问题，并为缓存添加过期时间 - 统一输出数据模型（标准json） - 解决其他已知问题 |
| `v0.2.0` | 2026-03-25 | Medium | - 优化任务池：支持任务并发和等待，支持持久化和停止恢复 - 提示词优化：增加更多细节和统一标准 - 优化质量审查智能体，支持更细致的审查 - 新增 Function Call 接口、命令行工具 和 MCP Server，支持 Claude、Cursor 等 MCP 兼容智能体调用 - 优化拓展 REST API 接口，支持批量和同步提交 - 优化用法示例，支持更多方式使用案例 - 优化语言配置 - 解决合规性问题 - 解决其他异常问题  **包名存在问题，下一版本解决，统一使用 penshot 名，neoshot 将用于 AI Agent video系列项目中，敬请期待** |
| `v0.1.3-beta` | 2026-03-06 | Low | - 解析并添加音频提示词，与视频保持同步（台词、背景声、画外音等） - 优化提示词管理，解决片段衔接和切割丢失问题 - 解决动作、特写、道具等解析丢失问题 - 标准化全局上下文信息 - 参数校验和合规性优化 - 标准化API输出 - 优化其他已知问题 - 解决智能体安装集成调用异常问题 |
| `v0.1.2-alpha` | 2026-02-28 | Low | 1. 优化视频分割功能 2. 完善质量审查，从多个方面检测和修复相关问题 3. 增强提示词管理，增加特写和细节描述，使得情感层次更加丰富 4. 解决其他已知缺陷 5. **包可能存在问题**，请安装最新版 |
| `v0.1.1-alpha.1` | 2026-02-12 | Low | 一个基于LLM的多智能体协作系统，实现从原始文字剧本到AI视频生成指令的端到端自动化转换。  系统通过剧本解析智能体将非结构化剧本转化为结构化元素序列，镜头分割智能体将剧本元素映射为具体的镜头语言描述，视频切割智能体对长镜头进行智能分割（2-5秒），提示词转换智能体将镜头描述编译为适配多模型的AI视频生成提示词，质量审查智能体对片段时长、提示词质量、角色一致性、场景连贯性进行全面验证并生成改进报告。  整个流程基于LangGraph工作流引擎构建，支持智能决策、循环检测、错误重试与自动降级，可在无需人工干预的情况下完成从剧本输入到可执行AI视频指令集的完整转换链路。  ### 核心功能  1. **智能剧本解析** - 自动提取场景、角色、动作、对话，生成结构化剧本分析 2. **AI分镜生成** - 13种镜头类型分类，LLM驱动镜头拆分与描述生成 3. **视频片段分割** - 长镜头智能分割（5秒阈值），AI决策+规则分割双引擎 4. **提示词工程** - 自动转换Runway Gen2/Sora/Pika等模型提示词 5. **质量审查系统** - 时 |

## Citation

- HTML: https://www.freshcrate.ai/projects/story-shot-agent
- Markdown: https://www.freshcrate.ai/projects/story-shot-agent.md
- Dependencies JSON: https://www.freshcrate.ai/api/projects/story-shot-agent/deps

_Generated by freshcrate.ai. Indexes github releases for AI-agent ecosystem packages._