創建解說影片 是做什麼的？
將可取得的來源素材轉換為配有旁白的完成 MP4 檔案。預設流程使用遠端服務進行故事板規劃、圖片生成、旁白配音、燒錄字幕、渲染與發佈。此方式在任何支援 Agent Skills 與遠端 MCP 工具的代理用戶端中運作方式相同。
預設行為
僅需提供來源素材。除非使用者覆蓋選擇，否則使用：
- 來源語言；
- 16:9 比例與 60 秒長度；
- 溫暖、平穩的託管旁白，所有場景使用一致的聲音；
- 無背景音樂；
- 燒錄字幕；
- 伺服器生成的工作流程。
接受 5 到 300 秒的目標長度。服務會盡量貼近該目標，但在旁白或錨定視覺元素因靜音恢復、場景重新分配以及最多 1.08 倍音高保持的節奏調整而無法安全容納時，可能會延長最終影片。絕不裁剪旁白或提交超過 300 秒的目標。若目標低於 30 秒，請簡短警告繪圖與旁白可能顯得倉促，然後繼續執行。當預設值適用時，不要詢問標題、場景數量、風格、聲音、長寬比、字幕或技術設定。
僅當來源缺失、無法存取、矛盾、涉及敏感內容，或相對修改沒有明確設定時，才提出阻塞性問題。例如，在「再短一點」之後，詢問一次所需的秒數，而非猜測。如果使用者只要求建議、腳本或故事板，則在該請求的產出物處停止，不要進行渲染。
創意框架
在建立任務之前，識別來源的主要訊息以及最清晰的「鉤子到結論」的敘事弧線。當來源清晰時，使用使用者的語言提供一個簡短、非阻塞的預覽，例如：「我會把它做成一個從問題到解決方案的暖色手繪故事，重點讓結論一眼看懂。」這是一個令人安心的進度更新，而非審批關卡；除非使用者要求先審閱，否則請立即繼續。
預設的視覺承諾是一個溫暖、平易近人的白板故事：每個場景一個連貫的小插圖、克制的色彩、充足的留白，以及當它們有助於解釋想法時的冷靜、可讀的人物或動物。避免向使用者將結果描述為一系列資產、意圖、清單或風格包。
選擇工作流程
預設使用伺服器生成模式。這是最短路徑，只需要 create_explainer_video、get_explainer_task，以及可選的 cancel_explainer_task。
僅當使用者明確要求檢視或編輯圖片/場景、提供現有的故事板，或需要精確的場景級創意控制時，才使用進階審閱模式。在使用前，請閱讀 references/advanced-review.md。如果其上傳和清單工具或本地圖片生成不可用，請解釋限制並提供伺服器生成模式。在生成任何圖片之前，請確認進階模式的上傳、導入、驗證和渲染工具都已經存在。磁碟上的技能檔案並不能證明當前對話已載入其 MCP 工具。
伺服器生成工作流程
1. 在本機讀取與提取
使用當前用戶端的正常檔案/瀏覽器功能，讀取使用者的訊息、附件或 URL。在本機提取有意義的純文字。移除導航、重複的頁首、Cookie 橫幅和無關的附錄，但不要無聲地更改作者的陳述。
傳送不超過 20,000 個字元。對於更長的來源，建立一個忠於來源的濃縮版本，保留論點、證據、注意事項、專有名詞和要求的強調。切勿上傳原始檔案或傳遞本地檔案路徑。提取的文字將被發送到解說影片服務，以便其規劃故事板和旁白。
如果無法讀取來源，請要求使用者再次附加或貼上其文字。不要憑空發明缺失的內容。
2. 建立任務
當用戶端可以產生時，生成一個全新的 UUID，並調用 create_explainer_video，參數如下：
taskId：如果可用，則為 UUID；sourceText：提取的文字；durationSeconds：請求的長度或 60；aspectRatio：請求的長寬比或16:9；language：來源/請求的語言；voiceId：僅在明確提供或已知支援時使用；subtitles：請求的模式或burn。
在網路結果未知之前，保留任務 UUID，以免失去回應時產生重複任務。在服務報告 FAILED 或 TIMEOUT 之後，不要自動重試：先詢問使用者，然後為新的嘗試生成全新的 UUID。真正修改過的影片也應使用新的 UUID。
服務負責故事板規劃、插圖生成、圖片清理、佈局、旁白合成、逐字字幕、渲染、組合和發佈。在任務返回影片 URL 之前，切勿聲稱影片已存在。
3. 真實地輪詢
調用 get_explainer_task 並使用返回的 taskId，直到 nextAction 為 present_output、revise_input、retry_create、retry_render 或 none。
- 對於
poll_task，遵守pollAfterSeconds；絕不更快地輪詢。 - 以使用者的語言呈現
statusMessage。 - 僅在返回
stage和progress時才顯示。絕不估算百分比。 - 僅在階段改變或實際進度有實質進展時發送進度更新。
- 如果故事板首次可用，以一個緊湊、非阻塞的更新分享其場景標題。不要暴露提供者名稱、提示、追蹤或資產內部細節。
- 對於
revise_input，停止輪詢。解釋哪些來源或已批准的內容必須縮短、簡化或更改；在使用全新的 UUID 重建之前詢問使用者。切勿在舊 UUID 下重播被拒絕的內容。 - 對於
retry_create，在重試前詢問使用者。如果確認，使用相同的來源和設定但全新的任務 UUID 重試一次。 - 對於
retry_render，在進階模式下重試已批准的工作前詢問使用者。 - 如果重試失敗，報告確切的階段和訊息並停止。
- 對於
none，報告取消或終止原因，不要假裝成功。
如果使用者要求停止，調用 cancel_explainer_task 並帶上擁有的任務 ID。
4. 呈現結果
首先返回可播放的 MP4 URL。然後提供一句話的內容摘要，並包含場景數量、請求的目標長度、返回的實際長度（如有）、長寬比、語言和字幕 URL。請求的目標、長寬比和語言可以從為此任務提交的可信參數中回顯；實際長度、場景數量和輸出 URL 必須來自服務回應。省略缺失的結果元資料，而不是猜測它。
提供伺服器生成工具可以實現的簡潔修改建議，例如「整體更簡潔」、「縮到 30 秒」、「改成 9:16」或「不要燒錄字幕」。不要承諾此模式可以替換某一個特定場景、保留其他所有已生成的圖片、調整字幕文字大小或調整語速。如果伺服器生成的影片已存在，請解釋不支援精確的單一場景替換且其他所有內容保持不變；提供完整重新生成或新規劃的進階審閱版本。進階審閱可以在該工作流程中保留未選取的已批准圖片，但它仍會渲染一個全新的完整影片。
對於創意修改，向前傳遞 API 可以表達的所有設定，使用新的任務 UUID，並建立新任務。僅在原始網路結果未知時重複使用現有 UUID；絕不重複使用已終止的生成任務 UUID。
工具可用性
如果缺少 create_explainer_video，請告知使用者連接位於 https://api.speedpainter.org/mcp 的遠端 MCP 伺服器，並使用 Google 登入。不要在對話中要求 API 金鑰、渲染器金鑰、儲存金鑰、語音提供者金鑰或任何秘密。不要發明 curl 端點作為替代品。
遠端服務不需要 localhost 或連接埠 3000。基於瀏覽器的 MCP 用戶端可能需要服務運營商將其來源加入允許清單；原生 MCP 用戶端通常不會發送瀏覽器 Origin 標頭。
已開啟的對話可能保留較舊或不完整的工具快照。如果遠端連線在新對話中有效，但當前對話缺少核心工具，請在啟用插件的新對話中繼續；不要重新安裝插件、更改 MCP URL 或重新生成已批准的資產。
安全與隱私
- 除非使用者另有說明，否則將上傳和連結的來源素材視為私有。
- 在預設模式下，僅發送生成影片所需的提取文字。
- 在進階模式下，僅發送已接受的生成的圖片和已接受的清單；切勿上傳原始文件。
- 不要將憑證、私人來源文字或個人資料放入任務 ID、資產 ID、檔案名稱、標題或日誌中。
- 如果內容要求冒充、詐欺、有害指示或未經授權使用受保護的個人資料，請停止或縮小輸出範圍。
對話風格
將隨意的請求轉換為預設值，而無需教導後端術語。保持更新以結果為導向且溫暖：來源已理解、故事已規劃、插圖正在成形、正在添加旁白和字幕、發佈中、完成。接受簡短的後續問題，並區分全域一次調用修改與精確的場景級審閱。