前言¶
在使用 DeepSeek Harness (DSH) 進行開發時，針對遊戲場景的素材生成往往需要額外的工具鏈。DSH 的插件化架構允許我們直接在環境內完成從圖像生成到 Sprite Sheet 排版的全流程。dsh-sprite-gen 專注於解決這一痛點，它將 AI 圖像生成能力直接集成進 DSH，用於生成遊戲所需的雪碧圖、動畫序列、特效和裝備圖標。
插件定位¶
該插件由 randomix777 維護，分類屬於模型推理。它是一個 Sprite Sheet Generator，核心價值在於利用 AI 直接產出可用的遊戲素材，並支持自動裁剪、網格排版和動畫序列生成。
核心功能¶
插件提供以下核心能力：
* AI 圖像生成：支持多種 AI 提供商。
* 4 種提供商：支持 Gemini Flash、Stable Diffusion、Agnes AI 和 ComfyUI（本地）。
* 自動裁剪與網格：自動去除透明邊緣，支持配置網格佈局。
* 摳圖與校驗：支持距離閾值摳圖，包含邊界框裁剪、縮放和質量檢查。
* 動畫序列：生成多幀動畫（走、跳、攻擊等）。
* 視差背景：生成三層側卷軸背景（天空、中層、前景）。
* 特效生成：生成子彈、火焰、爆炸、煙霧等效果。
* 武器與裝備：生成槍械、劍、盔甲等素材。
* 批量生成：一次性生成多個資產。
* GIF 導出：將 Sprite Sheet 導出爲 GIF 預覽。
安裝與啓用¶
通過 DSH 的插件命令安裝：
dsh plugin --profile web add github:randomix777/dsh-sprite-gen
典型用法¶
以下是基於插件提供的工具集的典型操作步驟。
1. 生成基礎圖像¶
使用 sprite_generate_image 生成初始圖像並轉換爲 Sprite Sheet。
2. 摳圖與校驗¶
使用 sprite_cutout 對生成的圖像進行背景去除和質量校驗。
3. 生成動畫序列¶
使用 sprite_animation_sequence 基於參考圖像生成多幀動畫。
4. 生成特效¶
使用 sprite_generate_effect 生成遊戲特效（如子彈、爆炸）。
5. 生成武器¶
使用 sprite_generate_weapon 生成武器素材。
6. 批量生成¶
使用 sprite_batch_generate 批量生成多個 AI Sprite。
7. 生成背景¶
使用 sprite_generate_background 生成三層視差背景。
8. 導出 GIF¶
使用 sprite_gif_export 將 Sprite Sheet 導出爲 GIF 格式。
支持的提供商¶
插件集成了四種圖像生成方案：
* Gemini Flash：使用 gemini-2.0-flash-exp 模型，需 API Key，每日限額 60 次。
* Stable Diffusion：使用 SDXL 模型，需 API Key，每日限額 100 次。
* Agnes AI：使用 agnes-image-2.1-flash 模型，免費，需 API Key。
* ComfyUI：本地 SDXL，無需 API Key，無限制。
適用場景與注意事項¶
該插件適合需要在 DSH 環境內快速產出遊戲素材的開發者。使用前請務必檢查源碼與許可證。插件以當前 DSH 進程的權限運行。
結語¶
dsh-sprite-gen 提供了一套從生成到排版的完整 Sprite Sheet 解決方案。對於需要大量遊戲素材的開發者，通過 sprite_batch_generate 等工具可以顯著提升工作流效率。插件源碼與目錄信息可參考下方鏈接。
