前言¶

在 DeepSeek Harness (DSH) 的开发实践中，为智能体添加特定领域的知识检索能力通常需要编写额外的接口调用逻辑。xby-constellation 插件解决了这一痛点，它是一个基于 Model Context Protocol (MCP) 的星座服务，开发者可以直接通过调用 DSH 接口获取星座相关的数据，无需自行维护后端服务。

简介¶

这是一个由 xby-skill 维护的联网工具类插件，提供从星座基础信息、上升星座计算到今日运势与配对分析的完整功能。插件采用 MIT 许可证，属于开源社区项目。

核心功能¶

插件提供了以下核心能力：

• set_xby_apikey：在聊天会话中设置 API 密钥，设置后自动持久化，重启 DSH 进程后依然有效。
• get_zodiac_info：获取指定星座的详细信息，包含性格特征、守护星、元素等。
• get_daily_horoscope：获取指定星座的今日运势。
• get_compatibility：获取两个星座的配对指数以及关系分析。
• get_all_zodiacs：获取所有星座的基本信息列表。
• get_zodiac_by_date：根据出生日期自动计算并返回对应的星座。
• get_rising_sign：计算上升星座，需要提供出生时间、地点和日期。
• get_rising_sign_info：获取指定上升星座的详细信息。

安装与启用¶

在终端中执行以下命令即可安装插件。

dsh plugin --profile web add github:xby_skill/xby_constellation

配置与使用¶

安装完成后，插件以当前 DSH 进程的权限运行。使用前需要完成以下步骤：

1. 获取 API 密钥：前往 小笨羊官网 注册账号并获取 API 密钥。
2. 设置密钥：在聊天中调用 set_xby_apikey 接口，将密钥传入。插件会自动处理持久化。
3. 查询数据：利用获取到的密钥，调用其他接口进行查询。例如：
   • 调用 get_daily_horoscope 查看今日运势。
   • 调用 get_compatibility 分析两个星座的关系。
   • 调用 get_zodiac_by_date 根据日期判断星座。
   • 调用 get_rising_sign 计算上升星座（需提供具体时间地点）。

注意事项¶

• 前置条件：使用任何功能前，必须先完成 API 密钥的获取与设置，否则接口调用将失败。
• 权限范围：插件运行依赖于当前 DSH 进程的权限配置，请确保环境安全。
• 许可证：项目遵循 MIT 许可证，请关注源码变更。

结语¶

xby-constellation 为 DSH 生态提供了一套标准化的星座数据查询方案。通过简单的接口调用，即可在智能体中实现复杂的星座分析逻辑。更多详情与源码可参考插件目录或 GitHub 仓库。