dsh-metaphysics 0.34.0 → 0.46.5

package/engine/index.js

@@ -1,7 +1,7 @@
 // 统一入口：解析参数、分派到各体系、生成可读摘要
 import { buildBazi } from './bazi.js';
-import { buildLiuyao, tossLines, bodyLabels, yongshenOf, yongshenStrength } 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';
@@ -12,7 +12,7 @@ import { geocodeAddress, resolveAddress } from './geo.js';
 import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
 import { randomOf, isSeed } from './random.js';
 import { interpret, DIRECTIONS, DIRECTION_DEFAULT } from './interpret.js';
-import { followup } from './followup.js';
+import { followup, askPrompt } from './followup.js';
 import { crossCheck, crossText } from './crosscheck.js';
 import { pastSignals, verifyFit } from './verify.js';
 import { rectifyBirth } from './rectify.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()) {
@@ -136,12 +151,35 @@ function baziText(r) {
     `大运：${r.dayun.rule}（${r.dayun.direction}），${r.dayun.startAge.years}岁${r.dayun.startAge.months}个月起运${jiao}`,
     `　${dayun}`,
     `流年：${r.liunian.slice(0, 10).map((l) => `${l.year}${l.ganzhi}(${l.stemTenGod})${l.luck ? `·${l.luck.tier}` : ''}`).join('　')}`,
+    (() => {
+      const hits = r.liunian.filter((l) => l.suiyun && l.suiyun.signals && l.suiyun.signals.length);
+      if (!hits.length) return '岁运提示：近十年无岁运并临、运年反吟或流年伏吟/反吟（只标干支，不判吉凶）';
+      const label = (s) => `${s.type}${s.type.startsWith('流年') && s.target ? `(${s.target})` : ''}`;
+      return '岁运提示（只标干支变动，不判吉凶）：' + hits
+        .map((l) => `${l.year}${l.ganzhi} ${l.suiyun.signals.map(label).join('/')}`).join('；');
+    })(),
     '（格局、用神、行运吉凶为扶抑＋简化调候的量化提示，非断语。）',
   ].join('\n') + near;
 }
 
 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(' ')
     : '—');
@@ -174,15 +212,29 @@ function ziweiText(r) {
     const text = ['禄', '权', '科', '忌'].map(one).filter(Boolean).join('　');
     return text ? `【命宫飞星】${text}` : '';
   })();
