核心用法
AstroAPI Skill 是一套功能全面的占星计算服务接口，通过 curl 调用 190+ API 端点，覆盖西方占星、印度占星、中国命理、塔罗、人类图等十余个玄学体系。
主要功能模块：
- 本命分析：生成出生星盘（natal chart）、行星位置、宫位、相位分析
- 关系合盘：synastry（双人比较盘）、composite（组合盘）兼容性解读
- 运势推运：transits（流年行运）、solar/lunar returns（日返/月返）、progressions（次限推进）
- 塔罗与数秘：塔罗牌阵抽取、核心数秘计算、姓名/生日解析
- 多体系支持：Vedic（印度占星）、Bazi（八字）、Human Design、Kabbalah、Astrocartography（占星地图）
- 可视化输出：SVG/PNG 星盘渲染、报告生成
调用方式：
bash {baseDir}/scripts/astro-api.sh POST /api/v3/charts/natal '{...JSON...}'需预先设置 ASTROLOGY_API_KEY 环境变量。
显著优点
- 体系完整：单一接口整合东西方主要命理系统，无需多源切换
- 计算标准化：基于专业天文算法（如 Swiss Ephemeris），行星位置精确
- 输出灵活：支持原始数据 JSON、AI 解读报告、可视化 SVG 三种形态
- 本地化支持：内置 EN/RU/FR/DE/ES/IT/PT 等多语言
- 默认配置合理：Placidus 宫位制 + 回归黄道，符合西方占星主流实践
潜在缺点与局限
- 依赖外部服务：需有效 API Key，存在配额限制与付费门槛
- 玄学非科学：所有解读属于文化/娱乐范畴，无实证医学或心理学依据
- 出生时间敏感：精确到分钟的推运结果对出生时间误差高度敏感
- 地理编码依赖：城市名称解析依赖外部地理数据库，偏远地区可能识别失败
- AI 报告不可控：AI-generated interpretation 的质量与一致性取决于服务商模型
适合人群
- 占星爱好者与个人探索者，希望快速获取标准化星盘数据
- 内容创作者（星座博主、塔罗师）需要批量生成解读素材
- 开发者集成命理功能到 App/网站，替代自建复杂计算库
- 心理学/人类学研究者进行占星文化现象的文本分析
常规风险
| 风险类别 | 具体表现 | 缓解建议 |
|---------|---------|---------|
| 隐私暴露 | 精确出生日期+地点可唯一识别个人身份 | 避免在日志中明文存储，仅保留哈希 |
| 心理暗示 | 负面解读可能引发焦虑或决策依赖 | 明确标注"娱乐参考"，不提供医疗/投资建议 |
| API 可用性 | 服务商中断导致功能失效 | 实现降级策略，本地缓存 ephemeris 数据 |
| 成本失控 | 高频调用（如实时推运）易消耗配额 | 设置调用频率上限与预算告警 |