dsh-metaphysics 0.38.2 → 0.50.1

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, yingqiWindow } 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';
@@ -13,7 +13,7 @@ import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
 import { randomOf, isSeed } from './random.js';
 import { interpret, DIRECTIONS, DIRECTION_DEFAULT } from './interpret.js';
 import { followup, askPrompt } from './followup.js';
-import { crossCheck, crossText } from './crosscheck.js';
+import { crossCheck, crossText, crossSection } from './crosscheck.js';
 import { pastSignals, verifyFit } from './verify.js';
 import { rectifyBirth } from './rectify.js';
 import { buildAlmanac } from './almanac.js';
@@ -24,7 +24,7 @@ import { buildStar } from './star.js';
 import { buildNumerology } from './numerology.js';
 import { buildMbti, mbtiPaper } from './mbti.js';
 import { buildConvert } from './convert.js';
-import { classicsFor, classicsText } from './classics.js';
+import { classicsFor, classicsText, suiyunClassicOf, CLASSIC_BOOKS } from './classics.js';
 import { buildTrend } from './trend.js';
 import { buildFengshui } from './fengshui.js';
 import { buildName } from './name.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()) {
@@ -111,6 +126,10 @@ function baziText(r) {
     ? `神煞（${r.shensha.count} 见）：` + r.shensha.groups.map((g) =>
       `${g.cat}｜` + g.items.map((i) => `${i.name}(${i.pillars.map((k) => SHORT[k]).join('')})`).join('、')).join('；')
     : '神煞：—';
+  const ry = r.renyuan;
+  const renyuanLine = ry
+    ? `人元：${ry.month}月第${ry.day}日，${ry.active}${ry.activeElement}司权（${ry.segments.map((s) => `${s.stem}${s.from}–${s.to}`).join(' ')}）${ry.beyond ? '；已过 30 日表，按本气算' : ''}`
+    : '';
   const gejuLine = r.frame ? [
     `格局：${r.frame.primary ? `${r.frame.primary.name}（${r.frame.primary.evidence}）` : '—'}`,
     `　　　${r.frame.geju.map((g) => `${g.name}[${g.kind}]`).join('　')}`,
@@ -133,6 +152,7 @@ function baziText(r) {
     shenshaLine,
     `真太阳时：${r.solarTime.trueSolarText}（${r.input.geo ? r.input.geo.note + '；' : ''}${r.solarTime.note}）　晚子时：${r.input.lateZi ? '23:00 后算次日' : '23:00 后仍算当日'}`,
     `节气：上一节 ${r.jieqi.previous.name} ${r.jieqi.previous.time}　下一节 ${r.jieqi.next.name} ${r.jieqi.next.time}`,
+    ...(renyuanLine ? [renyuanLine] : []),
     `大运：${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('　')}`,
@@ -140,15 +160,33 @@ function baziText(r) {
       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})` : ''}`;
+      const e = suiyunClassicOf(r);
+      const src = e ? `｜古籍见《${CLASSIC_BOOKS[e.book].name}·${e.chapter}》` : '';
       return '岁运提示（只标干支变动，不判吉凶）：' + hits
-        .map((l) => `${l.year}${l.ganzhi} ${l.suiyun.signals.map(label).join('/')}`).join('；');
+        .map((l) => `${l.year}${l.ganzhi} ${l.suiyun.signals.map(label).join('/')}`).join('；') + src;
     })(),
     '（格局、用神、行运吉凶为扶抑＋简化调候的量化提示，非断语。）',
   ].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(' ')
     : '—');
@@ -199,6 +237,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 +394,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('用神：未取（未指明所问之事；用「询问方向」指定后即按六亲取用）');
   }
