universe-st/dsh-game-material-master 预览 preview

universe-st/dsh-game-material-master

Plugin插件 Native原生 ⭐ 30 MIT Pets & Fun桌宠与娱乐Vision & Media视觉与多媒体

dsh游戏素材大师插件。接入seedream生图模型和minimax视频生成模型,可生成各种游戏素材。

Project Overview项目介绍

This is a native plugin built exclusively for DeepSeek Harness, designed to generate game-ready assets in bulk from a single character concept art. It can be installed via the DSH CLI using the command dsh plugin --profile web add dsh-game-material-master, and after installation you must restart DSH for the host side changes to take effect. For local development installation, you can point the CLI to your local repository path, and refreshing the browser after installation applies any client-side changes. The plugin ships with four core modules for different types of game asset generation, and all local processing runs via ffmpeg with no asset uploads to third parties.

Each step of the generation pipeline can be re-run individually, so if you are unhappy with one stage you do not need to re-run the entire process from the start. All functionality is exposed via callable tools that the DSH agent can invoke conversationally, so the agent can handle the entire pipeline automatically and pause at any step for your manual review and approval. This tool is built for independent game developers who need to quickly iterate on character assets without spending hours on manual chroma keying, compositing, and sprite sheet packing. The four core modules cover all common character asset types needed for 2D game development.

You need to have ffmpeg and ffprobe available on your system PATH, or you can specify their absolute paths via the FFMPEG_PATH and FPROBE_PATH environment variables. The plugin has no runtime npm dependencies of its own, as it pulls all required shared dependencies from DSH's existing installation tree. To use the plugin, you need to add your API keys for Volcano Ark Seedream and MiniMax in the DSH settings menu; these keys are stored only locally on your machine and are always masked when displayed. The project is released under the open source MIT license, and documents known model limitations.

这是一个专为 DeepSeek Harness 开发的原生插件,可基于单张角色设定图批量生成各类游戏开发素材。它包含四个功能模块:八方向行走精灵图生成、带抠图的自定义图片生成、序列帧动画生成、适配 Spine 和 DragonBones 的骨骼动画生成。整个流程中,生图由火山方舟 Seedream 完成,图生视频调用 MiniMax API,抠像与合成全部使用本地 FFmpeg 处理,素材不会上传到第三方服务。

每个功能阶段都支持单独重跑,用户可对不满意的步骤单独重做,无需从头启动整个流程。所有功能都支持通过对话调用,插件将整条流水线注册为专用工具,Agent 可自动推进流程,也可在每一步暂停等待用户人工验收。它面向独立游戏开发者,帮助快速生成可直接使用的游戏角色素材,省去大量手动抠图、排版、拼接的重复工作。

通过 DSH 命令行即可安装,安装完成后需要重启 DSH 让宿主端生效,修改浏览器端代码后仅需要刷新页面即可。依赖本地 FFmpeg,需要将其加入系统 PATH 或通过环境变量指定绝对路径,插件本身无额外 npm 运行依赖。API 密钥仅存储在本地,全程脱敏显示,项目遵循 MIT 开源许可,同时也列出了已知的模型生成限制供开发者参考。

Pre-install check安装前体检Compatibility · Security兼容性 · 安全性 1 note1 项提示
  • 30 stars - an early-stage project星标 30,属于早期项目
DSH walks through these 9 checksDSH 会逐条核对这 9 项

Compatibility兼容性

  • DSH, Node, OS and profile requirementsDSH 版本 / Node 版本 / 操作系统 / profile 是否满足要求
  • External dependencies and runtimes (Electron / Python / Docker, ...)外部依赖与运行时(Electron / Python / Docker 等)是否齐备
  • Conflicts with installed plugins: command names, skill / tool names, ports, duplicate MCP registration与已装插件是否冲突:命令名、skill / tool 重名、端口占用、重复 MCP 注册

Security安全性

  • Repo matches the facts registered here; archived or abandoned?仓库是否与页面登记一致,是否归档或长期停更
  • Safety of preinstall / install / postinstall and install.sh / setup.ps1preinstall / install / postinstall 与 install.sh、setup.ps1 是否安全
  • curl|bash, download-then-execute, obfuscation, unrelated domains → stop immediatelycurl|bash、下载即执行、混淆代码、无关域名 → 立刻停止
  • Typosquatting or unmaintained packages among the new dependencies新增依赖里有没有 typosquatting 或无人维护的包
  • Requested permissions vs. what the feature actually needs申请了哪些权限、是否超出功能所需(filesystem / network / shell / clipboard)
  • Any sudo / admin requirement, plus uninstall and rollback是否要求 sudo / 管理员权限,以及卸载与回滚方式

Anything uncertain must be marked unknown with a note on how to confirm it. This site's signal screen is a static snapshot, not a security audit.拿不准的必须标「未知」并说明要我怎么确认。本站的信号筛查是静态快照,不能替代安全审计。

Or use CLI install (for developers)或使用命令行安装(适合开发者)

CLI Install命令行安装

dsh plugin --profile web add dsh-game-material-master

把 universe-st/dsh-game-material-master 加入你的 DSH 配置(web profile)即可启用。

