dsh-metaphysics 0.63.0 → 0.64.0

package/engine/diff.js

@@ -338,9 +338,23 @@ 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: '各干通行表', 廉破曲阳: '甲干 廉破曲阳',
+      贪阴阳机: '戊干 贪阴阳机', 阳武同阴: '庚干 阳武同阴', 阳武府同: '庚干 阳武府同',
+      阳武府相: '庚干 阳武府相', 阳武同相: '庚干 阳武同相', 巨阳武昌: '辛干 巨阳武昌',
+      梁紫府武: '壬干 梁紫府武', 梁紫相武: '壬干 梁紫相武', 破巨阳贪: '癸干 破巨阳贪',
+    }),
   ],
   qimen: [
     {

package/engine/index.js

@@ -78,7 +78,7 @@ function requireGender(value, who = '') {
 const ZIWEI_SCHOOL_KEYS = [
   'brightnessSchool', 'gengYearSihua', 'tianmaSchool', 'tiankongSchool', 'jiekongSchool',
   'kuiyueSchool', 'tianshiTianshang', 'changshengSchool', 'lateZishi', 'shenzhuSchool',
-  'zuoyaoSchool',
+  'mingzhuSchool', 'zuoyaoSchool', 'liunianSihua', 'sihuaVariant',
 ];
 
 /** 紫微流派参数原样透传；非法值交给引擎按默认口径回退 */
@@ -211,8 +211,8 @@ function ziweiText(r) {
     const labels = {
       brightnessSchool: '亮度', gengYearSihua: '庚干四化', tianmaSchool: '天马', tiankongSchool: '天空',
       jiekongSchool: '截空', kuiyueSchool: '魁钺', tianshiTianshang: '天伤天使',
-      changshengSchool: '长生', lateZishi: '晚子时', shenzhuSchool: '身主',
-      zuoyaoSchool: '杂曜全表',
+      changshengSchool: '长生', lateZishi: '晚子时', shenzhuSchool: '身主', mingzhuSchool: '命主取法',
+      zuoyaoSchool: '杂曜全表', liunianSihua: '流年四化取干', sihuaVariant: '十干四化变体',
     };
     const diff = Object.entries(labels)
       .filter(([key]) => r.schools[key] && r.schools[key] !== ZIWEI_SCHOOL_DEFAULTS[key])
@@ -267,7 +267,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

@@ -95,7 +95,10 @@ 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',
 });
 
 export const ZIWEI_SCHOOL_OPTIONS = Object.freeze({
@@ -109,7 +112,18 @@ 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', '廉破曲阳', '贪阴阳机', '阳武同阴', '阳武府同', '阳武府相',
+    '阳武同相', '巨阳武昌', '梁紫府武', '梁紫相武', '破巨阳贪'],
 });
 
 export function ziweiSchoolsOf(input = {}) {
@@ -221,11 +235,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 +326,7 @@ export const KUI_YUE = {
 };
 KUI_YUE_SCHOOLS.qs1 = KUI_YUE;
 
-/** 命主：按命宫地支 */
+/** 命主：按地支查表。两派共用这张表，分歧在拿哪个地支 —— 见 mingzhuSchool。 */
 export const MING_ZHU = {
   子: '贪狼', 丑: '巨门', 寅: '禄存', 卯: '文曲', 辰: '廉贞', 巳: '武曲',
   午: '破军', 未: '武曲', 申: '廉贞', 酉: '文曲', 戌: '禄存', 亥: '巨门',
@@ -564,7 +634,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];
@@ -600,7 +670,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 +688,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]
@@ -682,10 +752,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 +775,7 @@ 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}`),
+      mutagen: Object.entries(sihuaTableOf(lnStemOf, schools)).map(([s, k]) => `${s}化${k}`),
       daxian: dxPalace
         ? { palace: dxPalace.palace, start: dxPalace.daxian.start, end: dxPalace.daxian.end }
         : null,
@@ -747,7 +828,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) ? {
@@ -794,15 +888,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 各干通行表，其余为文墨变体整表替换）；庚干四化只作用于生年四化，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 的「清/杂」是启发式标记，依据昌曲化忌与会煞，不是断语',
     },
@@ -1101,7 +1195,7 @@ export function daxianList(chart) {
       selfHua: p.selfHua,
       sanfang: p.sanfang,
       mainStars: mainOf(p.sanfang),
-      mutagenHits: Object.entries(MUTAGEN[p.stem] ?? {}).map(([star, type]) => {
+      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 +1212,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 +1228,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 +1254,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 +1304,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 {
@@ -1286,8 +1381,8 @@ export function flyComposite(chart, { from = '命宫' } = {}) {
 
 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 +1444,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,

package/index.js

@@ -65,7 +65,8 @@ const OPTION_KEYS = [
   'upper', 'lower', 'changing', 'count',
   'leapMonth', 'leapAsNext', 'brightnessSchool', 'gengYearSihua', 'tianmaSchool',
   'tiankongSchool', 'jiekongSchool', 'kuiyueSchool', 'tianshiTianshang',
-  'changshengSchool', 'lateZishi', 'shenzhuSchool', 'zuoyaoSchool',
+  'changshengSchool', 'lateZishi', 'shenzhuSchool', 'mingzhuSchool', 'zuoyaoSchool', 'liunianSihua',
+  'sihuaVariant',
   'action', 'toAge', 'sitting', 'facing', 'fortuneYear', 'period',
   'sittingOffset', 'sittingDegree', 'facingOffset', 'facingDegree',
   'fortuneDate', 'fortuneTime', 'surname', 'givenName', 'limit',
@@ -109,7 +110,10 @@ const OPTION_HINTS = {
   changshengSchool: '仅 ziwei：长生十二神起点流派',
   lateZishi: '仅 ziwei：晚子时口径 current-day / next-day',
   shenzhuSchool: '仅 ziwei：身主安法 common / verse',
+  mingzhuSchool: '仅 ziwei：命主取法 soul-branch 按命宫地支（默认）/ year-branch 按生年年支（中州派）',
   zuoyaoSchool: '仅 ziwei：杂曜取盘 minimal / full',
+  liunianSihua: '仅 ziwei：流年四化取干 year-stem 按流年天干（默认）/ life-palace-stem 按流年命宫宫干',
+  sihuaVariant: '仅 ziwei：十干四化变体 default 或 廉破曲阳/贪阴阳机/阳武同阴…（整表替换）',
   action: 'fengshui：natal（默认）/ advise / xuankong 玄空；name：assess / generate',
   toAge: '仅 trend：算到几岁 10–100，默认 100',
   sitting: '仅 fengshui advise/xuankong 玄空：坐山（24 山之一）',
@@ -140,7 +144,7 @@ const READ_KEYS = ['withInterpret', 'detail', 'ask', 'question', 'direction', 's
 /** 每个体系实际会读的参数：help 按这张表展开，避免「有这个键但该体系不看」 */
 const SYSTEM_PARAMS = {
   bazi: [...BIRTH_KEYS, 'hourUnknown', 'verifyPast', 'rectify', 'events', 'rectifyHours', 'cross', 'diff', 'trace', ...READ_KEYS],
-  ziwei: [...BIRTH_KEYS, 'leapMonth', 'leapAsNext', 'brightnessSchool', 'gengYearSihua', 'tianmaSchool', 'tiankongSchool', 'jiekongSchool', 'kuiyueSchool', 'tianshiTianshang', 'changshengSchool', 'lateZishi', 'shenzhuSchool', 'zuoyaoSchool', 'cross', 'diff', 'trace', ...READ_KEYS],
+  ziwei: [...BIRTH_KEYS, 'leapMonth', 'leapAsNext', 'brightnessSchool', 'gengYearSihua', 'tianmaSchool', 'tiankongSchool', 'jiekongSchool', 'kuiyueSchool', 'tianshiTianshang', 'changshengSchool', 'lateZishi', 'shenzhuSchool', 'mingzhuSchool', 'zuoyaoSchool', 'liunianSihua', 'sihuaVariant', 'cross', 'diff', 'trace', ...READ_KEYS],
   liuyao: ['datetime', 'lines', 'seed', 'trace', ...READ_KEYS],
   tarot: ['count', 'seed', ...READ_KEYS],
   meihua: ['datetime', 'mode', 'upper', 'lower', 'changing', ...READ_KEYS],
@@ -826,11 +830,27 @@ export function apply(ctx) {
           enum: ['common', 'verse'],
           description: '紫微斗数：身主安法（只影响子/午年生人）。common（默认，通行表）子午皆火星；verse 按安身主诀「子午安身铃火宿」逐字取子铃星、午火星。',
         },
+        mingzhuSchool: {
+          type: 'string',
+          enum: ['soul-branch', 'year-branch'],
+          description: '紫微斗数：命主取法。两派共用同一张十二支→命主星的表（子贪狼、丑亥巨门、寅戌禄存、卯酉文曲、辰申廉贞、巳未武曲、午破军），分歧只在拿哪个地支去查：soul-branch（默认，通行本 /《紫微斗数全书》卷二「安命主」）用命宫地支，year-branch（中州派，文墨「安命主 - 依据中州派理论」）用生年年支。命主的定义是「依地支指定的一颗星」，命宫里不一定有它，换取法不改任何宫位与星曜落宫。实测命宫地支与生年年支重合的只占约 8%，两派约九成的人结果不同。',
+        },
         zuoyaoSchool: {
           type: 'string',
           enum: ['minimal', 'full'],
           description: '紫微斗数：杂曜取盘。minimal（默认，通行简盘 49 颗，与旧盘和存档一致）；full 另按安星诀补入十二颗杂曜（解神、天巫、天月、阴煞、天官、天福、天厨、蜚廉、天德、年解、天才、天寿），共 61 颗。诀文属近代通行辑本并核，非《紫微斗数全书》原文。',
         },
+        liunianSihua: {
+          type: 'string',
+          enum: ['year-stem', 'life-palace-stem'],
+          description: '紫微斗数：流年四化的取干口径。year-stem（默认）用该年干支的天干，life-palace-stem 改用该年流年命宫那一宫的宫干（文墨「依据流年命宫天干」）。年干随年份走，命宫宫干由五虎遁从生年干起，两者是两张表，实测十二年会换十二次，四颗化星全变。每年回显 sihuaStem / sihuaStemFrom 说明实际用了哪一干。',
+        },
+        sihuaVariant: {
+          type: 'string',
+          enum: ['default', '廉破曲阳', '贪阴阳机', '阳武同阴', '阳武府同', '阳武府相',
+            '阳武同相', '巨阳武昌', '梁紫府武', '梁紫相武', '破巨阳贪'],
+          description: '紫微斗数：十干四化变体，整表替换生年、宫干自化、大限宫干、飞星与流年所查的那张表。default（默认）各干取通行表；其余取值按文墨天机「十干四化」原文四字命名，依禄权科忌顺序念，如 廉破曲阳 = 廉贞禄破军权文曲科太阳忌。可选：廉破曲阳（甲）、贪阴阳机（戊）、阳武同阴/阳武府同/阳武府相/阳武同相（庚）、巨阳武昌（辛）、梁紫府武/梁紫相武（壬）、破巨阳贪（癸）；乙丙丁己四干无变体。变体天干与所查该干不符时不生效，不会串表。与庚干那一项重叠时以本参数为准。',
+        },
         action: {
           type: 'string',
           enum: ['natal', 'advise', 'xuankong', 'assess', 'generate'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.63.0",
+  "version": "0.64.0",
   "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, 1,062-char name library with per-character pinyin, Kangxi stroke counts, five-grid (五格/三才) analysis and mechanical phonetics checks, a 78-card tarot library on the Rider-Waite-Smith base (per-card English name, image description, core meaning and astrological correspondence, cross-checked against three published sources; court cards carry no zodiac by design and the chart says so), 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 (全卦逐爻旺衰) and response-time clues (应期线索：逢值/逢冲/逢合 + 月建五态快慢) 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 (四化飞星串连), three-way-four-corner composite flights (三方四正复合飞化), switchable leap-month policy (闰月按日切分/整月归次月/整月归本月) eleven school switches (亮度/庚干四化/天马/天空/截空旬空/魁钺/天伤天使/长生/晚子时/身主/杂曜全表) for ziwei, the last one opting in to a 61-star minor-star (杂曜) table where each of the twelve extra stars carries its placement verse and the palace it landed in (verses accepted only when at least two independent published editions give the same table, homonymous stars never merged), caliber diffs for bazi/ziwei/qimen (same inputs, one switch, root-field changes), shadow-chart IDs (same normalized params → same ID; version bumps auto-diff chart fields), step-by-step deduction traces (liuyao najia→liuqin→shiying→fushen→strength; bazi strength score and pattern/yongshen; ziwei pattern conditions), and a bundled offline single-file page (命理排盘.html), a panel-to-chat handoff that asks the Harness about a finished chart, per-tab lazy engine chunks so the first-screen client bundle stays under 100KB gzip, and a public verification report (128 classical hexagram cases, 312 Zi Wei charts × 34 patterns, 12 dayun handover cases) generated from the same source that gates CI.",
   "keywords": [