# 灵心巧匠 · 机器人装配演示 基于 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 ``` 打开 ,会自动进入 `/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 拼装、移除首页登录入口、本体库切换刷新及项目菜单遮挡修复。