+  // 三方四正一起飞：四宫的 16 条飞化按落宫归堆，只看会聚
+  const flyCompositeLine = (() => {
+    const fc = r.flyComposite;
+    if (!fc || !Array.isArray(fc.sources) || !fc.sources.length) return '';
+    const groups = fc.labels.length ? fc.labels.join(' · ') : '无同宫会聚';
+    const detail = ['禄', '权', '科', '忌'].map((t) => {
+      const list = ((fc.byType && fc.byType[t]) || []).filter((x) => !x.self);
+      const tos = [...new Set(list.map((x) => String(x.to).replace(/宫$/, '')))];
+      return tos.length ? `${t}→${tos.join('/')}` : '';
+    }).filter(Boolean).join('　');
+    return `【三方四正飞化】${fc.sanfang.join('·')}：${groups}${detail ? `　${detail}` : ''}`;
+  })();
   return [
     `【农历】${lunarText}（月首 ${r.lunar.monthStart}）　时支：${r.hourBranch}　年干支：${r.yearGanzhi}`,
     `【时刻】${r.solarTime ? `${r.solarTime.civilText} → 真太阳时 ${r.solarTime.trueSolarText}${r.input.geo ? '（' + r.input.geo.note + '）' : ''}` : ''}`,
     `【命宫】${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,
+    flyCompositeLine,
     '十二宫：',
     ...rows,
     '大限（按起运年龄排序，前 8 限，宫干四化落宫）：',
@@ -190,7 +242,7 @@ function ziweiText(r) {
     '流年（前 6 年，完整 12 年在结构化数据里）：',
     ...liunian,
     `【格局】${patterns}`,
-    r.patternSummary ? `【结构统计】吉格 ${r.patternSummary.good.length}、忌格 ${r.patternSummary.bad.length}；${r.patternSummary.note}` : '',
+    r.patternSummary ? `【结构统计】吉格 ${r.patternSummary.good.length}、中性 ${r.patternSummary.neutral.length}、忌格 ${r.patternSummary.bad.length}；${r.patternSummary.note}` : '',
     r.lunar.note ? `注：${r.lunar.note}` : '',
   ].filter(Boolean).join('\n');
 }
@@ -335,9 +387,27 @@ 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('用神：未取（未指明所问之事；用「询问方向」指定后即按六亲取用）');
   }
+  // 全卦逐爻旺衰：不挑用神，六爻都给状态，世应、动爻、旬空另标
+  const hexSt = r.hexStrength;
+  if (hexSt && Array.isArray(hexSt.labels) && hexSt.labels.length) {
+    const m = hexSt.month && hexSt.month.branch
+      ? `月建 ${hexSt.month.branch}（${hexSt.month.element}）　`
+      : '无月建（未给起卦时间）　';
+    out.push(`全卦旺衰：${m}${hexSt.labels.join(' · ')}`);
+  }
+  // 化进/化退的力重：单列一行，免得跟卦体标签混着读
+  const jt = r.jinTuiPower;
+  if (jt && Array.isArray(jt.lines) && jt.lines.length) {
+    out.push(`进退力重：${jt.lines.map((l) => `${l.position}爻${l.from}→${l.to}${l.type}·${l.verdict}`).join(' · ')}`);
+  }
   return out.filter(Boolean).join('\n');
 }
 
@@ -388,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) {
@@ -441,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);
   // 一页读懂：报告顶部的五条结论，先给读的人一个「整体形状」
@@ -518,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,
@@ -649,20 +722,29 @@ function computeRaw(args = {}) {
     }
     // 用神挂在结果上：摘要、面板、解析三层读同一份，避免各自取一次走散
     const ug = yongshenOf(result, { direction: args.direction, gender: args.gender });
-    if (ug.liuqin) {
-      result.useGod = ug;
-      // 月建按节气换月、与八字同源：从同一个 snapshot 取月支，取不到就只按日辰算
-      let monthBranch = null;
-      if (stamp) {
-        try {
-          const snap = buildSnapshot({ year: stamp.year, month: stamp.month, day: stamp.day, hour: stamp.hour, minute: stamp.minute });
-          monthBranch = (snap.monthGanZhi || '')[1] || null;
-        } catch {
-          monthBranch = null;
-        }
+    if (ug.liuqin) result.useGod = ug;
+    // 月建按节气换月、与八字同源：从同一个 snapshot 取月支，取不到就只按日辰算
+    let monthBranch = null;
+    if (stamp) {
+      try {
+        const snap = buildSnapshot({ year: stamp.year, month: stamp.month, day: stamp.day, hour: stamp.hour, minute: stamp.minute });
+        monthBranch = (snap.monthGanZhi || '')[1] || null;
+      } catch {
+        monthBranch = null;
       }
+    }
+    // 全卦逐爻旺衰不依赖用神：没指定所问之事也要能看整张卦的气
+    const hexStrength = hexagramStrength(result, { monthBranch, dayBranch: result.dayGanZhi.branch });
+    if (hexStrength) result.hexStrength = hexStrength;
+    // 化进/化退的力重：与旺衰同一套五态/五关系，只说走不走得动
+    const jtPower = jinTuiPower(result, { monthBranch, dayBranch: result.dayGanZhi.branch });
+    if (jtPower) result.jinTuiPower = jtPower;
+    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) };
@@ -763,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,
@@ -802,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 ? {
@@ -980,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}`]
@@ -1012,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');
   }
