mingyu-core 0.1.0

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

@@ -0,0 +1,149 @@
+/**
+ * @file 九星旺衰落宫评估（《烟波钓叟歌》九星落宫章）
+ * @description 评估九星在九宫格中各宫位的旺相休囚死状态。
+ *
+ * 九星各有本宫（原始宫位），落宫不同则旺衰有别：
+ * - 本宫：星归原位 → 旺（力量最强）
+ * - 比和：星与宫同五行（非本宫） → 相（同气得助）
+ * - 旺地（同气）：宫生星 → 相（得生助）
+ * - 生地（受生）：星生宫 → 休（泄气耗力）
+ * - 囚地（受耗）：星克宫 → 囚（耗力受困）
+ * - 受克（受制）：宫克星 → 死（受制最弱）
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「九星各有本宫，旺相休囚死，落宫不同力量不同」
+ *   - 《奇门遁甲秘籍大全》：「九星飞宫，各以其五行与本宫五行参看旺衰」
+ *
+ * 九星原宫（宫位 1-9）：
+ *   坎 1 → 天蓬, 坤 2 → 天芮, 震 3 → 天冲, 巽 4 → 天辅,
+ *   中 5 → 天禽（寄坤 2）, 乾 6 → 天心, 兑 7 → 天柱,
+ *   艮 8 → 天任, 离 9 → 天英
+ *
+ * 九星五行：
+ *   天蓬水, 天芮土, 天冲木, 天辅木, 天禽土,
+ *   天心金, 天柱金, 天任土, 天英火
+ */
+/**
+ * 九星 → 原宫（本宫）映射表
+ *
+ * 《烟波钓叟歌》载九星各有所属之宫：
+ *   天蓬星在坎一，天芮星在坤二，天冲星在震三，天辅星在巽四，
+ *   天禽星在中五（寄坤二），天心星在乾六，天柱星在兑七，
+ *   天任星在艮八，天英星在离九。
+ *
+ * 星归本宫则旺，落他宫则衰。
+ */
+export declare const STAR_ORIGINAL_PALACES: Record<string, number>;
+/** 九星旺衰五态 */
+export type StarState = '旺' | '相' | '休' | '囚' | '死';
+/**
+ * 九星宫位评估结果
+ */
+export interface StarPalaceResult {
+    /** 星名，如 "天蓬" */
+    star: string;
+    /** 原宫序号（1-9） */
+    originalPalace: number;
+    /** 当前落宫序号（1-9） */
+    gong: number;
+    /** 旺衰状态 */
+    state: StarState;
+    /**
+     * 评分：
+     *   旺 = 3  （本宫，最强）
+     *   相 = 2  （得生助或同气）
+     *   休 = 0  （泄气，能量输出）
+     *   囚 = -1 （克宫耗力）
+     *   死 = -2 （受制最弱）
+     */
+    score: number;
+    /** 详细描述 */
+    detail: string;
+    /** 值符星特殊判断（仅值符星有此字段） */
+    specialJudgement?: string;
+}
+/** evaluateStarPalaces 输入参数 */
+export interface StarPalaceInput {
+    /** 九宫格数据，每宫须含 gong、element、tianPan.star */
+    jiuGongGe: Array<{
+        gong: number;
+        element: string;
+        tianPan: {
+            star: string;
+        };
+    }>;
+}
+/** getZhiFuStarJudgement 输入参数 */
+export interface ZhiFuJudgementInput extends StarPalaceInput {
+    /** 值符星名（如 "天蓬"） */
+    zhiFu: string;
+}
+/**
+ * 评估单个九星在宫位中的旺衰状态
+ *
+ * 判断逻辑（按优先级）：
+ *   1. 本宫（同宫）           → 旺（score: 3）
+ *   2. 比和（同五行，非本宫）   → 相（score: 2）
+ *   3. 宫生星（旺地）          → 相（score: 2）
+ *   4. 星生宫（生地）          → 休（score: 0）
+ *   5. 星克宫（囚地）          → 囚（score: -1）
+ *   6. 宫克星（受克）          → 死（score: -2）
+ *
+ * 比和（五行相同）在传统奇门中属同气得助，故归为"相"。
+ * 本宫则固有"旺"，不受五行规则约束。
+ *
+ * @param star            星名（如 "天蓬"）
+ * @param currentGong     当前落宫序号（1-9）
+ * @param palaceElement   宫位五行（木/火/土/金/水）
+ * @returns 评估结果
+ */
+export declare function evaluateSingleStar(star: string, currentGong: number, palaceElement: string): StarPalaceResult;
+/**
+ * 评估整盘中所有九星的旺衰状态
+ *
+ * 遍历九宫格中每个有星的宫位，计算各星的旺相休囚死状态。
+ * 中五宫如果有星也会参与评估。
+ *
+ * @param result - 含 jiuGongGe 的输入对象
+ * @param result.jiuGongGe - 九宫格数据，每宫含 gong、element、tianPan.star
+ * @returns 每颗星的旺衰评估结果数组
+ *
+ * @example
+ * ```ts
+ * const starResults = evaluateStarPalaces({ jiuGongGe: qimenResult.jiuGongGe });
+ * // 结果示例：
+ * // [
+ * //   { star: '天蓬', originalPalace: 1, gong: 6, state: '相', score: 2, detail: '天蓬落6宫（相）' },
+ * //   { star: '天芮', originalPalace: 2, gong: 2, state: '旺', score: 3, detail: '天芮落2宫（旺）' },
+ * // ]
+ * ```
+ */
+export declare function evaluateStarPalaces(result: StarPalaceInput): StarPalaceResult[];
+/**
+ * 值符星的特殊旺衰判断
+ *
+ * 值符星为九星之首，统摄全局。其旺衰状态对整体局势有放大效应：
+ *   - 旺/相 → 吉事加倍，凶事有救（加持）
+ *   - 休     → 值符能量中性，按常理断
+ *   - 囚     → 值符受困，吉事减力，凶事易发
+ *   - 死     → 值符失位，大势不利，宜守不宜攻
+ *
+ * 先计算值符星在其落宫的标准旺衰状态，再附加特殊解读。
+ *
+ * @param result - 含 jiuGongGe 和 zhiFu 的输入对象
+ * @param result.jiuGongGe - 九宫格数据
+ * @param result.zhiFu - 值符星名（如 "天蓬"）
+ * @returns 值符星的评估结果，含 specialJudgement 字段；
+ *          若找不到值符星落宫则返回 null
+ *
+ * @example
+ * ```ts
+ * const judgement = getZhiFuStarJudgement({
+ *   jiuGongGe: qimenResult.jiuGongGe,
+ *   zhiFu: qimenResult.zhiFu,
+ * });
+ * // => { star: '天蓬', gong: 6, state: '相', score: 2, specialJudgement: '值符得助，吉事加持' }
+ * ```
+ */
+export declare function getZhiFuStarJudgement(result: ZhiFuJudgementInput): StarPalaceResult | null;
+//# sourceMappingURL=star-palace.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"star-palace.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/star-palace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AASH;;;;;;;;;GASG;AACH,eAAO,MAAM,qBAAqB,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAUxD,CAAC;AAMF,aAAa;AACb,MAAM,MAAM,SAAS,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;AAEpD;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,gBAAgB;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,gBAAgB;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,KAAK,EAAE,SAAS,CAAC;IACjB;;;;;;;OAOG;IACH,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,MAAM,EAAE,MAAM,CAAC;IACf,wBAAwB;IACxB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,+BAA+B;AAC/B,MAAM,WAAW,eAAe;IAC9B,2CAA2C;IAC3C,SAAS,EAAE,KAAK,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,OAAO,EAAE,MAAM,CAAC;QAChB,OAAO,EAAE;YAAE,IAAI,EAAE,MAAM,CAAA;SAAE,CAAC;KAC3B,CAAC,CAAC;CACJ;AAED,iCAAiC;AACjC,MAAM,WAAW,mBAAoB,SAAQ,eAAe;IAC1D,mBAAmB;IACnB,KAAK,EAAE,MAAM,CAAC;CACf;AAMD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,MAAM,EACZ,WAAW,EAAE,MAAM,EACnB,aAAa,EAAE,MAAM,GACpB,gBAAgB,CAmDlB;AAMD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,eAAe,GAAG,gBAAgB,EAAE,CAU/E;AAMD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,mBAAmB,GAAG,gBAAgB,GAAG,IAAI,CAmC1F"}

