前言¶
工程图纸、GIS 底图、制造图档常以 DWG 交付。要在脚本或对话里做格式转换、查图层、搜图内文字，往往要单独装一套 CAD 生态或手写调用原生库。下面介绍 SkillHub 上的 dwg文件解析工具（@user_463e8e26/libredwg）：把基于 LibreDWG（GNU 开源 C 库）的 CLI 能力封装成 Agent Skill，在提到 DWG、DXF、图层查询等需求时由模型按说明选用对应工具。
这是什么¶
dwg文件解析工具 是面向开发场景的 DWG/AutoCAD 文件处理 Skill，坐标 @user_463e8e26/libredwg，当前版本 1.0.0，来源为 community，分类 dev-programming，标签 requires_api_key=false（无需 API Key）。
Skill 简介将其定位为：基于 LibreDWG 的 CLI 工具集，覆盖 DWG 读写、多格式转换、图层与文本检索、缩略图与元数据相关操作，以及从零创建 DWG。发布者为 SkillHub 用户 user_463e8e26；SkillHub 页面标注作者为「任准」。
核心功能¶
以下能力均来自 Skill 官方简介，按用途归纳。
格式转换与读写¶
- DWG 与 DXF、JSON、GeoJSON、SVG、PS 等格式互转或导出（简介表述为 DWG↔DXF/JSON/GeoJSON/SVG/PS）。
- DWG 读写、重写与过滤，简介中对应关键词包括 dwgread、dwg2dxf、dxf2dwg、dwgrewrite、dwgfilter。
查询与检索¶
- 图层查询：dwglayers。
- 文本搜索：dwggrep。
- 提取 DWG 元数据、缩略图（简介提到缩略图提取；工具名含 dwgbmp）。
创建与矢量输出¶
- 从零 创建 DWG：dwgadd。
- 将 DWG 转为 SVG 等：dwg2SVG。
触发条件（Agent 何时启用）¶
当用户需要处理 DWG、转换 CAD 格式、查询图层、搜索图内文本、提取元数据、将 DWG 转 SVG/DXF/JSON，或创建 DWG 时，Skill 说明中会引导选用上述 CLI。常见关键词包括：DWG、AutoCAD、CAD、DXF，以及各工具命令名。
安装与启用¶
Skill 遵循 SkillHub 通用的 SKILL.md 格式。安装前需本机具备 skillhub CLI；若无，可先按官方安装文档检查或安装。
检查 skillhub CLI¶
command -v skillhub && skillhub --version
未安装时，SkillHub 安装文档提供完整安装（CLI + 默认 Skill）与仅 CLI 两种方式，例如：
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash
curl -fsSL https://skillhub-1388575217.cos.ap-guangzhou.myqcloud.com/install/install.sh | bash -s -- --cli-only
安装本 Skill¶
安装时必须用 --dir 指向当前 Agent 的 skills 目录，否则默认落在 ./skills/ 且可能不被识别。SkillHub 文档给出的通用形式如下：
skillhub install user_463e8e26/libredwg --dir <skills 目录>
常用客户端 skills 路径（摘自 SkillHub 安装文档，按你实际使用的客户端选择其一）：
- Cursor：
~/.cursor/skills/ - Claude Code：
~/.claude/skills/ - Codex：
~/.codex/skills/或项目下的.agents/skills/
也可将下列说明发给 AI，让其按 SkillHub 安装文档 完成安装：
请根据 https://skillhub.cn/install/skillhub.md，安装 `@user_463e8e26/libredwg`。
典型用法¶
公开页面未附带逐条 shell 示例；实际流程是：在 Cursor 等客户端安装 Skill 后，用自然语言描述图纸任务，由 Agent 读取 SKILL 说明并调用 LibreDWG 系 CLI。可按需求对照下表组织提问（能力描述来自官方简介）：
| 需求 | 可提及的工具/方向 |
|---|---|
| 查看或解析 DWG 结构 | dwgread |
| DWG → DXF | dwg2dxf |
| DXF → DWG | dxf2dwg |
| 列出图层 | dwglayers |
| 搜索图内文字 | dwggrep |
| DWG → SVG | dwg2SVG |
| 缩略图/位图相关 | dwgbmp |
| 新建或追加图元 | dwgadd |
| 重写或过滤 DWG | dwgrewrite、dwgfilter |
示例提问（示意，具体参数以安装后的 SKILL 为准）：
- 「把这个 DWG 转成 DXF，并列出所有图层名。」
- 「在图纸里搜索包含“配电室”的 TEXT/MTEXT。」
- 「导出 SVG 预览，并说明能从文件里读到哪些元数据。」
适用场景与注意¶
适合谁：需要在自动化、CI、文档流水线或对话式开发里处理 DWG，又不想为单次任务打开完整 AutoCAD 的开发者；分类为 dev-programming，侧重编程与工具链集成。
依赖与边界：底层为 LibreDWG CLI，复杂图纸、新版本 DWG 特性或专有对象的支持程度以 LibreDWG 本身为准；Skill 不替代专业 CAD 审图软件。本 Skill 不需要 API Key。
平台数据：SkillHub 抓取信息显示评分 100000、下载 3885（页面统计可能随时间变化，以 SkillHub 为准）。
结尾¶
dwg文件解析工具 把 LibreDWG 的 DWG 读写、格式转换、图层与文本检索等 CLI 能力收敛到 @user_463e8e26/libredwg，便于在 Agent 对话里按关键词触发。安装与目录配置见 SkillHub 安装文档；Skill 主页：https://www.skillhub.cn/skills/user_463e8e26/libredwg，API 入口：https://api.skillhub.cn/user_463e8e26/libredwg。
