Drawing Analyzer

核心功能

Drawing Analyzer 是一款面向建筑工程领域的图纸智能解析工具，支持从 PDF 和 DWG 文件中自动提取结构化数据，包括图框信息（项目名称、图号、比例、日期等）、尺寸标注、注释说明、符号图例及材料表内容，并可生成工程量清单（Quantity Takeoff）与图纸索引。

显著优点

1. 自动化数据提取：通过正则表达式与 PDF 文本解析，自动识别英制/公制尺寸、房间编号、门窗标记、 keynote 注释等，替代人工读图录入。
2. 质量审查辅助：内置图纸完整性检查，可自动识别缺失图号、比例、日期等关键图框信息，辅助设计审查。
3. 多格式支持：基于 pdfplumber 处理 PDF，可扩展支持 DWG 等 CAD 格式，兼容主流设计交付物。
4. 结构化输出：提供 Dataclass 标准数据结构，便于对接造价软件、BIM 平台或项目管理系统的 API。

潜在局限

1. OCR 依赖局限：纯文本解析无法处理扫描版 PDF 或图片式图纸，需配合 OCR 预处理；复杂图形元素（如填充图案、线型）无法识别。
2. 正则匹配边界：尺寸与标注的提取依赖预设正则模式，非标准写法或手写标注易漏检；多语言图纸支持有限。
3. 坐标信息缺失：当前实现中元素位置为占位值 (0,0)，缺乏真实空间坐标，无法支持基于位置的智能算量或碰撞检查。
4. DWG 支持待完善：当前示例以 PDF 为主，原生 DWG 解析需依赖 ezdxf 或 AutoCAD COM 接口，未完整展示。

适合人群

• 工程造价师与 QS（Quantity Surveyor）：快速提取构件数量、尺寸，辅助预算编制
• 设计院审图人员：批量检查图纸完整性、图框规范性
• 施工总包技术部门：建立图纸索引、跟踪版本修订
• 建筑信息化开发者：作为图纸数据ETL管道的前置模块

常规风险

• 数据准确性风险：自动提取结果需人工复核，不可直接用于结算或关键决策
• 版本兼容性：PDF 生成方式多样（CAD 打印、扫描、设计软件导出），解析成功率存在差异
• 敏感图纸泄露：上传含项目信息的图纸至第三方服务时需注意数据安全与保密协议
• 开源依赖维护：核心依赖 pdfplumber 更新迭代可能影响解析稳定性

核心功能与用法

drawing-analyzer 是一款面向建筑工程领域的专业图纸解析工具，基于 Python 实现，能够从 PDF/DWG 格式的施工图中提取关键信息。核心能力包括：

• 图框信息识别：自动提取项目名称、图号、专业、比例、日期、版本、签字栏等 Title Block 元数据
• 尺寸数据提取：支持英制（英尺-英寸，如 10'-6 1/2"）与公制（mm/cm/m）单位的线性尺寸解析
• 标注符号识别：自动分类 keynote、房间编号、门窗标记、轴线、标高、详图索引等常见标注类型
• 图例表解析：从表格中提取门窗表、设备表等 Schedule 数据，生成结构化 Symbol 对象
• 质量检查：自动检测图纸完整性（缺失项目编号、比例、日期等常见疏漏）

使用方式简洁，初始化 DrawingAnalyzer 类后，调用 analyze_pdf_drawing() 即可完成单张图纸分析，返回结构化数据对象，支持生成 Markdown 格式的审图报告与图纸目录。

显著优点

• 专业领域适配：内置建筑行业特有的正则表达式模式，对施工图惯用标注方式识别率高
• 输出结构化：采用 dataclass 定义标准数据模型（TitleBlockData、Dimension、Annotation、Symbol），便于后续系统集成
• 多格式支持：基于 pdfplumber，既可处理文本层 PDF，也能提取表格数据
• 可扩展架构：模块化设计便于添加新的图元识别规则或导出格式

局限性与注意事项

• 无图像分析能力：当前仅解析 PDF 文本层，无法处理扫描件或纯图像型图纸；drawing_area 等几何信息为占位值，实际需结合图像分析
• 精度依赖图纸规范性：图框解析基于正则表达式，对非标准图框或版式差异较大的图纸可能识别失效
• 外部依赖单一：核心功能依赖 pdfplumber，若 PDF 结构复杂（如嵌套旋转、多层遮罩），提取效果可能受限
• 无 DWG 原生支持：描述中提及 DWG，但示例代码仅演示 PDF 解析，DWG 需额外依赖（如 ezdxf 或 AutoCAD API）

适合人群

• 建筑工程造价师、估算员：快速提取工程量数据，辅助 Quantity Takeoff
• 设计审查工程师：批量检查图纸完整性，自动化合规性审查
• BIM 数据录入人员：将传统 CAD 图纸信息结构化，导入项目管理系统
• 施工管理团队：建立项目图纸目录，追踪版本与修订

常规风险提示

• 数据隐私：建筑图纸常包含客户信息、项目地址等敏感内容，建议在本地或受控环境运行，避免上传至公共云服务
• 结果校验：自动提取的尺寸、图号等关键数据需人工复核，避免因 OCR 误差导致施工错误
• 依赖维护：pdfplumber 更新可能带来 API 变动，建议锁定版本或持续测试

安全评估

根据 CLS-Certify 深度扫描报告，该 skill 获得 A 级（85 分）认证，无任何安全威胁发现。六维评估均通过：静态代码无危险函数、动态行为无可执行风险、依赖无 CVE 漏洞、无网络外泄、隐私合规达标、来源为可信组织（T2 级）。