Skip to content
项目

wellingfeng/UltraGameStudio has 342 GitHub stars and 37 forks. GitHot measured 0 stars in 24 hours and +4 in 7 days. Last checked 2026-11-18 01:20 UTC. Last push 2026-11-14.

这些数字如何统计

实测星标增长

24小时
0
7天
+4
15天
正在收集历史
1个月
正在收集历史

各周期内的星标净变化,周期相互重叠,并非每日新增。缺失的测量保持空白。星标代表关注度,不代表软件质量。

关于

UltraGameStudio - AI coding agent for game development: engine workflows, gameplay code, and asset generation.

人工智能

app/doc/README.zh-CN.md

原文

UltraGameStudio

在游戏引擎里,代码只占很小一部分,更多的是资产和流程——材质、蓝图、地形、天空、UI、骨骼动画、打包、性能优化。UltraGameStudio 把 Claude Code / Codex / Gemini 这类编程 Agent 针对这一现实做了深度定制:它理解游戏引擎概念,能生成游戏所需的各类资产(图片、3D 模型、2D 精灵动画、图集、音频、骨骼绑定、视频),并把常规任务路由到免费或低成本渠道,让高级模型额度用在刀刃上。

一键生成虚幻引擎 UMG 界面
UltraGameStudio 一键生成虚幻引擎 UMG 界面

一键生成 3D 模型
UltraGameStudio 一键生成 3D 模型

UltraGameStudio 生成的 3D 模型预览

图片、精灵、网格、音频、骨骼绑定、视频——统一由一个编程 Agent 管理
UltraGameStudio 统一游戏资产生成

UltraGameStudio 游戏资产工作流

为什么做 UltraGameStudio

如今 AI 已经足够好,大部分代码都能自己写。程序员的角色正在转向描述需求、验证产出、编排 Agent。但游戏不只是代码。游戏引擎里充满了材质、蓝图、地形、天空、UI、骨骼动画、打包和性能调优——而大多数通用编程 Agent 根本不懂这些。

UltraGameStudio 把 Claude Code / Codex / Gemini 这类编程 Agent 针对游戏开发做了深度定制:

  • 懂游戏引擎语言。 Agent 预置了游戏开发概念,能推理材质、蓝图、地形、光照、UI(UMG 等)、骨骼动画、构建打包和性能优化,而不只是处理通用源码文件。
  • 生成游戏所需的各类资产。 图片、3D 模型、2D 精灵动画、精灵图集、音频、骨骼绑定、视频都能在同一个聊天界面里产出,并通过一套编程 Agent 工作流统一管理。
  • 内置游戏开发专家团。 40+ 个专家角色(技术总监,玩法/AI/网络/工具程序,关卡/数值设计,美术与音频总监,QA,发布经理等)覆盖 Unity、Unreal、Godot 和 Web 引擎。
  • 把高级额度留给关键判断。 常规任务走免费、试用额度或低成本渠道,Key、设置和历史都保存在本机。

主要能力

游戏开发 Chat

  • 让 AI 写玩法代码、引擎集成、shader/材质逻辑、构建脚本,排查 Bug、重构、补测试、写发布说明。
  • 面向 Unity、Unreal、Godot 或 Web 引擎项目——Agent 推理的是引擎概念,而不只是文件。
  • 支持附加文件路径,也可以把文件拖进输入区。
  • 在同一个聊天界面查看流式输出、命令日志、文件引用和总结。
  • 可以在同一个会话里继续追问,不需要重复解释上下文。

游戏资产生成

游戏所需的各类资产都能在同一个聊天界面里生成、应用到项目,再交回编程模型——全部保留在同一段会话历史中。每个生成器都通过你配置好的 Provider 运行。

资产 用途 进入方式
图片 概念图、UI 草图、图标、海报、贴图、参考图 /image、/img、/draw、/生图 或 /image-mode-start
ComfyUI 节点图 可编辑的节点式生图工作流 /comfyui-mode-start
2D 精灵 游戏精灵、序列帧、spritesheet /sprite 或 /sprite-mode-start
3D 模型 道具、角色、场景网格、blockout /mesh-mode-start(用 /mesh-search 搜索素材库)
音乐 BGM、配乐、音乐片段 /music 或 /music-mode-start
语音 配音和旁白 /speech-mode-start
视频 视频片段和动态素材 /video 或 /video-mode-start

Agent 会先扩写你的提示词,调用配置好的 Provider,并把结果连同提示词和 Provider 信息一起显示在聊天流里。用对应的 *-mode-end 命令退出任意模式。

游戏开发专家团