READMEREADME

游戏素材大师

从一张角色设定图出发,批量做出游戏里真正要用的素材。

火山方舟 Seedream 负责生图,MiniMax 负责图生视频,抠像、抽帧、像素量化、合图全部在 本机用 ffmpeg 完成——不需要任何系统图像库,素材也不会被传到第三方服务。

npm license

游戏素材大师 · 工作台

30 秒上手:dsh plugin --profile web add dsh-game-material-master → 重启 DSH → 侧栏点「游戏素材大师」→ 设置里填两个 API Key → 新建项目、上传设定图 → 点「生成转圈视频」 (默认路径:角色原地匀速转一圈,再自动截出八个方向;要逐方向生图就在阶段①切一下方式)。

三个模块共用同一套「生成 → 验收 → 重跑」工作台。每个阶段都能单独重做,每份产物都能 逐项打「通过」;「审核模式」可以选 agent 自动审完就往下走,也可以选每一步停下来等你点头。

模块 做什么 走完能拿到
① 八方向图生成 一张设定图 → 8 方位 × 8 帧(默认「转圈截帧」:一段转圈视频截出八个方向) 可用 WASD 操控预览的行走精灵图
② 图片生成 提示词(可带参考图)→ 出图 → 抠绿幕 干净透明的 PNG 立绘 / 道具
③ 序列帧生成 首尾帧或参考视频 → 生成视频 → 抽帧 → 抠像 横向排布、可循环播放的序列帧
④ 骨骼动画生成 拆件 → 装配 → 骨骼动画 → Spine / DragonBones 图集 实验性功能,本文不展示

⚠️ 模块④「骨骼动画生成」仍是实验性功能,尚未完善:拆件质量取决于生图模型,自动装配与骨骼推导 对真实立绘经常需要人工校正(agent 视觉先验或手工拖放),导出的 Spine / DragonBones 产物也还没经过 足够的引擎侧验证。界面上该模块带「实验性」角标,并在每次进入时弹窗说明。本文只展示前三个模块。 如果你需要它、或者想一起把它做扎实,欢迎到 GitHub 仓库 参与开发。


① 八方向图生成

一张正面设定图进去,八个方位一次做完:绿幕图 → 行走视频 → 序列帧 → 精灵整图 → 可操控预览。

flowchart LR
  S(["设定图"]) --> I["① 八方向绿幕图"] --> V["② 行走视频"] --> F["③ 提取序列帧"] --> P["④ 合成整图"] --> W(["⑤ WASD 预览"])

① 的两种生成方式:转圈截帧(默认)/ 逐方向生图

八张方向图有两条产法,产物完全一样(images/<方位>.png),所以后面四步不用换做法:

转圈截帧(默认) 逐方向生图(备选)
做法 先生成一段「角色原地匀速转一整圈」的绿幕视频,再按时间轴截出八个方向的帧 八个方位各自生图,按依赖顺序
花费 一次视频调用 八次生图调用
一致性 八个方向同源:同一个角色、同一段光线、同一套画风 模型每次都要重新理解角色,脸型/发色/服装容易漂移
调位置 时间轴上有八个可拖动的圆圈,拖到哪一帧就切哪一帧(本机重切,免费、即时) 逐张重新生成

界面上那一排圆圈就是八个方位的截帧位置,底下的缩略条带是整圈候选帧——对着画面拖, 松手就重切那一张(并自动作废这个方位的行走视频与序列帧,避免新旧朝向混在一起)。 默认位置是「从正面开始、匀速转满一圈」的等分假设;模型实际转的方向或快慢不一样时, 直接拖圆圈,或点一下「转圈方向」重排。改变候选帧数(8~64)会自动重抽,并把拖过的位置按比例换算。

怎么用

  1. 新建项目 → 上传设定图,写提示词(转圈截帧用的是一份转圈视频提示词;逐方向生图是每个方位一份, 另有「统一附加提示词」八个方向共用)。
  2. 生成转圈视频(默认路径):角色原地匀速转一整圈,绿幕背景。视频到手后插件会自动抽候选帧 并切出八个方向,一般不需要你动手。逐方向生图(备选)则是一键生成全部:八个方位按依赖顺序 出绿幕全身图。逐张能看到用时、落到哪个模型;不满意就重新生成这一张,或展开编辑提示词只改它。
  3. 生成全部视频:让角色在原方位原地走三步。这一步最贵、也最慢(单段 1~6 分钟)。
  4. 提取全部序列帧:每段视频按时长平均抽帧,这里同时完成统一裁剪、缩放与像素风量化。
  5. 合成整图:剔除绿幕,按行序拼成一张精灵图;行序可用 ↑↓ 拖动调整,合成前可存参数。
  6. 行走预览:用 WASD 或方向键操控角色,八方向接得顺不顺,一眼就能看出来。

Showing the opening section of the README — the full document lives in the repository以上为 README 开头摘要,完整文档在仓库内 · View the full README on GitHub →在 GitHub 查看完整 README →

← 上一个 Prev dsh-vscode 下一个 Next dsh-pet-live2d →