dsh-metaphysics 0.17.1 → 0.18.0

package/engine/fengshui.js

@@ -0,0 +1,288 @@
+// 风水：八宅命卦 + 大游年八星 + 年家紫白飞星 + 24 山门主灶布局倾向（纯本地确定性）。
+// 口径：大游年歌与 24 山归属为八宅通行口径，吉凶名词照传统转述；不做现场勘舆结论。
+// 参照公开通行表实现（与常见八宅/玄空入门资料一致），年紫白用纯公式，不依赖任何第三方历法库。
+import { partsToJd, termInstantJd } from './calendar.js';
+import { applyDst } from './dst.js';
+
+/** 九星名称表：数 → {name, color, element, star(北斗名), lucky}。 */
+export const NINE_STARS = {
+  1: { name: '一白', color: '白', element: '水', star: '贪狼', lucky: true },
+  2: { name: '二黑', color: '黑', element: '土', star: '巨门', lucky: false },
+  3: { name: '三碧', color: '碧', element: '木', star: '禄存', lucky: false },
+  4: { name: '四绿', color: '绿', element: '木', star: '文曲', lucky: true },
+  5: { name: '五黄', color: '黄', element: '土', star: '廉贞', lucky: false },
+  6: { name: '六白', color: '白', element: '金', star: '武曲', lucky: true },
+  7: { name: '七赤', color: '赤', element: '金', star: '破军', lucky: false },
+  8: { name: '八白', color: '白', element: '土', star: '左辅', lucky: true },
+  9: { name: '九紫', color: '紫', element: '火', star: '右弼', lucky: true },
+};
+
+/** 后天八卦 → 方位。 */
+export const PALACE_DIRECTION = {
+  坎: '正北', 艮: '东北', 震: '正东', 巽: '东南',
+  离: '正南', 坤: '西南', 兑: '正西', 乾: '西北',
+};
+
+/** 大游年歌：自本卦起，按「坎艮震巽离坤兑乾」循环顺数，数组为自卦后第 1–7 位。 */
+const YOUNIAN_ORDER = ['坎', '艮', '震', '巽', '离', '坤', '兑', '乾'];
+export const DAYOUTIAN = {
+  乾: ['六煞', '天医', '五鬼', '祸害', '绝命', '延年', '生气'],
+  坎: ['五鬼', '天医', '生气', '延年', '绝命', '祸害', '六煞'],
+  艮: ['六煞', '绝命', '祸害', '生气', '延年', '天医', '五鬼'],
+  震: ['延年', '生气', '祸害', '绝命', '五鬼', '天医', '六煞'],
+  巽: ['天医', '五鬼', '六煞', '祸害', '生气', '绝命', '延年'],
+  离: ['六煞', '五鬼', '绝命', '延年', '祸害', '生气', '天医'],
+  坤: ['天医', '延年', '绝命', '生气', '祸害', '五鬼', '六煞'],
+  兑: ['生气', '祸害', '延年', '绝命', '六煞', '五鬼', '天医'],
+};
+
+export const LUCKY_STARS = ['生气', '延年', '天医', '伏位'];
+export const UNLUCKY_STARS = ['绝命', '五鬼', '六煞', '祸害'];
+
+/** 24 山（周天 360° 每山 15°，自北顺时针）：山 → 后天八卦归属 + 中心度数（子山 = 0°）。 */
+export const MOUNTAINS_24 = [
+  { m: '壬', gua: '坎', deg: 345 }, { m: '子', gua: '坎', deg: 0 }, { m: '癸', gua: '坎', deg: 15 },
+  { m: '丑', gua: '艮', deg: 30 }, { m: '艮', gua: '艮', deg: 45 }, { m: '寅', gua: '艮', deg: 60 },
+  { m: '甲', gua: '震', deg: 75 }, { m: '卯', gua: '震', deg: 90 }, { m: '乙', gua: '震', deg: 105 },
+  { m: '辰', gua: '巽', deg: 120 }, { m: '巽', gua: '巽', deg: 135 }, { m: '巳', gua: '巽', deg: 150 },
+  { m: '丙', gua: '离', deg: 165 }, { m: '午', gua: '离', deg: 180 }, { m: '丁', gua: '离', deg: 195 },
+  { m: '未', gua: '坤', deg: 210 }, { m: '坤', gua: '坤', deg: 225 }, { m: '申', gua: '坤', deg: 240 },
+  { m: '庚', gua: '兑', deg: 255 }, { m: '酉', gua: '兑', deg: 270 }, { m: '辛', gua: '兑', deg: 285 },
+  { m: '戌', gua: '乾', deg: 300 }, { m: '乾', gua: '乾', deg: 315 }, { m: '亥', gua: '乾', deg: 330 },
+];
+
+const MOUNTAIN_INDEX = new Map(MOUNTAINS_24.map((x, i) => [x.m, i]));
+
+export function mountainInfo(name) {
+  const i = MOUNTAIN_INDEX.get(name);
+  if (i === undefined) {
+    throw new Error(`坐向必须是 24 山之一（${MOUNTAINS_24.map((x) => x.m).join('')}），收到「${name}」——请按罗盘 24 山报坐或报向，不要自造方位词。`);
+  }
+  return { ...MOUNTAINS_24[i], index: i };
+}
+
+export function sittingFromFacing(facing) {
+  const f = mountainInfo(facing);
+  const i = (f.index + 12) % 24;
+  return { ...MOUNTAINS_24[i], index: i };
+}
+
+const guaGroup = (gua) => (['坎', '离', '震', '巽'].includes(gua) ? '东四' : '西四');
+
+/** 八星 → 布局角色（门主灶厕各宜何星方）。 */
+export const STAR_LAYOUT_ROLE = {
+  生气: '大吉：最宜开门、主卧、灶口朝向',
+  延年: '大吉：宜开门、主卧（利感情与人缘）',
+  天医: '次吉：宜主卧、书房、老人房（利健康）',
+  伏位: '次吉：宜卧室、神位（主平稳）',
+  祸害: '小凶：宜厕所、储物间（宜静不宜动）',
+  六煞: '次凶：宜厕所、储物间',
+  五鬼: '大凶：宜厕所，或以灶坐压之（传统「火烧五鬼」说）',
+  绝命: '最凶：宜灶坐压之、储物，忌门床',
+};
+
+const GUA_BY_NUM = ['坎', '坤', '震', '巽', '中', '乾', '兑', '艮', '离'];
+
+/**
+ * 八宅命卦：按节气年（立春界）公元年后两位 n：
+ *   1900–1999：男 (100−n) ÷ 9 取余，女 (n−4) ÷ 9 取余；
+ *   2000–2099：男 (99−n) ÷ 9 取余，女 (n−3) ÷ 9 取余（负数加 9）。
+ * 余 0 作 9；余 5 男作坤、女作艮。数→卦：1坎 2坤 3震 4巽 6乾 7兑 8艮 9离。
+ */
+export function mingGua(birthYear, gender) {
+  const tail = ((birthYear % 100) + 100) % 100;
+  const century = birthYear >= 2000 ? { male: 99, female: 3 } : { male: 100, female: 4 };
+  const mod9 = (n) => { const r = ((n % 9) + 9) % 9; return r === 0 ? 9 : r; };
+  let num = gender === 'male' ? mod9(century.male - tail) : mod9(tail - century.female);
+  if (num === 5) num = gender === 'male' ? 2 : 8;
+  const gua = GUA_BY_NUM[num - 1];
+  if (gua === '中') throw new Error('命卦计算异常：落中宫');
+  return { num, gua, direction: PALACE_DIRECTION[gua] };
+}
+
+/** 大游年八星（含伏位=本卦）。 */
+export function eightStars(gua) {
+  const result = { 伏位: { palace: gua, direction: PALACE_DIRECTION[gua] } };
+  const start = YOUNIAN_ORDER.indexOf(gua);
+  for (let step = 1; step <= 7; step++) {
+    const palace = YOUNIAN_ORDER[(start + step) % 8];
+    result[DAYOUTIAN[gua][step - 1]] = { palace, direction: PALACE_DIRECTION[palace] };
+  }
+  return result;
+}
+
+/** 立春界节气年：生日在当年立春前 → 上一年（按正午判，与黄历一致）。 */
+export function guaYearOf(year, month, day) {
+  const birthJd = partsToJd({ year, month, day, hour: 12, minute: 0 });
+  return birthJd < termInstantJd(year, 2) ? year - 1 : year;
+}
+
+/**
+ * 年紫白入中之星（1–9）：锚点 2026 丙午 = 一白，逐年退一位，九年一轮。
+ * 对照公开表：2024 三碧、2025 二黑、2026 一白、2027 九紫、2034 二黑、2035 一白。
+ */
+export function yearZibaiStar(year) {
+  const n = (1 + (2026 - year)) % 9;
+  return n <= 0 ? n + 9 : n;
+}
+
+const PALACE_ORDER = ['坎', '坤', '震', '巽', '中', '乾', '兑', '艮', '离']; // 洛书数 1–9 对应宫
+
+/** 九宫飞星：年星入中顺飞。 */
+export function yearlyFlying(year) {
+  const center = yearZibaiStar(year);
+  const palaces = [];
+  for (const palace of PALACE_ORDER) {
+    const k = PALACE_ORDER.indexOf(palace) + 1;
+    const num = ((((k - 5 + center - 1) % 9) + 9) % 9) + 1;
+    const s = NINE_STARS[num];
+    palaces.push({ palace, direction: palace === '中' ? '中宫' : PALACE_DIRECTION[palace], num, name: s.name, star: s.star, element: s.element, lucky: s.lucky });
+  }
+  return { center, centerName: NINE_STARS[center].name, palaces };
+}
+
+const pad2 = (n) => String(n).padStart(2, '0');
+
+/** DST 校正出生日期（1986–1991），返回校正后的年月日。 */
+function civilDate(input) {
+  const dst = input.dst === false
+    ? { year: input.year, month: input.month, day: input.day, hour: 0, minute: 0, applied: false, note: null }
+    : applyDst({ year: input.year, month: input.month, day: input.day, hour: 0, minute: 0 });
+  return { year: dst.year, month: dst.month, day: dst.day, dst };
+}
+
+const SOURCES = [
+  '大游年歌（八宅通行口径）',
+  '年家紫白飞星（纯公式：以 2026 丙午一白入中、逐年退一位、九年一轮；按立春换年）',
+  '24 山归属与度数（八宅通行口径，每山 15°）',
+];
+
+const DISCLAIMER = '八宅与飞星为传统通行口径的本地计算，属民俗参考，不构成现场勘舆结论，仅供娱乐；实际户型以现场为准。';
+
+/**
+ * 风水主函数。
+ * @param {{action?:'natal'|'advise', year?:number, month?:number, day?:number, gender?:'male'|'female',
+ *          fortuneYear?:number, sitting?:string, facing?:string, dst?:boolean}} input
+ *  natal（默认）：要生日 + 性别 + 流年（缺流年则只算命卦与八星）。
+ *  advise：要坐山或向山（24 山，给一即可）；出生信息可选，给了才做命宅配。
+ */
+export function buildFengshui(input) {
+  if (input.action === 'advise') return buildAdvise(input);
+  const gender = input.gender;
+  if (gender !== 'male' && gender !== 'female') {
+    throw new Error('风水命卦需要性别：男女命卦算法不同，不可缺省');
+  }
+  if (!Number.isInteger(input.year) || !Number.isInteger(input.month) || !Number.isInteger(input.day)) {
+    throw new Error('风水命卦需要完整出生年月日（公历）——只知道年份不够：命卦按立春界划分出生年');
+  }
+  const civil = civilDate(input);
+  const guaYear = guaYearOf(civil.year, civil.month, civil.day);
+  const { num, gua, direction } = mingGua(guaYear, gender);
+  const stars = eightStars(gua);
+  const eastFour = ['坎', '离', '震', '巽'].includes(gua);
+  const fortuneYear = Number.isInteger(input.fortuneYear) ? input.fortuneYear : null;
+
+  return {
+    system: 'fengshui',
+    meta: {
+      birth: `${civil.year}-${pad2(civil.month)}-${pad2(civil.day)}`,
+      guaYear,
+      gender: gender === 'male' ? '男' : '女',
+      fortuneYear,
+      ...(civil.dst.applied ? { dst: civil.dst.note } : {}),
+      ...(fortuneYear === null ? { note: '未给流年：未算年紫白飞星（需要时补 fortuneYear）。' } : {}),
+      scope: '八宅命卦 + 大游年八星 + 年紫白；不含玄空飞星各运盘、不含形峦与现场勘舆。',
+    },
+    mingGua: {
+      num,
+      gua,
+      direction,
+      group: eastFour ? '东四命' : '西四命',
+      compatible: eastFour ? '宜东四宅（坐坎离震巽）' : '宜西四宅（坐乾坤艮兑）',
+    },
+    luckyDirections: LUCKY_STARS.map((s) => ({ star: s, ...stars[s] })),
+    unluckyDirections: UNLUCKY_STARS.map((s) => ({ star: s, ...stars[s] })),
+    ...(fortuneYear === null ? {} : { yearlyFlying: yearlyFlying(fortuneYear) }),
+    sources: SOURCES,
+    disclaimer: DISCLAIMER,
+  };
+}
+
+/** 宅卦坐向 + 门主灶厕布局倾向 + 命宅配。 */
+function buildAdvise(input) {
+  const hasSitting = typeof input.sitting === 'string' && input.sitting.trim() !== '';
+  const hasFacing = typeof input.facing === 'string' && input.facing.trim() !== '';
+  if (!hasSitting && !hasFacing) {
+    throw new Error('缺少坐向：sitting（坐山）或 facing（向山）至少给一个——按罗盘 24 山报坐或报向，例如「坐北朝南」对应坐子向午');
+  }
+  if (hasSitting && hasFacing) {
+    const s = mountainInfo(input.sitting.trim());
+    const f = mountainInfo(input.facing.trim());
+    if ((s.index + 12) % 24 !== f.index) {
+      throw new Error(`坐向不自洽：坐${s.m}（${s.deg}°）与向${f.m}（${f.deg}°）不是对宫（相差应 180°，实测 ${((f.deg - s.deg) + 360) % 360}°）——请核对罗盘读数。`);
+    }
+  }
+  const sitting = hasSitting ? mountainInfo(input.sitting.trim()) : sittingFromFacing(input.facing.trim());
+  const facing = MOUNTAINS_24[(sitting.index + 12) % 24];
+  const houseGua = sitting.gua;
+  const stars = eightStars(houseGua);
+  const lucky = LUCKY_STARS.map((s) => stars[s]);
+  const unlucky = UNLUCKY_STARS.map((s) => stars[s]);
+  const dir = (x) => `${x.direction}（${x.palace}宫）`;
+
+  const starChart = [...LUCKY_STARS, ...UNLUCKY_STARS].map((s) => ({
+    star: s,
+    lucky: LUCKY_STARS.includes(s),
+    ...stars[s],
+    role: STAR_LAYOUT_ROLE[s],
+  }));
+
+  const layout = {
+    door: `门宜开于吉方：首选生气方 ${dir(lucky[0])}，次选延年方 ${dir(lucky[1])}、天医方 ${dir(lucky[2])}。`,
+    stove: `灶宜「坐凶向吉」：灶身压凶方（首选绝命方 ${dir(unlucky[0])}、五鬼方 ${dir(unlucky[1])}），灶口朝吉方。`,
+    bed: `主卧与床头宜安吉方：生气方 ${dir(lucky[0])} 或延年方 ${dir(lucky[1])}；床头宜向吉方。`,
+    toilet: `厕所宜压凶方：祸害方 ${dir(unlucky[3])} 或六煞方 ${dir(unlucky[2])}（污去凶气，宜静常闭）。`,
+  };
+
+  let mingMatch = null;
+  const hasBirth = Number.isInteger(input.year) && Number.isInteger(input.month) && Number.isInteger(input.day)
+    && (input.gender === 'male' || input.gender === 'female');
+  if (hasBirth) {
+    const civil = civilDate(input);
+    const guaYear = guaYearOf(civil.year, civil.month, civil.day);
+    const ming = mingGua(guaYear, input.gender);
+    const mGroup = guaGroup(ming.gua);
+    const hGroup = guaGroup(houseGua);
+    const same = mGroup === hGroup;
+    const mingLucky = LUCKY_STARS.map((s) => `${s}位${eightStars(ming.gua)[s].direction}`).join('、');
+    mingMatch = {
+      birth: `${civil.year}-${pad2(civil.month)}-${pad2(civil.day)}`,
+      guaYear,
+      gender: input.gender === 'male' ? '男' : '女',
+      mingGua: { gua: ming.gua, direction: ming.direction, group: `${mGroup}命` },
+      houseGua: { gua: houseGua, group: `${hGroup}宅` },
+      sameGroup: same,
+      text: same
+        ? `命宅相配（${mGroup}命住${hGroup}宅）：以宅之八星盘布局即可，个人吉方与宅吉方大体同向。`
+        : `命宅不配（${mGroup}命住${hGroup}宅）：传统调停法——门与床以命卦吉方为先（此命四吉方：${mingLucky}），灶仍按宅卦坐凶向吉，两盘各自取用。`,
+    };
+  }
+
+  return {
+    system: 'fengshui',
+    meta: {
+      action: 'advise',
+      ...(hasBirth ? {} : { birthNote: '未提供生辰：未做命宅配；如需按个人命卦调停门床，请补充出生年月日与性别。' }),
+      sitting: `${sitting.m}山（罗盘 ${sitting.deg}°）`,
+      facing: `${facing.m}山（罗盘 ${facing.deg}°）`,
+      houseGua,
+      houseGroup: `${guaGroup(houseGua)}宅`,
+      scope: '门主灶厕走向按八宅通行口径给倾向，不含形峦、不含玄空飞星各运盘、不是现场勘舆结论。',
+    },
+    houseStars: starChart,
+    layout,
+    ...(mingMatch ? { mingMatch } : {}),
+    sources: SOURCES,
+    disclaimer: DISCLAIMER,
+  };
+}

