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 仓库