前言¶

做 BIM 或算量系统的人经常遇到同一个麻烦：CAD 图纸能被打开，却不容易被程序读懂。图层名有历史遗留、块名带乱码、文字样式不统一、同一个门在平面图和门窗表里的标注对不上。直接拿 CAD SDK 写解析，前两周都在处理这些脏数据，最后才轮到真正的识图逻辑。

下面介绍的这个 Skill 把前半段脏活包掉了：它本地读取 DWG/DXF/DWT/PDF，把图纸里能识读的内容抽成带坐标、带复核原因的候选对象，交给下游算量或审图技能使用。它本身不做最终工程量。

这是什么¶

Skill 名称：CAD 图纸识图与证据提取。

由 SkillHub 上的 user_43faedd6 发布维护，坐标 @user_43faedd6/cad-file-reader，当前版本 0.38.3，来源 community，分类 professional。页面标签 requires_api_key=false，说明不需要额外的 API key。抓取时页面显示评分 100000、下载 28314、安装 0。

解决的问题是：把一张 CAD 图纸从「文件」变成「结构化识图结果」，并且每一条结果都能追溯回图纸上的某个位置和判断依据。

核心功能¶

输入与解析路径¶

支持四类输入：AutoCAD DWG、DXF、DWT，以及 PDF 图纸。

1、DWG/DXF/DWT 走流式解析，边读边解析，适合大图。
2、PDF 走本机分流加本地 OCR，OCR 在本地执行，不把图纸内容送到外部服务。

两条路径的产出统一走同一套候选契约，下游不需要区分图纸来源。

输出契约¶

Skill 只输出识图与测量候选，不输出工程量。

具体约束是：所有结果 final_quantity=false。它不计算最终工程量、材料量、造价或结算量，这些交给专项算量技能完成。

每条候选都带两样东西：证据坐标，以及复核原因。坐标指向图纸上产生该结论的位置，复核原因说明为什么这个结论成立或需要人工再看一次。这比只给一个对象名可靠，因为下游可以在图纸上回溯验证。

提取范围¶

按基础元素、识图候选、拓扑、测量、元数据分五类。

基础元素：图层、文字、块、图框、几何。

识图候选覆盖的专业：建筑、结构、总图场地、安装、电气、钢结构、市政、给排水暖通、精装修、幕墙、人防、预制装配、园林景观。

其中园林景观做了针对性处理：苗木图例识别、乔灌地被候选、铺装闭合环识别、设计院校准。另外还有 DWG 块名净化，以及在块名不可用时自动转 DXF 复扫一遍。

系统拓扑：输出 MEP 等系统的连接拓扑候选。

测量候选：长度、面积、体积的测量候选。

规范图集元数据：抽取图纸中引用的规范与图集信息，作为单独一类元数据返回。

P0–P5 优化¶

简介中列了六个阶段的内置优化，按 P0 到 P5 编号。

P0：统一候选契约与置信度分层，让不同来源的候选可以比较和排序。
P1：大图缓存与局部解析，避免重复解析整张图。
P2：图层与块的语义增强，处理命名不规范的问题。
P3：MEP 拓扑增强。
P4：图纸对比，用于多版本图纸之间的差异核对。

这些优化的存在意味着解析过程不是一次性全量扫描，而是可以按区域、按置信度做增量处理。

安装与启用¶

官方地址：https://api.skillhub.cn/user_43faedd6/cad-file-reader

SkillHub 页面：https://www.skillhub.cn/skills/user_43faedd6/cad-file-reader

已抓取资料里只给出了坐标、版本、分类和标签，没有列出安装命令、目录结构或配置字段，也没有分别说明 Cursor / Codex CLI / Claude Code 的接入差异。此处不臆测命令，接入方式以官方页面为准。

可以确认的一点是标签 requires_api_key=false，即不需要申请 API key。版本号以 0.38.3 为准。

典型用法¶

资料中没有提供可复现的官方调用示例，下面的用法说明基于公开简介描述的输入输出契约，属于示意，未经官方资料核对。

1、把 DWG 或 DXF 图纸路径交给 Skill，走流式解析。
2、把 PDF 图纸交给 Skill，走本机分流加本地 OCR。
3、接收候选列表，每条候选包含证据坐标与复核原因。
4、筛掉复核原因标注为需要人工确认的候选，或先送人工复核。
5、把剩余候选交给算量类专项技能，由后者计算最终工程量。

因为 final_quantity=false，这条链路上不要指望从该 Skill 直接拿到工程量数字，它产出的是识图中间结果。

适用场景与注意¶

适合谁：需要把 CAD 图纸结构化后接自建算量、审图、图纸对比流程的开发方；以及想省掉 CAD SDK 解析层自研工作的团队。

限制：

1、最终工程量、材料量、造价、结算量不在本 Skill 范围内，必须接专项算量技能。
2、输出是候选而非结论，置信度分层需要下游自己使用，不能默认全部候选可直接入库。
3、DWG 块名不可用时会转 DXF 复扫，这是兜底路径，结果可能与原始 DWG 解析存在差异，建议把复扫标记保留下来。
4、PDF 路径依赖本机 OCR，识别质量受图纸清晰度和 OCR 环境影响，文字密集的图纸需要人工抽检。
5、版本号与评分、下载量为抓取时页面数据，接入前请以官方页面当前值为准。

结尾¶

这个 Skill 的价值在中间层：它把「图纸能打开」推进到「图纸能被程序读出带坐标的识图候选」，同时明确划出边界，不碰最终工程量。如果你的流程里缺的是这一步中间结果，可以直接从官方地址接入；如果缺的是算量本身，需要再配一个专项技能。

官方地址：https://api.skillhub.cn/user_43faedd6/cad-file-reader