命理综合系统 API / 前台栏目文档

获取服务基本信息和支持的功能分类列表。无需认证。

请求参数：无

返回示例：

{
  "service": "命理综合系统 API",
      "version": "2.3.0",
      "auth": "Header: X-User-ID + X-API-Key / X-Session-Token",
      "categories": ["bazi", "traditional", "numerology", ..., "member"]
}

检查服务运行状态。无需认证。

返回示例：

{
  "status": "ok",
  "model_loaded": false,
  "device": "cpu",
  "users_loaded": 3,
      "member_db": true,
  "time": "2026-03-13T12:00:00.000000"
}

根据出生信息进行完整的八字排盘，包含四柱、十神、纳音、五行、藏干、大运、流年等。

请求参数 (JSON Body)：

注：以上参数为 BirthReq 基础模型，被多个八字类接口复用。year/month/day/hour 虽有默认值但建议显式传入。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  八字排盘 - 张三 (男)\n  出生: 1990年6月15日 10时\n==================================================\n\n【八字】庚午 壬午 甲戌 己巳\n\n       年柱    月柱    日柱    时柱\n天干:  庚      壬      甲      己\n地支:  午      午      戌      巳\n\n【十神】偏官  偏印  日主  正财\n【纳音】路旁土  杨柳木  山头火  大林木\n【日主】甲(木) - 偏弱\n【五行】金1 木1 水1 火3 土2\n【缺失】无\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

八字排盘的深度解读版，包含十大板块：四柱排列、日主分析、五行旺衰、十神详解(性格/六亲/事业/财运/感情)、藏干透出、十二长生、格局判定、喜用神、大运走势、综合评分。

请求参数：同 八字排盘 (BirthReq)

返回：详细命理解读文本报告（约2000-3000字）

返回结果示例：