package/dist/divination/algorithms/qimen/helpers/star-palace.js

@@ -0,0 +1,216 @@
+/**
+ * @file 九星旺衰落宫评估（《烟波钓叟歌》九星落宫章）
+ * @description 评估九星在九宫格中各宫位的旺相休囚死状态。
+ *
+ * 九星各有本宫（原始宫位），落宫不同则旺衰有别：
+ * - 本宫：星归原位 → 旺（力量最强）
+ * - 比和：星与宫同五行（非本宫） → 相（同气得助）
+ * - 旺地（同气）：宫生星 → 相（得生助）
+ * - 生地（受生）：星生宫 → 休（泄气耗力）
+ * - 囚地（受耗）：星克宫 → 囚（耗力受困）
+ * - 受克（受制）：宫克星 → 死（受制最弱）
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「九星各有本宫，旺相休囚死，落宫不同力量不同」
+ *   - 《奇门遁甲秘籍大全》：「九星飞宫，各以其五行与本宫五行参看旺衰」
+ *
+ * 九星原宫（宫位 1-9）：
+ *   坎 1 → 天蓬, 坤 2 → 天芮, 震 3 → 天冲, 巽 4 → 天辅,
+ *   中 5 → 天禽（寄坤 2）, 乾 6 → 天心, 兑 7 → 天柱,
+ *   艮 8 → 天任, 离 9 → 天英
+ *
+ * 九星五行：
+ *   天蓬水, 天芮土, 天冲木, 天辅木, 天禽土,
+ *   天心金, 天柱金, 天任土, 天英火
+ */
+import { starElements } from './_constants';
+import { isGenerating, isControlling } from './_constants';
+// ============================================================================
+// 1. 九星原宫映射
+// ============================================================================
+/**
+ * 九星 → 原宫（本宫）映射表
+ *
+ * 《烟波钓叟歌》载九星各有所属之宫：
+ *   天蓬星在坎一，天芮星在坤二，天冲星在震三，天辅星在巽四，
+ *   天禽星在中五（寄坤二），天心星在乾六，天柱星在兑七，
+ *   天任星在艮八，天英星在离九。
+ *
+ * 星归本宫则旺，落他宫则衰。
+ */
+export const STAR_ORIGINAL_PALACES = {
+    天蓬: 1,
+    天芮: 2,
+    天冲: 3,
+    天辅: 4,
+    天禽: 5,
+    天心: 6,
+    天柱: 7,
+    天任: 8,
+    天英: 9,
+};
+// ============================================================================
+// 3. 核心函数：evaluateSingleStar
+// ============================================================================
+/**
+ * 评估单个九星在宫位中的旺衰状态
+ *
+ * 判断逻辑（按优先级）：
+ *   1. 本宫（同宫）           → 旺（score: 3）
+ *   2. 比和（同五行，非本宫）   → 相（score: 2）
+ *   3. 宫生星（旺地）          → 相（score: 2）
+ *   4. 星生宫（生地）          → 休（score: 0）
+ *   5. 星克宫（囚地）          → 囚（score: -1）
+ *   6. 宫克星（受克）          → 死（score: -2）
+ *
+ * 比和（五行相同）在传统奇门中属同气得助，故归为"相"。
+ * 本宫则固有"旺"，不受五行规则约束。
+ *
+ * @param star            星名（如 "天蓬"）
+ * @param currentGong     当前落宫序号（1-9）
+ * @param palaceElement   宫位五行（木/火/土/金/水）
+ * @returns 评估结果
+ */
+export function evaluateSingleStar(star, currentGong, palaceElement) {
+    const starWuxing = starElements[star];
+    const originalPalace = STAR_ORIGINAL_PALACES[star] ?? 0;
+    if (!starWuxing) {
+        return {
+            star,
+            originalPalace,
+            gong: currentGong,
+            state: '休',
+            score: 0,
+            detail: `${star}五行未知，落${currentGong}宫（休）`,
+        };
+    }
+    let state;
+    let score;
+    // 1. 本宫 → 旺
+    if (currentGong === originalPalace) {
+        state = '旺';
+        score = 3;
+    }
+    // 2. 比和：星与宫同五行（非本宫）→ 相
+    else if (starWuxing === palaceElement) {
+        state = '相';
+        score = 2;
+    }
+    // 3. 宫生星 → 相
+    else if (isGenerating(palaceElement, starWuxing)) {
+        state = '相';
+        score = 2;
+    }
+    // 4. 星生宫 → 休
+    else if (isGenerating(starWuxing, palaceElement)) {
+        state = '休';
+        score = 0;
+    }
+    // 5. 星克宫 → 囚
+    else if (isControlling(starWuxing, palaceElement)) {
+        state = '囚';
+        score = -1;
+    }
+    // 6. 宫克星 → 死（五行循环的剩余组合只有此情况）
+    else {
+        state = '死';
+        score = -2;
+    }
+    const detail = `${star}落${currentGong}宫（${state}）`;
+    return { star, originalPalace, gong: currentGong, state, score, detail };
+}
+// ============================================================================
+// 4. evaluateStarPalaces：整盘九星旺衰评估
+// ============================================================================
+/**
+ * 评估整盘中所有九星的旺衰状态
+ *
+ * 遍历九宫格中每个有星的宫位，计算各星的旺相休囚死状态。
+ * 中五宫如果有星也会参与评估。
+ *
+ * @param result - 含 jiuGongGe 的输入对象
+ * @param result.jiuGongGe - 九宫格数据，每宫含 gong、element、tianPan.star
+ * @returns 每颗星的旺衰评估结果数组
+ *
+ * @example
+ * ```ts
+ * const starResults = evaluateStarPalaces({ jiuGongGe: qimenResult.jiuGongGe });
+ * // 结果示例：
+ * // [
+ * //   { star: '天蓬', originalPalace: 1, gong: 6, state: '相', score: 2, detail: '天蓬落6宫（相）' },
+ * //   { star: '天芮', originalPalace: 2, gong: 2, state: '旺', score: 3, detail: '天芮落2宫（旺）' },
+ * // ]
+ * ```
+ */
+export function evaluateStarPalaces(result) {
+    const results = [];
+    for (const palace of result.jiuGongGe) {
+        if (!palace.tianPan.star)
+            continue;
+        results.push(evaluateSingleStar(palace.tianPan.star, palace.gong, palace.element));
+    }
+    return results;
+}
+// ============================================================================
+// 5. getZhiFuStarJudgement：值符星特殊判断
+// ============================================================================
+/**
+ * 值符星的特殊旺衰判断
+ *
+ * 值符星为九星之首，统摄全局。其旺衰状态对整体局势有放大效应：
+ *   - 旺/相 → 吉事加倍，凶事有救（加持）
+ *   - 休     → 值符能量中性，按常理断
+ *   - 囚     → 值符受困，吉事减力，凶事易发
+ *   - 死     → 值符失位，大势不利，宜守不宜攻
+ *
+ * 先计算值符星在其落宫的标准旺衰状态，再附加特殊解读。
+ *
+ * @param result - 含 jiuGongGe 和 zhiFu 的输入对象
+ * @param result.jiuGongGe - 九宫格数据
+ * @param result.zhiFu - 值符星名（如 "天蓬"）
+ * @returns 值符星的评估结果，含 specialJudgement 字段；
+ *          若找不到值符星落宫则返回 null
+ *
+ * @example
+ * ```ts
+ * const judgement = getZhiFuStarJudgement({
+ *   jiuGongGe: qimenResult.jiuGongGe,
+ *   zhiFu: qimenResult.zhiFu,
+ * });
+ * // => { star: '天蓬', gong: 6, state: '相', score: 2, specialJudgement: '值符得助，吉事加持' }
+ * ```
+ */
+export function getZhiFuStarJudgement(result) {
+    const { jiuGongGe, zhiFu } = result;
+    if (!zhiFu)
+        return null;
+    // 找到值符星的落宫
+    const palace = jiuGongGe.find((g) => g.tianPan.star === zhiFu);
+    if (!palace)
+        return null;
+    // 计算标准旺衰
+    const baseResult = evaluateSingleStar(zhiFu, palace.gong, palace.element);
+    // 附加特殊解读
+    let specialJudgement;
+    switch (baseResult.state) {
+        case '旺':
+            specialJudgement = '值符归位，势在我方，百事可为';
+            break;
+        case '相':
+            specialJudgement = '值符得助，吉事加持，凶中有救';
+            break;
+        case '休':
+            specialJudgement = '值符泄气，宜守不宜攻，待时而动';
+            break;
+        case '囚':
+            specialJudgement = '值符受困，事倍功半，谨防反复';
+            break;
+        case '死':
+            specialJudgement = '值符失位，大势不利，隐忍为上';
+            break;
+        default:
+            specialJudgement = '值符状态不明，审慎行事';
+    }
+    return { ...baseResult, specialJudgement };
+}
+//# sourceMappingURL=star-palace.js.map

