在构建基于 DeepSeek Harness (DSH) 的智能体工作流时，处理网络逻辑（如验证 IP 格式、计算 CIDR 网段范围）通常需要依赖正则表达式或外部工具。直接在代码中实现这些逻辑会增加复杂度。DSH 的理念是“一切皆插件”，通过引入专用工具可以剥离这些细节。
插件介绍¶
dsh-ip 是一个用于网络地址处理的工具插件。它由 uckkk 维护，属于联网工具类。核心功能是校验和分类 IP 地址，以及计算 IPv4 CIDR 网段范围，且基于纯 Node.js 实现。
核心功能¶
插件提供两个主要工具：
1. ip_info：用于校验 IP 地址并对其进行分类。
2. cidr_range：将 IPv4 CIDR 表示法（如 10.0.0.0/24）转换为网段范围。
安装与启用¶
使用官方安装命令添加插件：
dsh plugin add github:uckkk/dsh-ip
安装完成后，需要在 profile 的 package.json 文件中找到 dsh.profile.bundles 字段，并在其中加入 "dsh-ip"。
典型用法¶
安装后在会话中调用该插件注册的工具即可。
示例：
10.0.0.0/24 的网段范围是多少
→ 调用 cidr_range(cidr="10.0.0.0/24")
适用场景与注意¶
该插件以当前 DSH 进程的权限在本地运行，涉及第三方代码。安装前请务必审阅源码（仓库：https://github.com/uckkk/dsh-ip）以确保安全性。适合需要在智能体逻辑中直接进行网络地址运算的场景。
dsh-ip 将 IP 处理逻辑封装为插件，减少了在智能体代码中编写重复正则或网络逻辑的工作量。如需查看更多插件或源码，可访问：插件目录 或 GitHub。
