dsh-metaphysics 0.38.2 → 0.46.5

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

@@ -198,6 +198,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 +262,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 +273,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 +298,7 @@ function yongshenOf(dayStem, monthBranch, strength, wuxing, branches = []) {
     tiaohou: { ...climate, ...arb, element: climate.need ? climate.need.element : null },
     climate,
     qt,
+    tongguan,
     detail,
   };
 }

package/engine/index.js

@@ -1,7 +1,7 @@
 // 统一入口：解析参数、分派到各体系、生成可读摘要
 import { buildBazi } from './bazi.js';
-import { buildLiuyao, tossLines, bodyLabels, yongshenOf, yongshenStrength, hexagramStrength, jinTuiPower } from './liuyao.js';
-import { buildZiwei, BRIGHTNESS, flowOf, asOfParts } from './ziwei.js';
+import { buildLiuyao, tossLines, bodyLabels, yongshenOf, yongshenStrength, fushenAccess, hexagramStrength, jinTuiPower } from './liuyao.js';
+import { buildZiwei, BRIGHTNESS, flowOf, asOfParts, ZIWEI_SCHOOL_DEFAULTS } from './ziwei.js';
 import { drawTarot } from './tarot.js';
 import { buildMeihua } from './meihua.js';
 import { buildDaliuren } from './daliuren.js';
@@ -55,6 +55,21 @@ function requireGender(value, who = '') {
   throw fail('E_INPUT', `${who ? who + '的' : ''}gender 必须是 male 或 female${got}；性别决定大运/大限顺逆，不能靠默认值`);
 }
 
