CAD Viewer 是一款专为读取和分析 CAD 图纸文件（DWG/DXF 格式）而设计的专业工具。它提供了一套结构化的数据提取与分析能力，能够解析图纸中的几何实体、图层组织、块定义与引用，并支持空间关系计算和合规性审计。该工具适用于需要快速理解复杂工程图纸内容的技术人员，尤其擅长从电力、数据中心等行业的标准化图纸中自动提取关键信息。所有操作均通过命令行接口完成，输出为标准 JSON 格式，便于集成到自动化流程或与其他系统对接。 使用 CAD Viewer 前需注意其依赖环境要求：系统需为 x86_64 Linux 架构并安装 Python 3.8+。首次运行将自动下载并配置必要的组件，包括 ODA File Converter（用于 DWG 文件支持）和 QCAD dwg2bmp（用于高质量截图）。用户可选择手动安装以增强安全性，也可通过交互式脚本确认后自动完成部署。工具内置环境检测功能，可检查各组件状态并提供修复建议，确保分析过程稳定可靠。 CAD Viewer 的核心优势在于其全面的功能覆盖与高效的数据处理能力。无论是查看图纸基本信息、遍历图层结构、定位特定设备实例，还是测量距离、生成可视化图像或执行合规检查，均可通过单一命令实现。特别地，其对大型工程图纸具有良好的容错性和响应速度，即使面对坐标值达数百万量级的真实项目文件也能快速加载。此外，所有错误信息均以结构化方式输出至 stderr，便于程序化处理，极大提升了在 CI/CD 或批量分析场景下的可用性。
核心功能特点
- 支持 DWG 和 DXF 格式的图纸文件读取与分析
- 提供完整的图纸元数据获取，包括版本、单位、实体统计等信息
- 可按类型、图层或关键词筛选并列出模型空间内的几何实体与块引用
- 支持按坐标或实体对象计算两点间的二维与三维距离
- 具备截图功能，可截取指定区域、层或块的高清图像（支持 PNG/PDF/SVG）
- 内置合规性审计模块，自动检测零层违规、图层混用等问题
适用场景
CAD Viewer 特别适合在缺乏原生 CAD 软件许可的情况下进行图纸审查和技术分析。例如，在电力系统设计中，工程师常需快速统计某变电站的断路器数量、母线布局或电缆路径长度，此时可通过 `inserts` 命令筛选特定名称的块实例，再结合 `distance` 测量关键间距，显著提升设计校核效率。对于数据中心基础设施管理（DCIM），该工具能自动识别机柜、UPS 和配电单元的位置分布，并验证其是否符合最小安全距离规范。 另一个典型应用场景是跨部门协作时的图纸标准化审核。当接收外部提交的 DWG 文件时，使用 `audit` 命令可一次性发现潜在问题，如 INSERT 实体被错误放置于默认图层 0，或 DEFPOINTS 层上存在非打印元素，从而避免后续返工。同时，`texts` 命令可用于提取设备标签、电压等级等注释信息，辅助资产台账构建。若需向非技术人员展示某段线路走向，则可通过 `screenshot` 生成局部视图图片，嵌入报告或演示文稿中。 在运维与故障诊断方面，运维团队可利用 CAD Viewer 快速定位故障点周边设备。例如，当某条馈线中断时，先通过 `search` 查找相关变压器、开关柜等组件，再用 `layer-content` 深入分析其所处图层的拓扑连接关系，最后调用 `distance` 验证物理隔离是否满足检修要求。整个过程无需打开重型 CAD 软件，仅凭命令行即可完成初步研判，大幅缩短响应时间。