Files
frontend/README.md
T
2026-10-15 10:35:55 +08:00

2.2 KiB
Raw Blame History

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。
  • 本地版本保存包含视角、显示状态及装配关节角度。

详细说明见 前台说明、零件命名与旋转轴、后端匹配说明。