mingyu-core 0.1.0

package/dist/divination/algorithms/qimen/helpers/ying-qi.js

@@ -0,0 +1,291 @@
+/**
+ * @file 应期判断（《奇门遁甲大全》应期章、《奇门旨归》）
+ * @description 综合多种方法估算应期时间：
+ *   1. 用神落宫数 → 远近基线
+ *   2. 值符落宫数 → 辅助基线
+ *   3. 值使落宫数 → 辅助基线
+ *   4. 庚格定应期：阳日看庚下（地盘庚），阴日看庚上（天盘庚），地支逢冲为应
+ *   5. 马星加快、空亡填实/冲实、伏吟延迟、反吟加快
+ *   6. 吉格加快、凶格延迟
+ */
+import { palaceBranches } from './_constants';
+// ============================================================================
+// 常量
+// ============================================================================
+/** 六冲映射（地支六冲：子午、丑未、寅申、卯酉、辰戌、巳亥） */
+const sixChong = {
+    子: '午',
+    午: '子',
+    丑: '未',
+    未: '丑',
+    寅: '申',
+    申: '寅',
+    卯: '酉',
+    酉: '卯',
+    辰: '戌',
+    戌: '辰',
+    巳: '亥',
+    亥: '巳',
+};
+/** 阳干 */
+const YANG_STEMS = ['甲', '丙', '戊', '庚', '壬'];
+// ============================================================================
+// 核心函数
+// ============================================================================
+/**
+ * 估算应期
+ *
+ * @param jiuGongGe     - 九宫格数据（含天盘星干、地盘干）
+ * @param useShenPalace - 用神落宫（若无则回退至值符落宫）
+ * @param options       - 可选参数
+ * @returns 应期估算结果
+ *
+ * @example
+ * ```ts
+ * const result = estimateYingQi(jiuGongGe, 3, {
+ *   isFuyin: false,
+ *   isFanyin: true,
+ *   hasHorse: false,
+ *   hasVoid: true,
+ *   zhiFuLandingPalace: 1,
+ *   zhiShiLandingPalace: 8,
+ *   hourGanZhi: '甲子',
+ *   classicPatterns: [{ name: '青龙返首', score: 8 }],
+ *   voidBranches: ['寅', '卯'],
+ * });
+ * ```
+ */
+export function estimateYingQi(jiuGongGe, useShenPalace, options) {
+    const sources = [];
+    // ==========================================================================
+    // 1. 用神落宫数 → 远近基线
+    // ==========================================================================
+    // 内宫（1-3）：应速，1-15 日
+    // 中宫（4-6）：渐进，15-60 日
+    // 外宫（7-9）：迟应，60 日以上
+    const baseGong = useShenPalace || options?.zhiFuLandingPalace || 5;
+    let baseDays;
+    let rhythm;
+    if (baseGong <= 3) {
+        baseDays = 7;
+        rhythm = '快';
+        sources.push(`用神落${baseGong}宫（内宫速应），基线 1-15 日`);
+    }
+    else if (baseGong <= 6) {
+        baseDays = 30;
+        rhythm = '中';
+        sources.push(`用神落${baseGong}宫（中宫渐近），基线 15-60 日`);
+    }
+    else {
+        baseDays = 120;
+        rhythm = '慢';
+        sources.push(`用神落${baseGong}宫（外宫迟应），基线 60 日以上`);
+    }
+    // ==========================================================================
+    // 2. 值符落宫 → 辅助调整
+    // ==========================================================================
+    // 值符落内宫（1-3）→ 加快，落外宫（7-9）→ 减缓
+    if (options?.zhiFuLandingPalace) {
+        const fuGong = options.zhiFuLandingPalace;
+        if (fuGong <= 3) {
+            baseDays *= 0.85;
+            sources.push(`值符落${fuGong}宫（内宫），应期偏快`);
+        }
+        else if (fuGong >= 7) {
+            baseDays *= 1.15;
+            sources.push(`值符落${fuGong}宫（外宫），应期偏缓`);
+        }
+        else {
+            sources.push(`值符落${fuGong}宫（中宫），应期中平`);
+        }
+    }
+    // ==========================================================================
+    // 3. 值使落宫 → 辅助调整
+    // ==========================================================================
+    if (options?.zhiShiLandingPalace) {
+        const shiGong = options.zhiShiLandingPalace;
+        if (shiGong <= 3) {
+            baseDays *= 0.9;
+            sources.push(`值使落${shiGong}宫（内宫），应期略快`);
+        }
+        else if (shiGong >= 7) {
+            baseDays *= 1.1;
+            sources.push(`值使落${shiGong}宫（外宫），应期略迟`);
+        }
+    }
+    // ==========================================================================
+    // 4. 庚格定应期
+    // ==========================================================================
+    // 《奇门遁甲大全》庚格章：
+    //   阳日（甲丙戊庚壬）看庚下 → 地盘庚所在宫
+    //   阴日（乙丁己辛癸）看庚上 → 天盘庚所在宫
+    //   地支逢冲为应 → 庚所在宫的地支逢其六冲之日/月为应期
+    const ganZhi = options?.hourGanZhi || '';
+    if (ganZhi) {
+        const dayStem = ganZhi.charAt(0);
+        const isYangDay = YANG_STEMS.includes(dayStem);
+        // 遍历九宫查找庚的位置
+        for (const gong of jiuGongGe) {
+            if (gong.gong === 5)
+                continue; // 中五宫无明确地支定位
+            if (isYangDay && gong.diPan.stem === '庚') {
+                // 阳日：看庚下（地盘庚）
+                const gongNum = gong.gong;
+                const branches = palaceBranches[gongNum] || [];
+                const chongDesc = branches
+                    .map((b) => {
+                    const opp = sixChong[b];
+                    return opp ? `${b}冲${opp}` : b;
+                })
+                    .join('、');
+                sources.push(`阳日（${dayStem}日）见庚在地盘${gongNum}宫，` +
+                    `${chongDesc ? '逢' + chongDesc : '依宫数'}应`);
+                // 奇数宫（阳宫）以日/月计，偶数宫（阴宫）以月计
+                if (gongNum % 2 === 1) {
+                    sources.push(`庚落${gongNum}宫（阳宫），应期以日或月计`);
+                }
+                else {
+                    sources.push(`庚落${gongNum}宫（阴宫），应期以月计`);
+                }
+            }
+            else if (!isYangDay && gong.tianPan.stem === '庚') {
+                // 阴日：看庚上（天盘庚）
+                const gongNum = gong.gong;
+                const branches = palaceBranches[gongNum] || [];
+                const chongDesc = branches
+                    .map((b) => {
+                    const opp = sixChong[b];
+                    return opp ? `${b}冲${opp}` : b;
+                })
+                    .join('、');
+                sources.push(`阴日（${dayStem}日）见庚在天盘${gongNum}宫，` +
+                    `${chongDesc ? '逢' + chongDesc : '依宫数'}应`);
+                if (gongNum % 2 === 1) {
+                    sources.push(`庚落${gongNum}宫（阳宫），应期以日或月计`);
+                }
+                else {
+                    sources.push(`庚落${gongNum}宫（阴宫），应期以月计`);
+                }
+            }
+        }
+    }
+    // ==========================================================================
+    // 5. 伏吟延迟 / 反吟加快
+    // ==========================================================================
+    if (options?.isFuyin) {
+        baseDays *= 1.5;
+        rhythm = '慢';
+        sources.push('伏吟局，事势迟滞，应期延长约 50%');
+    }
+    if (options?.isFanyin) {
+        baseDays *= 0.7;
+        if (rhythm !== '快')
+            rhythm = '中';
+        sources.push('反吟局，事势反复，应期虽快但不稳定，需防变数');
+    }
+    // ==========================================================================
+    // 6. 马星加快
+    // ==========================================================================
+    if (options?.hasHorse) {
+        baseDays *= 0.7;
+        sources.push('驿马发动，应期加快约 30%');
+    }
+    // ==========================================================================
+    // 7. 空亡延迟 → 需填实 / 冲实
+    // ==========================================================================
+    if (options?.hasVoid) {
+        baseDays *= 1.3;
+        sources.push('空亡入局，需填实或冲实之月日方应，应期偏迟');
+        if (options?.voidBranches && options.voidBranches.length > 0) {
+            const voidDesc = options.voidBranches
+                .map((vb) => {
+                const chong = sixChong[vb];
+                return chong ? `${vb}（冲${chong}填实）` : vb;
+            })
+                .join('、');
+            sources.push(`空亡在${voidDesc}，待填实/冲实之月日应`);
+        }
+    }
+    // ==========================================================================
+    // 8. 经典格局调整
+    // ==========================================================================
+    // 吉格（score > 0）→ 加快 30%
+    // 凶格（score < 0）→ 延迟 50%
+    // 吉凶参半 → 保持中平
+    if (options?.classicPatterns && options.classicPatterns.length > 0) {
+        const goodCount = options.classicPatterns.filter((p) => p.score > 0).length;
+        const badCount = options.classicPatterns.filter((p) => p.score < 0).length;
+        if (goodCount > 0 && badCount === 0) {
+            baseDays *= 0.7;
+            sources.push(`吉格为主（${goodCount}吉），应期加快约 30%`);
+        }
+        else if (badCount > 0 && goodCount === 0) {
+            baseDays *= 1.5;
+            sources.push(`凶格为主（${badCount}凶），应期延迟约 50%`);
+        }
+        else if (goodCount > 0 && badCount > 0) {
+            sources.push(`吉凶参半（${goodCount}吉 ${badCount}凶），应期中平`);
+        }
+        // 高影响力格局单独说明
+        for (const pat of options.classicPatterns) {
+            if (Math.abs(pat.score) >= 8) {
+                if (pat.score > 0) {
+                    sources.push(`${pat.name}大吉格，应期显著加快`);
+                }
+                else {
+                    sources.push(`${pat.name}大凶格，应期显著延迟`);
+                }
+            }
+        }
+    }
+    // ==========================================================================
+    // 9. 最终计算
+    // ==========================================================================
+    // 限制到合理范围：至少 1 日，最多 360 日
+    baseDays = Math.max(1, Math.min(360, Math.round(baseDays)));
+    let minDays;
+    let maxDays;
+    if (rhythm === '快') {
+        // 快：1-15 日基线
+        minDays = Math.max(1, Math.round(baseDays * 0.5));
+        maxDays = Math.min(15, Math.round(baseDays * 1.5));
+    }
+    else if (rhythm === '中') {
+        // 中：15-60 日基线
+        minDays = Math.max(3, Math.round(baseDays * 0.6));
+        maxDays = Math.min(90, Math.round(baseDays * 1.5));
+    }
+    else {
+        // 慢：60 日以上基线
+        minDays = Math.max(15, Math.round(baseDays * 0.7));
+        maxDays = Math.min(360, Math.round(baseDays * 1.5));
+    }
+    // 确保合理
+    minDays = Math.max(1, Math.min(minDays, maxDays));
+    maxDays = Math.max(minDays, maxDays);
+    // ==========================================================================
+    // 10. 综合描述
+    // ==========================================================================
+    const parts = [`应期约 ${minDays}-${maxDays} 日（${rhythm}）。`];
+    if (options?.hasHorse) {
+        parts.push('马星冲动，应期较快，宜主动把握时机。');
+    }
+    if (options?.hasVoid) {
+        parts.push('空亡填实/冲实后方应，需耐心等待相应月日。');
+    }
+    if (options?.isFuyin) {
+        parts.push('伏吟局主迟滞，需反复推动或等待外因触发。');
+    }
+    if (options?.isFanyin) {
+        parts.push('反吟局主反复，虽快但易生变数，多做预案。');
+    }
+    if (baseGong <= 3 && !options?.hasVoid && !options?.isFuyin) {
+        parts.push('内宫用神，事在近期，果断推进即可。');
+    }
+    if (baseGong >= 7 && !options?.hasHorse && !options?.isFanyin) {
+        parts.push('外宫用神，事在远日，宜耐心布局。');
+    }
+    const description = parts.join('');
+    return { minDays, maxDays, rhythm, sources, description };
+}
+//# sourceMappingURL=ying-qi.js.map

