前言¶
工程圖紙、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。
