OpenCartridge

2周前更新 58 00

OpenCartridge 是面向游戏创作者的本地优先AI资产生成套件,底层由本机GPU上跑的ComfyUI工作器驱动,基于camenduru的TostUI二次开发,主打一站式生成、编辑图像、精灵表、循环动画、音频、3D模型,全程不上云,不需要账号、积分。

所在地:
camenduru
收录时间:
2026-10-30
OpenCartridgeOpenCartridge

OpenCartridge 是一款本地优先的 AI 游戏资产生成套件。它提供了一个用于合成图像、精灵表、动画、音频和 3D 模型的可视化画布环境。该项目基于 camenduru 的 TostUI 构建,底层由运行在用户本地 GPU 上的 ComfyUI 工作器驱动。

OpenCartridge

核心功能与架构设计

OpenCartridge 的设计重心在于降低本地 AI 工作流的部署门槛,同时保持数据处理的全本地化。

  • 可视化画布:提供图层管理、变换操作与撤销/重做功能。生成的资产可直接导出为 PNG、MP4、WebM 或 GLB 格式,满足游戏开发的多维需求。
  • 卡带化工作流(Cartridges):将复杂的 AI 工作器模型打包为“一键卡带”。用户可通过 UI 界面直接下载并运行,系统会自动拉取镜像、创建容器并指向内置存储,无需手动编写 Docker 命令或配置环境变量。
  • 内置对象存储:容器自带 MinIO 服务。生成的渲染结果和上传的输入文件均持久化存储于此,确保在容器重建或更新后数据不会丢失。
  • 100% 本地化与自更新:无需注册云账户,无积分消耗限制。全局配置面板支持从内部拉取最新源代码、重建并重启应用,实现平滑的版本迭代。
OpenCartridge

部署环境与运行要求

该套件依赖 Docker 环境运行,对硬件有一定要求,但部署过程已高度简化。

  • 硬件要求:需要配备英伟达显卡,当前工作器约需 24 GB显存即可满足常规运行需求。
  • 启动方式:安装并运行 Docker Desktop 后,通过单行命令即可启动服务。该命令会映射 3000、9000 和 9001 端口,并挂载数据卷与 Docker socket,无需手动启动额外的工作器容器。
  • 数据持久化:通过 -v opencartridge-data:/content/data 参数挂载的卷负责存储 MinIO 数据。若需清理生成内容,可通过删除该 Docker 卷实现。

可用卡带功能详解

OpenCartridge 预置了多种针对游戏资产生成的专用卡带,覆盖从 2D 到 3D 的完整管线:

  • 3×3 精灵表(图像):基于单张角色参考图,生成包含八个等距朝向及透明背景的 3×3 转身精灵表。
  • 3×3 精灵表动画(视频):为现有精灵表制作原地行走动画,生成包含音频且可无缝循环的视频片段。
  • Loop Hero 风格化(图像):将角色参考图转换为 Loop Hero 风格的像素艺术,保留抖动暗奇幻调色板与清晰的像素边缘,并进行颜色匹配。
  • CorridorKey 图像/视频抠像:利用 CorridorKey 2.0 从静态帧或完整视频片段中提取干净的 Alpha 遮罩,支持原生分辨率,无需绿幕或手动转描。
  • Idol 3D 模型生成:输入单张图像,由 Idol 模型预测物体的完整三维结构(包括未展示的侧面),并自动网格化为 GLB 格式的 3D 模型。

工作器状态与安全管理

系统对工作器容器的生命周期进行了直观的视觉化管理,并在左面板动态显示可用卡带。

  • 运行中(🟢):工作器正在执行任务,支持手动停止或删除容器。
  • 已停止/已下载(🟡):镜像已本地化,支持一键启动或删除。
  • 未安装(🔴):支持点击下载并运行,下载进度会在卡片上直观显示。

为保障系统安全,未运行的工作器卡带会在左面板隐藏。所有容器的规格(包括镜像来源、端口、命令和环境变量)均由 public/service-workers.json 静态定义,杜绝了从浏览器端动态注入不可信配置的风险。

相关导航