go-cad:零 cgo 读写 DWG/DXF,把中文施工图拆成 AI 能读的一页页

纯 Go 的 CAD 解析库:R9~R2018 读取、六代 DWG 容器写出、37 张语料与 LibreDWG 值级对齐 100%、自动识别图框逐幅出图。附仓库实测(18 次提交、0 Release、140 个 Go 文件)、中文码页处理、CLI / docling / WorkBuddy 三条接入路径,以及五条明确边界。

图:go-cad 封面——纯 Go 的 CAD 解析库

CAD 图纸一直是文档解析链路上最硬的一块。DWG 是二进制闭源格式,主流方案要么依赖 LibreDWG 的 C 实现,要么得装 AutoCAD。go-cad 是纯 Go 实现的 DWG/DXF 解析、渲染与写出库——零 cgo、无外部二进制,可直接嵌进 Go 服务;能把图纸转成 PNG/SVG,识别图框并逐幅拆图,提取中文说明与设备标注,也能把文档模型写回 DWG。

项目:https://github.com/unitedrhino/go-cad (Apache-2.0 · Go)

本文整理自「云物通科技」2026-10-09 的公众号推文。仓库数字为 2026-11-09 通过 GitHub REST API 与仓库文件树实测,非引用二手报道。


01 · 能力速览

维度当前支持
DWG 读取R9/R10/R11、R13~R2018 容器
DWG 写出R2000~R2018 六代容器
格式转换DXF 读写、LibreDWG 风格 JSON 导入
图纸预览PNG、SVG,中文与尺寸标注
自动拆图图框识别、图号图名提取、逐幅出图
文本提取文字、坐标、图层、图框归属
集成方式Go 模块 / 联犀 CLI / docling

02 · 仓库实测:一个刚满 6 周的项目

先把成熟度摆清楚,再谈能力。

维度实测值备注
Star / Fork80 / 16订阅者 1 人
建库 / 最近 push2026-09-29 / 2026-10-24存续 41 天,最近 push 距今 16 天
Commit 总数18集中式开发, contributors 接口返回空
Release0无版本发布,只能 go get 主干
Open issue2社区反馈回路尚未形成
仓库文件235 个 blob / 4.9 MB140 个 .go、57 个 .dwg 语料、2 篇 .md
语言构成Go 100%(2.37 MB)无 C 依赖
CI1 个 job(Go 1.25)gofmt + go vet + go test -cover
许可证Apache-2.0相对 LibreDWG 的 GPL,可闭源集成

结论很直白:这不是一个社区成熟项目,而是一份工程验证材料写得相当完整的新库。README 里最值钱的不是功能清单,是「37 张语料值级对齐」「147 张语料全链路」「1000+ 变异输入零 panic」这类可核对的验证记录。

同时也要看到占位清单:README 自己承认「约 5% 的 DumpEntities 长尾表记录键进行中」「少数 spec 分支无真实样本,已按 spec 实现 + 合成自证」「ACIS 几何内核仅存 blob」。0 Release + 18 次提交意味着生产接入需要自己锁定 commit,不能指望语义化版本与升级承诺。

03 · 中文工程图,直接出图

下面这张 V 型滤池工艺图来自公开语料。平面、剖面、彩色工艺管线和右侧材料设备表,都是 go-cad 的渲染输出。

图:V 型滤池工艺图,平面、剖面与材料设备表的渲染输出

材料设备表可以单独放大看,名称、规格与数量都在。

图:材料设备表局部,名称、规格与数量

消毒接触池图保留了平面、两处剖面和材料一览表;图中的管径标注与右侧材料表可以对照。

图:消毒接触池,平面、剖面与材料一览表

机械图对细节更敏感。内侧行走轮轴图上,尺寸线、箭头、公差、直径符号,以及下方的技术要求都要同时成立。

图:内侧行走轮轴,尺寸标注、粗糙度符号和技术要求

技术要求局部放大,中文说明与数值一起保留:45#钢、55HRC、公差标准与每套用量。

图:技术要求局部,45#钢、55HRC、公差标准与每套用量

中文出图需要解码和渲染两端都做对。go-cad 处理 GBK/UTF-16 码页、字符转义与 CAD 特殊文本码——%%C、%%d、%%p 分别显示为 φ、°、±;渲染端处理文字的旋转、镜像、对齐与宽度因子。PNG 可指定输出宽度,SVG 适合放大查看。分幅 PNG 会检查文字的像素字高,必要时提高分辨率重渲。

