前言¶
在 DSH 插件生態中，遊戲素材的生成往往涉及生圖、圖生視頻以及本地圖像處理等多個環節。插件 dsh-game-material-master（遊戲素材大師）將火山方舟 Seedream 的生圖能力、MiniMax 的圖生視頻能力，以及本地 ffmpeg 的摳像、抽幀、合圖能力整合在同一個工作流中。它由 universe-st 維護，旨在解決從一張角色設定圖出發，批量製作遊戲可用素材的效率問題。
核心功能¶
該插件包含以下功能模塊：
- 八方向圖生成：支持轉圈截幀和逐方向生圖兩種模式。默認從一段原地轉圈的綠幕視頻中截取八個方向的幀，合成可操控預覽的精靈圖。
- 圖片生成：支持提示詞生成與參考圖生圖，生成後自動摳像，輸出透明 PNG。
- 序列幀生成：通過首尾幀或參考視頻生成動畫，自動抽幀、摳像並橫向合成。
- 45°地圖地塊生成（實驗性）：採用“幾何交給代碼，內容交給 AI”的策略，生成等距地塊包。
- 地圖編輯器（實驗性）：全本地零計費，提供類似 AsLib 的 RPG Map Maker 界面，支持素材管理、自動連接與動畫地塊。
- 骨骼動畫生成（實驗性）：支持 Spine / DragonBones 圖集導出。
- 對話驅動：所有功能均可通過對話調用，插件註冊了
game_material_*工具，支持 Agent 自動推進或人工驗收。
安裝與啓用¶
安裝命令如下：
dsh plugin --profile web add dsh-game-material-master
安裝完成後，需重啓 DSH 以加載插件。在側欄找到「遊戲素材大師」，進入設置頁面配置 API Key：
* 火山方舟 API Key：用於 Seedream 生圖，需驗證連接。
* MiniMax API Key：用於圖生視頻。
* 生圖模型：默認使用 doubao-seedream-5-0-flash-260915，可切換不同版本。
典型用法¶
1. 八方向圖生成¶
這是最常用的功能，用於製作行走圖。
- 新建項目，上傳角色設定圖。
- 在八方向圖生成模塊中，選擇轉圈截幀模式（默認）。輸入一段提示詞，生成一段角色原地勻速轉一圈的綠幕視頻。
- 插件會自動按時間軸截取八個方向的幀。若需調整，可拖動時間軸上的圓圈進行重切。
- 點擊生成行走動作視頻，讓角色在原方位走三步。
- 插件會自動提取序列幀、摳綠幕、合成整圖。
- 使用 WASD 鍵在預覽區操控角色，檢查八方向銜接是否順滑。
2. 圖片生成¶
- 在「圖片生成」模塊，輸入主提示詞。
- 可選：拖入最多 10 張參考圖。
- 點擊生成，結果區會逐張展示。點擊「通過」或下載摳像後的 PNG 素材。
3. 序列幀生成¶
- 選擇模式：首尾幀模式或多模態參考模式。
- 輸入提示詞，設置時長和分辨率，生成視頻。
- 插件自動抽幀、摳像、橫向合成。
- 在右側預覽區循環播放，驗收動作連貫性。
注意事項¶
- 依賴環境：需要本地安裝
ffmpeg和ffprobe，並將其路徑加入環境變量（或在 DSH 配置中指定）。 - 數據隱私：素材生成完全在本地完成，不會上傳至第三方服務，數據存儲在本地 DSH 目錄。
- 實驗性功能：部分功能（如骨骼動畫、地圖編輯器、45°地圖地塊生成）目前爲實驗性狀態，尚未完善。
- 功能管理：在設置中可關閉不需要的模塊，關閉後插件界面將不再顯示該模塊，且對話中的 AI 無法調用。
結尾¶
該插件通過整合多模態模型與本地處理工具，爲遊戲開發提供了一套從設定到成品的素材流水線。其對話驅動的特性也方便集成到 DSH 的智能體開發中。更多細節與源碼可訪問 GitHub 倉庫。
