xby-bazi：八字計算器插件

前言¶

在 DeepSeek Harness (DSH) 中開發智能體時，如果需要集成八字排盤或黃曆查詢功能，可以直接使用社區提供的插件。xby-bazi 插件處理了相關的計算邏輯，開發者可以直接在對話或腳本中調用接口獲取數據。

插件概述¶

這是由 xby-skill 維護的模型推理類插件。xby-bazi 是一款基於 AI 的八字計算器，旨在提供精準的八字排盤數據，用於性格分析和命運預測。

安裝與啓用¶

通過 DSH 的命令行工具安裝該插件：

dsh plugin --profile web add github:xby_skill/xby-bazi

安裝完成後，插件即可在指定的 profile（如 web）中生效。

核心功能¶

插件提供以下四個核心能力：

1. set_xby_apikey
   在聊天中設置 API 密鑰。該操作支持自動持久化，重啓進程後密鑰依然有效。

2. getBaziDetail
   根據性別和時間獲取八字信息。

   • 參數：必須提供 solarDatetime（公曆時間）或 lunarDatetime（農曆時間），兩者互斥，只能傳其中一個。同時需要提供性別。
   • 返回：八字排盤數據。

3. getSolarTimes
   根據八字獲取對應的公曆時間列表。

   • 返回格式：YYYY-MM-DD hh:mm:ss。例如：1998-07-31 14:00:00。

4. getChineseCalendar
   獲取指定公曆時間的黃曆信息。如果不傳時間參數，默認獲取今天的黃曆信息。

使用前提¶

在調用上述功能前，需要完成以下配置：

1. 前往 小笨羊官網 註冊賬號。
2. 獲取 API 密鑰。
3. 使用 set_xby_apikey 命令將密鑰設置到當前會話中。

注意事項¶

• 在使用 getBaziDetail 時，務必注意參數校驗，確保只傳入 solarDatetime 或 lunarDatetime 其中一個。
• 該插件遵循 MIT 許可證。

參考資料¶

• 插件目錄頁
• GitHub 倉庫