Car Garage Academy

Car Garage Academy

通过浏览器里的交互式 3D 课程，教你汽车是怎么制造和维修的，包含课程、测验、刹车作业、发动机装配和故障排查游戏。适合学生和汽车爱好者。

由 hmb 在 Hugging Face 上制作。这些说明是 Mindket 根据它的 Space 页面和 README 写的，应用自己的文件和许可证在 Hugging Face 上。

简介

它是什么：这个 Space 是一门关于汽车如何制造和维修的交互式 3D 课程。它展示来自 NVIDIA SimReady 资产数据集的真实 3D 零件，提供引导式课程、两个装配任务和一个故障排查游戏。它在 Hugging Face 的 cpu-basic 硬件上运行。

适合谁：适合喜欢在屏幕上动手摆弄零件来学习的人，也适合想看看 Gradio 服务器如何搭配 three.js 查看器的开发者。

Industry | Who uses it | How they use it | Example
教育 | 学生和爱好者 | 学习汽车各系统如何配合 | 学习刹车课程并回答它的测验
汽车培训 | 培训师和讲师 | 把装配和诊断游戏当作练习 | 把前刹车作业布置为动手练习
网页开发 | 开发者 | 研究带 3D 前端的 Gradio 服务器 | 阅读游戏逻辑如何作为 API 端点提供

如果你需要某一辆具体车的维修手册，可以跳过它，因为这是一个教学游戏。

用在哪里：你可以在这些地方使用它：

• 浏览器：打开 Hugging Face 上这个 Space 的页面，不需要安装任何东西。
• Windows、macOS 或 Linux：用 Python 运行你自己的副本。

Use case | Who | What they get back
引导式课程 | 学习者 | 七个汽车系统的课程，每课以测验结尾
装配练习 | 爱好者 | 前刹车作业和发动机装配顺序的得分
故障排查 | 受训者 | 一个要用修理厂测试去找出的隐藏故障

如何设置：如果要在本地运行副本，你需要先准备：

• Python 和 pip
• 一个用来运行命令的终端

在线页面不需要这些。若要运行你自己的副本，请按下面的步骤操作。

1. 安装 Hugging Face 工具。
2. 把这个 Space 的文件下载到一个文件夹。
3. 进入那个文件夹。
4. 安装 Space 使用的版本的 Gradio，再安装其他依赖包。
5. 启动应用。

pip install -U huggingface_hub
hf download hmb/car-garage-academy --repo-type space --local-dir car-garage-academy
cd car-garage-academy
pip install gradio==6.30.0
pip install -r requirements.txt
python app.py

应用默认监听 7860 端口，并读取 PORT 和 HOST 环境变量。只有在你修改了资产列表时，才需要重新构建 3D 模型。这一步会安装更多的包并运行两个脚本。

pip install usd-core trimesh pillow huggingface_hub playwright
tools/convert_all.sh
tools/pack_all.sh

如何使用：在浏览器里打开这个 Space，或者用下面的命令启动你自己的副本。然后选一个模式，一步步完成。

python app.py

Tool | What it does
Learn | 关于车架、发动机、刹车、传动系统、冷却、电气和排气的引导式课程，每课都有测验
Build | 带工具箱和扭矩规格的前刹车作业，以及发动机装配顺序挑战
Diagnose | 从 8 个场景中隐藏一个故障，通过消耗修理厂时间的测试把它找出来
Progress | 当前浏览器会话的得分、徽章和历史

示例：你开始诊断模式。服务器会在某个部件里藏一个故障。你运行万用表或 OBD-II 扫描仪之类的测试，这会用掉修理厂时间，然后读取结果，再指出出故障的部件。

新手与专家：如果你是新手，先从一节课程开始，比如刹车。旋转 3D 零件，阅读说明，并完成结尾的测验。

如果你熟悉这个领域，后端是一个作为 FastAPI 应用运行的 Gradio 服务器。游戏逻辑放在排队的 API 端点后面，所以答案不会离开服务器。前端是纯 HTML 和 JavaScript，配合 three.js。转换脚本把每个资产的 USD 材质变成带贴图的 GLB，然后 gltfpack 对它简化并压缩。

打开课程页面
选择 Learn、Build 或 Diagnose
浏览器请求服务器 API
服务器检查你的答案
得分和徽章被保存

注意事项：进度按浏览器会话保存，所以不会跟着你转到另一个浏览器。来源注明了一张 CC0 的影棚灯光图，以及为引导装配步骤预先生成的朗读语音。

• License: cc-by-4
• Cost to run: 未提及
• Data it reaches: 你在浏览器会话中的进度，以及重新构建 3D 模型时用到的 NVIDIA SimReady 资产数据集

Hugging Face 上的数据（2026年11月13日）

• 点赞：4
• 构建方式：gradio
• 许可证：cc-by-4.0

链接

• Space：https://huggingface.co/spaces/hmb/car-garage-academy
• 文件：https://huggingface.co/spaces/hmb/car-garage-academy/tree/main

试用

在浏览器里打开这个 Space，或在它的页面上把它复制到你自己的 Hugging Face 账号。这个工具包里没有会自己运行的东西。