Introduction

In the DeepSeek Harness (DSH) plugin ecosystem, features for specific vertical domains often require dedicated development. xby-lunar-calendar focuses on traditional Chinese lunar calendars and Bazi calculations, providing a Python 3.12 and lunar-python-based backend that fills the gap for agents handling queries related to Chinese traditional culture.

Plugin Overview

xby-lunar-calendar is a DSH plugin in the online tool category, maintained by the user xby-skill. It is designed to address the logical requirements of agents when handling date conversion, almanac queries, Bazi fate analysis, and Five Elements analysis.

Core Features

The plugin provides the following function interfaces; all calculation logic is executed by a backend Python environment:

  • set_xby_apikey: Sets an API key in the chat context. The key is automatically persisted and remains valid after the DSH process is restarted.
  • bazi_calculate: Calculates birth Bazi.
    • Input: Date of birth (YYYY-MM-DD), time of birth (HH:MM).
    • Output: Detailed Bazi calculation results.
  • calendar_convert: Converts between Gregorian and lunar calendars.
    • Input: Date (YYYY-MM-DD), conversion target (“lunar” or “solar”).
    • Parameter: is_leap (whether it is a leap month; used only for converting from lunar to Gregorian).
    • Output: Calendar conversion result.
  • huangli_query: Queries almanac information for a specified date.
    • Input: Date (YYYY-MM-DD).
  • fortune_daily: Retrieves daily fortune and advice.
    • Input: Date (YYYY-MM-DD).
  • jieqi_query: Queries the 24 solar terms for a year.
    • Input: Year.
    • Output: The list of solar terms for that year.
  • wuxing_analyze: Analyzes the Five Elements based on birth information.
    • Input: Date of birth (YYYY-MM-DD), time of birth (HH:MM).
    • Output: Five Elements analysis results.

Installation and Configuration

Installation

Install it using the official DSH plugin management tool. Make sure to use the correct profile name.

# 安装插件
dsh plugin --profile web add github:xby_skill/xby-lunar-calendar

Configuration Prerequisites

The plugin relies on an external API key for calculations. Before calling features such as bazi_calculate and wuxing_analyze, you must first call set_xby_apikey in the chat to set the key.

  1. Visit the Xiaobenyang official website to register an account.
  2. Obtain an API key.
  3. Enter the configuration command in the DSH chat window to set the key.

Typical Usage

After installation, you can invoke the features in the following ways:

  1. Bazi calculation: Call the bazi_calculate interface with the date of birth and time of birth to obtain detailed Bazi chart results.
  2. Calendar conversion: Use the calendar_convert interface, enter a Gregorian date, and set the target to “lunar” to perform the conversion.
  3. Almanac query: Use the huangli_query interface to query information such as favorable and unfavorable activities for a given day.
  4. Daily fortune: Call the fortune_daily interface to retrieve fortune analysis for a specified date.
  5. Solar terms query: Use the jieqi_query interface to query the list of the 24 solar terms for a specified year.
  6. Five Elements analysis: Call the wuxing_analyze interface to analyze the Five Elements attributes in fate analysis based on the provided birth information.

Ecosystem Background

The DSH philosophy is “everything is a plugin.” The community catalog (such as SkillHub) is an independent site and has no official affiliation with DeepSeek or High-Flyer Research Institute. Community developers publish plugins via GitHub, and users install and run them themselves.

Conclusion

xby-lunar-calendar is a lightweight traditional calendar service plugin. If you need to build an agent involving Chinese traditional culture, date conversion, or fate analysis, this is a tool that can be directly integrated. For more details, please refer to its GitHub repository.