核心用法
astroapi-skill 是一个功能全面的占星术 API 封装工具，通过 curl 调用外部占星服务，覆盖本命盘（Natal Chart）、双人合盘（Synastry）、行运分析（Transits）、太阳/月亮返照、塔罗牌阵、数字命理、吠陀占星、中国八字、人类图、卡巴拉、天文地理学等 190 余个端点。
典型调用模式为：
bash {baseDir}/scripts/astro-api.sh POST /api/v3/charts/natal '{...JSON参数...}'需提供出生日期、时间、地点（或经纬度），支持 Placidus、Whole Sign 等多种宫位系统，热带/恒星黄道选择。高级功能包括 SVG 星图渲染、AI 生成的个人分析报告、实时天象数据查询。
显著优点
- 覆盖面极广：西方占星、吠陀、中国命理、塔罗、人类图、卡巴拉等跨体系整合
- 输出格式丰富：JSON 数据、文本报告、SVG/PNG 可视化图表
- AI 解读加持：自动生成自然语言分析报告，降低专业术语门槛
- 多语言支持：EN、RU、FR、DE、ES、IT、PT 等
- 灵活定位：支持城市名或精确经纬度输入，解决边缘地点识别问题
潜在缺点与局限性
- 外部 API 依赖：需
ASTROLOGY_API_KEY环境变量，服务可用性受制于第三方 - 出生时间敏感：月亮位置、上升星座对时间精度要求高，未知时辰会显著降低准确度
- 命理学本身的争议性：占星术缺乏科学实证基础，输出应视为娱乐或文化参考，非决策依据
- 成本不透明：未提及 API 定价与速率限制，高频使用可能存在费用风险
- 隐私顾虑：需上传精确出生信息至外部服务器
适合人群
- 占星爱好者与自学者
- 命理咨询师、塔罗师等从业者
- 内容创作者（星座运势、占星科普）
- 对神秘学/灵性成长感兴趣的普通用户
- 需程序化生成星图的应用开发者
常规风险
- 数据隐私：出生信息属于敏感个人数据，建议确认 API 服务商隐私政策
- 心理暗示效应：负面解读可能引发焦虑，建议保持批判性思维
- API 密钥泄露：脚本调用需妥善保管
ASTROLOGY_API_KEY - 过度依赖：重大人生决策不应基于占星输出