UltraGameStudio 内置 40+ 个游戏开发专家,Agent 会根据任务自动调用:

  • 引擎专家:Unity、Unreal、Godot(GDScript / C# / GDExtension / shader)和 Web。
  • 程序角色:技术总监,主程/引擎/玩法/AI/网络/工具/UI 程序。
  • 设计角色:玩法、关卡、数值、运营和叙事设计。
  • 美术与音频总监及专家、特效、音效设计和音频总监。
  • 制作、质量与发布:制作人,QA 负责人/测试,devops,安全,本地化,发布经理。

在 设置 里配置当前引擎、council 模式以及启用哪些专家。

免费大模型路由

  • 20+ 个远程渠道 + 本地运行时:NVIDIA NIM、OpenRouter、GitHub Models、Hugging Face Router、SambaNova Cloud、Together AI、Google Gemini、DeepSeek、Mistral、Mistral Codestral、OpenCode、Wafer、Kimi、Cerebras、Groq、Fireworks、Z.ai、LLM7、Kilo Gateway,以及 Ollama、LM Studio、llama.cpp 等本地运行时。
  • 免 Key 实验渠道:LLM7 和 Kilo Gateway 可以不填 API Key 直接试用,但只建议用于非敏感编程任务。
  • 官方免费/试用额度渠道:GitHub Models、Hugging Face Router、SambaNova Cloud、Together AI、Gemini、Groq、Cerebras、NVIDIA NIM、OpenRouter、Mistral/Codestral、DeepSeek、Kimi、Z.ai、OpenCode、Wafer、Fireworks 等需要填写 provider API Key,Key 只保存在本机。
  • 内置 Rust 本地反向代理,自动翻译 Anthropic 和 OpenAI-compatible 协议。
  • Claude Code 可以通过已经配置好的免费渠道路由,不需要改聊天界面。
  • API Key、模型覆盖值和本地模型配置都可以在设置里管理。

免费渠道路由
UltraGameStudio 免费渠道路由截图

当前默认的编程向模型:

渠道 默认模型
GitHub Models openai/gpt-4.1-mini
Hugging Face Router deepseek-ai/DeepSeek-V4-Pro
SambaNova Cloud DeepSeek-V3.1
Together AI Qwen/Qwen3-Coder-480B-A35B-Instruct-FP8
Kilo Gateway poolside/laguna-xs.2:free
LLM7 codestral-latest

动态工作流 (/studio)

对于复杂的多步骤编程任务,/studio <任务> 会即时生成一个专属的执行 harness 并立即运行,无需可视化画布。

  • 用自然语言描述任务 — planner 自动构建包含并行子代理、对抗验证和验收门的 harness。
  • 六种内部策略自动选择:分类执行、扇出合成、对抗验证、生成筛选、锦标赛、循环至完成。
  • 每次运行都在 .ugs-run/<run-id>/ 下完整记录:任务账本、事件、裁决和最终结果。
  • 可在桌面端直接使用,或通过命令行:ugs studio "<任务>" --json --interactive --cwd <workspace>。
  • 零配置 — 复用本地 claude CLI 登录态。

Free Auto — 多渠道自动切换

Auto 渠道(Channel 菜单中的 freecc:auto)自动将每次请求路由到当前可用的最佳免费渠道,无需手动切换。

  • 轮转所有已配置的免费渠道,自动跳过触发频率限制(429)或上游错误(5xx)的渠道。
  • 追踪每个渠道的冷却时间并退避:渠道报错后会暂停一段时间再重试。
  • 支持可选的模型覆盖,所有自动路由的请求使用同一模型,无论哪个渠道处理。
  • 如果所有渠道都已耗尽,返回 503 并附带失败日志,方便诊断中断原因。

多供应商接力:DeepSeek → CodeX

使用 /studio 时,harness 可以在各计划步骤间自动串联多个供应商。典型模式:让 DeepSeek 以低成本产出响应草案,再由 CodeX 接手精炼至最终质量。

  • 动态 Harness 计划支持按步骤设置 model 覆盖 — 将 DeepSeek 分配给头脑风暴/分类步骤,CodeX/Gemini 分配给实现/验证步骤。
  • cc-switch 兼容:UltraGameStudio 读取 cc-switch CLI 配置,已为 Claude Code 路由配置的任何供应商立即可用于 studio 步骤。
  • 扇出合成策略将 DeepSeek worker 并行分配到独立子任务上,再由共识门(CodeX)合成并验证结果。

速度感知的渠道选择

免费代理的 Auto 渠道根据实时可用性信号优先选择渠道:

  • 频率限制感知:返回 429 的渠道会冷却 30 秒以上再重试,避免在饱和的上游浪费尝试。
  • 错误快速失败:不可重试的错误(4xx 认证失败、5xx 上游宕机)会追踪每个渠道的冷却时间;Auto 路由会在当前请求中跳过它们。
  • 连接时间预算:每个渠道尝试受上游超时限制;Auto 路由循环候选渠道时不会阻塞在单个慢速上游。
  • 响应速度自然排序:成功的渠道会清空冷却记录,自然优先尝试;出错的渠道推迟到候选列表末尾。

这些功能协同工作,即使个别免费供应商变慢、触发限流或暂时不可用,/studio harness 运行也能保持韧性。

本地优先

  • 会话、收藏、定时提示词、API Key 和 workspace 历史都保存在本机。
  • 不需要托管版 UltraGameStudio 服务。
  • 桌面端可以使用本机已有的 CLI 凭据和本地模型运行时。

快速开始

从 app/ 启动 Web 开发版:

cd app
npm install
npm run dev

Vite 默认运行在 http://localhost:5173。

启动桌面端开发模式:

cd app
npm run desktop

打包生产版桌面应用:

cd app
npm run package

在仓库根目录下,也可以使用平台脚本:

./run.sh        # macOS/Linux:必要时重建,然后启动
./package.sh    # macOS/Linux:打包原生安装包(macOS 产出 .dmg)
run.bat         # Windows:必要时重建,然后启动
build.bat       # Windows:打包 NSIS 安装器

使用方式

注册免费渠道

  1. 打开底部 Channel 下拉列表,选择一个带警告符号的免费渠道,例如 Free · OpenRouter。

在 Channel 下拉列表中选择未配置的免费渠道

  1. 在 API Key 弹窗里点击 打开注册网址。

从 API Key 弹窗打开渠道注册网站

  1. 到平台官网创建新的 API Key,并复制出来。

在渠道平台新建 API Key

  1. 回到 UltraGameStudio 粘贴 API Key,点击 保存并使用。保存成功后,这个渠道后面的警告符号会消失。

配置完成后渠道警告符号消失

  1. 也可以从左下角 设置 进入 渠道 -> 免费渠道,集中查看每个渠道的 API Key、默认模型和配置状态。

在设置里查看和配置免费渠道

渠道状态显示 已就绪 后,就可以在底部输入框提问。完整步骤见 注册并配置免费渠道 API Key。

生成游戏资产

资产模式会把聊天输入区切换成资产生成入口,同时保留同一段会话历史。适合生成 UI 草图、图标、贴图、精灵、3D 模型、音频和视频,然后继续让编程模型把素材用到项目里。下面以生图模式为例,精灵、建模、音乐、语音、视频模式用各自的 *-mode-start 命令,用法一致。

  1. 打开 设置 -> 生图渠道(或对应资产章节),选择默认 Provider,并按渠道要求填写 API Key、Account ID、Base URL 或本地 ComfyUI 地址。配置完整的 Provider 会出现在该模式的底部渠道选择器里。
  2. 新建或打开一个 Chat,输入 /image-mode-start 进入生图模式。也可以在同一条消息里直接带上第一个需求,例如:
/image-mode-start 奇幻地牢里可平铺的石墙贴图,1024x1024
  1. 模式开启后,普通文本都会走资产生成,不会触发代码修改。底部 Channel 会切换为资产 Provider;如果打开了模型下拉框,还可以在输入区底部切换具体模型。
  2. 描述你想要的资产。UltraGameStudio 会先让编程模型扩写提示词,再调用配置好的 Provider 出图。生成结果会和提示词、Provider 信息一起显示在聊天流里。

资产模式在同一个 UltraGameStudio 会话中生成素材并保留上下文

  1. 输入 /image-mode-end 退出生图模式,回到普通 AI 编程渠道和模型。如果只想临时生成一份资产,不进入常驻模式,可以直接发送 /image、/img、/draw、/生图、/sprite、/music 或 /video 加上提示词。

工作原理

用户请求
    |
    v
聊天输入区
    |
    +--> 选中的 runtime / channel / 权限 / workspace
             |
             +--> 直接 provider API、本地 CLI 或本地免费渠道 proxy
                        |
                        +--> 流式 AI 输出、工具日志和聊天历史

免费渠道 proxy:

  • 只绑定 127.0.0.1:<port>。
  • 每个渠道通过 http://127.0.0.1:<port>/ch/<channelId> 路由。
  • 翻译 Anthropic 和 OpenAI-compatible 流式协议。
  • 让 Claude Code 也能通过同一条 gateway 路径使用非 Anthropic 或本地 provider。

技术栈

范围 技术
桌面壳 Tauri 2, Rust
前端 React 18, Vite 5, TypeScript 5
状态 Zustand
样式 Tailwind CSS, CSS variables
图标 lucide-react
Provider routing Claude Code、Codex、Gemini、可扩展 provider settings
免费渠道 proxy Rust tiny_http + ureq,Anthropic/OpenAI 协议翻译

项目结构

app/
  src/
    components/  共享 UI 和富文本 assistant message 渲染
    lib/         Provider 设置、免费渠道路由、资产生成(图片/精灵/3D 网格/音乐/语音/视频/ComfyUI)、游戏开发专家团、持久化辅助函数
    panels/      Sidebar、chat dock、settings、定时任务 UI
    store/       Zustand 状态和本地历史
  src-tauri/
    src/
      free_proxy.rs    Rust 反向代理 + Anthropic/OpenAI 协议翻译
      lib.rs           Tauri 命令、文件系统/历史桥接
  doc/                 教程、本地化 README、截图
docs/                  调研笔记、静态文档、素材
pencil/                Pencil 设计文件

相关文档

开发与验证

从 app/ 运行:

npm run dev        # Vite 开发服务器
npm run typecheck  # TypeScript 检查
npm run lint       # ESLint
npm run test       # Vitest
npm run desktop    # Tauri 开发模式
npm run package    # 生产打包

社区

许可证

目前尚未指定许可证。