package/dist/divination/algorithms/qimen/helpers/ying-qi.js.map

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

package/dist/divination/algorithms/qimen/index.d.ts

@@ -0,0 +1,116 @@
+/**
+ * @file 奇门遁甲排盘算法（主入口）
+ * @description 基于转盘法，实现时家奇门完整排盘，含定局、布盘、格局识别、方位建议、应期判断。
+ * @流派 转盘奇门（拆补法定局）
+ * @古籍依据 《烟波钓叟歌》《遁甲演义》《奇门遁甲秘籍大全》
+ *
+ * @核心流程
+ * 1. 定局数（拆补法）：根据节气和日干支三元确定阴阳遁和局数
+ * 2. 寻值符值使：由时辰干支旬首定位值符星和值使门
+ * 3. 排九宫格：布地盘三奇六仪 -> 定值符值使落宫 -> 排天盘九星 -> 排人盘八门 -> 排神盘八神
+ * 4. 识格局：基础标签（伏吟/反吟/门迫等）+ 经典双元格局（九遁、三奇格局、门迫、击刑、入墓）
+ * 5. 辅助分析：方位吉凶、应期估算
+ *
+ * 《烟波钓叟歌》核心法理（下称《歌》）：
+ *   "阴阳二遁分顺逆，一气三元人莫测"        —— 拆补法定局
+ *   "直符直使各有时，时干直符时支使"        —— 旬首寻值符值使
+ *   "星随符转，门随地转，八神随遁顺逆"      —— 转盘排盘
+ *   "星反吟兮门反吟，门迫宫兮事难行"        —— 格局判读
+ *   "天遁地遁与人遁，龙遁虎遁与风遁"        —— 九遁格局
+ *   "三奇得使最为良，玉女守门喜非常"        —— 吉格判据
+ *   "十干入墓主事迟，击刑之处防官非"        —— 凶格判据
+ */
+import type { QimenData, QimenJiuGongGe } from '../../../types/divination';
+import type { QimenMethod } from './helpers/layout';
+/**
+ * 根据地支解析所属宫位
+ *
+ * @param branch     地支（如"子""午"）
+ * @param jiuGongGe  九宫格数据
+ * @returns 宫位对象（含地支、宫号、宫名），找不到时返回 null
+ */
+declare function resolveQimenBranchPalace(branch: string, jiuGongGe: QimenJiuGongGe[]): {
+    branch: string;
+    palace: number;
+    name: string;
+} | null;
+/**
+ * 获取驿马地支
+ *
+ * 《烟波钓叟歌》：「天马方为动应之神，驿马冲则事速」
+ * 寅午戌马在申，申子辰马在寅，
+ * 巳酉丑马在亥，亥卯未马在巳。
+ *
+ * @param sourceBranch 时支
+ * @returns 驿马地支，无匹配时返回空字符串
+ */
+declare function getHorseBranch(sourceBranch: string): string;
+/**
+ * 生成奇门遁甲完整排盘
+ *
+ * 遵循拆补法定局、转盘法排盘，完整输出九宫四盘（天地人神）、
+ * 格局标签、经典格局（九遁、三奇、门迫、击刑、入墓等）、
+ * 宫位洞察、方位吉凶指引和应期估算。
+ *
+ * ── 排盘流程 ──
+ *
+ * 1. **时间信息**：《歌》"先须掌上排九宫，纵横十五在其中"
+ *    - 获取公历、农历、节气、干支等完整时间数据
+ *
+ * 2. **定局数（拆补法）**：《歌》"阴阳二遁分顺逆，一气三元人莫测"
+ *    - 根据当前节气与日干支三元确定阴阳遁和局数
+ *
+ * 3. **寻值符值使（旬首法）**：《歌》"直符直使各有时，时干直符时支使"
+ *    - 由时辰干支的旬首定位值符星和值使门
+ *
+ * 4. **排九宫格（转盘法）**：《歌》"星随符转，门随地转，八神随遁顺逆"
+ *    - 布地盘三奇六仪 -> 定值符值使落宫 -> 排天盘九星 -> 排人盘八门 -> 排神盘八神
+ *
+ * 5. **辅助数据**：空亡地支配对、驿马定位
+ *
+ * 6. **基础格局标签**：《歌》"星反吟兮门反吟，门迫宫兮事难行"
+ *    - 伏吟/反吟、门迫、击刑、入墓、三奇得、符使同宫、三奇得使、马星
+ *
+ * 7. **经典格局（advanced）**：《歌》"天遁地遁与人遁，龙遁虎遁与风遁"
+ *    - 九大遁格、三奇得使/升殿/入墓/会甲、符使同宫、天乙飞干/伏干、
+ *      玉女守门、门宫生克、击刑、入墓等
+ *
+ * 8. **天地盘干关系**：每个宫位天盘干与地盘干的五行生克/奇仪相合/入墓/击刑
+ *
+ * 9. **宫位洞察**：综合门、神、星、格局标签判定各宫有利/风险/关注等级
+ *
+ * 10. **方位建议**：《歌》"八门若遇开休生，诸事逢之总称情"
+ *     - 按门、神、星、三奇综合评分，推荐 Top 3 吉方与 1 个避方
+ *
+ * 11. **应期估算**：《奇门遁甲大全》庚格应期法
+ *     - 用神落宫基线 + 值符值使调整 + 庚格定应期 + 伏吟/反吟/马星/空亡微调
+ *
+ * @param customDate 自定义时间（可选，默认当前时间）
+ * @param method     排盘方法，默认 'zhuanpan'（转盘法）
+ * @returns 完整的奇门遁甲数据 QimenData
+ *
+ * @example
+ * ```ts
+ * const result = generateQimen();
+ * // 返回值示例：
+ * // {
+ * //   timeInfo: { solarTerm: '冬至', epoch: '上元' },
+ * //   ganzhi: { year: '甲辰', month: '丙子', day: '戊辰', hour: '壬子' },
+ * //   isYangDun: true,
+ * //   juShu: 1,
+ * //   zhiFu: '天蓬',
+ * //   zhiShi: '休门',
+ * //   patternTags: ['星伏吟', '三奇得（乙奇到震三宫）'],
+ * //   patternDetails: [{ tag: '星伏吟', summary: '九星回原位...' }],
+ * //   classicPatterns: [{ name: '天遁', type: 'good', score: 9, ... }],
+ * //   stemRelations: [{ gong: 1, heavenStem: '戊', earthStem: '癸', relation: '比和', ... }],
+ * //   palaceInsights: [{ gong: 1, name: '坎一宫', level: '关注', ... }],
+ * //   directions: { goodDirections: [...], avoidDirections: [...] },
+ * //   yingQi: { minDays: 7, maxDays: 15, rhythm: '快', ... },
+ * //   timestamp: 1703980800000,
+ * // }
+ * ```
+ */
+export declare function generateQimen(customDate?: Date, method?: QimenMethod): QimenData;
+export { getHorseBranch, resolveQimenBranchPalace };
+//# sourceMappingURL=index.d.ts.map

package/dist/divination/algorithms/qimen/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/divination/algorithms/qimen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAE3E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAyBpD;;;;;;GAMG;AACH,iBAAS,wBAAwB,CAC/B,MAAM,EAAE,MAAM,EACd,SAAS,EAAE,cAAc,EAAE,GAC1B;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAIzD;AAED;;;;;;;;;GASG;AACH,iBAAS,cAAc,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAMpD;AAgDD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiEG;AACH,wBAAgB,aAAa,CAAC,UAAU,CAAC,EAAE,IAAI,EAAE,MAAM,GAAE,WAAwB,GAAG,SAAS,CA6N5F;AAMD,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,CAAC"}