前言¶

在構建涉及網絡配置的智能體時，手動處理 IPv4 子網計算、通配符掩碼和 IP 驗證會佔用大量時間。DeepSeek Harness (DSH) 強調通過插件生態擴展功能，以覆蓋這類具體場景。下面介紹一個專門用於子網規劃的工具，它將計算邏輯封裝在對話流程中。

這是什麼¶

xby-skill/xby-subnet-calculator 是一個基於 Model Context Protocol 的工具，專注於 IPv4 子網規劃。它提供子網大小計算、通配符掩碼生成、網關選擇和主機驗證等功能。該項目由 xby-skill 維護，許可證爲 MIT。

核心功能¶

插件暴露了以下主要能力：
* set_xby_apikey：在聊天中設置 API 密鑰，自動持久化。
* calculate_subnet：給定基礎 IP 和所需主機數，計算子網詳情。
* calculate_wildcard_mask：爲子網生成 OSPF 通配符掩碼詳情。
* validate_ip_in_subnet：驗證 IP 地址是否屬於特定子網。
* calculate_subnet_from_mask：從 IP 地址和子網掩碼計算網絡信息。
* get_nth_usable_ip：返回子網中第 N 個可用 IP 地址。

安裝與啓用¶

安裝該插件需要在 DSH 命令行中執行以下命令：

dsh plugin --profile web add github:xby_skill/xby-subnet-calculator

安裝後，在聊天中提及 set_xby_apikey 或相關指令即可激活功能。

典型用法¶

1. 配置密鑰：首次使用需設置 API 密鑰。在聊天中發送設置指令，系統會自動持久化該密鑰。
2. 計算子網：給出基礎 IP（如 192.168.1.0）和所需主機數（如 20），調用 calculate_subnet 獲取子網劃分結果。
3. 生成通配符：在配置 OSPF 時，使用 calculate_wildcard_mask 快速生成掩碼。
4. IP 驗證：輸入 IP 地址和子網範圍，調用 validate_ip_in_subnet 確認歸屬。
5. 獲取特定 IP：若需獲取子網中的特定可用 IP，使用 get_nth_usable_ip。

注意事項¶

• 該插件依賴外部 API 密鑰，需前往小笨羊官網註冊獲取。
• 作者信息爲空。
• 使用前請確認該插件符合你的安全與合規要求。

結語¶

該插件爲 DSH 智能體提供了 IPv4 子網規劃的標準能力。更多細節可查閱 GitHub 倉庫。