一处口径差异值得记下:公众号推文写「中文渲染需要运行环境提供中文字体,也可通过 FontPath 指定」,README 写「内置 CJK 字形引擎,不依赖系统字体」。部署到精简容器前,按目标环境实测一次,别只看文档。

04 · 一张 DWG,拆成多张图

施工图常把多个楼层、专业或单体平铺在同一个模型空间。go-cad 会识别图框,从标题栏提取图号、图名,再逐幅出图。下面用四图幅 DXF 演示。

图:四张图幅在模型空间中的排列,整图全览

图:单幅给水系统图,保留图框、图形和标题栏

有真实图框时,批量出图首项为整图全览,后续为各张图幅;无图框时有整图兜底,设计说明、图例表等内容区也有相应切分路径。

// doc 为已解析的图纸文档。
images, err := cad.RenderAllSheets(doc, cad.RenderOptions{}, "png")
if err != nil { panic(err) }
texts := cad.SheetTexts(doc)

SheetTexts 把文字与图框放在一起,保留文本、坐标、字高、图层和归属编号,并展开块引用中的文字。这样「某层弱电平面图」对应的图片和说明可以一起保存、一起检索。项目公开记录中,消防与弱电施工图分别识别出 9 张图框,标题栏里的图号、图名可自动提取。

05 · 三条接入路径

5.1 WorkBuddy:一句话分析 CAD

联犀 CLI 从 v0.8.5 起支持 CAD 文档解析,联犀 Skills 可安装到 WorkBuddy / CodeBuddy。首次安装(Linux / macOS)一行命令:

curl -fsSL https://doc.unitedrhino.com/cli/install.sh | bash

已有 CLI 的用户先执行 ur upgrade,随后安装 Skills:

ur skills install --dir ~/.codebuddy/skills
ur skills status

安装完成后重启会话加载 Skills。把图纸放进 WorkBuddy 可访问的工作目录,指定文件后就能让 AI 调用 CLI 读取并分析:

用联犀 CLI 分析工作目录里的「施工图.dwg」。按图幅整理图号、图名和设计说明;提取设备材料、型号与数量,并注明来自哪张图。图纸里没有写明的信息单独列出。

分工是:CLI 负责把 DWG/DXF 解析成 AI 能读的内容,WorkBuddy 中的 AI 负责按要求整理、分析。材料表、施工说明和设备型号可以直接作为任务输入,不必先手工截图、复制文字。开发人员也可以直接跑命令:

ur doc parse 施工图.dwg --format outline
ur doc parse 施工图.dwg --format md --out 施工图.md

还支持 content-list 和 json 输出,适合进一步筛选文本、保留文档结构。

5.2 docling:把 CAD 放进知识库

联犀的纯 Go 文档解析库 unitedrhino/docling 从 v1.4.0 起集成 go-cad,支持 .dwg、.dxf、.dxfb 输入。在 Go 服务中按扩展名调用统一入口:

// data 为已读入的图纸字节。
doc, err := docling.ParseByExt("施工图.dwg", data)
if err != nil { panic(err) }
md := doc.ToMarkdown()

文档按图纸组织:每个识别到的图框对应一页,包含图名标题、渲染图片和框内文本;图框外的文字保留在文档前部,整图全览不会重复占一页。

CAD 图纸可以与 PDF、Word 使用统一的 Markdown、JSON、content-list 输出,进入后续分块、索引和检索流程。 保存图名与来源后,检索到一段说明可以回到对应图幅核对。

需要独立的机器清单,go-cad 还提供 caddocling:

# 在 go-cad 仓库中运行。
go run ./cmd/caddocling drawing.dwg -o out

它输出 manifest.json 与分幅图片,清单包含图框、文本和图片信息,方便接入自己的文档处理程序。

docling 仓库本身同样年轻:78 Star、16 Fork、MIT、默认分支 master,最近 push 为 2026-10-14。整套链路目前都是「同一个人 / 同一个组织在推」的状态。

06 · 能读,也能写

cad.Parse 读取 DWG,cad.ParseDXF 读取 DXF,cad.ParseJSON 导入 LibreDWG 风格 JSON。解析结果可提取文本、渲染图片,也可通过 cad.WriteDwg 写出 DWG——按文档版本分派到 R2000~R2018 六代容器,项目使用回读与 dwgread 交叉验证。DXF 和 JSON 导入构建的文档,也有结构化 DWG 写出路径。