@@ -371,6 +415,11 @@ function liuyaoText(r) {
   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(' · ')}`);
   }
+  // 应期线索：只列地支与快慢，不给日期
+  const yq = r.yingqi;
+  if (yq && Array.isArray(yq.triggers) && yq.triggers.length) {
+    out.push(`应期线索：${yq.tempo} · ${yq.triggers.map((t) => `${t.labels.join('/')}${t.branch}`).join(' · ')}（只列地支，不出日期）`);
+  }
   return out.filter(Boolean).join('\n');
 }
 
@@ -391,6 +440,9 @@ export function compute(args = {}) {
     r.classics = classicsFor(r);
     const ct = classicsText(r.classics);
     if (ct) r.summary = `${r.summary}\n【古籍】\n${ct}`;
+    // 岁运提示的原文不占五条上限：只在盘面真有岁运信号时挂到结果上，摘要、解析层与面板各自取用
+    const syc = suiyunClassicOf(r);
+    if (syc) r.suiyunClassic = { ...syc, bookName: CLASSIC_BOOKS[syc.book].name };
   }
   // 超出 ΔT 覆盖范围时把精度提示顶到摘要最前，别让远期盘悄悄出错
   if (r && r.precision && r.precision.level === 'approx' && r.summary) {
@@ -421,11 +473,11 @@ 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) {
-      r.interpret.sections.push({ key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: crossText(r.cross) });
+      r.interpret.sections.push(crossSection(r.cross));
     }
   }
   // 验前事：把过去若干年的流年信号摊开（只读，不改盘）
@@ -474,8 +526,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 +604,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 +757,12 @@ 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;
+      // 应期线索：只列逢值/逢冲/逢合与旬空的出空/冲空，再给快慢方向，不换算日期
+      const yq = yingqiWindow(result, ug, { monthBranch });
+      if (yq) result.yingqi = yq;
     }
     if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
     return { ...result, ...(asOf ? { asOf } : {}), summary: liuyaoText(result) };
@@ -802,7 +863,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 +912,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 +1092,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 +1143,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 +1160,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');
@@ -1108,7 +1214,7 @@ export { geocodeAddress, resolveAddress };
 export { buildBazi, buildLiuyao, tossLines };
 export { followup, askPrompt };
 export { pastSignals, verifyFit, rectifyBirth };
-export { crossCheck, crossText };
+export { crossCheck, crossText, crossSection };
 export { buildAlmanac, buildZeri, buildChenggu, buildXiaoliuren, buildStar, buildNumerology, buildConvert };
 export { buildTrend, buildFengshui, buildName };
 

package/engine/interpret-knowledge.js

@@ -15,10 +15,10 @@ export const KNOWLEDGE = [
     id: 'bazi-yueling-siquan',
     system: 'bazi', dims: ['overall', 'career'],
     gist: '月令不是「一个月」，是当月最有权的那一个字。',
-    detail: '月令藏干按本气、中气、余气分日用事，本气当权的时间最长。所以判旺衰先看日主在月令是得令还是失令——得令者未看全局，已有三分底气。',
+    detail: '月令藏干按本气、中气、余气分日用事，本气当权的时间最长。所以判旺衰先看日主在月令是得令还是失令——得令者未看全局，已有三分底气。本插件按 30 日表算出「生在本月第几日、哪一干当权」，给的是月内轮值这一层细节；旺衰与取格仍以月令本气、透干与会支为主，不随轮值改判。',
     source: '《子平真诠》论用神；人元司权分日之说见《渊海子平》',
     status: 'variant',
-    note: '各家对中气、余气各主几日分法不同（有 7/7/16、9/3/18 等多说），本插件只取「本气当权」这一层，未细分日数。',
+    note: '各家对中气、余气各主几日分法不同（有 7/7/16、9/3/18 等多说）；本插件固定通行 30 日表（如寅月戊7丙7甲16），节当日为第 1 日，第 31 日以后按本气算、不硬分摊。司权表与本柱藏干表口径不同（子月壬、卯月甲、午月丙、酉月庚、亥月戊只出现在司权表里），两表各照原样；取格不随轮值改判。',
   },
   {
     id: 'bazi-tonggen-tougan',
@@ -66,8 +66,8 @@ export const KNOWLEDGE = [
     id: 'bazi-suiyun',
     system: 'bazi', dims: ['overall', 'career'],
     gist: '大运管十年基调，流年管当年触发。',
-    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（当值大运与流年干支相同）、运年反吟（大运与流年天克地冲）、流年伏吟（流年与原局某柱干支相同）与流年反吟（流年与原局某柱天克地冲），是传统上标记「变动较大」的年份，属于提示而非断语。本插件逐年标出四类信号：当值大运按该年立春到次年立春的区间取，交运落在年内时前后两步并列；只标干支重复与对冲，不折分数。',
-    source: '岁运并临、伏吟反吟见《三命通会》《渊海子平》',
+    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（当值大运与流年干支相同）、运年反吟（大运与流年天克地冲）、流年伏吟（流年与原局某柱干支相同）与流年反吟（流年与原局某柱天克地冲），是传统上标记「变动较大」的年份，属于提示而非断语。本插件逐年标出四类信号：当值大运按该年立春到次年立春的区间取，交运落在年内时前后两步并列；只标干支重复与对冲，不折分数。原文里「返吟」指岁运与日柱相对、「伏吟」指岁运压日，与本插件「干支相同为伏吟、天克地冲为反吟」不是同一套定义，两者并列、不合并。',
+    source: '《三命通会》卷二·总论岁运（https://www.diancang.xyz/xuanxuewushu/sanmingtonghui/7539.html）；岁运并临之说出自《渊海子平》',
     status: 'variant',
     note: '「岁运并临主大凶」是流传最广也最被滥用的说法，本插件只作变动提示，不断吉凶；大运与原局之间的伏吟反吟未逐年标注，四柱十神层面的引化也未叠入。',
   },
@@ -102,8 +102,8 @@ export const KNOWLEDGE = [
     id: 'bazi-sanming-duizhao',
     system: 'bazi', dims: ['overall', 'career'],
     gist: '同一个格，子平真诠讲怎么用，三命通会讲怎么取。',
-    detail: '两书不是谁替代谁：子平真诠以月令取用神、论顺逆成败，重「用」；三命通会按十神逐格立论，重「取」与「忌」。同看正官格，前者问财印护官、伤煞混杂，后者先说「止许一位，多则不宜」。本插件把两条并列，不合并成一句断语。',
-    source: '《子平真诠》论正官等篇；《三命通会》卷五、卷六论十神',
+    detail: '两书不是谁替代谁：子平真诠以月令取用神、论顺逆成败，重「用」；三命通会按十神逐格立论，重「取」与「忌」。同看正官格，前者问财印护官、伤煞混杂，后者先说「止许一位，多则不宜」。此本正财、偏财分章，两格各取本格一条；七杀没有单列「论偏官」，取卷五「官煞去留杂论」讲混杂时的去留。本插件把两条并列，不合并成一句断语。',
+    source: '《子平真诠》论正官等篇；《三命通会》卷五、卷六论十神与官煞去留',
     status: 'variant',
     note: '两书成书年代与流派不同，用语有出入；本插件照录通行本，不做校勘改字，也不替两家调和。',
   },
@@ -125,6 +125,42 @@ export const KNOWLEDGE = [
     status: 'variant',
     note: '化气格成立条件各家宽严不一（是否要求月令为化神、日主是否允许有根），本插件只列条件、附原文，不据此断定化气已成。',
   },
+  {
+    id: 'bazi-zaji-quyong',
+    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 分」；通关一行只按五行生克唯一确定，不据此断吉凶，也不判通关之力是否够用。',
+  },
 
   // ── 紫微 ──────────────────────────────────────────────
   {
@@ -236,10 +272,10 @@ export const KNOWLEDGE = [
     id: 'liuyao-fushen',
     system: 'liuyao', dims: ['overall'],
     gist: '用神不上卦，就去本宫首卦的同位取伏神。',
-    detail: '本卦六爻里没有用神那一类六亲，就叫用神不上卦。取法是回到本卦所属宫的首卦（八纯卦），找出该六亲所在的爻位，那一爻即伏神，本卦同一爻位上的爻叫飞神。伏神要「得出」才有用：飞神生伏神、伏神克飞神、日月生扶都算得力；飞神克伏神则受压难出。本插件给出伏神爻位、干支五行与飞伏生克关系，不出具体的出伏日期。',
+    detail: '本卦六爻里没有用神那一类六亲，就叫用神不上卦。取法是回到本卦所属宫的首卦（八纯卦），找出该六亲所在的爻位，那一爻即伏神，本卦同一爻位上的爻叫飞神。伏神要「得出」才有用：飞神生伏神、伏神克飞神、日月生扶都算得力；飞神克伏神则受压难出。本插件给出伏神爻位、干支五行、飞伏生克，并按月建日辰归成四档出伏条件（可出 / 有助有压 / 受压难出 / 未得助）；只判条件，不出应期日期。',
     source: '《卜筮正宗》伏神章；《增删卜易》伏神篇',
     status: 'variant',
-    note: '首卦里同一六亲也可能出现两次（如乾宫乾为天的父母在三爻与上爻），此时取哪一爻为伏神各家不一；本插件把候选都列出并标「伏神两现」，不代选。伏神出伏的应期各家分歧更大，故不输出日期。',
+    note: '首卦里同一六亲也可能出现两次（如乾宫乾为天的父母在三爻与上爻），此时取哪一爻为伏神各家不一；本插件把候选都列出并标「伏神两现」，不代选。出伏条件的归并口径：飞生伏、伏克飞、日辰生/比和、月建旺/相算助，飞克伏、日辰克、月破算压；有助无压为「可出」，有助有压为「有助有压」，有压无助为「受压难出」，两者都无为「未得助」。四档只并列条件、不排各家优先级；旬空只标出，不并入档位。应期各家分歧更大，仍不输出日期。',
   },
   {
     id: 'liuyao-yongshen-shuai',
@@ -263,10 +299,10 @@ export const KNOWLEDGE = [
     id: 'liuyao-yingqi',
     system: 'liuyao', dims: ['overall', 'career'],
     gist: '应期是「什么时候见分晓」，不是「哪天」。',
-    detail: '近事以日计、远事以月计；常见取法是等用神逢值、逢冲、逢合之期，或等忌神受制之期。应期法各家互有出入，同一卦不同取法可以差出很远，所以只作时间窗口的提示。',
+    detail: '近事以日计、远事以月计；常见取法是等用神逢值、逢冲、逢合之期，或等忌神受制之期。本插件只做前一半：把用神（不上卦则取伏神）的逢值、逢冲、逢合三支列出，旬空另标出空与冲空，再按月建五态给「偏速 / 偏缓 / 待解 / 未定」一个快慢方向；忌神受制与具体日期仍未做。应期法各家互有出入，同一卦不同取法可以差出很远，所以只作时间窗口的提示。',
     source: '《卜筮正宗》应期章；《增删卜易》',
     status: 'variant',
-    note: '应期取法（值日、冲、合、填实、旬空出空）各家优先级不同，本插件不做具体日期推算。',
+    note: '应期取法（值日、冲、合、填实、旬空出空）各家优先级不同，本插件只并列触发支、不排先后，也不换算日期；近事以日计、远事以月计，用哪把尺由事情远近决定，不代选。',
   },
   {
     id: 'liuyao-liushen',
@@ -423,10 +459,10 @@ export const KNOWLEDGE = [
     id: 'liuyao-yingqi-exact',
     system: 'liuyao', dims: [],
     gist: '具体应期（哪一天应验）本插件尚未推算。',
-    detail: '应期需要综合用神旺衰、动变、旬空出空、日月冲合多层条件，且各家取法不同。当前只给时间窗口的方向性提示，不给具体日期——与其给一个看起来精确、实则拍脑袋的日子，不如留白。',
+    detail: '应期需要综合用神旺衰、动变、旬空出空、日月冲合多层条件，且各家取法不同。当前只给时间窗口的方向性提示（逢值 / 逢冲 / 逢合的触发支，加一个快慢方向），不给具体日期——与其给一个看起来精确、实则拍脑袋的日子，不如留白。',
     source: '待补：《卜筮正宗》应期章逐条实现 + 已录 128 条卦例对拍（源 138 条）',
     status: 'todo',
-    note: '扩展方向：用《卜筮正宗》卦例里有明确应验日期的条目做回归，先验证再输出。',
+    note: '扩展方向：用《卜筮正宗》卦例里有明确应验日期的条目做回归，先验证再输出。0.50.0 已给出触发支与快慢方向，仍不输出日期。',
   },
 ];