mingyu-core 0.1.0

package/dist/divination/algorithms/qimen/helpers/jushu.d.ts

@@ -0,0 +1,137 @@
+/**
+ * @file 奇门遁甲定局数、值符值使、特殊时辰和遁干
+ * @description 基于拆补法实现时家奇门的定局数、值符值使、特殊时辰检查和遁干。
+ *
+ * 拆补法以节气为界，不置闰，是当代主流排盘软件（元亨利贞、各在线排盘）普遍采用的定局法。
+ *
+ * ── 法理依据 ──
+ *
+ * 《烟波钓叟歌》：
+ *   "阴阳二遁分顺逆，一气三元人莫测。
+ *    五日都来换一元，接气超神为准则。"
+ *
+ * 《遁甲演义》卷一：
+ *   "冬至后用阳遁，顺布六仪逆布三奇；
+ *    夏至后用阴遁，逆布六仪顺布三奇。"
+ *
+ * 《奇门遁甲秘籍大全》卷三"定局成局诀"列二十四节气三元局数：
+ *   冬至惊蛰一七四，小寒二八五为嗣。
+ *   大寒春分三九六，立春八五二相随。
+ *   ……（二十四节气各有所属）
+ *
+ * 旬首法源出《秘籍大全》卷四"年家奇门定局"篇：
+ *   由干支求旬首地支，旬首地支对应地盘宫位，
+ *   该宫之星为值符，该宫之门为值使。
+ */
+/**
+ * 拆补法定三元局数
+ *
+ * 核心逻辑：
+ *   1. 以节气交节日为界，每个节气跨 15 天左右，含上中下三元。
+ *   2. 上元起于该节气内最近的"甲己符头日"（甲子/甲戌/甲申/甲午/甲辰/甲寅）。
+ *   3. 若符头早于节气交节日（超神），则该符头日之前属上一节气末尾（拆），
+ *      之后属本节气上元（补）；若符头晚于交节日，同理向下一节气拆补。
+ *   4. 本法不置闰，三元局数严格按节气表取。
+ *
+ * @param timeInfo 时间信息，包含 solar 日期字段（用于 拆补法 精确计算）、
+ *                 jieQi 节气名和 ganzhi 日干支（用作兜底）
+ * @returns { isYangDun, juShu, yuan, jieQi }
+ *    isYangDun  - 是否为阳遁
+ *    juShu      - 局数（1-9）
+ *    yuan       - 三元名称（"上元" | "中元" | "下元"）
+ *    jieQi      - 实际归属的节气名（当日期在第一个符头前时可能为上一节气）
+ *
+ * @throws 当无法获取节气信息或查找局数规则失败时
+ */
+export declare function getQimenJuShu(timeInfo: {
+    solar?: {
+        year: number;
+        month: number;
+        day: number;
+    };
+    jieQi: string;
+    ganzhi: {
+        day: string;
+    };
+}): {
+    isYangDun: boolean;
+    juShu: number;
+    yuan: string;
+    jieQi: string;
+};
+/**
+ * 检查特殊时辰情况
+ *
+ * 包括：六甲时、六癸时、时干入墓、五不遇时。
+ *
+ * 时干入墓法理依据（《烟波钓叟歌》："时干入墓凶无疑"）：
+ *   各天干五行墓地不同，时干遇其墓支即为入墓，
+ *   主事情停滞、阻力大，不宜举事。
+ *
+ * 五不遇时法理依据（《遁甲演义》）：
+ *   时干克日干，名为五不遇，主事多不顺，好事被阻，凶时。
+ *
+ * @param hourGanZhi 时辰干支字符串（如 "甲子"、"乙丑"）
+ * @returns 包含各项特殊条件的检查结果
+ */
+export declare function checkSpecialHourConditions(hourGanZhi: string): {
+    isLiuJiaHour: boolean;
+    isLiuGuiHour: boolean;
+    isShiGanRuMu: boolean;
+    isWuBuYuShi: boolean;
+    description: string;
+};
+/**
+ * 寻值符与值使（旬首法）
+ *
+ * 法理：
+ *   值符（九星之主）与值使（八门之主）由时辰干支所属的"旬"来决定。
+ *   旬首（如甲子、甲戌、甲申等）所在的九宫，其对应的星即为值符，
+ *   其对应的门即为值使。
+ *
+ * 《奇门遁甲秘籍大全》卷四：
+ *   "凡占事，先看值符以定九星之吉凶，再看值使以定八门之休咎。"
+ *
+ * 计算步骤：
+ *   1. 求旬首地支：旬首地支序数 = (时支序 - 时干序 + 12) % 12
+ *   2. 旬首地支对应地盘宫位即为旬首落宫
+ *   3. 该宫之星 = 值符，该宫之门 = 值使
+ *
+ * @param hourGanZhi 时辰干支（如 "甲子"、"乙丑"）
+ * @returns { zhiFu, zhiShi, zhiFuPalace, specialConditions }
+ *    zhiFu            - 值符星名
+ *    zhiShi           - 值使门名
+ *    zhiFuPalace      - 值符所在宫位（即旬首落宫）
+ *    specialConditions - 当前时辰的特殊情况
+ *
+ * @throws 当时辰干支无法识别时
+ */
+export declare function getZhiFuZhiShi(hourGanZhi: string): {
+    zhiFu: string;
+    zhiShi: string;
+    zhiFuPalace: number;
+    specialConditions: ReturnType<typeof checkSpecialHourConditions>;
+};
+/**
+ * 获取时辰的遁干（甲遁于六仪之下）
+ *
+ * 法理依据（《烟波钓叟歌》）：
+ *   "六甲元号六仪名，三奇即是乙丙丁。
+ *    阳遁顺仪奇逆布，阴遁逆仪奇顺行。"
+ *
+ * 六甲所遁：
+ *   甲子遁戊、甲戌遁己、甲申遁庚、
+ *   甲午遁辛、甲辰遁壬、甲寅遁癸。
+ *
+ * 非六甲时辰（时干不为"甲"）返回时干本身。
+ *
+ * @param hourGanZhi 时辰干支（如 "甲子"、"乙丑"）
+ * @returns 遁干后的天干名
+ *
+ * @example
+ *   getDunJiaStem('甲子') // => '戊'
+ *   getDunJiaStem('甲戌') // => '己'
+ *   getDunJiaStem('乙丑') // => '乙'（非六甲时返回时干本身）
+ */
+export declare function getDunJiaStem(hourGanZhi: string): string;
+//# sourceMappingURL=jushu.d.ts.map

