前言¶
在使用 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 等工具可以显著提升工作流效率。插件源码与目录信息可参考下方链接。
