53 lines
2.1 KiB
Markdown
53 lines
2.1 KiB
Markdown
# 灵心巧匠 · 机器人装配演示
|
|
|
|
基于 React、TypeScript 和 Three.js 的机器人三维装配工作台。本仓库保存可直接运行的本地版本,默认进入 O6 灵巧手拼装页面,无需登录或配置业务后端。
|
|
|
|
## 启动
|
|
|
|
使用 Node.js 22.12 或更高版本,并安装 pnpm 和 Git LFS。模型及图片资源通过 Git LFS 保存。
|
|
|
|
```bash
|
|
git lfs install
|
|
git clone https://gitea.robotquan.com/xuyongjie/robot-assembly.git
|
|
cd robot-assembly
|
|
git lfs pull
|
|
pnpm install --frozen-lockfile
|
|
pnpm dev --host 127.0.0.1 --port 5173 --strictPort
|
|
```
|
|
|
|
打开 <http://127.0.0.1:5173/>,会自动进入 `/workbench` 装配页面。首次打开默认选择 `O6_new`,之后会记住浏览器中选择的项目。
|
|
|
|
## 页面与操作
|
|
|
|
- `/workbench`:装配工作台;点击左侧步骤播放装配动画,右侧查看流程图和零件。
|
|
- `/library`:本体库;包含 A7 机械臂、O6 灵巧手、O6 新版和 O6 手指模组。
|
|
- `/customize`:改装页面。
|
|
- 顶部“当前项目”菜单可以切换本体,切换后自动重新加载装配数据。
|
|
- 三维视图支持左键旋转、右键平移和滚轮缩放。
|
|
|
|
## 构建
|
|
|
|
```bash
|
|
pnpm build
|
|
pnpm preview --host 127.0.0.1
|
|
```
|
|
|
|
构建产物在 `dist/`。部署到静态服务器时,需要将前端路由回退到 `index.html`。
|
|
|
|
## 源码和资源
|
|
|
|
```text
|
|
src/assets/ GLB、URDF、STL 模型和项目缩略图
|
|
src/data/ 各本体的装配 JSON、项目配置和资源注册
|
|
src/features/ 装配步骤、动画、流程图、本体库及改装功能
|
|
src/scene/ Three.js 场景、相机、灯光及零件渲染
|
|
src/layout/ 页面布局
|
|
src/styles/ 样式和设计变量
|
|
scripts/ 模型处理、URDF 检查与缩略图脚本
|
|
pose-corrector/ 辅助姿态校正工具
|
|
```
|
|
|
|
模型资源通过本仓库的 Git LFS 一同保存;`node_modules/`、构建产物及本地缓存不进入版本控制。克隆时需要启用 Git LFS,已有克隆可运行 `git lfs pull` 下载实际模型文件。
|
|
|
|
本地版本基于原项目 `8bd1a32`,已加入默认进入 O6 拼装、移除首页登录入口、本体库切换刷新及项目菜单遮挡修复。
|