CAD 图纸操作 · 入口指引
涉及 CAD 图纸操作时，先判断操作侧，再读对应指南执行。
路由规则
| 用户意图 | 操作侧 | 指南 |
|---|---|---|
| 网页中预览、浏览、编辑、绘制、标注、测量、图层管理、导出图纸 | 前端（mxcad） | 前端 mxcad 指南 |
| 服务端处理图纸文件：格式转换、数据提取、参数化绘图生成、切分合并、批量导出 | 后端（MxServiceCode） | 后端 MxServiceCode 指南 |
| 两侧都涉及（如后台生成 DWG 后在网页预览） | 先后端生成，再前端预览 | 依次读两份指南 |
用户未明确前端还是后端时，必须先询问，得到答复后再执行：
您这次是需要在网页中预览编辑图纸（前端 mxcad），还是通过后端服务处理图纸文件（如转换、生成、数据提取）？
线索可辅助判断但不能替代询问："网页/浏览器/嵌入网站/mxcad/mxweb" → 前端；"服务端/Node/批量/生成图纸文件/数据提取/接口" → 后端。
文档链接与程序下载地址
文档链接
| 文档 | 链接 |
|---|---|
| 入口指引（本文件） | 链接 |
| 前端 mxcad 指南 | 链接 |
| 后端 MxServiceCode 指南 | 链接 |
| MxServiceCode 命令参考 | 链接 |
| Mx2DNode 二开 API 参考 | 链接 |
| 部署与启动说明 | 链接 |
程序下载地址
两类包：单独转换程序（MxConvert，仅含 mxcadassembly）与后端服务（MxServiceCode，同时含后端服务和转换程序，即完整超集）。均为试用版（期限 6 个月），托管在外部站点（demo.mxdraw3d.com），直接按绝对地址下载。Linux 包基于 Ubuntu 20.04（Ubuntu20）构建，仅适用于 Ubuntu 20.04 x86_64 及以上兼容环境（如 Ubuntu 22.04）；ARM 机器（uname -m 为 aarch64）或更低版本系统请先停止并向用户确认。
| 程序 | 平台 | 下载地址 |
|---|---|---|
| 单独转换程序 MxConvert（试用版） | Windows | MxConvert_TryVersion.zip |
| 单独转换程序 MxConvert（试用版） | Linux（Ubuntu 20.04 x86_64） | MxConvert_Ubuntu20_TryVersion.zip |
| 后端服务 MxServiceCode（含转换程序 mxcadassembly，试用版） | Windows | MxServiceCode_TryVersion.zip |
| 后端服务 MxServiceCode（含转换程序 mxcadassembly，试用版） | Linux（Ubuntu 20.04 x86_64） | MxServiceCode_Ubuntu20_TryVersion.zip |
固定临时路径（只下载一次，跨会话复用）：
- Windows：
%TEMP%\MxCAD\（%TEMP%为用户 Temp 目录环境变量，命令中直接使用，无需手动展开） - Linux：
/tmp/MxCAD/
程序排查与获取步骤（收到命令后执行）：
第 1 步 判断任务需要什么：只需转换程序（格式转换 / PDF / 图片等 mxcadassembly 调用）或需要后端服务（命令调用 / 二开）。
第 2 步 查看固定临时路径下有哪些东西，按下表处理：
| 临时目录现状 | 本次只需转换程序 | 本次需要后端服务 |
|---|---|---|
| 什么都没有 | 按平台下载单独转换程序（MxConvert）zip，解压到临时路径 | 按平台下载后端服务（MxServiceCode）zip（含转换程序），解压到临时路径 |
只有转换程序（单独包解包，可能不在 MxCAD\Release\ 下） | 直接做试用版过期验证，通过即可用 | 清空临时路径后下载解压后端服务 zip |
有后端服务（已解包，转换程序在 MxCAD\Release\ / Linux\MxCAD\） | 做试用版过期验证 + 包完整性验证，通过即用；不完整则清空后下载单独转换程序 zip 重下 | 检查工程目录 MxServiceCode\MxServiceCode 完整，完整即用；不完整则清空后下载后端服务 zip 重下 |
注意各包目录结构固定：两个 zip 解压后都只有一个顶层目录（与 zip 同名：
MxConvert_TryVersion\/MxServiceCode_TryVersion\）；单独转换程序包的转换程序文件（mxcadassembly.exe、fonts\ 等）直接在该顶层目录里，后端服务包在该目录下含MxServiceCode\+MxCAD\Release\（Windows）/MxServiceCode\+Linux\MxCAD\（Linux）两个子目录。因此重新下载前必须先清空临时路径（后端包是完整超集，同时含后端与转换程序，清空重解不会丢东西）。系统清理临时目录后重新下载即可。不要扫描用户机器其他目录。