Files
2026-10-15 10:35:55 +08:00

62 lines
2.2 KiB
Markdown
Raw Permalink Blame History

This file contains ambiguous Unicode characters
This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.
# CAD World 前台
机器人设计与装配工作台。用户输入文字或图片需求后,前台请求业务后端,加载返回的 `components`、URDF 和网格文件,并按接口坐标装配展示。
## 目录
- `Client/`:React、TypeScript、Vite 前台源码、开发代理、测试与文档。
- `shared/`:前台所需的 API 环境路由、对象存储地址、零件命名、旋转轴等公共模块。请与 `Client/` 一起保留。
本仓库只包含设计前台及其依赖,管理后台和社区项目分别维护。
## 本地运行
要求 Node.js >= 22.12.0。
```sh
cd Client
npm ci
npm run dev
```
访问 `http://127.0.0.1:8091/`。默认通过本地代理请求开发 API;需要覆盖时,复制 `Client/.env.example` 为 `Client/.env.local` 并修改 `ROBOT_API_TARGET`。
## 验证与打包
在 `Client/` 目录执行:
```sh
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 配置路由回退:
```nginx
location / {
try_files $uri $uri/ /index.html;
}
```
## 装配与交互
- 返回的零件全部进入画布,不加载默认机器人;无法唯一配对的零件仍单独展示。
- 安装对齐使用父接口变换乘以子接口变换的逆,不按部件名称猜测方向或额外翻转模型。
- 保留 URDF 自带的几何体、关节与坐标;可选 `rotationAxis` 在装配连接点增加活动关节。
- 零件库按组件实例展示;物料清单读取后端返回的 `component.bomList`。
- 本地版本保存包含视角、显示状态及装配关节角度。
详细说明见 [前台说明](Client/README.md)、[零件命名与旋转轴](Client/docs/part-naming.md)、[后端匹配说明](Client/docs/backend-direct-matching.md)。