dsh-metaphysics 0.14.3 → 0.16.0

package/engine/meihua.js

@@ -1,136 +1,137 @@
-// 梅花易数：时间/数字起卦、体用、互卦、变卦、错综卦
-import { BRANCHES } from './calendar.js';
-import { solarToLunar } from './lunar.js';
-import { hexagramFromBits } from './liuyao.js';
-
-// 先天八卦数：乾1 兑2 离3 震4 巽5 坎6 艮7 坤8
-const TRI_NAME = ['', '乾', '兑', '离', '震', '巽', '坎', '艮', '坤'];
-const TRI_BITS = {
-  乾: [1, 1, 1], 兑: [1, 1, 0], 离: [1, 0, 1], 震: [1, 0, 0],
-  巽: [0, 1, 1], 坎: [0, 1, 0], 艮: [0, 0, 1], 坤: [0, 0, 0],
-};
-const TRI_ELEMENT = { 乾: '金', 兑: '金', 离: '火', 震: '木', 巽: '木', 坎: '水', 艮: '土', 坤: '土' };
-const GENERATES = { 木: '火', 火: '土', 土: '金', 金: '水', 水: '木' };
-const OVERCOMES = { 木: '土', 土: '水', 水: '火', 火: '金', 金: '木' };
-
-const mod8 = (n) => ((n % 8) + 7) % 8 + 1; // 1..8，余 0 作 8
-const mod6 = (n) => ((n % 6) + 5) % 6 + 1; // 1..6，余 0 作 6
-
-function bitsOf(num) {
-  return TRI_BITS[TRI_NAME[num]];
-}
-
-function hexName(upperNum, lowerNum) {
-  const bits = [...bitsOf(lowerNum), ...bitsOf(upperNum)];
-  const h = hexagramFromBits(bits);
-  return { name: h.name, upper: TRI_NAME[upperNum], lower: TRI_NAME[lowerNum], bits };
-}
-
-/** 体用关系 */
-function relation(bodyEl, useEl) {
-  if (bodyEl === useEl) return { level: '吉', text: '体用比和，事顺而稳' };
-  if (GENERATES[useEl] === bodyEl) return { level: '大吉', text: `用生体（${useEl}生${bodyEl}），得外力相助` };
-  if (GENERATES[bodyEl] === useEl) return { level: '小凶', text: `体生用（${bodyEl}生${useEl}），耗损付出` };
-  if (OVERCOMES[bodyEl] === useEl) return { level: '吉', text: `体克用（${bodyEl}克${useEl}），事可为但费力` };
-  return { level: '凶', text: `用克体（${useEl}克${bodyEl}），受阻受制` };
-}
-
-/**
- * 起卦
- * @param {object} input
- *   mode: 'time' | 'number'
- *   datetime: 'YYYY-MM-DDTHH:mm'（time 模式）
- *   upper/lower/changing: 数字（number 模式，可给两数由程序取余）
- */
-export function buildMeihua(input = {}) {
-  const mode = input.mode === 'number' ? 'number' : 'time';
-  let upperNum;
-  let lowerNum;
-  let moving;
-  let source;
-
-  if (mode === 'number') {
-    const a = Number(input.upper);
-    const b = Number(input.lower);
-    if (!Number.isFinite(a) || !Number.isFinite(b)) throw new Error('数字起卦需要两个数字（upper / lower）');
-    upperNum = mod8(a);
-    lowerNum = mod8(b);
-    moving = Number.isFinite(Number(input.changing)) && Number(input.changing) > 0
-      ? mod6(Number(input.changing))
-      : mod6(a + b);
-    source = `数字起卦：${a} / ${b}`;
-  } else {
-    const dt = parseDateTime(input.datetime);
-    const lunar = solarToLunar(dt.year, dt.month, dt.day);
-    const yearBranch = ((lunar.lunarYear - 4) % 12 + 12) % 12;
-    const hb = Math.floor(((dt.hour + 1) % 24) / 2);
-    const sum1 = yearBranch + 1 + lunar.month + lunar.day;
-    const sum2 = sum1 + hb + 1;
-    upperNum = mod8(sum1);
-    lowerNum = mod8(sum2);
-    moving = mod6(sum2);
-    source = `时间起卦：${BRANCHES[yearBranch]}年${lunar.month}月${lunar.day}日${BRANCHES[hb]}时`;
-  }
-
-  const ben = hexName(upperNum, lowerNum);
-  const bits = ben.bits;
-
-  // 动爻：自下而上第 moving 爻
-  const changedBits = bits.slice();
-  changedBits[moving - 1] = changedBits[moving - 1] ? 0 : 1;
-  const bian = hexagramFromBits(changedBits);
-
-  // 互卦：2·3·4 为下互，3·4·5 为上互
-  const huLower = [bits[1], bits[2], bits[3]];
-  const huUpper = [bits[2], bits[3], bits[4]];
-  const hu = hexagramFromBits([...huLower, ...huUpper]);
-
-  // 体用：动爻所在之卦为用，另一卦为体
-  const movingInUpper = moving >= 4;
-  const bodyTri = movingInUpper ? ben.lower : ben.upper;
-  const useTri = movingInUpper ? ben.upper : ben.lower;
-  const rel = relation(TRI_ELEMENT[bodyTri], TRI_ELEMENT[useTri]);
-
-  // 错卦＝六爻全变；综卦＝整卦倒转（覆卦），不是上下卦对调：天风姤 → 泽天夬
-  const cuoBits = bits.map((b) => (b ? 0 : 1));
-  const zongBits = bits.slice().reverse();
-  const cuo = hexagramFromBits(cuoBits);
-  const zong = hexagramFromBits(zongBits);
-
-  return {
-    system: 'meihua',
-    mode,
-    source,
-    moving,
-    movingName: ['初爻', '二爻', '三爻', '四爻', '五爻', '上爻'][moving - 1],
-    ben: { name: ben.name, upper: ben.upper, lower: ben.lower, element: `${TRI_ELEMENT[ben.upper]}/${TRI_ELEMENT[ben.lower]}` },
-    hu: { name: hu.name, upper: hu.upper, lower: hu.lower },
-    bian: { name: bian.name, upper: bian.upper, lower: bian.lower },
-    cuo: { name: cuo.name },
-    zong: { name: zong.name },
-    bodyUse: {
-      body: { trigram: bodyTri, element: TRI_ELEMENT[bodyTri] },
-      use: { trigram: useTri, element: TRI_ELEMENT[useTri] },
-      relation: rel.text,
-      level: rel.level,
-    },
-    lines: bits.map((b, i) => ({
-      position: i + 1,
-      name: ['初爻', '二爻', '三爻', '四爻', '五爻', '上爻'][i],
-      yinYang: b ? '阳' : '阴',
-      moving: i === moving - 1,
-    })),
-  };
-}
-
-function parseDateTime(text) {
-  if (typeof text !== 'string' || !text.trim()) throw new Error('时间起卦需要 datetime');
-  const m = text.trim().match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T\s](\d{1,2}):(\d{1,2}))?$/);
-  if (!m) throw new Error(`无法解析 datetime：「${text}」`);
-  return {
-    year: Number(m[1]), month: Number(m[2]), day: Number(m[3]),
-    hour: Number(m[4] ?? 0), minute: Number(m[5] ?? 0),
-  };
-}
-
-export { TRI_NAME, TRI_ELEMENT, TRI_BITS };
+// 梅花易数：时间/数字起卦、体用、互卦、变卦、错综卦
+import { BRANCHES } from './calendar.js';
+import { solarToLunar } from './lunar.js';
+import { fail } from './fail.js';
+import { hexagramFromBits } from './liuyao.js';
+
+// 先天八卦数：乾1 兑2 离3 震4 巽5 坎6 艮7 坤8
+const TRI_NAME = ['', '乾', '兑', '离', '震', '巽', '坎', '艮', '坤'];
+const TRI_BITS = {
+  乾: [1, 1, 1], 兑: [1, 1, 0], 离: [1, 0, 1], 震: [1, 0, 0],
+  巽: [0, 1, 1], 坎: [0, 1, 0], 艮: [0, 0, 1], 坤: [0, 0, 0],
+};
+const TRI_ELEMENT = { 乾: '金', 兑: '金', 离: '火', 震: '木', 巽: '木', 坎: '水', 艮: '土', 坤: '土' };
+const GENERATES = { 木: '火', 火: '土', 土: '金', 金: '水', 水: '木' };
+const OVERCOMES = { 木: '土', 土: '水', 水: '火', 火: '金', 金: '木' };
+
+const mod8 = (n) => ((n % 8) + 7) % 8 + 1; // 1..8，余 0 作 8
+const mod6 = (n) => ((n % 6) + 5) % 6 + 1; // 1..6，余 0 作 6
+
+function bitsOf(num) {
+  return TRI_BITS[TRI_NAME[num]];
+}
+
+function hexName(upperNum, lowerNum) {
+  const bits = [...bitsOf(lowerNum), ...bitsOf(upperNum)];
+  const h = hexagramFromBits(bits);
+  return { name: h.name, upper: TRI_NAME[upperNum], lower: TRI_NAME[lowerNum], bits };
+}
+
+/** 体用关系 */
+function relation(bodyEl, useEl) {
+  if (bodyEl === useEl) return { level: '吉', text: '体用比和，事顺而稳' };
+  if (GENERATES[useEl] === bodyEl) return { level: '大吉', text: `用生体（${useEl}生${bodyEl}），得外力相助` };
+  if (GENERATES[bodyEl] === useEl) return { level: '小凶', text: `体生用（${bodyEl}生${useEl}），耗损付出` };
+  if (OVERCOMES[bodyEl] === useEl) return { level: '吉', text: `体克用（${bodyEl}克${useEl}），事可为但费力` };
+  return { level: '凶', text: `用克体（${useEl}克${bodyEl}），受阻受制` };
+}
+
+/**
+ * 起卦
+ * @param {object} input
+ *   mode: 'time' | 'number'
+ *   datetime: 'YYYY-MM-DDTHH:mm'（time 模式）
+ *   upper/lower/changing: 数字（number 模式，可给两数由程序取余）
+ */
+export function buildMeihua(input = {}) {
+  const mode = input.mode === 'number' ? 'number' : 'time';
+  let upperNum;
+  let lowerNum;
+  let moving;
+  let source;
+
+  if (mode === 'number') {
+    const a = Number(input.upper);
+    const b = Number(input.lower);
+    if (!Number.isFinite(a) || !Number.isFinite(b)) throw fail('E_INPUT', '数字起卦需要两个数字（upper / lower），例如 upper=3、lower=5');
+    upperNum = mod8(a);
+    lowerNum = mod8(b);
+    moving = Number.isFinite(Number(input.changing)) && Number(input.changing) > 0
+      ? mod6(Number(input.changing))
+      : mod6(a + b);
+    source = `数字起卦：${a} / ${b}`;
+  } else {
+    const dt = parseDateTime(input.datetime);
+    const lunar = solarToLunar(dt.year, dt.month, dt.day);
+    const yearBranch = ((lunar.lunarYear - 4) % 12 + 12) % 12;
+    const hb = Math.floor(((dt.hour + 1) % 24) / 2);
+    const sum1 = yearBranch + 1 + lunar.month + lunar.day;
+    const sum2 = sum1 + hb + 1;
+    upperNum = mod8(sum1);
+    lowerNum = mod8(sum2);
+    moving = mod6(sum2);
+    source = `时间起卦：${BRANCHES[yearBranch]}年${lunar.month}月${lunar.day}日${BRANCHES[hb]}时`;
+  }
+
+  const ben = hexName(upperNum, lowerNum);
+  const bits = ben.bits;
+
+  // 动爻：自下而上第 moving 爻
+  const changedBits = bits.slice();
+  changedBits[moving - 1] = changedBits[moving - 1] ? 0 : 1;
+  const bian = hexagramFromBits(changedBits);
+
+  // 互卦：2·3·4 为下互，3·4·5 为上互
+  const huLower = [bits[1], bits[2], bits[3]];
+  const huUpper = [bits[2], bits[3], bits[4]];
+  const hu = hexagramFromBits([...huLower, ...huUpper]);
+
+  // 体用：动爻所在之卦为用，另一卦为体
+  const movingInUpper = moving >= 4;
+  const bodyTri = movingInUpper ? ben.lower : ben.upper;
+  const useTri = movingInUpper ? ben.upper : ben.lower;
+  const rel = relation(TRI_ELEMENT[bodyTri], TRI_ELEMENT[useTri]);
+
+  // 错卦＝六爻全变；综卦＝整卦倒转（覆卦），不是上下卦对调：天风姤 → 泽天夬
+  const cuoBits = bits.map((b) => (b ? 0 : 1));
+  const zongBits = bits.slice().reverse();
+  const cuo = hexagramFromBits(cuoBits);
+  const zong = hexagramFromBits(zongBits);
+
+  return {
+    system: 'meihua',
+    mode,
+    source,
+    moving,
+    movingName: ['初爻', '二爻', '三爻', '四爻', '五爻', '上爻'][moving - 1],
+    ben: { name: ben.name, upper: ben.upper, lower: ben.lower, element: `${TRI_ELEMENT[ben.upper]}/${TRI_ELEMENT[ben.lower]}` },
+    hu: { name: hu.name, upper: hu.upper, lower: hu.lower },
+    bian: { name: bian.name, upper: bian.upper, lower: bian.lower },
+    cuo: { name: cuo.name },
+    zong: { name: zong.name },
+    bodyUse: {
+      body: { trigram: bodyTri, element: TRI_ELEMENT[bodyTri] },
+      use: { trigram: useTri, element: TRI_ELEMENT[useTri] },
+      relation: rel.text,
+      level: rel.level,
+    },
+    lines: bits.map((b, i) => ({
+      position: i + 1,
+      name: ['初爻', '二爻', '三爻', '四爻', '五爻', '上爻'][i],
+      yinYang: b ? '阳' : '阴',
+      moving: i === moving - 1,
+    })),
+  };
+}
+
+function parseDateTime(text) {
+  if (typeof text !== 'string' || !text.trim()) throw fail('E_INPUT', '时间起卦需要 datetime，例如 2026-10-24T11:43');
+  const m = text.trim().match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T\s](\d{1,2}):(\d{1,2}))?$/);
+  if (!m) throw fail('E_INPUT', `无法解析 datetime：「${text}」，请用 2026-10-24T11:43 这种格式`);
+  return {
+    year: Number(m[1]), month: Number(m[2]), day: Number(m[3]),
+    hour: Number(m[4] ?? 0), minute: Number(m[5] ?? 0),
+  };
+}
+
+export { TRI_NAME, TRI_ELEMENT, TRI_BITS };