{
  "status": "ok",
  "result": "【八字精算详细解读】\n\n一、四柱排列\n年柱：庚午  月柱：壬午  日柱：甲戌  时柱：己巳\n\n二、日主分析\n日主甲木，生于午月，火旺木衰...\n\n三、五行旺衰\n木：偏弱  火：旺  土：中和  金：弱  水：弱\n\n四、十神详解\n性格：刚直仁慈，上进心强...\n六亲：父缘薄，母缘厚...\n事业：宜文职、教育...\n财运：正财为主...\n感情：重情重义...\n\n五、藏干透出\n...\n六、十二长生\n...\n七、格局判定\n...\n八、喜用神\n...\n九、大运走势\n...\n十、综合评分：82分\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据八字推算当天的运势（事业、财运、感情、健康等）。

请求参数：同 八字排盘 (BirthReq)

返回结果示例：

{
  "status": "ok",
  "result": "【今日运势 - 2026年7月3日】\n日主：甲木  流日：丙寅\n\n事业运：★★★★☆\n食神生财，思路灵活，利于创意工作，宜主动沟通。\n\n财运：★★★☆☆\n正财平稳，偏财一般，不宜大额投资。\n\n感情运：★★★★☆\n桃花显旺，单身者有姻缘际遇，已婚者感情融洽。\n\n健康运：★★★☆☆\n木火偏旺，注意肝胆与心火，宜清淡饮食。\n\n幸运色：青色  幸运方位：东方\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

双方八字合婚评分分析，包含天干五合、地支六合/六冲/三合等。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【八字合婚分析】\n甲方：张三 (男) 1990年6月15日 10时\n乙方：李静 (女) 1992年3月20日 14时\n\n合婚评分：85分\n天干五合：有合\n地支六合：有合\n地支六冲：无冲\n地支三合：有合\n综合评定：吉\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

对两人的八字命盘进行并排对照分析，适合用于前台 hepan.html 的双人命盘比对展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【八字合盘对照】\n甲方：张三  庚午 壬午 甲戌 己巳\n乙方：李四  壬申 癸卯 乙亥 丁亥\n\n（双人命盘并排对照分析...）",
  "timestamp": "2026-03-13T12:00:00.000000"
}

分析指定年份的流年运势（日主与流年天干的十神关系）。

请求参数：BirthReq + 额外字段

返回结果示例：

{
  "status": "ok",
  "result": "【流年运势 - 2026年】\n日主：甲木\n流年天干：丙火（食神）\n流年地支：午火\n\n事业：食神生财，利于技能发挥...\n财运：...\n感情：...\n健康：...\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据婚姻宫和日主五行推算配偶外貌、性格、职业特征。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "【正缘画像】\n日主：甲木  婚姻宫：戌土\n\n配偶外貌：\n身高中等偏上，体态匀称，面型方正，肤色偏黄，眉目清秀。\n\n配偶性格：\n沉稳踏实，重信义，行事稳重，略带固执，顾家爱家。\n\n配偶职业特征：\n宜从事五行属土、金的行业，如房地产、建筑、金融、机械、矿业等。\n\n相识方位：西北方\n相识年份：龙年、狗年机缘较旺\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据八字五行和日主强弱预测财运走向。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "【财运预测】\n日主：甲木  身强身弱：偏弱\n财星：己土（正财）、戊土（偏财）\n\n财运总评：\n身弱财旺，需借印比帮扶方能任财。早年财运平平，中年遇印星大运财运渐佳。\n\n正财运：★★★☆☆\n宜稳定职业，靠专业积累获财，忌投机冒险。\n\n偏财运：★★☆☆☆\n偏财较弱，不宜大额投资或创业冒进。\n\n有利方位：中央、北方\n有利行业：土、水相关行业\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

未来10年红鸾/天喜/桃花流年分析。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "【姻缘预测 - 未来十年流年分析】\n日主：甲木  婚姻宫：戌\n\n2026年 丙午：红鸾星动，姻缘显旺，宜把握机缘。\n2027年 丁未：天喜照命，感情顺遂，有订婚结婚之喜。\n2028年 戊申：桃花平，宜稳定经营现有感情。\n2029年 己酉：流年合婚姻宫，姻缘有成。\n2030年 庚戌：冲婚姻宫，感情波折，宜慎重。\n2031年 辛亥：桃花暗动，注意烂桃花。\n2032年 壬子：子午冲，感情起伏，需多沟通。\n2033年 癸丑：天喜再现，姻缘转佳。\n2034年 甲寅：比劫夺财，注意第三者干扰。\n2035年 乙卯：桃花旺，姻缘定。\n\n最佳姻缘年份：2027年、2033年\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

详细叙述版命运预测：日主性格、命局格局、命运总评、事业方向、健康提示、大运走势。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "【命运预测 - 详细版】\n\n一、日主性格\n甲木日主，仁慈正直，刚毅上进，有领导才能，但略显固执...\n\n二、命局格局\n偏印格，木火通明，食伤生财，格局清纯...\n\n三、命运总评\n一生衣食丰足，早年波折，中年渐入佳境，晚景荣华。命主宜修身养性，把握机遇...\n\n四、事业方向\n宜文职、教育、文化、创意行业，忌武职、重体力劳动。中年遇贵人提携，事业可大成...\n\n五、健康提示\n木旺火盛，注意肝胆、心脑血管，宜规律作息，少熬夜...\n\n六、大运走势\n10岁起运，庚辰、辛巳、壬午、癸未、甲申、乙酉、丙戌、丁亥...\n30-50岁为人生黄金期，宜积极进取...\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

详细叙述版结婚预测：婚姻宫详解、配偶星分析、姻缘方位、10年婚恋流年、最佳结婚年份。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "【结婚预测 - 详细版】\n\n一、婚姻宫详解\n婚姻宫戌土，藏戊辛丁，主配偶沉稳内敛，婚姻基础稳固...\n\n二、配偶星分析\n正财星己土透干，配偶贤淑持家，情深意重；偏财戊土藏支，偶有桃花干扰...\n\n三、姻缘方位\n正缘方位在西北方，相亲方位宜往西南方...\n\n四、十年婚恋流年\n2026年 丙午：红鸾入命，姻缘显旺\n2027年 丁未：天喜照命，宜婚宜嫁\n2028年 戊申：配偶星显，定亲之机\n2029年 己酉：合婚姻宫，喜结良缘\n2030年 庚戌：冲婚姻宫，感情动荡，宜推迟\n2031-2035年：婚姻稳定，家庭和睦\n\n五、最佳结婚年份\n首选：2027年（丁未天喜年）\n次选：2029年（己酉合婚年）\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

逐年分析：十神关系×事业/财运/感情/健康、桃花年/红鸾年标记、星级评分。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "【未来十年运势 - 详细版】\n日主：甲木\n\n【2026年 丙午】十神：食神  ★★★★☆\n事业：食神生财，利于技能发挥与创意工作\n财运：偏财显旺，投资理财有获\n感情：桃花年，单身者姻缘机缘旺 ★桃花\n健康：火旺，注意心火与眼疾\n\n【2027年 丁未】十神：伤官  ★★★☆☆\n事业：伤官见官，注意口舌是非\n财运：财库被冲，宜守不宜攻\n感情：天喜年，已婚者感情升温 ★天喜\n健康：脾胃稍弱，注意饮食\n\n【2028年 戊申】十神：偏财  ★★★★★\n事业：偏财生杀，事业突破之机\n财运：财星透干，正偏财皆佳\n感情：配偶星显，定亲良机\n健康：整体平稳\n\n【2029年 己酉】十神：正财  ★★★★☆\n事业：正财合身，事业稳定上升\n财运：正财为主，宜稳扎稳打\n感情：合婚姻宫，喜结良缘\n健康：金木相战，注意肝胆\n\n【2030年 庚戌】十神：七杀  ★★☆☆☆\n事业：七杀攻身，压力较大\n财运：财来财去，宜节俭\n感情：冲婚姻宫，需多包容\n健康：注意外伤与呼吸系统\n\n【2031-2035年】运势逐年分析...\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

使用微调过的LLM模型进行八字预测。mode=chart时回退到算法排盘，mode=predict时使用AI模型。

请求参数：BirthReq + 额外字段

⚠ mode="predict" 需要预先加载模型，否则返回 503。

返回结果示例：

{
  "status": "ok",
  "result": "【八字AI预测】\n姓名：张三  性别：男\n公历：1990年6月15日 10时\n农历：庚午年 五月 廿三 巳时\n\n四柱：庚午 壬午 甲戌 己巳\n日主：甲木  五行：木1 火3 土2 金1 水1\n\nAI解读：\n命主甲木生于午月，火旺木衰，日主偏弱。命中火土较旺，金水不足...\n性格方面，甲木日主刚直仁慈，为人正直，有上进心，但火多木焚，性子略急...\n事业方面，宜从事文化、教育、创意类行业，中年遇印星大运可获突破...\n财运方面，身弱财旺，需借印比帮扶，正财稳定，偏财谨慎...\n感情方面，婚姻宫戌土，配偶贤淑，中年姻缘机缘较佳...\n健康方面，注意肝胆、心脑血管，宜规律作息...\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

分析指定年份的详细运势，支持指定流年派系。

请求参数：BirthReq + 额外字段

返回结果示例：

{
  "status": "ok",
  "result": "【未来指定年份运势 - 2026年】\n日主：甲木  流年：丙午\n十神：食神\n\n事业运：★★★★☆\n食神生财，才华得展，宜主动争取表现机会，职场人际关系融洽。\n\n财运：★★★★☆\n财星有源，正财偏财皆有机会，利于投资理财与副业发展。\n\n感情运：★★★★☆\n流年桃花，单身者姻缘机缘旺，已婚者感情甜蜜。\n\n健康运：★★★☆☆\n火旺木焚，注意心火旺盛、眼疾与睡眠，宜清淡饮食、规律作息。\n\n学业运：★★★★☆\n食神主文，利于考试进修与学习深造。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

袁天罡称骨术，按出生年月日时对应的骨重计算命格。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "袁天罡称骨算命\n\n姓名：张三  性别：男\n出生：1990年6月15日 10时\n\n【骨重】总重：四两二钱\n  年骨：一两五钱\n  月骨：六钱\n  日骨：一两二钱\n  时骨：九钱\n\n【命格】中等命格\n\n【称骨歌】\n得宽怀处且宽怀，何必双眉皱不开。\n若使中年命运济，那时名利一起来。\n\n【解析】\n此命为人性燥，心直口快，有才能，见义勇为，不求人，自立家计，早年驳杂，劳碌奔波，初限不顺，中限渐佳，晚年大兴...\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

前台 guxiang.html 对应接口。后端实现复用称骨算法，但以“骨相论命”文案输出。

请求参数：同 BirthReq / GuxiangReq

返回结果示例：

{
  "status": "ok",
  "result": "骨相论命\n\n姓名：张三  性别：男\n出生：1990年6月15日 10时\n\n【总骨重】四两二钱\n\n【骨相特征】\n头骨：圆润饱满\n额骨：宽广平满\n颧骨：适中有势\n下颌骨：方正厚实\n\n【骨相论命】\n此骨相者，性格刚柔并济，仁慈聪慧，早年得贵人相助，中年立业成家，晚年福禄双全。\n\n【诗曰】\n得宽怀处且宽怀，何必双眉皱不开。\n若使中年命运济，那时名利一起来。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生年份推算九星命理。

请求参数：同 BirthReq（详见八字排盘接口）

返回结果示例：

{
  "status": "ok",
  "result": "九星命理推算\n\n姓名：张三  性别：男\n出生年：1990年\n\n【九星归属】三碧禄存星（木）\n\n【星性解析】\n三碧星属木，主智慧、文学、艺术之才，性情刚直，富有创造力。\n\n【性格】\n聪明好学，善于思考，但易冲动，需修身养性。\n\n【事业】\n宜文教、艺术、设计、出版等行业，可成大器。\n\n【财运】\n财源广进，但需防破财，宜守不宜攻。\n\n【健康】\n注意肝胆、神经系统之疾。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生月日分析性格和运势。

返回结果示例：

{
  "status": "ok",
  "result": "生日论命\n\n姓名：张三\n出生：6月15日\n\n【性格分析】\n6月15日出生的人，性格温和而坚定，富有同情心，乐于助人，但有时过于敏感。\n\n【优点】\n心地善良，待人真诚，富有责任感。\n\n【缺点】\n情绪化，易受外界影响。\n\n【爱情运】\n感情丰富，注重家庭，宜配温柔体贴之人。\n\n【事业运】\n适合从事艺术、教育、医疗、服务等行业。\n\n【财运】\n财源稳定，晚年富足，宜积蓄。\n\n【幸运色】橙色\n【幸运数字】3、6\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生日期推算前世今生六道归属。

请求参数：同 BirthReq（详见八字排盘接口）

返回结果示例：

{
  "status": "ok",
  "result": "六道轮回推算\n\n姓名：张三  性别：男\n出生：1990年6月15日 10时\n\n【前世六道归属】天道\n\n【释义】\n前世生于天道，主尊贵、福报深厚，今生得人身，福泽绵长。\n\n【今生特征】\n聪明仁慈，相貌端正，性格温和，人缘极佳。\n\n【因果】\n前世积累善业，今生福报具足，宜继续行善积德。\n\n【建议】\n保持善念，多行布施，戒杀放生，可增福延寿。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

按出生年份查询生肖、值太岁/冲太岁等相关信息，对应前台 taisui.html。基础查询结果可见，涉及化解方法的段落按当前会员等级 / SVIP 规则展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "太岁生肖查询\n\n姓名：张三  性别：男\n查询年份：2024年（甲辰年）\n\n【生肖】马\n【太岁关系】冲太岁\n\n【太岁解析】\n2024甲辰年，生肖马为冲太岁，主变动较多，需谨慎应对。\n\n【影响】\n事业：易有变动，防口舌是非\n财运：财源不稳，防破财\n健康：注意心血管、肠胃\n感情：易生口舌，需多沟通\n\n【化解方法】\n* 化解方法详情按当前会员等级 / SVIP 规则展示\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

前台 yinzhai.html 对应接口，根据出生时间计算阴债相关结果。基础债额与等级结果可查看，化解方法与还债注意事项按当前会员等级 / SVIP 规则展示。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "阴债计算\n\n姓名：张三  性别：男\n出生：1990年6月15日 10时\n\n【阴债总额】三万六千贯\n\n【明细】\n受生债：一万二千贯\n本命债：八千贯\n冤亲债主：六千贯\n业力债：一万贯\n\n【评级】中等\n\n【化解方法】\n* 化解方法与还债注意事项按当前会员等级 / SVIP 规则展示\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生时间查询仙家缘分相关信息。

返回结果示例：

{
  "status": "ok",
  "result": "仙家缘分查询\n\n姓名：张三  性别：男\n出生：1990年6月15日 10时\n\n【仙家缘分】有\n\n【主仙】胡三太爷\n【仙家类型】狐仙\n【缘分等级】★★★★☆\n\n【缘分说明】\n此命格与狐仙缘分深厚，主聪明灵秀，通灵慧根，宜修习玄学。\n\n【供奉建议】\n宜供奉胡三太爷，每月初一十五焚香礼拜，可增福添慧。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据81数理分析手机号码吉凶。

返回结果示例：

{
  "status": "ok",
  "result": "手机号吉凶分析\n\n号码：13812345678\n\n【数理总分】56 → 大吉\n\n【寓意】\n五六之数，主立身兴家，大业成就，富贵荣华。\n\n【运势分析】\n事业：★★★★☆ 贵人扶持\n财运：★★★★ 财源广进\n感情：★★★★ 桃花旺盛\n健康：★★★ 需防小恙\n\n【综合评级】大吉\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "QQ号吉凶分析\n\n号码：12345678\n\n【数理分析】36 → 凶\n\n【寓意】\n三六之数，主波澜重叠，常陷困境，须防小人。\n\n【运势分析】\n事业：★★ 波折较多\n财运：★★ 破财之兆\n感情：★★★ 平平淡淡\n健康：★★★ 注意休息\n\n【综合评级】凶\n【建议】可考虑更换号码\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "车牌号吉凶分析\n\n车牌号：京A12345\n类型：个人\n\n【数理分析】15 → 大吉\n\n【寓意】\n一五之数，主福寿双全，立业兴家，万事顺遂。\n\n【运势分析】\n出行：★★★★★ 平安顺遂\n财运：★★★★ 财运亨通\n事业：★★★★ 步步高升\n\n【综合评级】大吉\n【建议】此车牌宜用，出行平安\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "身份证吉凶分析\n\n号码：110101199006151234\n\n【数理分析】53 → 平\n\n【寓意】\n五三之数，主内忧外患，须防微杜渐，谨慎行事。\n\n【运势分析】\n事业：★★★ 平稳发展\n财运：★★★ 积少成多\n感情：★★★ 中规中矩\n健康：★★★ 注意保养\n\n【综合评级】平\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "电话号吉凶分析\n\n号码：010-12345678\n\n【数理分析】37 → 大吉\n\n【寓意】\n三七之数，主权威显达，吉人天相，事业有成。\n\n【运势分析】\n事业：★★★★ 权势显赫\n财运：★★★★ 财源稳固\n感情：★★★ 平稳和谐\n健康：★★★★ 安泰康宁\n\n【综合评级】大吉\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "数字吉凶分析\n\n数字：88888888\n\n【数理分析】64 → 大吉\n\n【寓意】\n六四之数，主富贵荣华，万事如意，福寿绵长。\n\n【运势分析】\n事业：★★★★★ 飞黄腾达\n财运：★★★★★ 财源广进\n感情：★★★★ 美满幸福\n健康：★★★★ 福寿绵长\n\n【综合评级】大吉\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生月日判定星座并输出性格运势分析。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  星座分析 - 张三\n  出生: 8月15日\n==================================================\n\n【星座】狮子座 (Leo) 07/23 - 08/22\n【守护星】太阳\n【守护宫】第五宫\n【元素】火象星座\n【特质】固定宫\n\n【性格特点】\n狮子座的你天生具有王者风范，自信、热情、慷慨大方，喜欢成为众人瞩目的焦点。\n你富有领导才能，行事果断，对朋友忠诚，但需注意避免过于自我中心和固执。\n\n【爱情运势】\n感情中追求浪漫与激情，渴望被仰慕。今年桃花旺盛，有望邂逅心仪对象。\n\n【事业运势】\n事业处于上升期，适合展现才华与领导力，有望获得晋升机会。\n\n【幸运色彩】金色、橙红\n【幸运数字】1、9\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  星座每日运势 - 白羊座\n  日期: 2026-03-13\n==================================================\n\n【综合运势】★★★★☆\n今日整体运势上扬，行动力旺盛，适合推进新计划。\n\n【爱情运势】★★★★★\n金星拱月亮，单身者有望遇到心动对象；有伴者感情甜蜜升温。\n\n【事业运势】★★★☆☆\n水星与天王星形成相位，思维活跃但需注意沟通细节，避免口舌之争。\n\n【财运】★★★★☆\n正财稳健，偏财有机会，可关注短期投资。\n\n【健康运势】★★★★☆\n精力充沛，但火星入庙易急躁，注意情绪管理与作息。\n\n【幸运色】红色、橙色\n【幸运数字】5、9\n【幸运方位】正东\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  星座配对分析\n  白羊座 ♈  VS  天秤座 ♎\n==================================================\n\n【综合配对指数】85分 ★★★★☆\n【配对元素】火象 VS 风象 - 互相吸引，能量互补\n【对宫星座】180度对冲，既是挑战也是镜像互补\n\n【友情配对】★★★★☆\n彼此欣赏对方的特质，白羊的行动力搭配天秤的协调力，相处愉快。\n\n【爱情配对】★★★★★\n初期吸引力极强，白羊被天秤的优雅气质吸引，天秤欣赏白羊的果断。\n对宫关系带来强烈化学反应，但需注意节奏差异。\n\n【婚姻配对】★★★★☆\n长久相处需要磨合：白羊直率冲动，天秤优柔圆融。学会互相退让可成佳偶。\n\n【亲情配对】★★★★☆\n家庭关系融洽，天秤的平衡感有助于化解白羊的急躁情绪。\n\n【建议】\n发挥互补优势，白羊学习天秤的圆融，天秤借鉴白羊的果决。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据精确出生时间与经纬度，绘制西洋占星本命盘（Natal Chart），含行星落座、宫位、相位、SVG 星盘图。

返回字段：

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  西洋占星本命盘 - 张三 (男)\n  出生: 1990-06-15 10:00  东经116°23' 北纬39°54'\n  宫位系统: Placidus\n==================================================\n\n【四轴】\n  ASC(上升): 天秤座 12°35'\n  DESC(下降): 白羊座 12°35'\n  MC(天顶): 巨蟹座 05°12'\n  IC(天底): 摩羯座 05°12'\n\n【行星落座与宫位】\n  太阳: 双子座 24°08'  第9宫\n  月亮: 水瓶座 16°42'  第4宫\n  水星: 巨蟹座 09°33'  第10宫\n  金星: 狮子座 02°15'  第10宫\n  火星: 金牛座 18°50'  第8宫\n  木星: 巨蟹座 02°11'  第10宫\n  土星: 摩羯座 18°22'  第4宫\n  天王星: 摩羯座 11°05'  第3宫\n  海王星: 摩羯座 15°30'  第3宫\n  冥王星: 天蝎座 19°48'  第2宫\n\n【主要相位】(容许度: 标准)\n  太阳 三分 月亮 (120°, 容许度5.2°)\n  金星 合相 木星 (0°, 容许度0.8°)\n  月亮 四分 土星 (90°, 容许度1.5°)\n  火星 三分 冥王星 (120°, 容许度2.1°)\n  水星 六合 天王星 (60°, 容许度1.6°)\n\n【星盘图】SVG 已生成 (chart_svg 字段)\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

双人比较盘：分别计算两人本命盘，输出交叉相位分析。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  比较盘 Synastry - 张三 VS 李四\n  A方: 1990-06-15 10:00  B方: 1992-03-08 14:30\n==================================================\n\n【双方行星对照】\n  A太阳(双子座)  VS  B月亮(双子座)   → 合相 0°\n  A月亮(水瓶座)  VS  B太阳(双鱼座)   → 六合 60°\n  A金星(狮子座)  VS  B火星(白羊座)   → 三分 120°\n  A水星(巨蟹座)  VS  B水星(双鱼座)   → 三分 120°\n\n【交叉相位分析】\n  ★ A的太阳合相B的月亮：情感共鸣强烈，是亲密关系的核心纽带。\n  ★ A的金星三分B的火星：浪漫吸引力十足，性爱和谐。\n  ★ A的土星四分B的太阳：责任感带来压力，需注意一方过度约束另一方。\n  ★ A的木星合相B的上升：彼此带来成长机遇，关系乐观向上。\n\n【关系评估】\n  情感亲密度: ★★★★★\n  沟通契合度: ★★★★☆\n  价值观契合: ★★★★☆\n  长期稳定性: ★★★☆☆\n\n【建议】发挥金星-火星和谐相位带来的浪漫，化解土星方带来的压力。\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

取双人行星中点合成一张组合盘，反映关系整体能量。参数同比较盘。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  组合盘 Composite Chart - 张三 & 李四\n  中点合成星盘\n==================================================\n\n【组合盘行星落座】\n  太阳: 双鱼座 03°22'  → 关系核心：感性包容、互相体谅\n  月亮: 摩羯座 28°15'  → 情感基调：克制稳重、务实可靠\n  水星: 双鱼座 21°40'  → 沟通方式：感性细腻、富同理心\n  金星: 双鱼座 18°50'  → 爱情表达：浪漫温柔、相互奉献\n  火星: 双子座 10°08'  → 行动模式：灵活多变、需防浮躁\n\n【组合盘宫位】\n  太阳落第7宫：关系本身是双方核心议题，强调伴侣契约与平衡。\n  月亮落第10宫：情感公众化，关系易被外界关注。\n  金星落第7宫：爱情能量集中，利于稳定伴侣关系。\n\n【主要相位】\n  太阳 合相 金星 (0°) → 浪漫能量强，爱情甜蜜\n  月亮 六合 木星 (60°) → 关系带来幸运与情感滋养\n  火星 四分 海王星 (90°) → 行动方向易模糊，需防误会\n\n【关系整体能量】\n  关系定位: 伴侣型，以爱与陪伴为核心\n  优势: 互相滋养、情感深度高\n  挑战: 现实目标需更清晰\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

将目标日期天象叠加到本命盘上，分析行运相位触发。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  行运盘 Transit - 张三\n  本命: 1990-06-15 10:00\n  推运: 2026-03-13 12:00\n==================================================\n\n【行运行星落座】\n  行运太阳: 双鱼座 22°45'\n  行运月亮: 天蝎座 08°12'\n  行运水星: 双鱼座 18°30'\n  行运金星: 水瓶座 26°05'\n  行运火星: 巨蟹座 14°20'\n  行运木星: 双子座 12°48'\n  行运土星: 双鱼座 19°33'\n\n【行运触发相位】\n  ★ 行运土星 合相 本命太阳 (0°) → 责任加重，重要人生转折期，需踏实耕耘\n  ★ 行运木星 三分 本命月亮 (120°) → 情感丰盛，家庭喜事，心情愉悦\n  ★ 行运天王星 四分 本命金星 (90°) → 感情突变数，需灵活应对\n  ★ 行运冥王星 六合 本命中天 (60°) → 事业转型机遇，深度变革\n\n【行运宫位聚焦】\n  行运太阳过本命第10宫：事业高光期，公众形象受关注\n  行运土星过本命第9宫：学习与信仰领域需承担责任\n\n【周期提示】\n  土星回归期临近(约2年后)，建议提前规划长远目标\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

一天等于一年的推运法，反映内在心理演化。参数同行运盘。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  次限盘 Secondary Progression - 张三\n  本命: 1990-06-15 10:00\n  推运年龄: 35岁 (1天=1年)\n  推运日期: 1990-07-20 10:00\n==================================================\n\n【推进行星落座】\n  推进太阳: 巨蟹座 03°12' (约每年推进1°)\n  推进月亮: 摩羯座 18°45' (推进月亮换座较快，反映情绪演变)\n  推进水星: 巨蟹座 15°28'\n  推进金星: 双子座 28°50'\n  推进火星: 巨蟹座 22°10'\n\n【次限相位】\n  ★ 推进太阳 合相 本命木星 → 自信与机遇提升，内在成长期\n  ★ 推进月亮 三分 本命太阳 → 情感与意志协调，内心安定\n  ★ 推进水星 六合 本命天王星 → 思维突破，学习新知的好时机\n  ★ 推进金星 合相 本命中天 → 事业与美感结合，社交运势佳\n\n【内在心理演化分析】\n  推进太阳进入巨蟹座：内省向家庭、归属感倾斜，关注情感根基。\n  推进月亮处于摩羯座：情绪趋于克制务实，追求情感的安全感。\n\n【心理主题】\n  当前阶段：内在情感成熟期，适合沉淀与自我滋养\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

以太阳弧度推进全盘行星，反映外在事件触发。参数同行运盘。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  太阳弧 Solar Arc - 张三\n  本命: 1990-06-15 10:00\n  推运年龄: 35岁\n  太阳弧增量: +35°00'\n==================================================\n\n【太阳弧行星落座】\n  SA太阳: 狮子座 29°08' (本命双子座24°08' + 35°)\n  SA月亮: 处女座 21°42' (本命水瓶座16°42' + 35°)\n  SA水星: 处女座 14°33'\n  SA金星: 处女座 07°15'\n  SA火星: 巨蟹座 23°50'\n  SA木星: 处女座 07°11'\n  SA土星: 白羊座 23°22'\n\n【太阳弧触发相位】\n  ★ SA太阳 合相 本命上升(天秤座) → 自我形象重塑期，重要人生节点\n  ★ SA木星 合相 本命中天 → 事业突破，扩张机遇\n  ★ SA土星 四分 本命月亮 → 情感责任加重，家庭考验\n  ★ SA火星 三分 本命冥王星 → 行动力与意志力结合，攻坚克难\n\n【外在事件触发提示】\n  SA太阳-上升合相：通常伴随身份、形象、关系层面的重大事件\n  SA木星-中天合相：事业晋升、公众认可的高峰期\n\n【周期主题】\n  当前为外在成就显化期，宜把握事业与地位机遇\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

太阳回归本命度数时刻的年度星盘，用于年度运势分析。参数同行运盘。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  日返照盘 Solar Return - 张三\n  本命太阳度数: 双子座 24°08'\n  返照时刻: 2026-06-15 22:34\n  覆盖周期: 2026-06 至 2027-06\n==================================================\n\n【返照盘四轴】\n  ASC: 天蝎座 18°20'\n  MC: 处女座 12°45'\n  返照地点: 北京\n\n【返照盘行星落宫】\n  太阳: 第8宫 → 本年度聚焦深度转化、共享资源、心理探索\n  月亮: 第10宫 → 事业情感波动大，公众形象受关注\n  水星: 第9宫 → 学习、远行、哲学思考活跃\n  金星: 第7宫 → 伴侣关系主题突出，合作运佳\n  火星: 第11宫 → 社交圈行动力强，人际推进有力\n  木星: 第2宫 → 财务扩张机遇\n  土星: 第4宫 → 家庭责任加重，根基建设期\n\n【年度关键相位】\n  ★ 返照太阳 三分 返照月亮 → 自我意志与情感协调，年度顺遂\n  ★ 返照土星 四分 返照ASC → 自我形象与家庭考验\n  ★ 返照木星 六合 返照金星 → 财情双收信号\n\n【年度主题】\n  核心议题：深度蜕变(8宫)与家庭根基(4宫)的平衡\n  机遇：财务扩张与人际合作\n  挑战：家庭责任与自我表达间的张力\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

月亮回归本命度数时刻的月度星盘，用于28天短期运势预测。参数同行运盘。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  月返照盘 Lunar Return - 张三\n  本命月亮度数: 水瓶座 16°42'\n  返照时刻: 2026-03-10 04:12\n  覆盖周期: 28天 (2026-03-10 至 2026-04-07)\n==================================================\n\n【返照盘四轴】\n  ASC: 双子座 05°30'\n  MC: 水瓶座 22°18'\n  返照地点: 北京\n\n【返照盘行星落宫】\n  月亮: 第1宫 → 本月情感与自我表达突出，主观感受强烈\n  太阳: 第10宫 → 事业公众形象受关注\n  水星: 第10宫 → 工作沟通、谈判频繁\n  金星: 第9宫 → 远行、学习领域有桃花或愉悦\n  火星: 第6宫 → 工作节奏紧凑，注意健康与作息\n  木星: 第3宫 → 邻里、短途、信息交流顺畅\n  土星: 第8宫 → 共享资源、债务需审慎处理\n\n【月度关键相位】\n  ★ 返照月亮 合相 返照上升 → 情绪敏感，自我意识强\n  ★ 返照太阳 三分 返照月亮 → 本月意志与情感协调\n  ★ 返照火星 六合 返照水星 → 行动与沟通高效\n  ★ 返照土星 四分 返照金星 → 财务与关系需克制\n\n【月度主题】\n  焦点：自我表达(1宫)与事业推进(10宫)并重\n  机遇：学习远行带来愉悦，沟通谈判顺利\n  注意：健康作息与共享财务审慎\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

紫微斗数排盘，含五行局、紫微系/天府系安星、12辅星、四化。

请求参数：同 BirthReq

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  紫微斗数排盘 - 张三 (男)\n  出生: 农历 1990年五月廿三 巳时\n  命局: 水二局  命宫: 子\n==================================================\n\n【十二宫主星】\n  命宫(子): 紫微 天府  → 紫府同宫，帝王格局\n  兄弟宫(丑): 天机 太阴\n  夫妻宫(寅): 贪狼\n  子女宫(卯): 天同 巨门\n  财帛宫(辰): 武曲 天相\n  疾厄宫(巳): 太阳 天梁\n  迁移宫(午): 七杀\n  交友宫(未): 破军\n  事业宫(申): 廉贞\n  田宅宫(酉): 空宫(借对宫太阳天梁)\n  福德宫(戌): 空宫(借对宫武曲天相)\n  父母宫(亥): 天同 巨门\n\n【五行局】水二局 (命宫天干丙 + 地支子 = 水二局)\n\n【四化】(年干庚)\n  太阳化禄 → 福气、贵人运增强\n  武曲化权 → 事业财权提升\n  太阴化科 → 名声、文昌运佳\n  天同化忌 → 情绪、享受受阻\n\n【主星格局解析】\n  紫府同宫坐命：领导力强，富贵双全之格\n  武曲天相入财帛：财帛丰厚，理财有道\n  七杀入迁移：外出发展有成，奔波得财\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

紫微斗数流年盘，含流年四化。

返回结果示例：

{
  "status": "ok",
  "result": "==================================================\n  紫微斗数流年盘 - 张三\n  本命: 1990年五月廿三 巳时\n  流年: 2026年(丙午)\n  流年命宫: 午\n==================================================\n\n【流年宫位流转】\n  流年命宫(午): 七杀 → 本年开创、变动之年，宜主动求变\n  流年财帛宫(寅): 贪狼 → 偏财机会多，需防破耗\n  流年事业宫(戌): 紫微天府 → 事业地位提升，贵人提携\n  流年夫妻宫(子): 破军 → 感情波动，需用心经营\n\n【流年四化】(年干丙)\n  天同化禄 → 享受、福气增加，人际和顺\n  天机化权 → 思维敏锐，决策主动权增强\n  文昌化科 → 文书考试运佳，利于晋升考核\n  廉贞化忌 → 是非官非、感情纠纷需防\n\n【流年主星吉凶提示】\n  ★ 七杀坐流年命宫：变动开创之年，宜主动出击，忌守成\n  ★ 紫府入流年事业宫：事业高升机遇，把握贵人\n  ★ 廉贞化忌冲流年夫妻宫：感情易生口舌，需忍让\n\n【流年运势总评】\n  事业: ★★★★★  贵人助力强，地位提升\n  财运: ★★★★☆  偏财有机，需防破耗\n  感情: ★★★☆☆  波动较多，宜耐心化解\n  健康: ★★★★☆  整体平稳，注意肠胃\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

六爻排盘（纳甲+世应+六亲+六神+断卦提示）。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【六爻排盘】\n公历：2026年3月13日 星期五\n农历：丙午年 二月 廿四\n干支：丙午年 辛卯月 庚辰日 丙子时\n\n卦象：坎为水（坎宫八卦）\n世应：世爻在三爻 应爻在六爻\n六亲：父母 兄弟 官鬼 妻财 子孙\n六神：青龙 朱雀 勾陈 腾蛇 白虎 玄武\n\n断卦提示：用神得位 事可成...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

梅花易数起卦（体用生克+互变错综子卦+64卦详解）。结果包含吉凶分析段落（用克体、体生用、下下卦凶象等）；化解/破解方法按当前会员等级 / SVIP 规则展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【梅花易数】\n公历：2026年3月13日\n\n本卦：坎为水（坎上坎下）\n体卦：坎水 用卦：坎水\n体用生克：体用比和 事可成\n互卦：山雷颐\n变卦：泽水困\n\n吉凶分析：用克体 凶象...\n化解方法：...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据当前时间起金口诀课。结果包含吉凶分析段落（将神衰弱、贵神克人元、地分衰弱、四位连环克、地分旬空等）；化解/破解方法按当前会员等级 / SVIP 规则展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【大六壬金口诀】\n公历：2026年3月13日 丙子时\n\n人元：甲\n贵神：乙丑（天乙贵人）\n将神：丁卯\n地分：巳\n\n四位生克：将神衰弱 贵神克人元 地分旬空...\n化解方法：...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据当前时间起奇门遁甲盘。结果包含吉凶分析段落（门迫局、凶门凶星同宫、白虎/玄武临凶门等）；化解/破解方法按当前会员等级 / SVIP 规则展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【奇门遁甲】\n公历：2026年3月13日 丙子时 阳遁\n\n九宫排盘：\n坎宫：休门 天蓬 玄武\n坤宫：死门 天芮 九天\n震宫：伤门 天冲 九地\n巽宫：杜门 天辅 值符\n中宫：— —\n乾宫：开门 天心 腾蛇\n兑宫：惊门 天柱 太阴\n艮宫：生门 天任 六合\n离宫：景门 天英 白虎\n\n吉凶分析：门迫局 凶门凶星同宫...\n化解方法：...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

阴盘奇门起盘。结果包含吉凶分析段落（同阳盘奇门）；化解/破解方法按当前会员等级 / SVIP 规则展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【阴盘奇门遁甲】\n公历：2026年3月13日\n\n九宫排盘：\n坎宫：休门 天蓬 玄武\n坤宫：死门 天芮 九天\n震宫：伤门 天冲 九地\n巽宫：杜门 天辅 值符\n中宫：— —\n乾宫：开门 天心 腾蛇\n兑宫：惊门 天柱 太阴\n艮宫：生门 天任 六合\n离宫：景门 天英 白虎\n\n神盘：值符 腾蛇 太阴 六合 白虎 玄武 九地 九天\n\n吉凶分析：...\n化解方法：...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

获取今日老黄历（宜忌、冲煞、吉神凶煞、农历、节气）。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【今日黄历】\n公历：2026年3月13日 星期五\n农历：丙午年 二月 廿四\n干支：丙午年 辛卯月 庚辰日\n\n宜：祭祀、祈福、开光、求嗣、出行...\n忌：嫁娶、移徙、入宅、安葬\n冲：冲狗(甲戌)煞南\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

黄历基础版，无需认证。支持查询指定日期（±365天）的黄历信息。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【黄历】\n公历：2026年3月13日\n农历：丙午年 二月 廿四\n干支：丙午年 辛卯月 庚辰日\n宜：祭祀、祈福...\n忌：嫁娶、移徙...\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【择吉日 · 嫁娶】\n查询范围：2026年3月13日起 30天内\n\n吉日列表：\n1. 2026年3月15日 庚辰日 宜嫁娶\n2. 2026年3月20日 乙酉日 宜嫁娶\n3. 2026年3月25日 庚寅日 宜嫁娶\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【童子命查询】\n姓名：张三 性别：男\n出生：1990年6月15日 10时\n\n查询结果：命带童子煞\n童子类型：春秋寅子贵\n影响：体弱多病 婚姻不顺 运势坎坷\n\n化解方法：送替身法事 佩戴化解符...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

输入梦境关键词进行解梦（210+词条）。

返回结果示例：

{
  "status": "ok",
  "result": "【周公解梦】\n关键词：蛇\n\n匹配词条：\n1. 梦见蛇：主财运 有贵人相助\n2. 梦见蛇咬：主口舌是非\n3. 梦见杀蛇：主吉 排除困难\n...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

输入完整梦境描述，多关键词匹配+场景组合+吉凶评定+运势影响。

返回结果示例：

{
  "status": "ok",
  "result": "【周公解梦 · 详细版】\n====\n梦境描述：梦见蛇在水里游\n\n▶ 一、梦境意象解析\n  1.【蛇】(动物)\n     梦见蛇多主财运...\n  2.【水】(自然)\n     梦见清水为吉...\n\n▶ 二、场景组合特殊解读\n  1. 梦见水中蛇，主偏财运...\n\n▶ 三、吉凶评定\n  综合吉凶：中吉 🌟🌟🌟🌟\n...",
  "timestamp": "2026-03-13T12:00:00"
}

按关键词或分类搜索解梦词条，支持分页。

返回结果示例：

{
  "code": 0,
  "data": {
    "total": 25,
    "page": 1,
    "page_size": 50,
    "keyword": "水",
    "category": "",
    "results": [
      {"idx": 120, "title": "水", "category": "自然"},
      {"idx": 121, "title": "河水", "category": "自然"},
      {"idx": 122, "title": "海水", "category": "自然"}
    ]
  }
}

根据词条索引获取解梦词条完整内容。

返回结果示例：

{
  "code": 0,
  "data": {
    "idx": 0,
    "title": "蛇",
    "category": "动物",
    "sub_category": "爬行类",
    "content": "梦见蛇多主财运，有贵人相助。若被蛇咬主口舌是非..."
  }
}

获取所有解梦词条的分类列表。

请求参数：无

返回结果示例：

{
  "code": 0,
  "data": {
    "人物": 56,
    "动物": 43,
    "植物": 28,
    "物品": 67,
    "活动": 35,
    "自然": 22,
    "建筑": 19,
    "鬼神": 14
  }
}

返回结果示例：

{
  "status": "ok",
  "result": "【公历转农历】\n公历：2026年3月13日\n农历：丙午年 二月 廿四\n干支：丙午年 辛卯月 庚辰日\n生肖：马\n节气：惊蛰后 第10天",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【2026年二十四节气】\n立春：2月4日\n雨水：2月19日\n惊蛰：3月5日\n春分：3月20日\n清明：4月5日\n谷雨：4月20日\n立夏：5月5日\n小满：5月21日\n芒种：6月5日\n夏至：6月21日\n小暑：7月7日\n大暑：7月22日\n立秋：8月7日\n处暑：8月23日\n白露：9月7日\n秋分：9月23日\n寒露：10月8日\n霜降：10月23日\n立冬：11月7日\n小雪：11月22日\n大雪：12月7日\n冬至：12月22日\n小寒：1月5日\n大寒：1月20日",
  "timestamp": "2026-03-13T12:00:00.000000"
}

对应前台 yaogua.html。按起卦逻辑返回结果。结果包含吉凶分析与化解/破解方法（同六爷排盘），按当前会员等级 / SVIP 规则展示。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【摇卦占卜】\n卦象：坎为水（坎宫八卦）\n世应：世爻在三爻 应爻在六爻\n六亲：父母 兄弟 官鬼 妻财 子孙\n六神：青龙 朱雀 勾陈 腾蛇 白虎 玄武\n\n吉凶分析：用神得位 事可成\n化解方法：...",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【灵签】\n签号：第二十七签\n签题：刘智远边关招亲\n签诗：君今庚甲未亨通 且向江头作钓翁 玉兔重生应发迹 万人头上逞英雄\n解曰：凡事耐守待时 静中作动 守旧待发\n典故：刘智远边关招亲",
  "timestamp": "2026-03-13T12:00:00.000000"
}

观音灵签增强版，无需参数，直接返回签文与详细解读。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【观音灵签】\n签号：第一百签\n吉凶：上签\n签题：楚襄王阳台梦醒\n签诗：楚襄王梦巫山阳台 暮暮朝朝事可哀 一觉醒来人不见 悟知原是大梦来\n解曰：凡事多虚少实 守旧待时\n典故：楚襄王阳台梦醒",
  "timestamp": "2026-03-13T12:00:00.000000"
}

佛祖灵签增强版，无需参数。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【佛祖灵签】\n签号：第三签\n吉凶：中签\n签题：唐僧取经\n签诗：千辛万苦路难行 万水千山岂等闲 历尽艰辛终到岸 取回真经度人间\n解曰：先苦后甜 功德圆满\n典故：唐三藏西天取经",
  "timestamp": "2026-03-13T12:00:00.000000"
}

诸葛灵签增强版，无需参数。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【诸葛灵签】\n签号：第十六签\n签题：孔明七擒孟获\n签诗：南方平定已成功 火攻藤甲显奇功 七擒七纵服蛮夷 仁义之师万古崇\n解曰：谋事可成 宜以仁服人\n典故：诸葛亮七擒孟获",
  "timestamp": "2026-03-13T12:00:00.000000"
}

月老灵签增强版，无需参数。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【月老灵签】\n签号：第五十签\n签题：姻缘天定\n签诗：红线暗中系足牢 姻缘本是前生造 不必强求自有期 终须配合结成娇\n解曰：姻缘天定 静待良缘\n典故：月老红线系足",
  "timestamp": "2026-03-13T12:00:00.000000"
}

妈祖灵签增强版，无需参数。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【妈祖灵签】\n签号：第十二签\n吉凶：上签\n签题：妈祖显圣救万民\n签诗：圣德巍巍护海疆 千帆万艘保安康 慈航普度逢凶化 四海清平颂吉祥\n解曰：出行吉利 海上平安\n典故：妈祖显圣救渔民",
  "timestamp": "2026-03-13T12:00:00.000000"
}

吕祖灵签增强版，无需参数。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【吕祖灵签】\n签号：第二签\n签题：钟吕传道\n签诗：仙道原来重自修 不须外向苦贪求 功成行满丹成后 自有金童作玉俦\n解曰：修道贵在自修 功成自然得道\n典故：钟离权度吕洞宾",
  "timestamp": "2026-03-13T12:00:00.000000"
}

78张全副牌 + 7种牌阵。

返回结果示例：

{
  "status": "ok",
  "result": "【塔罗牌占卜】\n问题：综合运势\n牌阵：三牌阵\n牌1：愚者（正位）- 新的开始 冒险 无限可能\n牌2：女祭司（逆位）- 内省不足 直觉受阻\n牌3：星星（正位）- 希望 灵感 平静\n\n解读：当下是开启新篇章的良机 唯需内省觉醒 方能迎来希望之光",
  "timestamp": "2026-03-13T12:00:00.000000"
}

抽取一张塔罗牌进行占卜，可指定牌面和正逆位。

返回结果示例：

{
  "status": "ok",
  "result": "【塔罗一张牌】\n牌名：太阳（The Sun）\n正逆位：正位\n牌意：快乐 成功 活力 真诚\n解读：阳光普照 阴霾散尽 积极乐观 充满希望 事宜积极进取",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据当前时间起小六壬课。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【小六壬】\n起课数：3\n宫位：速喜\n方位：南方\n五行：火\n吉凶：吉\n断语：速喜居南方属火 主有喜事速至 财禄速至 谋事可成 大安留连速喜赤口小吉空亡",
  "timestamp": "2026-03-13T12:00:00.000000"
}

大六壬排盘（天地盘+四课三传+十二天将+断语）。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【大六壬】\n天地盘：戌将加未时\n四课：申亥寅巳\n三传：初传巳 中传寅 末传亥\n十二天将：贵人 腾蛇 朱雀 六合 勾陈 青龙 天空 白虎 太常 玄武 太阴 天后\n断语：贵人临身 谋事可成 大安留连速喜赤口小吉空亡",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【指纹占卜】\n斗(螺)数量：5\n箕(簿)数量：5\n纹路分析：五斗五箕 平衡之相\n性格：性情温和 待人诚恳 富有同理心\n运势：中年得志 晚年安康",
  "timestamp": "2026-03-13T12:00:00.000000"
}

分别输入五指的斗/簿类型，获取每根手指的详细解读。

返回结果示例：

{
  "status": "ok",
  "result": "【指纹五指详解】\n拇指：斗 - 主意志坚定 领导力强\n食指：斗 - 主上进心强 事业有成\n中指：斗 - 主责任心重 家庭观念强\n无名指：斗 - 主艺术天赋 桃花较旺\n小指：斗 - 主口才出众 商业头脑",
  "timestamp": "2026-03-13T12:00:00.000000"
}

今日随机占卜。

请求参数：无

返回结果示例：

{
  "status": "ok",
  "result": "【每日一占】\n日期：2026-03-13\n卦象：地天泰（坤宫）\n吉凶：吉\n宜：祭祀 祈福 出行 立券\n忌：动土 安葬\n断语：天地交泰 万象更新 宜守正道 事宜可行",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【姓名配对】\n姓名1：张三\n姓名2：李四\n配对指数：85分\n缘分分析：天生一对 性情相投 默契十足\n建议：相互包容 珍惜缘分",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【生日配对】\n甲方：5月20日\n乙方：8月15日\n配对指数：78分\n缘分分析：性格互补 但需磨合\n建议：多沟通 增进了解",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【生肖配对】\n甲方：龙（1988年）\n乙方：鸡（1993年）\n配对指数：92分\n缘分分析：辰酉六合 天作之合\n建议：珍惜良缘 相互扶持",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【血型配对】\n血型1：A\n血型2：O\n配对指数：88分\n缘分分析：A与O型互补 相处融洽\n建议：A型多表达 O型多倾听",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【数字配对】\n号码1：12345678\n号码2：87654321\n类型：QQ\n配对指数：73分\n缘分分析：数字相合度一般 需努力\n建议：多交流 加深感情",
  "timestamp": "2026-03-13T12:00:00.000000"
}

康熙笔画 + 81数理 + 五格分析。

请求参数 (JSON Body)：

返回结果示例：

{
  "status": "ok",
  "result": "【姓名打分】\n姓名：张伟\n康熙笔画：张(11) 伟(11)\n天格：12（木）凶\n人格：22（木）凶\n地格：12（木）凶\n外格：2（木）大凶\n总格：22（木）凶\n三才配置：木木木\n综合评分：62分",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回结果示例：

{
  "status": "ok",
  "result": "【公司名打分】\n公司名：华为技术有限公司\n康熙笔画：华(14) 为(12) 技(8) 术(11) 有(6) 限(9) 公(4) 司(5)\n天格：15（土）吉\n人格：27（金）凶\n地格：19（水）凶\n外格：38（金）吉\n总格：69（水）凶\n三才配置：土金水\n综合评分：75分",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据八字五行 + 五格吉凶 + 三才配置自动推荐吉名。

返回结果示例：

{
  "status": "ok",
  "result": "【在线起名】\n姓氏：张\n性别：男\n五行喜用：金 水\n推荐名字：\n1. 张睿哲（天格12 人格25 地格24 外格11 总格35 三才木土火 评分95）\n2. 张铭轩（天格12 人格23 地格24 外格13 总格35 评分92）\n3. 张子涵（天格12 人格15 地格20 外格17 总格32 评分90）",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生年、性别、坐向和房间方位进行八宅风水分析，判断各方位吉凶。

返回结果示例：

{
  "status": "ok",
  "result": "【阳宅风水·八宅分析】\n出生年：1990 性别：男\n命卦：坤卦（西四命）\n坐向：坐北向南\n\n东四命吉方：北、东、东南、南\n西四命吉方：西北、西南、东北、西\n\n各方位吉凶：\n大门（南）：绝命方 - 凶\n东方：祸害方 - 凶\n东南：绝命方 - 凶\n南方：绝命方 - 凶\n西南：天医方 - 吉\n西方：延年方 - 吉\n西北：生气方 - 大吉\n北方：五鬼方 - 凶\n东北：伏位方 - 中吉\n\n建议：大门开在绝命方不吉，宜调整或以五行化煞；卧室宜选天医、延年、生气方。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据坐山、来龙、山势、水法、明堂等参数进行阴宅风水分析。

返回结果示例：

{
  "status": "ok",
  "result": "【阴宅风水分析】\n坐山：子 来龙：亥 龙脉质量：平缓\n四势：青龙(左)适中 白虎(右)适中 玄武(靠山)适中 朱雀(案山)有(平缓)\n水法：左来右去 出水口：未知\n明堂：适中 地势：丘陵 植被：一般\n\n综合评价：龙脉平缓，四势均衡，明堂聚气，整体格局中吉。\n水法左来右去主进财，宜察看出水口是否合局；植被一般宜补种以固龙气。\n建议：明堂适中可藏风聚气，宜择吉日安葬，注意白虎方不可高过青龙方。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据出生信息和八方位状态进行户型缺角凸角分析，每个方位可为 "正常"/"缺角"/"凸角"。

返回结果示例：

{
  "status": "ok",
  "result": "【户型缺角凸角分析】\n出生：1990年1月1日 12时 男\n\n方位状态：\n正东方：正常\n东南方：缺角\n正南方：正常\n西南方：凸角\n正西方：正常\n西北方：缺角\n正北方：正常\n东北方：正常\n\n缺角影响：东南（巽宫）主长女、文昌，缺角不利学业财运；西北（乾宫）主男主人、事业，缺角不利事业健康。\n凸角影响：西南（坤宫）主女主人、脾胃，凸角过旺易致女主人强势。\n化解建议：东南缺角宜摆放绿色植物或文昌塔；西北缺角宜放置金属饰品或泰山石。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据年份排玄空飞星九宫图。

返回结果示例：

{
  "status": "ok",
  "result": "【玄空飞星·运盘】\n年份：2026 元运：九运\n\n九宫飞星盘（九紫入中顺飞）：\n  四  九  二\n  三  五  七\n  八  一  六\n\n说明：九运当令星为九紫星入中宫，一白、二黑为未来生气之星。\n流年2026年九紫入中，主管丁财贵之三般卦可据此推算。\n中宫九紫主喜庆姻缘，东南四绿文昌主学业，北方一白主事业桃花。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

支持元运、山向、用替、排龙诀、水口、流年流月、命盘等详细参数的玄空飞星排盘。

返回结果示例：

{
  "status": "ok",
  "result": "【玄空飞星·详细排盘】\n年份：2026 元运：九运\n山向：子山午向 用替：否 排龙诀：否\n水口：子 排命盘：否 流年：2026 流月：（空）\n命盘：1990年 男\n\n运盘（九紫入中顺飞）：\n  四  九  二\n  三  五  七\n  八  一  六\n\n山星盘（子山入中）：\n  4  9  2\n  3  5  7\n  8  1  6\n\n向星盘（午向入中）：\n  6  1  8\n  7  5  3\n  2  9  4\n\n飞星组合解读：\n中宫 5/5 - 二黑五黄同宫，主疾病灾厄，宜化解。\n乾宫 6/2 - 武曲遇巨门，主肝病、被劫。\n巽宫 4/6 - 文曲遇武曲，金木相克，主肺疾、口舌。\n建议：中宫宜用铜葫芦化二黑五黄，乾宫宜金水化解。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

返回全部风水煞摘要列表（公开接口，不消耗额度）。

无需参数，直接 GET 请求即可。

返回结果示例：

{
  "categories": [
    {"key": "xingsha", "label": "形煞"},
    {"key": "qisha", "label": "气煞"}
  ],
  "total": 56,
  "items": [
    {"id": "tianzan", "name": "天斩煞", "alias": "", "category": "xingsha", "danger": 3, "danger_label": "大凶", "brief": "两楼之间缝隙直冲住宅…"},
    {"id": "luchong", "name": "路冲煞", "alias": "", "category": "xingsha", "danger": 3, "danger_label": "大凶", "brief": "道路直冲大门，主意外破财…"}
  ]
}

返回指定煞气的完整详情（公开接口，不含化解方法）。

返回结果示例：

{
  "id": "tianzan",
  "name": "天斩煞",
  "alias": "剪刀煞",
  "category": "xingsha",
  "category_label": "形煞",
  "danger": 3,
  "danger_label": "大凶",
  "desc": "两楼之间的狭窄缝隙正对住宅门窗，形如刀斩，主血光之灾…",
  "precautions": ["勿在正对缝隙处开窗", "勿将床位朝向缝隙方向"],
  "harm": "主家中成员易有血光之灾、手术意外",
  "suggestion": "可在窗外悬挂凸面镜或山海镇以化解",
  "fortune": {"财运": "大凶", "健康": "凶", "人际": "中"},
  "life_advice": "建议尽快采取化解措施，以免煞气积累影响家人健康"
}

返回全部风水煞化解方法。仅 SVIP 会员可查看，非 SVIP 返回空对象 {}。

无需参数，需要有效 session（SVIP 级别）。

返回结果示例：

{
  "tianzan": [
    "在正对缝隙的门窗外悬挂凸面镜（山海镇）",
    "在窗台摆放盆栽遮挡，植物宜选圆叶厚叶品种",
    "用厚重窗帘遮挡正对缝隙的窗户"
  ],
  "luchong": [
    "大门悬挂八卦镜或麒麟踩八卦",
    "门口种植绿植（宜圆叶）以阻挡煞气"
  ]
}

根据三支香的燃烧形态（高/中/低），结合问事内容进行观香解读。

返回结果示例：

{
  "status": "ok",
  "result": "【观香解读】\n三香状态：左(高) 中(中) 右(低)\n问事：事业\n\n香谱判定：左高右低，主先难后易，事情起初受阻，后渐入佳境。\n中香平稳，主事主心诚，神明有应。\n\n解读：当前事业有阻滞，贵人尚未到位，需耐心等待。约半月后转机出现，宜把握东方机遇。\n宜：诚信待人，广结善缘\n忌：急躁冒进，三心二意",
  "timestamp": "2026-03-13T12:00:00.000000"
}

根据香的八种物理特征进行综合观香解读。

返回结果示例：

{
  "status": "ok",
  "result": "【把香观香·八象综合解读】\n八象：\n火焰：明亮 - 朱雀象主文书喜讯\n弯曲：向内 - 青龙象主贵人相助\n立香：端正 - 玄武象主根基稳固\n元宝：成形 - 财库丰盈\n黑白：白多 - 阳气旺盛主吉\n速度：正常 - 顺遂之象\n烟雾：上直 - 神明降临之兆\n落灰：向前 - 事主有求必应\n\n问事：财运\n综合：八象七吉一平，朱雀主文书，青龙主贵人，玄武主稳固，整体大吉。\n近期有贵人提携，财运上扬，宜主动出击把握机会。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

上传正面面部照片，使用 MediaPipe 面部468点分析三停/面型/五官。

cURL 示例：

curl -X POST http://localhost:8000/api/v1/face_reading \
  -H "X-User-ID: demo" \
  -H "X-API-Key: demo123" \
  -F "file=@face.jpg"

依赖：mediapipe、opencv-python

返回结果示例：

{
  "status": "ok",
  "result": "【面相分析】\n三停：上停饱满（早年运佳）中停匀称（中年平稳）下停方圆（晚年有福）\n面型：甲字面（思维敏捷，早年得志）\n\n五官：\n眉：浓淡适宜，兄弟宫平满主手足和睦\n眼：黑白分明，有神主智慧决断\n鼻：鼻梁挺直鼻头丰隆，财帛宫丰主财运亨通\n口：唇红齿白，出纳官正主衣食无忧\n耳：耳大有垂，采听官厚主福气寿元\n\n十二宫：命宫平满明润主运势顺遂；财帛宫丰隆主进财；官禄宫饱满主事业有成；迁移宫平满主外出得利。\n\n综合：福相，事业财运俱佳，宜把握中年运势。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

上传面部照片，自动检测面型并返回8个关键点坐标（头顶/下巴/左右额/左右颧/左右颌）。前端支持拖拽关键点进行微调，面型会使用13种面型分类算法实时重新计算。

返回字段：

前端交互：

检测后8个关键点会可视化在照片上，用户可以拖拽关键点微调位置，面型和比例参数将使用客户端13种面型分类算法实时重新计算。

返回结果示例：

{
  "status": "ok",
  "result": "【面相检测】\n检测面型：甲字面（置信度 92.5%）\n第二候选：申字面（置信度 5.8%）\n\n8个关键点（归一化坐标）：\n头顶(0.50, 0.08) 下巴(0.50, 0.95)\n左额(0.35, 0.22) 右额(0.65, 0.22)\n左颧(0.32, 0.52) 右颧(0.68, 0.52)\n左颌(0.37, 0.78) 右颌(0.63, 0.78)\n\n比例参数：高宽比 1.42 额颧比 0.82 颧颌比 0.88 颌额比 0.95\n肤色置信度：88.3% 面部对称度：95.1%\n\n特征：额头饱满宽阔，下颌线条流畅，整体呈上宽下窄的甲字面型，主思维敏捷、早年得志。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

上传手掌照片（掌心展开、光线充足），使用 OpenCV 边缘检测分析四大掌纹+掌型。

cURL 示例：

curl -X POST http://localhost:8000/api/v1/palm_reading \
  -H "X-User-ID: demo" \
  -H "X-API-Key: demo123" \
  -F "file=@palm.jpg"

返回结果示例：

{
  "status": "ok",
  "result": "【手相分析】\n掌型：火形手（掌长指短，性格热情冲动）\n\n三大主线：\n生命线：深长清晰，起于食指拇指间，弧度圆润，主精力充沛健康长寿。\n智慧线：平直止于无名指下，主思维实际、行事果断，善于经商理财。\n感情线：止于食指下，主感情专一、重情重义，婚姻美满。\n\n五大丘：木星丘饱满主有领导力；金星丘丰隆主感情丰富；水星丘隆起主商业头脑；太阳丘平满主才艺；火星丘适中主勇气。\n\n手指：食指长于无名指主自信强势；中指最长主责任感强；拇指厚实主意志坚定。\n\n综合：火形手配务实智慧线，适合创业经商，中年财运旺盛，感情美满。",
  "timestamp": "2026-03-13T12:00:00.000000"
}

上传手掌照片，自动检测手型并返回五型评分。前端支持手动绘制掌纹（生命线/智慧线/感情线），可选择线条类型、撤销、清除。

返回字段：

前端交互：

上传照片后自动显示掌纹绘制画布，用户可选择生命线(蓝)、智慧线(绿)、感情线(红)在手掌上绘制，支持撤销和清除操作。

返回结果示例：

{
  "status": "ok",
  "result": "【手相检测】\n检测手型：木形手（五行属木）置信度：89.2%\n第二候选：水形手 置信度：7.5%\n\n五型评分：\n金形手：12.3\n木形手：89.2\n水形手：7.5\n火形手：4.1\n土形手：3.8\n\n手掌参数：\n长宽比 1.35 皮肤比 0.62 边缘密度 0.48 亮度 142 色彩方差 0.21\n\n特征：掌长指长，指节分明，皮肤细腻，符合木形手特征，主思维细腻、感情丰富、宜文职艺术。",
  "timestamp": "2026-03-13T12:00:00.000000"
}