package/dist/divination/algorithms/qimen/helpers/jushu.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jushu.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/jushu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAwEH;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE;IACtC,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAC;QAAC,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;IACrD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE;QAAE,GAAG,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB,GAAG;IACF,SAAS,EAAE,OAAO,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;CACf,CA6EA;AAMD;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG;IAC9D,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,YAAY,EAAE,OAAO,CAAC;IACtB,WAAW,EAAE,OAAO,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB,CA0EA;AAMD;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG;IAClD,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,UAAU,CAAC,OAAO,0BAA0B,CAAC,CAAC;CAClE,CA0BA;AAMD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAiBxD"}

package/dist/divination/algorithms/qimen/helpers/jushu.js

@@ -0,0 +1,352 @@
+/**
+ * @file 奇门遁甲定局数、值符值使、特殊时辰和遁干
+ * @description 基于拆补法实现时家奇门的定局数、值符值使、特殊时辰检查和遁干。
+ *
+ * 拆补法以节气为界，不置闰，是当代主流排盘软件（元亨利贞、各在线排盘）普遍采用的定局法。
+ *
+ * ── 法理依据 ──
+ *
+ * 《烟波钓叟歌》：
+ *   "阴阳二遁分顺逆，一气三元人莫测。
+ *    五日都来换一元，接气超神为准则。"
+ *
+ * 《遁甲演义》卷一：
+ *   "冬至后用阳遁，顺布六仪逆布三奇；
+ *    夏至后用阴遁，逆布六仪顺布三奇。"
+ *
+ * 《奇门遁甲秘籍大全》卷三"定局成局诀"列二十四节气三元局数：
+ *   冬至惊蛰一七四，小寒二八五为嗣。
+ *   大寒春分三九六，立春八五二相随。
+ *   ……（二十四节气各有所属）
+ *
+ * 旬首法源出《秘籍大全》卷四"年家奇门定局"篇：
+ *   由干支求旬首地支，旬首地支对应地盘宫位，
+ *   该宫之星为值符，该宫之门为值使。
+ */
+import { SolarDay } from 'tyme4ts';
+import { tiangan, jiazi, qimen } from '../../../../divination/divination-data';
+const { dizhi, diPanPalaces, palaceStars, palaceDoorMap, jieQiJuShuMap } = qimen;
+const tenStems = tiangan;
+// ============================================================================
+// 内部辅助方法
+// ============================================================================
+/** 六甲符头日：甲子、甲戌、甲申、甲午、甲辰、甲寅（上元起点候选） */
+const FU_TOU = ['甲子', '甲戌', '甲申', '甲午', '甲辰', '甲寅'];
+/**
+ * 将 Date 转为东八区年月日对应的 SolarDay
+ * @param date 要转换的日期
+ * @returns SolarDay 对象
+ */
+// eslint-disable-next-line @typescript-eslint/no-unused-vars
+function toSolarDay(date) {
+    const parts = new Intl.DateTimeFormat('zh-CN', {
+        timeZone: 'Asia/Shanghai',
+        year: 'numeric',
+        month: '2-digit',
+        day: '2-digit',
+    }).formatToParts(date);
+    const v = Object.fromEntries(parts.map((p) => [p.type, p.value]));
+    return SolarDay.fromYmd(Number(v.year), Number(v.month), Number(v.day));
+}
+/**
+ * 取某 SolarDay 的六十甲子名（如 "甲子"）
+ * @param sd 公历日
+ * @returns 干支字符串
+ */
+function getDayGanZhi(sd) {
+    return sd.getLunarDay().getSixtyCycle().getName();
+}
+/**
+ * 在 [from, to) 区间内按方向查找最近的符头日
+ * @param start 起始日
+ * @param direction -1 向前找，1 向后找
+ * @returns { day, ganzhi } 或 null
+ */
+function findFuTou(start, direction) {
+    let cur = start;
+    // 最多搜索 70 天（远超节气跨度 15 天），确保能找到
+    for (let i = 0; i < 70; i++) {
+        const gz = getDayGanZhi(cur);
+        if (FU_TOU.includes(gz))
+            return { day: cur, ganzhi: gz };
+        cur = direction === 1 ? cur.next(1) : cur.next(-1);
+    }
+    return null;
+}
+/**
+ * 计算两个 SolarDay 相隔天数（to - from）
+ * @param from 起始日
+ * @param to 结束日
+ * @returns 相差天数（可为负数）
+ */
+function dayDiff(from, to) {
+    return Math.round(Number(to.getJulianDay()) - Number(from.getJulianDay()));
+}
+// ============================================================================
+// 1. 定局数（拆补法）
+// ============================================================================
+/**
+ * 拆补法定三元局数
+ *
+ * 核心逻辑：
+ *   1. 以节气交节日为界，每个节气跨 15 天左右，含上中下三元。
+ *   2. 上元起于该节气内最近的"甲己符头日"（甲子/甲戌/甲申/甲午/甲辰/甲寅）。
+ *   3. 若符头早于节气交节日（超神），则该符头日之前属上一节气末尾（拆），
+ *      之后属本节气上元（补）；若符头晚于交节日，同理向下一节气拆补。
+ *   4. 本法不置闰，三元局数严格按节气表取。
+ *
+ * @param timeInfo 时间信息，包含 solar 日期字段（用于 拆补法 精确计算）、
+ *                 jieQi 节气名和 ganzhi 日干支（用作兜底）
+ * @returns { isYangDun, juShu, yuan, jieQi }
+ *    isYangDun  - 是否为阳遁
+ *    juShu      - 局数（1-9）
+ *    yuan       - 三元名称（"上元" | "中元" | "下元"）
+ *    jieQi      - 实际归属的节气名（当日期在第一个符头前时可能为上一节气）
+ *
+ * @throws 当无法获取节气信息或查找局数规则失败时
+ */
+export function getQimenJuShu(timeInfo) {
+    // ── 拆补法（优先） ──
+    if (timeInfo.solar) {
+        const today = SolarDay.fromYmd(timeInfo.solar.year, timeInfo.solar.month, timeInfo.solar.day);
+        // 获取当日所属节气
+        const term = today.getTerm();
+        if (!term) {
+            throw new Error(`无法获取 ${timeInfo.solar.year}年${timeInfo.solar.month}月${timeInfo.solar.day}日 的节气信息。`);
+        }
+        const jieQi = term.getName();
+        const rule = jieQiJuShuMap[jieQi];
+        if (!rule) {
+            throw new Error(`找不到节气 "${jieQi}" 对应的局数规则。`);
+        }
+        const isYangDun = rule.dun === '阳';
+        // 节气交节日（精确到日的节气起始日）
+        const jieQiDay = term.getSolarDay();
+        // 在本节气内找最早的符头日（从交节日当天往后找，取本节气内第一个符头）
+        // 拆补法以"本节气内出现的符头日"为上元起点
+        // 若交节日当天就是符头，则为正授
+        const fuTouAfter = findFuTou(jieQiDay, 1);
+        let yuanIndex;
+        if (fuTouAfter && !today.isBefore(fuTouAfter.day)) {
+            // 当日 >= 本节气内首个符头日
+            // 按天数差定上/中/下元：
+            //   符头日当天 ~ +4 天 → 上元
+            //   +5 天 ~ +9 天     → 中元
+            //   +10 天 ~ +14 天   → 下元
+            const diff = dayDiff(fuTouAfter.day, today); // 0..14
+            yuanIndex = Math.min(2, Math.floor(diff / 5));
+        }
+        else {
+            // 当日在本节气首个符头之前：
+            // 从交节日到首个符头之间的日期，属上一节气末尾拆过来的元
+            // 统一归为上一节气的下元
+            const prevTerm = term.next(-1);
+            const prevJieQi = prevTerm.getName();
+            const prevRule = jieQiJuShuMap[prevJieQi];
+            if (prevRule) {
+                return {
+                    isYangDun: prevRule.dun === '阳',
+                    juShu: prevRule.ju[2], // 上一节气下元
+                    yuan: '下元',
+                    jieQi: prevJieQi,
+                };
+            }
+            // 防御：如果查不到上一节气规则，用本节气下元
+            yuanIndex = 2;
+        }
+        const yuan = ['上元', '中元', '下元'][yuanIndex];
+        const juShu = rule.ju[yuanIndex];
+        return { isYangDun, juShu, yuan, jieQi };
+    }
+    // ── 兜底：无 solar 字段时使用日干支序数定元（旧方法） ──
+    const { jieQi, ganzhi } = timeInfo;
+    const dayGanZhi = ganzhi.day;
+    const rule = jieQiJuShuMap[jieQi];
+    if (!rule) {
+        throw new Error(`找不到节气 "${jieQi}" 对应的局数规则。`);
+    }
+    const isYangDun = rule.dun === '阳';
+    const dayIndex = jiazi.indexOf(dayGanZhi);
+    if (dayIndex === -1) {
+        throw new Error(`无法识别日干支 "${dayGanZhi}" 的三元归属。`);
+    }
+    const yuanIndex = Math.floor(dayIndex / 5) % 3;
+    const yuan = ['上元', '中元', '下元'][yuanIndex];
+    const juShu = rule.ju[yuanIndex];
+    return { isYangDun, juShu, yuan, jieQi };
+}
+// ============================================================================
+// 2. 检查特殊时辰情况
+// ============================================================================
+/**
+ * 检查特殊时辰情况
+ *
+ * 包括：六甲时、六癸时、时干入墓、五不遇时。
+ *
+ * 时干入墓法理依据（《烟波钓叟歌》："时干入墓凶无疑"）：
+ *   各天干五行墓地不同，时干遇其墓支即为入墓，
+ *   主事情停滞、阻力大，不宜举事。
+ *
+ * 五不遇时法理依据（《遁甲演义》）：
+ *   时干克日干，名为五不遇，主事多不顺，好事被阻，凶时。
+ *
+ * @param hourGanZhi 时辰干支字符串（如 "甲子"、"乙丑"）
+ * @returns 包含各项特殊条件的检查结果
+ */
+export function checkSpecialHourConditions(hourGanZhi) {
+    const hourGan = hourGanZhi.charAt(0);
+    const hourZhi = hourGanZhi.charAt(1);
+    const result = {
+        isLiuJiaHour: false,
+        isLiuGuiHour: false,
+        isShiGanRuMu: false,
+        isWuBuYuShi: false,
+        description: '',
+    };
+    // ── 1. 六甲时 ──
+    // 甲子、甲戌、甲申、甲午、甲辰、甲寅
+    // 《烟波钓叟歌》："六甲时分六仪名"
+    const liuJiaHours = ['甲子', '甲戌', '甲申', '甲午', '甲辰', '甲寅'];
+    if (liuJiaHours.includes(hourGanZhi)) {
+        result.isLiuJiaHour = true;
+        result.description += '六甲时辰（甲时），甲遁于六仪之下；';
+    }
+    // ── 2. 六癸时 ──
+    // 癸酉、癸未、癸巳、癸卯、癸丑、癸亥
+    const liuGuiHours = ['癸酉', '癸亥', '癸未', '癸巳', '癸卯', '癸丑'];
+    if (liuGuiHours.includes(hourGanZhi)) {
+        result.isLiuGuiHour = true;
+        result.description += '六癸时辰，癸为阴干之末；';
+    }
+    // ── 3. 时干入墓 ──
+    // 《遁甲演义》论入墓法：
+    //   乙入坤二宫（未支）、丙入乾六宫（戌支）、丁入艮八宫（丑支）
+    //   己入巽四宫（辰支）、庚入坤二宫（未支）、辛入艮八宫（丑支）
+    //   壬入巽四宫（辰支）、癸入离九宫（午支）
+    const ruMuMap = {
+        乙: { palace: 2, branch: '未' }, // 坤二宫
+        丙: { palace: 6, branch: '戌' }, // 乾六宫
+        丁: { palace: 8, branch: '丑' }, // 艮八宫
+        戊: { palace: 6, branch: '戌' }, // 乾六宫（戊随丙入墓）
+        己: { palace: 4, branch: '辰' }, // 巽四宫
+        庚: { palace: 2, branch: '未' }, // 坤二宫
+        辛: { palace: 8, branch: '丑' }, // 艮八宫
+        壬: { palace: 4, branch: '辰' }, // 巽四宫
+        癸: { palace: 9, branch: '午' }, // 离九宫
+    };
+    const ruMuInfo = ruMuMap[hourGan];
+    if (ruMuInfo && hourZhi === ruMuInfo.branch) {
+        result.isShiGanRuMu = true;
+        result.description += `时干${hourGan}入墓（${hourGan}入${ruMuInfo.palace}宫/${ruMuInfo.branch}支），事情停滞，不宜举事；`;
+    }
+    // ── 4. 五不遇时 ──
+    // 《遁甲演义》："五不遇时者，时干克日干也。"
+    // 传统固定列：甲申、乙酉、丙子、丁亥、戊寅、己卯、庚午、辛巳、壬辰、癸未
+    // 此时辰时干克日干，主事多不顺
+    const wuBuYuShiHours = [
+        '甲申',
+        '乙酉',
+        '丙子',
+        '丁亥',
+        '戊寅',
+        '己卯',
+        '庚午',
+        '辛巳',
+        '壬辰',
+        '癸未',
+    ];
+    if (wuBuYuShiHours.includes(hourGanZhi)) {
+        result.isWuBuYuShi = true;
+        result.description += '五不遇时（时干克日干），事多不顺，不宜举事；';
+    }
+    return result;
+}
+// ============================================================================
+// 3. 寻值符与值使
+// ============================================================================
+/**
+ * 寻值符与值使（旬首法）
+ *
+ * 法理：
+ *   值符（九星之主）与值使（八门之主）由时辰干支所属的"旬"来决定。
+ *   旬首（如甲子、甲戌、甲申等）所在的九宫，其对应的星即为值符，
+ *   其对应的门即为值使。
+ *
+ * 《奇门遁甲秘籍大全》卷四：
+ *   "凡占事，先看值符以定九星之吉凶，再看值使以定八门之休咎。"
+ *
+ * 计算步骤：
+ *   1. 求旬首地支：旬首地支序数 = (时支序 - 时干序 + 12) % 12
+ *   2. 旬首地支对应地盘宫位即为旬首落宫
+ *   3. 该宫之星 = 值符，该宫之门 = 值使
+ *
+ * @param hourGanZhi 时辰干支（如 "甲子"、"乙丑"）
+ * @returns { zhiFu, zhiShi, zhiFuPalace, specialConditions }
+ *    zhiFu            - 值符星名
+ *    zhiShi           - 值使门名
+ *    zhiFuPalace      - 值符所在宫位（即旬首落宫）
+ *    specialConditions - 当前时辰的特殊情况
+ *
+ * @throws 当时辰干支无法识别时
+ */
+export function getZhiFuZhiShi(hourGanZhi) {
+    const hourGan = hourGanZhi.charAt(0);
+    const hourZhi = hourGanZhi.charAt(1);
+    const hourGanIndex = tenStems.indexOf(hourGan);
+    const hourZhiIndex = dizhi.indexOf(hourZhi);
+    if (hourGanIndex === -1 || hourZhiIndex === -1) {
+        throw new Error(`无法识别时辰干支 "${hourGanZhi}"。`);
+    }
+    // 旬首地支序数 = (时支序 - 时干序 + 12) % 12
+    const xunShouZhiIndex = (hourZhiIndex - hourGanIndex + 12) % 12;
+    const xunShouZhi = dizhi[xunShouZhiIndex];
+    // 旬首地支对应地盘宫位
+    const xunShouPalace = diPanPalaces[xunShouZhi];
+    // 该宫之星 = 值符，该宫之门 = 值使
+    const zhiFu = palaceStars[xunShouPalace - 1];
+    const zhiShi = palaceDoorMap[xunShouPalace];
+    // 检查当前时辰的特殊情况
+    const specialConditions = checkSpecialHourConditions(hourGanZhi);
+    return { zhiFu, zhiShi, zhiFuPalace: xunShouPalace, specialConditions };
+}
+// ============================================================================
+// 4. 遁干（甲遁于六仪之下）
+// ============================================================================
+/**
+ * 获取时辰的遁干（甲遁于六仪之下）
+ *
+ * 法理依据（《烟波钓叟歌》）：
+ *   "六甲元号六仪名，三奇即是乙丙丁。
+ *    阳遁顺仪奇逆布，阴遁逆仪奇顺行。"
+ *
+ * 六甲所遁：
+ *   甲子遁戊、甲戌遁己、甲申遁庚、
+ *   甲午遁辛、甲辰遁壬、甲寅遁癸。
+ *
+ * 非六甲时辰（时干不为"甲"）返回时干本身。
+ *
+ * @param hourGanZhi 时辰干支（如 "甲子"、"乙丑"）
+ * @returns 遁干后的天干名
+ *
+ * @example
+ *   getDunJiaStem('甲子') // => '戊'
+ *   getDunJiaStem('甲戌') // => '己'
+ *   getDunJiaStem('乙丑') // => '乙'（非六甲时返回时干本身）
+ */
+export function getDunJiaStem(hourGanZhi) {
+    // 非六甲时：时干不为"甲"，返回时干本身
+    if (!hourGanZhi.startsWith('甲')) {
+        return hourGanZhi.charAt(0);
+    }
+    // 六甲时：甲遁于六仪之下
+    const dunJiaMap = {
+        甲子: '戊',
+        甲戌: '己',
+        甲申: '庚',
+        甲午: '辛',
+        甲辰: '壬',
+        甲寅: '癸',
+    };
+    return dunJiaMap[hourGanZhi] || '戊';
+}
+//# sourceMappingURL=jushu.js.map

