dsh-metaphysics 0.38.2 → 0.50.1

package/engine/fengshui.js

@@ -3,6 +3,7 @@
 // 参照公开通行表实现（与常见八宅/玄空入门资料一致），年紫白用纯公式，不依赖任何第三方历法库。
 import { partsToJd, termInstantJd } from './calendar.js';
 import { applyDst } from './dst.js';
+import { fail } from './fail.js';
 
 /** 九星名称表：数 → {name, color, element, star(北斗名), lucky}。 */
 export const NINE_STARS = {
@@ -56,7 +57,7 @@ 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 山报坐或报向，不要自造方位词。`);
+    throw fail('E_INPUT', `坐向必须是 24 山之一（${MOUNTAINS_24.map((x) => x.m).join('')}），收到「${name}」——请按罗盘 24 山报坐或报向，不要自造方位词。`);
   }
   return { ...MOUNTAINS_24[i], index: i };
 }
@@ -143,6 +144,127 @@ export function yearlyFlying(year) {
 
 const pad2 = (n) => String(n).padStart(2, '0');
 
+// ── 玄空飞星（下卦） ─────────────────────────────────────────────
+// 口径：三元九运每运 20 年，1864 年起一运；运盘当运星入中顺飞。
+// 山盘/向盘：取坐宫/向宫的运星入中，按「入中运星本宫同元龙」的阴阳定顺逆（五黄入中按本山阴阳）。
+// 这一步是玄空挨星的关键：不是按坐山本身的阴阳，而是按入中运星原宫对应元龙的阴阳；
+// 按本山阴阳会把旺山旺向算成每运固定的六局，与通行二十四山旺山旺向表对不上。
+
+/** 三元九运：1864 起每 20 年一运，九运一轮（180 年）。 */
+export function periodOfYear(year) {
+  const k = Math.floor((year - 1864) / 20);
+  const period = ((k % 9) + 9) % 9 + 1;
+  const start = 1864 + 20 * k;
+  return { period, start, end: start + 19, label: `${period}运（${start}–${start + 19}）` };
+}
+
+/** 三元龙阴阳：天元/人元四隅为阳、四正为阴；地元四正为阳、四隅为阴。 */
+const YANG_MOUNTAINS = new Set(['乾', '巽', '艮', '坤', '甲', '庚', '壬', '丙', '寅', '申', '巳', '亥']);
+const YUAN_NAME = ['地元', '天元', '人元'];
+
+/** 24 山 → 三元龙 + 阴阳（MOUNTAINS_24 每卦三山依次为 地元/天元/人元）。 */
+export const MOUNTAIN_META = {};
+MOUNTAINS_24.forEach((x, i) => {
+  MOUNTAIN_META[x.m] = { ...x, yuan: YUAN_NAME[i % 3], yinYang: YANG_MOUNTAINS.has(x.m) ? '阳' : '阴' };
+});
+
+/** 飞星轨迹：中 → 乾 → 兑 → 艮 → 离 → 坎 → 坤 → 震 → 巽（即洛书 5→6→7→8→9→1→2→3→4）。 */
+const FLY_SEQ = ['中', '乾', '兑', '艮', '离', '坎', '坤', '震', '巽'];
+const NUM_TO_GUA = ['坎', '坤', '震', '巽', '中', '乾', '兑', '艮', '离']; // 洛书数 1–9 本位卦
+const YUAN_INDEX = { 地元: 0, 天元: 1, 人元: 2 };
+
+const mountainsOfGua = (gua) => MOUNTAINS_24.filter((x) => x.gua === gua).map((x) => MOUNTAIN_META[x.m]);
+
+/** 入中星按轨迹飞布：forward=true 顺飞，false 逆飞。返回 宫 → 星数。 */
+function fly(center, forward) {
+  const out = {};
+  for (let i = 0; i < 9; i++) {
+    const v = ((center - 1 + (forward ? i : -i)) % 9 + 9) % 9 + 1;
+    out[FLY_SEQ[i]] = v;
+  }
+  return out;
+}
+
+/** 入中运星定顺逆：取本宫（运星本位卦）同元龙之山的阴阳；五黄入中按本山阴阳。 */
+function flightOf(mount, center) {
+  if (center === 5) {
+    return { forward: mount.yinYang === '阳', basis: `五黄入中，按${mount.m}本山${mount.yuan}${mount.yinYang}论` };
+  }
+  const home = NUM_TO_GUA[center - 1];
+  const hm = mountainsOfGua(home)[YUAN_INDEX[mount.yuan]];
+  return { forward: hm.yinYang === '阳', basis: `${center}${home}宫取${mount.yuan}${hm.m}（${hm.yinYang}）` };
+}
+
+/** 通行二十四山旺山旺向表（每项含正反两向；一运、九运无局）。 */
+export const WANG_SHAN_WANG_XIANG = {
+  1: [],
+  2: [['乾', '巽'], ['亥', '巳'], ['丑', '未']],
+  3: [['卯', '酉'], ['乙', '辛'], ['辰', '戌']],
+  4: [['艮', '坤'], ['寅', '申'], ['甲', '庚']],
+  5: [['子', '午'], ['癸', '丁'], ['卯', '酉'], ['乙', '辛'], ['丑', '未'], ['辰', '戌']],
+  6: [['艮', '坤'], ['寅', '申'], ['甲', '庚']],
+  7: [['卯', '酉'], ['乙', '辛'], ['辰', '戌']],
+  8: [['乾', '巽'], ['亥', '巳'], ['丑', '未']],
+  9: [],
+};
+
+export const XUANKONG_SOURCES = [
+  '三元九运（1864 年起一运、每运 20 年，九运 180 年一轮）',
+  '玄空下卦挨星（运盘顺飞；山盘/向盘以入中运星本宫同元龙阴阳定顺逆，五黄入中按本山阴阳）',
+  '二十四山旺山旺向通行表（每项含正反两向；一运、九运无局）',
+];
+
+export const XUANKONG_DISCLAIMER = '玄空下卦为传统通行口径的本地排盘，属民俗参考，不构成现场勘舆结论，仅供娱乐；替卦/兼向、年月日时飞星与形峦不在本工具范围内。';
+
+/** 玄空下卦排盘：运盘 + 山盘 + 向盘 + 当运星 + 合十 + 表法旺山旺向。 */
+export function xuankongChart(period, sitting, facing) {
+  const sit = MOUNTAIN_META[sitting];
+  const face = MOUNTAIN_META[facing];
+  const yun = fly(period, true);
+  const sCenter = yun[sit.gua];
+  const fCenter = yun[face.gua];
+  const sFly = flightOf(sit, sCenter);
+  const fFly = flightOf(face, fCenter);
+  const shan = fly(sCenter, sFly.forward);
+  const xiang = fly(fCenter, fFly.forward);
+  const palaces = PALACE_ORDER.map((palace, i) => ({
+    palace,
+    direction: palace === '中' ? '中宫' : PALACE_DIRECTION[palace],
+    luoshu: i + 1,
+    yun: yun[palace],
+    shan: shan[palace],
+    xiang: xiang[palace],
+  }));
+  const wheres = (map) => PALACE_ORDER.filter((p) => map[p] === period);
+  const pairs = WANG_SHAN_WANG_XIANG[period];
+  const hit = pairs.find(([a, b]) => (sit.m === a && face.m === b) || (sit.m === b && face.m === a));
+  const byChart = shan[sit.gua] === period && xiang[face.gua] === period;
+  const note = byChart && hit
+    ? '盘面与表法一致：本局到山到向。'
+    : byChart
+      ? '盘面到山到向，但不在通行表法所列之局（表法与盘面口径不同，并列不合并）。'
+      : hit
+        ? '通行表法列为旺山旺向，但本盘当运山星/向星未同时落坐向（表法与盘面口径不同，并列不合并）。'
+        : '本局既未到山到向，也不在表法旺山旺向之列。';
+  return {
+    palaces,
+    sitting: sit,
+    facing: face,
+    yun,
+    shan,
+    xiang,
+    yunCenter: period,
+    shanCenter: { star: sCenter, ...sFly },
+    xiangCenter: { star: fCenter, ...fFly },
+    dangYun: { shan: wheres(shan), xiang: wheres(xiang) },
+    heshi: {
+      shan: PALACE_ORDER.filter((p) => shan[p] + yun[p] === 10),
+      xiang: PALACE_ORDER.filter((p) => xiang[p] + yun[p] === 10),
+    },
+    wangShanWangXiang: { byChart, byTable: Boolean(hit), table: pairs.map(([a, b]) => `${a}${b}`), note },
+  };
+}
+
 /** DST 校正出生日期（1986–1991），返回校正后的年月日。 */
 function civilDate(input) {
   const dst = input.dst === false
@@ -161,19 +283,21 @@ const DISCLAIMER = '八宅与飞星为传统通行口径的本地计算，属民
 
 /**
  * 风水主函数。
- * @param {{action?:'natal'|'advise', year?:number, month?:number, day?:number, gender?:'male'|'female',
- *          fortuneYear?:number, sitting?:string, facing?:string, dst?:boolean}} input
+ * @param {{action?:'natal'|'advise'|'xuankong', year?:number, month?:number, day?:number, gender?:'male'|'female',
+ *          fortuneYear?:number, sitting?:string, facing?:string, period?:number, dst?:boolean}} input
  *  natal（默认）：要生日 + 性别 + 流年（缺流年则只算命卦与八星）。
  *  advise：要坐山或向山（24 山，给一即可）；出生信息可选，给了才做命宅配。
+ *  xuankong：要坐山或向山；运由 period（1–9）或 fortuneYear 定，缺省按九运并注明。
  */
 export function buildFengshui(input) {
   if (input.action === 'advise') return buildAdvise(input);
+  if (input.action === 'xuankong') return buildXuankong(input);
   const gender = input.gender;
   if (gender !== 'male' && gender !== 'female') {
-    throw new Error('风水命卦需要性别：男女命卦算法不同，不可缺省');
+    throw fail('E_INPUT', '风水命卦需要性别：男女命卦算法不同，不可缺省');
   }
   if (!Number.isInteger(input.year) || !Number.isInteger(input.month) || !Number.isInteger(input.day)) {
-    throw new Error('风水命卦需要完整出生年月日（公历）——只知道年份不够：命卦按立春界划分出生年');
+    throw fail('E_INPUT', '风水命卦需要完整出生年月日（公历）——只知道年份不够：命卦按立春界划分出生年');
   }
   const civil = civilDate(input);
   const guaYear = guaYearOf(civil.year, civil.month, civil.day);
@@ -191,7 +315,7 @@ export function buildFengshui(input) {
       fortuneYear,
       ...(civil.dst.applied ? { dst: civil.dst.note } : {}),
       ...(fortuneYear === null ? { note: '未给流年：未算年紫白飞星（需要时补 fortuneYear）。' } : {}),
-      scope: '八宅命卦 + 大游年八星 + 年紫白；不含玄空飞星各运盘、不含形峦与现场勘舆。',
+      scope: '八宅命卦 + 大游年八星 + 年紫白；玄空飞星见 action=xuankong；不含形峦与现场勘舆。',
     },
     mingGua: {
       num,
@@ -208,22 +332,28 @@ export function buildFengshui(input) {
   };
 }
 
-/** 宅卦坐向 + 门主灶厕布局倾向 + 命宅配。 */
-function buildAdvise(input) {
+/** 坐向解析：至少给坐或向；两者都给则必须对宫。 */
+function resolveSittingFacing(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 山报坐或报向，例如「坐北朝南」对应坐子向午');
+    throw fail('E_INPUT', '缺少坐向：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}°）——请核对罗盘读数。`);
+      throw fail('E_INPUT', `坐向不自洽：坐${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];
+  return { sitting, facing };
+}
+
+/** 宅卦坐向 + 门主灶厕布局倾向 + 命宅配。 */
+function buildAdvise(input) {
+  const { sitting, facing } = resolveSittingFacing(input);
   const houseGua = sitting.gua;
   const stars = eightStars(houseGua);
   const lucky = LUCKY_STARS.map((s) => stars[s]);
@@ -277,7 +407,7 @@ function buildAdvise(input) {
       facing: `${facing.m}山（罗盘 ${facing.deg}°）`,
       houseGua,
       houseGroup: `${guaGroup(houseGua)}宅`,
-      scope: '门主灶厕走向按八宅通行口径给倾向，不含形峦、不含玄空飞星各运盘、不是现场勘舆结论。',
+      scope: '门主灶厕走向按八宅通行口径给倾向，玄空飞星见 action=xuankong；不含形峦、不是现场勘舆结论。',
     },
     houseStars: starChart,
     layout,
@@ -286,3 +416,59 @@ function buildAdvise(input) {
     disclaimer: DISCLAIMER,
   };
 }
+
+/** 玄空下卦：坐向 + 运 → 九宫盘、当运星、合十、表法旺山旺向。 */
+function buildXuankong(input) {
+  const { sitting, facing } = resolveSittingFacing(input);
+  let period;
+  let yearInfo = null;
+  let note;
+  if (input.period !== undefined && input.period !== null && !Number.isInteger(input.period)) {
+    throw fail('E_INPUT', `运必须是 1–9 的整数（三元九运），收到「${input.period}」——一运 1864 起、九运 2024–2043。`);
+  }
+  if (Number.isInteger(input.period)) {
+    if (input.period < 1 || input.period > 9) {
+      throw fail('E_INPUT', `运必须是 1–9 的整数（三元九运），收到「${input.period}」——一运 1864 起、九运 2024–2043。`);
+    }
+    period = input.period;
+  } else if (Number.isInteger(input.fortuneYear)) {
+    yearInfo = periodOfYear(input.fortuneYear);
+    period = yearInfo.period;
+  } else {
+    period = 9;
+    note = '未给运：默认按九运（2024–2043）排盘；可传 period（1–9）或 fortuneYear 指定。';
+  }
+  const chart = xuankongChart(period, sitting.m, facing.m);
+  const sitMeta = MOUNTAIN_META[sitting.m];
+  const faceMeta = MOUNTAIN_META[facing.m];
+  const center = (c) => ({ star: c.star, name: NINE_STARS[c.star].name, fly: c.forward ? '顺飞' : '逆飞', basis: c.basis });
+  const where = (list) => list.map((p) => `${p}宫${PALACE_DIRECTION[p]}`).join('、') || '无';
+  return {
+    system: 'fengshui',
+    meta: {
+      action: 'xuankong',
+      period,
+      periodLabel: yearInfo ? yearInfo.label : `${period}运`,
+      ...(yearInfo ? { year: input.fortuneYear, periodStart: yearInfo.start, periodEnd: yearInfo.end } : {}),
+      sitting: `${sitting.m}山（罗盘 ${sitting.deg}°）`,
+      facing: `${facing.m}山（罗盘 ${facing.deg}°）`,
+      sittingGua: sitting.gua,
+      facingGua: facing.gua,
+      sittingYuan: `${sitMeta.yuan}${sitMeta.yinYang}`,
+      facingYuan: `${faceMeta.yuan}${faceMeta.yinYang}`,
+      shanCenter: center(chart.shanCenter),
+      xiangCenter: center(chart.xiangCenter),
+      ...(note ? { note } : {}),
+      scope: '玄空下卦：运盘 + 山盘 + 向盘 + 当运星 + 合十 + 表法旺山旺向；不含替卦/兼向、不含年月日时飞星、不含形峦与现场勘舆。',
+    },
+    palaces: chart.palaces,
+    dangYun: {
+      shan: { palaces: chart.dangYun.shan, text: where(chart.dangYun.shan) },
+      xiang: { palaces: chart.dangYun.xiang, text: where(chart.dangYun.xiang) },
+    },
+    heshi: { shan: chart.heshi.shan, xiang: chart.heshi.xiang },
+    wangShanWangXiang: chart.wangShanWangXiang,
+    sources: XUANKONG_SOURCES,
+    disclaimer: XUANKONG_DISCLAIMER,
+  };
+}

package/engine/followup.js

@@ -199,30 +199,54 @@ const SYSTEM_LABEL = {
  * 客户端把这段文字写进对话输入框并提交，由对话里的模型基于盘面回答。
  *
  * @param {object} r compute 的结果（至少要带 system 与 summary）
- * @param {{question?:string, maxChars?:number}} [opts]
+ * @param {{question?:string, maxChars?:number, interpret?:object}} [opts]
+ *        interpret 传面板已算好的解析对象（it）时，把其中的白话结论一并交给模型，
+ *        让对话开场与面板里的「先答所问 / 说人话」是同一个口径；不传则不加这一段。
  * @returns {{text:string, question:string, system:string, label:string, chars:number, truncated:boolean}}
  */
 export function askPrompt(r, opts = {}) {
   const label = SYSTEM_LABEL[r && r.system] || (r && r.system) || '未知体系';
   const asked = String((opts && opts.question) || '').trim();
-  const question = asked || '请先总览这张盘，指出最值得注意的一两处，并说明各自的依据。';
+  const question = asked || '请先用一句白话讲清这张盘的主线，再指出最值得注意的一两处，并说明每处的具体依据。';
   const limit = Number.isFinite(opts && opts.maxChars) && opts.maxChars >= 400 ? opts.maxChars : 3000;
   const raw = String((r && r.summary) || '').trim();
   const truncated = raw.length > limit;
   const summary = truncated ? `${raw.slice(0, limit)}…（摘要已截断）` : raw;
 
+  // 面板里已经算过一遍解析：直接取「直答 / 说人话」，避免模型开场另起一套说法
+  const it = (opts && typeof opts.interpret === 'object' && opts.interpret)
+    || (r && typeof r.interpret === 'object' && r.interpret) || null;
+  const answer = String((it && it.answer) || '').trim();
+  const plain = String((it && it.plain) || '').trim();
+  const draft = [];
+  if (answer) draft.push(`直答：${answer}`);
+  if (plain) draft.push(`说人话：${plain}`);
+
   const lines = [
     '【命理追问】下面这张盘是命理插件刚排好的，请就着它回答我的问题；不用重新排盘，盘面字段已经够用。',
     `体系：${label}`,
     `所问：${question}`,
     '',
+    ...(draft.length ? [
+      '——开场结论（插件已按同一套规则算好，开场先沿用这句；措辞可改，口径别换）——',
+      ...draft,
+      '',
+    ] : []),
     '——盘面摘要——',
     summary || '（这张盘没有摘要字段，请先让我重新排一次。）',
     '',
     '——回答要求——',
-    '1) 尽量引用到具体的柱、宫或爻，再说判断，别只给结论；',
-    '2) 盘面里没有依据的地方直接说「这盘里看不出来」，不要补外部假设；',
-    '3) 用概率和倾向的说法，别给绝对化的断言，也别把传统说法当成事实。',
+    '读者不懂命理。按下面的骨架答；任何一句他看不懂，就算没写完：',
+    draft.length
+      ? '1) 开头一句结论：先沿用上面的「开场结论」，再用一句不用术语的话说清这张盘的主线——只读这一句也该有收获；'
+      : '1) 开头一句结论：不用术语，一句话说清这张盘的主线，只读这一句也该有收获；',
+    '2) 判断最多两条，按重要性排序，每条分四行写：',
+    '   盘面｜只引盘面已有的字（具体的柱、宫或爻、字段名），不掺解释；',
+    '   白话｜把上一行的术语当场翻成日常话——调候 / 化气 / 通关 / 空亡 / 争合 这类词必须落地，一个词只翻一次，不连续堆三个以上；',
+    '   倾向｜说「更可能……」，讲清它在现实里大概意味着什么，用概率语气；',
+    '   边界｜这条在什么情况下不成立；盘面没给的，直接写「这盘里看不出来」；',
+    '3) 收尾一句「如果只记一件事」：给一条能核对、能动手的观察点，并说明它出自上面哪条盘面依据；',
+    '4) 别把传统说法当成已证实的事实：不下绝对断言，也不用「肯定」「绝对」这类词，更不写「格局很好」「运程不顺」这种没有信息的空话。',
   ];
   const text = lines.join('\n');
   return { text, question, system: (r && r.system) || '', label, chars: text.length, truncated };

package/engine/geju.js

@@ -9,6 +9,7 @@
 
 import { judgeClimate, arbitrate } from './tiaohou.js';
 import { qtOf } from './qiongtong.js';
+import { sanheGroupOf } from './sanhe.js';
 
 const STEMS = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
 const BRANCHES = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -87,6 +88,25 @@ export function elementRoles(dayStem) {
 
 // ── 月令格 ───────────────────────────────────────────────────
 
+// 四墓（杂气）月：辰戌丑未所藏多、用神不一，取用先看透干，再看会支。
+// 会支只认三合局——子平真诠十六「逢申与子会局」的例子即三合，三会方与兼透兼用仍不纳入。
+const ZA_MONTHS = ['辰', '未', '戌', '丑'];
+
+function huiCandidate(pillars, monthBranch, cands) {
+  if (!ZA_MONTHS.includes(monthBranch)) return null;
+  const group = sanheGroupOf(monthBranch);
+  if (!group) return null;
+  const others = ['year', 'day', 'hour'];
+  const need = group.branches.filter((b) => b !== monthBranch);
+  if (!need.every((b) => others.some((k) => pillars[k].branch === b))) return null;
+  const cand = cands.find((c) => STEM_ELEMENT[c.stem] === group.element);
+  if (!cand) return null;
+  const where = others
+    .filter((k) => need.includes(pillars[k].branch))
+    .map((k) => `${({ year: '年', day: '日', hour: '时' })[k]}支${pillars[k].branch}`);
+  return { ...cand, group, where };
+}
+
 function monthPattern(pillars, dayStem, monthBranch) {
   const hidden = HIDDEN[monthBranch] || [];
   const cands = hidden.map((stem, i) => ({
@@ -98,10 +118,13 @@ function monthPattern(pillars, dayStem, monthBranch) {
   const others = ['year', 'month', 'hour'];
   const exposedKey = others.find((k) => cands.some((c) => c.stem === pillars[k].stem));
   const base = cands[0];
-  const use = exposedKey ? cands.find((c) => c.stem === pillars[exposedKey].stem) : base;
+  const hui = exposedKey ? null : huiCandidate(pillars, monthBranch, cands);
+  const use = exposedKey ? cands.find((c) => c.stem === pillars[exposedKey].stem) : (hui || base);
+  const usedBy = exposedKey ? '透干' : (hui ? '会支' : '本气');
   const exposedPos = exposedKey ? { year: '年', month: '月', hour: '时' }[exposedKey] : null;
 
-  if (base.god === '比肩') {
+  // 建禄只认日干的禄位；戊土辰月、己土未月这类「本气比肩但不在禄位」的杂气月不再冒称建禄
+  if (base.god === '比肩' && LUSHEN_BRANCH[dayStem] === monthBranch) {
     return {
       name: '建禄格',
       kind: '月令格',
@@ -118,10 +141,31 @@ function monthPattern(pillars, dayStem, monthBranch) {
     }
     return { name: '月劫格', kind: '月令格', evidence: `月令${monthBranch}本气${base.stem}为劫财` };
   }
+  if (usedBy === '本气' && base.god === '比肩') {
+    return {
+      name: '比肩格',
+      kind: '月令格',
+      evidence: `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}为比肩，但${dayStem}禄在${LUSHEN_BRANCH[dayStem]}、不在${monthBranch}，属杂气月比肩当权`,
+    };
+  }
+  // 子平十六：「透乙则用月劫」——杂气月由透干或会支取到劫财时，仍作月劫论
+  if (usedBy !== '本气' && use.god === '劫财') {
+    const via = exposedKey ? `透于${exposedPos}干` : `${hui.where.join('、')}会成${hui.group.element}局`;
+    return {
+      name: '月劫格',
+      kind: '月令格',
+      evidence: `月令${monthBranch}藏${hidden.join('')}，${use.pos}${use.stem}（劫财）${via}，劫财为用，作月劫论`,
+    };
+  }
   const name = `${use.god}格`;
-  const ex = exposedKey
-    ? `月令${monthBranch}藏${hidden.join('')}，${use.pos}${use.stem}（${use.god}）透于${exposedPos}干`
-    : `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}（${base.god}）未透干，以月令本气取格`;
+  let ex;
+  if (exposedKey) {
+    ex = `月令${monthBranch}藏${hidden.join('')}，${use.pos}${use.stem}（${use.god}）透于${exposedPos}干`;
+  } else if (hui) {
+    ex = `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}（${base.god}）未透干，而${hui.where.join('、')}会成${hui.group.element}局，取${use.pos}${use.stem}（${use.god}）为用`;
+  } else {
+    ex = `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}（${base.god}）未透干，以月令本气取格`;
+  }
   return { name, kind: '月令格', evidence: ex };
 }
 
@@ -198,6 +242,36 @@ function specialPatterns(pillars, dayStem, monthBranch, strength, wuxing, gods)
   return out;
 }
 
+// ── 通关 ────────────────────────────────────────────────────
+// 滴天髓「通关」只给取象（织女、牛郎），这里把结构说清：
+// 用神与忌神两行在局中都真有分量、且相克时，五行里恰有一行能接上——克方所生、且能生被克方。
+// 只报这一行在局中的分量，不判「关通了就吉」。
+const TONGGUAN_MIN = 1.5;
+export function tongguanOf(favor = [], avoid = [], wuxing = {}) {
+  const w = (el) => Math.round((Number(wuxing[el]) || 0) * 10) / 10;
+  for (const use of favor) {
+    if (w(use) < TONGGUAN_MIN) continue;
+    for (const foe of avoid) {
+      if (OVERCOMES[foe] !== use || w(foe) < TONGGUAN_MIN) continue;
+      const bridge = GENERATES[foe];
+      if (!bridge || GENERATES[bridge] !== use) continue;
+      const weight = w(bridge);
+      const bridgeIsAvoid = avoid.includes(bridge) && !favor.includes(bridge);
+      const level = bridgeIsAvoid ? '为忌' : weight >= TONGGUAN_MIN ? '可通' : weight > 0 ? '关弱' : '未通';
+      return {
+        use, foe, bridge,
+        weight,
+        present: weight > 0,
+        bridgeIsAvoid,
+        level,
+        usable: level === '可通',
+        note: '相战＝用神与忌神两行各在局中 ≥1.5 分且相克；通关一行＝克方所生、又能生用神的那一行（五行里唯一），只报局中分量，不据此断吉凶',
+      };
+    }
+  }
+  return null;
+}
+
 // ── 用神 / 喜忌 ──────────────────────────────────────────────
 
 
@@ -232,6 +306,7 @@ function yongshenOf(dayStem, monthBranch, strength, wuxing, branches = []) {
   };
   const favorTenGods = Array.from(new Set(favor.flatMap((el) => expand[roleName(el)] || [])));
   const avoidTenGods = Array.from(new Set(avoid.flatMap((el) => expand[roleName(el)] || [])));
+  const tongguan = tongguanOf(favor, avoid, wuxing);
 
   const detail = [
     `日主${dayStem}${me}，${strength.level}（${strength.score} 分）：`,
@@ -242,6 +317,15 @@ function yongshenOf(dayStem, monthBranch, strength, wuxing, branches = []) {
         : '身中和，先取调候与通关，喜忌随大运流年动态变化。',
     `调候：${climate.label}（${(climate.evidence || []).join('、')}）${climate.need ? `，取${climate.need.stem}${climate.need.element}，忌${climate.avoidElement}` : '，气候平和'}。`,
     qt ? `穷通宝鉴：${qt.month}${dayStem}${me}，用神${qt.yong.join('、')}（首取${qt.primary}）。` : '',
+    tongguan
+      ? `通关：忌${tongguan.foe}克用${tongguan.use}，五行以${tongguan.bridge}为关；局中${tongguan.level === '可通'
+        ? `${tongguan.bridge} ${tongguan.weight} 分，关可通`
+        : tongguan.level === '关弱'
+          ? `仅 ${tongguan.bridge} ${tongguan.weight} 分，关弱`
+          : tongguan.level === '为忌'
+            ? `${tongguan.bridge} ${tongguan.weight} 分但此行为忌，通关力打折`
+            : `未见${tongguan.bridge}，关未通`}（只作结构提示，不据此断吉凶）。`
+      : '',
     arb.text,
     arb.clash ? '取舍：本盘按「调候优先、扶抑次之」取用；若你更认同扶抑派，可把调候当环境偏好，强弱判断不受影响。' : '',
   ].filter(Boolean).join('');
@@ -258,6 +342,7 @@ function yongshenOf(dayStem, monthBranch, strength, wuxing, branches = []) {
     tiaohou: { ...climate, ...arb, element: climate.need ? climate.need.element : null },
     climate,
     qt,
+    tongguan,
     detail,
   };
 }