dsh-metaphysics 0.34.0 → 0.38.2

package/engine/interpret.js

@@ -342,6 +342,19 @@ function baziInterpret(r) {
         return `${jiaoLine}当前大运：${pick(cur, 'ganzhi', '—')}（${curSpan}）。后续两步：${nextTwo}。\n近五年流年：${years || '—'}。\n读法：大运管"这十年的大环境"，流年管"今年的具体天气"；两者打架时，以能否动到用神为准。`;
       })(),
     },
+    (() => {
+      const hits = (r.liunian || []).filter((l) => l.suiyun && Array.isArray(l.suiyun.signals) && l.suiyun.signals.length);
+      return {
+        key: 'suiyun', label: '岁运提示',
+        text: hits.length
+          ? hits.map((l) => {
+            const stem = (l.suiyun.dayun || []).map((d) => `第${d.step}步${d.ganzhi}`).join('、');
+            return `${l.year} ${l.ganzhi}（${stem || '未到起运'}）：${l.suiyun.signals.map((s) => s.detail).join('；')}`;
+          }).join('\n') +
+            '\n读法：岁运并临、运年反吟与流年伏吟/反吟只说明干支层面重复或对冲，传统上当作「变动感较强」的信号；本插件不据此判吉凶，要落到具体年份，仍看该年是否动到用神。'
+          : '近十年没有岁运并临、运年反吟或流年伏吟/反吟。「岁运并临主大凶」这类说法流传很广，本插件只把它当变动提示，没有命中就不作额外解读。',
+      };
+    })(),
     {
       key: 'checks', label: '交叉校验',
       text: (() => {
@@ -699,6 +712,39 @@ function ziweiInterpret(r) {
     }
   }
 
+  // 三方四正复合飞化：命宫连同对宫与两个三合宫一起飞，四宫 16 条按落宫归堆
+  {
+    const fc = r.flyComposite;
+    const word = (p) => `${p}${String(p).endsWith('宫') ? '' : '宫'}`;
+    if (fc && Array.isArray(fc.sources) && fc.sources.length >= 2) {
+      const hubs = fc.targets.filter((t) => t.count >= 2);
+      const hubText = hubs.length
+        ? hubs.slice(0, 5).map((t) => `${word(t.palace)}收了 ${t.incoming.map((x) => `${word(x.from)}化${x.type}${x.star}`).join('、')}`).join('；')
+        : '四宫化出去之后没有落在同一宫，力是散开的';
+      const readings = [];
+      if (fc.groups.doubleJi.length) {
+        readings.push(`${fc.groups.doubleJi.map((t) => word(t.palace)).join('、')}收到两个以上的忌——同一件事被反复牵动，传统看作那一宫的事务容易拖着不放`);
+      }
+      if (fc.groups.luJi.length) {
+        readings.push(`${fc.groups.luJi.map((t) => word(t.palace)).join('、')}禄忌同宫：好处与在意的地方绑在一起，越想要的东西越容易反复`);
+      }
+      if (fc.groups.tripleHua.length) {
+        readings.push(`${fc.groups.tripleHua.map((t) => word(t.palace)).join('、')}三化以上会宫：那一宫同时被几种力牵住，常常是这张盘最忙的地方`);
+      }
+      if (fc.groups.selfHua.length) {
+        readings.push(`${fc.groups.selfHua.map((t) => word(t.palace)).join('、')}自化：宫干化出去又落回自己，表现为力气绕回原处`);
+      }
+      sections.push({
+        key: 'flyComposite',
+        label: '三方四正飞化',
+        text: `上一节是命宫一条线往下追；这一节把命宫连同对宫与两个三合宫（${fc.sanfang.join('、')}）一起飞：四宫各化禄权科忌，共 16 条飞化（星未上盘的只记星不记落宫），按落宫归堆。` +
+          `${hubText}。` +
+          `${readings.length ? `${readings.join('；')}。` : ''}` +
+          `读法上，会在一处的化越多，那一宫被牵动的力道越集中；落单的飞化只说明方向，不单独取象。这一层同样只描会照与方向，不折吉凶，也没有叠大限与流年四化。`,
+      });
+    }
+  }
+
   // 流月/流日/流时：流年只回答「今年」，再往下才是「这个月」「这两天」
   if (r.flow) {
     const f = r.flow;
@@ -870,6 +916,10 @@ function liuyaoInterpret(r, ask) {
     const tuiYao = (bd.jinTui || []).filter((x) => x.type === '退');
     if (jinYao.length) bodyText.push(`化进神（第${jinYao.map((x) => x.position).join('、')}爻：${jinYao.map((x) => `${x.from}→${x.to}`).join('、')}）：变出的地支与本爻同五行、且顺着往前一步，传统读作「进」——这一爻代表的人或事有后劲，往前走比退回去顺。`);
     if (tuiYao.length) bodyText.push(`化退神（第${tuiYao.map((x) => x.position).join('、')}爻：${tuiYao.map((x) => `${x.from}→${x.to}`).join('、')}）：变出的地支与本爻同五行、却倒着退一步，传统读作「退」——这一爻代表的人或事渐渐退气，别按原来的势头去推。`);
+    const jp = r.jinTuiPower;
+    if (jp && Array.isArray(jp.lines) && jp.lines.length) {
+      bodyText.push(`进退的力重（放回月建日辰看）：${jp.lines.map((l) => `第${l.position}爻${l.say}`).join('；')}。进退只管方向，走不走得动看时令托不托着；用神化进为喜，忌神化进反而是忌。`);
+    }
     bodyText.push('这些标签只说明卦体的动势，不直接定吉凶：同一支六冲，近病问的是速愈、久病问的是凶险；同一爻化进，也得看用神旺不旺、有没有月建日辰托着。');
     sections.push({ key: 'body', label: '卦体关系', text: bodyText.join('\n') });
   }
@@ -929,9 +979,36 @@ function liuyaoInterpret(r, ask) {
     sections.push({ key: 'yongshen', label: '用神落位与卦体', text: useText.join('\n') });
   }
 
+  // 全卦逐爻旺衰：不挑用神，六爻都过一遍，看整张卦的气压在哪一头
+  {
+    const hs = r.hexStrength;
+    if (hs && Array.isArray(hs.lines) && hs.lines.length) {
+      const head = hs.month && hs.month.branch
+        ? `月建 ${hs.month.branch}（${hs.month.element}）`
+        : '没有月建（未给起卦时间）';
+      const day = hs.day && hs.day.branch ? `日辰 ${hs.day.branch}（${hs.day.element}）` : '日辰 —';
+      const rows = hs.lines.map((l) => {
+        const who = l.shi ? '（世）' : l.ying ? '（应）' : '';
+        const flags = `${l.moving ? '·动' : ''}${l.kong ? '·旬空' : ''}`;
+        return `${l.position}爻${l.liuqin ? l.liuqin : ''}${l.branch}${l.element}${who}${flags}：月建${l.monthState}，${l.dayRelation}${l.chongTag ? `，${l.chongTag}` : ''}`;
+      });
+      const order = ['旺', '相', '休', '囚', '死'];
+      const dist = order.filter((k) => hs.counts[k]).map((k) => `${k}${hs.counts[k]}`).join('、');
+      const shi = hs.shi ? `世爻在${hs.shi.position}爻（月建${hs.shi.monthState}，${hs.shi.dayRelation}）` : '';
+      const ying = hs.ying ? `应爻在${hs.ying.position}爻（月建${hs.ying.monthState}，${hs.ying.dayRelation}）` : '';
+      sections.push({
+        key: 'hexStrength',
+        label: '全卦逐爻旺衰',
+        text: `整张卦按${head}、${day}逐爻过一遍：${rows.join('；')}。五态分布：${dist}——${[shi, ying].filter(Boolean).join('，')}。` +
+          `气旺的爻对应的事推进起来省力，气弱或遭月破的爻对应的事宜缓；这只是六爻全貌，用神那几爻的细节仍以上一节为准，两处不冲突时再看动爻把哪一头带动。` +
+          `判定与用神旺衰同一套（月令五态、日辰五关系、月破/暗动/冲空），只报状态，不折成分数。`,
+      });
+    }
+  }
+
   sections.push({
     key: 'limits', label: '未纳入',
-    text: '本卦没有计算：全卦逐爻的月建旺衰（现在只算到用神那几爻）、化进化退叠上月建日辰之后的实际力重、用神两现时该取哪一爻的权重、伏神出伏的应期。这些会改变"旺不旺"的判断，所以这里只给取象与方向。',
+    text: '本卦没有计算：用神两现时该取哪一爻的权重、伏神出伏的应期。化进/化退的力重只按月建五态给「得令/失令」这类档位，不折成加权分数，也不叠动变连环；这些都会改变"旺不旺"的判断，所以这里只给取象与方向。',
   });
 
   const dimensions = [

package/engine/liuyao.js

@@ -700,3 +700,148 @@ export function yongshenStrength(result, useGod, opts = {}) {
     note: '月建主这一段的旺衰，日辰看当天是扶是克；两处都只给状态标签，不折成分数，也不单独断吉凶。',
   };
 }
+
+// ── 全卦逐爻旺衰：月建日辰落到六爻全部 ──────────────────────────────
+// 与用神旺衰同一套判定（月令五态、日辰五关系、三种冲法），区别只在不挑用神：
+// 六爻每一爻都给一次，世应、动爻、旬空另标，看得出整张卦的气压在哪一头。
+export function hexagramStrength(result, opts = {}) {
+  const rows = (result && result.ben && Array.isArray(result.ben.lines))
+    ? result.ben.lines
+    : (result && Array.isArray(result.lines) ? result.lines : []);
+  if (!rows.length) return null;
+  const monthBranch = opts.monthBranch || null;
+  const dayBranch = opts.dayBranch || (result.dayGanZhi ? result.dayGanZhi.branch : null);
+  if (!monthBranch && !dayBranch) return null;
+  const monthElement = monthBranch ? zhiElementOf(monthBranch) : null;
+  const dayElement = dayBranch ? zhiElementOf(dayBranch) : null;
+  const kong = Array.isArray(result.xunKong)
+    ? result.xunKong
+    : (typeof result.xunKong === 'string' ? result.xunKong.split('') : []);
+  const shiPos = result.ben ? result.ben.shi : null;
+  const yingPos = result.ben ? result.ben.ying : null;
+
+  const lines = rows.map((l) => {
+    const element = l.element || zhiElementOf(l.branch);
+    const monthChong = !!(monthBranch && CHONG_OF[l.branch] === monthBranch);
+    const dayChong = !!(dayBranch && CHONG_OF[l.branch] === dayBranch);
+    const monthState = monthStateOf(element, monthElement);
+    const dayRelation = dayRelationOf(element, dayElement);
+    const isEmpty = kong.includes(l.branch);
+    return {
+      position: l.position,
+      name: l.name,
+      branch: l.branch,
+      element,
+      liuqin: l.liuqin ?? null,
+      shi: l.position === shiPos,
+      ying: l.position === yingPos,
+      moving: !!l.moving,
+      kong: isEmpty,
+      monthState,
+      monthSay: MONTH_STATE_SAY[monthState] || '',
+      monthChong,
+      dayRelation,
+      daySay: DAY_RELATION_SAY[dayRelation] || '',
+      dayChong,
+      chongTag: monthChong ? '月破'
+        : dayChong ? (isEmpty ? '冲空' : (l.moving ? '逢日辰冲' : '暗动')) : '',
+    };
+  });
+
+  const counts = {};
+  for (const st of MONTH_STATE_ORDER) counts[st] = lines.filter((l) => l.monthState === st).length;
+
+  const labels = [];
+  for (const st of MONTH_STATE_ORDER) if (counts[st]) labels.push(`全卦${st}${counts[st]}爻`);
+  const shiLine = lines.find((l) => l.shi) || null;
+  const yingLine = lines.find((l) => l.ying) || null;
+  if (shiLine && shiLine.monthState !== 'unknown') labels.push(`世爻月建${shiLine.monthState}`);
+  if (yingLine && yingLine.monthState !== 'unknown') labels.push(`应爻月建${yingLine.monthState}`);
+  const tagCount = (tag) => lines.filter((l) => l.chongTag === tag).length;
+  for (const tag of ['月破', '暗动', '冲空', '逢日辰冲']) {
+    const n = tagCount(tag);
+    if (n) labels.push(`${tag}${n}爻`);
+  }
+
+  return {
+    month: monthBranch ? { branch: monthBranch, element: monthElement } : null,
+    day: dayBranch ? { branch: dayBranch, element: dayElement } : null,
+    lines,
+    counts,
+    strongest: lines.filter((l) => l.monthState === '旺').map((l) => l.position),
+    weakest: lines.filter((l) => l.monthState === '死' || l.monthChong).map((l) => l.position),
+    shi: shiLine ? { position: shiLine.position, branch: shiLine.branch, monthState: shiLine.monthState, dayRelation: shiLine.dayRelation } : null,
+    ying: yingLine ? { position: yingLine.position, branch: yingLine.branch, monthState: yingLine.monthState, dayRelation: yingLine.dayRelation } : null,
+    labels,
+    note: '月建主这一段的旺衰、日辰管当天的扶克，六爻逐一给状态；判定与用神旺衰同一套，只多了世应与动爻标记。只报状态、不折分数，也不单独断吉凶。',
+  };
+}
+
+// ── 化进 / 化退的力重：进退只管方向，走不走得动看时令 ─────────────────
+// 化进只说明这一爻顺着往前走一步，能不能走实要放回月建日辰：
+//   得令（旺/相）化进 → 后劲足；休/囚化进 → 后劲有限；逢死 → 进得虚
+//   得令化退 → 退得缓（时令还托着，退得慢）；失令化退 → 退得实
+// 月破压过一切：爻遭月建冲，进退都站不稳，先看出空填实。
+// 旬空只标出来、不并进结论——动爻旬空要等出空才算数。
+// 《增删卜易》进神退神章讲「化进神须得日月生扶」，这里只做这一步，不叠动变连环。
+const JIN_VERDICT = { 旺: '后劲足', 相: '后劲足', 休: '后劲有限', 囚: '后劲有限', 死: '进得虚' };
+const TUI_VERDICT = { 旺: '退得缓', 相: '退得缓', 休: '退得实', 囚: '退得实', 死: '退得实' };
+
+/**
+ * 化进 / 化退的力重：把 body.jinTui 每一条放回月建日辰结算。
+ * @param {object} result buildLiuyao 的结果（需带 body.jinTui）
+ * @param {{monthBranch?: string, dayBranch?: string}} opts
+ */
+export function jinTuiPower(result, opts = {}) {
+  const items = result && result.body && Array.isArray(result.body.jinTui) ? result.body.jinTui : [];
+  if (!items.length) return null;
+  const rows = result && result.ben && Array.isArray(result.ben.lines) ? result.ben.lines : [];
+  const monthBranch = opts.monthBranch || null;
+  const dayBranch = opts.dayBranch || (result && result.dayGanZhi ? result.dayGanZhi.branch : null);
+  const monthElement = monthBranch ? zhiElementOf(monthBranch) : null;
+  const dayElement = dayBranch ? zhiElementOf(dayBranch) : null;
+  const kong = Array.isArray(result && result.xunKong)
+    ? result.xunKong
+    : (result && typeof result.xunKong === 'string' ? result.xunKong.split('') : []);
+
+  const lines = items.map((x) => {
+    const line = rows[x.position - 1] || null;
+    const element = (line && line.element) || zhiElementOf(x.from);
+    const monthState = monthStateOf(element, monthElement);
+    const monthChong = !!(monthBranch && CHONG_OF[x.from] === monthBranch);
+    const dayChong = !!(dayBranch && CHONG_OF[x.from] === dayBranch);
+    const dayRelation = dayRelationOf(element, dayElement);
+    const isEmpty = kong.includes(x.from);
+    // 判定顺序：无月建只报趋势 → 月破压过一切 → 按五态给进退定档
+    const verdict = !monthBranch ? '只报趋势'
+      : monthChong ? '月破失据'
+        : ((x.type === '进' ? JIN_VERDICT : TUI_VERDICT)[monthState] || '未定');
+    const monthSay = monthBranch
+      ? `月建${monthBranch}（${monthElement}）对${element}为${monthState}`
+      : '缺月建，只看日辰';
+    const daySay = dayRelation === 'unknown' ? '' : `日辰${dayBranch}（${dayElement}）${dayRelation}`;
+    const extra = [monthChong ? '又遭月破' : '', isEmpty ? '旬空待填' : '', dayChong ? '逢日辰冲' : ''].filter(Boolean);
+    return {
+      position: x.position,
+      from: x.from,
+      to: x.to,
+      type: x.type,
+      element,
+      monthState,
+      monthChong,
+      dayRelation,
+      dayChong,
+      kong: isEmpty,
+      verdict,
+      say: `${x.from}→${x.to}（${x.type}）：${monthSay}${daySay ? `，${daySay}` : ''}${extra.length ? `，${extra.join('、')}` : ''} → ${verdict}`,
+    };
+  });
+
+  return {
+    month: monthBranch ? { branch: monthBranch, element: monthElement } : null,
+    day: dayBranch ? { branch: dayBranch, element: dayElement } : null,
+    lines,
+    labels: lines.map((l) => `${l.position}爻化${l.type}·${l.verdict}`),
+    note: '进退只说这一爻往哪边走；力重是把它放回月建日辰，看有没有托着——得令则进得动、退得慢，失令则进得虚、退得实，月破压过一切。仍不直接定吉凶：用神化进为喜，忌神化进反而是忌。',
+  };
+}

package/engine/ziwei.js

@@ -518,6 +518,7 @@ export function buildZiwei(input) {
       shensha: '长生、博士随大限顺逆；将前、岁前恒顺行；天伤恒在交友、天使恒在疾厄',
       masters: '命主按命宫地支，身主按生年地支',
       liunian: '流年命宫取该年地支宫；三方四正为本宫与 +4/+8/+6；并给该年所属大限与小限',
+      flyComposite: '三方四正取本宫、对宫与两个三合宫共四宫，四宫宫干各化禄权科忌共 16 条，按落宫归堆标会聚（双忌会、禄忌同宫、三化会、自化）；只描会照，不折吉凶',
       changqu: '昌曲落宫只由时支决定，故与丑未的关系（夹/三合/同宫/无关）是结构性结论；absorb 的「清/杂」是启发式标记，依据昌曲化忌与会煞，不是断语',
     },
   };
@@ -526,14 +527,16 @@ export function buildZiwei(input) {
   chart.daxianList = daxianList(chart);
   chart.fly = flyStars(chart);
   chart.flyChains = flyChains(chart, { from: '命宫' });
+  chart.flyComposite = flyComposite(chart, { from: '命宫' });
   enrichLiunian(chart);
   // 流月/流日/流时：默认按本机当前时刻，可用 asOf 指定（如 "2026-10-22T16:00"）
   chart.flow = flowOf(chart, input.asOf);
   chart.patternSummary = {
     count: chart.patterns.length,
     good: chart.patterns.filter((p) => p.tone === 'good').map((p) => p.name),
+    neutral: chart.patterns.filter((p) => p.tone === 'neutral').map((p) => p.name),
     bad: chart.patterns.filter((p) => p.tone === 'bad').map((p) => p.name),
-    note: '格局只描述结构，不作吉凶断语；同一命盘可并存吉格与忌格',
+    note: '格局只描述结构，不作吉凶断语；同一命盘可并存吉格、中性结构与忌格',
   };
   return chart;
 }
@@ -575,19 +578,18 @@ export function detectPatterns(chart) {
 
   const lu = starBranchOf(chart, '禄存');
   const ma = starBranchOf(chart, '天马');
-  if (lu >= 0 && ma >= 0 && (lu === ma || fix(lu - ma) === 6)) add('禄马交驰', `禄存在${chart.ziwei && BRANCHES[lu]}，天马在${BRANCHES[ma]}`);
+  if (lu >= 0 && ma >= 0 && (lu === ma || fix(lu - ma) === 6)) add('禄马交驰', `禄存在${BRANCHES[lu]}，天马在${BRANCHES[ma]}`);
 
   const huo = starBranchOf(chart, '火星');
   const ling = starBranchOf(chart, '铃星');
   if (fix(soulIdx - 1) === huo && fix(soulIdx + 1) === ling) add('火铃夹命', '火星在命宫前一宫、铃星在后一宫夹命');
   if (fix(soulIdx - 1) === ling && fix(soulIdx + 1) === huo) add('火铃夹命', '铃星与火星夹命');
 
+  // 擎羊在禄存 +1、陀罗在禄存 -1，两星只能夹「禄存」那一宫；
+  // 所以「羊陀夹忌」实际就是化忌与禄存同宫，按左右两侧去找永远找不到。
   const ji = chart.palaces.find((p) => p.stars.some((s) => s.mutagen === '忌'));
-  if (ji) {
-    const jb = BRANCHES.indexOf(ji.branch);
-    if (fix(jb - 1) === starBranchOf(chart, '擎羊') && fix(jb + 1) === starBranchOf(chart, '陀罗')) {
-      add('羊陀夹忌', `化忌在${ji.branch}，擎羊陀罗夹之`);
-    }
+  if (ji && lu >= 0 && BRANCHES.indexOf(ji.branch) === lu) {
+    add('羊陀夹忌', `化忌与禄存在${ji.branch}同宫，擎羊陀罗夹之`);
   }
 
   // 铃昌陀武：四星会于命宫三方四正
@@ -605,10 +607,14 @@ export function detectPatterns(chart) {
   // ── 以下为扩展格局（条件都是星位判断，evidence 写明落在哪宫）──
   const inSoul = (name) => soul.stars.some((s) => s.name === name);
   const nearStar = (name) => near.has(name);
+  // 「夹」只要求两星分居命宫前后，不分左右——日月、左右、魁钺本来就没有固定左右；
+  // 旧写法只认一种顺序，昌曲夹命与羊陀夹命因此从未命中，日月/左右/魁钺也漏掉一半。
   const jia = (a, b) => {
     const ba = starBranchOf(chart, a);
     const bb = starBranchOf(chart, b);
-    return ba >= 0 && bb >= 0 && fix(ba + 1) === soulIdx && fix(bb - 1) === soulIdx;
+    if (ba < 0 || bb < 0) return false;
+    return (fix(ba + 1) === soulIdx && fix(bb - 1) === soulIdx)
+      || (fix(bb + 1) === soulIdx && fix(ba - 1) === soulIdx);
   };
   const mutagensIn = (indices) => {
     const set = new Set();
@@ -642,7 +648,7 @@ export function detectPatterns(chart) {
   if (jia('左辅', '右弼')) add('左右夹命', '左辅、右弼夹命宫');
   if (jia('文昌', '文曲')) add('昌曲夹命', '文昌、文曲夹命宫');
   if (jia('天魁', '天钺')) add('魁钺夹命', '天魁、天钺夹命宫');
-  if (jia('擎羊', '陀罗')) add('羊陀夹命', '擎羊、陀罗夹命宫');
+  if (jia('擎羊', '陀罗')) add('羊陀夹命', `禄存在${BRANCHES[soulIdx]}守命，擎羊陀罗前后夹之`);
 
   // 四化
   const muts = mutagensIn(sanfang);
@@ -657,9 +663,13 @@ export function detectPatterns(chart) {
   const lianzhen = starBranchOf(chart, '廉贞');
   const tianxiang = starBranchOf(chart, '天相');
   const qingyang = starBranchOf(chart, '擎羊');
-  if (lianzhen >= 0 && qingyang >= 0 && tianxiang >= 0
-    && fix(lianzhen + 1) === tianxiang && fix(qingyang - 1) === tianxiang) {
-    add('刑囚夹印', '廉贞与擎羊夹天相（刑囚夹印）');
+  // 天相与廉贞永远隔偶数宫，字面上的「廉贞、擎羊夹天相」不可能成立；
+  // 通行说法取「廉贞天相同守命宫于子午、擎羊同宫」——判的是守命那一宫，其它宫位同宫不算。
+  // 命宫卯酉、廉贞天相对照遇擎羊的变体未纳入。
+  if (lianzhen >= 0 && tianxiang >= 0 && qingyang >= 0
+    && lianzhen === tianxiang && qingyang === tianxiang && tianxiang === soulIdx
+    && (tianxiang === 0 || tianxiang === 6)) {
+    add('刑囚夹印', `廉贞天相同守命宫${BRANCHES[tianxiang]}，擎羊同宫`);
   }
   if (near.has('贪狼') && (near.has('火星') || near.has('铃星'))) {
     add('火贪铃贪', `贪狼与${near.has('火星') ? '火星' : '铃星'}会于命宫三方四正`);
@@ -676,7 +686,7 @@ export function detectPatterns(chart) {
     .map((p) => ({ ...p, tone: PATTERN_TONE[p.name] || 'neutral' }));
 }
 
-const PATTERN_TONE = {
+export const PATTERN_TONE = {
   紫府同宫: 'good', 紫府朝垣: 'good', 君臣庆会: 'good', 极向离明: 'good',
   七杀朝斗: 'good', 英星入庙: 'good', 石中隐玉: 'good', 巨日同宫: 'good',
   日月夹命: 'good', 日月对照: 'good', 左右夹命: 'good', 昌曲夹命: 'good',
@@ -795,6 +805,102 @@ export function flyChains(chart, { from = '命宫', maxSteps = 12 } = {}) {
   return out;
 }
 
+// ── 三方四正复合飞化：四宫一起飞、看落到同一宫的会聚 ─────────────────
+// 单宫飞化回答「这一宫自己去找谁」；三方四正看的是本宫连同对宫、两个三合宫
+// 四股力同时飞出去，最后在哪一宫会到一起。会在一处的化越多，那一宫被牵动的力道越集中。
+// 只归堆与标会照，不折吉凶：同样是双忌会一宫，落在生年忌和落在生年禄上意思完全不同。
+const PALACE_SUFFIX = (p) => `${p}${String(p).endsWith('宫') ? '' : '宫'}`;
+
+export function flyComposite(chart, { from = '命宫' } = {}) {
+  const palaces = chart.palaces || [];
+  const src = palaces.find((p) => p.palace === from) || palaces[0];
+  if (!src) return null;
+  const names = Array.isArray(src.sanfang) && src.sanfang.length
+    ? [...new Set(src.sanfang)].slice(0, 4)
+    : [src.palace];
+
+  const sources = [];
+  for (const name of names) {
+    const p = palaces.find((x) => x.palace === name);
+    if (!p) continue;
+    sources.push({
+      palace: p.palace,
+      branch: p.branch,
+      stem: p.stem,
+      flies: FLY_TYPES.map((type) => {
+        const star = flyStarOf(p.stem, type);
+        const b = star ? starBranchOf(chart, star) : -1;
+        const target = b >= 0 ? palaces.find((x) => x.branch === BRANCHES[b]) : null;
+        return {
+          type,
+          star,
+          to: target ? target.palace : null,
+          toBranch: target ? target.branch : null,
+          self: !!(target && target.palace === p.palace),
+        };
+      }),
+    });
+  }
+
+  // 16 条飞化按落宫归堆；未上盘的星不计入落点
+  const targets = [];
+  for (const p of palaces) {
+    const incoming = [];
+    for (const s of sources) {
+      for (const f of s.flies) {
+        if (f.to === p.palace) {
+          incoming.push({ from: s.palace, fromBranch: s.branch, fromStem: s.stem, type: f.type, star: f.star, self: f.self });
+        }
+      }
+    }
+    if (!incoming.length) continue;
+    targets.push({
+      palace: p.palace,
+      branch: p.branch,
+      incoming,
+      types: [...new Set(incoming.map((x) => x.type))],
+      count: incoming.length,
+    });
+  }
+  targets.sort((a, b) => b.count - a.count || BRANCHES.indexOf(a.branch) - BRANCHES.indexOf(b.branch));
+
+  const jiAt = (t) => t.incoming.filter((x) => x.type === '忌').length;
+  const groups = {
+    doubleJi: targets.filter((t) => jiAt(t) >= 2),
+    luJi: targets.filter((t) => t.types.includes('禄') && t.types.includes('忌')),
+    tripleHua: targets.filter((t) => t.types.length >= 3),
+    selfHua: targets.filter((t) => t.incoming.some((x) => x.self)),
+  };
+
+  const labels = [];
+  for (const t of groups.doubleJi) labels.push(`${['', '', '双忌', '三忌', '四忌'][jiAt(t)] || `${jiAt(t)}忌`}会${PALACE_SUFFIX(t.palace)}`);
+  for (const t of groups.luJi) labels.push(`禄忌同宫${PALACE_SUFFIX(t.palace)}`);
+  const HUA_NUM = { 3: '三化会', 4: '四化会' };
+  for (const t of groups.tripleHua) labels.push(`${HUA_NUM[t.types.length] || `${t.types.length}化会`}${PALACE_SUFFIX(t.palace)}`);
+  for (const t of groups.selfHua) labels.push(`${PALACE_SUFFIX(t.palace)}自化`);
+
+  const byType = {};
+  for (const type of FLY_TYPES) {
+    byType[type] = sources
+      .map((s) => {
+        const f = s.flies.find((x) => x.type === type);
+        return f && f.to ? { from: s.palace, star: f.star, to: f.to, self: f.self } : null;
+      })
+      .filter(Boolean);
+  }
+
+  return {
+    from: src.palace,
+    sanfang: sources.map((s) => s.palace),
+    sources,
+    targets,
+    groups,
+    byType,
+    labels,
+    note: '三方四正取本宫、对宫与两个三合宫共四宫，四宫宫干各化禄权科忌共 16 条飞化，按落宫归堆；只在落宫相同（会照）时标会聚，单条飞出不另立标签。只描会照与方向，不折吉凶，也未叠大限流年四化。',
+  };
+}
+
 // ── 流年四化落宫 ────────────────────────────────────────────
 
 export function enrichLiunian(chart) {

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "命理排盘（玄学）· 八字紫微六爻梅花六壬奇门合盘塔罗",
-    "description": "玄学命理排盘：十九套体系一站排盘——既有的八套排盘（八字、紫微、六爻、梅花、大六壬、奇门、合盘、塔罗）之外，另有十一套速查（黄历、农历互转、择日、称骨、小六壬、星座、生命数字、人生K线、风水、起名、十六型人格）：八字（藏干十神、十二长生、42 神煞、旺衰、格局用神、大运流年吉凶评分）、紫微斗数（49 星曜与主星庙旺、四层十二神、34 格局、大限、流年流月流日流时四化）、六爻纳甲、梅花易数、大六壬（天地盘/四课/三传）、奇门遁甲（拆补/超神接气/置闰三派取局）、合盘（八字与紫微两套）与塔罗；另有所问之事驱动的解析与详解。纯本地计算、默认不联网，作为 Agent 工具供对话调用，并提供可切换本命/大限/流年视图的 Web 面板。"
+    "description": "玄学命理排盘：十九套体系一站排盘——既有的八套排盘（八字、紫微、六爻、梅花、大六壬、奇门、合盘、塔罗）之外，另有十一套速查（黄历、农历互转、择日、称骨、小六壬、星座、生命数字、人生K线、风水、起名、十六型人格）：八字（藏干十神、十二长生、42 神煞、旺衰、格局用神、大运流年吉凶评分）、紫微斗数（49 星曜与主星庙旺、四层十二神、34 格局、大限、流年流月流日流时四化）、六爻纳甲、梅花易数、大六壬（天地盘/四课/三传）、奇门遁甲（拆补/超神接气/置闰三派取局）、合盘（八字与紫微两套）与塔罗；另有所问之事驱动的解析与详解。纯本地计算、默认不联网，作为 Agent 工具供对话调用，并提供可切换本命/大限/流年视图的 Web 面板。紫微含飞星串连与三方四正复合飞化，六爻含用神旺衰与全卦逐爻旺衰。"
   }
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.34.0",
+  "version": "0.38.2",
   "type": "module",
-  "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: nineteen systems and eleven quick references (almanac, solar–lunar conversion, …), with climate adjustment (tiaohou), the 120 Qiongtong Baojian entries, 391-char name library, classical quotes (Ziping Zhenquan / Di Tian Sui), hexagram body relations (六冲/六合/伏吟/反吟/化进神/化退神) plus yongshen placement (用神落位) with month/day strength (月建日辰旺衰) for liuyao, plus an MBTI-style 16-type questionnaire and exact dayun handover dates (交运日), palace conditions (击刑/入墓), month states (旺相休囚死) and stem–palace relations (天盘干与宫生克) for qimen, flying four-transformations (四化飞星串连) for ziwei, and a bundled offline single-file page (命理排盘.html).",
+  "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: nineteen systems and eleven quick references (almanac, solar–lunar conversion, …), with climate adjustment (tiaohou), the 120 Qiongtong Baojian entries, 391-char name library, classical quotes (Ziping Zhenquan / Di Tian Sui / San Ming Tong Hui), hexagram body relations (六冲/六合/伏吟/反吟/化进神/化退神) plus yongshen placement (用神落位) with month/day strength (月建日辰旺衰) and whole-hexagram per-line strength (全卦逐爻旺衰) for liuyao, plus an MBTI-style 16-type questionnaire and exact dayun handover dates (交运日) with annual suiyun hints (岁运并临/伏吟反吟), palace conditions (击刑/入墓), month states (旺相休囚死) and stem–palace relations (天盘干与宫生克) for qimen, flying four-transformations with chained flights (四化飞星串连) and three-way-four-corner composite flights (三方四正复合飞化) for ziwei, and a bundled offline single-file page (命理排盘.html), and a panel-to-chat handoff that asks the Harness about a finished chart.",
   "keywords": [
     "玄学",
     "玄学排盘",
@@ -60,6 +60,18 @@
     "node": ">=18",
     "dsh": ">=0.2.0"
   },
+  "scripts": {
+    "build": "node tools/build-client.mjs",
+    "build:html": "node tools/build-html.mjs",
+    "build:desktop": "node tools/build-html.mjs --desktop",
+    "test": "node tools/test-all.mjs",
+    "test:ci": "node tools/build-client.mjs && node tools/check-bundle.mjs && node tools/test-all.mjs && node tools/check-assertions.mjs && node tools/verify-tests-can-fail.mjs && node tools/check-html-sinks.mjs && node tools/check-patterns.mjs",
+    "test:baseline": "node tools/check-assertions.mjs --update",
+    "check:html": "node tools/check-html-sinks.mjs",
+    "check:bundle": "node tools/check-bundle.mjs",
+    "check:patterns": "node tools/check-patterns.mjs",
+    "release": "node tools/release.mjs"
+  },
   "exports": {
     ".": "./index.js",
     "./client": "./client.js",
@@ -78,6 +90,7 @@
     "icon.svg",
     "README.md",
     "CHANGELOG.md",
+    "docs/assets",
     "LICENSE"
   ],
   "dsh": {
@@ -89,16 +102,5 @@
       "immediately": true,
       "inject": []
     }
-  },
-  "scripts": {
-    "build": "node tools/build-client.mjs",
-    "build:html": "node tools/build-html.mjs",
-    "test": "node tools/test-all.mjs",
-    "test:ci": "node tools/build-client.mjs && node tools/check-bundle.mjs && node tools/test-all.mjs && node tools/check-assertions.mjs && node tools/verify-tests-can-fail.mjs && node tools/check-html-sinks.mjs && node tools/check-patterns.mjs",
-    "test:baseline": "node tools/check-assertions.mjs --update",
-    "check:html": "node tools/check-html-sinks.mjs",
-    "check:bundle": "node tools/check-bundle.mjs",
-    "check:patterns": "node tools/check-patterns.mjs",
-    "release": "node tools/release.mjs"
   }
-}
+}