# urdf-studio-web

**Repository Path**: futurelei/urdf-studio-web

## Basic Information

- **Project Name**: urdf-studio-web
- **Description**: 基于开源的urdf-studio-web的仓库
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-06-27
- **Last Updated**: 2026-06-27

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# URDF Studio 离线部署

[urdf.d-robotics.cc](https://urdf.d-robotics.cc/) 的离线构建版本。

基于开源仓库 [URDF-Studio](https://gitee.com/zjzcn/URDF-Studio) (Apache-2.0) 构建。

## 使用

```bash
cd urdf-studio-web

# 启动服务器 (需要 COOP/COEP 头支持 SharedArrayBuffer)
python3 serve.py          # 默认 8080 端口
python3 serve.py 3000     # 自定义端口
```

浏览器打开 **http://localhost:8080**

> 不能直接双击 `dist/index.html` 打开。
> USD 导入功能需要 `Cross-Origin-Opener-Policy: same-origin` 和
> `Cross-Origin-Embedder-Policy: require-corp` 响应头，因此必须使用提供的 `serve.py`。

## 功能

| 功能 | 离线可用 |
|---|---|
| URDF 可视化与 3D 渲染 | ✅ Three.js 本地渲染 |
| 骨架模式编辑 | ✅ 纯前端 |
| 细节模式编辑 (碰撞体/视觉) | ✅ |
| 硬件参数配置 | ✅ |
| STL/OBJ/DAE 网格导入 | ✅ |
| URDF 导出 | ✅ |
| USD 导入/导出 | ⚠️ 需 `/api/write-usd-export` 后端 |
| AI 审阅 | ❌ 需 OpenAI API Key |
| 在线体验 | → [urdf.d-robotics.cc](https://urdf.d-robotics.cc/) |

## 构建

```bash
git clone https://gitee.com/zjzcn/URDF-Studio.git
cd URDF-Studio
npm install
npm run build
# dist/ 即为可部署目录
```

## 许可

Apache-2.0 License. 原项目版权归 OpenLegged 所有。