mingyu-core 0.1.0

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

@@ -0,0 +1,260 @@
+/**
+ * @file 转盘法（zhuanpan）排盘算法
+ * @description 实现时家奇门转盘法的完整九宫格排盘，包含地盘、天盘、人盘、神盘四层。
+ *
+ * ─── 古籍依据 ───
+ *
+ * 《烟波钓叟歌》：
+ *   "先观九宫分八卦，次详六甲与三奇。
+ *    直符直使从中起，顺逆推算莫差迟。"
+ *
+ * 《奇门遁甲秘籍大全》卷三"排盘诀"：
+ *   第一步 布地盘三奇六仪 —— "阳遁顺布六仪，逆布三奇；阴遁逆布六仪，顺布三奇"
+ *   第二步 定值符值使落宫 —— "旬首所值之星为值符，所值之门为值使"
+ *   第三步 排天盘九星 —— "星随符转，各归其所"（《遁甲演义》）
+ *   第四步 排人盘八门 —— "门随地转，宫中无门不入"
+ *   第五步 排神盘八神 —— "八神随遁顺逆，中宫无神位"（《遁甲演义》）
+ *
+ * 《易纬·乾凿度》：
+ *   太一九宫体系 —— "戴九履一，左三右七，二四为肩，六八为足，五居中央"
+ *   洛书轨迹 —— "一居坎、八居艮、三居震、四居巽、九居离、二居坤、七居兑、六居乾"
+ *
+ * 流派说明：
+ *   转盘法（zhuanpan）为时家奇门主流，天盘九星整体旋转、人盘八门沿洛书轨迹旋转、
+ *   神盘八神随值符飞布，与飞盘法区别在于九星不跳飞、门不单飞。
+ */
+import { qimen } from '../../../../divination/divination-data';
+import { getDunJiaStem } from './palace-utils';
+// ─── 数据源 ───
+const { diPanPalaces, palaceStars, palaceDoors, yangGods, yinGods, ninePositions } = qimen;
+// ─── 排盘主函数 ───
+/**
+ * 排九宫格（转盘法）
+ *
+ * 按照《奇门遁甲秘籍大全》卷三"排盘诀"所述五大步骤，生成完整的九宫格数据。
+ * 每宫包含：宫位信息、地盘干、天盘星与干、人盘门、神盘神。
+ *
+ * @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 function arrangeJiuGongGe(isYangDun, juShu, zhiFu, zhiShi, ganzhi, method = 'zhuanpan') {
+    // ──────────────────────────────────────────────
+    // 第一步：初始化九宫
+    // ──────────────────────────────────────────────
+    // 创建 9 个宫位，四盘（天/地/人/神）全部重置为空
+    const jiuGong = Array.from({ length: 9 }, (_, i) => ({
+        gong: i + 1,
+        name: ninePositions[i].name,
+        direction: ninePositions[i].direction,
+        element: ninePositions[i].element,
+        tianPan: { star: '', stem: '' },
+        diPan: { stem: '' },
+        renPan: { door: '' },
+        shenPan: { god: '' },
+    }));
+    // ──────────────────────────────────────────────
+    // 第二步：布地盘三奇六仪（DiPan）
+    // ──────────────────────────────────────────────
+    //
+    // 法理（《烟波钓叟歌》）：
+    //   "六甲元号六仪名，三奇即是乙丙丁。
+    //    阳遁顺仪奇逆布，阴遁逆仪奇顺行。"
+    //
+    // 固定顺序：戊 → 己 → 庚 → 辛 → 壬 → 癸 → 丁 → 丙 → 乙
+    // 阳遁：从局数宫位起，顺九宫序布列
+    // 阴遁：从局数宫位起，逆九宫序布列
+    // 戊土居中五宫，中五无专位，寄于坤二宫。
+    const sanQiLiuYi = ['戊', '己', '庚', '辛', '壬', '癸', '丁', '丙', '乙'];
+    let centerJiGongStem = ''; // 中五宫戊土寄宫记录
+    for (let i = 0; i < 9; i++) {
+        const palaceNum = isYangDun ? ((juShu + i - 1 + 9) % 9) + 1 : ((juShu - i - 1 + 9) % 9) + 1;
+        jiuGong[palaceNum - 1].diPan.stem = sanQiLiuYi[i];
+    }
+    // 戊土寄宫：中五宫戊土寄于坤二宫
+    // 中五宫有戊土时，将戊土寄至坤二，中五宫地盘不再布干
+    if (jiuGong[4].diPan.stem === '戊') {
+        centerJiGongStem = '戊';
+        jiuGong[4].diPan.stem = '';
+    }
+    // ──────────────────────────────────────────────
+    // 第三步：定值符与值使的落宫
+    // ──────────────────────────────────────────────
+    //
+    // 法理（《烟波钓叟歌》）：
+    //   "直符直使各有时，时干直符时支使。"
+    //
+    // 值符星追时干：找到时干的遁干在地盘中的落宫，值符星即落此宫。
+    // 值使门追时支：查找时支对应的地盘宫位，值使门即落此宫。
+    const hourZhi = ganzhi.hour.charAt(1);
+    const hourGanForFind = getDunJiaStem(ganzhi.hour); // 遁干（甲遁于六仪之下）
+    // ── 3a. 定值符落宫 ──
+    let zhiFuLandingPalace = -1;
+    for (let i = 0; i < 9; i++) {
+        if (jiuGong[i].diPan.stem === hourGanForFind) {
+            zhiFuLandingPalace = i + 1;
+            break;
+        }
+    }
+    // 若时干遁干为戊且戊寄于坤二宫，则在坤二宫查找
+    if (zhiFuLandingPalace === -1) {
+        if (centerJiGongStem && hourGanForFind === centerJiGongStem) {
+            zhiFuLandingPalace = 2; // 坤二宫
+        }
+    }
+    // 兜底：仍然找不到则报错
+    if (zhiFuLandingPalace === -1) {
+        throw new Error(`找不到时干 "${ganzhi.hour}" 遁干 "${hourGanForFind}" 在地盘的落宫，请检查地盘排布逻辑。`);
+    }
+    // ── 3b. 定值使落宫 ──
+    const zhiShiLandingPalace = diPanPalaces[hourZhi];
+    if (zhiShiLandingPalace === undefined) {
+        throw new Error(`找不到时支 "${hourZhi}" 对应的地盘宫位。`);
+    }
+    // ──────────────────────────────────────────────
+    // 第四步：排天盘九星与天干（TianPan）
+    // ──────────────────────────────────────────────
+    //
+    // 法理（《遁甲演义》）：
+    //   "星随符转，各归其所。"
+    //
+    // 值符星（大值符）为九星之首，从值符落宫开始排布。
+    // 阳遁顺九宫序（宫号递增）排布，阴遁逆九宫序排布。
+    // 天盘干 = 该星在地盘"老家"之天干，即"星带干飞"。
+    // 天禽星的中五宫原位无干时，取坤二宫的地盘干。
+    //
+    // 星的位置映射（老家）：
+    //   天蓬→坎一、天芮→坤二、天冲→震三、天辅→巽四、
+    //   天禽→中五、天心→乾六、天柱→兑七、天任→艮八、天英→离九
+    if (method === 'zhuanpan') {
+        // ── 转盘法：九星整体旋转 ──
+        // 值符星为"把手"，从值符落宫开始，按九宫序（阳顺阴逆）放置九星，
+        // 星序保持原固定位顺序（天蓬→天芮→天冲→...→天英）。
+        const zhiFuStarIndex = palaceStars.indexOf(zhiFu);
+        for (let i = 0; i < 9; i++) {
+            // 目标宫位：从值符落宫开始，阳遁顺排（+i），阴遁逆排（-i）
+            const palaceIndex = (zhiFuLandingPalace - 1 + (isYangDun ? i : -i) + 9) % 9;
+            // 星索引：从值符星开始，始终按星序递增（阳阴都是正序取星）
+            const starIndex = (zhiFuStarIndex + i + 9) % 9;
+            const star = palaceStars[starIndex];
+            jiuGong[palaceIndex].tianPan.star = star;
+            // ── 天盘干：星带干飞 ──
+            // 天盘干 = 该星在地盘老家之干
+            // 天禽星（原中五宫）特殊处理：
+            //   若中五宫戊土寄坤二宫，则天禽全盘携带戊土
+            //   若中五宫无干，则取坤二宫的地盘干
+            if (star === '天禽' && centerJiGongStem) {
+                jiuGong[palaceIndex].tianPan.stem = centerJiGongStem;
+                continue;
+            }
+            // 天禽星的中五宫原位无干时，取坤二宫（index 1）的地盘干
+            if (star === '天禽' && !jiuGong[4].diPan.stem) {
+                jiuGong[palaceIndex].tianPan.stem = jiuGong[1].diPan.stem;
+                continue;
+            }
+            // 一般情况：取该星在地盘原位之干
+            jiuGong[palaceIndex].tianPan.stem = jiuGong[starIndex].diPan.stem;
+        }
+    }
+    else {
+        // ── 飞盘法保留分支（暂未完整实现，仅保持接口兼容） ──
+        const zhiFuStarIndex = palaceStars.indexOf(zhiFu);
+        const luoShuPathForTian = [1, 8, 3, 4, 9, 2, 7, 6]; // 洛书轨迹
+        const zhiFuLuoShuIndex = luoShuPathForTian.indexOf(zhiFuLandingPalace);
+        for (let i = 0; i < 8; i++) {
+            const starIndex = (zhiFuStarIndex + i + 8) % 8;
+            const luoShuIndex = (zhiFuLuoShuIndex + (isYangDun ? i : -i) + 8) % 8;
+            const palaceNum = luoShuPathForTian[luoShuIndex];
+            const star = palaceStars[starIndex];
+            jiuGong[palaceNum - 1].tianPan.star = star;
+            if (star === '天禽' && centerJiGongStem) {
+                jiuGong[palaceNum - 1].tianPan.stem = centerJiGongStem;
+                continue;
+            }
+            if (star === '天禽' && !jiuGong[4].diPan.stem) {
+                jiuGong[palaceNum - 1].tianPan.stem = jiuGong[1].diPan.stem;
+                continue;
+            }
+            jiuGong[palaceNum - 1].tianPan.stem = jiuGong[starIndex].diPan.stem;
+        }
+    }
+    // ──────────────────────────────────────────────
+    // 第五步：排人盘八门（RenPan）
+    // ──────────────────────────────────────────────
+    //
+    // 法理（《烟波钓叟歌》）：
+    //   "直使常随时支转，八门逐位配宫行。"
+    //
+    // 值使门为八门之主，从值使落宫开始，按洛书轨迹排布八门。
+    // 洛书轨迹：1(坎) → 8(艮) → 3(震) → 4(巽) → 9(离) → 2(坤) → 7(兑) → 6(乾)
+    // 阳遁顺转（沿洛书轨迹正向），阴遁逆转（沿洛书轨迹反向）。
+    // 中五宫无门位，八门只布于八宫。
+    //
+    // 门序（对应洛书轨迹）：休门→生门→伤门→杜门→景门→死门→惊门→开门
+    const zhiShiDoorIndex = palaceDoors.indexOf(zhiShi);
+    const luoShuDoorPath = [1, 8, 3, 4, 9, 2, 7, 6]; // 洛书轨迹（八门走宫顺序）
+    const zhiShiLuoShuIndex = luoShuDoorPath.indexOf(zhiShiLandingPalace);
+    if (zhiShiDoorIndex === -1) {
+        throw new Error(`找不到值使门 "${zhiShi}"，请检查八门数据。`);
+    }
+    if (zhiShiLuoShuIndex === -1) {
+        throw new Error(`值使落宫 "${zhiShiLandingPalace}" 不在洛书轨迹八宫中。`);
+    }
+    for (let i = 0; i < 8; i++) {
+        // 目标宫位的洛书索引：从值使落宫开始，阳顺阴逆沿洛书轨迹
+        const targetLuoShuIndex = (zhiShiLuoShuIndex + (isYangDun ? i : -i) + 8) % 8;
+        const targetPalace = luoShuDoorPath[targetLuoShuIndex];
+        // 门索引：从值使门开始，始终按门序正序递增
+        const doorIndex = (zhiShiDoorIndex + i + 8) % 8;
+        jiuGong[targetPalace - 1].renPan.door = palaceDoors[doorIndex];
+    }
+    // ──────────────────────────────────────────────
+    // 第六步：排神盘八神（ShenPan）
+    // ──────────────────────────────────────────────
+    //
+    // 法理（《遁甲演义》）：
+    //   "八神随遁顺逆，中宫无神位。"
+    //
+    // 八神之首"值符神"（小值符）永远追随天盘值符星（大值符）。
+    // 值符神落于天盘值符星所在之宫，其余七神依次排布。
+    // 阳遁顺排（沿九宫序顺时针），阴遁逆排（沿九宫序逆时针）。
+    // 中五宫不排神，值符落中五时借坤二宫起布。
+    //
+    // 阳遁七神顺序：螣蛇 → 太阴 → 六合 → 白虎 → 玄武 → 九地 → 九天
+    // 阴遁七神顺序：九天 → 九地 → 玄武 → 白虎 → 六合 → 太阴 → 螣蛇
+    // 八神之首"值符"固定在前端，随遁变迁
+    const gods = isYangDun ? yangGods : yinGods;
+    // 收集排神宫的宫位（跳过中五宫，共 8 宫）
+    const shenPanPalaces = [];
+    for (let offset = 0; shenPanPalaces.length < 8; offset++) {
+        const palaceNum = ((zhiFuLandingPalace - 1 + (isYangDun ? offset : -offset) + 18) % 9) + 1;
+        if (palaceNum === 5) {
+            // 中五宫无神位，跳过
+            continue;
+        }
+        shenPanPalaces.push(palaceNum);
+    }
+    // 值符神数组依次放入排神宫位
+    for (let i = 0; i < 8; i++) {
+        const palaceNum = shenPanPalaces[i];
+        jiuGong[palaceNum - 1].shenPan.god = gods[i];
+    }
+    // ──────────────────────────────────────────────
+    // 返回九宫格完整数据
+    // ──────────────────────────────────────────────
+    return jiuGong;
+}
+//# sourceMappingURL=layout.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"layout.js","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/layout.ts"],"names":[],"mappings":"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"}

package/dist/divination/algorithms/qimen/helpers/palace-relations.d.ts

@@ -0,0 +1,135 @@
+/**
+ * @file 单宫门星神关系分析
+ * @description 分析一个宫位内八门、九星、八神之间的五行生克关系，
+ * 判断宫位内部的和谐程度，为宫位能量解读提供基础。
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「九星八门八神配五行，生克判吉凶」
+ *   - 《奇门遁甲秘籍大全·门星神合参章》：「门为事体，星为事主，神为事机。
+ *     三者相生则吉，比和则顺，相克则阻。」
+ *   - 《遁甲演义》：「凡门星神三者比和，此宫为吉；三者相克，此宫大凶；
+ *     凡生我者为恩，克我者为仇，我生者为泄，我克者为制。」
+ *
+ * 门星神三者的五行生克是判断宫位能量是否协调的核心：
+ *   - 比和（同五行）：相互支持，和谐稳定
+ *   - 相生（我生/生我）：有助力或宣泄，整体偏正
+ *   - 相克（我克/克我）：有压制或反抗，有矛盾张力
+ */
+import type { QimenJiuGongGe } from '../../../../types/divination';
+/**
+ * 获取八门的五行属性
+ *
+ * @param door 八门名称（如 "休门"、"生门"）
+ * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"），未知时返回空字符串
+ *
+ * @example
+ * ```ts
+ * getDoorElement('休门'); // '水'
+ * getDoorElement('景门'); // '火'
+ * ```
+ */
+export declare function getDoorElement(door: string): string;
+/**
+ * 获取九星的五行属性
+ *
+ * @param star 九星名称（如 "天蓬"、"天芮"）
+ * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"），未知时返回空字符串
+ *
+ * @example
+ * ```ts
+ * getStarElement('天蓬'); // '水'
+ * getStarElement('天英'); // '火'
+ * ```
+ */
+export declare function getStarElement(star: string): string;
+/**
+ * 获取八神的五行属性
+ *
+ * @param god 八神名称（如 "值符"、"螣蛇"）
+ * @returns 对应的五行（"水"、"火"、"木"、"金"、"土"），未知时返回空字符串
+ *
+ * @example
+ * ```ts
+ * getGodElement('值符'); // '土'
+ * getGodElement('螣蛇'); // '火'
+ * getGodElement('太阴'); // '金'
+ * ```
+ */
+export declare function getGodElement(god: string): string;
+/** 单对关系结果 */
+export interface PairRelation {
+    /** 第一个元素名称（门/星/神） */
+    first: string;
+    /** 第二个元素名称（门/星/神） */
+    second: string;
+    /** 第一个元素的五行 */
+    firstElement: string;
+    /** 第二个元素的五行 */
+    secondElement: string;
+    /** 关系类型：比和（同五行）、相生、相克 */
+    relation: '比和' | '相生' | '相克';
+    /** 关系的中文描述 */
+    description: string;
+}
+/** 宫位内所有关系的综合分析结果 */
+export interface PalaceRelationsResult {
+    /** 门与星的关系 */
+    doorStar: PairRelation;
+    /** 门与神的关系 */
+    doorGod: PairRelation;
+    /** 星与神的关系 */
+    starGod: PairRelation;
+    /** 整体和谐等级 */
+    harmony: '和谐' | '有拉扯' | '冲突';
+    /** 综合评分（-3 ~ +3，越高越和谐） */
+    score: number;
+    /** 整体关系的中文描述 */
+    description: string;
+}
+/**
+ * 分析单个宫位中门、星、神之间的两两五行关系
+ *
+ * 逐一计算门与星、门与神、星与神的五行生克，汇总得到宫位内部能量状态。
+ * 门星神三者的和谐程度决定了该宫位行事是否顺畅：
+ *   - 和谐：多数为相生或比和，能量协同，利于在该宫方位行事
+ *   - 有拉扯：生克参半，有助力也有阻力，需要具体分析矛盾项
+ *   - 冲突：多数为相克，矛盾突出，在该宫方位易生阻碍
+ *
+ * @param palace 宫位数据（须含 renPan.door、tianPan.star、shenPan.god）
+ * @returns 包含三对关系详情、综合等级和评分的结果对象
+ *
+ * @example
+ * ```ts
+ * const result = analyzePalaceRelations(jiuGongGe[0]);
+ * // {
+ * //   doorStar: { first: '休门', second: '天蓬', firstElement: '水', secondElement: '水', relation: '比和', description: '...' },
+ * //   harmony: '和谐',
+ * //   score: 3,
+ * //   description: '该宫门星神三者关系和谐，利于行事。'
+ * // }
+ * ```
+ */
+export declare function analyzePalaceRelations(palace: Pick<QimenJiuGongGe, 'renPan' | 'tianPan' | 'shenPan'>): PalaceRelationsResult;
+/**
+ * 获取宫位门星神三者的整体和谐评分
+ *
+ * 评分规则（-3 ~ +3，整数）：
+ *   门-星：比和 +1 | 相生 +1 | 相克 -1
+ *   门-神：比和 +1 | 相生 +1 | 相克 -1
+ *   星-神：比和 +1 | 相生 +1 | 相克 -1
+ *
+ * 分值含义：
+ *   +3 ~ +2：能量协同，吉顺
+ *   +1 ~ -1：有拉扯，需具体分析
+ *   -2 ~ -3：能量冲突，多阻碍
+ *
+ * @param palace 宫位数据（须含 renPan.door、tianPan.star、shenPan.god）
+ * @returns 和谐评分，-3（最冲突）到 +3（最和谐）
+ *
+ * @example
+ * ```ts
+ * const score = getPalaceHarmony(jiuGongGe[1]); // 返回 -1, 2, 等
+ * ```
+ */
+export declare function getPalaceHarmony(palace: Pick<QimenJiuGongGe, 'renPan' | 'tianPan' | 'shenPan'>): number;
+//# sourceMappingURL=palace-relations.d.ts.map

package/dist/divination/algorithms/qimen/helpers/palace-relations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"palace-relations.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/palace-relations.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,8BAA8B,CAAC;AA+BnE;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAEnD;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAMD,aAAa;AACb,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,KAAK,EAAE,MAAM,CAAC;IACd,qBAAqB;IACrB,MAAM,EAAE,MAAM,CAAC;IACf,eAAe;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,yBAAyB;IACzB,QAAQ,EAAE,IAAI,GAAG,IAAI,GAAG,IAAI,CAAC;IAC7B,cAAc;IACd,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,qBAAqB;AACrB,MAAM,WAAW,qBAAqB;IACpC,aAAa;IACb,QAAQ,EAAE,YAAY,CAAC;IACvB,aAAa;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa;IACb,OAAO,EAAE,YAAY,CAAC;IACtB,aAAa;IACb,OAAO,EAAE,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC;IAC7B,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AA6DD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,GAC7D,qBAAqB,CAiFvB;AA6CD;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,wBAAgB,gBAAgB,CAC9B,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,QAAQ,GAAG,SAAS,GAAG,SAAS,CAAC,GAC7D,MAAM,CAER"}