前言¶
在 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 仓库。
