Josiecontrolling326/unifi-map

unifi-map 是做什麼的？

使用真實裝置資料將 UniFi 網路拓撲匯出為可縮放的向量圖表和可編輯的 draw.io 檔案。

概觀

此技能會從您的 UniFi 控制器擷取即時網路拓撲，並產生高度詳細的圖表。產生的輸出包含：

• SVG 檔案：可縮放的向量圖形，可用於文件、簡報或直接嵌入網頁。
• draw.io 檔案：可於 draw.io 或 diagrams.net 中開啟的原生格式，方便進行後續編輯與協作。

支援的裝置

• UniFi 閘道器（例如：UniFi Dream Machine、UniFi Security Gateway）
• UniFi 交換器（例如：UniFi Switch 系列）
• UniFi 存取點（例如：UniFi AP AC/Pro/LR）

設定

使用 UniFi API 需要設定下列環境變數：

# UniFi 控制器連線
export UNIFI_HOST="https://unifi-controller.local:8443"
export UNIFI_USERNAME="admin"
export UNIFI_PASSWORD="your-password"
export UNIFI_SITE="default"

使用方式

在任何支援的 AI 代理（例如 Claude Code、Cursor、Codex）中觸發此技能。系統會自動從您的 UniFi 控制器擷取拓撲，並產生輸出圖表。

輸出範例

產生流程完成後，您會得到下列檔案：

• unifi-topology.svg：可縮放的向量圖表。
• unifi-topology.drawio：可編輯的 draw.io 檔案。

您可以在瀏覽器中開啟 SVG 檔案，或將 draw.io 檔案匯入 diagrams.net 進行進一步編輯。

進階選項

您可在提示詞中提供額外參數來自訂圖表輸出，例如：

• 僅包含特定裝置類型（例如：僅交換器）。
• 包含或排除特定站台（預設為「default」）。
• 使用過濾器只顯示特定 VLAN 或子網路上的裝置。

疑難排解

若技能無法連線到 UniFi 控制器，請檢查：

1. UniFi 控制器是否正在執行且可透過網路存取。
2. 環境變數中的主機名稱、使用者名稱與密碼是否正確。
3. 使用的 API 端點是否為正確的站台路徑（預設為 /s/default）。

授權

此技能依據 MIT 授權條款發布。如需完整授權資訊，請參閱技能儲存庫中的 LICENSE 檔案。