package/dist/divination/algorithms/qimen/helpers/star-palace.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"star-palace.js","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/star-palace.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAE3D,+EAA+E;AAC/E,YAAY;AACZ,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAA2B;IAC3D,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;IACL,EAAE,EAAE,CAAC;CACN,CAAC;AAoDF,+EAA+E;AAC/E,6BAA6B;AAC7B,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,kBAAkB,CAChC,IAAY,EACZ,WAAmB,EACnB,aAAqB;IAErB,MAAM,UAAU,GAAG,YAAY,CAAC,IAAI,CAAC,CAAC;IACtC,MAAM,cAAc,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAExD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO;YACL,IAAI;YACJ,cAAc;YACd,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,GAAG;YACV,KAAK,EAAE,CAAC;YACR,MAAM,EAAE,GAAG,IAAI,SAAS,WAAW,MAAM;SAC1C,CAAC;IACJ,CAAC;IAED,IAAI,KAAgB,CAAC;IACrB,IAAI,KAAa,CAAC;IAElB,YAAY;IACZ,IAAI,WAAW,KAAK,cAAc,EAAE,CAAC;QACnC,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,uBAAuB;SAClB,IAAI,UAAU,KAAK,aAAa,EAAE,CAAC;QACtC,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,aAAa;SACR,IAAI,YAAY,CAAC,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC;QACjD,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,aAAa;SACR,IAAI,YAAY,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC;QACjD,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,GAAG,CAAC,CAAC;IACZ,CAAC;IACD,aAAa;SACR,IAAI,aAAa,CAAC,UAAU,EAAE,aAAa,CAAC,EAAE,CAAC;QAClD,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,GAAG,CAAC,CAAC,CAAC;IACb,CAAC;IACD,6BAA6B;SACxB,CAAC;QACJ,KAAK,GAAG,GAAG,CAAC;QACZ,KAAK,GAAG,CAAC,CAAC,CAAC;IACb,CAAC;IAED,MAAM,MAAM,GAAG,GAAG,IAAI,IAAI,WAAW,KAAK,KAAK,GAAG,CAAC;IACnD,OAAO,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,WAAW,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AAC3E,CAAC;AAED,+EAA+E;AAC/E,kCAAkC;AAClC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,mBAAmB,CAAC,MAAuB;IACzD,MAAM,OAAO,GAAuB,EAAE,CAAC;IAEvC,KAAK,MAAM,MAAM,IAAI,MAAM,CAAC,SAAS,EAAE,CAAC;QACtC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI;YAAE,SAAS;QAEnC,OAAO,CAAC,IAAI,CAAC,kBAAkB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;IACrF,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+EAA+E;AAC/E,mCAAmC;AACnC,+EAA+E;AAE/E;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAA2B;IAC/D,MAAM,EAAE,SAAS,EAAE,KAAK,EAAE,GAAG,MAAM,CAAC;IAEpC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IAExB,WAAW;IACX,MAAM,MAAM,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC;IAC/D,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAEzB,SAAS;IACT,MAAM,UAAU,GAAG,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC;IAE1E,SAAS;IACT,IAAI,gBAAwB,CAAC;IAC7B,QAAQ,UAAU,CAAC,KAAK,EAAE,CAAC;QACzB,KAAK,GAAG;YACN,gBAAgB,GAAG,gBAAgB,CAAC;YACpC,MAAM;QACR,KAAK,GAAG;YACN,gBAAgB,GAAG,gBAAgB,CAAC;YACpC,MAAM;QACR,KAAK,GAAG;YACN,gBAAgB,GAAG,iBAAiB,CAAC;YACrC,MAAM;QACR,KAAK,GAAG;YACN,gBAAgB,GAAG,gBAAgB,CAAC;YACpC,MAAM;QACR,KAAK,GAAG;YACN,gBAAgB,GAAG,gBAAgB,CAAC;YACpC,MAAM;QACR;YACE,gBAAgB,GAAG,aAAa,CAAC;IACrC,CAAC;IAED,OAAO,EAAE,GAAG,UAAU,EAAE,gBAAgB,EAAE,CAAC;AAC7C,CAAC"}

