dsh-metaphysics 0.63.0 → 0.65.0

package/engine/diff.js

@@ -338,9 +338,29 @@ export const CALIBER_SWITCHES = {
     ziweiSchoolSwitch('shenzhuSchool', '身主：子午皆火星 / 子铃午火', '身主', 'common', 'verse', {
       common: '子午皆火星', verse: '子铃午火（安身主诀逐字）',
     }),
+    ziweiSchoolSwitch('mingzhuSchool', '命主取法：命宫地支 / 生年年支', '命主取法', 'soul-branch', 'year-branch', {
+      'soul-branch': '命宫地支（通行本）', 'year-branch': '生年年支（中州派）',
+    }),
     ziweiSchoolSwitch('zuoyaoSchool', '杂曜：49 颗简盘 / 61 颗全表', '杂曜全表', 'minimal', 'full', {
       minimal: '49 颗（简盘）', full: '61 颗（加十二颗杂曜）',
     }),
+    ziweiSchoolSwitch('liunianSihua', '流年四化取干：流年天干 / 流年命宫宫干', '流年四化取干', 'year-stem', 'life-palace-stem', {
+      'year-stem': '流年天干', 'life-palace-stem': '流年命宫宫干',
+    }),
+    // 十干四化变体有十一档，口径卡只拿「甲干廉破曲阳」当对照样本：
+    // 甲年换成文曲化科、太阳化忌这一档，与本插件默认的武曲化科最近、最能看出整表在动。
+    ziweiSchoolSwitch('sihuaVariant', '十干四化：通行表 / 变体整表替换', '十干四化变体', 'default', '廉破曲阳', {
+      default: '各干通行表', 廉破曲阳: '甲干 廉破曲阳',
+      贪阴阳机: '戊干 贪阴阳机', 阳武同阴: '庚干 阳武同阴', 阳武府同: '庚干 阳武府同',
+      阳武府相: '庚干 阳武府相', 阳武同相: '庚干 阳武同相', 巨阳武昌: '辛干 巨阳武昌',
+      梁紫府武: '壬干 梁紫府武', 梁紫相武: '壬干 梁紫相武', 破巨阳贪: '癸干 破巨阳贪',
+    }),
+    ziweiSchoolSwitch('jieluSchool', '截路空亡：照常 / 不排（中州派）', '截路空亡', 'off', 'zhongzhou', {
+      off: '照常（截空/副截/旬空/副旬）', zhongzhou: '不排（中州派）',
+    }),
+    ziweiSchoolSwitch('suipoSchool', '岁前十二神：照常 / 大耗改岁破（中州派）', '岁前十二神', 'off', 'zhongzhou', {
+      off: '照常（大耗）', zhongzhou: '大耗改岁破',
+    }),
   ],
   qimen: [
     {

package/engine/index.js

@@ -78,7 +78,8 @@ function requireGender(value, who = '') {
 const ZIWEI_SCHOOL_KEYS = [
   'brightnessSchool', 'gengYearSihua', 'tianmaSchool', 'tiankongSchool', 'jiekongSchool',
   'kuiyueSchool', 'tianshiTianshang', 'changshengSchool', 'lateZishi', 'shenzhuSchool',
-  'zuoyaoSchool',
+  'mingzhuSchool', 'zuoyaoSchool', 'liunianSihua', 'sihuaVariant',
+  'jieluSchool', 'suipoSchool',
 ];
 
 /** 紫微流派参数原样透传；非法值交给引擎按默认口径回退 */
@@ -211,8 +212,9 @@ function ziweiText(r) {
     const labels = {
       brightnessSchool: '亮度', gengYearSihua: '庚干四化', tianmaSchool: '天马', tiankongSchool: '天空',
       jiekongSchool: '截空', kuiyueSchool: '魁钺', tianshiTianshang: '天伤天使',
-      changshengSchool: '长生', lateZishi: '晚子时', shenzhuSchool: '身主',
-      zuoyaoSchool: '杂曜全表',
+      changshengSchool: '长生', lateZishi: '晚子时', shenzhuSchool: '身主', mingzhuSchool: '命主取法',
+      zuoyaoSchool: '杂曜全表', liunianSihua: '流年四化取干', sihuaVariant: '十干四化变体',
+      jieluSchool: '截路空亡', suipoSchool: '岁前十二神',
     };
     const diff = Object.entries(labels)
       .filter(([key]) => r.schools[key] && r.schools[key] !== ZIWEI_SCHOOL_DEFAULTS[key])
@@ -267,7 +269,7 @@ function ziweiText(r) {
     `【农历】${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.bodyMasterNote ? `（${r.bodyMasterSchool === 'common' ? '子午皆火星' : '子铃午火'}）` : ''}`,
+    `【紫微】${r.ziwei}　【天府】${r.tianfu}　【命主】${r.lifeMaster}　【身主】${r.bodyMaster}${r.bodyMasterNote ? `（${r.bodyMasterSchool === 'common' ? '子午皆火星' : '子铃午火'}）` : ''}${r.lifeMasterNote ? `（${r.lifeMasterNote}）` : ''}`,
     `【大限】${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 : ''}）`,

package/engine/interpret.js

@@ -12,7 +12,7 @@ import {
   LIUREN_JIANG, TAROT_ELEMENT_FOCUS, DISCLAIMER,
 } from './interpret-data.js';
 // 生年四化要按年干反查四颗星，四化表只在紫微引擎里定义了一份，这里直接复用，避免两处维护打架
-import { MUTAGEN } from './ziwei.js';
+import { natalSihuaTableOf } from './ziwei.js';
 // 紫微的词库单列一处：宫位取象、主星细节、双星、煞星辅星、四化措辞、庙旺语气、格局读法
 import {
   palaceFieldOf, starExtraOf, starPairOf, brightRead, huaInLine,
@@ -666,9 +666,10 @@ function zwNatalSihua(r) {
   }
 
   // 年干四化表：用来补齐「盘上没有落点」的那几颗，以及保证输出顺序
+  // 该盘若选了十干四化变体，这张表也要跟着换，否则文案里的四化与盘面标的不是同一张
   const ganzhi = pick(r, 'yearGanzhi', '');
   const yearStem = typeof ganzhi === 'string' ? ganzhi.slice(0, 1) : '';
-  const table = MUTAGEN[yearStem] || {};
+  const table = natalSihuaTableOf(yearStem, r?.schools);
   const starOfType = {};
   for (const [star, type] of Object.entries(table)) starOfType[type] = star;
 
@@ -870,7 +871,7 @@ function ziweiInterpret(r) {
     soulPair ? `${soulPair.gist}；要留意的是${soulPair.watch}。` : '',
     bodyLands ? `身宫寄在${bodyLands}——${bodyField ? `${bodyField.field}是后天更容易使上劲的地方` : '这是后天着力点'}，中年以后会越来越明显。` : '',
     `五行局为${pick(r.bureau, 'name', '—')}，${pick(r.daxian, 'startAge', '—')}岁起运：局定的是节奏（几步起、十年一换），不是好坏。`,
-    `命主${pick(r, 'lifeMaster', '—')}、身主${pick(r, 'bodyMaster', '—')}：传统把这两颗当作整张盘的定调星，命主看底色，身主看后半程的着力点。`,
+    `命主${pick(r, 'lifeMaster', '—')}、身主${pick(r, 'bodyMaster', '—')}：传统把这两颗当作整张盘的定调星，命主看底色，身主看后半程的着力点。${r.lifeMasterNote ? '（本盘' + r.lifeMasterNote + '。）' : ''}`,
   ].filter(Boolean).join('\n');
 
   // ── 逐宫分析：十二宫各一行清单 + 一句读法 ────────────────────

package/engine/ziwei.js

@@ -1,5 +1,5 @@
 // 紫微斗数安星：命身宫 → 五行局 → 紫微/天府 → 十四主星 → 诸辅煞杂曜 → 十二宫 → 四化 → 大限小限流年 → 格局
-import { STEMS, BRANCHES, ganzhiName, sexagenaryIndex, jdToParts, partsToJd, formatJd } from './calendar.js';
+import { STEMS, BRANCHES, ganzhiName, sexagenaryIndex, jdToParts, partsToJd, formatJd, dayGanzhiIndex } from './calendar.js';
 import { solarToLunar } from './lunar.js';
 import { applyTrueSolar } from './bazi.js';
 import { applyDst } from './dst.js';
@@ -95,7 +95,17 @@ export const ZIWEI_SCHOOL_DEFAULTS = Object.freeze({
   changshengSchool: 'yin-yang-shun-ni',
   lateZishi: 'current-day',
   shenzhuSchool: 'common',
+  mingzhuSchool: 'soul-branch',
   zuoyaoSchool: 'minimal',
+  liunianSihua: 'year-stem',
+  sihuaVariant: 'default',
+  // 中州派成组差异：off 全部用通行本（默认，默认盘逐字节不变）；zhongzhou 表示
+  // 「跟随 tianshiTianshang 的 zhongzhou 档」—— 那把开关切到中州派时，这一组跟着生效；
+  // 单独选 off/zhongzhou 而不动 tianshiTianshang 也可。
+  //   jieluSchool  截路空亡：zhongzhou 不排（截空、副截、旬空、副旬整组不出）
+  //   suipoSchool  岁前十二神：zhongzhou 把「大耗」改记作「岁破」（宫位不变，只换名字）
+  jieluSchool: 'off',
+  suipoSchool: 'off',
 });
 
 export const ZIWEI_SCHOOL_OPTIONS = Object.freeze({
@@ -109,7 +119,23 @@ export const ZIWEI_SCHOOL_OPTIONS = Object.freeze({
   changshengSchool: ['yin-yang-shun-ni', 'shui-tu', 'huo-tu'],
   lateZishi: ['current-day', 'next-day', 'all-current', 'day-cur-time-next'],
   shenzhuSchool: ['common', 'verse'],
+  // 命主取法：两派共用同一张十二支→命主星的表（贪狼子、巨门丑亥、禄存寅戌、文曲卯酉、
+  // 廉贞辰申、武曲巳未、破军午），分歧只在「拿哪个地支去查」——
+  //   soul-branch（默认，通行本 /《紫微斗数全书》卷二「安命主」）：按命宫地支
+  //   year-branch（中州派，王亭之整理）：按生年年支
+  // 实测命宫地支与生年年支重合的只占约 8%，两派约九成的人的命主不同。
+  mingzhuSchool: ['soul-branch', 'year-branch'],
   zuoyaoSchool: ['minimal', 'full'],
+  liunianSihua: ['year-stem', 'life-palace-stem'],
+  // 十干四化变体：default 表示各干用本插件原有通行表；其余按文墨变体名整表替换。
+  // 只列与 default 不同的那一档（default 之外全是「换掉某一干」的显式选择）。
+  sihuaVariant: ['default', '廉破曲阳', '贪阴阳机', '阳武同阴', '阳武府同', '阳武府相',
+    '阳武同相', '巨阳武昌', '梁紫府武', '梁紫相武', '破巨阳贪'],
+  // 中州派成组差异（两档各自独立，可单独开）：
+  //   jieluSchool  off 截路空亡照常 / zhongzhou 整组不排（截空、副截、旬空、副旬都不出）
+  //   suipoSchool  off 岁前十二神照常 / zhongzhou 把「大耗」改记作「岁破」
+  jieluSchool: ['off', 'zhongzhou'],
+  suipoSchool: ['off', 'zhongzhou'],
 });
 
 export function ziweiSchoolsOf(input = {}) {
@@ -221,11 +247,67 @@ const GENG_MUTAGEN = {
   GYWTX: { 太阳: '禄', 武曲: '权', 天同: '科', 天相: '忌' },
 };
 
+// 十干四化变体全表（文墨天机「十干四化」，2026-11 从 WMTJ-Pro64-2.5.26 的 App.swf 常量表挖出）。
+// 变体名一律取文墨原文四字，按「禄 权 科 忌」的顺序念，所以名字本身就是这张表：
+// 「廉破曲阳」= 廉贞化禄、破军化权、文曲化科、太阳化忌。
+// 每干第一个是与本插件原有默认表完全一致的那一档，乙丙丁己四干文墨没有变体。
+// 这张表和 gengYearSihua 不是一回事：gengYearSihua 只换生年四化里庚年那一支，
+// sihuaVariant 换的是整张十干四化表（生年、宫干自化、大限宫干、飞星、流年一起走）。
+export const SIHUA_VARIANTS = Object.freeze({
+  廉破武阳: { stem: '甲', table: MUTAGEN.甲 },
+  廉破曲阳: { stem: '甲', table: Object.freeze({ 廉贞: '禄', 破军: '权', 文曲: '科', 太阳: '忌' }) },
+  贪阴右机: { stem: '戊', table: MUTAGEN.戊 },
+  贪阴阳机: { stem: '戊', table: Object.freeze({ 贪狼: '禄', 太阴: '权', 太阳: '科', 天机: '忌' }) },
+  阳武阴同: { stem: '庚', table: GENG_MUTAGEN.GYWYT },
+  阳武同阴: { stem: '庚', table: GENG_MUTAGEN.GYWTY },
+  阳武府同: { stem: '庚', table: GENG_MUTAGEN.GYWFT },
+  阳武府相: { stem: '庚', table: GENG_MUTAGEN.GYWFX },
+  阳武同相: { stem: '庚', table: GENG_MUTAGEN.GYWTX },
+  巨阳曲昌: { stem: '辛', table: MUTAGEN.辛 },
+  巨阳武昌: { stem: '辛', table: Object.freeze({ 巨门: '禄', 太阳: '权', 武曲: '科', 文昌: '忌' }) },
+  梁紫辅武: { stem: '壬', table: MUTAGEN.壬 },
+  梁紫府武: { stem: '壬', table: Object.freeze({ 天梁: '禄', 紫微: '权', 天府: '科', 武曲: '忌' }) },
+  梁紫相武: { stem: '壬', table: Object.freeze({ 天梁: '禄', 紫微: '权', 天相: '科', 武曲: '忌' }) },
+  破巨阴贪: { stem: '癸', table: MUTAGEN.癸 },
+  破巨阳贪: { stem: '癸', table: Object.freeze({ 破军: '禄', 巨门: '权', 太阳: '科', 贪狼: '忌' }) },
+});
+
 function mutagenOf(stem, schools) {
   if (stem === '庚') return GENG_MUTAGEN[schools.gengYearSihua] || MUTAGEN.庚;
   return MUTAGEN[stem] ?? {};
 }
 
+/**
+ * 取某一干的四化表（宫干自化、大限宫干、飞星、流年都用这张）。
+ * 只认 `sihuaVariant`——`gengYearSihua` 按既有约定只管生年四化那一支，
+ * 不能让它顺带改掉宫干自化（那是另一套断法，混了就是两派口径串味）。
+ * 变体名所属天干对不上这一干时不生效，直接落回该干通行表，不会把甲的表套到乙上。
+ * @param {string} stem 天干
+ * @param {object} [schools] 流派开关
+ * @returns {Record<string,string>} 星名 → 禄/权/科/忌
+ */
+export function sihuaTableOf(stem, schools) {
+  const variant = schools && schools.sihuaVariant;
+  if (variant && variant !== 'default') {
+    const v = SIHUA_VARIANTS[variant];
+    if (v && v.stem === stem) return v.table;
+  }
+  return MUTAGEN[stem] ?? {};
+}
+
+/**
+ * 生年四化专用的取表：先看 `sihuaVariant`，没命中该干再让 `gengYearSihua` 生效。
+ * 两项同时指向庚干时以 `sihuaVariant` 为准——它说的是「整张表长这样」，比单点覆盖更明确。
+ * @param {string} stem 年干
+ * @param {object} [schools] 流派开关
+ * @returns {Record<string,string>} 星名 → 禄/权/科/忌
+ */
+export function natalSihuaTableOf(stem, schools) {
+  const table = sihuaTableOf(stem, schools);
+  if (table === MUTAGEN[stem]) return mutagenOf(stem, schools || {});
+  return table;
+}
+
 // 安魁钺三派：差异集中在庚辛壬癸年（「网络派」与 qs1 同表，不单列）
 export const KUI_YUE_SCHOOLS = {
   qs2: {
@@ -256,7 +338,7 @@ export const KUI_YUE = {
 };
 KUI_YUE_SCHOOLS.qs1 = KUI_YUE;
 
-/** 命主：按命宫地支 */
+/** 命主：按地支查表。两派共用这张表，分歧在拿哪个地支 —— 见 mingzhuSchool。 */
 export const MING_ZHU = {
   子: '贪狼', 丑: '巨门', 寅: '禄存', 卯: '文曲', 辰: '廉贞', 巳: '武曲',
   午: '破军', 未: '武曲', 申: '廉贞', 酉: '文曲', 戌: '禄存', 亥: '巨门',
@@ -516,7 +598,11 @@ export function buildZiwei(input) {
   if (schools.tiankongSchool !== 'off') {
     put(schools.tiankongSchool === 'shun-jia-shi' ? yb + hb : yb + 1, '天空', '杂曜');
   }
-  if (schools.jiekongSchool !== 'off') {
+  // 截路空亡：zhongzhou（中州派）整组不排——截空、副截、旬空、副旬都不出。
+  // 依据《中州派紫微斗数》：截路空亡不入中州派体系；通行本才排。
+  // 这一组只影响杂曜清单，不动宫盘、主星、十二宫位置。
+  const skipJielu = schools.jieluSchool === 'zhongzhou';
+  if (schools.jiekongSchool !== 'off' && !skipJielu) {
     const jk = JIEKONG[schools.jiekongSchool][yearStem];
     if (Array.isArray(jk)) {
       put(jk[0], '截空', '杂曜');
@@ -564,7 +650,7 @@ export function buildZiwei(input) {
   }
 
   // 生年四化（庚干按所选变体）
-  const mutagenMap = mutagenOf(yearStem, schools);
+  const mutagenMap = natalSihuaTableOf(yearStem, schools);
   for (const list of starsByBranch) {
     for (const star of list) {
       if (mutagenMap[star.name]) star.mutagen = mutagenMap[star.name];
@@ -583,13 +669,17 @@ export function buildZiwei(input) {
   const csStart = schools.changshengSchool === 'huo-tu' && bureau.number === 5
     ? 2
     : CHANGSHENG_START[bureau.number];
+  // 岁前十二神：中州派把「大耗」改记作「岁破」（宫位不变，只换名字）。
+  const renameDahao = schools.suipoSchool === 'zhongzhou';
   const shenshaAt = (branch) => {
     const d = forward ? 1 : -1;
+    let suiqi = SUIQI_NAMES[fix(branch - yb)];
+    if (renameDahao && suiqi === '大耗') suiqi = '岁破';
     return {
       changsheng: CHANGSHENG_NAMES[fix(d * (branch - csStart))],
       boshi: BOSHI_NAMES[fix(d * (branch - lucun))],
       jiangqian: JIANGQIAN_NAMES[fix(branch - JIANGXING[triad])],
-      suiqi: SUIQI_NAMES[fix(branch - yb)],
+      suiqi,
     };
   };
 
@@ -600,7 +690,7 @@ export function buildZiwei(input) {
     const stepIndex = forward ? fix(branch - soulIndex) : fix(soulIndex - branch);
     const dxStart = startAge + stepIndex * 10;
     const gz = STEMS[stem] + BRANCHES[branch];
-    const pal = MUTAGEN[STEMS[stem]] ?? {};
+    const pal = sihuaTableOf(STEMS[stem], schools);
     const selfHua = starsByBranch[branch]
       .filter((s) => pal[s.name])
       .map((s) => ({ star: s.name, type: pal[s.name] }));
@@ -618,7 +708,7 @@ export function buildZiwei(input) {
         start: dxStart,
         end: dxStart + 9,
         stem: STEMS[stem],
-        mutagen: Object.entries(MUTAGEN[STEMS[stem]] ?? {}).map(([s, k]) => `${s}化${k}`),
+        mutagen: Object.entries(sihuaTableOf(STEMS[stem], schools)).map(([s, k]) => `${s}化${k}`),
       },
       xiaoxian: { age: xiaoxianAge(branch, triad, gender) },
       sanfang: [branch, branch + 4, branch + 8, branch + 6]
@@ -626,6 +716,10 @@ export function buildZiwei(input) {
     });
   }
 
+  // 来因宫（iztro 口径）：生年天干与宫干相同的宫，子丑两宫除外（这两支五虎遁永不排甲己…的生年干）。
+  // 之所以叫「来因」：此宫是今生命局展开的起点，主「因何而来」，看一个人的先天因缘与执念方向。
+  const laiyin = palaces.find((p) => p.stem === yearStem && p.branch !== '子' && p.branch !== '丑') || null;
+
   // 昌曲专论：与丑未的关系、是否入命三方、吸收面的清杂
   const changqu = (() => {
     const set = new Set([wenchang, wenqu]);
@@ -682,10 +776,21 @@ export function buildZiwei(input) {
     const xxAge = ((age - 1) % 12) + 1;
     const xxPalace = palaces.find((p) => p.xiaoxian.age === xxAge);
     const dxPalace = palaces.find((p) => age >= p.daxian.start && age <= p.daxian.end);
+    // 流年四化取干：默认按流年天干；liunianSihua: life-palace-stem 改按该年命宫
+    // 的宫干（文墨设置树里的「依据流年命宫天干」）。这两干各依不同的表：年干随年份走，
+    // 命宫宫干由五虎遁从出生年干起，所以实测十二年会换掉十二次，不是只差个别年。
+    // 取哪一干必须随盘回显，否则用户看不出四颗化星是被哪张表定的。
+    const lnStemOf = (() => {
+      if (schools.liunianSihua !== 'life-palace-stem') return gz.stem;
+      const lp = palaces.find((p) => p.branch === gz.branch);
+      return lp ? lp.stem : gz.stem;
+    })();
     liunian.push({
       year: y,
       ganzhi: gz.name,
       age,
+      sihuaStem: lnStemOf,
+      sihuaStemFrom: schools.liunianSihua === 'life-palace-stem' ? '流年命宫天干' : '流年天干',
       lifePalace: { branch: gz.branch, palace: palaceNames[b] },
       doujun: BRANCHES[fix(b - (lunarMonth - 1) + hb)],
       sanfang: [fix(b), fix(b + 4), fix(b + 8), fix(b + 6)].map((x) => palaceNames[x]),
@@ -694,7 +799,20 @@ export function buildZiwei(input) {
       liutuo: BRANCHES[fix(lu - 1)],
       liukui: BRANCHES[kuiyueTable[gz.stem][0]],
       liuyue: BRANCHES[kuiyueTable[gz.stem][1]],
-      mutagen: Object.entries(MUTAGEN[gz.stem] ?? {}).map(([s, k]) => `${s}化${k}`),
+      // 流曜补全（流昌曲按流年干、流马按流年支三合、流鸾流喜按流年支、年解按流年支）
+      ...(() => {
+        const s = horoscopeStarsByBranch(gz, true);
+        const out = {};
+        for (const [name, br] of Object.entries(s)) {
+          if (name === '流禄' || name === '流羊' || name === '流陀' || name === '流魁' || name === '流钺') continue;
+          out[name] = br;
+        }
+        return out;
+      })(),
+      mutagen: Object.entries(sihuaTableOf(lnStemOf, schools)).map(([s, k]) => `${s}化${k}`),
+      // 流年十二神：岁前/将前随流年支重安（iztro getYearly12 口径）
+      lnSuiqi: suiqiByBranch(gz.branch, schools.suipoSchool),
+      lnJiangqian: jiangqianByBranch(gz.branch),
       daxian: dxPalace
         ? { palace: dxPalace.palace, start: dxPalace.daxian.start, end: dxPalace.daxian.end }
         : null,
@@ -739,6 +857,30 @@ export function buildZiwei(input) {
     },
     hourBranch,
     yearGanzhi: yearGanzhi.name,
+    ...((() => {
+      // 非节气四柱（紫微斗数口径，文墨「显示非节气四柱」开关的数据源）：
+      // 紫微按农历排盘，年柱以正月初一换岁（lunarYear 已是此口径）、月柱按农历月配五虎遁；
+      // 日柱、时柱与节气版完全一致（日时不受节气影响）。与八字（节气）四柱只在立春前后的
+      // 出生者上年/月两柱有差异，正好给用户对照。
+      const yIdx = (((lunarRaw.lunarYear - 4) % 60) + 60) % 60;
+      const nYinStem = ((STEMS.indexOf(yearGanzhi.stem) % 5) * 2 + 2) % 10;
+      const mBranchIdx = 2 + (lunarMonth - 1) >= 12 ? 2 + (lunarMonth - 1) - 12 : 2 + (lunarMonth - 1); // 正月建寅
+      const mStemIdx = (nYinStem + lunarMonth - 1) % 10;
+      const nJd = partsToJd({ year, month, day, hour: 12 });
+      const dIdx = dayGanzhiIndex(Math.floor(nJd + 0.5));
+      const dStemIdx = dIdx % 10;
+      const ziStem = ((dStemIdx % 5) * 2) % 10;
+      const hIdx = sexagenaryIndex((ziStem + hb) % 10, hb);
+      return {
+        nonJieqi: {
+          year: ganzhiName(yIdx).name,
+          month: ganzhiName(sexagenaryIndex(mStemIdx, mBranchIdx)).name,
+          day: ganzhiName(dIdx).name,
+          hour: ganzhiName(hIdx).name,
+          note: '非节气（农历）口径：年以正月初一、月以朔为界；与八字节气四柱仅立春前后出生者有差',
+        },
+      };
+    })()),
     soul: {
       palace: '命宫',
       branch: BRANCHES[soulIndex],
@@ -747,7 +889,20 @@ export function buildZiwei(input) {
       nayin: soulNayin.name,
     },
     body: { palace: '身宫', branch: BRANCHES[bodyIndex], lands: palaceNames[bodyIndex] },
-    lifeMaster: MING_ZHU[BRANCHES[soulIndex]],
+    lifeMaster: MING_ZHU[schools.mingzhuSchool === 'year-branch' ? BRANCHES[yb] : BRANCHES[soulIndex]],
+    lifeMasterSchool: schools.mingzhuSchool,
+    ...((() => {
+      // 两派取的地支不同时，把另一派的结果一并回显——不然用户切档后只看到命主变了一个字，
+      // 无从判断是取法变了还是排盘出了问题。
+      const bySoul = MING_ZHU[BRANCHES[soulIndex]];
+      const byYear = MING_ZHU[BRANCHES[yb]];
+      if (bySoul === byYear) return {};
+      return {
+        lifeMasterNote: schools.mingzhuSchool === 'year-branch'
+          ? `中州派按生年年支${BRANCHES[yb]}取${byYear}；通行本按命宫地支${BRANCHES[soulIndex]}取${bySoul}`
+          : `通行本按命宫地支${BRANCHES[soulIndex]}取${bySoul}；中州派按生年年支${BRANCHES[yb]}取${byYear}`,
+      };
+    })()),
     bodyMaster: SHEN_ZHU[schools.shenzhuSchool][BRANCHES[yb]],
     bodyMasterSchool: schools.shenzhuSchool,
     ...((yb === 0 || yb === 6) ? {
@@ -763,6 +918,8 @@ export function buildZiwei(input) {
     ziwei: BRANCHES[ziwei],
     tianfu: BRANCHES[tianfu],
     changqu,
+    // 来因宫：{branch, palace, ganzhi} 或 null（理论上不 null，防御性保留）
+    laiyin: laiyin ? { branch: laiyin.branch, palace: laiyin.palace, ganzhi: laiyin.ganzhi } : null,
     // 杂曜全表的这一层只写「这一盘怎么定宫」：面板、独立页与「复制提问」共用。
     // 默认（minimal）时 placed 为空，但 skipped 照旧给出，说明为什么少了两颗。
     zuoyao: {
@@ -794,15 +951,15 @@ export function buildZiwei(input) {
     rules: {
       ziweiPlacement: '借数法：局数除日数取商，商数自寅宫顺行，借数奇逆偶顺',
       mutagen: '生年四化用中州派常用表；庚干可按流派切换（默认阳武阴同，另有同科阴忌、府科、府科相忌、同科相忌）',
-      schools: `流派开关：亮度 ${schools.brightnessSchool}、庚干四化 ${schools.gengYearSihua}、天马 ${schools.tianmaSchool}、天空 ${schools.tiankongSchool}、截空 ${schools.jiekongSchool}、魁钺 ${schools.kuiyueSchool}、天伤天使 ${schools.tianshiTianshang}、长生 ${schools.changshengSchool}、晚子时 ${schools.lateZishi}、身主 ${schools.shenzhuSchool}（common 子午皆火星 / verse 子铃午火）、杂曜 ${schools.zuoyaoSchool}（minimal 49 颗 / full 61 颗）；庚干四化只作用于生年四化`,
+      schools: `流派开关：亮度 ${schools.brightnessSchool}、庚干四化 ${schools.gengYearSihua}、天马 ${schools.tianmaSchool}、天空 ${schools.tiankongSchool}、截空 ${schools.jiekongSchool}、魁钺 ${schools.kuiyueSchool}、天伤天使 ${schools.tianshiTianshang}、长生 ${schools.changshengSchool}、晚子时 ${schools.lateZishi}、身主 ${schools.shenzhuSchool}（common 子午皆火星 / verse 子铃午火）、命主 ${schools.mingzhuSchool}（soul-branch 按命宫地支 / year-branch 按生年年支）、杂曜 ${schools.zuoyaoSchool}（minimal 49 颗 / full 61 颗）、流年四化取干 ${schools.liunianSihua}（year-stem 按流年天干 / life-palace-stem 按流年命宫宫干）、十干四化 ${schools.sihuaVariant}（default 各干通行表，其余为文墨变体整表替换）、截路空亡 ${schools.jieluSchool}（off 照常排 / zhongzhou 整组不排）、岁前十二神 ${schools.suipoSchool}（off 照常 / zhongzhou 大耗改岁破）；庚干四化只作用于生年四化，sihuaVariant 换的是宫干自化、大限宫干、飞星与流年共用的那张表`,
       zuoyao: schools.zuoyaoSchool === 'full'
         ? `全表十二颗已安：生月 解神、天巫、天月、阴煞；生年干 天官、天福、天厨；生年支 蜚廉、天德、年解；命宫＋生年支 天才、身宫＋生年支 天寿。蜚廉与博士十二神的飞廉同名异星，年解与月解（解神）分列，天德与岁前十二神的天德同名异宫。`
         : `本盘按 49 颗的通行简盘安星，未排全表杂曜。开 zuoyaoSchool: "full" 追加十二颗：解神、天巫、天月、阴煞（生月）、天官、天福、天厨（生年干）、蜚廉、天德、年解（生年支）、天才（命宫＋生年支）、天寿（身宫＋生年支），每颗都带安星诀。`,
       leapMonth: '闰月默认按日切分（1–15 归本月、16 起归次月，主流排盘口径）；可传 leapMonth: next（整月归次月）或 prev（整月归本月），leapAsNext: true 等同 next',
       auxStars: '火铃按年支三合起点顺数至生时；羊陀夹禄存；魁钺按年干；地空亥起子时逆行、地劫顺行；三台八座随辅弼；恩光天贵随昌曲退一位；台辅封诰按时支',
       shensha: '长生、博士随大限顺逆；将前、岁前恒顺行；天伤恒在交友、天使恒在疾厄',
-      masters: '命主按命宫地支，身主按生年地支',
-      liunian: '流年命宫取该年地支宫；三方四正为本宫与 +4/+8/+6；并给该年所属大限与小限',
+      masters: '命主按 mingzhuSchool 取地支再查表（soul-branch 命宫地支 / year-branch 生年年支），身主按生年地支；两派共用同一张十二支命主表，只换查表用的地支',
+      liunian: '流年命宫取该年地支宫；三方四正为本宫与 +4/+8/+6；并给该年所属大限与小限；四化取干按 liunianSihua 口径，sihuaStem 回显实际用的那一干',
       flyComposite: '三方四正取本宫、对宫与两个三合宫共四宫，四宫宫干各化禄权科忌共 16 条，按落宫归堆标会聚（双忌会、禄忌同宫、三化会、自化）；只描会照，不折吉凶',
       changqu: '昌曲落宫只由时支决定，故与丑未的关系（夹/三合/同宫/无关）是结构性结论；absorb 的「清/杂」是启发式标记，依据昌曲化忌与会煞，不是断语',
     },
@@ -1079,6 +1236,34 @@ export const PATTERN_TONE = {
   刑囚夹印: 'bad', 泛水桃花: 'bad',
 };
 
+// ── 限流十二神（iztro 口径）：随流年干支重安的只有岁前/将前两组 ──
+// 长生十二神、博士十二神只在本命排盘算一次，horoscope scope 不重算（iztro
+// FunctionalAstrolabe._getHoroscopeBySolarDate 里 yearlyDecStar=getYearly12(solarDate)
+// 只重出 suiqian12/jiangqian12，长生与博士留在本命宫位上）。
+// 岁前：流年支起岁建，顺数 SUIQI_NAMES；将前：寅午戌起午、申子辰起子、巳酉丑起酉、亥卯未起卯。
+export function suiqiByBranch(branch, suipoSchool) {
+  const b = BRANCHES.indexOf(branch);
+  if (b < 0) return {};
+  const out = {};
+  for (let i = 0; i < 12; i++) {
+    let name = SUIQI_NAMES[i];
+    if (suipoSchool === 'zhongzhou' && name === '大耗') name = '岁破';
+    out[name] = BRANCHES[fix(b + i)];
+  }
+  return out;
+}
+
+export function jiangqianByBranch(branch) {
+  const b = BRANCHES.indexOf(branch);
+  if (b < 0) return {};
+  const triad = ['寅午戌', '申子辰', '巳酉丑', '亥卯未'].find((t) => t.includes(branch));
+  if (!triad) return {};
+  const start = JIANGXING[triad];
+  const out = {};
+  for (let i = 0; i < 12; i++) out[JIANGQIAN_NAMES[i]] = BRANCHES[fix(start + i)];
+  return out;
+}
+
 // ── 大限一览：宫干四化落宫、三方主星 ──────────────────────────
 
 export function daxianList(chart) {
@@ -1101,7 +1286,12 @@ export function daxianList(chart) {
       selfHua: p.selfHua,
       sanfang: p.sanfang,
       mainStars: mainOf(p.sanfang),
-      mutagenHits: Object.entries(MUTAGEN[p.stem] ?? {}).map(([star, type]) => {
+      // 运曜：按大限宫干支安 10 颗（魁钺昌曲禄羊陀马鸾喜），映射 星名→地支
+      yunStars: horoscopeStarsByBranch(p.ganzhi, false),
+      // 限流十二神：随大限宫支重安的岁前/将前两组（长生、博士不随限流变）
+      yunSuiqi: suiqiByBranch(p.branch, chart.schools.suipoSchool),
+      yunJiangqian: jiangqianByBranch(p.branch),
+      mutagenHits: Object.entries(sihuaTableOf(p.stem, chart.schools)).map(([star, type]) => {
         const b = starBranchOf(chart, star);
         return { star, type, branch: b >= 0 ? BRANCHES[b] : null, palace: b >= 0 ? chart.palaces.find((x) => x.branch === BRANCHES[b])?.palace ?? null : null };
       }),
@@ -1118,9 +1308,10 @@ export function daxianList(chart) {
 export const FLY_TYPES = ['禄', '权', '科', '忌'];
 
 // 某天干下某一化的星曜；表里没有就返回 null（不会凭印象补）
-export function flyStarOf(stem, type) {
-  const map = MUTAGEN[stem];
-  if (!map) return null;
+// 第三参 schools 选填：给了就按该盘的十干四化变体取表，不给沿用通行表（旧调用零漂移）
+export function flyStarOf(stem, type, schools) {
+  const map = sihuaTableOf(stem, schools || {});
+  if (!map || !Object.keys(map).length) return null;
   for (const [star, t] of Object.entries(map)) if (t === type) return star;
   return null;
 }
@@ -1133,7 +1324,7 @@ export function flyStars(chart) {
     branch: p.branch,
     stem: p.stem,
     flies: FLY_TYPES.map((type) => {
-      const star = flyStarOf(p.stem, type);
+      const star = flyStarOf(p.stem, type, chart.schools);
       const b = star ? starBranchOf(chart, star) : -1;
       const target = b >= 0 ? palaces.find((x) => x.branch === BRANCHES[b]) : null;
       return {
@@ -1159,7 +1350,7 @@ export function flyChain(chart, { from = '命宫', type = '忌', maxSteps = 12 }
   let cur = start;
   let ended = 'max';
   for (let i = 0; i < Math.max(1, maxSteps); i++) {
-    const star = flyStarOf(cur.stem, type);
+    const star = flyStarOf(cur.stem, type, chart.schools);
     if (!star) { ended = 'no-star'; break; }
     const b = starBranchOf(chart, star);
     if (b < 0) { ended = 'off-chart'; break; }
@@ -1209,7 +1400,7 @@ export function flyComposite(chart, { from = '命宫' } = {}) {
       branch: p.branch,
       stem: p.stem,
       flies: FLY_TYPES.map((type) => {
-        const star = flyStarOf(p.stem, type);
+        const star = flyStarOf(p.stem, type, chart.schools);
         const b = star ? starBranchOf(chart, star) : -1;
         const target = b >= 0 ? palaces.find((x) => x.branch === BRANCHES[b]) : null;
         return {
@@ -1282,12 +1473,66 @@ export function flyComposite(chart, { from = '命宫' } = {}) {
   };
 }
 
-// ── 流年四化落宫 ────────────────────────────────────────────
+// ── 限流星曜（运曜/流曜）────────────────────────────────────
+// 口径依据 iztro star/horoscopeStar.ts + star/location.ts（本命同表换干支重算）：
+//   · 魁钺、昌曲、禄羊陀 按运限天干；天马按运限地支三合；红鸾天喜按运限地支（卯起逆数）。
+//   · 流年另加「年解」：戌上起子，逆数至流年地支。
+// 与本命安星的差异只有两点：昌曲在本命按时支（戌起逆数/辰起顺数），限流按天干
+//（甲昌巳曲酉、乙昌午曲申、丙戊昌申曲午、丁己昌酉曲巳、庚昌亥曲卯、辛昌子曲寅、壬昌寅曲辰、癸昌卯曲巳）；
+// 火铃不随限流重安（iztro 同样只安这 10+1 颗）。
+const LIU_CHANGQU = {
+  甲: [5, 9], 乙: [6, 8], 丙: [8, 6], 戊: [8, 6], 丁: [9, 5], 己: [9, 5],
+  庚: [11, 3], 辛: [0, 2], 壬: [2, 4], 癸: [3, 5],
+};
+
+const NIANJIE_OF = { 子: 10, 丑: 9, 寅: 8, 卯: 7, 辰: 6, 巳: 5, 午: 4, 未: 3, 申: 2, 酉: 1, 戌: 0, 亥: 11 };
+
+/** 前缀：大限叫运X、流年叫流X（iztro 同款命名） */
+const HS_PREFIX = (yearly) => (yearly ? '流' : '运');
+
+/** 按一组干支安限流星曜，返回 12 宫（按地支序）各宫的星名数组。yearly=true 时前缀用「流」并加年解。 */
+export function horoscopeStarsOf(gz, yearly = false) {
+  const stem = gz.stem ?? String(gz).replace(/[子丑寅卯辰巳午未申酉戌亥]$/, '');
+  const branch = gz.branch ?? String(gz).slice(-1);
+  const sb = BRANCHES.indexOf(branch);
+  const pre = HS_PREFIX(yearly);
+  const lu = LUCUN[stem];
+  const [kui, yue] = KUI_YUE[stem];
+  const [chang, qu] = LIU_CHANGQU[stem];
+  const ma = TIANMA[triadOf(sb)];
+  const luang = fix(3 - sb);
+  const byBranch = Array.from({ length: 12 }, () => []);
+  const add = (idx, name) => byBranch[fix(idx)].push(name);
+  add(kui, `${pre}魁`);
+  add(yue, `${pre}钺`);
+  add(chang, `${pre}昌`);
+  add(qu, `${pre}曲`);
+  add(lu, `${pre}禄`);
+  add(lu + 1, `${pre}羊`);
+  add(lu - 1, `${pre}陀`);
+  add(ma, `${pre}马`);
+  add(luang, `${pre}鸾`);
+  add(luang + 6, `${pre}喜`);
+  if (yearly) add(NIANJIE_OF[branch], '年解');
+  return byBranch;
+}
+
+/** 把 12 宫的星名数组转成 {星名: 地支}（供 daxianList/liunian 挂字段） */
+export function horoscopeStarsByBranch(gz, yearly = false) {
+  const byBranch = horoscopeStarsOf(gz, yearly);
+  const out = {};
+  byBranch.forEach((stars, i) => {
+    for (const name of stars) out[name] = BRANCHES[i];
+  });
+  return out;
+}
+
+
 
 export function enrichLiunian(chart) {
   for (const ln of chart.liunian) {
-    const stem = ln.ganzhi[0];
-    ln.mutagenHits = Object.entries(MUTAGEN[stem] ?? {}).map(([star, type]) => {
+    const stem = ln.sihuaStem || ln.ganzhi[0];
+    ln.mutagenHits = Object.entries(sihuaTableOf(stem, chart.schools)).map(([star, type]) => {
       const b = starBranchOf(chart, star);
       return {
         star,
@@ -1349,7 +1594,7 @@ export function flowOf(chart, asOf) {
     const p = chart.palaces.find((x) => x.branch === br);
     const stem = p ? p.stem : null;
     const mutagenHits = stem
-      ? Object.entries(MUTAGEN[stem] ?? {}).map(([star, type]) => {
+      ? Object.entries(sihuaTableOf(stem, chart.schools)).map(([star, type]) => {
         const b = starBranchOf(chart, star);
         return {
           star,