前言¶

在開發 DeepSeek Harness (DSH) 智能體時，讓模型自主獲取域名的註冊信息是一個常見需求。傳統方案通常依賴端口 43 的 WHOIS 協議，需要處理複雜的文本解析或依賴外部二進制文件。下面介紹 dsh-whois-plugin，它直接爲模型添加了 whois 工具，通過 RDAP 協議查詢域名數據。

插件定位¶

這是由 rjn32s 維護的一個 DSH 插件。它爲模型提供了 whois 工具，用於查詢域名的註冊信息。該插件使用 RDAP 協議（RFC 7484/9082/9083），這是舊版 WHOIS 的結構化 JSON 繼任者，無需外部二進制文件或端口 43 文本解析。

核心功能¶

• 添加 whois 工具：模型可以直接調用 whois 函數。
• 基於 RDAP 協議：使用現代 RDAP 協議進行查詢，替代傳統的文本解析。
• 無需額外依賴：不依賴外部二進制文件，也不需要處理複雜的文本解析邏輯。
• 權威查詢：通過 IANA 引導註冊表（https://data.iana.org/rdap/dns.json）解析權威 RDAP 服務器，並緩存 24 小時。

安裝與啓用¶

在 dsh profile 中安裝：

dsh plugin --profile <name> add dsh-whois-plugin

或者直接從 GitHub 安裝：

dsh plugin --profile <name> add github:rjn32s/dsh-whois-plugin

安裝後，驗證配置並啓動：

dsh --profile <name> --dump-config   # 查找 "# == dsh-whois-plugin"
dsh --profile <name>

典型用法¶

安裝完成後，模型可以直接調用 whois 工具。例如：

Look up the WHOIS/RDAP info for example.com

模型會執行 whois({ domain: "example.com" })，並返回原始 RDAP JSON 數據，其中包含註冊商、狀態、註冊/過期事件、名稱服務器以及註冊實體信息（如果註冊表發佈了這些信息）。

適用場景與注意¶

• 適用場景：需要智能體具備域名查詢能力的開發者。
• 注意：
  • 部分國家頂級域名（ccTLD）在 IANA 引導文件中暫無 RDAP 條目，此時工具會拋出清晰的錯誤，而不是靜默回退到舊版 WHOIS。
  • 除了出站 HTTPS 外，無需配置 API 密鑰或網絡出口。
  • 插件在當前 DSH 進程權限下運行，安裝前請檢查源碼與許可證。

總結¶

該插件通過 RDAP 協議簡化了域名查詢流程，爲 DSH 智能體提供了標準化的域名註冊信息獲取能力。更多詳情請查看 插件目錄 或 GitHub 倉庫。