package/dist/divination/algorithms/qimen/helpers/stem-pair-patterns.d.ts

@@ -0,0 +1,75 @@
+/**
+ * @file 天盘干与地盘干组合格局表（81局）
+ * @description 奇门遁甲81种天盘干+地盘干组合的传统格局判定，
+ * 包含吉格、凶格和一般五行生克关系。
+ *
+ * 奇门中甲始终遁藏，故天盘与地盘各取九干：乙丙丁戊己庚辛壬癸，
+ * 两两配对共 9 x 9 = 81 种组合。
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「三奇六仪分吉凶，天盘地盘合参用」
+ *   - 《奇门遁甲秘籍大全·十干吉凶章》：「十干相配各有格局，
+ *     或名青龙返首，或名飞鸟跌穴，吉凶各有所主」
+ *   - 《遁甲演义》：「三奇入雾、五凶格、天网地网，皆十干之变也」
+ *   - 《太白阴经》：「天乙青龙、朱雀、白虎、玄武、螣蛇，各有本象」
+ *
+ * 判断思路：
+ *   1. 优先匹配传统命名格局（如青龙返首、白虎猖狂等）；
+ *   2. 无命名格局则按天盘地盘五行生克自动判定：
+ *      - 天盘克地盘 → 冲（凶，-2）
+ *      - 地盘克天盘 → 受阻（凶，-1）
+ *      - 天盘生地盘 → 泄（凶，-1）
+ *      - 地盘生天盘 → 生（吉，+1）
+ *      - 五行相同 → 比和（平，0）
+ */
+export interface StemPairPattern {
+    /** 传统格局名称 */
+    name: string;
+    /** 吉凶类型 */
+    type: 'good' | 'bad' | 'neutral';
+    /** 评分 -10 ~ +10（负数越凶、正数越吉） */
+    score: number;
+    /** 传统描述 */
+    summary: string;
+    /** 现代解读 */
+    interpretation: string;
+    /** 现实表现 */
+    manifestation: string;
+}
+/**
+ * 获取天盘干与地盘干的组合格局
+ *
+ * 在奇门遁甲中，天盘干随九星飞转至某宫，与该宫地盘干形成特定的生克关系。
+ * 部分组合有传统的命名格局（如青龙返首、白虎猖狂等），
+ * 其余按五行生克关系自动判定。
+ *
+ * @param heavenStem 天盘干（乙/丙/丁/戊/己/庚/辛/壬/癸）
+ * @param earthStem  地盘干（乙/丙/丁/戊/己/庚/辛/壬/癸）
+ * @returns 格局对象，若参数不合法则返回 null
+ *
+ * @example
+ * ```ts
+ * getStemPairPattern('戊', '丙');
+ * // { name: '青龙返首', type: 'good', score: 8, ... }
+ *
+ * getStemPairPattern('乙', '辛');
+ * // { name: '青龙逃走', type: 'bad', score: -8, ... }
+ *
+ * getStemPairPattern('乙', '乙');
+ * // { name: '比和', type: 'neutral', score: 0, ... }
+ * ```
+ */
+export declare function getStemPairPattern(heavenStem: string, earthStem: string): StemPairPattern | null;
+/**
+ * 获取所有81种天盘干与地盘干组合的格局列表
+ *
+ * @returns 全部81种格局对象数组（按天盘干分组排列）
+ *
+ * @example
+ * ```ts
+ * const allPairs = listAllStemPairs();
+ * console.log(allPairs.length); // 81
+ * ```
+ */
+export declare function listAllStemPairs(): StemPairPattern[];
+//# sourceMappingURL=stem-pair-patterns.d.ts.map

package/dist/divination/algorithms/qimen/helpers/stem-pair-patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stem-pair-patterns.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/stem-pair-patterns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAQH,MAAM,WAAW,eAAe;IAC9B,aAAa;IACb,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,IAAI,EAAE,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;IACjC,8BAA8B;IAC9B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW;IACX,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,cAAc,EAAE,MAAM,CAAC;IACvB,WAAW;IACX,aAAa,EAAE,MAAM,CAAC;CACvB;AA2cD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,eAAe,GAAG,IAAI,CAehG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,IAAI,eAAe,EAAE,CAcpD"}