package/engine/nayin.js

@@ -0,0 +1,24 @@
+// 六十甲子纳音（每两个干支一名）。
+//
+// 之前 bazi.js 与 ziwei.js 各存了一份完全相同的 30 项表：改一处漏改另一处，
+// 就会出现「八字时柱纳音」与「紫微五行局」对不上的静默错误。这里收成单一来源。
+
+export const NAYIN_NAMES = [
+  '海中金', '炉中火', '大林木', '路旁土', '剑锋金',
+  '山头火', '涧下水', '城头土', '白蜡金', '杨柳木',
+  '泉中水', '屋上土', '霹雳火', '松柏木', '长流水',
+  '沙中金', '山下火', '平地木', '壁上土', '金箔金',
+  '覆灯火', '天河水', '大驿土', '钗钏金', '桑柘木',
+  '大溪水', '沙中土', '天上火', '石榴木', '大海水',
+];
+
+/**
+ * 按六十甲子序号取纳音。序号可越界/为负，内部先归一到 0–59。
+ * @param {number} ganzhiIdx 0 = 甲子 … 59 = 癸亥
+ * @returns {{name: string, element: '金'|'木'|'水'|'火'|'土'}}
+ */
+export function nayinOf(ganzhiIdx) {
+  const i = ((Number(ganzhiIdx) % 60) + 60) % 60;
+  const name = NAYIN_NAMES[Math.floor(i / 2)];
+  return { name, element: name[2] };
+}