package/dist/divination/algorithms/qimen/helpers/jushu.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"jushu.js","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/jushu.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,wCAAwC,CAAC;AAE/E,MAAM,EAAE,KAAK,EAAE,YAAY,EAAE,WAAW,EAAE,aAAa,EAAE,aAAa,EAAE,GAAG,KAAK,CAAC;AACjF,MAAM,QAAQ,GAAG,OAAO,CAAC;AAEzB,+EAA+E;AAC/E,SAAS;AACT,+EAA+E;AAE/E,sCAAsC;AACtC,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAEpD;;;;GAIG;AACH,6DAA6D;AAC7D,SAAS,UAAU,CAAC,IAAU;IAC5B,MAAM,KAAK,GAAG,IAAI,IAAI,CAAC,cAAc,CAAC,OAAO,EAAE;QAC7C,QAAQ,EAAE,eAAe;QACzB,IAAI,EAAE,SAAS;QACf,KAAK,EAAE,SAAS;QAChB,GAAG,EAAE,SAAS;KACf,CAAC,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,MAAM,CAAC,WAAW,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAClE,OAAO,QAAQ,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;AAC1E,CAAC;AAED;;;;GAIG;AACH,SAAS,YAAY,CAAC,EAAY;IAChC,OAAO,EAAE,CAAC,WAAW,EAAE,CAAC,aAAa,EAAE,CAAC,OAAO,EAAE,CAAC;AACpD,CAAC;AAED;;;;;GAKG;AACH,SAAS,SAAS,CAAC,KAAe,EAAE,SAAiB;IACnD,IAAI,GAAG,GAAG,KAAK,CAAC;IAChB,+BAA+B;IAC/B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,MAAM,EAAE,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC;QAC7B,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC;QACzD,GAAG,GAAG,SAAS,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;GAKG;AACH,SAAS,OAAO,CAAC,IAAc,EAAE,EAAY;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,EAAE,CAAC,YAAY,EAAE,CAAC,GAAG,MAAM,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC;AAC7E,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAAC,QAI7B;IAMC,gBAAgB;IAChB,IAAI,QAAQ,CAAC,KAAK,EAAE,CAAC;QACnB,MAAM,KAAK,GAAG,QAAQ,CAAC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;QAE9F,WAAW;QACX,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CACb,QAAQ,QAAQ,CAAC,KAAK,CAAC,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,KAAK,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,UAAU,CACpF,CAAC;QACJ,CAAC;QACD,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAmC,CAAC,CAAC;QAChE,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC;QAC/C,CAAC;QACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC;QAEnC,oBAAoB;QACpB,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,EAAE,CAAC;QAEpC,qCAAqC;QACrC,wBAAwB;QACxB,kBAAkB;QAClB,MAAM,UAAU,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC;QAE1C,IAAI,SAAiB,CAAC;QAEtB,IAAI,UAAU,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YAClD,kBAAkB;YAClB,eAAe;YACf,sBAAsB;YACtB,yBAAyB;YACzB,yBAAyB;YACzB,MAAM,IAAI,GAAG,OAAO,CAAC,UAAU,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ;YACrD,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,GAAG,CAAC,CAAC,CAAC,CAAC;QAChD,CAAC;aAAM,CAAC;YACN,gBAAgB;YAChB,8BAA8B;YAC9B,cAAc;YACd,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;YAC/B,MAAM,SAAS,GAAG,QAAQ,CAAC,OAAO,EAAE,CAAC;YACrC,MAAM,QAAQ,GAAG,aAAa,CAAC,SAAuC,CAAC,CAAC;YACxE,IAAI,QAAQ,EAAE,CAAC;gBACb,OAAO;oBACL,SAAS,EAAE,QAAQ,CAAC,GAAG,KAAK,GAAG;oBAC/B,KAAK,EAAE,QAAQ,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,SAAS;oBAChC,IAAI,EAAE,IAAI;oBACV,KAAK,EAAE,SAAS;iBACjB,CAAC;YACJ,CAAC;YACD,wBAAwB;YACxB,SAAS,GAAG,CAAC,CAAC;QAChB,CAAC;QAED,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;QAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;QACjC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;IAC3C,CAAC;IAED,qCAAqC;IACrC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC;IACnC,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC;IAC7B,MAAM,IAAI,GAAG,aAAa,CAAC,KAAmC,CAAC,CAAC;IAChE,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,MAAM,IAAI,KAAK,CAAC,UAAU,KAAK,YAAY,CAAC,CAAC;IAC/C,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,KAAK,GAAG,CAAC;IACnC,MAAM,QAAQ,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC1C,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE,CAAC;QACpB,MAAM,IAAI,KAAK,CAAC,YAAY,SAAS,UAAU,CAAC,CAAC;IACnD,CAAC;IACD,MAAM,SAAS,GAAG,IAAI,CAAC,KAAK,CAAC,QAAQ,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,KAAK,GAAG,IAAI,CAAC,EAAE,CAAC,SAAS,CAAC,CAAC;IACjC,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC;AAC3C,CAAC;AAED,+EAA+E;AAC/E,cAAc;AACd,+EAA+E;AAE/E;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAO3D,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAErC,MAAM,MAAM,GAAG;QACb,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,KAAK;QACnB,YAAY,EAAE,KAAK;QACnB,WAAW,EAAE,KAAK;QAClB,WAAW,EAAE,EAAE;KAChB,CAAC;IAEF,eAAe;IACf,oBAAoB;IACpB,oBAAoB;IACpB,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,WAAW,IAAI,mBAAmB,CAAC;IAC5C,CAAC;IAED,eAAe;IACf,oBAAoB;IACpB,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACzD,IAAI,WAAW,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACrC,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,WAAW,IAAI,cAAc,CAAC;IACvC,CAAC;IAED,gBAAgB;IAChB,cAAc;IACd,kCAAkC;IAClC,kCAAkC;IAClC,wBAAwB;IACxB,MAAM,OAAO,GAAuD;QAClE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,aAAa;QAC5C,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;QACrC,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,EAAE,MAAM;KACtC,CAAC;IAEF,MAAM,QAAQ,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAClC,IAAI,QAAQ,IAAI,OAAO,KAAK,QAAQ,CAAC,MAAM,EAAE,CAAC;QAC5C,MAAM,CAAC,YAAY,GAAG,IAAI,CAAC;QAC3B,MAAM,CAAC,WAAW,IAAI,KAAK,OAAO,MAAM,OAAO,IAAI,QAAQ,CAAC,MAAM,KAAK,QAAQ,CAAC,MAAM,eAAe,CAAC;IACxG,CAAC;IAED,gBAAgB;IAChB,yBAAyB;IACzB,sCAAsC;IACtC,iBAAiB;IACjB,MAAM,cAAc,GAAG;QACrB,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;QACJ,IAAI;KACL,CAAC;IACF,IAAI,cAAc,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;QACxC,MAAM,CAAC,WAAW,GAAG,IAAI,CAAC;QAC1B,MAAM,CAAC,WAAW,IAAI,wBAAwB,CAAC;IACjD,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,UAAU,cAAc,CAAC,UAAkB;IAM/C,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IACrC,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAErC,MAAM,YAAY,GAAG,QAAQ,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,MAAM,YAAY,GAAG,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,CAAC;IAE5C,IAAI,YAAY,KAAK,CAAC,CAAC,IAAI,YAAY,KAAK,CAAC,CAAC,EAAE,CAAC;QAC/C,MAAM,IAAI,KAAK,CAAC,aAAa,UAAU,IAAI,CAAC,CAAC;IAC/C,CAAC;IAED,iCAAiC;IACjC,MAAM,eAAe,GAAG,CAAC,YAAY,GAAG,YAAY,GAAG,EAAE,CAAC,GAAG,EAAE,CAAC;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,eAAe,CAAC,CAAC;IAE1C,aAAa;IACb,MAAM,aAAa,GAAG,YAAY,CAAC,UAAuC,CAAC,CAAC;IAE5E,sBAAsB;IACtB,MAAM,KAAK,GAAG,WAAW,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;IAC7C,MAAM,MAAM,GAAG,aAAa,CAAC,aAA2C,CAAC,CAAC;IAE1E,cAAc;IACd,MAAM,iBAAiB,GAAG,0BAA0B,CAAC,UAAU,CAAC,CAAC;IAEjE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,iBAAiB,EAAE,CAAC;AAC1E,CAAC;AAED,+EAA+E;AAC/E,iBAAiB;AACjB,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,aAAa,CAAC,UAAkB;IAC9C,sBAAsB;IACtB,IAAI,CAAC,UAAU,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAChC,OAAO,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC9B,CAAC;IAED,cAAc;IACd,MAAM,SAAS,GAA2B;QACxC,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;QACP,EAAE,EAAE,GAAG;KACR,CAAC;IAEF,OAAO,SAAS,CAAC,UAAU,CAAC,IAAI,GAAG,CAAC;AACtC,CAAC"}

