前言¶

在 DeepSeek Harness（DSH）的插件生态中，处理网络威胁情报是常见需求。开发者需要一种方式来获取 IP 的画像与威胁信息，以便在智能体逻辑中做出判断。xby-ip-query 插件为此提供了基于长亭威胁情报的查询能力。

插件简介¶

xby-ip-query 是一个 DSH 插件。它依托全球蜜罐网络及百万级节点构建 IP 情报分析平台，提供精准的 IP 画像与威胁预警服务。

核心功能¶

该插件提供以下能力：

1. set_xby_apikey：在聊天中设置 API 密钥，密钥会自动持久化，重启后依然有效。
2. 长亭 IP 情报查询：基于长亭威胁情报，获取给定 IP 的威胁情报信息。返回结果包含 IP 地址、地理位置、ASN 以及历史恶意行为等信息。

安装与启用¶

使用 DSH 的插件管理命令进行安装。

方式一：从 GitHub 直接安装（推荐）

dsh plugin --profile web add github:xby_skill/xby-ip-query

以下是针对本地开发调试的安装方式：

# 仅用于本地开发调试
dsh plugin --profile web add /absolute/path/to/xby-ip-query

典型用法¶

使用前需要获取 API 密钥。

1. 前往小笨羊官网注册并获取 API 密钥。
2. 在聊天中调用 set_xby_apikey 命令设置密钥。
3. 使用查询功能，输入目标 IP，插件将返回其威胁情报。

注意事项¶

• 方式二仅用于本地开发调试。
• 方式三通过 cordis.patch.yml 开发调试。
• 该插件以当前 DSH 进程的权限运行。安装前请检查源码与许可证（MIT）。

总结¶

xby-ip-query 通过集成长亭威胁情报，解决了智能体在处理 IP 相关任务时的情报获取问题。开发者可以通过简单的命令配置 API 密钥，进而查询 IP 的地理位置、ASN 及历史恶意行为。

GitHub 仓库：https://github.com/xby_skill/xby-ip-query