前言¶

在 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