🎮 GodotHub
Godot Engine 的终极项目管理器
在一个地方管理项目、版本、模板和 Git。
“如果 Unity Hub 和 GitHub Desktop 生了个孩子，但被领养了会怎样？” - 是的.. 就是这么回事。
⬇️ 立即下载
📸 截图
📖 功能
🛠️ 安装
⌨️ 快捷键
## 截图
The Projects view with search, categories, and drag-and-drop sorting
🎯 Versions
Browse, download, and manage Godot versions
|
📦 Templates
Save and reuse project templates
|
🔄 Git Integration
Full Git management inside GodotHub
|
📰 News Feed
Stay up to date with Godot community news
|
🎨 Appearance & Settings
Deep customization with themes, accent colors, corner radius, and more
|
## 功能
### 项目管理
通过丰富、直观的界面全面掌控你的 Godot 项目。
| 功能 | 描述 |
|---|---|
| **创建和导入** | 从零开始或基于模板创建新项目，从磁盘导入现有项目，或直接从 Git 仓库克隆。 |
| **拖拽排序** | 通过流畅的拖放重新排列项目。可以在分类内重新排序，或在分类间移动。 |
| **固定项目** | 将你最重要的项目固定在顶部专用的“已固定”区域。 |
| **批量操作** | 一次选择多个项目以更改版本、分配分类、切换固定状态，或从库中移除。 |
| **搜索和过滤** | 按名称或路径搜索，按分类过滤，并按自定义顺序、名称、日期、最后打开时间或项目大小进行排序。 |
| **版本警告** | 当项目绑定的 Godot 版本缺失或存在主要版本不匹配时提供视觉指示。 |
| **项目属性** | 检查详细的项目信息，包括按类型（脚本、场景、图像、音频、3D 模型等）划分的文件明细及其大小和数量。 |
| **自定义启动参数** | 启动项目时添加自定义命令行参数。 |
| **快速操作** | 从项目卡片打开项目文件夹、在外部编辑器中打开、在项目路径下打开终端。 |
### Godot 版本管理
轻松下载、安装和管理任何 Godot 版本。
| 功能 | 描述 |
|---|---|
| **浏览版本** | 直接从 GitHub 获取完整的官方 Godot 构建列表，并针对你的平台进行过滤。 |
| **下载和安装** | 支持进度跟踪、断点续传和并发下载（最多可配置为同时 10 个）的下载功能。 |
| **导入版本** | 从任意文件夹导入现有的 Godot 安装，或拖放 `.zip` 压缩包。 |
| **分组显示** | 版本按 `major.minor` 分组，带有可折叠的区域以便浏览。 |
| **过滤** | 按构建类型（Standard / Mono / 两者皆是）和通道（Stable / Unstable / 两者皆是）进行过滤。 |
| **自定义名称** | 为你安装的版本指定友好、自定义的名称。 |
| **自动清理** | 自动从注册表中清理缺失的可执行文件。 |
### 模板
通过重用项目结构来节省时间。
| 功能 | 描述 |
|---|---|
| **保存为模板** | 将任何现有项目转换为可重用的模板。 |
| **从模板创建** | 启动预填充了模板内容的新项目。 |
| **预览内容** | 在使用任何模板之前，浏览其完整的目录树。 |
| **从目录同步** | 从配置的扫描文件夹自动导入模板。 |
| **文件监视器** | 监视模板目录的更改。编辑模板文件夹，库会自动更新。 |
### Git 集成
直接在 GodotHub 内进行功能齐全的 Git 管理。
| 功能 | 描述 |
|---|---|
| **状态概览** | 一目了然地查看分支名称、未提交的更改和仓库状态。 |
| **暂存 / 取消暂存** | 暂存或取消暂存单个文件或一次性处理所有文件。 |
| **提交** | 编写提交信息，可选择追加提交。 |
| **推送 / 拉取 / 获取** | 与远程仓库同步。 |
| **分支管理** | 列出、切换、创建和删除分支。 |
| **储藏** | 储藏、列出、应用和丢弃储藏。 |
| **差异查看器** | 用于已更改文件的内联差异查看器，带有语法高亮的增加和删除内容。 |
| **放弃更改** | 确认后放弃所有未提交的更改。 |
| **初始化和远程仓库** | 初始化新的 Git 仓库，设置或移除远程仓库。 |
| **撤销** | 撤销上一次的提交或撤销一次拉取。 |
| **自动刷新** | 每 30 秒自动轮询一次 Git 状态。 |
### 工作区
通过多个工作区让你的项目井井有条。
| 功能 | 描述 |
|---|---|
| **多个工作区** | 为不同的项目、客户或 Game Jam 创建独立的工作区。 |
| **自定义图标和颜色** | 每个工作区都有独特的图标和颜色，以便快速进行视觉识别。 |
| **快速切换** | 从侧边栏下拉菜单切换工作区。 |
### 分类
使用灵活、丰富多彩的分类来组织项目。
| 功能 | 描述 |
|---|---|
| **创建和自定义** | 从丰富的调色板中创建具有自定义名称和颜色的分类。 |
| **可折叠区域** | 折叠和展开分类区域以保持视图整洁。 |
| **在分类间拖动** | 使用由 `@dnd-kit` 提供支持的排序功能，在分类之间拖动项目。 |
| **按分类过滤** | 按任意分类过滤项目列表。 |
| **启用 / 禁用** | 从“设置”中全局开启或关闭分类。 |
### 新闻推送
随时了解 Godot 社区的最新动态。
| 功能 | 描述 |
|---|---|
| **RSS 订阅源** | 获取并显示与 Godot 相关的新闻和更新。 |
| **缓存** | 为了提升性能，订阅源数据已进行缓存。 |
| **在浏览器中打开** | 点击任意新闻条目以打开完整的文章。 |
### 外观与自定义
让 GodotHub 真正属于你。
| 功能 | 描述 |
|---|---|
| **深色 / 浅色模式** | 在深色和浅色主题之间切换。 |
| **强调色** | 从 18 种预设的强调色中进行选择，或选择任意自定义的十六进制颜色。 |
| **背景颜色** | 使用预设或随机生成来自定义背景。 |
| **“手气不错”** | 一键随机生成独特的配色方案。 |
| **圆角半径** | 从 0px（尖锐）调整到 20px（圆形） - 适用于每个元素。 |
| **UI 密度** | 将内边距和间距从 75%（紧凑）缩放到 125%（宽松）。 |
| **字体缩放** | 将所有文本从 85% 缩放到 130%。 |
| **减少动态效果** | 为了无障碍访问，尽量减少动画。 |
| **侧边栏宽度** | 独立调整展开和收起时的侧边栏宽度。 |
### 设置和首选项
为应用程序的各个方面提供深度的配置选项。
| 功能 | 描述 |
|---|---|
| **存储位置** | 为项目、Godot 版本和模板配置扫描目录。 |
| **启动时自动扫描** | 应用程序启动时自动发现新的项目和版本。 |
| **文件监视器** | 实时检测项目、版本和模板目录中的更改。 |
| **下载并发数** | 控制同时下载的 Godot 版本数量（1 到 10 个）。 |
| **扫描深度** | 配置扫描文件夹的深度（1 到 10 层）。 |
| **启动时关闭** | 启动项目时退出或最小化到系统托盘。 |
| **Godot 关闭后重新打开** | 编辑器关闭时自动恢复 GodotHub。 |
| **托盘菜单** | 系统托盘右键菜单中的最近项目（数量可配置）。 |
| **提示延迟** | 将提示框悬停延迟从 100 毫秒调整到 1000 毫秒。 |
| **命令面板快捷键** | 将 `Ctrl/Cmd +
` 重新绑定为你喜欢的按键。 |
| **导出 / 导入** | 将所有设置以 JSON 格式备份或传输。 |
| **重置和清除** | 将设置恢复为默认值，或彻底清除所有应用数据。 |
### 其他亮点
| 功能 | 描述 |
|---|---|
| **拖放导入** | 将项目文件夹或 `.zip` 版本压缩包直接拖入应用程序窗口。 |
| **命令面板** | `Ctrl/Cmd + P`（或你的自定义按键）可打开强大的命令面板以进行快速导航。 |
| **系统托盘** | 最小化到托盘，右键菜单显示最近打开的项目。 |
| **自定义标题栏** | 无边框窗口搭配自定义标题栏，带来精致、现代的体验。 |
| **启动画面** | 启动时会有动画启动画面迎接你。 |
| **新手引导向导** | 引导首次设置，配置扫描文件夹、分类和外观。 |
| **自动更新** | 启动时检查更新，并通过 Tauri 更新器自动下载新版本。 |
| **错误报告** | 直接从应用程序报告问题。 |
| **更新日志查看器** | 追踪每个 GodotHub 版本中的新功能。 |
| **键盘快捷键** | 随时可查看完整的快捷键速查表。 |
## 安装
### 下载预构建的二进制文件
GodotHub 提供以下桌面应用程序版本：
| 平台 | 安装包类型 |
|---|---|
| **Windows** | `.msi` 或 `.exe` 安装程序 |
| **macOS** | `.dmg` 或 `.app` 包 |
| **Linux** | `.deb`、`.AppImage` 或 `.rpm` 包 |
### 从源码构建
#### 前置条件
| 依赖 | 版本 | 用途 |
|---|---|---|
| [Bun](https://bun.sh) | >= 1.0 | JavaScript runtime 及包管理器 |
| [Rust](https://rustup.rs) | 最新稳定版 | 后端编译 |
| [Tauri 2 前置条件](https://v2.tauri.app/start/prerequisites/) | - | 特定平台的构建工具 |
#### 步骤
```
# Clone 仓库
git clone https://github.com/RykoTheDev/godothub.git
cd godothub
# 安装 frontend 依赖
bun install
# 以 development mode 运行（带 hot-reload）
bun tauri dev
# 为 production 构建
bun tauri build
```
## 键盘快捷键
| 快捷键 | 操作 |
|---|---|
| `Ctrl/Cmd + 1` | 转到项目 |
| `Ctrl/Cmd + 2` | 转到版本 |
| `Ctrl/Cmd + 3` | 转到新闻 |
| `Ctrl/Cmd + 4` | 转到模板 |
| `Ctrl/Cmd + N` | 新建项目 |
| `Ctrl/Cmd + ,` | 打开设置 |
| `Ctrl/Cmd + P` | 切换命令面板 |
| `Escape` | 关闭遮罩层 / 清除选择 |
## 技术栈
| 层级 | 技术 |
|---|---|
| **前端框架** | [React 19](https://react.dev) + [TypeScript](https://www.typescriptlang.org/) |
| **样式** | [Tailwind CSS 4](https://tailwindcss.com) |
| **动画** | [Framer Motion](https://www.framer.com/motion/) |
| **拖放** | [@dnd-kit](https://dndkit.com/) |
| **桌面端框架** | [Tauri 2](https://v2.tauri.app/) (Rust) |
| **图标** | 通过 [react-fontawesome](标签：Godot引擎, Linux 内核安全, PPID欺骗, Tauri, 可视化界面, 安全可观测性, 数据可视化, 游戏开发, 版本控制, 自动化攻击, 项目管理