前言¶

在构建涉及网络配置的智能体时，手动处理 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 仓库。