前言¶

在 DeepSeek Harness (DSH) 的開發實踐中，爲智能體添加特定領域的知識檢索能力通常需要編寫額外的接口調用邏輯。xby-constellation 插件解決了這一痛點，它是一個基於 Model Context Protocol (MCP) 的星座服務，開發者可以直接通過調用 DSH 接口獲取星座相關的數據，無需自行維護後端服務。

簡介¶

這是一個由 xby-skill 維護的聯網工具類插件，提供從星座基礎信息、上升星座計算到今日運勢與配對分析的完整功能。插件採用 MIT 許可證，屬於開源社區項目。

核心功能¶

插件提供了以下核心能力：

• set_xby_apikey：在聊天會話中設置 API 密鑰，設置後自動持久化，重啓 DSH 進程後依然有效。
• get_zodiac_info：獲取指定星座的詳細信息，包含性格特徵、守護星、元素等。
• get_daily_horoscope：獲取指定星座的今日運勢。
• get_compatibility：獲取兩個星座的配對指數以及關係分析。
• get_all_zodiacs：獲取所有星座的基本信息列表。
• get_zodiac_by_date：根據出生日期自動計算並返回對應的星座。
• get_rising_sign：計算上升星座，需要提供出生時間、地點和日期。
• get_rising_sign_info：獲取指定上升星座的詳細信息。

安裝與啓用¶

在終端中執行以下命令即可安裝插件。

dsh plugin --profile web add github:xby_skill/xby_constellation

配置與使用¶

安裝完成後，插件以當前 DSH 進程的權限運行。使用前需要完成以下步驟：

1. 獲取 API 密鑰：前往 小笨羊官網 註冊賬號並獲取 API 密鑰。
2. 設置密鑰：在聊天中調用 set_xby_apikey 接口，將密鑰傳入。插件會自動處理持久化。
3. 查詢數據：利用獲取到的密鑰，調用其他接口進行查詢。例如：
   • 調用 get_daily_horoscope 查看今日運勢。
   • 調用 get_compatibility 分析兩個星座的關係。
   • 調用 get_zodiac_by_date 根據日期判斷星座。
   • 調用 get_rising_sign 計算上升星座（需提供具體時間地點）。

注意事項¶

• 前置條件：使用任何功能前，必須先完成 API 密鑰的獲取與設置，否則接口調用將失敗。
• 權限範圍：插件運行依賴於當前 DSH 進程的權限配置，請確保環境安全。
• 許可證：項目遵循 MIT 許可證，請關注源碼變更。

結語¶

xby-constellation 爲 DSH 生態提供了一套標準化的星座數據查詢方案。通過簡單的接口調用，即可在智能體中實現複雜的星座分析邏輯。更多詳情與源碼可參考插件目錄或 GitHub 倉庫。