前言¶
在 DeepSeek Harness (DSH) 的插件生態中，特定垂直領域的功能往往需要單獨開發。xby-lunar-calendar 專注於中國傳統的農曆與八字計算，提供了一個基於 Python 3.12 和 lunar-python 的服務端，填補了智能體在處理中國傳統文化相關查詢時的空白。
插件簡介¶
xby-lunar-calendar 是一個聯網工具類別的 DSH 插件，由用戶 xby-skill 維護。它旨在解決智能體在處理日期轉換、黃曆查詢、八字命理及五行分析時的邏輯需求。
核心功能¶
該插件提供以下功能接口，所有計算邏輯由後端 Python 環境執行：
set_xby_apikey：在聊天上下文中設置 API 密鑰。該密鑰會自動持久化，重啓 DSH 進程後依然有效。bazi_calculate：計算生辰八字。- 輸入：出生日期 (YYYY-MM-DD)、出生時間 (HH:MM)。
- 輸出：詳細的八字計算結果。
calendar_convert：公曆與農曆互轉。- 輸入：日期 (YYYY-MM-DD)、轉換目標 (“lunar” 或 “solar”)。
- 參數：
is_leap（是否閏月，僅用於農曆轉公曆）。 - 輸出：曆法轉換結果。
huangli_query：查詢指定日期的黃曆信息。- 輸入：日期 (YYYY-MM-DD)。
fortune_daily：獲取每日運勢和建議。- 輸入：日期 (YYYY-MM-DD)。
jieqi_query：查詢一年的二十四節氣。- 輸入：年份。
- 輸出：該年的節氣列表。
wuxing_analyze：根據出生信息分析五行。- 輸入：出生日期 (YYYY-MM-DD)、出生時間 (HH:MM)。
- 輸出：五行分析結果。
安裝與配置¶
安裝¶
使用 DSH 官方插件管理工具進行安裝。請確保使用正確的 profile 名稱。
# 安裝插件
dsh plugin --profile web add github:xby_skill/xby-lunar-calendar
配置前置條件¶
該插件依賴外部 API 密鑰進行計算。在調用 bazi_calculate、wuxing_analyze 等功能前，需要在聊天中先調用 set_xby_apikey 設置密鑰。
- 訪問 小笨羊官網 註冊賬號。
- 獲取 API 密鑰。
- 在 DSH 聊天窗口中輸入配置命令，設置密鑰。
典型用法¶
安裝完成後，可以通過以下方式調用功能：
- 八字計算：調用
bazi_calculate接口，傳入出生日期和出生時間，獲取詳細的八字排盤結果。 - 日曆轉換：使用
calendar_convert接口，輸入公曆日期並將目標設爲 “lunar” 進行轉換。 - 黃曆查詢：通過
huangli_query接口查詢某天的宜忌等信息。 - 每日運勢：調用
fortune_daily接口獲取指定日期的運勢分析。 - 節氣查詢：使用
jieqi_query接口查詢指定年份的二十四節氣列表。 - 五行分析：調用
wuxing_analyze接口，根據提供的出生信息分析命理中的五行屬性。
生態背景¶
DSH 理念是「一切皆插件」，社區目錄（如 SkillHub）是一個獨立的站點，與 DeepSeek 或幻方研究院無官方從屬關係。社區開發者通過 GitHub 發佈插件，用戶自行安裝並運行。
結語¶
xby-lunar-calendar 是一個輕量級的傳統曆法服務插件。如果你需要構建涉及中國傳統文化、日期轉換或命理分析的智能體，這是一個可以直接集成的工具。更多細節請參考其 GitHub 倉庫。
