story-shot-agent
劇本分鏡智能體(PenShot):電影/動漫/短劇/小說→分鏡片段→影片提示詞。基於 LLM 透過 LangGraph+LlamaIndex 實現任意格式劇本的自動解析,生成 Sora/Veo/Runway 等模型可
story-shot-agent 是什麼?
劇本分鏡智能體(PenShot):電影/動漫/短劇/小說→分鏡片段→影片提示詞。基於 LLM 透過 LangGraph+LlamaIndex 實現任意格式劇本的自動解析,生成 Sora/Veo/Runway 等模型可用的連貫 text-to-video 提示詞。保持角色/劇情跨片段一致,支援 MCP/REST API/Function Calls/A2A 整合。(LLM-powered text-to-video-prompt agent. Break scripts into Sora/Veo-ready shots with character consistency)
story-shot-agent 概覽
這是什麼
Story Shot Agent (PenShot) 是一個基於 LLM 的文本轉影片提示詞代理,能將劇本(電影、動漫、短劇、小說)自動解析為鏡頭級描述,並生成適用於 Sora、Veo、Runway、可靈等 AI 影片模型的連貫提示詞。它使用 LangGraph + LlamaIndex 實現任意格式劇本的自動解析,並透過多級記憶與向量檢索確保角色與場景跨片段一致。支援 Python SDK、MCP 服務、Function Calling、REST API 及 A2A 協定整合。
主要功能
- 智慧劇本解析:自動識別場景、對話與動作指令,支援長文本分段處理 - 精準時序規劃:按鏡頭粒度智能切分內容,分配合理時長,符合 AI 影片生成模型的時長限制 - 連續性守護:多層級記憶(短期/中期/長期)搭配 Chroma 向量檢索、快照機制與多維召回,確保相鄰分鏡間角色、場景與情節高度一致 - 高品質提示詞輸出:生成詳細的中英雙語畫面描述、負面提示詞及音訊提示詞 - 多模型相容:支援 OpenAI、Qwen、DeepSeek、Ollama 等主流 LLM 提供商 - 多協定整合:提供 Python SDK、REST API、LangGraph 節點、A2A 協作協定與 MCP 標準介面 - 穩健性與可追溯:內建自動重試、錯誤降級機制,每個分鏡片段均可雙向追溯至原始劇本位置
使用情境
- 將電影、動漫、短劇或小說劇本轉換為 AI 影片生成所需的鏡頭級提示詞 - 在多個影片片段中維持角色外觀、場景與情節的一致性 - 為內容創作者、電影製作者及 AI 影片愛好者自動化劇本到提示詞的流程 - 透過 MCP、REST API 或 A2A 與上游劇本創作代理及下游文生影片/剪輯工具整合
快速開始
bash pip install penshot docker pull neotems/penshot 詳細環境配置與使用範例請參閱儲存庫 README。
授權與價格
授權:MIT。開放原始碼且免費使用。
內容整理自該專案公開的 README 與儲存庫資訊。