Spaces:
Running
Running
"""
知识库增强型AI解读引擎 v4.0
Knowledge-Enhanced AI Interpretation Engine
基于今日建成的紫微斗数知识库（772KB，5大核心模块）
Powered by comprehensive Ziwei Doushu knowledge base (772KB, 5 core modules)
v4.0 新增功能:
- 巴纳姆冷读效果：温暖有共鸣的解读语言
- 六亲分析：父母/兄弟/夫妻/子女运批断
- 10步批命流程：标准化解读流程
- 福德宫核心秘诀：夫妻死别判断
知识库路径:
- 主星特性: /agent-knowledge/mingli-knowledge/eastern/ziwei/foundations/01-main-stars.md
- 十二宫位: /agent-knowledge/mingli-knowledge/eastern/ziwei/foundations/02-twelve-palaces.md
- 四化理论: /agent-knowledge/mingli-knowledge/eastern/ziwei/foundations/03-four-transformations.md
- 流年大运: /agent-knowledge/mingli-knowledge/eastern/ziwei/timing/01-annual-fortune.md
- 实战断诀: /agent-knowledge/mingli-knowledge/eastern/ziwei/interpretations/01-practical-divination.md
- 批命方法论: /agent-knowledge/mingli-knowledge/eastern/ziwei/interpretations/00-reading-methodology.md
- 六亲批断: /agent-knowledge/mingli-knowledge/eastern/ziwei/interpretations/00-six-relations.md
Created: 2025-12-12
Updated: 2026-02-03 (v4.0 巴纳姆+六亲+批命流程)
Author: Sisi 🦊 (紫微知识库管理员 + AI引擎架构师)
"""
from typing import Dict, List, Any, Optional
from sihua_data import PALACE_ENGLISH
from palace_strength import calculate_all_palaces_strength, calculate_palace_strength
from star_brightness_table import enhance_star_with_brightness, get_palace_brightness_summary
from san_fang_si_zheng_analyzer import analyze_san_fang_si_zheng, analyze_all_san_fang_si_zheng
from geju_matcher import GejuMatcher, MATCHER_VERSION
from star_combination_matcher import StarCombinationMatcher # v3.8: 星曜组合断语引擎
# v4.0 新增模块 - 使用延迟导入减少启动内存占用
# from barnum_cold_reader import BarnumColdReader, get_barnum_reader
# from methodology_loader import MethodologyLoader, get_methodology_loader
# from six_relations_interpreter import SixRelationsInterpreter, get_six_relations_interpreter
# from reading_methodology import ReadingMethodologyEngine, get_reading_engine
class KnowledgeEnhancedInterpreter:
"""知识库增强型AI解读器 - 基于772KB专业知识库 + v4.0巴纳姆效果"""
def __init__(self):
"""初始化增强型解读器"""
# v3.7: 初始化格局匹配器
self.geju_matcher = GejuMatcher()
# v3.8: 初始化星曜组合断语匹配器
self.star_combination_matcher = StarCombinationMatcher()
# v4.0 新增: 延迟初始化（减少启动内存占用）
self._barnum_reader = None
self._methodology_loader = None
self._six_relations_interpreter = None
self._reading_engine = None
# 初始化知识库数据（修复：调用被遗忘的初始化方法）
self.__init_v4_modules()
def __init_v4_modules(self):
"""v4.0: 初始化模块数据"""
# 十天干四化表（THE CORE！）- 从知识库提取
self.TIANGAN_SIHUA = {
'甲': {'禄': '廉贞', '权': '破军', '科': '武曲', '忌': '太阳'},
'乙': {'禄': '天机', '权': '天梁', '科': '紫微', '忌': '太阴'},
'丙': {'禄': '天同', '权': '天机', '科': '文昌', '忌': '廉贞'},
'丁': {'禄': '太阴', '权': '天同', '科': '天机', '忌': '巨门'},
'戊': {'禄': '贪狼', '权': '太阴', '科': '右弼', '忌': '天机'},
'己': {'禄': '武曲', '权': '贪狼', '科': '天梁', '忌': '文曲'},
'庚': {'禄': '太阳', '权': '武曲', '科': '天府', '忌': '天同'},
'辛': {'禄': '巨门', '权': '太阳', '科': '文曲', '忌': '文昌'},
'壬': {'禄': '天梁', '权': '紫微', '科': '左辅', '忌': '武曲'},
'癸': {'禄': '破军', '权': '巨门', '科': '太阴', '忌': '贪狼'}
}
# 主星基本特性（从01-main-stars.md提取）
self.MAIN_STAR_TRAITS = {
'紫微': {
'五行': '己阴土',
'化气': '尊贵',
'特质': '帝王星，领导力强，尊贵有气度',
'事业': '适合管理、政治、高层领导',
'性格': '自尊心强，喜欢掌权，有责任感'
},
'天机': {
'五行': '乙阴木',
'化气': '善',
'特质': '智慧星，机智聪明，善于策划',
'事业': '适合教育、咨询、策划、技术',
'性格': '心思细腻，反应快，喜欢思考'
},
'太阳': {
'五行': '丙阳火',
'化气': '贵',
'特质': '光明星，热情大方，爱面子',
'事业': '适合外交、公关、管理、服务业',
'性格': '热情开朗，重视名声，乐于助人'
},
'武曲': {
'五行': '辛阴金',
'化气': '财',
'特质': '财星，刚毅果断，理财能力强',
'事业': '适合金融、财务、工程、武职',
'性格': '务实稳重，意志坚定，重视物质'
},
'天同': {
'五行': '壬阳水',
'化气': '福',
'特质': '福星，温和慈善，享受生活',
'事业': '适合服务业、文艺、娱乐',
'性格': '随和乐观，不喜竞争，享受安逸'
},
'廉贞': {
'五行': '丁阴火',
'化气': '囚',
'特质': '次桃花星，灵活多变，善社交',
'事业': '适合公关、演艺、设计、外交',
'性格': '热情主动，交际广泛，感情丰富'
},
'天府': {
'五行': '戊阳土',
'化气': '令',
'特质': '财库星，保守稳健，善于积累',
'事业': '适合管理、财务、行政',
'性格': '谨慎务实，重视安全，善于守成'
},
'太阴': {
'五行': '癸阴水',
'化气': '富',
'特质': '财星，温柔细腻，重视内涵',
'事业': '适合教育、文化、艺术、服务',
'性格': '温和内敛，心思细密，重情重义'
},
'贪狼': {
'五行': '甲阳木',
'化气': '桃花',
'特质': '桃花星，多才多艺，欲望强烈',
'事业': '适合娱乐、销售、艺术、交际',
'性格': '积极进取，爱好广泛，社交能力强'
},
'巨门': {
'五行': '癸阴水',
'化气': '暗',
'特质': '是非星，口才好，易招口舌',
'事业': '适合法律、传媒、教师、咨询',
'性格': '善于表达，直言不讳，易得罪人'
},
'天相': {
'五行': '壬阳水',
'化气': '印',
'特质': '印星，忠诚可靠，协调能力强',
'事业': '适合行政、服务、辅助性工作',
'性格': '诚实守信，重视外表，善于调和'
},
'天梁': {
'五行': '戊阳土',
'化气': '荫',
'特质': '贵人星，清高正直，喜助人',
'事业': '适合医疗、慈善、教育、宗教',
'性格': '正直善良，喜欢助人，清高自持'
},
'七杀': {
'五行': '庚阳金',
'化气': '杀',
'特质': '将星，果断勇敢，独立性强',
'事业': '适合军警、竞争性行业、开创',
'性格': '刚毅果断，独来独往，不服输'
},
'破军': {
'五行': '癸阴水',
'化气': '耗',
'特质': '先锋星，开创变革，破旧立新，不畏艰难',
'事业': '适合军警、探险、改革、投机、开拓性行业',
'性格': '冲劲十足，不惧挑战，敢于推翻重来，喜新厌旧'
}
}
# 十二宫位核心意义（从02-twelve-palaces.md提取）
self.PALACE_MEANINGS = {
'命宫': {
'代表': '一生格局、性格特质、外在表现',
'三方四正': ['官禄宫', '财帛宫', '迁移宫'],
'重要性': '特别重要',
'判断要点': '命宫强弱决定一生成就高低'
},
'兄弟宫': {
'代表': '兄弟姐妹、同事关系、合伙运',
'三方四正': ['仆役宫', '疾厄宫', '田宅宫'],
'重要性': '较重要',
'判断要点': '看与兄弟朋友的缘分和帮助'
},
'夫妻宫': {
'代表': '配偶状况、婚姻关系、恋爱运',
'三方四正': ['福德宫', '官禄宫', '迁移宫'],
'重要性': '特别重要',
'判断要点': '配偶条件、婚姻幸福度'
},
'子女宫': {
'代表': '子女状况、生育能力、性生活',
'三方四正': ['田宅宫', '仆役宫', '疾厄宫'],
'重要性': '较重要',
'判断要点': '子女数量质量、性欲强弱'
},
'财帛宫': {
'代表': '财运状况、赚钱能力、理财观',
'三方四正': ['命宫', '福德宫', '官禄宫'],
'重要性': '特别重要',
'判断要点': '财运好坏、赚钱方式'
},
'疾厄宫': {
'代表': '身体健康、疾病倾向、体质',
'三方四正': ['兄弟宫', '田宅宫', '子女宫'],
'重要性': '重要',
'判断要点': '健康状况、易患疾病'
},
'迁移宫': {
'代表': '外出运、人际关系、社会评价',
'三方四正': ['命宫', '夫妻宫', '福德宫'],
'重要性': '特别重要',
'判断要点': '外出发展、社交能力、外部机遇'
},
'仆役宫': {
'代表': '朋友关系、下属状况、社交圈',
'三方四正': ['兄弟宫', '子女宫', '田宅宫'],
'重要性': '较重要',
'判断要点': '朋友质量、得到帮助'
},
'官禄宫': {
'代表': '事业成就、工作状况、社会地位',
'三方四正': ['命宫', '财帛宫', '夫妻宫'],
'重要性': '特别重要',
'判断要点': '事业发展、工作稳定性'
},
'田宅宫': {
'代表': '不动产、家庭环境、居住状况',
'三方四正': ['兄弟宫', '疾厄宫', '子女宫'],
'重要性': '重要',
'判断要点': '房产运、家庭和睦'
},
'福德宫': {
'代表': '精神享受、福气厚薄、兴趣爱好',
'三方四正': ['财帛宫', '夫妻宫', '迁移宫'],
'重要性': '特别重要',
'判断要点': '福气深浅、精神状态'
},
'父母宫': {
'代表': '父母状况、长辈关系、读书运',
'三方四正': ['官禄宫', '福德宫', '迁移宫'],
'重要性': '重要',
'判断要点': '父母缘分、学业成绩'
}
}
# 四化判断优先级（从03-four-transformations.md提取）
self.SIHUA_PRIORITY = {
'本命盘': 0.4, # 40% - 基础命格
'大限盘': 0.3, # 30% - 10年大势
'流年盘': 0.2, # 20% - 当年运势
'流月日': 0.1 # 10% - 短期波动
}
# v4.0: 延迟加载属性
@property
def barnum_reader(self):
"""延迟加载巴纳姆冷读引擎"""
if self._barnum_reader is None:
from barnum_cold_reader import get_barnum_reader
self._barnum_reader = get_barnum_reader()
return self._barnum_reader
@property
def methodology_loader(self):
"""延迟加载知识库加载器"""
if self._methodology_loader is None:
from methodology_loader import get_methodology_loader
self._methodology_loader = get_methodology_loader()
return self._methodology_loader
@property
def six_relations_interpreter(self):
"""延迟加载六亲解读器"""
if self._six_relations_interpreter is None:
from six_relations_interpreter import get_six_relations_interpreter
self._six_relations_interpreter = get_six_relations_interpreter()
return self._six_relations_interpreter
@property
def reading_engine(self):
"""延迟加载批命流程引擎"""
if self._reading_engine is None:
from reading_methodology import get_reading_engine
self._reading_engine = get_reading_engine()
return self._reading_engine
def interpret_full_chart_enhanced(
self,
sihua_analysis: dict,
chart_data: dict
) -> dict:
"""
增强版完整命盘解读 - 基于知识库
Args:
sihua_analysis: 四化分析结果
chart_data: 原始命盘数据
Returns:
dict: 增强版AI解读结果
"""
year_sihua = sihua_analysis.get('year_sihua', {})
overall_judgment = sihua_analysis.get('overall_judgment', {})
# 0. 提取宫位数据（用于后续分析）
palaces = chart_data.get('palaces', [])
# NEW: 计算所有宫位的强弱评分 (P0-2核心功能！)
palace_strength_analysis = calculate_all_palaces_strength(
palaces,
sihua_analysis
)
# NEW v3.6: 计算所有宫位的三方四正分析 (P1核心功能！)
san_fang_analysis = analyze_all_san_fang_si_zheng(
palaces,
sihua_analysis
)
# NEW v3.7: 格局识别（P1核心功能！）
# 获取出生年干（用于格局匹配）
birth_year_stem = (chart_data.get('year_stem')
or chart_data.get('chart', {}).get('year_heavenly_stem'))
# The Node adapter stores the clock in solar_date/birth_info, not a root hour field.
birth_time = (chart_data.get('birth_info', {}).get('time')
or chart_data.get('solar_date', '').split(' ')[-1])
try:
pattern_birth_hour = int(birth_time.split(':')[0]) if ':' in birth_time else None
if pattern_birth_hour is not None and not 0 <= pattern_birth_hour <= 23:
pattern_birth_hour = None
except (TypeError, ValueError):
pattern_birth_hour = None
# 匹配所有格局
matched_patterns = self.geju_matcher.match_all_patterns(
palaces,
birth_year_stem,
pattern_birth_hour
)
# 生成格局总结
pattern_summary = self.geju_matcher.get_pattern_summary(matched_patterns)
birth_hour = pattern_birth_hour
# NEW v3.8: 星曜组合断语匹配（P1完成！）
# v3.14.0升级：添加宏观格局分析（紫微孤君+日月反背+星系类型）
star_combination_result = self.star_combination_matcher.match_all_combinations(
palaces,
birth_hour # v3.14.0新增：传递出生时辰
)
# 1. 生成命盘核心特质（基于主星）
core_traits = self._analyze_core_traits(chart_data)
# 2. 生成宫位详细分析（融合知识库 + 宫位评分 + 三方四正）
palace_analysis = self._analyze_palaces_with_knowledge(
chart_data,
year_sihua,
palace_strength_analysis, # v3.5: 传入宫位评分
san_fang_analysis # v3.6: 传入三方四正分析
)
# 3. 生成四化深度解读（基于理论）
sihua_deep_analysis = self._analyze_sihua_with_theory(year_sihua)
# 4. 生成整体运势（知识库增强）
life_overview = self._generate_enhanced_life_overview(
overall_judgment,
core_traits
)
# 5. 生成实战建议（基于南北派断诀）
practical_advice = self._generate_practical_advice(
year_sihua,
chart_data,
core_traits
)
# 6. 生成优势与挑战（知识库版本）
strengths_challenges = self._analyze_strengths_challenges_enhanced(
year_sihua,
palace_analysis
)
# ========== v4.0 可选功能：巴纳姆增强 + 六亲分析 + 10步批命 ==========
# 使用静默失败模式，不影响核心功能
v4_features = {}
try:
# 延迟加载v4.0模块（减少启动内存占用）
if self._barnum_reader is None:
from barnum_cold_reader import get_barnum_reader
self._barnum_reader = get_barnum_reader()
if self._six_relations_interpreter is None:
from six_relations_interpreter import get_six_relations_interpreter
self._six_relations_interpreter = get_six_relations_interpreter()
if self._reading_engine is None:
from reading_methodology import get_reading_engine
self._reading_engine = get_reading_engine()
# 1. 六亲分析（基于86个批断技巧）
gender = chart_data.get('gender', '男')
six_relations_result = self._six_relations_interpreter.analyze_all_relations(
palaces,
sihua_analysis,
gender
)
v4_features['six_relations_analysis'] = six_relations_result
# 2. 10步批命流程（可选，较重）
# 用户可以通过API参数决定是否执行
if chart_data.get('enable_ten_step_reading', False):
ten_step_result = self._reading_engine.execute_ten_step_reading(chart_data)
v4_features['ten_step_reading'] = ten_step_result
# 3. 巴纳姆温暖描述（轻量级增强）
# 为palace_analysis添加巴纳姆增强版本
if hasattr(self, '_barnum_reader') and palace_analysis:
v4_features['barnum_enhanced_palaces'] = []
for palace in palace_analysis[:3]: # 仅增强前3个重要宫位（命宫/财帛/官禄）
palace_name = palace.get('palace_name', '')
interpretation = palace.get('interpretation', '')
if interpretation:
barnum_result = self._barnum_reader.apply_barnum_effect(
interpretation,
palace_name=palace_name
)
v4_features['barnum_enhanced_palaces'].append({
'palace_name': palace_name,
'original': interpretation,
'enhanced': barnum_result.get('enhanced', '')
})
except Exception as e:
# 静默失败，记录错误但不影响核心功能
v4_features['v4_error'] = f'v4.0 features partially failed: {str(e)}'
# ========== 返回结果（含v4.0可选功能） ==========
result = {
'core_traits': core_traits, # NEW: 命盘核心特质
'palace_analysis': palace_analysis, # NEW: 宫位详细分析（含强弱评分）
'palace_strength_summary': palace_strength_analysis['summary'], # NEW v3.5: 宫位强弱总结
'pattern_recognition': { # NEW v3.7: 格局识别 ⭐
'matcher_version': MATCHER_VERSION,
'calculation_mode': 'deterministic_rules',
'matched_patterns': matched_patterns, # 匹配到的所有格局
'pattern_summary': pattern_summary, # 格局总结
'pattern_count': len(matched_patterns), # 格局数量
'highest_score': pattern_summary.get('highest_score', 0), # 最高分格局
'overall_quality': pattern_summary.get('overall_quality', 'unknown') # 整体质量
},
'star_combinations': { # NEW v3.8: 星曜组合断语 ⭐⭐ | v3.14: 宏观格局分析 🌟
'matched_rules': star_combination_result['matched_rules'], # 匹配到的所有组合规则
'summary': star_combination_result['summary'], # 组合总结（含评分、分类统计）
'interpretations_by_category': star_combination_result['interpretations_by_category'], # 按分类整理的断语
'total_matched': star_combination_result['total_matched'], # 匹配数量
'total_rules_checked': star_combination_result['total_rules_checked'], # 检查的总规则数
'macro_patterns': star_combination_result.get('macro_patterns', {}) # v3.14.0新增：宏观格局分析
},
'sihua_deep_analysis': sihua_deep_analysis, # ENHANCED: 四化深度解读
'life_overview': life_overview, # ENHANCED: 整体运势
'practical_advice': practical_advice, # NEW: 实战建议
'strengths_challenges': strengths_challenges, # ENHANCED: 优势挑战
'interpretation_quality': 'knowledge_enhanced_v4.0_with_barnum_sixrelations', # 升级到v4.0
'knowledge_base_version': '2026-02-03', # 更新到v4.0发布日期
'knowledge_modules_used': [
'01-main-stars.md',
'02-twelve-palaces.md',
'03-four-transformations.md',
'01-practical-divination.md',
'star_brightness_table.py', # v3.5: 星曜庙旺陷表
'palace_strength.py', # v3.5: 宫位强弱评分系统
'san_fang_si_zheng_analyzer.py', # v3.6: 三方四正分析引擎
'geju_patterns.py', # v3.7: 格局规则库（15个经典格局）
'geju_matcher.py', # v3.7: 格局匹配引擎
'star_combination_rules.py', # v3.8: 星曜组合规则库（19条核心规则）
'star_combination_matcher.py', # v3.8: 星曜组合匹配引擎
# v4.0 新增模块
'barnum_cold_reader.py', # v4.0: 巴纳姆冷读引擎
'six_relations_interpreter.py', # v4.0: 六亲解读器（86个技巧）
'reading_methodology.py' # v4.0: 10步批命流程引擎
]
}
# 合并v4.0功能（如果存在）
if v4_features:
result['v4_features'] = v4_features
return result
def _analyze_core_traits(self, chart_data: dict) -> dict:
"""
分析命盘核心特质（基于主星知识库）
从 chart_data 中提取命宫主星，查 MAIN_STAR_TRAITS 字典生成分析
Returns:
dict: 核心特质分析
"""
# 从 palaces 中找到命宫
palaces = chart_data.get('palaces', [])
ming_palace_stars = []
ming_palace = None
for palace in palaces:
if palace.get('name') == '命宫':
ming_palace = palace
break
# 提取命宫主星名称
if ming_palace:
for star in ming_palace.get('major_stars', []):
star_name = star.get('name', '') if isinstance(star, dict) else star
if star_name:
ming_palace_stars.append(star_name)
# 从 MAIN_STAR_TRAITS 查询特质
personalities = []
careers = []
traits_detail = []
for star_name in ming_palace_stars:
star_traits = self.MAIN_STAR_TRAITS.get(star_name, {})
if star_traits:
personalities.append(star_traits.get('性格', ''))
careers.append(star_traits.get('事业', ''))
traits_detail.append({
'star': star_name,
'wuxing': star_traits.get('五行', ''),
'huaqi': star_traits.get('化气', ''),
'trait': star_traits.get('特质', ''),
'career': star_traits.get('事业', ''),
'personality': star_traits.get('性格', '')
})
# 组合输出
personality_summary = '、'.join(filter(None, personalities)) if personalities else '命宫无主星，性格受辅星和三方四正影响'
career_tendency = '、'.join(filter(None, careers)) if careers else '事业方向受三方四正主星影响'
# 判断格局等级
fortune_level = 'medium'
if len(ming_palace_stars) >= 2:
fortune_level = 'high' # 双星坐命格局较高
elif len(ming_palace_stars) == 0:
fortune_level = 'special' # 空宫需看三方四正借星
traits = {
'primary_stars': ming_palace_stars,
'personality_summary': personality_summary,
'career_tendency': career_tendency,
'fortune_level': fortune_level,
'traits_detail': traits_detail
}
return traits
def _analyze_palaces_with_knowledge(
self,
chart_data: dict,
year_sihua: dict,
palace_strength_analysis: dict = None,
san_fang_analysis: List[dict] = None
) -> List[dict]:
"""
融合知识库的宫位分析（含强弱评分 + 三方四正）
Args:
chart_data: 命盘数据
year_sihua: 年干四化
palace_strength_analysis: 宫位强弱评分结果（v3.5）
san_fang_analysis: 三方四正分析结果（v3.6 NEW!）
Returns:
list: 各宫位详细分析
"""
palace_analyses = []
palaces = chart_data.get('palaces', [])
# 创建宫位名称到强弱评分的映射
strength_map = {}
if palace_strength_analysis and 'palaces' in palace_strength_analysis:
for palace_strength in palace_strength_analysis['palaces']:
palace_name = palace_strength['name']
strength_map[palace_name] = palace_strength['strength']
# 创建宫位名称到三方四正分析的映射（v3.6 NEW!）
san_fang_map = {}
if san_fang_analysis:
for san_fang in san_fang_analysis:
palace_name = san_fang.get('palace', '')
san_fang_map[palace_name] = san_fang
for palace_name, palace_info in self.PALACE_MEANINGS.items():
# 从chart_data中找到对应的宫位数据
palace_data = next((p for p in palaces if p.get('name') == palace_name), None)
# 获取该宫位的强弱评分
strength_info = strength_map.get(palace_name, {})
# 获取该宫位的三方四正分析（v3.6 NEW!）
san_fang_info = san_fang_map.get(palace_name, {})
# 提取星曜信息
stars_list = []
if palace_data:
major_stars = palace_data.get('major_stars', [])
minor_stars = palace_data.get('minor_stars', [])
for star in major_stars:
star_name = star.get('name', '') if isinstance(star, dict) else star
stars_list.append(star_name)
# 提取四化信息
transformations = []
for sihua_type, data in year_sihua.items():
if data.get('palace') == palace_name:
transformations.append({
'type': sihua_type,
'star': data.get('star'),
'emoji': self._get_sihua_emoji(sihua_type)
})
# 判断整体质量（基于强弱评分）
overall_quality = '待评估'
if strength_info:
rank = strength_info.get('rank', 'C')
if rank in ['A+', 'A']:
overall_quality = '极佳'
elif rank in ['B+', 'B']:
overall_quality = '良好'
elif rank in ['C+', 'C']:
overall_quality = '一般'
else:
overall_quality = '需改善'
analysis = {
'palace': palace_name,
'english_name': PALACE_ENGLISH.get(palace_name, palace_name),
'represents': palace_info['代表'],
'importance': palace_info['重要性'],
'judgment_points': palace_info['判断要点'],
'san_fang_si_zheng': palace_info['三方四正'],
'stars': stars_list, # NEW: 实际星曜列表
'transformations': transformations, # NEW: 四化列表
'overall_quality': overall_quality, # NEW: 整体质量
'strength': strength_info, # v3.5: 宫位强弱评分详情
'san_fang_analysis': san_fang_info # v3.6 NEW: 三方四正详细分析
}
palace_analyses.append(analysis)
return palace_analyses
def _get_sihua_emoji(self, sihua_type: str) -> str:
"""获取四化emoji"""
emoji_map = {
'化禄': '💰',
'化权': '👑',
'化科': '📜',
'化忌': '⚠️'
}
return emoji_map.get(sihua_type, '')
def _analyze_sihua_with_theory(self, year_sihua: dict) -> dict:
"""
基于四化理论的深度分析
Returns:
dict: 四化深度分析
"""
analysis = {
'theory_basis': '十天干四化表（易经理论基础）',
'sihua_interactions': [], # 四化间的互动关系
'critical_transformations': [], # 关键四化
'suggestions': [] # 基于理论的建议
}
# 分析四化间的互动
if '化禄' in year_sihua and '化忌' in year_sihua:
hualu_palace = year_sihua['化禄'].get('palace')
huaji_palace = year_sihua['化忌'].get('palace')
analysis['sihua_interactions'].append({
'type': '禄忌对冲',
'description': f'化禄在{hualu_palace}，化忌在{huaji_palace}',
'interpretation': '有得有失，需要平衡发展，把握机会同时规避风险'
})
return analysis
def _generate_enhanced_life_overview(
self,
overall_judgment: dict,
core_traits: dict
) -> dict:
"""
生成知识库增强的整体运势
Returns:
dict: 增强版运势概述
"""
total_score = overall_judgment.get('total_score', 0)
# 使用更温暖、专业的语言（符合思思的风格）
if total_score >= 30:
fortune_level = '上上吉'
emoji = '✨'
summary = '您的命盘格局优秀，一生多贵人相助，事业财运俱佳。建议把握机会，积极进取，可有大成就。'
tone = 'very_positive'
elif total_score >= 15:
fortune_level = '上吉'
emoji = '🌟'
summary = '您的命盘配置良好，整体运势不错。只要努力奋斗，把握时机，定能成就一番事业。'
tone = 'positive'
elif total_score >= 0:
fortune_level = '中吉'
emoji = '🌤️'
summary = '您的命盘平稳中带有机遇。需要主动把握机会，谨慎处理挑战，稳健发展可趋吉避凶。'
tone = 'balanced'
elif total_score >= -15:
fortune_level = '平'
emoji = '⚖️'
summary = '您的命盘有些挑战，但也有转机。建议修身养性，积极化解不利因素，保持乐观心态。'
tone = 'cautious'
else:
fortune_level = '需化解'
emoji = '🔔'
summary = '您的命盘存在一些挑战。建议多行善事，提升自身修养，化解不利因素。记住：命运掌握在自己手中。'
tone = 'supportive'
return {
'fortune_level': fortune_level,
'emoji': emoji,
'total_score': total_score,
'summary': summary,
'tone': tone,
'sisi_note': '💕 思思提示：紫微斗数仅供参考，积极行动比算命更重要！',
'knowledge_enhanced': True
}
def _generate_practical_advice(
self,
year_sihua: dict,
chart_data: dict,
core_traits: dict
) -> dict:
"""
生成基于南北派断诀的实战建议
Returns:
dict: 实战建议
"""
advice_items = []
# 基于四化生成具体建议
for sihua_type, data in year_sihua.items():
palace = data.get('palace')
star = data.get('star')
# TODO: 从01-practical-divination.md提取对应断语
# 目前先用模板
if sihua_type == '化禄':
advice_items.append({
'category': '财运机遇',
'priority': 'high',
'palace': palace,
'advice': f'{star}化禄在{palace}，这是您的财运和喜事来源。建议重点发展{palace}相关事务。',
'action_items': [
f'积极把握{palace}方面的机会',
'主动出击，不要被动等待',
'这是您的优势领域，可以大胆尝试'
]
})
elif sihua_type == '化忌':
advice_items.append({
'category': '风险规避',
'priority': 'critical',
'palace': palace,
'advice': f'{star}化忌在{palace}，需要特别注意该领域。建议谨慎处理，避免冲动。',
'action_items': [
f'谨慎处理{palace}相关事务',
'避免重大决策和投资',
'多听取他人建议，不要一意孤行'
]
})
return {
'specific_advice': advice_items,
'overall_strategy': '综合分析命盘优势和挑战，扬长避短，趋吉避凶',
'sisi_reminder': '记住：命运70%靠自己，30%靠天意。积极行动最重要！',
'knowledge_source': '基于南北派断诀（138页实战经验）'
}
def _analyze_strengths_challenges_enhanced(
self,
year_sihua: dict,
palace_analysis: List[dict]
) -> dict:
"""
知识库增强的优势挑战分析
Returns:
dict: 优势挑战详细分析
"""
strengths = []
challenges = []
# 基于四化分析优势和挑战
for sihua_type, data in year_sihua.items():
palace = data.get('palace')
star = data.get('star')
score = data.get('impact_score', 0)
if sihua_type in ['化禄', '化权', '化科']:
strength = {
'type': sihua_type,
'palace': palace,
'star': star,
'description': self._get_knowledge_based_strength(sihua_type, palace, star),
'score': score,
'action_suggestion': self._get_strength_action(sihua_type, palace)
}
strengths.append(strength)
elif sihua_type == '化忌':
challenge = {
'type': sihua_type,
'palace': palace,
'star': star,
'description': self._get_knowledge_based_challenge(palace, star),
'severity': self._get_challenge_severity_enhanced(score),
'score': score,
'solution': self._get_challenge_solution(palace)
}
challenges.append(challenge)
return {
'strengths': strengths,
'challenges': challenges,
'balance_analysis': {
'strength_count': len(strengths),
'challenge_count': len(challenges),
'overall_balance': self._calculate_balance_score(strengths, challenges),
'recommendation': self._get_balance_recommendation(strengths, challenges)
},
'knowledge_enhanced': True
}
def _get_knowledge_based_strength(self, sihua_type: str, palace: str, star: str) -> str:
"""基于知识库的优势描述"""
# 融合主星特性和宫位意义
star_trait = self.MAIN_STAR_TRAITS.get(star, {}).get('特质', '')
base_descriptions = {
'化禄': f'{star}{star_trait}，在{palace}化禄，财运亨通，喜事连连',
'化权': f'{star}{star_trait}，在{palace}化权，掌握主导权，能力突出',
'化科': f'{star}{star_trait}，在{palace}化科，名声显扬，贵人相助'
}
return base_descriptions.get(sihua_type, f'{palace}运势良好')
def _get_knowledge_based_challenge(self, palace: str, star: str) -> str:
"""基于知识库的挑战描述"""
palace_meaning = self.PALACE_MEANINGS.get(palace, {}).get('代表', palace)
return f'{star}化忌在{palace}（{palace_meaning}），需要特别注意该领域，谨慎处理可化解'
def _get_strength_action(self, sihua_type: str, palace: str) -> str:
"""获取优势的行动建议"""
actions = {
'化禄': f'积极把握{palace}方面的机会，这是您的财运来源',
'化权': f'在{palace}方面主动出击，建立自己的影响力',
'化科': f'注重{palace}的文化修养和名声积累，多结识贵人'
}
return actions.get(sihua_type, f'善用{palace}的优势')
def _get_challenge_solution(self, palace: str) -> str:
"""获取挑战的解决方案"""
solutions = {
'命宫': '修身养性，提升自我，化解人生挑战',
'财帛宫': '谨慎理财，避免贪心，稳健投资',
'夫妻宫': '用心经营感情，多沟通理解，避免冲动',
'官禄宫': '踏实工作，提升能力，避免盲目跳槽',
'疾厄宫': '注意健康，预防疾病，保持良好生活习惯'
}
return solutions.get(palace, f'谨慎处理{palace}事务，化险为夷')
def _get_challenge_severity_enhanced(self, score: int) -> dict:
"""增强版挑战严重度评估"""
if score <= -25:
return {'level': '严重', 'color': 'red', 'priority': 'urgent'}
elif score <= -15:
return {'level': '中等', 'color': 'orange', 'priority': 'important'}
else:
return {'level': '较轻', 'color': 'yellow', 'priority': 'normal'}
def _calculate_balance_score(self, strengths: List, challenges: List) -> int:
"""计算平衡分数"""
strength_total = sum(s['score'] for s in strengths)
challenge_total = sum(c['score'] for c in challenges)
return strength_total + challenge_total
def _get_balance_recommendation(self, strengths: List, challenges: List) -> str:
"""获取平衡建议"""
balance_score = self._calculate_balance_score(strengths, challenges)
if balance_score >= 20:
return '整体优势明显，积极进取可大有作为'
elif balance_score >= 0:
return '优势和挑战并存，需要扬长避短，稳健发展'
else:
return '挑战较大，需要谨慎应对，化解不利因素'
def generate_summary_text_enhanced(self, interpretation: dict) -> str:
"""
生成增强版文字总结
Args:
interpretation: 增强版解读结果
Returns:
str: 文字总结
"""
overview = interpretation.get('life_overview', {})
core_traits = interpretation.get('core_traits', {})
strengths_challenges = interpretation.get('strengths_challenges', {})
practical_advice = interpretation.get('practical_advice', {})
summary_parts = []
# 品牌标识
summary_parts.append("【天機玄鑑 · 紫微斗数AI解读】")
summary_parts.append(f"知识库版本: {interpretation.get('knowledge_base_version', '2025-12-12')}")
summary_parts.append("")
# 整体运势
summary_parts.append(f"【整体运势】{overview.get('emoji', '')} {overview.get('fortune_level', '')}")
summary_parts.append(overview.get('summary', ''))
summary_parts.append(overview.get('sisi_note', ''))
summary_parts.append("")
# 核心特质
# TODO: 待core_traits实现后添加
# 主要优势
strengths = strengths_challenges.get('strengths', [])
if strengths:
summary_parts.append("【您的优势】")
for s in strengths:
summary_parts.append(f"• {s['type']}: {s['description']}")
summary_parts.append(f" 建议: {s.get('action_suggestion', '')}")
summary_parts.append("")
# 主要挑战
challenges = strengths_challenges.get('challenges', [])
if challenges:
summary_parts.append("【需要注意】")
for c in challenges:
severity = c.get('severity', {})
level = severity.get('level', '待评估') if isinstance(severity, dict) else severity
summary_parts.append(f"• {c['type']}: {c['description']} (严重程度: {level})")
summary_parts.append(f" 化解: {c.get('solution', '')}")
summary_parts.append("")
# 实战建议
summary_parts.append("【核心建议】")
summary_parts.append(practical_advice.get('overall_strategy', ''))
summary_parts.append(practical_advice.get('sisi_reminder', ''))
summary_parts.append("")
# 平衡分析
balance = strengths_challenges.get('balance_analysis', {})
summary_parts.append(f"【综合评估】{balance.get('recommendation', '')}")
# 结尾
summary_parts.append("")
summary_parts.append("---")
summary_parts.append("🦊 Generated with knowledge & love by Sisi")
summary_parts.append("📚 基于772KB专业紫微斗数知识库")
summary_parts.append("⚠️ 仅供参考，积极行动比算命更重要")
return "\n".join(summary_parts)
# ============== v4.0 新增方法 ==============
def apply_barnum_effect(
self,
interpretation: Dict,
gender: str = '',
age_group: str = 'middle'
) -> Dict:
"""
v4.0: 应用巴纳姆效果，让解读更温暖有共鸣
Args:
interpretation: 原始解读结果
gender: 性别 (男/女)
age_group: 年龄段 (young/middle_young/middle/senior)
Returns:
dict: 巴纳姆效果增强后的解读
"""
enhanced = interpretation.copy()
# 1. 增强整体运势文本
if 'life_overview' in enhanced:
overview = enhanced['life_overview']
original_summary = overview.get('summary', '')
# 应用巴纳姆效果 (v4.1修复：参数签名应该是original_text, star_name, palace_name, tone)
barnum_enhanced = self.barnum_reader.apply_barnum_effect(
original_summary
)
overview['summary_barnum'] = barnum_enhanced.get('enhanced', original_summary)
overview['barnum_hooks'] = barnum_enhanced.get('hooks_used', [])
# 2. 增强优势描述
if 'strengths_challenges' in enhanced:
sc = enhanced['strengths_challenges']
for strength in sc.get('strengths', []):
original_desc = strength.get('description', '')
# 使用星曜的温暖描述
star = strength.get('star', '')
if star:
warm_desc = self.barnum_reader.get_star_warm_description(star)
if warm_desc:
strength['description_barnum'] = warm_desc
# 3. 增强挑战描述（使用敏感内容替换）
if 'strengths_challenges' in enhanced:
sc = enhanced['strengths_challenges']
for challenge in sc.get('challenges', []):
original_desc = challenge.get('description', '')
safe_desc = self.barnum_reader.replace_sensitive_content(original_desc)
challenge['description_safe'] = safe_desc
enhanced['barnum_enhanced'] = True
enhanced['barnum_version'] = '4.0'
return enhanced
def analyze_six_relations(
self,
chart_data: Dict,
sihua_analysis: Dict
) -> Dict:
"""
v4.0: 六亲关系分析
Args:
chart_data: 命盘数据
sihua_analysis: 四化分析结果
Returns:
dict: 六亲分析结果
"""
palaces = chart_data.get('palaces', [])
gender = chart_data.get('gender', '')
year_sihua = sihua_analysis.get('year_sihua', {})
# 转换宫位数据格式
palace_dict = {}
for palace in palaces:
palace_name = palace.get('name', '')
if palace_name:
palace_dict[palace_name] = palace
# 调用六亲解读器（修复：应该传入palaces list，不是palace_dict）
six_relations_result = self.six_relations_interpreter.analyze_all_relations(
palaces,
year_sihua,
gender
)
return {
'six_relations': six_relations_result,
'methodology': '六亲批断（86条技巧）',
'key_discovery': '福德宫化忌→夫妻必死别',
'version': '4.0'
}
def apply_reading_methodology(
self,
chart_data: Dict,
sihua_analysis: Dict
) -> Dict:
"""
v4.0: 应用10步批命流程
Args:
chart_data: 命盘数据
sihua_analysis: 四化分析结果
Returns:
dict: 10步批命结果
"""
# 准备数据
palaces = chart_data.get('palaces', [])
year_sihua = sihua_analysis.get('year_sihua', {})
# 转换宫位数据为字典格式
palace_dict = {}
for palace in palaces:
palace_name = palace.get('name', '')
if palace_name:
palace_dict[palace_name] = palace
# 准备chart_data格式供引擎使用
engine_chart_data = {
'palaces': palace_dict,
'ming_palace': palace_dict.get('命宫', {}),
'shen_palace': self._find_shen_palace(palaces),
'sihua': year_sihua,
'birth_info': chart_data.get('birth_info', {}),
'gender': chart_data.get('gender', ''),
'tiangan': chart_data.get('year_stem', ''),
'wuxing': chart_data.get('wuxing', ''),
'daxun': chart_data.get('daxun', [])
}
# 执行10步批命
reading_result = self.reading_engine.execute_ten_step_reading(engine_chart_data)
return {
'ten_step_reading': reading_result,
'methodology': '10步标准批命流程',
'formulas_applied': len(reading_result.get('formulas_matched', [])),
'version': '4.0'
}
def _find_shen_palace(self, palaces: List) -> Dict:
"""查找身宫"""
for palace in palaces:
if palace.get('is_shen_palace', False):
return palace
return {}
def _calculate_age_group(self, birth_year: int) -> str:
"""计算年龄段"""
if not birth_year:
return 'middle'
import datetime
current_year = datetime.datetime.now().year
age = current_year - birth_year
if age < 25:
return 'young'
elif age < 40:
return 'middle_young'
elif age < 55:
return 'middle'
else:
return 'senior'
def generate_summary_text_v4(self, interpretation: dict) -> str:
"""
v4.0: 生成温暖有共鸣的文字总结
Args:
interpretation: v4.0解读结果
Returns:
str: 巴纳姆效果增强的文字总结
"""
overview = interpretation.get('life_overview', {})
six_relations = interpretation.get('six_relations', {})
reading = interpretation.get('reading_methodology', {})
strengths_challenges = interpretation.get('strengths_challenges', {})
summary_parts = []
# 品牌标识（v4.0升级）
summary_parts.append("【天機玄鑑 · 紫微斗数AI解读 v4.0】")
summary_parts.append(f"知识库版本: {interpretation.get('knowledge_base_version', '2026-02-03')}")
summary_parts.append("✨ 巴纳姆温暖版 | 10步标准批命 | 六亲全分析")
summary_parts.append("")
# 整体运势（使用巴纳姆增强版）
summary_parts.append(f"【整体运势】{overview.get('emoji', '')} {overview.get('fortune_level', '')}")
barnum_summary = overview.get('summary_barnum', overview.get('summary', ''))
summary_parts.append(barnum_summary)
summary_parts.append("")
# 格局识别总结
ten_step = reading.get('ten_step_reading', {})
if ten_step:
summary_info = ten_step.get('summary', {})
if summary_info.get('overall_pattern'):
summary_parts.append("【命格总评】")
summary_parts.append(summary_info.get('overall_pattern', ''))
summary_parts.append("")
# 六亲分析摘要
six_rel = six_relations.get('six_relations', {})
if six_rel:
summary_parts.append("【六亲运势】")
# 父母运
parents = six_rel.get('parents', {})
if parents.get('summary'):
summary_parts.append(f"👨👩👧 父母: {parents.get('summary', '')}")
# 婚姻运（重点！）
spouse = six_rel.get('spouse', {})
if spouse.get('summary'):
summary_parts.append(f"💕 婚姻: {spouse.get('summary', '')}")
if spouse.get('critical_warning'):
warning = spouse.get('critical_warning', {})
safe_msg = self.barnum_reader.replace_sensitive_content(
warning.get('message', '')
)
summary_parts.append(f" ⚠️ 特别提醒: {safe_msg}")
# 子女运
children = six_rel.get('children', {})
if children.get('summary'):
summary_parts.append(f"👶 子女: {children.get('summary', '')}")
summary_parts.append("")
# 核心优势（巴纳姆增强）
strengths = strengths_challenges.get('strengths', [])
if strengths:
summary_parts.append("【您的核心优势】")
for s in strengths[:3]: # 只显示前3个
desc = s.get('description_barnum', s.get('description', ''))
summary_parts.append(f"✨ {s.get('type', '')}: {desc}")
summary_parts.append("")
# 需要关注（安全版描述）
challenges = strengths_challenges.get('challenges', [])
if challenges:
summary_parts.append("【需要关注】")
for c in challenges[:2]: # 只显示前2个
desc = c.get('description_safe', c.get('description', ''))
summary_parts.append(f"💡 {desc}")
if c.get('solution'):
summary_parts.append(f" 化解: {c.get('solution', '')}")
summary_parts.append("")
# 温暖的结语
summary_parts.append("【温馨寄语】")
summary_parts.append("您的命盘就像一幅独特的画卷，每一笔都有其意义。")
summary_parts.append("记住：了解自己是为了更好地成长，而非被命运所限。")
summary_parts.append("把握当下，积极行动，未来掌握在您自己手中。")
summary_parts.append("")
# 结尾
summary_parts.append("---")
summary_parts.append("🦊 Generated with knowledge & love by Sisi")
summary_parts.append("📚 基于772KB专业紫微斗数知识库 + 巴纳姆温暖效果")
summary_parts.append("💕 让命理不再冰冷，让解读充满共鸣")
summary_parts.append("⚠️ 仅供参考，您的人生由您做主")
return "\n".join(summary_parts)
"""
知识库增强型AI解读引擎 v4.0
Knowledge-Enhanced AI Interpretation Engine
基于今日建成的紫微斗数知识库（772KB，5大核心模块）
Powered by comprehensive Ziwei Doushu knowledge base (772KB, 5 core modules)
v4.0 新增功能:
- 巴纳姆冷读效果：温暖有共鸣的解读语言
- 六亲分析：父母/兄弟/夫妻/子女运批断
- 10步批命流程：标准化解读流程
- 福德宫核心秘诀：夫妻死别判断
知识库路径:
- 主星特性: /agent-knowledge/mingli-knowledge/eastern/ziwei/foundations/01-main-stars.md
- 十二宫位: /agent-knowledge/mingli-knowledge/eastern/ziwei/foundations/02-twelve-palaces.md
- 四化理论: /agent-knowledge/mingli-knowledge/eastern/ziwei/foundations/03-four-transformations.md
- 流年大运: /agent-knowledge/mingli-knowledge/eastern/ziwei/timing/01-annual-fortune.md
- 实战断诀: /agent-knowledge/mingli-knowledge/eastern/ziwei/interpretations/01-practical-divination.md
- 批命方法论: /agent-knowledge/mingli-knowledge/eastern/ziwei/interpretations/00-reading-methodology.md
- 六亲批断: /agent-knowledge/mingli-knowledge/eastern/ziwei/interpretations/00-six-relations.md
Created: 2025-12-12
Updated: 2026-02-03 (v4.0 巴纳姆+六亲+批命流程)
Author: Sisi 🦊 (紫微知识库管理员 + AI引擎架构师)
"""
from typing import Dict, List, Any, Optional
from sihua_data import PALACE_ENGLISH
from palace_strength import calculate_all_palaces_strength, calculate_palace_strength
from star_brightness_table import enhance_star_with_brightness, get_palace_brightness_summary
from san_fang_si_zheng_analyzer import analyze_san_fang_si_zheng, analyze_all_san_fang_si_zheng
from geju_matcher import GejuMatcher, MATCHER_VERSION
from star_combination_matcher import StarCombinationMatcher # v3.8: 星曜组合断语引擎
# v4.0 新增模块 - 使用延迟导入减少启动内存占用
# from barnum_cold_reader import BarnumColdReader, get_barnum_reader
# from methodology_loader import MethodologyLoader, get_methodology_loader
# from six_relations_interpreter import SixRelationsInterpreter, get_six_relations_interpreter
# from reading_methodology import ReadingMethodologyEngine, get_reading_engine
class KnowledgeEnhancedInterpreter:
"""知识库增强型AI解读器 - 基于772KB专业知识库 + v4.0巴纳姆效果"""
def __init__(self):
"""初始化增强型解读器"""
# v3.7: 初始化格局匹配器
self.geju_matcher = GejuMatcher()
# v3.8: 初始化星曜组合断语匹配器
self.star_combination_matcher = StarCombinationMatcher()
# v4.0 新增: 延迟初始化（减少启动内存占用）
self._barnum_reader = None
self._methodology_loader = None
self._six_relations_interpreter = None
self._reading_engine = None
# 初始化知识库数据（修复：调用被遗忘的初始化方法）
self.__init_v4_modules()
def __init_v4_modules(self):
"""v4.0: 初始化模块数据"""
# 十天干四化表（THE CORE！）- 从知识库提取
self.TIANGAN_SIHUA = {
'甲': {'禄': '廉贞', '权': '破军', '科': '武曲', '忌': '太阳'},
'乙': {'禄': '天机', '权': '天梁', '科': '紫微', '忌': '太阴'},
'丙': {'禄': '天同', '权': '天机', '科': '文昌', '忌': '廉贞'},
'丁': {'禄': '太阴', '权': '天同', '科': '天机', '忌': '巨门'},
'戊': {'禄': '贪狼', '权': '太阴', '科': '右弼', '忌': '天机'},
'己': {'禄': '武曲', '权': '贪狼', '科': '天梁', '忌': '文曲'},
'庚': {'禄': '太阳', '权': '武曲', '科': '天府', '忌': '天同'},
'辛': {'禄': '巨门', '权': '太阳', '科': '文曲', '忌': '文昌'},
'壬': {'禄': '天梁', '权': '紫微', '科': '左辅', '忌': '武曲'},
'癸': {'禄': '破军', '权': '巨门', '科': '太阴', '忌': '贪狼'}
}
# 主星基本特性（从01-main-stars.md提取）
self.MAIN_STAR_TRAITS = {
'紫微': {
'五行': '己阴土',
'化气': '尊贵',
'特质': '帝王星，领导力强，尊贵有气度',
'事业': '适合管理、政治、高层领导',
'性格': '自尊心强，喜欢掌权，有责任感'
},
'天机': {
'五行': '乙阴木',
'化气': '善',
'特质': '智慧星，机智聪明，善于策划',
'事业': '适合教育、咨询、策划、技术',
'性格': '心思细腻，反应快，喜欢思考'
},
'太阳': {
'五行': '丙阳火',
'化气': '贵',
'特质': '光明星，热情大方，爱面子',
'事业': '适合外交、公关、管理、服务业',
'性格': '热情开朗，重视名声，乐于助人'