main
CAD World 前台
机器人设计与装配工作台。用户输入文字或图片需求后,前台请求业务后端,加载返回的 components、URDF 和网格文件,并按接口坐标装配展示。
目录
Client/:React、TypeScript、Vite 前台源码、开发代理、测试与文档。shared/:前台所需的 API 环境路由、对象存储地址、零件命名、旋转轴等公共模块。请与Client/一起保留。
本仓库只包含设计前台及其依赖,管理后台和社区项目分别维护。
本地运行
要求 Node.js >= 22.12.0。
cd Client
npm ci
npm run dev
访问 http://127.0.0.1:8091/。默认通过本地代理请求开发 API;需要覆盖时,复制 Client/.env.example 为 Client/.env.local 并修改 ROBOT_API_TARGET。
验证与打包
在 Client/ 目录执行:
npm test
npm run build
构建输出为 Client/dist/,将其内容部署到网站目录即可。源码仓库不提交依赖目录、构建产物或本地环境文件。
环境与资源
| 网站 | API |
|---|---|
| 本机 / 局域网 | 本地开发代理,默认连接开发 API |
dev-cadworld.robotquan.com |
https://dev-cadworld-api.robotquan.com |
cadworld.robotquan.com |
https://cadworld-api.robotquan.com |
模型资源直接从 https://linkerbot.oss-cn-beijing.aliyuncs.com 下载。后端和对象存储需允许相应网站来源跨域。
静态网站如使用 history 路由,Nginx 配置路由回退:
location / {
try_files $uri $uri/ /index.html;
}
装配与交互
- 返回的零件全部进入画布,不加载默认机器人;无法唯一配对的零件仍单独展示。
- 安装对齐使用父接口变换乘以子接口变换的逆,不按部件名称猜测方向或额外翻转模型。
- 保留 URDF 自带的几何体、关节与坐标;可选
rotationAxis在装配连接点增加活动关节。 - 零件库按组件实例展示;物料清单读取后端返回的
component.bomList。 - 本地版本保存包含视角、显示状态及装配关节角度。
Description
Languages
TypeScript
44.9%
JavaScript
43.6%
CSS
11.4%
HTML
0.1%