package/engine/geo.js

@@ -143,7 +143,7 @@ const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
 /** OpenStreetMap Nominatim：免密钥、支持中文。失败返回 null。
  *  UA 按 OSM 使用政策要求写明应用与联系方式（改版本时同步这里）。 */
-const USER_AGENT = 'dsh-metaphysics/0.17.1 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.18.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;

package/engine/hepan.js

@@ -1,7 +1,7 @@
 // 合盘（合婚）：日主关系 + 夫妻宫关系 + 五行互补。
 // 口径：日主取五行生克（双向平均），夫妻宫取日支的六合/三合/冲/害/刑/破，
 // 五行互补看「一方喜用是否正是另一方所旺」。各派取法不同，这里只给通用版结论。
-import { buildBazi } from './bazi.js';
+import { buildBazi, tenGod } from './bazi.js';
 import { STEMS, BRANCHES } from './calendar.js';
 import { assertCivil } from './validate.js';
 import { SANHE_GROUPS } from './sanhe.js';
@@ -46,6 +46,21 @@ function wxToMe(other, me) {
   return { name: '克我', score: -12, text: '对方克我，压力感偏重，宜把话说开' };
 }
 
+/** 年支（属相）关系：六合、三合、六冲、六害、相刑、自刑，其余为无直接关系。 */
+function yearBranchRelation(a, b) {
+  if (a === b) return { name: '同属相（自刑之一）', score: -3, text: '属相相同，传统称「自刑」，容易互相较劲、谁也不让谁' };
+  if (pairIn(LIU_HE, a, b)) return { name: '六合', score: 3, text: '属相六合，初印象与长辈缘通常不错' };
+  if (SANHE_GROUPS.some((g) => g.branches.includes(a) && g.branches.includes(b))) {
+    return { name: '三合', score: 3, text: '属相三合，容易有共同话题与共同朋友' };
+  }
+  if (pairIn(CHONG, a, b)) return { name: '六冲', score: -3, text: '属相六冲，节奏与立场容易相反，重大决定前宜多对一遍' };
+  if (pairIn(HAI, a, b)) return { name: '相害', score: -2, text: '属相相害，容易因第三方或误会生嫌隙' };
+  for (const g of XING) {
+    if (g.includes(a) && g.includes(b)) return { name: '相刑', score: -2, text: '属相相刑，摩擦多起于相处细节' };
+  }
+  return { name: '无直接关系', score: 0, text: '属相之间没有合冲刑害，表层影响小，以日柱为主' };
+}
+
 /** 合盘主函数 */
 export function buildHepan(input) {
   assertCivil(input && input.a, 'a');
@@ -102,6 +117,71 @@ export function buildHepan(input) {
   const pct = Math.max(0, Math.min(100, Math.round(((raw + 27) / 83) * 100)));
   const level = pct >= 75 ? '契合度较高' : pct >= 55 ? '中等偏顺' : pct >= 40 ? '需要磨合' : '差异较大';
 
+  // ⑤ 细化层（对齐传统合婚口径）：属相（年支）关系、天干五合、双向十神、
+  //    跨盘地支关系、年命纳音生克、吉凶象计数。只增加明细，不改动上面的总分与三维度。
+  const aYear = A.pillars.year;
+  const bYear = B.pillars.year;
+  const yearRel = yearBranchRelation(aYear.branch, bYear.branch);
+  const HE5 = [['甲', '己'], ['乙', '庚'], ['丙', '辛'], ['丁', '壬'], ['戊', '癸']];
+  const he5 = HE5.some((p) => p.includes(aStem) && p.includes(bStem) && aStem !== bStem);
+  const godA = tenGod(aStem, bStem); // 对方日干在我盘中为
+  const godB = tenGod(bStem, aStem);
+  const A_BR = ['year', 'month', 'day', 'hour'].map((k) => A.pillars[k].branch);
+  const B_BR = ['year', 'month', 'day', 'hour'].map((k) => B.pillars[k].branch);
+  const cross = [];
+  for (const x of A_BR) {
+    for (const y of B_BR) {
+      if (pairIn(LIU_HE, x, y)) cross.push({ a: x, b: y, name: '六合', score: 1, text: '跨盘六合，易有自然的亲近与默契' });
+      else if (SANHE_GROUPS.some((g) => g.branches.includes(x) && g.branches.includes(y))) {
+        cross.push({ a: x, b: y, name: '半合', score: 1, text: '跨盘半合，某些事上容易一拍即合' });
+      } else if (pairIn(CHONG, x, y)) cross.push({ a: x, b: y, name: '相冲', score: -1, text: '跨盘相冲，某些领域节奏相反，需要分工' });
+      else if (pairIn(HAI, x, y)) cross.push({ a: x, b: y, name: '相害', score: -1, text: '跨盘相害，容易在第三方或琐事上起误会' });
+    }
+  }
+  const uniqCross = [];
+  const seen = new Set();
+  for (const c of cross) {
+    const k = `${c.name}${[c.a, c.b].sort().join('')}`;
+    if (seen.has(k)) continue;
+    seen.add(k);
+    uniqCross.push(c);
+  }
+  // 年命纳音：纳音名末字即五行（如「大林木」→ 木）
+  const nyA = aYear.nayin;
+  const nyB = bYear.nayin;
+  const naEl = nyA[nyA.length - 1];
+  const nbEl = nyB[nyB.length - 1];
+  const nayinRel = naEl === nbEl
+    ? { name: '纳音比和', score: 0, text: '两人年命纳音同五行，底色相近' }
+    : SHENG[naEl] === nbEl
+      ? { name: '纳音相生', score: 1, text: `你的年命纳音属${naEl}生对方${nbEl}，你多是先付出的一方` }
+      : SHENG[nbEl] === naEl
+        ? { name: '纳音相生', score: 1, text: `对方年命纳音属${nbEl}生你${naEl}，你容易得到照应` }
+        : KE[naEl] === nbEl
+          ? { name: '纳音相克', score: -1, text: `你的年命纳音属${naEl}克对方${nbEl}，主导感偏强` }
+          : { name: '纳音相克', score: -1, text: `对方年命纳音属${nbEl}克你${naEl}，压力感偏重` };
+  const good = (yearRel.score > 0 ? 1 : 0) + (he5 ? 1 : 0) + (gong.score > 5 ? 1 : 0)
+    + uniqCross.filter((c) => c.score > 0).length + (nayinRel.score > 0 ? 1 : 0);
+  const bad = (yearRel.score < 0 ? 1 : 0) + (gong.score < 0 ? 1 : 0)
+    + uniqCross.filter((c) => c.score < 0).length + (nayinRel.score < 0 ? 1 : 0);
+  const lean = good - bad >= 3 ? '吉象偏多' : good - bad >= 1 ? '吉略多于凶' : good - bad === 0 ? '吉凶相当' : '凶象偏多';
+
+  const detail = {
+    yearRelation: { label: yearRel.name, text: `属相：你${aYear.branch}（${aYear.ganzhi}），对方${bYear.branch}（${bYear.ganzhi}）。${yearRel.text}。` },
+    stems: {
+      he5,
+      tenGodToB: godA,
+      tenGodToA: godB,
+      text: he5
+        ? `日干五合（${aStem}${bStem}），传统称「天干五合」，主彼此吸引强，也容易黏在一起分不开。`
+        : `日干无五合：你在对方盘里是「${godA}」，对方在你盘里是「${godB}」。`,
+    },
+    crossBranches: uniqCross.slice(0, 8),
+    nayin: { a: nyA, b: nyB, label: nayinRel.name, text: nayinRel.text },
+    tally: { good, bad, lean },
+    framing: '属相（年支）只影响表层印象，传统合婚以日柱为主；分档只说明吉凶象多少，不作「必配/必离」断言。',
+  };
+
   const dim = (key, label, score, text, extra) => ({ key, label, score: Math.round(score), text, ...(extra || {}) });
 
   return {
@@ -134,6 +214,7 @@ export function buildHepan(input) {
       summary: B.summary,
     },
     score: { total: pct, level },
+    detail,
     dimensions: [
       dim('stem', '日主关系', stemScore, `你的日主 ${aStem}${aWx}，对方 ${bStem}${bWx}。${aToB.text}；${bToA.text}。`),
       dim('gong', '夫妻宫（日支）', gong.score, `${gong.name}：${gong.text}。你日支 ${aZhi}，对方日支 ${bZhi}。`),