对 Go 后端,解析、渲染和写出都在同一进程内完成,减少外部转换程序与 C 动态库的部署工作。项目采用 Apache-2.0,集成时保留相应许可与通知即可。

07 · 验证与性能

DWG 解码有些错误不容易从图片看出来:坐标或对象字段解错,程序仍可能正常出图。因此 go-cad 以 LibreDWG 的 dwgread -O JSON 输出作参考,比较对象与实体的字段值。

验证项目公开记录
值级对照37 张语料,严格对照项 100% 对齐
DWG 写出六代容器回读与 dwgread 交叉验证
DXF 转换dxf2dwg 参考验证 59/59
消费链路147 张语料:解析、渲染、写出、再解析
健壮性1000+ 变异输入测试,未出现 panic

对照结果限定于所列语料和已纳入比较的字段;外部参考数据测试需要配置相应资源。

一份 4.3 MB、108,850 个对象的图纸,项目记录的处理耗时:

操作耗时
解析691 ms
PNG 渲染,宽 20484.1 s
DWG 回写785 ms

这些是项目基准数据,实际耗时随硬件、图纸内容和输出分辨率变化。

README 里还有几项推文没提、但值得核对的数字:

项记录
语句覆盖率83.5%
解析吞吐为 dwgread(C)的 2.3~6.4 倍
117 KB 样本32.9 MB/s vs 5.1 MB/s
8.2 MB 样本9.1 MB/s vs 3.4 MB/s
4.3 MB 样本值级对照250 万实体键值 100% 对齐
JSON 输入9 图纸 0 差异

08 · Go 最小示例

安装:

go get github.com/unitedrhino/go-cad

完整的 main.go,读取图纸、输出 PNG/SVG、统计文本,再写回 DWG:

// 演示 DWG 解析、图片渲染与 DWG 写出。
package main

import (
    "bytes"
    "fmt"
    "os"

    cad "github.com/unitedrhino/go-cad"
)

// check 遇到错误时终止示例,避免继续输出无效文件。
func check(err error) {
    if err != nil { panic(err) }
}

// main 从 drawing.dwg 读取图纸,在当前目录输出文件。
func main() {
    // data 为原始图纸字节,doc 为解析后的文档。
    data, err := os.ReadFile("drawing.dwg")
    check(err)

    doc, err := cad.Parse(data)
    check(err)

    // opts 控制输出宽度,png 和 svg 为图片内容。
    opts := cad.RenderOptions{Width: 2048}

    png, err := cad.RenderPNG(doc, opts)
    check(err)
    check(os.WriteFile("drawing.png", png, 0644))

    svg, err := cad.RenderSVG(doc, opts)
    check(err)
    check(os.WriteFile("drawing.svg", svg, 0644))

    // buf 接收回写后的 DWG 字节。
    var buf bytes.Buffer
    check(cad.WriteDwg(doc, &buf))
    check(os.WriteFile("roundtrip.dwg", buf.Bytes(), 0644))

    fmt.Println("文本条数:", len(doc.Texts()))
}

把一份支持写出的 DWG 命名为 drawing.dwg,放在同目录运行即可。仓库也提供 example/,可直接演示解析、渲染、回写和再解析。

09 · 当前边界

  1. ACIS 三维实体的 SAT/SAB 几何重建不在当前范围内。
  2. 不支持 pre-R13 写出、R2.x~R8 早期格式。
  3. 部分长尾对象字段仍在完善;没有真实样本的分支使用合成数据验证。
  4. 文字提取只针对 CAD 文本实体,画成线条或嵌入图片的文字需要另行处理。
  5. 高分辨率出图需要相应内存;docling 的文本包围框用于近似定位。

最后按场景选:

场景建议
做图纸预览直接用 go-cad
在 WorkBuddy 中分析图纸联犀 CLI + Skills
已有知识库解析流程用 docling 接入,CAD 与 PDF/Word 同管线
要生产稳定版本先自建 fork 锁 commit——目前 0 Release

本文整理自「云物通科技」公众号推文,仓库数据以 2026-11-09 状态为准。项目仅 41 天、0 Release,功能与限制请以目标图纸的实测结果为准。作者与项目无关联,不构成推荐。