feat: 四层schema追加(meta/strength/timing/evidence) — /analyze-ziwei-v4

只追加新字段，旧字段一个不改(已验证old_keys全部保留)。

- terms.py：14主星+辅星/十二宫/亮度/四化双语术语单一真相源
- evidence.py：build_meta/build_strength/build_timing/build_evidence
- strength.weak_mutagen_stars专门标注"带四化但亮度弱"的星——这是今天实测
挖出的真实发现(太阳化权却陷落、巨门化禄却亮度"不")，此前完全没有结构化
标注，容易被AI报告当纯利好写。evidence块会自动生成CAUTION提示，要求
正反双审(结构层vs执行层)
- timing数组统一current+next大限，next大限原始数据缺end_age字段，
已按10年一步的规则兜底补上，跟evidence文本口径一致
- 已用小鱼盘验证：命宫紫微(平)+左辅+文昌(得,化忌)、身宫财帛、生年四化、
现行大限官禄(45-54)全部正确；test_golden_charts.py新增1条，7项全过

🦊 Generated with Sisi

app.py

@@ -20,6 +20,7 @@ from ai_interpreter import AIInterpreter
 from knowledge_enhanced_interpreter import KnowledgeEnhancedInterpreter
 from daxun_analyzer import DaxunAnalyzer
 from resolution_advisor import ResolutionAdvisor
