{ "缘分合盘接口规范": { "接口名称": "缘分合盘测算", "接口路径": "/api/affinity/calculate", "请求方法": "POST", "入参 (Request)": { "relationship": { "type": "string", "required": true, "description": "缘分类型", "enum": [ "couple", "married", "crush", "partner", "friend", "family" ], "enum_labels": { "couple": "情侣", "married": "夫妻", "crush": "暗恋", "partner": "合伙", "friend": "知己", "family": "亲缘" } }, "person1": { "type": "object", "required": true, "description": "甲方信息（君）", "properties": { "name": { "type": "string", "required": true, "description": "姓名", "example": "张三" }, "gender": { "type": "string", "required": true, "description": "性别", "enum": [ "male", "female" ], "enum_labels": { "male": "郎君", "female": "佳人" } }, "birthDate": { "type": "string", "required": true, "description": "生辰八字（显示格式）", "example": "1990年1月1日 子时" }, "birthDateApi": { "type": "string", "required": true, "description": "生辰八字（API格式）", "format": "YYYY-MM-DD HH:mm:ss", "example": "1990-01-01 00:30:00" } } }, "person2": { "type": "object", "required": true, "description": "乙方信息（卿）", "properties": { "name": { "type": "string", "required": true, "description": "姓名", "example": "李四" }, "gender": { "type": "string", "required": true, "description": "性别", "enum": [ "male", "female" ], "enum_labels": { "male": "郎君", "female": "佳人" } }, "birthDate": { "type": "string", "required": true, "description": "生辰八字（显示格式）", "example": "1992年3月15日 午时" }, "birthDateApi": { "type": "string", "required": true, "description": "生辰八字（API格式）", "format": "YYYY-MM-DD HH:mm:ss", "example": "1992-03-15 12:30:00" } } } }, "入参示例": { "relationship": "couple", "person1": { "name": "张三", "gender": "male", "birthDate": "1990年1月1日 子时", "birthDateApi": "1990-01-01 00:30:00" }, "person2": { "name": "李四", "gender": "female", "birthDate": "1992年3月15日 午时", "birthDateApi": "1992-03-15 12:30:00" } }, "出参 (Response)": { "code": { "type": "number", "description": "状态码，200表示成功" }, "msg": { "type": "string", "description": "返回消息" }, "data": { "type": "object", "description": "缘分合盘结果数据", "properties": { "relationship": { "type": "string", "description": "缘分类型", "example": "couple" }, "relationshipLabel": { "type": "string", "description": "缘分类型标签", "example": "情侣" }, "person1": { "type": "object", "description": "甲方信息", "properties": { "name": "string", "gender": "string", "birthDate": "string" } }, "person2": { "type": "object", "description": "乙方信息", "properties": { "name": "string", "gender": "string", "birthDate": "string" } }, "score": { "type": "number", "description": "默契指数总分", "example": 88, "range": "0-100" }, "scoreBadge": { "type": "string", "description": "婚配等级", "example": "上上婚", "enum": [ "上上婚", "上等婚", "中等婚", "下等婚" ] }, "sixDimension": { "type": "object", "description": "六维契合度评分", "properties": { "emotional": { "type": "number", "description": "情感共鸣", "example": 92, "range": "0-100" }, "communication": { "type": "number", "description": "沟通模式", "example": 78, "range": "0-100" }, "trust": { "type": "number", "description": "信任安全", "example": 95, "range": "0-100" }, "values": { "type": "number", "description": "价值观", "example": 85, "range": "0-100" }, "compatibility": { "type": "number", "description": "互补性", "example": 88, "range": "0-100" }, "luck": { "type": "number", "description": "互旺运势", "example": 88, "range": "0-100" } } }, "radarDesc": { "type": "string", "description": "六维雷达图描述", "example": "双方在信任与情感维度表现卓越，虽在沟通方式上略有差异，但互补性极强。" }, "analysisCards": { "type": "array", "description": "分析卡片列表", "items": { "type": "object", "properties": { "id": { "type": "string", "description": "卡片ID", "example": "emotional" }, "icon": { "type": "string", "description": "图标emoji", "example": "💗" }, "iconBg": { "type": "string", "description": "图标背景色", "example": "rgba(236, 72, 153, 0.2)" }, "title": { "type": "string", "description": "标题", "example": "情感共鸣" }, "score": { "type": "string", "description": "评分", "example": "92" }, "summary": { "type": "string", "description": "摘要（折叠时显示）", "example": "两人的情感连接深厚，前世羁绊颇深。在相处中，往往能心领神会，无需多言。" }, "content": { "type": "string", "description": "详细内容（展开时显示）", "example": "从八字命盘来看，男方日元为甲木，女方日元为己土，甲己相合，为中正之合..." } } } }, "unlocked": { "type": "object", "description": "解锁后的深度内容", "properties": { "pastLife": { "type": "object", "description": "前世羁绊", "properties": { "description": { "type": "string", "description": "前世关系描述", "example": "根据三世书推演，你们二人前世曾是同门师兄妹..." }, "depth": { "type": "string", "description": "缘分深浅", "example": "三生石上旧精魂" }, "relationship": { "type": "string", "description": "还债关系", "example": "互不相欠 · 共同成长" } } }, "matchItems": { "type": "array", "description": "正缘特征验证", "items": { "type": "object", "properties": { "label": { "type": "string", "description": "验证项", "example": "外貌特征" }, "match": { "type": "number", "description": "契合度百分比", "example": 90, "range": "0-100" }, "desc": { "type": "string", "description": "描述", "example": "命中注定伴侣多为身材高大、眉眼深邃之人，与对方特征高度吻合。" } } } }, "guide": { "type": "object", "description": "潜意识与相处指南", "properties": { "realNeeds": { "type": "string", "description": "TA的真实需求", "example": "表面上TA看起来很独立、无所谓，其实内心极度渴望被坚定地选择..." }, "redZone": { "type": "string", "description": "绝对雷区", "example": "千万不要在公开场合质疑TA的决定，或者拿TA与前任/别人做比较..." }, "tips": { "type": "array", "description": "如何拿捏TA", "items": { "type": "string" }, "example": [ "适当示弱：TA有很强的保护欲，你的偶尔依赖会让TA成就感爆棚。", "制造反差：在平淡生活中突然制造一个小惊喜，能让TA记很久。" ] } } }, "monthlyFortune": { "type": "object", "description": "未来12个月感情运势", "properties": { "heats": { "type": "array", "description": "12个月的热度值（0-3）", "items": { "type": "number" }, "example": [ 1, 2, 3, 3, 2, 1, 0, 1, 2, 3, 3, 2 ] }, "heatLabels": { "type": "array", "description": "热度标签", "items": { "type": "string" }, "example": [ "平", "吉", "大吉", "如意" ] }, "highlights": { "type": "string", "description": "高光时刻提示", "example": "3月、4月、10月是感情升温的最佳窗口期。" }, "warnings": { "type": "string", "description": "预警时刻提示", "example": "7月需防范外界诱惑或误会。" } } }, "timeline": { "type": "array", "description": "未来十年关键节点", "items": { "type": "object", "properties": { "year": { "type": "string", "description": "年份", "example": "2025" }, "title": { "type": "string", "description": "阶段标题", "example": "升温期" }, "desc": { "type": "string", "description": "描述", "example": "感情运势大吉，适合谈婚论嫁或共同置业。" }, "highlight": { "type": "boolean", "description": "是否高亮显示", "example": true } } } }, "masterAdvice": { "type": "object", "description": "大师寄语与化解之道", "properties": { "message": { "type": "string", "description": "寄语", "example": "虽然你们是上上婚配，但仍需注意农历五月和十一月，这两个月份情绪易波动。" }, "tips": { "type": "array", "description": "开运建议", "items": { "type": "string" }, "example": [ "家中东南方摆放一对木质鸳鸯摆件，可增进感情。", "多佩戴红色或紫色饰品，以火生土，旺运旺财。" ] } } } } }, "isUnlocked": { "type": "boolean", "description": "是否已解锁深度报告", "example": false }, "unlockPrice": { "type": "number", "description": "解锁价格（元）", "example": 9.9 }, "unlockStats": { "type": "object", "description": "解锁统计信息", "properties": { "unlockCount": { "type": "number", "description": "已解锁人数", "example": 12392 }, "accuracy": { "type": "string", "description": "准确率", "example": "98%" } } } } } }, "出参示例": { "code": 200, "msg": "测算成功", "data": { "relationship": "couple", "relationshipLabel": "情侣", "person1": { "name": "张三", "gender": "male", "birthDate": "1990年1月1日 子时" }, "person2": { "name": "李四", "gender": "female", "birthDate": "1992年3月15日 午时" }, "score": 88, "scoreBadge": "上上婚", "sixDimension": { "emotional": 92, "communication": 78, "trust": 95, "values": 85, "compatibility": 88, "luck": 88 }, "radarDesc": "双方在信任与情感维度表现卓越，虽在沟通方式上略有差异，但互补性极强。", "analysisCards": [ { "id": "emotional", "icon": "💗", "iconBg": "rgba(236, 72, 153, 0.2)", "title": "情感共鸣", "score": "92", "summary": "两人的情感连接深厚，前世羁绊颇深。在相处中，往往能心领神会，无需多言。", "content": "从八字命盘来看，男方日元为甲木，女方日元为己土，甲己相合，为中正之合。这意味着你们在精神层面有着极高的共鸣度。\n\n前世羁绊：\n你们的缘分并非始于今生。星盘显示，你们在前世可能是一对共同经历过患难的知己。这种深刻的灵魂印记，让你们在今生初见时就有一种莫名的熟悉感。\n\n情感模式：\n你们的相处模式属于"润物细无声"的类型。虽然没有轰轰烈烈的开场，但随着时间的推移，感情会像陈年老酒一样越发醇厚。" }, { "id": "communication", "icon": "💬", "iconBg": "rgba(59, 130, 246, 0.2)", "title": "沟通模式", "score": "78", "summary": "沟通上存在"一动一静"的格局。建议多换位思考，避免因表达节奏不同产生误解。", "content": "你们的沟通宫位呈现出互补但偶尔摩擦的状态。\n\n思维差异：\n男方偏向于逻辑思维，遇到问题倾向于直接寻找解决方案；女方则更偏向于感受思维，更看重解决问题过程中的情绪价值。\n\n建议：\n1. 设立"冷静角"：当发生争执时，不要急于说服对方，先各自冷静15分钟。\n2. 倾听练习：每周抽出半小时，只倾听对方这一周的喜怒哀乐，不作评判，只给拥抱。" }, { "id": "trust", "icon": "🛡️", "iconBg": "rgba(34, 197, 94, 0.2)", "title": "安全感与信任", "score": "95", "summary": "这是这段关系最坚固的基石。双方都极具责任感，能给予对方无条件的支持。", "content": "信任宫位有吉星高照，显示出极其稳固的信任基础。\n\n忠诚度分析：\n双方命盘中均无明显的烂桃花干扰。男方责任感重，视家庭为奋斗的动力；女方心思细腻，能将家庭打理得井井有条。\n\n加分项：\n在财务管理上，你们有着惊人的一致性。这种在金钱观上的契合，大大减少了现实生活中的摩擦。" }, { "id": "luck", "icon": "⚡", "iconBg": "rgba(234, 179, 8, 0.2)", "title": "互相旺运", "score": "88", "summary": "五行互补，结合后尤其对男方的事业运有显著提升，女方财运亦会水涨船高。", "content": "你们是典型的"互旺"组合。\n\n五行分析：\n男方喜火，女方八字火旺，这就像是在寒冷的冬日里送来了一盆炭火，能极大地激发男方的潜能。\n\n财运影响：\n女方自带"聚宝盆"属性，能守住男方打拼来的财富。二人的结合实现了"开源节流"的最佳配置。" } ], "unlocked": { "pastLife": { "description": "根据三世书推演，你们二人前世曾是同门师兄妹。彼时情深缘浅，因世俗礼教未能终成眷属，留下了深刻的遗憾。这份未了的情缘穿越轮回，在今生化作了你们初见时的"一见如故"。", "depth": "三生石上旧精魂", "relationship": "互不相欠 · 共同成长" }, "matchItems": [ { "label": "外貌特征", "match": 90, "desc": "命中注定伴侣多为身材高大、眉眼深邃之人，与对方特征高度吻合。" }, { "label": "性格互补", "match": 85, "desc": "您喜静，对方喜动，正符合"一阴一阳谓之道"的最佳互补模型。" }, { "label": "出现时机", "match": 95, "desc": "红鸾星动之年相遇，是天作之合的典型征兆。" } ], "guide": { "realNeeds": "表面上TA看起来很独立、无所谓，其实内心极度渴望被坚定地选择。TA最怕的不是争吵，而是冷暴力和被忽略。", "redZone": "千万不要在公开场合质疑TA的决定，或者拿TA与前任/别人做比较。这会瞬间触犯TA的自尊底线。", "tips": [ "适当示弱：TA有很强的保护欲，你的偶尔依赖会让TA成就感爆棚。", "制造反差：在平淡生活中突然制造一个小惊喜，能让TA记很久。" ] }, "monthlyFortune": { "heats": [ 1, 2, 3, 3, 2, 1, 0, 1, 2, 3, 3, 2 ], "heatLabels": [ "平", "吉", "大吉", "如意" ], "highlights": "3月、4月、10月是感情升温的最佳窗口期。", "warnings": "7月需防范外界诱惑或误会。" }, "timeline": [ { "year": "2024", "title": "磨合期", "desc": "需注意口舌之争，多包容对方的小缺点。", "highlight": false }, { "year": "2025", "title": "升温期", "desc": "感情运势大吉，适合谈婚论嫁或共同置业。", "highlight": true }, { "year": "2027", "title": "子女缘", "desc": "添丁进口之喜，家庭运势达到顶峰。", "highlight": false }, { "year": "2030", "title": "稳定期", "desc": "事业有成，二人重心回归家庭，享受生活。", "highlight": false } ], "masterAdvice": { "message": "虽然你们是上上婚配，但仍需注意农历五月和十一月，这两个月份情绪易波动。", "tips": [ "家中东南方摆放一对木质鸳鸯摆件，可增进感情。", "多佩戴红色或紫色饰品，以火生土，旺运旺财。" ] } }, "isUnlocked": false, "unlockPrice": 9.9, "unlockStats": { "unlockCount": 12392, "accuracy": "98%" } } } } }