+const ZIWEI_SCHOOL_KEYS = [
+  'brightnessSchool', 'gengYearSihua', 'tianmaSchool', 'tiankongSchool', 'jiekongSchool',
+  'kuiyueSchool', 'tianshiTianshang', 'changshengSchool', 'lateZishi',
+];
+
+/** 紫微流派参数原样透传；非法值交给引擎按默认口径回退 */
+function ziweiSchoolArgs(args) {
+  const out = {};
+  for (const key of ZIWEI_SCHOOL_KEYS) {
+    if (args[key] !== undefined) out[key] = args[key];
+  }
+  if (args.schools && typeof args.schools === 'object') out.schools = args.schools;
+  return out;
+}
+
 /** 解析 'YYYY-MM-DDTHH:mm' / 'YYYY-MM-DD HH:mm' / 'YYYY-MM-DD' */
 export function parseDateTime(text) {
   if (typeof text !== 'string' || !text.trim()) {
@@ -148,7 +163,23 @@ function baziText(r) {
 }
 
 function ziweiText(r) {
-  const lunarText = `${r.lunar.year}年${r.lunar.isLeap ? '闰' : ''}${r.lunar.month}月${r.lunar.day}日`;
+  // 闰月：日期按「闰X月」原样写；换算过起盘月时再附一句，免得把 21 日写成「闰5月21日」
+  const rawMonth = r.lunar.monthRaw || r.lunar.month;
+  const lunarText = `${r.lunar.year}年${r.lunar.isLeap ? `闰${rawMonth}` : r.lunar.month}月${r.lunar.day}日`
+    + (r.lunar.isLeap && r.lunar.month !== rawMonth ? `（按${r.lunar.month}月起盘）` : '');
+  // 只在显式改动流派时补一行，默认盘不增加噪音
+  const schoolLine = (() => {
+    if (!r.schools) return '';
+    const labels = {
+      brightnessSchool: '亮度', gengYearSihua: '庚干四化', tianmaSchool: '天马', tiankongSchool: '天空',
+      jiekongSchool: '截空', kuiyueSchool: '魁钺', tianshiTianshang: '天伤天使',
+      changshengSchool: '长生', lateZishi: '晚子时',
+    };
+    const diff = Object.entries(labels)
+      .filter(([key]) => r.schools[key] && r.schools[key] !== ZIWEI_SCHOOL_DEFAULTS[key])
+      .map(([key, label]) => `${label} ${r.schools[key]}`);
+    return diff.length ? `【流派】${diff.join('　')}` : '';
+  })();
   const starText = (stars) => (stars.length
     ? stars.map((s) => `${s.name}${s.mutagen ? `化${s.mutagen}` : ''}`).join(' ')
     : '—');
@@ -199,6 +230,7 @@ function ziweiText(r) {
     `【命宫】${r.soul.branch}（${r.soul.ganzhi}·${r.soul.nayin}）　【身宫】${r.body.branch}（落${r.body.lands}）　【五行局】${r.bureau.name}`,
     `【紫微】${r.ziwei}　【天府】${r.tianfu}　【命主】${r.lifeMaster}　【身主】${r.bodyMaster}`,
     `【大限】${r.daxian.rule}，${r.daxian.startAge}岁起　【小限】${r.xiaoxianRule.direction}`,
+    schoolLine,
     `【昌曲】文昌${r.changqu.wenchang.branch}（${r.changqu.wenchang.palace}${r.changqu.wenchang.mutagen ? '·化' + r.changqu.wenchang.mutagen : ''}）　文曲${r.changqu.wenqu.branch}（${r.changqu.wenqu.palace}${r.changqu.wenqu.mutagen ? '·化' + r.changqu.wenqu.mutagen : ''}）`,
     `　　　${r.changqu.relation}　入命三方：${r.changqu.inSoulSanfang ? '是' : '否'}　吸收面：${r.changqu.absorb.label}（${r.changqu.absorb.reason}）`,
     flyLine,
@@ -355,6 +387,11 @@ function liuyaoText(r) {
       const m = strength.month && strength.month.branch ? `月建 ${strength.month.branch}（${strength.month.element}）　` : '';
       out.push(`用神旺衰：${m}${strength.labels.join(' · ')}`);
     }
+    // 伏神出伏条件：只在用神不上卦时出现；只归条件档，不给应期
+    const chufu = r.fushenAccess;
+    if (chufu && Array.isArray(chufu.labels) && chufu.labels.length) {
+      out.push(`伏神出伏：${chufu.labels.join(' · ')}`);
+    }
   } else {
     out.push('用神：未取（未指明所问之事；用「询问方向」指定后即按六亲取用）');
   }
@@ -421,7 +458,7 @@ export function compute(args = {}) {
     };
     const asOf = checkAsOf(args.asOf);
     const other = r.system === 'bazi'
-      ? buildZiwei({ ...common, leapAsNext: args.leapAsNext === true, asOf })
+      ? buildZiwei({ ...common, leapMonth: args.leapMonth, leapAsNext: args.leapAsNext === true, ...ziweiSchoolArgs(args), asOf })
       : buildBazi({ ...common, lateZi: args.lateZi !== false, nowYear: asOf ? asOf.year : undefined });
     r.cross = crossCheck(r.system === 'bazi' ? r : other, r.system === 'ziwei' ? r : other);
     if (r.interpret) {
@@ -474,8 +511,9 @@ export function compute(args = {}) {
 export function interpretText(i) {
   if (!i) return '';
   const out = [`【${i.title || '解析与详解'}】${i.ask && i.ask.echo ? i.ask.echo : ''}`];
-  // 直答放在最前：先回答「你问的事」，再说依据，避免读者读到最后才知道结论
-  if (i.answer) out.push(`▶ 先答所问：${i.answer}`);
+  // 直答放在最前：先回答「你问的事」，再说依据，避免读者读到最后才知道结论；
+  // 没填问题时就不该喊「答所问」——改为「先看结论」，否则是一句假话
+  if (i.answer) out.push(`▶ ${i.ask && i.ask.question ? '先答所问' : '先看结论'}：${i.answer}`);
   if (i.plain) out.push(`▶ 说人话：${i.plain}`);
   if (i.lead) out.push(i.lead);
   // 一页读懂：报告顶部的五条结论，先给读的人一个「整体形状」
@@ -551,7 +589,9 @@ function computeRaw(args = {}) {
     const result = buildZiwei({
       ...dt,
       gender: requireGender(args.gender),
+      leapMonth: args.leapMonth,
       leapAsNext: args.leapAsNext === true,
+      ...ziweiSchoolArgs(args),
       longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
       address: typeof args.address === 'string' ? args.address : undefined,
       geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
@@ -702,6 +742,9 @@ function computeRaw(args = {}) {
     if (ug.liuqin) {
       const strength = yongshenStrength(result, ug, { monthBranch, dayBranch: result.dayGanZhi.branch });
       if (strength) result.useGodStrength = strength;
+      // 伏神出伏条件：飞伏生克叠月建日辰，只判条件、不出应期
+      const chufu = fushenAccess(result, ug, { monthBranch, dayBranch: result.dayGanZhi.branch });
+      if (chufu) result.fushenAccess = chufu;
     }
     if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
     return { ...result, ...(asOf ? { asOf } : {}), summary: liuyaoText(result) };
@@ -802,7 +845,17 @@ function computeRaw(args = {}) {
     return { ...result, precision: dt.precision, summary: trendText(result) };
   }
   if (system === 'fengshui') {
-    const action = args.action === 'advise' ? 'advise' : 'natal';
+    const action = args.action === 'advise' ? 'advise' : args.action === 'xuankong' ? 'xuankong' : 'natal';
+    if (action === 'xuankong') {
+      const result = buildFengshui({
+        action,
+        sitting: args.sitting,
+        facing: args.facing,
+        ...(args.period !== undefined ? { period: args.period } : {}),
+        ...(Number.isInteger(args.fortuneYear) ? { fortuneYear: args.fortuneYear } : {}),
+      });
+      return { ...result, summary: fengshuiText(result) };
+    }
     if (action === 'advise') {
       const result = buildFengshui({
         action,
@@ -841,6 +894,8 @@ function computeRaw(args = {}) {
       givenName: args.givenName,
       limit: args.limit,
       charElements: args.charElements && typeof args.charElements === 'object' ? args.charElements : undefined,
+      strokeOverrides: args.strokeOverrides && typeof args.strokeOverrides === 'object' ? args.strokeOverrides : undefined,
+      surnameStrokes: args.surnameStrokes && typeof args.surnameStrokes === 'object' ? args.surnameStrokes : undefined,
       ...birth,
       ...(args.gender === 'male' || args.gender === 'female' ? { gender: args.gender } : {}),
       ...(args.datetime ? {
@@ -1019,6 +1074,25 @@ function trendText(r) {
 
 /** 风水文本 */
 function fengshuiText(r) {
+  if (r.meta.action === 'xuankong') {
+    const p = r.meta.period;
+    const cell = (palace) => {
+      const x = r.palaces.find((y) => y.palace === palace);
+      return `${palace}${x.yun}/${x.shan}/${x.xiang}`;
+    };
+    const row = (names) => names.map(cell).join('　');
+    const w = r.wangShanWangXiang;
+    return [
+      `【玄空】${r.meta.periodLabel}　坐 ${r.meta.sitting}　向 ${r.meta.facing}`,
+      `【入中】山盘 ${r.meta.shanCenter.star}${r.meta.shanCenter.name}（${r.meta.shanCenter.fly}，${r.meta.shanCenter.basis}）；向盘 ${r.meta.xiangCenter.star}${r.meta.xiangCenter.name}（${r.meta.xiangCenter.fly}，${r.meta.xiangCenter.basis}）`,
+      `【九宫】${row(['巽', '离', '坤'])}｜${row(['震', '中', '兑'])}｜${row(['艮', '坎', '乾'])}`,
+      `【当运】山星${p}到${r.dangYun.shan.text}；向星${p}到${r.dangYun.xiang.text}`,
+      `【表法】${w.table.length ? w.table.join('、') : '无'}；${w.note}`,
+      `【合十】山星合十 ${r.heshi.shan.join('、') || '无'}；向星合十 ${r.heshi.xiang.join('、') || '无'}`,
+      ...(r.meta.note ? [`※ ${r.meta.note}`] : []),
+      `※ ${r.disclaimer}`,
+    ].join('\n');
+  }
   if (r.meta.action === 'advise') {
     const match = r.mingMatch
       ? [`【命宅配】${r.mingMatch.text}`]
@@ -1051,7 +1125,11 @@ function nameText(r) {
   if (r.action === 'generate') {
     return [
       `【候选名】姓 ${r.surname}（${r.gender}，喜用 ${r.bazi.favorable.join('、')}）${r.bazi.basis}`,
-      ...r.candidates.map((c) => `${c.rank}. ${c.name}　${c.chars.map((x) => `${x.char}(${x.element})${x.meaning}`).join('　')}`),
+      ...r.candidates.map((c) => {
+        const wu = c.wuge && c.wuge.available ? `　五格 ${c.wuge.summary}` : '';
+        const ph = c.phonetics && c.phonetics.available ? `　音韵 ${c.phonetics.level}（${c.phonetics.tonePattern}）` : '';
+        return `${c.rank}. ${c.name}　${c.chars.map((x) => `${x.char}(${x.element})${x.meaning}`).join('　')}${wu}${ph}`;
+      }),
       ...r.notes.map((n) => `※ ${n}`),
     ].join('\n');
   }
@@ -1064,10 +1142,20 @@ function nameText(r) {
       : '';
     return `· ${c.char}：${el}｜${fit}｜${c.meaning}${sug}`;
   };
+  const wu = r.wuge;
+  const wugeLine = wu && wu.available
+    ? `【五格】${wu.strokes.map((x) => `${x.char}${x.strokes}画`).join('＋')}｜${wu.summary}｜三才 ${wu.sancai.text}`
+    : `【五格】${wu ? wu.reason : '未算'}`;
+  const ph = r.phonetics;
+  const phLine = ph && ph.available
+    ? `【音韵】${ph.chars.map((x) => `${x.char}${x.py}${x.tone}`).join(' ')}｜声调 ${ph.tonePattern}｜${ph.level}${ph.issues.length ? `：${ph.issues.map((i) => i.text).join('；')}` : ''}`
+    : `【音韵】${ph ? ph.reason : '未算'}`;
   return [
     `【名字评估】${r.fullName}`,
     ...r.chars.map(charLine),
     r.bazi ? `【八字】日主 ${r.bazi.dayMaster && r.bazi.dayMaster.stem ? `${r.bazi.dayMaster.stem}（${r.bazi.dayMaster.element}）` : r.bazi.dayMaster}，旺衰 ${r.bazi.strength.level}（${r.bazi.strength.score}），${r.bazi.basis}` : '',
+    wugeLine,
+    phLine,
     `【结论】${r.verdict}`,
     ...r.notes.map((n) => `※ ${n}`),
   ].filter(Boolean).join('\n');