@@ -1025,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');
@@ -1067,7 +1194,7 @@ export function renderText(result) {
 export { geocodeAddress, resolveAddress };
 
 export { buildBazi, buildLiuyao, tossLines };
-export { followup };
+export { followup, askPrompt };
 export { pastSignals, verifyFit, rectifyBirth };
 export { crossCheck, crossText };
 export { buildAlmanac, buildZeri, buildChenggu, buildXiaoliuren, buildStar, buildNumerology, buildConvert };

package/engine/interpret-knowledge.js

@@ -66,10 +66,10 @@ export const KNOWLEDGE = [
     id: 'bazi-suiyun',
     system: 'bazi', dims: ['overall', 'career'],
     gist: '大运管十年基调，流年管当年触发。',
-    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（大运与流年干支相同）与伏吟反吟（干支重复或与原局对冲）是传统上标记「变动较大」的年份，属于提示而非断语。',
+    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（当值大运与流年干支相同）、运年反吟（大运与流年天克地冲）、流年伏吟（流年与原局某柱干支相同）与流年反吟（流年与原局某柱天克地冲），是传统上标记「变动较大」的年份，属于提示而非断语。本插件逐年标出四类信号：当值大运按该年立春到次年立春的区间取，交运落在年内时前后两步并列；只标干支重复与对冲，不折分数。',
     source: '岁运并临、伏吟反吟见《三命通会》《渊海子平》',
     status: 'variant',
-    note: '「岁运并临主大凶」是流传最广也最被滥用的说法，本插件只作变动提示，不断吉凶。',
+    note: '「岁运并临主大凶」是流传最广也最被滥用的说法，本插件只作变动提示，不断吉凶；大运与原局之间的伏吟反吟未逐年标注，四柱十神层面的引化也未叠入。',
   },
   {
     id: 'bazi-liuqin',
@@ -98,6 +98,61 @@ export const KNOWLEDGE = [
     status: 'settled',
   },
 
+  {
+    id: 'bazi-sanming-duizhao',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '同一个格，子平真诠讲怎么用，三命通会讲怎么取。',
+    detail: '两书不是谁替代谁：子平真诠以月令取用神、论顺逆成败，重「用」；三命通会按十神逐格立论，重「取」与「忌」。同看正官格，前者问财印护官、伤煞混杂，后者先说「止许一位，多则不宜」。此本正财、偏财分章，两格各取本格一条；七杀没有单列「论偏官」，取卷五「官煞去留杂论」讲混杂时的去留。本插件把两条并列，不合并成一句断语。',
+    source: '《子平真诠》论正官等篇；《三命通会》卷五、卷六论十神与官煞去留',
+    status: 'variant',
+    note: '两书成书年代与流派不同，用语有出入；本插件照录通行本，不做校勘改字，也不替两家调和。',
+  },
+  {
+    id: 'bazi-geju-chengbai',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '格有成有败：成中带忌会打折，败中有救还能转成。',
+    detail: '月令取到格只是起点。成格要看有没有带忌——官逢财又逢伤、官透而被合、财旺生官又逢伤，都会把成格打折；败格也看有没有救应——印来解伤、合来清煞、劫来解财，败中可转。所以判格不能只报一个格名。',
+    source: '《子平真诠》九、论用神成败救应',
+    status: 'variant',
+    note: '各家对成格条件与带忌轻重的排序不同（有先看刑冲、有先看合化），本插件只把原文与成败方向并列摆出，不逐盘判成破。',
+  },
+  {
+    id: 'bazi-huagi-bianhua',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '月令用神会因合化而变：同一个起点，取用可以不同。',
+    detail: '用神本从月令取，但月令藏干不一，透出的字不同、支会合局不同，取用就跟着变：丁生亥月本为正官，支全卯未化为印；己生申月本属伤官，藏庚透壬化为财。所以看到化气格，要回头核对月令与合局，不能只按本气定格。',
+    source: '《子平真诠》十、论用神变化；化气条件各家另论',
+    status: 'variant',
+    note: '化气格成立条件各家宽严不一（是否要求月令为化神、日主是否允许有根），本插件只列条件、附原文，不据此断定化气已成。',
+  },
+  {
+    id: 'bazi-zhuanwang-yuanwen',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '专旺五格各有专章：成格要看局全带印，不只看身强。',
+    detail: '三命通会卷六曲直、炎上、从革、润下、稼穑五篇各立一格：曲直须亥卯未带亥，炎上须寅午戌带寅，从革须巳酉丑带丙丁巳午，润下须申子辰全，稼穑取四季土。原文的条件都比「身强」细：要局全、要带印或带火炼金，还要防冲刑死绝。本插件把命中的那一篇附在结果里，只作结构说明。',
+    source: '《三命通会》卷六·曲直、炎上、从革、润下、稼穑',
+    status: 'variant',
+    note: '专旺是否必须成方局、是否允许一点官杀财，各家宽严不一；原文五篇之间条件也不齐（润下重忌冲刑、稼穑重四季土）。本插件只按「同类+印 ≥5、官杀财皆弱」列出并附原文，不据此断贵贱，也不补专旺的破格条件。',
+  },
+  {
+    id: 'bazi-congge-yuanwen',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '从格是身无归处才「弃命」相从：一见根气就破格。',
+    detail: '三命通会卷五弃命从煞、卷六弃命从财各有一篇：从煞要煞重身柔、四柱无一点比肩印绶；从财要财会成局、日干无气，原文说「若逢根气，命损无猜」。两篇都说行运喜财煞旺地、忌扶身。本插件只在盘面出现从财格或从杀格时附上对应原文；从儿、从强没有单章，不硬凑。',
+    source: '《三命通会》卷五·弃命从煞；卷六·弃命从财',
+    status: 'variant',
+    note: '从格成立条件各家分歧很大：是否允许日主有微根、阴阳干从与不从（原文说阳木不能从）、从儿与从强算不算正从，说法不一。本插件只列结构与原文，不据此断吉凶，也不补从儿、从强的原文。',
+  },
+  {
+    id: 'bazi-tongguan',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '两神相战要有中间一行接上，对峙才化成相生。',
+    detail: '用神与忌神两行在局中各 ≥1.5 分、又正好相克时，五行里只有一行能接上：克方生它、它再生被克方（金克木则以水为关，土克水则以金为关）。滴天髓用织女、牛郎隔关相望作比，说「此关若通也，相邀入洞房」。本插件只按局中分量点出这一行，并写明它是不是忌神。',
+    source: '《滴天髓》通神论·通关；五行生克为通行说',
+    status: 'variant',
+    note: '各家对「两神相战」取哪两神不一（有取日主与官杀、有取用神与忌神、有取局中最旺两行），本插件固定取「用神与克它的忌神，且两行各 ≥1.5 分」；通关一行只按五行生克唯一确定，不据此断吉凶，也不判通关之力是否够用。',
+  },
+
   // ── 紫微 ──────────────────────────────────────────────
   {
     id: 'ziwei-sanfang',
@@ -158,7 +213,16 @@ export const KNOWLEDGE = [
     detail: '生年四化是先天带的，飞星四化是宫位自己去找的：每一宫的宫干定出禄权科忌四颗星，那几颗星落在哪一宫，就是这一宫的力气往哪边使。所以同一个「化忌」，从命宫飞出去和从财帛飞出去，说的是两件事。',
     source: '《紫微斗数全书》四化篇；中州派宫干四化传法',
     status: 'variant',
-    note: '飞星派（如钦天四化）把宫干四化当主线，三合派只作辅助；庚干四化各派另有异说，本插件取中州派常用表。',
+    note: '飞星派（如钦天四化）把宫干四化当主线，三合派只作辅助；庚干四化各派另有异说，本插件取中州派常用表。飞星串连与三方四正复合飞化现已给出，但未叠大限流年四化。',
+  },
+  {
+    id: 'ziwei-sanfang-fei',
+    system: 'ziwei', dims: ['overall', 'career'],
+    gist: '三方四正一起飞，看四股力会到哪一宫。',
+    detail: '单宫飞化只看本宫宫干把四化送去哪里；三方四正复合飞化把本宫、对宫与两个三合宫共四宫的宫干四化同时摊开，约 16 条，按落宫归堆，落到同一宫的就是会照。会在一处的化越多，那一宫被牵动的力道越集中；两忌以上会宫、禄忌同宫、三化以上会宫、宫干化出又落回本宫（自化），是这一层最常取的几种情形。',
+    source: '《紫微斗数全书》四化篇；飞星派三方四正同飞说',
+    status: 'variant',
+    note: '飞星派对「三方四正一起飞」是否成立、会照要不要折成分数，各家口径不一；本插件只做落宫归堆与会照标记，不折分数，也未叠大限流年四化。',
   },
   {
     id: 'ziwei-jichuanji',
@@ -199,10 +263,10 @@ export const KNOWLEDGE = [
     id: 'liuyao-fushen',
     system: 'liuyao', dims: ['overall'],
     gist: '用神不上卦，就去本宫首卦的同位取伏神。',
-    detail: '本卦六爻里没有用神那一类六亲，就叫用神不上卦。取法是回到本卦所属宫的首卦（八纯卦），找出该六亲所在的爻位，那一爻即伏神，本卦同一爻位上的爻叫飞神。伏神要「得出」才有用：飞神生伏神、伏神克飞神、日月生扶都算得力；飞神克伏神则受压难出。本插件给出伏神爻位、干支五行与飞伏生克关系，不出具体的出伏日期。',
+    detail: '本卦六爻里没有用神那一类六亲，就叫用神不上卦。取法是回到本卦所属宫的首卦（八纯卦），找出该六亲所在的爻位，那一爻即伏神，本卦同一爻位上的爻叫飞神。伏神要「得出」才有用：飞神生伏神、伏神克飞神、日月生扶都算得力；飞神克伏神则受压难出。本插件给出伏神爻位、干支五行、飞伏生克，并按月建日辰归成四档出伏条件（可出 / 有助有压 / 受压难出 / 未得助）；只判条件，不出应期日期。',
     source: '《卜筮正宗》伏神章；《增删卜易》伏神篇',
     status: 'variant',
-    note: '首卦里同一六亲也可能出现两次（如乾宫乾为天的父母在三爻与上爻），此时取哪一爻为伏神各家不一；本插件把候选都列出并标「伏神两现」，不代选。伏神出伏的应期各家分歧更大，故不输出日期。',
+    note: '首卦里同一六亲也可能出现两次（如乾宫乾为天的父母在三爻与上爻），此时取哪一爻为伏神各家不一；本插件把候选都列出并标「伏神两现」，不代选。出伏条件的归并口径：飞生伏、伏克飞、日辰生/比和、月建旺/相算助，飞克伏、日辰克、月破算压；有助无压为「可出」，有助有压为「有助有压」，有压无助为「受压难出」，两者都无为「未得助」。四档只并列条件、不排各家优先级；旬空只标出，不并入档位。应期各家分歧更大，仍不输出日期。',
   },
   {
     id: 'liuyao-yongshen-shuai',
@@ -213,6 +277,15 @@ export const KNOWLEDGE = [
     status: 'variant',
     note: '月破、暗动、冲空三者各家取法不完全一致（有派别把日冲动爻也叫暗动，有派别只认旺相之爻暗动）；本插件按「月建冲=月破、日冲静爻=暗动、日冲旬空=冲空」这一套给标签，并注明用了哪一支月建。',
   },
+  {
+    id: 'liuyao-quanggu-shuai',
+    system: 'liuyao', dims: ['overall', 'work'],
+    gist: '全卦逐爻看月建，才看得出气聚在哪一头。',
+    detail: '月建管这一段时令的旺衰、日辰管当天的扶克，落到全部六爻逐爻判定：每爻都出月令五态（旺相休囚死）与日辰五关系，并标月破、暗动、冲空。世爻、应爻、动爻与旬空另标，五态分布能看出气是聚在世应还是散在旁爻——用神只是其中一处落点，不看全卦容易把一处当全局。',
+    source: '《增删卜易》月建章、日辰章；《卜筮正宗》六爻旺衰论',
+    status: 'variant',
+    note: '各家对月破、暗动、冲空的取法不完全一致，是否给六爻折力重（分数）分歧更大；本插件只给状态标签与五态分布，不折分数。',
+  },
   {
     id: 'liuyao-yingqi',
     system: 'liuyao', dims: ['overall', 'career'],
@@ -278,7 +351,7 @@ export const KNOWLEDGE = [
     id: 'liuyao-jintui-yong',
     system: 'liuyao', dims: ['overall', 'work'],
     gist: '化进化退要看是用神还是忌神，还要叠月建日辰。',
-    detail: '进神退神本身只说明这一爻的向外趋势：用神化进为得力，忌神化进则为患加剧；用神化退是力衰，忌神化退反而是解脱。传统还要看它在本月令衰旺、有没有日辰生扶，空亡或受克时进者未必能进。所以本插件只标出化进/化退与爻位，力重与吉凶仍留给用神一节判断。',
+    detail: '进神退神本身只说明这一爻的向外趋势：用神化进为得力，忌神化进则为患加剧；用神化退是力衰，忌神化退反而是解脱。传统还要看它在本月令衰旺、有没有日辰生扶，空亡或受克时进者未必能进。本插件把进退与爻位标出来，再按月建五态给一档力重——得令则进得动、退得慢，失令则进得虚、退得实，月破压过一切；只给档位，不折成加权分数，吉凶仍落在用神与忌神那一层判。',
     source: '《增删卜易》进神退神章、用神章',
     status: 'variant',
     note: '土之进退次序各家说法不完全一致，有以丑→辰→未→戌为进、也有只取辰戌丑未相对者；本插件按丑辰未戌成环处理，并用《增删卜易》卦例中「未土化戌土为进」「戌土化未土为退」对拍。',