星座服务

要解决什么问题

在对话里查星座资料、看今日运势或算配对时，模型若靠常识拼凑，容易过时或与商业 API 口径不一致。本技能把小笨羊星座 API封装成 MCP 工具：由模型做意图识别与参数提取，由 scripts.tools 发起真实请求，结果以 result["raw"] 为准展示。

技能如何工作

使用前必须在 .env 配置 XBY_APIKEY，或在首次调用前通过 AskUserQuestion 收集密钥并执行 scripts.config.set_api_key。密钥可在 xiaobenyang.com 申请；禁止在无密钥时搜索或编造运势数据。

典型路由流程：检查 scripts.config.settings.api_key → 按用户意图选工具 → 用关键字参数调用，例如 get_daily_horoscope(zodiac='狮子座') → 整理 API 原始 JSON 后回复。

| 意图 | 工具 |
|------|------|
| 星座详情（性格、守护星、元素等） | get_zodiac_info |
| 今日运势（可选 category，默认 luck） | get_daily_horoscope |
| 两星座配对 | get_compatibility |
| 全星座列表 | get_all_zodiacs |
| 按月日定太阳星座 | get_zodiac_by_date |
| 按出生时刻与经纬度算上升星座 | get_rising_sign |
| 上升星座说明 | get_rising_sign_info |

工具返回 success、message 与 raw；展示层应以 raw 为事实来源。参数不全时应对用户追问（如配对缺第二星座、上升星座缺经纬度或出生时间）。

适用边界与注意点

• 运势与配对文案来自远端 API，本技能不负责占星理论解释以外的二次创作。
• get_rising_sign 对 birthHour、latitude、longitude 等字段要求严格，错误坐标会直接影响计算结果。
• 星座名支持中英文；类别型参数（如运势 category）需按工具表传入，避免模型擅自改参。