Sand3D Assets Explorer

Sand3D Assets Explorer

以 3D 方式浏览 Sand3D 物体，移动它们的关节，并显示每个物体背后的 Python 程序。适合想在浏览器里检查这类仿真风格 3D 资产的人。

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

简介

它是什么：Sand3D Assets Explorer 是一个用来浏览 Sand3D 物体的网页应用。你可以在 3D 里打开一个物体，移动它的关节，并阅读描述它的 Python 程序。它由一个较早的浏览器里的 Sand3D 部分构建而来，并列出数据集 Sandflow/sand3d-automate。

适合谁：处理带关节的 3D 物体、想在一个地方检查部件、运动和代码的人，也适合想看这类查看器怎样构建的开发者。

行业 | 使用者 | 使用方式 | 例子
仿真 | 处理 3D 资产的工程师 | 在使用物体之前检查部件和关节运动 | 播放一个运动，观察各个部件
研究 | 研究者 | 浏览一个物体数据集并阅读它们的程序 | 搜索一个物体并打开它的 Python 代码
软件 | 开发者 | 研究一个基于 USD 文件的查看器 | 在本地副本里读 src 和 backend 文件夹
教育 | 学生 | 看关节和部件之间的关系 | 拖动 Explode 滑块

如果你只需要平面的图片库，可以跳过它。

用在哪里：这个浏览器可以在这些地方运行：

• 网页浏览器：打开 Hugging Face 上的 Space 页面直接使用。
• 装有 Docker 的 Windows、macOS 或 Linux：在自己的电脑上构建并运行一份副本。

Use case | Who | What they get back
检查一个物体 | 工程师 | 带部件、网格和材质的交互式 3D 视图
测试关节运动 | 研究者 | 勾选的运动在播放或暂停，每个都有滑块
阅读并复制程序 | 开发者 | 带行号的物体 Python 源码，可复制或下载
收集原始文件 | 任何人 | 一个装有原始文件的下载篮

如何设置：在线使用不需要任何准备。要用本地副本，你需要这几样：

• 带 pip 的 Python，用来取文件
• huggingface_hub 包，第一条命令会安装它
• Docker，因为这个 Space 由 Dockerfile 构建

这些步骤会下载 Space，用它构建一个 Docker 镜像，再在打开 7860 端口的情况下运行镜像。

1. 安装 Hugging Face 包。
2. 把 Space 下载到名为 Sand3D-assets-explorer 的文件夹。
3. 进入这个文件夹。
4. 构建 Docker 镜像。
5. 打开 7860 端口并运行镜像。

pip install -U huggingface_hub
hf download fffiloni/Sand3D-assets-explorer --repo-type space --local-dir Sand3D-assets-explorer
cd Sand3D-assets-explorer
docker build -t sand3d-assets-explorer .
docker run -it -p 7860:7860 sand3d-assets-explorer

如何使用：打开 Space 页面，或者运行上面的最后一条命令，然后在浏览器里打开你自己电脑的 7860 端口。用平移和缩放在画布上移动。搜索一个物体，按来源或运动缩小列表，然后选中一个在 3D 里打开。拖动它可以旋转，拖动背景可以平移。

Tool | What it does
Materials、Parts、Meshes | 三种显示模式：原始材质、每个部件一种颜色、表面边线
Explode 滑块 | 把网格部件拉开以便检查
运动清单 | 选择哪些关节一起运动，带 Play、Pause 和 Reset
Python 阅读器 | 显示物体的程序，带行号、复制和下载
下载篮 | 收集你想要的原始文件

示例：你搜索一个物体，选中它，勾选它的一个运动。按下 Play，看关节动起来，然后打开 Python 阅读器，复制这个物体的程序。

新手与专家：如果你是新手，先打开 Space 页面，随便选一个物体，对一个运动按下 Play。然后打开 Python 阅读器，看它背后的代码。显示设置里的任何改动都不会改变你下载的文件。

如果你熟悉这个领域：这个查看器基于 USD 渲染器工作，不需要转换成 GLB。Parts 模式给每个命名的 USD 网格一种独立颜色，超过 250,000 个三角形的物体使用着色器线框，让边线的准备工作保持有界。数据集的源文本在显示时会被转义，绝不会被执行。

你搜索或筛选物体画布
你选中一个物体，在 3D 里打开
你播放关节并检查部件
你阅读它的程序或下载原始文件

注意事项：README 很长，页面控件也很多，所以请用较宽的窗口打开，这样能看到侧边面板。

• License: apache-2，按 Space 所列。物体在应用里带有各自的来源和许可信息。
• Cost to run: 未提及。托管的 Space 运行在 Hugging Face 的 cpu-basic 硬件上。
• Data it reaches: 它列出的 Sand3D 数据集 Sandflow/sand3d-automate。数据集里的代码只显示，从不运行。
• Not for: 编辑物体。显示模式只改变视图，所以你下载的文件保持原样。

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

• 点赞：1
• 构建方式：docker
• 许可证：apache-2.0

链接

• Space：https://huggingface.co/spaces/fffiloni/Sand3D-assets-explorer
• 文件：https://huggingface.co/spaces/fffiloni/Sand3D-assets-explorer/tree/main

试用

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