dsh-metaphysics 0.14.3 → 0.16.0

package/engine/bazi.js

@@ -1,515 +1,505 @@
-// 四柱八字引擎
-import {
-  STEMS, BRANCHES, TERM_NAMES,
-  ganzhiName, dayGanzhiIndex, jdToParts, partsToJd, sexagenaryIndex,
-  termWindow, previousJie, nextJie, equationOfTime, formatJd,
-} from './calendar.js';
-import { resolveAddress } from './geo.js';
-import { computeBaziShensha } from './shensha.js';
-import { analyzeBaziFrame, scoreLuck } from './geju.js';
-
-// 地支藏干（本气 / 中气 / 余气）
-export const HIDDEN_STEMS = {
-  子: ['癸'],
-  丑: ['己', '癸', '辛'],
-  寅: ['甲', '丙', '戊'],
-  卯: ['乙'],
-  辰: ['戊', '乙', '癸'],
-  巳: ['丙', '戊', '庚'],
-  午: ['丁', '己'],
-  未: ['己', '丁', '乙'],
-  申: ['庚', '壬', '戊'],
-  酉: ['辛'],
-  戌: ['戊', '辛', '丁'],
-  亥: ['壬', '甲'],
-};
-
-export const STEM_ELEMENT = {
-  甲: '木', 乙: '木', 丙: '火', 丁: '火', 戊: '土',
-  己: '土', 庚: '金', 辛: '金', 壬: '水', 癸: '水',
-};
-
-export const BRANCH_ELEMENT = {
-  子: '水', 丑: '土', 寅: '木', 卯: '木', 辰: '土', 巳: '火',
-  午: '火', 未: '土', 申: '金', 酉: '金', 戌: '土', 亥: '水',
-};
-
-const GENERATES = { 木: '火', 火: '土', 土: '金', 金: '水', 水: '木' };
-const OVERCOMES = { 木: '土', 土: '水', 水: '火', 火: '金', 金: '木' };
-
-const isYangStem = (stem) => STEMS.indexOf(stem) % 2 === 0;
-
-// 两套藏干权重是不同用途，不是"同一件事写了两次"：
-//   · 五行占比——看这一行在盘里有多少，本气 1 / 中气 0.5 / 余气 0.3；
-//   · 日主通根——看这一支能不能让日主站住，本气权重更高（1.2 / 0.6 / 0.3）。
-const WUXING_HIDDEN_WEIGHT = [1, 0.5, 0.3];
-const ROOT_HIDDEN_WEIGHT = [1.2, 0.6, 0.3];
-
-const STEM_HE = { 甲己: '土', 乙庚: '金', 丙辛: '水', 丁壬: '木', 戊癸: '火' };
-const STEM_CHONG_PAIRS = ['甲庚', '乙辛', '丙壬', '丁癸'];
-const BRANCH_HE = { 子丑: '土', 寅亥: '木', 卯戌: '火', 辰酉: '金', 巳申: '水', 午未: '土' };
-const SANHE = { 申子辰: '水', 亥卯未: '木', 寅午戌: '火', 巳酉丑: '金' };
-const SANHUI = { 寅卯辰: '木', 巳午未: '火', 申酉戌: '金', 亥子丑: '水' };
-const BRANCH_CHONG = ['子午', '丑未', '寅申', '卯酉', '辰戌', '巳亥'];
-const BRANCH_HAI = ['子未', '丑午', '寅巳', '卯辰', '申亥', '酉戌'];
-const BRANCH_PO = ['子酉', '丑辰', '寅亥', '卯午', '巳申', '未戌'];
-// 三刑：寅巳申（无恩之刑）、丑戌未（恃势之刑）、子卯（无礼之刑）。
-// 另有「自刑」：辰午酉亥四支见同支即自刑（辰辰、午午、酉酉、亥亥），此前漏判。
-const XING_GROUPS = [['寅', '巳', '申'], ['丑', '戌', '未'], ['子', '卯']];
-const XING_SELF = ['辰', '午', '酉', '亥'];
-
-const hasPair = (list, a, b) => list.includes(a + b) || list.includes(b + a);
-
-/** 干支关系：五合、相冲、相克；六合、三合半合、三会半会拱会、冲、害、破、刑 */
-export function buildRelations(pillars) {
-  const stems = ['year', 'month', 'day', 'hour'].map((k) => pillars[k].stem);
-  const branches = ['year', 'month', 'day', 'hour'].map((k) => pillars[k].branch);
-
-  const stemOut = [];
-  for (let i = 0; i < 4; i++) {
-    for (let j = i + 1; j < 4; j++) {
-      const a = stems[i];
-      const b = stems[j];
-      if (a === b) continue;
-      const he = STEM_HE[a + b] || STEM_HE[b + a];
-      if (he) { stemOut.push({ text: `${a}${b}合化${he}`, rank: 0 }); continue; }
-      if (hasPair(STEM_CHONG_PAIRS, a, b)) { stemOut.push({ text: `${a}${b}相冲`, rank: 1 }); continue; }
-      const ea = STEM_ELEMENT[a];
-      const eb = STEM_ELEMENT[b];
-      if (OVERCOMES[ea] === eb) stemOut.push({ text: `${a}克${b}`, rank: 3 });
-      else if (OVERCOMES[eb] === ea) stemOut.push({ text: `${b}克${a}`, rank: 3 });
-    }
-  }
-
-  const branchOut = [];
-  const set = new Set(branches);
-  const fullSans = [];
-  for (const [k, v] of Object.entries(SANHE)) {
-    if ([...k].every((c) => set.has(c))) {
-      branchOut.push({ text: `${k}三合${v}`, rank: 0 });
-      fullSans.push(k);
-    }
-  }
-  const fullHuis = [];
-  for (const [k, v] of Object.entries(SANHUI)) {
-    if ([...k].every((c) => set.has(c))) {
-      branchOut.push({ text: `${k}三会${v}`, rank: 0 });
-      fullHuis.push(k);
-    }
-  }
-  for (let i = 0; i < 4; i++) {
-    for (let j = i + 1; j < 4; j++) {
-      const a = branches[i];
-      const b = branches[j];
-      if (a === b) {
-        // 同支不是"没关系"：辰午酉亥两柱同见为自刑
-        if (XING_SELF.includes(a)) branchOut.push({ text: `${a}${b}自刑`, rank: 2 });
-        continue;
-      }
-      const he = BRANCH_HE[a + b] || BRANCH_HE[b + a];
-      const sh = Object.keys(SANHE).find((k) => k.includes(a) && k.includes(b));
-      const hui = Object.keys(SANHUI).find((k) => k.includes(a) && k.includes(b));
-      if (he) {
-        // 六合优先，不再重复标半合/半会
-        branchOut.push({ text: `${a}${b}合${he}`, rank: 0 });
-      } else {
-        if (sh && !fullSans.includes(sh)) {
-          const mid = sh[1];
-          const kind = a === mid || b === mid ? '半合' : '拱合';
-          branchOut.push({ text: `${a}${b}${kind}${SANHE[sh]}`, rank: 0 });
-        }
-        if (hui && !fullHuis.includes(hui)) {
-          const adj = Math.abs(hui.indexOf(a) - hui.indexOf(b)) === 1;
-          branchOut.push({ text: `${a}${b}${adj ? '半会' : '拱会'}${SANHUI[hui]}`, rank: 0 });
-        }
-      }
-      if (hasPair(BRANCH_CHONG, a, b)) branchOut.push({ text: `${a}${b}相冲`, rank: 1 });
-      if (hasPair(BRANCH_HAI, a, b)) branchOut.push({ text: `${a}${b}相害`, rank: 2 });
-      if (hasPair(BRANCH_PO, a, b)) branchOut.push({ text: `${a}${b}相破`, rank: 2 });
-      for (const g of XING_GROUPS) {
-        if (g.includes(a) && g.includes(b)) branchOut.push({ text: `${a}${b}相刑`, rank: 2 });
-      }
-    }
-  }
-
-  const uniq = (arr) => {
-    const seen = new Set();
-    const out = [];
-    for (const x of [...arr].sort((p, q) => p.rank - q.rank)) {
-      if (!seen.has(x.text)) { seen.add(x.text); out.push(x.text); }
-    }
-    return out;
-  };
-  return { stems: uniq(stemOut), branches: uniq(branchOut) };
-}
-
-/** 十神：以日干为我 */
-export function tenGod(dayStem, otherStem) {
-  const me = STEM_ELEMENT[dayStem];
-  const it = STEM_ELEMENT[otherStem];
-  const samePolarity = isYangStem(dayStem) === isYangStem(otherStem);
-  if (me === it) return samePolarity ? '比肩' : '劫财';
-  if (GENERATES[me] === it) return samePolarity ? '食神' : '伤官';
-  if (OVERCOMES[me] === it) return samePolarity ? '偏财' : '正财';
-  if (OVERCOMES[it] === me) return samePolarity ? '七杀' : '正官';
-  if (GENERATES[it] === me) return samePolarity ? '偏印' : '正印';
-  return '?';
-}
-
-// 六十甲子纳音（每两个干支一名）
-const NAYIN_NAMES = [
-  '海中金', '炉中火', '大林木', '路旁土', '剑锋金',
-  '山头火', '涧下水', '城头土', '白蜡金', '杨柳木',
-  '泉中水', '屋上土', '霹雳火', '松柏木', '长流水',
-  '沙中金', '山下火', '平地木', '壁上土', '金箔金',
-  '覆灯火', '天河水', '大驿土', '钗钏金', '桑柘木',
-  '大溪水', '沙中土', '天上火', '石榴木', '大海水',
-];
-
-export function nayin(ganzhiIdx) {
-  return NAYIN_NAMES[Math.floor((((ganzhiIdx % 60) + 60) % 60) / 2)];
-}
-
-const JIE_TO_MONTH_BRANCH = { 0: 1, 2: 2, 4: 3, 6: 4, 8: 5, 10: 6, 12: 7, 14: 8, 16: 9, 18: 10, 20: 11, 22: 0 };
-
-function pillar(ganzhiIdx, dayStem) {
-  const g = ganzhiName(ganzhiIdx);
-  const hidden = HIDDEN_STEMS[g.branch];
-  return {
-    ganzhi: g.name,
-    stem: g.stem,
-    branch: g.branch,
-    stemElement: STEM_ELEMENT[g.stem],
-    branchElement: BRANCH_ELEMENT[g.branch],
-    stemTenGod: dayStem ? tenGod(dayStem, g.stem) : null,
-    hidden: hidden.map((s, i) => ({
-      stem: s,
-      element: STEM_ELEMENT[s],
-      tenGod: dayStem ? tenGod(dayStem, s) : null,
-      role: ['本气', '中气', '余气'][i] ?? '余气',
-    })),
-    nayin: nayin(ganzhiIdx),
-  };
-}
-
-/**
- * 真太阳时修正
- * @returns {{offsetMinutes:number, jd:number, note:string}}
- */
-export function applyTrueSolar(jd, longitude) {
-  const p = jdToParts(jd);
-  if (longitude == null || Number.isNaN(longitude)) {
-    return { offsetMinutes: 0, jd, note: '未提供经度，按东八区平太阳时' };
-  }
-  const longitudeMinutes = (longitude - 120) * 4;
-  const eot = equationOfTime(p.year, p.month, p.day);
-  const offset = longitudeMinutes + eot;
-  return {
-    offsetMinutes: Math.round(offset * 10) / 10,
-    jd: jd + offset / 1440,
-    note: `经度差 ${longitudeMinutes.toFixed(1)} 分 + 均时差 ${eot.toFixed(1)} 分`,
-  };
-}
-
-/**
- * 排四柱八字
- * @param {object} input { year,month,day,hour,minute, gender:'male'|'female', longitude?, lateZi?:boolean, trueSolar?:boolean }
- */
-export function buildBazi(input) {
-  const { year, month, day, hour = 0, minute = 0, gender = 'male' } = input;
-  const lateZi = input.lateZi !== false;
-  const useTrueSolar = input.trueSolar !== false;
-
-  const civilJd = partsToJd({ year, month, day, hour, minute });
-  // 地址 -> 经度：手填的 longitude 优先，其次按地址查表
-  const geo = input.geo || (input.address ? resolveAddress(input.address) : null);
-  const longitude = typeof input.longitude === 'number'
-    ? input.longitude
-    : (geo && typeof geo.lon === 'number' ? geo.lon : undefined);
-  const solar = useTrueSolar ? applyTrueSolar(civilJd, longitude) : { offsetMinutes: 0, jd: civilJd, note: '未启用真太阳时' };
-  const jd = solar.jd;
-
-  const terms = termWindow(year);
-  const prevJieTerm = previousJie(terms, jd);
-  const nextJieTerm = nextJie(terms, jd);
-
-  // 年柱：以立春为界
-  const lichun = terms.find((t) => t.index === 2 && t.year === year);
-  const solarYear = lichun && jd < lichun.jd ? year - 1 : year;
-  const yearIdx = (((solarYear - 4) % 60) + 60) % 60;
-  const yearStem = STEMS[yearIdx % 10];
-
-  // 月柱：以「节」为界
-  const monthBranchIdx = JIE_TO_MONTH_BRANCH[prevJieTerm.index];
-  const yinMonthStem = ((STEMS.indexOf(yearStem) % 5) * 2 + 2) % 10;
-  const monthOffset = ((monthBranchIdx - 2) % 12 + 12) % 12; // 0 = 寅月
-  const monthStemIdx = (yinMonthStem + monthOffset) % 10;
-  const monthIdx = sexagenaryIndex(monthStemIdx, monthBranchIdx);
-
-  // 日柱：23:00 后是否换日
-  const jdnBase = Math.floor(jd + 0.5);
-  const hourOfDay = jdToParts(jd).hour;
-  const jdn = lateZi && hourOfDay >= 23 ? jdnBase + 1 : jdnBase;
-  const dayIdx = dayGanzhiIndex(jdn);
-  const dayStem = STEMS[dayIdx % 10];
-
-  // 时柱：五鼠遁
-  const hourBranchIdx = Math.floor(((hourOfDay + 1) % 24) / 2);
-  const ziHourStem = ((STEMS.indexOf(dayStem) % 5) * 2) % 10;
-  const hourStemIdx = (ziHourStem + hourBranchIdx) % 10;
-  const hourIdx = sexagenaryIndex(hourStemIdx, hourBranchIdx);
-
-  const pillars = {
-    year: pillar(yearIdx, dayStem),
-    month: pillar(monthIdx, dayStem),
-    day: pillar(dayIdx, dayStem),
-    hour: pillar(hourIdx, dayStem),
-  };
-
-  // 大运
-  const isYangYear = STEMS.indexOf(yearStem) % 2 === 0;
-  const forward = (isYangYear && gender === 'male') || (!isYangYear && gender === 'female');
-  const spanDays = forward ? nextJieTerm.jd - jd : jd - prevJieTerm.jd;
-  const totalMonths = spanDays * 4; // 3 天 = 1 年 = 12 个月
-  let startAgeYears = Math.floor(totalMonths / 12);
-  let startAgeMonths = Math.round(totalMonths % 12);
-  // 四舍五入到 12 个月时必须进位，否则显示「X 岁 12 个月起运」
-  if (startAgeMonths >= 12) { startAgeMonths -= 12; startAgeYears += 1; }
-
-  const dayun = [];
-  for (let i = 1; i <= 8; i++) {
-    const idx = (((monthIdx + (forward ? i : -i)) % 60) + 60) % 60;
-    const g = ganzhiName(idx);
-    dayun.push({
-      step: i,
-      startAge: startAgeYears + (i - 1) * 10,
-      ganzhi: g.name,
-      stem: g.stem,
-      branch: g.branch,
-      stemTenGod: tenGod(dayStem, g.stem),
-      nayin: nayin(idx),
-    });
-  }
-
-  // 流年（默认从「今年」起排 10 年；传 input.nowYear 可钉死基准年，用于复现历史结论）
-  const thisYear = Number(input.nowYear) || new Date().getFullYear();
-  const liunian = [];
-  for (let y = thisYear; y < thisYear + 10; y++) {
-    const idx = (((y - 4) % 60) + 60) % 60;
-    liunian.push({
-      year: y,
-      age: y - solarYear + 1,
-      ganzhi: ganzhiName(idx).name,
-      stemTenGod: tenGod(dayStem, ganzhiName(idx).stem),
-    });
-  }
-
-  // 五行统计（天干 1.0；地支藏干按 WUXING_HIDDEN_WEIGHT）
-  const wuxing = { 木: 0, 火: 0, 土: 0, 金: 0, 水: 0 };
-  for (const p of Object.values(pillars)) {
-    wuxing[p.stemElement] += 1;
-    p.hidden.forEach((h, i) => {
-      wuxing[h.element] += WUXING_HIDDEN_WEIGHT[i] ?? 0.1;
-    });
-  }
-  for (const k of Object.keys(wuxing)) wuxing[k] = Math.round(wuxing[k] * 10) / 10;
-
-  // 旬空（以日柱所在旬）
-  const xunStart = Math.floor(dayIdx / 10) * 10;
-  const kongwang = [
-    BRANCHES[(xunStart + 10) % 12],
-    BRANCHES[(xunStart + 11) % 12],
-  ];
-
-  // ── 十二长生、各柱空亡、神煞 ──────────────────────────────
-  const CHANGSHENG = ['长生', '沐浴', '冠带', '临官', '帝旺', '衰', '病', '死', '墓', '绝', '胎', '养'];
-  const CS_START = { 甲: 11, 乙: 6, 丙: 2, 丁: 9, 戊: 2, 己: 9, 庚: 5, 辛: 0, 壬: 8, 癸: 3 };
-  const isYang = (s) => STEMS.indexOf(s) % 2 === 0;
-
-  function changsheng(stem, branch) {
-    const start = CS_START[stem];
-    const bi = BRANCHES.indexOf(branch);
-    const step = isYang(stem) ? bi - start : start - bi;
-    return CHANGSHENG[((step % 12) + 12) % 12];
-  }
-
-  function xunKong(ganzhi) {
-    const idx = sexagenaryIndex(STEMS.indexOf(ganzhi[0]), BRANCHES.indexOf(ganzhi[1]));
-    const start = Math.floor(idx / 10) * 10;
-    return [BRANCHES[(start + 10) % 12], BRANCHES[(start + 11) % 12]];
-  }
-
-  const monthBranch = pillars.month.branch;
-
-  // 神煞：表驱动、双查法（年干/日干、年支/日支、月支、日柱、时柱），详见 engine/shensha.js
-  const shensha = computeBaziShensha(pillars, kongwang);
-
-  for (const key of ['year', 'month', 'day', 'hour']) {
-    const pl = pillars[key];
-    pl.dishi = changsheng(dayStem, pl.branch);
-    pl.zizuo = changsheng(pl.stem, pl.branch);
-    pl.kongwang = xunKong(pl.ganzhi);
-    // shensha 保持字符串数组以兼容既有 UI / 测试；明细见 shenshaDetail
-    pl.shensha = shensha.detail[key].map((x) => x.name);
-    pl.shenshaDetail = shensha.detail[key];
-  }
-
-  // ── 日主旺衰（月令 + 通根 + 天干帮扶，量化但规则透明）──
-  const SEASON_EL = { 寅: '木', 卯: '木', 巳: '火', 午: '火', 申: '金', 酉: '金', 亥: '水', 子: '水', 辰: '土', 戌: '土', 丑: '土', 未: '土' };
-  const me = STEM_ELEMENT[dayStem];
-  const seasonEl = SEASON_EL[monthBranch];
-  let monthW;
-  let monthWord;
-  if (me === seasonEl) { monthW = 3; monthWord = '旺'; }
-  else if (GENERATES[seasonEl] === me) { monthW = 2; monthWord = '相'; }
-  else if (GENERATES[me] === seasonEl) { monthW = 1; monthWord = '休'; }
-  else if (OVERCOMES[me] === seasonEl) { monthW = 0.5; monthWord = '囚'; }
-  else { monthW = 0; monthWord = '死'; }
-
-  let rootScore = 0;
-  const rootBranches = [];
-  for (const key of ['year', 'month', 'day', 'hour']) {
-    const pl = pillars[key];
-    let hit = false;
-    pl.hidden.forEach((h, i) => {
-      if (STEM_ELEMENT[h.stem] === me) { rootScore += ROOT_HIDDEN_WEIGHT[i] ?? 0.1; hit = true; }
-      else if (GENERATES[STEM_ELEMENT[h.stem]] === me) { rootScore += (ROOT_HIDDEN_WEIGHT[i] ?? 0.1) * 0.4; hit = true; }
-    });
-    if (hit) rootBranches.push(pl.branch);
-  }
-
-  let helpScore = 0;
-  const helpers = [];
-  const drainers = [];
-  for (const key of ['year', 'month', 'hour']) {
-    const st = pillars[key].stem;
-    const el2 = STEM_ELEMENT[st];
-    if (el2 === me) { helpScore += 1; helpers.push(st); }
-    else if (GENERATES[el2] === me) { helpScore += 0.8; helpers.push(st); }
-    else if (OVERCOMES[el2] === me) { helpScore -= 1; drainers.push(st); }
-    else if (OVERCOMES[me] === el2) { helpScore -= 0.8; drainers.push(st); }
-    else { helpScore -= 0.5; drainers.push(st); }
-  }
-
-  const total = Math.round((monthW + rootScore + helpScore) * 10) / 10;
-  const level = total >= 4 ? '身强' : total >= 2.5 ? '偏强' : total >= 1.5 ? '中和' : total >= 0.5 ? '偏弱' : '身弱';
-  const strength = {
-    level,
-    score: total,
-    detail: `月令${monthBranch}${seasonEl}，日主${me}${monthWord}(${monthW})；通根${rootBranches.join('') || '无'}(${rootScore.toFixed(1)})；天干帮扶${helpers.join('') || '无'}／耗泄${drainers.join('') || '无'}(${helpScore.toFixed(1)})`,
-    method: '月令权重 3/2/1/0.5/0 + 地支藏干通根 + 天干帮扶，量化后分档；属简化算法，非唯一流派',
-    parts: {
-      season: { branch: monthBranch, element: seasonEl, word: monthWord, weight: monthW },
-      roots: rootBranches,
-      rootScore: Math.round(rootScore * 10) / 10,
-      helpers,
-      drainers,
-      helpScore: Math.round(helpScore * 10) / 10,
-    },
-  };
-
-  // ── 格局 / 用神 / 行运 ─────────────────────────────────────
-  const frame = analyzeBaziFrame({ pillars, dayStem, monthBranch, strength, wuxing });
-
-  // ── 大运/流年与原局的地支关系 ──
-  const pairRel = (a, b) => {
-    if (!a || !b) return [];
-    // 大运/流年支与原局同支：辰午酉亥为自刑，其余同支不算关系
-    if (a === b) return XING_SELF.includes(a) ? ['自刑'] : [];
-    const out = [];
-    if (BRANCH_HE[a + b] || BRANCH_HE[b + a]) out.push('合');
-    if (hasPair(BRANCH_CHONG, a, b)) out.push('冲');
-    if (hasPair(BRANCH_HAI, a, b)) out.push('害');
-    if (hasPair(BRANCH_PO, a, b)) out.push('破');
-    for (const g of XING_GROUPS) if (g.includes(a) && g.includes(b)) out.push('刑');
-    return out;
-  };
-  const natalBranches = ['year', 'month', 'day', 'hour'].map((k) => pillars[k].branch);
-  const relOf = (branch) => {
-    const seen = new Set();
-    const out = [];
-    for (const b of natalBranches) {
-      for (const r of pairRel(b, branch)) {
-        const t = r + b;
-        if (!seen.has(t)) { seen.add(t); out.push(t); }
-      }
-    }
-    return out;
-  };
-  for (const d of dayun) {
-    d.relations = relOf(d.branch);
-    d.luck = scoreLuck(d.ganzhi, frame);
-  }
-  for (const l of liunian) {
-    l.relations = relOf(l.ganzhi[1]);
-    l.luck = scoreLuck(l.ganzhi, frame);
-  }
-
-  const p = jdToParts(jd);
-
-  // ── 胎元 / 命宫 / 身宫 ──
-  // 胎元：月柱天干进一位、地支进三位（受胎之月的干支）
-  const mStemIdx = STEMS.indexOf(pillars.month.stem);
-  const mBranchIdx = BRANCHES.indexOf(pillars.month.branch);
-  const taiyuan = ganzhiName(sexagenaryIndex((mStemIdx + 1) % 10, (mBranchIdx + 3) % 12));
-  // 命宫：以子月起正月顺数至生月，再自该宫起子时逆数至生时
-  const hourBrIdxForGong = BRANCHES.indexOf(pillars.hour.branch);
-  const soulIdx = (((mBranchIdx - hourBrIdxForGong) % 12) + 12) % 12;
-  // 命宫天干按五虎遁从年干起（寅为正月）
-  const yinStem = ((STEMS.indexOf(pillars.year.stem) % 5) * 2 + 2) % 10;
-  const soulStemIdx = (yinStem + ((soulIdx - 2 + 12) % 12)) % 10;
-  const minggong = ganzhiName(sexagenaryIndex(soulStemIdx, soulIdx));
-  // 身宫：命宫对宫（相隔六位）
-  const bodyIdx = (soulIdx + 6) % 12;
-  const bodyStemIdx = (yinStem + ((bodyIdx - 2 + 12) % 12)) % 10;
-  const shengong = ganzhiName(sexagenaryIndex(bodyStemIdx, bodyIdx));
-
-  return {
-    system: 'bazi',
-    relations: buildRelations(pillars),
-    palaces: {
-      taiyuan: { ganzhi: taiyuan.name, note: '月干进一、月支进三' },
-      minggong: { ganzhi: minggong.name, branch: minggong.branch, note: '子月起正月顺数至生月，再逆数至生时；干按五虎遁' },
-      shengong: { ganzhi: shengong.name, branch: shengong.branch, note: '命宫对宫' },
-    },
-    input: {
-      civil: { year, month, day, hour, minute },
-      gender,
-      longitude: longitude ?? null,
-      address: input.address || null,
-      geo,
-      lateZi,
-      trueSolar: useTrueSolar,
-    },
-    solarTime: {
-      civilText: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')} ${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}`,
-      trueSolarText: formatJd(jd),
-      offsetMinutes: solar.offsetMinutes,
-      note: solar.note,
-      lunarYearForPillar: solarYear,
-    },
-    jieqi: {
-      previous: { name: prevJieTerm.name, time: formatJd(prevJieTerm.jd) },
-      next: { name: nextJieTerm.name, time: formatJd(nextJieTerm.jd) },
-      // 距「节」的分钟数（取两侧较小值）。是否提示复核由摘要层决定，阈值 20 分钟：
-      // 与 NAOJ 历要项对拍实测节气最多偏 13.5 分钟，20 分钟留出余量。
-      nearBoundaryMinutes: Math.round(Math.min(jd - prevJieTerm.jd, nextJieTerm.jd - jd) * 1440),
-    },
-    pillars,
-    dayMaster: { stem: dayStem, element: STEM_ELEMENT[dayStem], yinYang: isYangStem(dayStem) ? '阳' : '阴' },
-    wuxing,
-    kongwang,
-    shensha,
-    dayun: {
-      direction: forward ? '顺行' : '逆行',
-      rule: `${isYangYear ? '阳' : '阴'}年${gender === 'male' ? '男' : '女'}${forward ? '顺排' : '逆排'}`,
-      startAge: { years: startAgeYears, months: startAgeMonths },
-      toNextJieDays: Math.round(spanDays * 100) / 100,
-      list: dayun,
-    },
-    strength,
-    frame,
-    liunian,
-    liunianFrom: thisYear,
-  };
-}
+// 四柱八字引擎
+import {
+  STEMS, BRANCHES, TERM_NAMES,
+  ganzhiName, dayGanzhiIndex, jdToParts, partsToJd, sexagenaryIndex,
+  termWindow, previousJie, nextJie, equationOfTime, formatJd, xunKongOf,
+} from './calendar.js';
+import { resolveAddress } from './geo.js';
+import { computeBaziShensha } from './shensha.js';
+import { assertCivil } from './validate.js';
+import { nayinOf } from './nayin.js';
+import { SANHE } from './sanhe.js';
+import { analyzeBaziFrame, scoreLuck } from './geju.js';
+
+// 地支藏干（本气 / 中气 / 余气）
+export const HIDDEN_STEMS = {
+  子: ['癸'],
+  丑: ['己', '癸', '辛'],
+  寅: ['甲', '丙', '戊'],
+  卯: ['乙'],
+  辰: ['戊', '乙', '癸'],
+  巳: ['丙', '戊', '庚'],
+  午: ['丁', '己'],
+  未: ['己', '丁', '乙'],
+  申: ['庚', '壬', '戊'],
+  酉: ['辛'],
+  戌: ['戊', '辛', '丁'],
+  亥: ['壬', '甲'],
+};
+
+export const STEM_ELEMENT = {
+  甲: '木', 乙: '木', 丙: '火', 丁: '火', 戊: '土',
+  己: '土', 庚: '金', 辛: '金', 壬: '水', 癸: '水',
+};
+
+export const BRANCH_ELEMENT = {
+  子: '水', 丑: '土', 寅: '木', 卯: '木', 辰: '土', 巳: '火',
+  午: '火', 未: '土', 申: '金', 酉: '金', 戌: '土', 亥: '水',
+};
+
+const GENERATES = { 木: '火', 火: '土', 土: '金', 金: '水', 水: '木' };
+const OVERCOMES = { 木: '土', 土: '水', 水: '火', 火: '金', 金: '木' };
+
+const isYangStem = (stem) => STEMS.indexOf(stem) % 2 === 0;
+
+// 两套藏干权重是不同用途，不是"同一件事写了两次"：
+//   · 五行占比——看这一行在盘里有多少，本气 1 / 中气 0.5 / 余气 0.3；
+//   · 日主通根——看这一支能不能让日主站住，本气权重更高（1.2 / 0.6 / 0.3）。
+const WUXING_HIDDEN_WEIGHT = [1, 0.5, 0.3];
+const ROOT_HIDDEN_WEIGHT = [1.2, 0.6, 0.3];
+
+const STEM_HE = { 甲己: '土', 乙庚: '金', 丙辛: '水', 丁壬: '木', 戊癸: '火' };
+const STEM_CHONG_PAIRS = ['甲庚', '乙辛', '丙壬', '丁癸'];
+const BRANCH_HE = { 子丑: '土', 寅亥: '木', 卯戌: '火', 辰酉: '金', 巳申: '水', 午未: '土' };
+const SANHUI = { 寅卯辰: '木', 巳午未: '火', 申酉戌: '金', 亥子丑: '水' };
+const BRANCH_CHONG = ['子午', '丑未', '寅申', '卯酉', '辰戌', '巳亥'];
+const BRANCH_HAI = ['子未', '丑午', '寅巳', '卯辰', '申亥', '酉戌'];
+const BRANCH_PO = ['子酉', '丑辰', '寅亥', '卯午', '巳申', '未戌'];
+// 三刑：寅巳申（无恩之刑）、丑戌未（恃势之刑）、子卯（无礼之刑）。
+// 另有「自刑」：辰午酉亥四支见同支即自刑（辰辰、午午、酉酉、亥亥），此前漏判。
+const XING_GROUPS = [['寅', '巳', '申'], ['丑', '戌', '未'], ['子', '卯']];
+const XING_SELF = ['辰', '午', '酉', '亥'];
+
+const hasPair = (list, a, b) => list.includes(a + b) || list.includes(b + a);
+
+/** 干支关系：五合、相冲、相克；六合、三合半合、三会半会拱会、冲、害、破、刑 */
+export function buildRelations(pillars) {
+  const stems = ['year', 'month', 'day', 'hour'].map((k) => pillars[k].stem);
+  const branches = ['year', 'month', 'day', 'hour'].map((k) => pillars[k].branch);
+
+  const stemOut = [];
+  for (let i = 0; i < 4; i++) {
+    for (let j = i + 1; j < 4; j++) {
+      const a = stems[i];
+      const b = stems[j];
+      if (a === b) continue;
+      const he = STEM_HE[a + b] || STEM_HE[b + a];
+      if (he) { stemOut.push({ text: `${a}${b}合化${he}`, rank: 0 }); continue; }
+      if (hasPair(STEM_CHONG_PAIRS, a, b)) { stemOut.push({ text: `${a}${b}相冲`, rank: 1 }); continue; }
+      const ea = STEM_ELEMENT[a];
+      const eb = STEM_ELEMENT[b];
+      if (OVERCOMES[ea] === eb) stemOut.push({ text: `${a}克${b}`, rank: 3 });
+      else if (OVERCOMES[eb] === ea) stemOut.push({ text: `${b}克${a}`, rank: 3 });
+    }
+  }
+
+  const branchOut = [];
+  const set = new Set(branches);
+  const fullSans = [];
+  for (const [k, v] of Object.entries(SANHE)) {
+    if ([...k].every((c) => set.has(c))) {
+      branchOut.push({ text: `${k}三合${v}`, rank: 0 });
+      fullSans.push(k);
+    }
+  }
+  const fullHuis = [];
+  for (const [k, v] of Object.entries(SANHUI)) {
+    if ([...k].every((c) => set.has(c))) {
+      branchOut.push({ text: `${k}三会${v}`, rank: 0 });
+      fullHuis.push(k);
+    }
+  }
+  for (let i = 0; i < 4; i++) {
+    for (let j = i + 1; j < 4; j++) {
+      const a = branches[i];
+      const b = branches[j];
+      if (a === b) {
+        // 同支不是"没关系"：辰午酉亥两柱同见为自刑
+        if (XING_SELF.includes(a)) branchOut.push({ text: `${a}${b}自刑`, rank: 2 });
+        continue;
+      }
+      const he = BRANCH_HE[a + b] || BRANCH_HE[b + a];
+      const sh = Object.keys(SANHE).find((k) => k.includes(a) && k.includes(b));
+      const hui = Object.keys(SANHUI).find((k) => k.includes(a) && k.includes(b));
+      if (he) {
+        // 六合优先，不再重复标半合/半会
+        branchOut.push({ text: `${a}${b}合${he}`, rank: 0 });
+      } else {
+        if (sh && !fullSans.includes(sh)) {
+          const mid = sh[1];
+          const kind = a === mid || b === mid ? '半合' : '拱合';
+          branchOut.push({ text: `${a}${b}${kind}${SANHE[sh]}`, rank: 0 });
+        }
+        if (hui && !fullHuis.includes(hui)) {
+          const adj = Math.abs(hui.indexOf(a) - hui.indexOf(b)) === 1;
+          branchOut.push({ text: `${a}${b}${adj ? '半会' : '拱会'}${SANHUI[hui]}`, rank: 0 });
+        }
+      }
+      if (hasPair(BRANCH_CHONG, a, b)) branchOut.push({ text: `${a}${b}相冲`, rank: 1 });
+      if (hasPair(BRANCH_HAI, a, b)) branchOut.push({ text: `${a}${b}相害`, rank: 2 });
+      if (hasPair(BRANCH_PO, a, b)) branchOut.push({ text: `${a}${b}相破`, rank: 2 });
+      for (const g of XING_GROUPS) {
+        if (g.includes(a) && g.includes(b)) branchOut.push({ text: `${a}${b}相刑`, rank: 2 });
+      }
+    }
+  }
+
+  const uniq = (arr) => {
+    const seen = new Set();
+    const out = [];
+    for (const x of [...arr].sort((p, q) => p.rank - q.rank)) {
+      if (!seen.has(x.text)) { seen.add(x.text); out.push(x.text); }
+    }
+    return out;
+  };
+  return { stems: uniq(stemOut), branches: uniq(branchOut) };
+}
+
+/** 十神：以日干为我 */
+export function tenGod(dayStem, otherStem) {
+  const me = STEM_ELEMENT[dayStem];
+  const it = STEM_ELEMENT[otherStem];
+  const samePolarity = isYangStem(dayStem) === isYangStem(otherStem);
+  if (me === it) return samePolarity ? '比肩' : '劫财';
+  if (GENERATES[me] === it) return samePolarity ? '食神' : '伤官';
+  if (OVERCOMES[me] === it) return samePolarity ? '偏财' : '正财';
+  if (OVERCOMES[it] === me) return samePolarity ? '七杀' : '正官';
+  if (GENERATES[it] === me) return samePolarity ? '偏印' : '正印';
+  return '?';
+}
+
+export function nayin(ganzhiIdx) {
+  return nayinOf(ganzhiIdx).name;
+}
+
+const JIE_TO_MONTH_BRANCH = { 0: 1, 2: 2, 4: 3, 6: 4, 8: 5, 10: 6, 12: 7, 14: 8, 16: 9, 18: 10, 20: 11, 22: 0 };
+
+function pillar(ganzhiIdx, dayStem) {
+  const g = ganzhiName(ganzhiIdx);
+  const hidden = HIDDEN_STEMS[g.branch];
+  return {
+    ganzhi: g.name,
+    stem: g.stem,
+    branch: g.branch,
+    stemElement: STEM_ELEMENT[g.stem],
+    branchElement: BRANCH_ELEMENT[g.branch],
+    stemTenGod: dayStem ? tenGod(dayStem, g.stem) : null,
+    hidden: hidden.map((s, i) => ({
+      stem: s,
+      element: STEM_ELEMENT[s],
+      tenGod: dayStem ? tenGod(dayStem, s) : null,
+      role: ['本气', '中气', '余气'][i] ?? '余气',
+    })),
+    nayin: nayin(ganzhiIdx),
+  };
+}
+
+/**
+ * 真太阳时修正
+ * @returns {{offsetMinutes:number, jd:number, note:string}}
+ */
+export function applyTrueSolar(jd, longitude) {
+  const p = jdToParts(jd);
+  if (longitude == null || Number.isNaN(longitude)) {
+    return { offsetMinutes: 0, jd, note: '未提供经度，按东八区平太阳时' };
+  }
+  const longitudeMinutes = (longitude - 120) * 4;
+  const eot = equationOfTime(p.year, p.month, p.day);
+  const offset = longitudeMinutes + eot;
+  return {
+    offsetMinutes: Math.round(offset * 10) / 10,
+    jd: jd + offset / 1440,
+    note: `经度差 ${longitudeMinutes.toFixed(1)} 分 + 均时差 ${eot.toFixed(1)} 分`,
+  };
+}
+
+/**
+ * 排四柱八字
+ * @param {object} input { year,month,day,hour,minute, gender:'male'|'female', longitude?, lateZi?:boolean, trueSolar?:boolean }
+ */
+export function buildBazi(input) {
+  assertCivil(input);
+  const { year, month, day, hour = 0, minute = 0, gender = 'male' } = input;
+  const lateZi = input.lateZi !== false;
+  const useTrueSolar = input.trueSolar !== false;
+
+  const civilJd = partsToJd({ year, month, day, hour, minute });
+  // 地址 -> 经度：手填的 longitude 优先，其次按地址查表
+  const geo = input.geo || (input.address ? resolveAddress(input.address) : null);
+  const longitude = typeof input.longitude === 'number'
+    ? input.longitude
+    : (geo && typeof geo.lon === 'number' ? geo.lon : undefined);
+  const solar = useTrueSolar ? applyTrueSolar(civilJd, longitude) : { offsetMinutes: 0, jd: civilJd, note: '未启用真太阳时' };
+  const jd = solar.jd;
+
+  // 八字只用「节」定月柱与起运（气不参与），传 jieOnly 省掉一半节气求值
+  const terms = termWindow(year, { jieOnly: true });
+  const prevJieTerm = previousJie(terms, jd);
+  const nextJieTerm = nextJie(terms, jd);
+
+  // 年柱：以立春为界
+  const lichun = terms.find((t) => t.index === 2 && t.year === year);
+  const solarYear = lichun && jd < lichun.jd ? year - 1 : year;
+  const yearIdx = (((solarYear - 4) % 60) + 60) % 60;
+  const yearStem = STEMS[yearIdx % 10];
+
+  // 月柱：以「节」为界
+  const monthBranchIdx = JIE_TO_MONTH_BRANCH[prevJieTerm.index];
+  const yinMonthStem = ((STEMS.indexOf(yearStem) % 5) * 2 + 2) % 10;
+  const monthOffset = ((monthBranchIdx - 2) % 12 + 12) % 12; // 0 = 寅月
+  const monthStemIdx = (yinMonthStem + monthOffset) % 10;
+  const monthIdx = sexagenaryIndex(monthStemIdx, monthBranchIdx);
+
+  // 日柱：23:00 后是否换日
+  const jdnBase = Math.floor(jd + 0.5);
+  const hourOfDay = jdToParts(jd).hour;
+  const jdn = lateZi && hourOfDay >= 23 ? jdnBase + 1 : jdnBase;
+  const dayIdx = dayGanzhiIndex(jdn);
+  const dayStem = STEMS[dayIdx % 10];
+
+  // 时柱：五鼠遁
+  const hourBranchIdx = Math.floor(((hourOfDay + 1) % 24) / 2);
+  const ziHourStem = ((STEMS.indexOf(dayStem) % 5) * 2) % 10;
+  const hourStemIdx = (ziHourStem + hourBranchIdx) % 10;
+  const hourIdx = sexagenaryIndex(hourStemIdx, hourBranchIdx);
+
+  const pillars = {
+    year: pillar(yearIdx, dayStem),
+    month: pillar(monthIdx, dayStem),
+    day: pillar(dayIdx, dayStem),
+    hour: pillar(hourIdx, dayStem),
+  };
+
+  // 大运
+  const isYangYear = STEMS.indexOf(yearStem) % 2 === 0;
+  const forward = (isYangYear && gender === 'male') || (!isYangYear && gender === 'female');
+  const spanDays = forward ? nextJieTerm.jd - jd : jd - prevJieTerm.jd;
+  const totalMonths = spanDays * 4; // 3 天 = 1 年 = 12 个月
+  let startAgeYears = Math.floor(totalMonths / 12);
+  let startAgeMonths = Math.round(totalMonths % 12);
+  // 四舍五入到 12 个月时必须进位，否则显示「X 岁 12 个月起运」
+  if (startAgeMonths >= 12) { startAgeMonths -= 12; startAgeYears += 1; }
+
+  const dayun = [];
+  for (let i = 1; i <= 8; i++) {
+    const idx = (((monthIdx + (forward ? i : -i)) % 60) + 60) % 60;
+    const g = ganzhiName(idx);
+    dayun.push({
+      step: i,
+      startAge: startAgeYears + (i - 1) * 10,
+      ganzhi: g.name,
+      stem: g.stem,
+      branch: g.branch,
+      stemTenGod: tenGod(dayStem, g.stem),
+      nayin: nayin(idx),
+    });
+  }
+
+  // 流年（默认从「今年」起排 10 年；传 input.nowYear 可钉死基准年，用于复现历史结论）
+  const thisYear = Number(input.nowYear) || new Date().getFullYear();
+  const liunian = [];
+  for (let y = thisYear; y < thisYear + 10; y++) {
+    const idx = (((y - 4) % 60) + 60) % 60;
+    liunian.push({
+      year: y,
+      age: y - solarYear + 1,
+      ganzhi: ganzhiName(idx).name,
+      stemTenGod: tenGod(dayStem, ganzhiName(idx).stem),
+    });
+  }
+
+  // 五行统计（天干 1.0；地支藏干按 WUXING_HIDDEN_WEIGHT）
+  const wuxing = { 木: 0, 火: 0, 土: 0, 金: 0, 水: 0 };
+  for (const p of Object.values(pillars)) {
+    wuxing[p.stemElement] += 1;
+    p.hidden.forEach((h, i) => {
+      wuxing[h.element] += WUXING_HIDDEN_WEIGHT[i] ?? 0.1;
+    });
+  }
+  for (const k of Object.keys(wuxing)) wuxing[k] = Math.round(wuxing[k] * 10) / 10;
+
+  // 旬空（以日柱所在旬）
+  const xunStart = Math.floor(dayIdx / 10) * 10;
+  const kongwang = [
+    BRANCHES[(xunStart + 10) % 12],
+    BRANCHES[(xunStart + 11) % 12],
+  ];
+
+  // ── 十二长生、各柱空亡、神煞 ──────────────────────────────
+  const CHANGSHENG = ['长生', '沐浴', '冠带', '临官', '帝旺', '衰', '病', '死', '墓', '绝', '胎', '养'];
+  const CS_START = { 甲: 11, 乙: 6, 丙: 2, 丁: 9, 戊: 2, 己: 9, 庚: 5, 辛: 0, 壬: 8, 癸: 3 };
+  const isYang = (s) => STEMS.indexOf(s) % 2 === 0;
+
+  function changsheng(stem, branch) {
+    const start = CS_START[stem];
+    const bi = BRANCHES.indexOf(branch);
+    const step = isYang(stem) ? bi - start : start - bi;
+    return CHANGSHENG[((step % 12) + 12) % 12];
+  }
+
+  // 旬空统一走 calendar.xunKongOf：此前 bazi / liuyao / daliuren 各写一份公式，
+  // 三份形式不同（一处用 (start+10)%12、一处用 (10-2k)%12、一处查表），改一处极易漏改另两处。
+  const monthBranch = pillars.month.branch;
+
+  // 神煞：表驱动、双查法（年干/日干、年支/日支、月支、日柱、时柱），详见 engine/shensha.js
+  const shensha = computeBaziShensha(pillars, kongwang);
+
+  for (const key of ['year', 'month', 'day', 'hour']) {
+    const pl = pillars[key];
+    pl.dishi = changsheng(dayStem, pl.branch);
+    pl.zizuo = changsheng(pl.stem, pl.branch);
+    pl.kongwang = xunKongOf(pl.ganzhi);
+    // shensha 保持字符串数组以兼容既有 UI / 测试；明细见 shenshaDetail
+    pl.shensha = shensha.detail[key].map((x) => x.name);
+    pl.shenshaDetail = shensha.detail[key];
+  }
+
+  // ── 日主旺衰（月令 + 通根 + 天干帮扶，量化但规则透明）──
+  const SEASON_EL = { 寅: '木', 卯: '木', 巳: '火', 午: '火', 申: '金', 酉: '金', 亥: '水', 子: '水', 辰: '土', 戌: '土', 丑: '土', 未: '土' };
+  const me = STEM_ELEMENT[dayStem];
+  const seasonEl = SEASON_EL[monthBranch];
+  let monthW;
+  let monthWord;
+  if (me === seasonEl) { monthW = 3; monthWord = '旺'; }
+  else if (GENERATES[seasonEl] === me) { monthW = 2; monthWord = '相'; }
+  else if (GENERATES[me] === seasonEl) { monthW = 1; monthWord = '休'; }
+  else if (OVERCOMES[me] === seasonEl) { monthW = 0.5; monthWord = '囚'; }
+  else { monthW = 0; monthWord = '死'; }
+
+  let rootScore = 0;
+  const rootBranches = [];
+  for (const key of ['year', 'month', 'day', 'hour']) {
+    const pl = pillars[key];
+    let hit = false;
+    pl.hidden.forEach((h, i) => {
+      if (STEM_ELEMENT[h.stem] === me) { rootScore += ROOT_HIDDEN_WEIGHT[i] ?? 0.1; hit = true; }
+      else if (GENERATES[STEM_ELEMENT[h.stem]] === me) { rootScore += (ROOT_HIDDEN_WEIGHT[i] ?? 0.1) * 0.4; hit = true; }
+    });
+    if (hit) rootBranches.push(pl.branch);
+  }
+
+  let helpScore = 0;
+  const helpers = [];
+  const drainers = [];
+  for (const key of ['year', 'month', 'hour']) {
+    const st = pillars[key].stem;
+    const el2 = STEM_ELEMENT[st];
+    if (el2 === me) { helpScore += 1; helpers.push(st); }
+    else if (GENERATES[el2] === me) { helpScore += 0.8; helpers.push(st); }
+    else if (OVERCOMES[el2] === me) { helpScore -= 1; drainers.push(st); }
+    else if (OVERCOMES[me] === el2) { helpScore -= 0.8; drainers.push(st); }
+    else { helpScore -= 0.5; drainers.push(st); }
+  }
+
+  const total = Math.round((monthW + rootScore + helpScore) * 10) / 10;
+  const level = total >= 4 ? '身强' : total >= 2.5 ? '偏强' : total >= 1.5 ? '中和' : total >= 0.5 ? '偏弱' : '身弱';
+  const strength = {
+    level,
+    score: total,
+    detail: `月令${monthBranch}${seasonEl}，日主${me}${monthWord}(${monthW})；通根${rootBranches.join('') || '无'}(${rootScore.toFixed(1)})；天干帮扶${helpers.join('') || '无'}／耗泄${drainers.join('') || '无'}(${helpScore.toFixed(1)})`,
+    method: '月令权重 3/2/1/0.5/0 + 地支藏干通根 + 天干帮扶，量化后分档；属简化算法，非唯一流派',
+    parts: {
+      season: { branch: monthBranch, element: seasonEl, word: monthWord, weight: monthW },
+      roots: rootBranches,
+      rootScore: Math.round(rootScore * 10) / 10,
+      helpers,
+      drainers,
+      helpScore: Math.round(helpScore * 10) / 10,
+    },
+  };
+
+  // ── 格局 / 用神 / 行运 ─────────────────────────────────────
+  const frame = analyzeBaziFrame({ pillars, dayStem, monthBranch, strength, wuxing });
+
+  // ── 大运/流年与原局的地支关系 ──
+  const pairRel = (a, b) => {
+    if (!a || !b) return [];
+    // 大运/流年支与原局同支：辰午酉亥为自刑，其余同支不算关系
+    if (a === b) return XING_SELF.includes(a) ? ['自刑'] : [];
+    const out = [];
+    if (BRANCH_HE[a + b] || BRANCH_HE[b + a]) out.push('合');
+    if (hasPair(BRANCH_CHONG, a, b)) out.push('冲');
+    if (hasPair(BRANCH_HAI, a, b)) out.push('害');
+    if (hasPair(BRANCH_PO, a, b)) out.push('破');
+    for (const g of XING_GROUPS) if (g.includes(a) && g.includes(b)) out.push('刑');
+    return out;
+  };
+  const natalBranches = ['year', 'month', 'day', 'hour'].map((k) => pillars[k].branch);
+  const relOf = (branch) => {
+    const seen = new Set();
+    const out = [];
+    for (const b of natalBranches) {
+      for (const r of pairRel(b, branch)) {
+        const t = r + b;
+        if (!seen.has(t)) { seen.add(t); out.push(t); }
+      }
+    }
+    return out;
+  };
+  for (const d of dayun) {
+    d.relations = relOf(d.branch);
+    d.luck = scoreLuck(d.ganzhi, frame);
+  }
+  for (const l of liunian) {
+    l.relations = relOf(l.ganzhi[1]);
+    l.luck = scoreLuck(l.ganzhi, frame);
+  }
+
+  const p = jdToParts(jd);
+
+  // ── 胎元 / 命宫 / 身宫 ──
+  // 胎元：月柱天干进一位、地支进三位（受胎之月的干支）
+  const mStemIdx = STEMS.indexOf(pillars.month.stem);
+  const mBranchIdx = BRANCHES.indexOf(pillars.month.branch);
+  const taiyuan = ganzhiName(sexagenaryIndex((mStemIdx + 1) % 10, (mBranchIdx + 3) % 12));
+  // 命宫：以子月起正月顺数至生月，再自该宫起子时逆数至生时
+  const hourBrIdxForGong = BRANCHES.indexOf(pillars.hour.branch);
+  const soulIdx = (((mBranchIdx - hourBrIdxForGong) % 12) + 12) % 12;
+  // 命宫天干按五虎遁从年干起（寅为正月）
+  const yinStem = ((STEMS.indexOf(pillars.year.stem) % 5) * 2 + 2) % 10;
+  const soulStemIdx = (yinStem + ((soulIdx - 2 + 12) % 12)) % 10;
+  const minggong = ganzhiName(sexagenaryIndex(soulStemIdx, soulIdx));
+  // 身宫：命宫对宫（相隔六位）
+  const bodyIdx = (soulIdx + 6) % 12;
+  const bodyStemIdx = (yinStem + ((bodyIdx - 2 + 12) % 12)) % 10;
+  const shengong = ganzhiName(sexagenaryIndex(bodyStemIdx, bodyIdx));
+
+  return {
+    system: 'bazi',
+    relations: buildRelations(pillars),
+    palaces: {
+      taiyuan: { ganzhi: taiyuan.name, note: '月干进一、月支进三' },
+      minggong: { ganzhi: minggong.name, branch: minggong.branch, note: '子月起正月顺数至生月，再逆数至生时；干按五虎遁' },
+      shengong: { ganzhi: shengong.name, branch: shengong.branch, note: '命宫对宫' },
+    },
+    input: {
+      civil: { year, month, day, hour, minute },
+      gender,
+      longitude: longitude ?? null,
+      address: input.address || null,
+      geo,
+      lateZi,
+      trueSolar: useTrueSolar,
+    },
+    solarTime: {
+      civilText: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')} ${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}`,
+      trueSolarText: formatJd(jd),
+      offsetMinutes: solar.offsetMinutes,
+      note: solar.note,
+      lunarYearForPillar: solarYear,
+    },
+    jieqi: {
+      previous: { name: prevJieTerm.name, time: formatJd(prevJieTerm.jd) },
+      next: { name: nextJieTerm.name, time: formatJd(nextJieTerm.jd) },
+      // 距「节」的分钟数（取两侧较小值）。是否提示复核由摘要层决定，阈值 20 分钟：
+      // 与 NAOJ 历要项对拍实测节气最多偏 13.5 分钟，20 分钟留出余量。
+      nearBoundaryMinutes: Math.round(Math.min(jd - prevJieTerm.jd, nextJieTerm.jd - jd) * 1440),
+    },
+    pillars,
+    dayMaster: { stem: dayStem, element: STEM_ELEMENT[dayStem], yinYang: isYangStem(dayStem) ? '阳' : '阴' },
+    wuxing,
+    kongwang,
+    shensha,
+    dayun: {
+      direction: forward ? '顺行' : '逆行',
+      rule: `${isYangYear ? '阳' : '阴'}年${gender === 'male' ? '男' : '女'}${forward ? '顺排' : '逆排'}`,
+      startAge: { years: startAgeYears, months: startAgeMonths },
+      toNextJieDays: Math.round(spanDays * 100) / 100,
+      list: dayun,
+    },
+    strength,
+    frame,
+    liunian,
+    liunianFrom: thisYear,
+  };
+}