观星 GuanXing — 中文玄学 AI

一套全面的中文玄学工具包。调用 GuanXing API，可提供八字命理分析、每日运势、加密货币运势（五行）、风水分析、塔罗牌占卜、易经求签、梦境解析、姓名评分、缘分合盘及生肖运势等服务。

配置

在 https://heartai.zeabur.app 免费获取 API 密钥（注册 → 开发者中心 → 创建应用 → 复制你的 gx_sk_ 密钥）。

设置环境变量：

GUANXING_API_KEY=gx_sk_your_key_here

基础 URL：https://heartai.zeabur.app

身份验证

所有请求均需在 Authorization 请求头中携带 Bearer Token：

Authorization: Bearer $GUANXING_API_KEY
Content-Type: application/json

外部接口端点

安全与隐私

• 所有数据均通过 HTTPS 发送至 heartai.zeabur.app 的 GuanXing API。
• 本地不存储任何数据，不读取或写入任何文件。
• API 仅使用出生日期和姓名生成运势解读，不会将数据共享给任何第三方。
• 启用本技能后，您的数据将被发送至 GuanXing（观星）服务。请仅在信任该服务的前提下安装。

模型调用说明

当用户询问运势、命理、八字、生肖、加密货币运气、风水或相关话题时，本技能可能由智能体自主调用。此为标准行为。如需禁用，请移除该技能。

操作说明

1. 八字命理分析（八字）

当用户询问其生辰八字、命运、人生路径或命格时：

curl -s -X POST https://heartai.zeabur.app/api/v1/bazi 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"birthDate": "YYYY-MM-DD", "birthHour": HOUR_0_TO_23, "name": "NAME"}'

• birthDate（必填）：出生日期，格式为 YYYY-MM-DD
• birthHour（选填）：出生时辰，0–23（对应十二时辰）
• name（选填）：用户姓名，用于个性化解读

若用户未提供出生日期，请主动询问；出生时辰可提升分析精度，但非必需。

2. 每日运势（每日运势）

当用户询问今日运势、运气或运势走势时：

curl -s -X POST https://heartai.zeabur.app/api/v1/fortune 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"zodiac": "ZODIAC_SIGN", "birthDate": "YYYY-MM-DD"}'

• zodiac（必填）：中文生肖名称，如 白羊座、金牛座 等
• birthDate（选填）：用于生成基于八字的个性化运势

3. 加密货币运势（加密运势）

当用户询问加密货币运气、代币运势或币圈运势时：

curl -s -X POST https://heartai.zeabur.app/api/v1/crypto-fortune 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"token": "BTC"}'

• token（必填）：代币符号，支持 BTC、ETH、SOL、BNB、TON、DOGE、AVAX
• 代币与五行映射关系：BTC→金（Metal）、ETH→水（Water）、SOL→火（Fire）、BNB→土（Earth）、TON→木（Wood）

如需获取投资组合整体运势，请对用户持有的每个代币分别调用该接口。

4. 易经求签（求签）

当用户希望占卜、抽签或求签时：

curl -s -X POST https://heartai.zeabur.app/api/v1/qiuqian 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"category": "CATEGORY", "question": "USER_QUESTION"}'

• category（选填）：事业、感情、财运、学业、健康
• question（选填）：用户希望解答的具体问题

5. 塔罗牌占卜（塔罗牌）

当用户请求塔罗牌占卜时：

curl -s -X POST https://heartai.zeabur.app/api/v1/tarot 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"question": "USER_QUESTION", "spread": "SPREAD_TYPE"}'

• question（选填）：待探索的问题
• spread（选填）：“single”（单张牌）、“three”（过去–现在–未来三张牌）、“celtic”（凯尔特十字完整牌阵）

6. 梦境解析（解梦）

当用户描述梦境并请求解析时：

curl -s -X POST https://heartai.zeabur.app/api/v1/dream 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"dream": "DREAM_DESCRIPTION"}'

• dream（必填）：用户的梦境描述

7. 老黄历（老黄历）

当用户询问今日吉凶、宜忌或老黄历时：

curl -s -X POST https://heartai.zeabur.app/api/v1/almanac 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"date": "YYYY-MM-DD"}'

• date（选填）：若未指定，则默认为当天

8. 风水分析（风水）

当用户询问风水、家居布局或方位时：

curl -s -X POST https://heartai.zeabur.app/api/v1/fengshui 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"direction": "DIRECTION", "element": "ELEMENT", "spaceType": "SPACE_TYPE"}'

• direction（选填）：东 / 南 / 西 / 北 / 东南 / 西南 / 东北 / 西北
• element（选填）：金 / 木 / 水 / 火 / 土
• spaceType（选填）：办公室 / 卧室 / 客厅

9. 姓名评分（姓名打分）

当用户希望为姓名评分或分析姓名含义时：

curl -s -X POST https://heartai.zeabur.app/api/v1/name-score 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"name": "FULL_NAME"}'

• name（必填）：中文或英文全名

10. 缘分合盘（兼容性）

当用户询问与某人之间的缘分或匹配度时：

curl -s -X POST https://heartai.zeabur.app/api/v1/compatibility 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"person1": {"birthDate": "YYYY-MM-DD", "name": "NAME1"}, "person2": {"birthDate": "YYYY-MM-DD", "name": "NAME2"}}'

• person1 与 person2 均须提供 birthDate；name 为可选项。

11. 生肖运势（生肖运势）

当用户询问其生肖运势时：

curl -s -X POST https://heartai.zeabur.app/api/v1/zodiac 
  -H "Authorization: Bearer $GUANXING_API_KEY" 
  -H "Content-Type: application/json" 
  -d '{"zodiac": "ZODIAC_ANIMAL", "birthYear": YEAR}'

• zodiac（选填）：鼠 / 牛 / 虎 / 兔 / 龙 / 蛇 / 马 / 羊 / 猴 / 鸡 / 狗 / 猪
• birthYear（选填）：出生年份，用于自动推算生肖

响应处理

所有接口均返回如下结构的 JSON：

{
  "success": true,
  "data": { ... },
  "meta": { "skill": "...", "tokensUsed": 245, "latencyMs": 1200 }
}

若 success 为 false，则响应中会包含 error 字段。请以友好方式向用户呈现错误信息。

响应格式化

向用户呈现结果时，请遵循以下规范：

• 自然使用中文术语（如 八字、五行、天干地支 等）
• 运势评分统一采用 X/100 或 X/5 星格式
• 突出显示幸运颜色、数字与方位
• 加密货币运势中需说明其对应的五行属性关系
• 语气应温暖而富有洞见，避免过于临床或机械
• 若用户使用英文交流，应对关键中文玄学术语作简要英文解释（如 “BaZi (Eight Characters of Birth)”、“Wu Xing (Five Elements)”）

信任声明

启用本技能后，您提供的数据（出生日期、姓名、问题等）将发送至 heartai.zeabur.app 的 GuanXing（观星）API 进行处理。API 利用 AI 生成玄学解读结果。请仅在充分信任该服务的前提下安装使用。API 文档地址：https://heartai.zeabur.app