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 與儲存庫資訊。

將此徽章加入你的 README

Featured on YunoDB 徽章樣式與說明

你是這個專案的維護者嗎?展示它已收錄於 YunoDB。

Markdown[![Featured on YunoDB](https://yunodb.com/badge/neopenstory-shot-agent.svg)](https://yunodb.com/tools/neopenstory-shot-agent?utm_source=github&utm_medium=badge)
HTML<a href="https://yunodb.com/tools/neopenstory-shot-agent?utm_source=github&utm_medium=badge"><img src="https://yunodb.com/badge/neopenstory-shot-agent.svg" alt="Featured on YunoDB" height="20"></a>