命理分析服务

为什么需要这个服务

在应用里集成命理功能时，开发者常面临排盘逻辑复杂、多系统兼容难的问题：紫微斗数的十二宫、主辅星、四化，八字的四柱、十神、五行藏干，各自规则繁多，自行实现需大量领域知识与测试成本。该服务将多种命理系统封装为标准化MCP工具，开发者只需调用接口，无需维护底层排盘代码。

服务如何工作

技能以MCP协议服务器形式运行，核心是大模型作为路由层，负责理解用户意图、选择工具、提取参数，代码仅负责调用API。

• 强制密钥校验：首次使用时若 .env 中无 XBY_APIKEY，大模型必须通过 AskUserQuestion 向用户询问密钥，调用 scripts.config.set_api_key(api_key) 保存后才能继续，禁止无密钥时编造数据。
• 工具调用流程：根据用户意图选择对应工具函数（如紫微排盘 scripts.tools.get_ziwei_chart、八字五行分析 scripts.tools.analyze_bazi_element），提取参数后用关键字参数调用，整理返回的 result["raw"] 数据展示。
• 多系统支持：覆盖紫微斗数、八字等，提供排盘、运势查询、宫位分析、五行强弱等7类工具，参数支持阳历/农历、真太阳时修正等配置。

适用边界与注意点

• 该服务依赖外部API，需用户提供有效密钥，无密钥时无法运行。
• 参数不完整时（如缺少出生时辰、性别），大模型需主动询问，不能自行假设。
• 返回数据需直接展示原始结果，不可二次加工编造，适合需要标准化命理数据的AI工具集成，而非替代专业命理咨询。