dsh-metaphysics 0.38.2 → 0.46.5

package/engine/ziwei.js

@@ -74,12 +74,182 @@ export const MUTAGEN = {
   癸: { 破军: '禄', 巨门: '权', 太阴: '科', 贪狼: '忌' },
 };
 
+// ── 流派开关 ──────────────────────────────────────────────────
+// 默认值对齐本插件既有盘面：亮度用内置通行表，庚干用阳武阴同，
+// 天马按年支、魁钺用全书理解一、天使天伤不换、长生按现有五行局表、
+// 晚子时仍算当日；天空/截空旬空默认不排（旧盘没有这两组星，保持 49 颗）。
+// 其余选项只在显式指定时改变盘面，不影响默认输出。
+export const ZIWEI_SCHOOL_DEFAULTS = Object.freeze({
+  brightnessSchool: 'default',
+  gengYearSihua: 'GYWYT',
+  tianmaSchool: 'year-branch',
+  tiankongSchool: 'off',
+  jiekongSchool: 'off',
+  kuiyueSchool: 'qs1',
+  tianshiTianshang: 'normal',
+  changshengSchool: 'yin-yang-shun-ni',
+  lateZishi: 'current-day',
+});
+
+export const ZIWEI_SCHOOL_OPTIONS = Object.freeze({
+  brightnessSchool: ['default', 'QS', 'XD1', 'ZZ', 'XD2'],
+  gengYearSihua: ['GYWYT', 'GYWTY', 'GYWFT', 'GYWFX', 'GYWTX'],
+  tianmaSchool: ['year-branch', 'month-branch'],
+  tiankongSchool: ['off', 'normal', 'shun-jia-shi'],
+  jiekongSchool: ['off', 'double', 'single', 'zhanyan'],
+  kuiyueSchool: ['qs1', 'qs2', 'zhong-yiming', 'network'],
+  tianshiTianshang: ['normal', 'zhongzhou'],
+  changshengSchool: ['yin-yang-shun-ni', 'shui-tu', 'huo-tu'],
+  lateZishi: ['current-day', 'next-day', 'all-current', 'day-cur-time-next'],
+});
+
+export function ziweiSchoolsOf(input = {}) {
+  const nested = input.schools && typeof input.schools === 'object' ? input.schools : {};
+  const out = {};
+  for (const [key, allowed] of Object.entries(ZIWEI_SCHOOL_OPTIONS)) {
+    const raw = input[key] !== undefined ? input[key] : nested[key];
+    out[key] = allowed.includes(raw) ? raw : ZIWEI_SCHOOL_DEFAULTS[key];
+  }
+  return out;
+}
+
+// 亮度表按流派取值：数值 1–7 按各派档位换成中文。
+// QS / XD1 为七档（1庙…7陷），ZZ / XD2 为五档（1庙 2旺 3平 4闲 5陷）。
+const BRIGHTNESS_LEVELS_7 = ['', '庙', '旺', '得', '利', '平', '不', '陷'];
+const BRIGHTNESS_LEVELS_5 = ['', '庙', '旺', '平', '闲', '陷'];
+export const BRIGHTNESS_SCHOOLS = {
+  QS: {
+    levels: BRIGHTNESS_LEVELS_7,
+    rows: {
+      紫微: [5, 1, 2, 2, 3, 2, 1, 1, 2, 2, 3, 2],
+      天机: [1, 7, 3, 2, 4, 5, 1, 7, 3, 2, 4, 5],
+      太阳: [7, 6, 2, 1, 2, 2, 2, 3, 3, 5, 6, 7],
+      武曲: [2, 1, 3, 4, 1, 5, 2, 1, 3, 4, 1, 5],
+      天同: [2, 6, 4, 5, 5, 1, 7, 6, 2, 5, 5, 1],
+      廉贞: [5, 4, 1, 5, 4, 7, 5, 4, 1, 5, 4, 7],
+      天府: [1, 1, 1, 3, 1, 3, 2, 1, 3, 2, 1, 3],
+      太阴: [1, 1, 2, 7, 7, 7, 6, 6, 4, 2, 2, 1],
+      贪狼: [2, 1, 5, 4, 1, 7, 2, 1, 5, 4, 1, 7],
+      巨门: [2, 6, 1, 1, 7, 2, 2, 6, 1, 1, 7, 2],
+      天相: [1, 1, 1, 7, 3, 3, 1, 3, 1, 7, 3, 3],
+      天梁: [1, 2, 1, 1, 1, 3, 1, 2, 7, 3, 1, 7],
+      七杀: [2, 1, 1, 2, 1, 5, 2, 1, 1, 2, 1, 5],
+      破军: [1, 2, 3, 7, 2, 5, 1, 2, 3, 7, 2, 5],
+    },
+  },
+  XD1: {
+    levels: BRIGHTNESS_LEVELS_7,
+    rows: {
+      紫微: [5, 1, 1, 2, 3, 2, 1, 1, 2, 2, 3, 2],
+      天机: [1, 7, 3, 2, 4, 5, 1, 7, 3, 2, 4, 5],
+      太阳: [7, 6, 2, 1, 2, 2, 1, 3, 4, 5, 7, 7],
+      武曲: [2, 1, 3, 4, 1, 5, 2, 1, 3, 4, 1, 5],
+      天同: [2, 6, 4, 1, 5, 1, 7, 6, 2, 5, 5, 1],
+      廉贞: [5, 4, 1, 5, 4, 7, 5, 4, 1, 5, 4, 7],
+      天府: [1, 1, 1, 3, 2, 3, 2, 1, 3, 2, 2, 3],
+      太阴: [1, 1, 6, 7, 7, 7, 7, 5, 4, 2, 2, 1],
+      贪狼: [2, 1, 5, 3, 1, 7, 2, 1, 5, 4, 1, 7],
+      巨门: [2, 6, 1, 1, 5, 5, 2, 5, 1, 1, 5, 2],
+      天相: [1, 1, 1, 7, 5, 3, 3, 3, 1, 7, 3, 3],
+      天梁: [1, 2, 1, 2, 1, 7, 1, 2, 7, 3, 1, 7],
+      七杀: [2, 1, 1, 2, 3, 5, 2, 1, 1, 2, 1, 5],
+      破军: [1, 2, 3, 7, 2, 5, 1, 2, 3, 7, 2, 5],
+    },
+  },
+  ZZ: {
+    levels: BRIGHTNESS_LEVELS_5,
+    rows: {
+      紫微: [3, 1, 1, 2, 5, 2, 1, 1, 2, 3, 4, 2],
+      天机: [1, 5, 2, 2, 1, 3, 1, 5, 3, 2, 1, 3],
+      太阳: [5, 5, 2, 1, 2, 2, 1, 3, 4, 4, 5, 5],
+      武曲: [2, 1, 4, 5, 1, 3, 2, 1, 3, 2, 1, 3],
+      天同: [2, 5, 4, 1, 3, 1, 5, 5, 2, 3, 3, 1],
+      廉贞: [3, 2, 1, 4, 2, 5, 3, 1, 1, 3, 2, 5],
+      天府: [1, 1, 1, 3, 1, 3, 2, 1, 3, 5, 1, 2],
+      太阴: [1, 1, 4, 5, 4, 5, 5, 3, 3, 2, 2, 1],
+      贪狼: [2, 1, 3, 4, 1, 5, 2, 1, 3, 3, 1, 5],
+      巨门: [2, 2, 1, 1, 3, 3, 2, 5, 1, 1, 2, 2],
+      天相: [1, 1, 1, 5, 2, 3, 2, 4, 1, 5, 4, 3],
+      天梁: [1, 2, 1, 1, 2, 5, 1, 2, 5, 4, 2, 5],
+      七杀: [2, 1, 1, 5, 2, 3, 2, 2, 1, 4, 1, 3],
+      破军: [1, 2, 5, 2, 2, 4, 1, 1, 5, 5, 2, 3],
+    },
+  },
+  XD2: {
+    levels: BRIGHTNESS_LEVELS_5,
+    rows: {
+      紫微: [4, 1, 1, 2, 4, 2, 1, 1, 2, 3, 5, 2],
+      天机: [1, 5, 2, 2, 2, 3, 1, 5, 2, 2, 2, 3],
+      太阳: [5, 5, 2, 1, 2, 2, 1, 2, 3, 3, 5, 5],
+      武曲: [2, 1, 3, 5, 1, 3, 2, 1, 3, 2, 1, 3],
+      天同: [2, 5, 3, 1, 2, 1, 5, 5, 2, 3, 3, 1],
+      廉贞: [3, 2, 1, 4, 2, 5, 3, 1, 1, 3, 2, 5],
+      天府: [2, 1, 1, 3, 1, 2, 2, 1, 2, 3, 1, 2],
+      太阴: [1, 1, 5, 5, 5, 5, 5, 5, 2, 2, 1, 1],
+      贪狼: [2, 1, 3, 2, 1, 5, 2, 1, 3, 2, 1, 5],
+      巨门: [2, 5, 1, 2, 5, 1, 2, 5, 1, 2, 5, 1],
+      天相: [1, 1, 1, 5, 2, 3, 2, 3, 1, 5, 5, 3],
+      天梁: [1, 2, 1, 1, 2, 5, 1, 2, 5, 3, 2, 5],
+      七杀: [2, 2, 1, 5, 1, 3, 2, 2, 1, 3, 1, 3],
+      破军: [1, 1, 5, 2, 2, 3, 1, 1, 5, 5, 2, 3],
+    },
+  },
+};
+
+export function schoolBrightness(name, branchIndex, school = 'default') {
+  const table = BRIGHTNESS_SCHOOLS[school];
+  if (!table || !table.rows[name]) return BRIGHTNESS[name] ? BRIGHTNESS[name][fix(branchIndex)] : undefined;
+  const level = table.rows[name][fix(branchIndex)];
+  return level ? table.levels[level] : undefined;
+}
+
+// 庚干四化五变体
+const GENG_MUTAGEN = {
+  GYWYT: { 太阳: '禄', 武曲: '权', 太阴: '科', 天同: '忌' },
+  GYWTY: { 太阳: '禄', 武曲: '权', 天同: '科', 太阴: '忌' },
+  GYWFT: { 太阳: '禄', 武曲: '权', 天府: '科', 天同: '忌' },
+  GYWFX: { 太阳: '禄', 武曲: '权', 天府: '科', 天相: '忌' },
+  GYWTX: { 太阳: '禄', 武曲: '权', 天同: '科', 天相: '忌' },
+};
+
+function mutagenOf(stem, schools) {
+  if (stem === '庚') return GENG_MUTAGEN[schools.gengYearSihua] || MUTAGEN.庚;
+  return MUTAGEN[stem] ?? {};
+}
+
+// 安魁钺四派：差异集中在庚辛壬癸年
+export const KUI_YUE_SCHOOLS = {
+  qs2: {
+    甲: [1, 7], 戊: [1, 7], 庚: [6, 2], 乙: [0, 8], 己: [0, 8],
+    丙: [11, 9], 丁: [11, 9], 辛: [6, 2], 壬: [5, 3], 癸: [5, 3],
+  },
+  'zhong-yiming': {
+    甲: [1, 7], 戊: [1, 7], 庚: [2, 6], 乙: [0, 8], 己: [0, 8],
+    丙: [11, 9], 丁: [11, 9], 辛: [2, 6], 壬: [5, 3], 癸: [5, 3],
+  },
+  network: {
+    甲: [1, 7], 戊: [1, 7], 庚: [1, 7], 乙: [0, 8], 己: [0, 8],
+    丙: [11, 9], 丁: [11, 9], 辛: [6, 2], 壬: [3, 5], 癸: [3, 5],
+  },
+};
+
+// 截空（按生年干）：single 单星、double 正副双星、zhanyan 占验派
+const JIEKONG = {
+  single: { 甲: 8, 乙: 6, 丙: 4, 丁: 2, 戊: 0, 己: 9, 庚: 7, 辛: 5, 壬: 3, 癸: 1 },
+  double: {
+    甲: [8, 9], 乙: [7, 6], 丙: [4, 5], 丁: [3, 2], 戊: [0, 1],
+    己: [9, 8], 庚: [6, 7], 辛: [5, 4], 壬: [2, 3], 癸: [1, 0],
+  },
+  zhanyan: { 甲: 8, 乙: 6, 丙: 4, 丁: 2, 戊: 10, 己: 9, 庚: 7, 辛: 5, 壬: 3, 癸: 11 },
+};
+
 // 年干系
 export const LUCUN = { 甲: 2, 乙: 3, 丙: 5, 丁: 6, 戊: 5, 己: 6, 庚: 8, 辛: 9, 壬: 11, 癸: 0 };
 export const KUI_YUE = {
   甲: [1, 7], 戊: [1, 7], 庚: [1, 7], 乙: [0, 8], 己: [0, 8],
   丙: [11, 9], 丁: [11, 9], 辛: [6, 2], 壬: [3, 5], 癸: [3, 5],
 };
