Files
robot-assembly/README.md
T

2.1 KiB

灵心巧匠 · 机器人装配演示

基于 React、TypeScript 和 Three.js 的机器人三维装配工作台。本仓库保存可直接运行的本地版本,默认进入 O6 灵巧手拼装页面,无需登录或配置业务后端。

启动

使用 Node.js 22.12 或更高版本,并安装 pnpm 和 Git LFS。模型及图片资源通过 Git LFS 保存。

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:改装页面。
  • 顶部“当前项目”菜单可以切换本体,切换后自动重新加载装配数据。
  • 三维视图支持左键旋转、右键平移和滚轮缩放。

构建

pnpm build
pnpm preview --host 127.0.0.1

构建产物在 dist/。部署到静态服务器时,需要将前端路由回退到 index.html。

源码和资源

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 拼装、移除首页登录入口、本体库切换刷新及项目菜单遮挡修复。