+from evidence import build_meta, build_strength, build_timing, build_evidence
 from liuyue_analyzer import LiuyueAnalyzer
 
 app = FastAPI(
@@ -410,6 +411,14 @@ def analyze_ziwei_knowledge_enhanced(request: ZiweiRequest, api_key: str = Depen
             'sisi_signature': '🦊 Generated with warmth & wisdom by Sisi v4.0'
         }
 
+        # 2026-07-12 Phase 3: 追加 meta/strength/timing/evidence 四层字段，旧字段一个不改。
+        enhanced_data['meta'] = build_meta()
+        enhanced_data['strength'] = build_strength(ziwei_chart.get('palaces', []))
+        enhanced_data['timing'] = build_timing(daxun_analysis)
+        enhanced_data['evidence'] = build_evidence(
+            ziwei_chart.get('chart', {}), ziwei_chart.get('palaces', []), sihua_analysis, daxun_analysis
+        )
+
         return ZiweiResponse(
             status="success",
             data=enhanced_data

evidence.py

@@ -0,0 +1,127 @@
+"""
+紫微斗数四层Schema组装：meta / strength / timing / evidence。
+
+只追加新字段，不改动任何旧字段——见 API_UNIFICATION_PLAN.md §3。
+调用方：app.py 的 v4系列endpoint (analyze_ziwei_knowledge_enhanced / analyze_ziwei_v4)。
+"""
+
+from typing import Any, Dict, List, Optional
+
+from terms import star_term, palace_term, brightness_term, mutagen_term, star_with_brightness
+
+WEAK_BRIGHTNESS = {"不", "陷"}
+
+
+def build_meta() -> Dict[str, str]:
+    return {"engine": "iztro", "schema_version": "1.0"}
+
+
+def build_strength(palaces: List[Dict[str, Any]]) -> Dict[str, Any]:
+    """
+    亮度汇总——尤其标出"带四化但亮度弱"的星(2026-07-12发现的真实案例：小鱼盘太阳
+    化权却落陷、巨门化禄却亮度"不"，这两条此前完全没有被结构化标注出来，只能靠
+    人工核对十二宫才能发现，容易被AI报告当成纯粹的利好来写)。
+    """
+    weak_mutagen_stars = []
+    strong_stars = []
+    for p in palaces:
+        for s in p.get("major_stars", []) or []:
+            name, brightness, mutagen = s.get("name"), s.get("brightness"), s.get("mutagen")
+            if not name:
+                continue
+            if mutagen and brightness in WEAK_BRIGHTNESS:
+                weak_mutagen_stars.append({
+                    "star": name, "palace": p.get("name"), "brightness": brightness, "mutagen": mutagen,
+                })
+            if brightness in ("庙", "旺"):
+                strong_stars.append({"star": name, "palace": p.get("name"), "brightness": brightness})
+    return {
+        "weak_mutagen_stars": weak_mutagen_stars,
+        "strong_stars": strong_stars,
+    }
+
+
+def build_timing(daxun_analysis: Optional[Dict[str, Any]]) -> List[Dict[str, Any]]:
+    if not daxun_analysis:
+        return []
+    timing = []
+    for key, is_current in (("current", True), ("next", False)):
+        d = daxun_analysis.get(key)
+        if not d:
+            continue
+        # "next" daxun(predict_next_daxun的输出)不带end_age，只有start_age——
+        # 每步大限固定10年，缺失时用start_age+9兜底，跟evidence文本口径保持一致
+        end_age = d.get("end_age")
+        if end_age is None and d.get("start_age") is not None:
+            end_age = d["start_age"] + 9
+        timing.append({
+            "layer": "daxun",
+            "label": d.get("palace_name", ""),
+            "label_en": palace_term(d.get("palace_name", "")) if d.get("palace_name") else "",
+            "start_age": d.get("start_age"),
+            "end_age": end_age,
+            "is_current": is_current,
+            "flags": ["empty_palace"] if d.get("is_empty_palace") else [],
+        })
+    return timing
+
+
+def build_evidence(
+    chart: Dict[str, Any],
+    palaces: List[Dict[str, Any]],
+    sihua_analysis: Optional[Dict[str, Any]],
+    daxun_analysis: Optional[Dict[str, Any]],
+) -> str:
+    lines: List[str] = []
+
+    ming_gong = next((p for p in palaces if p.get("name") == "命宫"), None)
+    body_palace = next((p for p in palaces if p.get("is_body_palace")), None)
+    if ming_gong:
+        stars = ", ".join(
+            star_with_brightness(s["name"], s.get("brightness", ""))
+            for s in ming_gong.get("major_stars", []) if s.get("name")
+        )
+        lines.append(f"- {palace_term('命宫')}: {stars or '(no major star / 借星安宫)'}.")
+    lines.append(f"- Soul star (命主): {star_term(chart.get('soul', ''))}. Body star (身主): {star_term(chart.get('body', ''))}.")
+    if body_palace:
+        lines.append(f"- Body Palace (身宫) falls in: {palace_term(body_palace.get('name', ''))}.")
+
+    if sihua_analysis:
+        year_sihua = sihua_analysis.get("year_sihua", {})
+        parts = []
+        for mutagen_key, mutagen_char in (("化禄", "禄"), ("化权", "权"), ("化科", "科"), ("化忌", "忌")):
+            entry = year_sihua.get(mutagen_key)
+            if entry:
+                parts.append(f"{mutagen_term(mutagen_char)} -> {star_term(entry.get('star',''))} @ {palace_term(entry.get('palace',''))}")
+        if parts:
+            lines.append("- Natal Four Transformations (生年四化): " + "; ".join(parts) + ".")
+
+    strength = build_strength(palaces)
+    if strength["weak_mutagen_stars"]:
+        flagged = "; ".join(
+            f"{star_term(w['star'])} {mutagen_term(w['mutagen'][-1] if len(w['mutagen'])>1 else w['mutagen'])} "
+            f"but brightness={brightness_term(w['brightness'])}"
+            for w in strength["weak_mutagen_stars"]
+        )
+        lines.append(
+            f"- CAUTION (signal present but weak execution): {flagged}. "
+            f"The mutagen signal exists structurally but the star's own brightness is low — "
+            f"deliver at a discount, must state both sides (structure vs. execution)."
+        )
+
+    if daxun_analysis:
+        current = daxun_analysis.get("current", {})
+        if current:
+            major = ", ".join(current.get("palace_stars", {}).get("major", []))
+            lines.append(
+                f"- Current Daxun (现行大限): {palace_term(current.get('palace_name',''))} "
+                f"({current.get('start_age')}-{current.get('end_age')}), stars: {major or '(empty)'}."
+            )
+        nxt = daxun_analysis.get("next", {})
+        if nxt:
+            lines.append(
+                f"- Next Daxun (下一大限): {palace_term(nxt.get('palace_name',''))} "
+                f"({nxt.get('start_age')}-{nxt.get('start_age', 0) + 9})."
+            )
+
+    return "\n".join(lines)

terms.py

@@ -0,0 +1,67 @@
+"""
+紫微斗数术语双语对照表 —— 单一真相源。
+
+跟astrologybazi-api的terms.py同一个思路：AI报告/evidence块引用命理术语时统一从这里查，
+避免同一颗星这次译一个名字下次译另一个名字。
+"""
+
+STAR_TERMS = {
+    "紫微": "Zi Wei (Emperor Star)", "天机": "Tian Ji (Advisor Star)",
+    "太阳": "Tai Yang (Sun Star)", "武曲": "Wu Qu (Military Star)",
+    "天同": "Tian Tong (Harmony Star)", "廉贞": "Lian Zhen (Chastity Star)",
+    "天府": "Tian Fu (Treasury Star)", "太阴": "Tai Yin (Moon Star)",
+    "贪狼": "Tan Lang (Greedy Wolf Star)", "巨门": "Ju Men (Giant Gate Star)",
+    "天相": "Tian Xiang (Minister Star)", "天梁": "Tian Liang (Beam Star)",
+    "七杀": "Qi Sha (Seven Killings Star)", "破军": "Po Jun (Army Breaker Star)",
+    "左辅": "Zuo Fu (Left Assistant)", "右弼": "You Bi (Right Assistant)",
+    "文昌": "Wen Chang (Literary Star)", "文曲": "Wen Qu (Artistic Star)",
+    "天魁": "Tian Kui (Noble Star, Yang)", "天钺": "Tian Yue (Noble Star, Yin)",
+}
+
+PALACE_TERMS = {
+    "命宫": "Life Palace (Ming Gong)", "兄弟": "Siblings Palace (Xiong Di)",
+    "夫妻": "Spouse Palace (Fu Qi)", "子女": "Children Palace (Zi Nu)",
+    "财帛": "Wealth Palace (Cai Bo)", "疾厄": "Health Palace (Ji E)",
+    "迁移": "Travel Palace (Qian Yi)", "仆役": "Friends Palace (Pu Yi)",
+    "官禄": "Career Palace (Guan Lu)", "田宅": "Property Palace (Tian Zhai)",
+    "福德": "Fortune Palace (Fu De)", "父母": "Parents Palace (Fu Mu)",
+}
+
+BRIGHTNESS_TERMS = {
+    "庙": "temple-bright, strongest (Miao)",
+    "旺": "prosperous, strong (Wang)",
+    "得": "gaining, above average (De)",
+    "利": "favorable, average-plus (Li)",
+    "平": "level, average (Ping)",
+    "不": "weak, below average (Bu)",
+    "陷": "trapped, weakest (Xian)",
+}
+
+MUTAGEN_TERMS = {
+    "禄": "Transformation of Wealth (Hua Lu)",
+    "权": "Transformation of Power (Hua Quan)",
+    "科": "Transformation of Fame (Hua Ke)",
+    "忌": "Transformation of Obstruction (Hua Ji)",
+}
+
+
+def star_term(name: str) -> str:
+    return f"{name} ({STAR_TERMS[name]})" if name in STAR_TERMS else name
+
+
+def palace_term(name: str) -> str:
+    return f"{name} ({PALACE_TERMS[name]})" if name in PALACE_TERMS else name
+
+
+def brightness_term(level: str) -> str:
+    return f"{level} ({BRIGHTNESS_TERMS[level]})" if level in BRIGHTNESS_TERMS else level
+
+
+def mutagen_term(mutagen: str) -> str:
+    return f"Hua {mutagen} ({MUTAGEN_TERMS[mutagen]})" if mutagen in MUTAGEN_TERMS else mutagen
+
+
+def star_with_brightness(name: str, brightness: str) -> str:
+    if brightness:
+        return f"{star_term(name)} [{brightness_term(brightness)}]"
+    return star_term(name)

test_golden_charts.py

@@ -76,6 +76,28 @@ def test_xiaoyu_current_daxun():
     assert set(current['palace_stars']['major']) == {'廉贞', '天府'}
 
 
+def test_four_layer_schema():
+    """
+    2026-07-12 Phase 3新增：v4 endpoint追加 meta/strength/timing/evidence 四层字段。
+    strength.weak_mutagen_stars专门标注"带四化但亮度弱"的星——这是2026-07-12实测时
+    发现的真实案例(太阳化权却陷落、巨门化禄却亮度'不')，此前完全没有结构化标注。
+    """
+    d = _get_data()
+    assert d['meta']['schema_version'] == '1.0'
+
+    weak = {w['star']: w for w in d['strength']['weak_mutagen_stars']}
+    assert '太阳' in weak and weak['太阳']['brightness'] == '陷'
+    assert '巨门' in weak and weak['巨门']['brightness'] == '不'
+
+    current_timing = next(t for t in d['timing'] if t['is_current'])
+    assert current_timing['label'] == '官禄'
+    assert current_timing['start_age'] == 45 and current_timing['end_age'] == 54
+
+    evidence = d['evidence']
+    assert 'CAUTION' in evidence
+    assert '巨门' in evidence and '太阳' in evidence
+
+
 def test_ziwei_v4_evidence_fields_present():
     """
     2026-07-12 P0 bug回归锁定：确认v4 endpoint真的返回sihua_analysis/daxun_analysis，