package/dist/divination/algorithms/qimen/helpers/layout.d.ts

@@ -0,0 +1,59 @@
+/**
+ * @file 转盘法（zhuanpan）排盘算法
+ * @description 实现时家奇门转盘法的完整九宫格排盘，包含地盘、天盘、人盘、神盘四层。
+ *
+ * ─── 古籍依据 ───
+ *
+ * 《烟波钓叟歌》：
+ *   "先观九宫分八卦，次详六甲与三奇。
+ *    直符直使从中起，顺逆推算莫差迟。"
+ *
+ * 《奇门遁甲秘籍大全》卷三"排盘诀"：
+ *   第一步 布地盘三奇六仪 —— "阳遁顺布六仪，逆布三奇；阴遁逆布六仪，顺布三奇"
+ *   第二步 定值符值使落宫 —— "旬首所值之星为值符，所值之门为值使"
+ *   第三步 排天盘九星 —— "星随符转，各归其所"（《遁甲演义》）
+ *   第四步 排人盘八门 —— "门随地转，宫中无门不入"
+ *   第五步 排神盘八神 —— "八神随遁顺逆，中宫无神位"（《遁甲演义》）
+ *
+ * 《易纬·乾凿度》：
+ *   太一九宫体系 —— "戴九履一，左三右七，二四为肩，六八为足，五居中央"
+ *   洛书轨迹 —— "一居坎、八居艮、三居震、四居巽、九居离、二居坤、七居兑、六居乾"
+ *
+ * 流派说明：
+ *   转盘法（zhuanpan）为时家奇门主流，天盘九星整体旋转、人盘八门沿洛书轨迹旋转、
+ *   神盘八神随值符飞布，与飞盘法区别在于九星不跳飞、门不单飞。
+ */
+import type { QimenJiuGongGe } from '../../../../types/divination';
+/**
+ * 奇门排盘方法
+ * - 'zhuanpan': 转盘法（默认），天盘九星、人盘八门整体旋转，神盘八神飞布
+ * - 'feipan': 飞盘法，天盘九星按洛书轨迹跳飞（暂未完整实现）
+ */
+export type QimenMethod = 'zhuanpan' | 'feipan';
+/**
+ * 排九宫格（转盘法）
+ *
+ * 按照《奇门遁甲秘籍大全》卷三"排盘诀"所述五大步骤，生成完整的九宫格数据。
+ * 每宫包含：宫位信息、地盘干、天盘星与干、人盘门、神盘神。
+ *
+ * @param isYangDun  是否为阳遁
+ * @param juShu      局数（1-9）
+ * @param zhiFu      值符星名（如 "天蓬"）
+ * @param zhiShi     值使门名（如 "休门"）
+ * @param ganzhi     时辰干支，如 { hour: "甲子" }
+ * @param method     排盘方法，默认 'zhuanpan'（转盘法）
+ *
+ * @returns 包含九宫完整排盘数据的数组，每宫含 tianPan / diPan / renPan / shenPan 四盘
+ *
+ * @throws 当找不到时干落宫或时支对应的地盘宫位时
+ *
+ * @example
+ * ```ts
+ * const jiuGong = arrangeJiuGongGe(true, 3, '天冲', '伤门', { hour: '乙丑' });
+ * console.log(jiuGong[0]); // { gong: 1, name: '坎一宫', tianPan: {...}, ... }
+ * ```
+ */
+export declare function arrangeJiuGongGe(isYangDun: boolean, juShu: number, zhiFu: string, zhiShi: string, ganzhi: {
+    hour: string;
+}, method?: QimenMethod): QimenJiuGongGe[];
+//# sourceMappingURL=layout.d.ts.map

package/dist/divination/algorithms/qimen/helpers/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/layout.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAIH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AAQnE;;;;GAIG;AACH,MAAM,MAAM,WAAW,GAAG,UAAU,GAAG,QAAQ,CAAC;AAIhD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,gBAAgB,CAC9B,SAAS,EAAE,OAAO,EAClB,KAAK,EAAE,MAAM,EACb,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAA;CAAE,EACxB,MAAM,GAAE,WAAwB,GAC/B,cAAc,EAAE,CA0OlB"}