前言¶
在 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 仓库。