+KUI_YUE_SCHOOLS.qs1 = KUI_YUE;
 
 /** 命主：按命宫地支 */
 export const MING_ZHU = {
@@ -192,12 +362,31 @@ export function xiaoxianAge(branchIndex, triad, gender) {
 
 // ── 主流程 ────────────────────────────────────────────────────
 
+/**
+ * 闰月口径：split 按日切分（1–15 归本月、16 起归次月，主流排盘默认）、
+ * next 整月归次月、prev 整月归本月。`leapAsNext: true` 是 next 的旧写法。
+ */
+export const LEAP_POLICIES = ['split', 'next', 'prev'];
+
+export function leapPolicyOf(input) {
+  if (input && LEAP_POLICIES.includes(input.leapMonth)) return input.leapMonth;
+  return input && input.leapAsNext ? 'next' : 'split';
+}
+
+export function effectiveLunarMonth(raw, policy) {
+  if (!raw || !raw.isLeap) return raw ? raw.month : 0;
+  if (policy === 'next') return (raw.month % 12) + 1;
+  if (policy === 'split') return raw.day <= 15 ? raw.month : (raw.month % 12) + 1;
+  return raw.month;
+}
+
 /**
  * 排紫微斗数命盘
- * @param {object} input { year,month,day,hour,minute, gender, leapAsNext? }
+ * @param {object} input { year,month,day,hour,minute, gender, leapMonth? }
  */
 export function buildZiwei(input) {
   assertCivil(input);
+  const schools = ziweiSchoolsOf(input);
   const { year: cy, month: cm, day: cd, hour: ch = 0, minute: cmin = 0, gender = 'male' } = input;
   const useTrueSolar = input.trueSolar !== false;
   const geo = input.geo || (input.address ? resolveAddress(input.address) : null);
@@ -212,7 +401,9 @@ export function buildZiwei(input) {
     ? applyTrueSolar(civilJd, longitude)
     : { offsetMinutes: 0, jd: civilJd, note: '未启用真太阳时' };
   // 紫微按「时辰」起盘：真太阳时若跨时辰/跨日，命盘随之改变
-  const eff = jdToParts(solar.jd);
+  // 晚子时 next-day：23:00 后起盘日顺延一日，只改起盘日，不改真太阳时显示
+  let eff = jdToParts(solar.jd);
+  if (schools.lateZishi === 'next-day' && eff.hour >= 23) eff = jdToParts(solar.jd + 1);
   const year = eff.year;
   const month = eff.month;
   const day = eff.day;
@@ -220,9 +411,8 @@ export function buildZiwei(input) {
   const minute = eff.minute;
 
   const lunarRaw = solarToLunar(year, month, day);
-  const lunarMonth = lunarRaw.isLeap && input.leapAsNext
-    ? (lunarRaw.month % 12) + 1
-    : lunarRaw.month;
+  const leapPolicy = leapPolicyOf(input);
+  const lunarMonth = effectiveLunarMonth(lunarRaw, leapPolicy);
   const lunarDay = lunarRaw.day;
 
   const hb = hourBranchIndex(hour, minute);
@@ -232,6 +422,10 @@ export function buildZiwei(input) {
   const yearStem = yearGanzhi.stem;
   const yb = BRANCHES.indexOf(yearGanzhi.branch);
   const triad = triadOf(yb);
+  // 大限顺逆：阳男阴女顺行、阴男阳女逆行（天伤天使的中州派互换也要用它）
+  const yearYang = STEMS.indexOf(yearStem) % 2 === 0;
+  const forward = (yearYang && gender === 'male') || (!yearYang && gender === 'female');
+  const kuiyueTable = KUI_YUE_SCHOOLS[schools.kuiyueSchool] || KUI_YUE;
 
   // 命宫 / 身宫
   const soulIndex = fix(2 + (lunarMonth - 1) - hb);
@@ -247,12 +441,12 @@ export function buildZiwei(input) {
 
   // 星曜落宫
   const starsByBranch = Array.from({ length: 12 }, () => []);
-  // 安星：主星顺带记下所在宫的庙旺得利平不陷（BRIGHTNESS 以地支序索引，与 fix(branch) 一致）
+  // 安星：主星顺带记下所在宫的庙旺得利平不陷（亮度可按流派切换，默认用内置通行表）
   const put = (branch, name, type) => {
     const idx = fix(branch);
     const star = { name, type };
     if (type === '主星' && BRIGHTNESS[name]) {
-      const b = BRIGHTNESS[name][idx];
+      const b = schoolBrightness(name, idx, schools.brightnessSchool);
       if (b) star.brightness = b;
     }
     starsByBranch[idx].push(star);
@@ -278,7 +472,7 @@ export function buildZiwei(input) {
   put(lucun, '禄存', '吉星');
   put(lucun + 1, '擎羊', '煞星');
   put(lucun - 1, '陀罗', '煞星');
-  const [kui, yue] = KUI_YUE[yearStem];
+  const [kui, yue] = kuiyueTable[yearStem];
   put(kui, '天魁', '吉星');
   put(yue, '天钺', '吉星');
 
@@ -290,7 +484,11 @@ export function buildZiwei(input) {
   put(6 + yb, '天虚', '煞星');
   put(4 + yb, '龙池', '吉星');
   put(10 - yb, '凤阁', '吉星');
-  put(TIANMA[triad], '天马', '吉星');
+  // 天马：默认按年支三合，可切生月三合（正月起寅）
+  const maTriad = schools.tianmaSchool === 'month-branch'
+    ? triadOf(fix(2 + (lunarMonth - 1)))
+    : triad;
+  put(TIANMA[maTriad], '天马', '吉星');
   put(XIANCHI[triad], '咸池', '煞星');
   put(HUAGAI[triad], '华盖', '杂曜');
   const dirGroup = directionOf(yb);
@@ -298,6 +496,25 @@ export function buildZiwei(input) {
   put(GUASU[dirGroup], '寡宿', '煞星');
   put(posuIndex(yb), '破碎', '煞星');
 
+  // 空曜（默认不排，旧盘保持 49 颗）
+  if (schools.tiankongSchool !== 'off') {
+    put(schools.tiankongSchool === 'shun-jia-shi' ? yb + hb : yb + 1, '天空', '杂曜');
+  }
+  if (schools.jiekongSchool !== 'off') {
+    const jk = JIEKONG[schools.jiekongSchool][yearStem];
+    if (Array.isArray(jk)) {
+      put(jk[0], '截空', '杂曜');
+      put(jk[1], '副截', '杂曜');
+    } else {
+      put(jk, '截空', '杂曜');
+    }
+    // 旬空：本旬十日所空两支（年干支所在旬的末两位）
+    const nianIndex = (((lunarRaw.lunarYear - 4) % 60) + 60) % 60;
+    const decadeStart = nianIndex - (nianIndex % 10);
+    put(decadeStart + 10, '旬空', '杂曜');
+    put(decadeStart + 11, '副旬', '杂曜');
+  }
+
   // 月系
   put(9 + (lunarMonth - 1), '天刑', '煞星');  // 酉起正月顺行
   put(1 + (lunarMonth - 1), '天姚', '煞星');  // 丑起正月顺行
@@ -314,12 +531,13 @@ export function buildZiwei(input) {
   put(11 + hb, '地劫', '煞星');   // 亥宫起子时，顺行
   put(11 - hb, '地空', '煞星');   // 亥宫起子时，逆行
 
-  // 固定宫位：天伤恒在交友，天使恒在疾厄
-  put(soulIndex - 7, '天伤', '杂曜');
-  put(soulIndex - 5, '天使', '杂曜');
+  // 固定宫位：天伤恒在交友、天使恒在疾厄；中州派阴男阳女互换
+  const swapTianshi = schools.tianshiTianshang === 'zhongzhou' && !forward;
+  put(soulIndex - (swapTianshi ? 5 : 7), '天伤', '杂曜');
+  put(soulIndex - (swapTianshi ? 7 : 5), '天使', '杂曜');
 
-  // 生年四化
-  const mutagenMap = MUTAGEN[yearStem] ?? {};
+  // 生年四化（庚干按所选变体）
+  const mutagenMap = mutagenOf(yearStem, schools);
   for (const list of starsByBranch) {
     for (const star of list) {
       if (mutagenMap[star.name]) star.mutagen = mutagenMap[star.name];
@@ -330,13 +548,14 @@ export function buildZiwei(input) {
   const palaceNames = [];
   for (let i = 0; i < 12; i++) palaceNames[fix(soulIndex - i)] = PALACE_NAMES[i];
 
-  // 大限：阳男阴女顺行、阴男阳女逆行
-  const yearYang = STEMS.indexOf(yearStem) % 2 === 0;
-  const forward = (yearYang && gender === 'male') || (!yearYang && gender === 'female');
+  // 大限：阳男阴女顺行、阴男阳女逆行（forward 已在安星前算好）
   const startAge = bureau.number;
 
   // 十二神（长生/博士 随大限顺逆，将前/岁前 恒顺行）
-  const csStart = CHANGSHENG_START[bureau.number];
+  // 土五局长生起点按流派：默认申，河洛/火土派取寅
+  const csStart = schools.changshengSchool === 'huo-tu' && bureau.number === 5
+    ? 2
+    : CHANGSHENG_START[bureau.number];
   const shenshaAt = (branch) => {
     const d = forward ? 1 : -1;
     return {
@@ -442,8 +661,8 @@ export function buildZiwei(input) {
       liulu: BRANCHES[lu],
       liuyang: BRANCHES[fix(lu + 1)],
       liutuo: BRANCHES[fix(lu - 1)],
-      liukui: BRANCHES[KUI_YUE[gz.stem][0]],
-      liuyue: BRANCHES[KUI_YUE[gz.stem][1]],
+      liukui: BRANCHES[kuiyueTable[gz.stem][0]],
+      liuyue: BRANCHES[kuiyueTable[gz.stem][1]],
       mutagen: Object.entries(MUTAGEN[gz.stem] ?? {}).map(([s, k]) => `${s}化${k}`),
       daxian: dxPalace
         ? { palace: dxPalace.palace, start: dxPalace.daxian.start, end: dxPalace.daxian.end }
@@ -457,13 +676,16 @@ export function buildZiwei(input) {
     input: {
       year: cy, month: cm, day: cd, hour: ch, minute: cmin,
       gender,
-      leapAsNext: Boolean(input.leapAsNext),
+      leapMonth: leapPolicy,
+      leapAsNext: leapPolicy === 'next',
       longitude: longitude ?? null,
       address: input.address || null,
       geo,
       trueSolar: useTrueSolar,
       dst: { applied: !!dst.applied, note: dst.note || null },
+      schools: { ...schools },
     },
+    schools: { ...schools },
     solarTime: {
       civilText: `${cy}-${String(cm).padStart(2, '0')}-${String(cd).padStart(2, '0')} ${String(ch).padStart(2, '0')}:${String(cmin).padStart(2, '0')}`,
       trueSolarText: formatJd(solar.jd),
@@ -473,10 +695,16 @@ export function buildZiwei(input) {
     lunar: {
       year: lunarRaw.lunarYear,
       month: lunarMonth,
+      monthRaw: lunarRaw.month,
       day: lunarDay,
       isLeap: lunarRaw.isLeap,
+      leapPolicy,
       monthStart: lunarRaw.monthStart,
-      ...(lunarRaw.isLeap ? { note: '闰月按本月起盘（可用 leapAsNext 改为按次月）' } : {}),
+      ...(lunarRaw.isLeap ? {
+        note: leapPolicy === 'split'
+          ? `闰${lunarRaw.month}月按日切分：1–15 按本月、16 起按次月；本盘闰月${lunarDay}日按${lunarMonth}月`
+          : leapPolicy === 'next' ? '闰月整月按次月起盘' : '闰月整月按本月起盘',
+      } : {}),
     },
     hourBranch,
     yearGanzhi: yearGanzhi.name,
@@ -512,8 +740,9 @@ export function buildZiwei(input) {
     },
     rules: {
       ziweiPlacement: '借数法：局数除日数取商，商数自寅宫顺行，借数奇逆偶顺',
-      mutagen: '生年四化用中州派常用表；庚干各派有异（有以天同化科、太阴化忌者）',
-      leapMonth: '闰月默认按本月，可切换为按次月',
+      mutagen: '生年四化用中州派常用表；庚干可按流派切换（默认阳武阴同，另有同科阴忌、府科、府科相忌、同科相忌）',
+      schools: `流派开关：亮度 ${schools.brightnessSchool}、庚干四化 ${schools.gengYearSihua}、天马 ${schools.tianmaSchool}、天空 ${schools.tiankongSchool}、截空 ${schools.jiekongSchool}、魁钺 ${schools.kuiyueSchool}、天伤天使 ${schools.tianshiTianshang}、长生 ${schools.changshengSchool}、晚子时 ${schools.lateZishi}；庚干四化只作用于生年四化`,
+      leapMonth: '闰月默认按日切分（1–15 归本月、16 起归次月，主流排盘口径）；可传 leapMonth: next（整月归次月）或 prev（整月归本月），leapAsNext: true 等同 next',
       auxStars: '火铃按年支三合起点顺数至生时；羊陀夹禄存；魁钺按年干；地空亥起子时逆行、地劫顺行；三台八座随辅弼；恩光天贵随昌曲退一位；台辅封诰按时支',
       shensha: '长生、博士随大限顺逆；将前、岁前恒顺行；天伤恒在交友、天使恒在疾厄',
       masters: '命主按命宫地支，身主按生年地支',
@@ -950,8 +1179,7 @@ export function flowOf(chart, asOf) {
   const MI = a.minute === undefined ? now.getMinutes() : a.minute;
 
   const lr = solarToLunar(Y, M, D);
-  const leapAsNext = Boolean(chart.input && chart.input.leapAsNext);
-  const natalMonth = chart.lunar.isLeap && leapAsNext ? (chart.lunar.month % 12) + 1 : chart.lunar.month;
+  const natalMonth = chart.lunar.month; // 已在起盘时按闰月口径换算过，这里不再二次换月
   const natalHB = BRANCHES.indexOf(chart.hourBranch);
   const hbNow = hourBranchIndex(H, MI);
 

package/index.js

@@ -92,8 +92,10 @@ export function apply(ctx) {
     if (next.system === 'xiaoliuren' && next.mode !== 'number' && !next.datetime && !next.date) {
       next.datetime = `${today}T${pad(now.getHours())}:${pad(now.getMinutes())}`;
     }
-    // 风水 natal 的流年飞星默认看今年；显式给了 fortuneYear 就按给的算
-    if (next.system === 'fengshui' && next.action !== 'advise' && next.fortuneYear === undefined) {
+    // 风水 natal 的流年飞星默认看今年；玄空由 period / fortuneYear 自定，不补默认年份，
+    // 否则缺省会悄悄把「默认九运」变成「按今年定运」。
+    if (next.system === 'fengshui' && (next.action === undefined || next.action === 'natal')
+      && next.fortuneYear === undefined) {
       next.fortuneYear = now.getFullYear();
     }
     return compute(next);
@@ -108,7 +110,7 @@ export function apply(ctx) {
         system: {
           type: 'string',
           enum: ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren', 'hepan', 'qimen', 'almanac', 'zeri', 'chenggu', 'xiaoliuren', 'star', 'numerology', 'mbti', 'trend', 'fengshui', 'name', 'convert'],
-          description: 'bazi = 四柱八字（含调候寒暖与《穷通宝鉴》120 格用神）；ziwei = 紫微斗数；liuyao = 六爻（纳甲、卦体关系、用神落位与月建日辰旺衰）；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需同时给 partner；qimen = 奇门遁甲（时家转盘，拆补法）；almanac = 黄历（某日宜忌/冲煞/建除/节气）；zeri = 择日（某事项在日期区间内逐日打分排序）；chenggu = 袁天罡称骨（骨重 + 通行本称骨歌原文 + 白话释义）；xiaoliuren = 小六壬（时间或报数起课）；star = 星座当日基调；numerology = 生命数字；mbti = 十六型人格（MBTI 风格 24 题问卷：给 answers 出类型，不给则先返回题目）；trend = 人生 K 线（大运/流年走势可视化）；fengshui = 风水（八宅命卦/流年飞星/门主灶布局）；name = 起名（391 字库的用字五行评估与候选生成；未收录字可传 charElements 指定五行）；convert = 公农历互转（solar2lunar 公历转农历 / lunar2solar 农历转公历）。',
+          description: 'bazi = 四柱八字（含调候寒暖与《穷通宝鉴》120 格用神）；ziwei = 紫微斗数；liuyao = 六爻（纳甲、卦体关系、用神落位与月建日辰旺衰）；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需同时给 partner；qimen = 奇门遁甲（时家转盘，拆补法）；almanac = 黄历（某日宜忌/冲煞/建除/节气）；zeri = 择日（某事项在日期区间内逐日打分排序）；chenggu = 袁天罡称骨（骨重 + 通行本称骨歌原文 + 白话释义）；xiaoliuren = 小六壬（时间或报数起课）；star = 星座当日基调；numerology = 生命数字；mbti = 十六型人格（MBTI 风格 24 题问卷：给 answers 出类型，不给则先返回题目）；trend = 人生 K 线（大运/流年走势可视化）；fengshui = 风水（八宅命卦/流年飞星/门主灶布局/玄空下卦，action 三选一）；name = 起名（391 字库的用字五行评估与候选生成；未收录字可传 charElements 指定五行）；convert = 公农历互转（solar2lunar 公历转农历 / lunar2solar 农历转公历）。',
         },
         datetime: {
           type: 'string',
@@ -275,24 +277,78 @@ export function apply(ctx) {
           enum: [1, 3, 5],
           description: '塔罗张数：1 单张指引、3 过去现在未来、5 十字牌阵。默认 3。',
         },
+        leapMonth: {
+          type: 'string',
+          enum: ['split', 'next', 'prev'],
+          description: '紫微斗数：闰月口径。split（默认，按日切分：1–15 归本月、16 起归次月，主流排盘口径）、next（整月归次月）、prev（整月归本月）。',
+        },
         leapAsNext: {
           type: 'boolean',
-          description: '紫微斗数：闰月是否按次月起盘（默认按本月起盘）。',
+          description: '紫微斗数：旧写法，true 等同 leapMonth: next。',
+        },
+        brightnessSchool: {
+          type: 'string',
+          enum: ['default', 'QS', 'XD1', 'ZZ', 'XD2'],
+          description: '紫微斗数：星曜亮度流派。default 用内置通行表；QS/XD1 为全书派/现代派七档，ZZ/XD2 为五档。只影响十四主星的庙旺得利平不陷。',
+        },
+        gengYearSihua: {
+          type: 'string',
+          enum: ['GYWYT', 'GYWTY', 'GYWFT', 'GYWFX', 'GYWTX'],
+          description: '紫微斗数：庚干四化变体，默认 GYWYT（阳武阴同）。仅作用于生年四化。',
+        },
+        tianmaSchool: {
+          type: 'string',
+          enum: ['year-branch', 'month-branch'],
+          description: '紫微斗数：天马安法。year-branch（默认）按年支三合，month-branch 改按生月三合。',
+        },
+        tiankongSchool: {
+          type: 'string',
+          enum: ['off', 'normal', 'shun-jia-shi'],
+          description: '紫微斗数：天空安法。off（默认不排）、normal（年支顺行一位）、shun-jia-shi（年支加生时）。',
+        },
+        jiekongSchool: {
+          type: 'string',
+          enum: ['off', 'double', 'single', 'zhanyan'],
+          description: '紫微斗数：截空/旬空安法。off（默认不排）、single 单星、double 正副双星、zhanyan 占验派；非 off 时同时排旬空、副旬。',
+        },
+        kuiyueSchool: {
+          type: 'string',
+          enum: ['qs1', 'qs2', 'zhong-yiming', 'network'],
+          description: '紫微斗数：天魁天钺安法，默认 qs1（全书理解一），差异集中在庚辛壬癸年。',
+        },
+        tianshiTianshang: {
+          type: 'string',
+          enum: ['normal', 'zhongzhou'],
+          description: '紫微斗数：天伤天使安法。normal（默认，天伤交友、天使疾厄）、zhongzhou（阴男阳女互换）。',
+        },
+        changshengSchool: {
+          type: 'string',
+          enum: ['yin-yang-shun-ni', 'shui-tu', 'huo-tu'],
+          description: '紫微斗数：长生十二神起点流派。默认 yin-yang-shun-ni；huo-tu 把土五局起点从申改寅；shui-tu 与默认同。',
+        },
+        lateZishi: {
+          type: 'string',
+          enum: ['current-day', 'next-day', 'all-current', 'day-cur-time-next'],
+          description: '紫微斗数：晚子时口径。current-day（默认，23:00 后仍按当日）、next-day（起盘日顺延次日）；另两个别名保留为兼容值。',
         },
         action: {
           type: 'string',
-          enum: ['natal', 'advise', 'assess', 'generate'],
-          description: '子动作。fengshui：natal（默认，算八宅命卦+流年飞星，需生日与性别）、advise（算宅卦门主灶布局，需 sitting 或 facing，出生信息可选）；name：assess（默认，评估已有名字，需 surname + givenName）、generate（生成候选名，需生辰，可选 surname / limit）。',
+          enum: ['natal', 'advise', 'xuankong', 'assess', 'generate'],
+          description: '子动作。fengshui：natal（默认，算八宅命卦+流年飞星，需生日与性别）、advise（算宅卦门主灶布局，需 sitting 或 facing，出生信息可选）、xuankong（玄空下卦九宫盘，需 sitting 或 facing，运由 period 或 fortuneYear 定，缺省九运并注明）；name：assess（默认，评估已有名字，需 surname + givenName）、generate（生成候选名，需生辰，可选 surname / limit）。',
         },
         toAge: {
           type: 'number',
           description: '仅 trend 使用：算到几岁（10–100，默认 100）。',
         },
-        sitting: { type: 'string', description: '仅 fengshui advise：坐山（24 山之一，如 子/午/乾）。与 facing 至少给一个。' },
-        facing: { type: 'string', description: '仅 fengshui advise：向山（24 山之一）。缺 sitting 时按对宫反推。' },
+        sitting: { type: 'string', description: '仅 fengshui advise / xuankong：坐山（24 山之一，如 子/午/乾）。与 facing 至少给一个（玄空按坐向定山盘/向盘）。' },
+        facing: { type: 'string', description: '仅 fengshui advise / xuankong：向山（24 山之一）。缺 sitting 时按对宫反推。' },
         fortuneYear: {
           type: 'number',
-          description: '仅 fengshui natal：流年九宫飞星的目标年份，省略则不算飞星（只算命卦与八星）。',
+          description: '仅 fengshui natal / xuankong：natal 用它定流年九宫飞星（省略则按今年）；xuankong 用它定三元九运（省略按九运）。',
+        },
+        period: {
+          type: 'number',
+          description: '仅 fengshui xuankong：三元九运的运（1–9）。优先于 fortuneYear；省略时按 fortuneYear 定，再缺省按九运（2024–2043）并注明。',
         },
         surname: { type: 'string', description: '仅 name 使用：姓氏，如「李」（复姓整体写，如「欧阳」）。' },
         givenName: { type: 'string', description: '仅 name assess 使用：名（1–2 个汉字）。' },

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.38.2",
+  "version": "0.46.5",
   "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 / 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.",
+  "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 with per-character pinyin, Kangxi stroke counts, five-grid (五格/三才) analysis and mechanical phonetics checks, 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 (四化飞星串连), three-way-four-corner composite flights (三方四正复合飞化), switchable leap-month policy (闰月按日切分/整月归次月/整月归本月) and nine school switches (亮度/庚干四化/天马/天空/截空旬空/魁钺/天伤天使/长生/晚子时) 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": [
     "玄学",
     "玄学排盘",