mingyu-core 0.1.0

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

@@ -0,0 +1,451 @@
+/**
+ * @file 天盘干与地盘干组合格局表（81局）
+ * @description 奇门遁甲81种天盘干+地盘干组合的传统格局判定，
+ * 包含吉格、凶格和一般五行生克关系。
+ *
+ * 奇门中甲始终遁藏，故天盘与地盘各取九干：乙丙丁戊己庚辛壬癸，
+ * 两两配对共 9 x 9 = 81 种组合。
+ *
+ * 古籍依据：
+ *   - 《烟波钓叟歌》：「三奇六仪分吉凶，天盘地盘合参用」
+ *   - 《奇门遁甲秘籍大全·十干吉凶章》：「十干相配各有格局，
+ *     或名青龙返首，或名飞鸟跌穴，吉凶各有所主」
+ *   - 《遁甲演义》：「三奇入雾、五凶格、天网地网，皆十干之变也」
+ *   - 《太白阴经》：「天乙青龙、朱雀、白虎、玄武、螣蛇，各有本象」
+ *
+ * 判断思路：
+ *   1. 优先匹配传统命名格局（如青龙返首、白虎猖狂等）；
+ *   2. 无命名格局则按天盘地盘五行生克自动判定：
+ *      - 天盘克地盘 → 冲（凶，-2）
+ *      - 地盘克天盘 → 受阻（凶，-1）
+ *      - 天盘生地盘 → 泄（凶，-1）
+ *      - 地盘生天盘 → 生（吉，+1）
+ *      - 五行相同 → 比和（平，0）
+ */
+import { stemElements, isGenerating, isControlling } from './_constants';
+// ============================================================================
+// 2. 天盘 / 地盘干列表（甲遁藏，不计入）
+// ============================================================================
+const HEAVEN_STEMS = ['乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
+const EARTH_STEMS = ['乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
+// ============================================================================
+// 3. 五行生克自动生成格局
+// ============================================================================
+/**
+ * 根据天盘与地盘的五行关系自动生成格局
+ *
+ * @param heavenStem 天盘干
+ * @param earthStem  地盘干
+ * @returns 自动生成的格局对象
+ */
+function getAutoPattern(heavenStem, earthStem) {
+    const heavenElem = stemElements[heavenStem];
+    const earthElem = stemElements[earthStem];
+    if (!heavenElem || !earthElem) {
+        return {
+            name: '未知',
+            type: 'neutral',
+            score: 0,
+            summary: `天盘${heavenStem}与地盘${earthStem}的五行属性无法识别。`,
+            interpretation: '无法判断两者关系。',
+            manifestation: '需结合其他宫位信息综合判断。',
+        };
+    }
+    // 五行相同 → 比和
+    if (heavenElem === earthElem) {
+        return {
+            name: '比和',
+            type: 'neutral',
+            score: 0,
+            summary: `天盘${heavenStem}（${heavenElem}）与地盘${earthStem}（${earthElem}）` +
+                `五行相同，比和相助。`,
+            interpretation: '双方五行相同，能量协同稳定，无生克矛盾。' +
+                '适合维持现状、稳步推进的事项，不宜冒进或改变。',
+            manifestation: '事情进展平稳，内外一致，无明显助力也无明显阻力，按部就班即可。',
+        };
+    }
+    // 天盘克地盘 → 冲（凶）
+    if (isControlling(heavenElem, earthElem)) {
+        return {
+            name: '冲',
+            type: 'bad',
+            score: -2,
+            summary: `天盘${heavenStem}（${heavenElem}）克地盘${earthStem}（${earthElem}），` +
+                `天盘压制地盘，强行突破之象。`,
+            interpretation: '天盘主动克制地盘，代表外部力量强行改变内部结构。' +
+                '行动力强但带有破坏性，虽然有可能快速见效，但易损伤根基。' +
+                '适合需要果断突破的事项，但需注意后续影响。',
+            manifestation: '做事雷厉风行但容易得罪人；主动出击可能短期内取胜，但长期可能有后遗症；' +
+                '宜把握好度，不可过度强势。',
+        };
+    }
+    // 地盘克天盘 → 受阻（凶）
+    if (isControlling(earthElem, heavenElem)) {
+        return {
+            name: '受阻',
+            type: 'bad',
+            score: -1,
+            summary: `地盘${earthStem}（${earthElem}）克天盘${heavenStem}（${heavenElem}），` +
+                `根基反制行动，阻力来自内部。`,
+            interpretation: '地盘反克天盘，代表基础或内部因素制约外部行动。' +
+                '事情阻力主要来自内部环境、既有制度或下级配合，不易通过外部突破解决。' +
+                '宜先巩固内部再图进取，不可硬闯。',
+            manifestation: '想做却做不了，受到环境、制度或人际关系的限制；' +
+                '如审批卡住、预算被砍、下级不配合；宜静不宜动，先理顺内部。',
+        };
+    }
+    // 天盘生地盘 → 泄（凶）
+    if (isGenerating(heavenElem, earthElem)) {
+        return {
+            name: '泄',
+            type: 'bad',
+            score: -1,
+            summary: `天盘${heavenStem}（${heavenElem}）生地盘${earthStem}（${earthElem}），` +
+                `天盘能量被泄，付出较多。`,
+            interpretation: '天盘主动生助地盘，代表外部能量流向内部，对天盘而言是消耗。' +
+                '付出多于回报，虽然未必全坏，但需要衡量投入产出比。' +
+                '适合公益、培养、投资等需要前期投入的事项。',
+            manifestation: '付出较多而对方受益；短期来看自己吃亏，长期可能积累福报；' +
+                '需注意不要过度消耗自己，量力而行。',
+        };
+    }
+    // 地盘生天盘 → 生（吉）
+    if (isGenerating(earthElem, heavenElem)) {
+        return {
+            name: '生',
+            type: 'good',
+            score: 1,
+            summary: `地盘${earthStem}（${earthElem}）生天盘${heavenStem}（${heavenElem}），` +
+                `根基滋养行动，有后盾之象。`,
+            interpretation: '地盘生助天盘，代表基础或内部因素滋养外部行动。' +
+                '做事有靠山、有资源支持，能够得到他人或环境的帮助。' +
+                '适合主动推进、大胆进取的事项。',
+            manifestation: '有靠山或资源支持，做事顺遂；' + '如上级支持、资金充足、团队配合好；宜乘势进取。',
+        };
+    }
+    // 不应到达此处
+    return {
+        name: '平',
+        type: 'neutral',
+        score: 0,
+        summary: `天盘${heavenStem}与地盘${earthStem}关系平和。`,
+        interpretation: '暂无明确生克判断。',
+        manifestation: '需结合其他宫位信息综合判断。',
+    };
+}
+// ============================================================================
+// 4. 命名格局表（81局中具有传统名称的组合）
+// ============================================================================
+const NAMED_PATTERNS = {
+    // ========================================================================
+    // 一、吉格
+    // ========================================================================
+    戊_丙: {
+        name: '青龙返首',
+        type: 'good',
+        score: 8,
+        summary: '戊为青龙天乙，丙为月奇朱雀，丙火生戊土，龙回之首，百事吉昌。',
+        interpretation: '青龙返首是奇门中最吉利的格局之一。戊为青龙、为钱财、为贵人，丙为月奇、为希望。' +
+            '火生土而天盘得地盘之生助，代表好事反转、长期努力终见回报。' +
+            '适合求财、求职、谋事、远行、婚嫁，百事皆宜。',
+        manifestation: '做事出现关键转机，长期努力看到成果；如仕途升迁、经商得大利、' +
+            '官司得胜、失物复得、求职成功。',
+    },
+    丙_戊: {
+        name: '飞鸟跌穴',
+        type: 'good',
+        score: 8,
+        summary: '丙为朱雀飞鸟，戊为土穴金窟，飞鸟归巢，百事顺遂。',
+        interpretation: '飞鸟跌穴与青龙返首并称奇门两大吉格。丙为月奇飞鸟，戊为青龙之土穴，' +
+            '火生土为天盘主动生入地盘，代表投入能够回馈、计划顺利落地。' +
+            '适合投资、创业、谈判、签约，所谋之事易成。',
+        manifestation: '投放的资源能够回收，计划顺利执行；如投资回报、项目落地、' + '货物卖出、求职得到录用通知。',
+    },
+    // ========================================================================
+    // 二、凶格
+    // ========================================================================
+    乙_辛: {
+        name: '青龙逃走',
+        type: 'bad',
+        score: -8,
+        summary: '乙为青龙日奇，辛为白虎，金克木，青龙受制而逃，主破败损失。',
+        interpretation: '青龙逃走是大凶之格。乙为日奇青龙，代表人才、财物、计划；' +
+            '辛为白虎凶神属金，金克木，青龙被迫逃走。' +
+            '主计划失败、人才流失、财物散失、合作破裂。百事不利，宜静不宜动。',
+        manifestation: '计划好的事情突然生变，合作方退出或反悔；如签约失败、人才离职、' +
+            '投资亏损、财物被盗、合作伙伴跑路。',
+    },
+    辛_乙: {
+        name: '白虎猖狂',
+        type: 'bad',
+        score: -8,
+        summary: '辛为白虎，乙为青龙，金克木，白虎势盛而猖狂，主争斗破坏。',
+        interpretation: '白虎猖狂是大凶之格，与青龙逃走相对。辛金白虎恃强克制乙木青龙，' +
+            '代表恶势力嚣张、小人得志、强者欺凌弱者。' +
+            '主冲突激化、人事斗争、恶性竞争。凡事宜隐忍退让，不可正面硬抗。',
+        manifestation: '遭遇强敌或小人欺压，冲突一触即发；如被人恶意竞争、' +
+            '职场排挤、家庭矛盾激化、遭遇暴力或威胁。',
+    },
+    丁_癸: {
+        name: '朱雀投江',
+        type: 'bad',
+        score: -7,
+        summary: '丁为朱雀星奇，癸为江河之水，水克火，朱雀入水而灭，主文书消息断绝。',
+        interpretation: '朱雀投江为凶格。丁为文书、消息、才华、希望，' +
+            '癸为阴水江河，水克火而丁火熄灭。' +
+            '主音信不通、文书失效、才华被埋没、计划搁浅。',
+        manifestation: '发出的消息石沉大海，提交的申请被驳回或没有下文；' +
+            '如投稿被退、考试落榜、重要信件丢失、面试后无回音。',
+    },
+    癸_丁: {
+        name: '螣蛇夭矫',
+        type: 'bad',
+        score: -7,
+        summary: '癸为螣蛇阴水，丁为星奇之火，水克火，蛇遇火而夭矫不安，主虚惊怪异。',
+        interpretation: '螣蛇夭矫主虚惊怪异、反复无常。癸水螣蛇为阴暗之事，丁为火为文明，' +
+            '水克火而产生不安定的能量。多主意外之事、虚惊一场、计划反复被打断。',
+        manifestation: '莫名出现干扰和波折，事情一而再再而三地反复；' +
+            '如电脑故障、交通延误、约定临时取消、谣言困扰。',
+    },
+    丙_庚: {
+        name: '荧入太白',
+        type: 'bad',
+        score: -7,
+        summary: '丙为荧惑（火星），庚为太白（金星），火克金，荧入太白，主贼盗破财。',
+        interpretation: '荧入太白（全称"荧惑入太白"）是奇门凶格之一。' +
+            '丙为月奇、为希望、为权威，庚为阻碍、为变革，火克金本是正常，' +
+            '但在奇门中代表好事被破坏、到手的成果被夺取。主盗窃、破财、诉讼、争执。',
+        manifestation: '即将成功的事情被破坏，到手的利益被人抢走；' + '如中标被抢、合同被毁约、财物被盗、功劳被抢。',
+    },
+    庚_丙: {
+        name: '太白入荧',
+        type: 'bad',
+        score: -7,
+        summary: '庚为太白（金星），丙为荧惑（火星），火克金，太白受制于荧惑，主客来欺主。',
+        interpretation: '太白入荧（全称"太白入荧惑"）与荧入太白相对，同为大凶之格。' +
+            '庚为敌方、竞争者、外来力量，丙为我方、希望、权威。' +
+            '代表外来力量主动挑战或侵犯我方利益，客来欺主之象。',
+        manifestation: '受到竞争对手或外部的直接挑战；如商业竞争中被对手抢占市场、' +
+            '被人主动挑衅、外来者喧宾夺主。',
+    },
+    庚_癸: {
+        name: '大格',
+        type: 'bad',
+        score: -7,
+        summary: '庚为太白阻隔之神，癸为螣蛇天网，金入水乡，主大凶、出行阻隔。',
+        interpretation: '大格是奇门中最凶的出行格局之一。庚为阻碍、为道路断绝，' +
+            '癸为天网、为困厄，庚金生癸水为天盘泄气而地盘网罗。' +
+            '主道路不通、出行遇险、官司缠身、父子分离、重要事项被卡。',
+        manifestation: '出行严重受阻、信息不通；如签证被拒、航班取消或延误、' +
+            '官司败诉、重要审批被卡住、离家之人久不归。',
+    },
+    壬_己: {
+        name: '小格（伏干格）',
+        type: 'bad',
+        score: -6,
+        summary: '壬为天网主动扩张，己为地户阴土，土克水，天网受阻于地户，主迟滞拖延。',
+        interpretation: '小格又名伏干格，代表事情受到内部牵制而进展缓慢。' +
+            '壬为天网主动扩张，被己土地户所阻。' +
+            '主计划被拖延、内部意见不合、暗中有小人作祟、决策困难。',
+        manifestation: '事情推进迟缓，总有小问题不断出现；如内部讨论不休无法决策、' +
+            '文件审批流程冗长、人事安排反复调整。',
+    },
+    庚_己: {
+        name: '刑格',
+        type: 'bad',
+        score: -7,
+        summary: '庚为太白刑杀之神，己为地户阴私，金土相遇，主刑罚官非、身体伤害。',
+        interpretation: '刑格是奇门凶格中最为凶险的格局之一。庚为刀兵刑杀，己为地户阴暗，' +
+            '土生金为暗中藏刀。主官非刑罚、身体伤害、意外事故。' +
+            '百事需格外谨慎，尤其要防法律纠纷和健康损害。',
+        manifestation: '触犯法律或规章制度的风险极高；如卷入诉讼、被行政处罚、' +
+            '发生意外伤害、病情加重、手术不顺。',
+    },
+    癸_癸: {
+        name: '天网四张',
+        type: 'bad',
+        score: -10,
+        summary: '癸为天网，双癸重逢如天网四张，主困厄至极、大凶。',
+        interpretation: '天网四张是奇门中最凶的格局，没有之一。双癸重叠，天网重重，' +
+            '代表无处可逃、处处碰壁、走投无路。百事不利，宜静守待变，' +
+            '绝不可有任何主动行动。此时任何举措都可能使情况更糟。',
+        manifestation: '事情全面受阻，进退两难；如被多方围困、求救无门、' +
+            '资源枯竭、健康严重恶化、遭遇重大挫折。应静待转机，切勿妄动。',
+    },
+    壬_壬: {
+        name: '地网四张',
+        type: 'bad',
+        score: -8,
+        summary: '壬为地网，双壬重逢如地网四张，主沉沦停滞、陷入僵局。',
+        interpretation: '地网四张与天网四张类似，主被困于僵局之中。双壬为水，泛滥不可收拾。' +
+            '与天网四张不同的是，地网四张更偏重内在的困顿——' +
+            '如思维僵化、缺乏突破口。宜冷静观察、等待外部转机。',
+        manifestation: '陷入僵局无法突破，事情像陷入泥潭；如项目停滞、资金链断裂、' +
+            '被套牢无法脱身、思维陷入死胡同。',
+    },
+    丙_癸: {
+        name: '火入泉池',
+        type: 'bad',
+        score: -6,
+        summary: '丙为月奇之火，癸为阴泉之水，水克火，火入水乡而灭，主希望破灭。',
+        interpretation: '火入泉池为凶格。丙为月奇，代表热情、希望、光明，' +
+            '被癸水（阴泉）所克，主满腔热情被浇灭、好事难成。' +
+            '凡事宜保守，不可冲动行事。',
+        manifestation: '满怀希望却遭遇沉重打击，兴致勃勃却被泼冷水；' + '如表白被拒、项目被否、投资失败、考试失利。',
+    },
+    戊_庚: {
+        name: '天乙飞宫',
+        type: 'bad',
+        score: -5,
+        summary: '戊为天乙青龙（财、根基），庚为太白（变革、道路），土生金，根基被抽，主动荡迁移。',
+        interpretation: '天乙飞宫主事物发生位移或变动。戊为财、为家宅、为稳定，' +
+            '庚为变革，土生金为稳定被转化为变动。主搬家、换工作、财产变动、' +
+            '位置迁移。虽然变动未必全坏，但过程多有不安。',
+        manifestation: '被迫搬家、换工作、调整岗位；如公司搬迁、部门重组、' + '房产交易、迁移到新的城市。',
+    },
+    庚_戊: {
+        name: '天乙太白',
+        type: 'bad',
+        score: -5,
+        summary: '庚为太白（外来力量），戊为天乙（主人、根基），土生金，外来力量消耗主人根基。',
+        interpretation: '天乙太白代表外来力量冲击主人的地位和利益。庚为客人、竞争者、' +
+            '变革力量，戊为天乙主人、原有根基，土生金为根基被外来者消耗。' +
+            '主客反主、被后来者夺权夺利。',
+        manifestation: '被后来者居上，地位或利益被冲击；如老员工被新人取代、' +
+            '市场份额被新竞争者抢占、外来势力喧宾夺主。',
+    },
+    乙_己: {
+        name: '日奇入雾',
+        type: 'bad',
+        score: -4,
+        summary: '乙为日奇（太阳），己为地户土雾，日入雾中，主被遮蔽、才能难伸。',
+        interpretation: '日奇入雾代表才能被埋没、计划被拖延。乙为日奇（太阳、才华、希望），' +
+            '被己土（雾霾、阴私）遮蔽。主怀才不遇、好的想法得不到重视、' +
+            '计划被搁置。宜耐心等待云开雾散。',
+        manifestation: '有能力却无发挥空间，好的方案被搁置不议；如求职被压价、' +
+            '提案被上级搁置、晋升被各种理由拖延。',
+    },
+    丙_己: {
+        name: '月奇入雾',
+        type: 'bad',
+        score: -4,
+        summary: '丙为月奇（希望、热情），己为地户土雾，月入雾中，主迷惘昏暗、方向不明。',
+        interpretation: '月奇入雾代表方向迷失、信心受挫。丙为月奇，代表方向感、热情、明确的追求，' +
+            '被己土之雾遮蔽。主做事缺乏方向感、热情消退、犹豫不决、难以抉择。',
+        manifestation: '不知该往哪个方向走，决策极度困难；如职业转型迷茫、' +
+            '感情选择左右为难、投资方向不明确、信心不足。',
+    },
+    丁_己: {
+        name: '星奇入雾',
+        type: 'bad',
+        score: -4,
+        summary: '丁为星奇（朱雀、文书、才华），己为地户土雾，星入雾中，主文书迟滞消息不通。',
+        interpretation: '星奇入雾代表信息不通、文书延误。丁为星奇，代表消息、文书、才华、沟通，' +
+            '被己土遮蔽。主发出的消息无回应、重要文件延误、沟通不畅。',
+        manifestation: '信函丢失、邮件未回、申请石沉大海；如寄出的简历无回音、' +
+            '发送的申请迟迟没有结果、电话短信无人回复。',
+    },
+    // ========================================================================
+    // 三、中性格（吉凶参半或偏吉）
+    // ========================================================================
+    乙_庚: {
+        name: '奇仪相合（仁义之合）',
+        type: 'neutral',
+        score: 2,
+        summary: '乙庚相合为仁义之合，乙木庚金阴阳相配，合能解凶，主合作和谐。',
+        interpretation: '乙庚相合是天干五合之一，在奇门中属于奇仪相合格局。' +
+            '乙为日奇，庚为太白凶神，合则化凶为吉。代表合作关系和谐、' +
+            '双方各取所需、互利共赢。适合合作、联姻、谈判、团队协作。',
+        manifestation: '合作顺利，双方互相补益；如商务谈判达成协议、' + '婚姻配对成功、团队内部协作高效。',
+    },
+    丙_辛: {
+        name: '奇仪相合（威权之合）',
+        type: 'neutral',
+        score: 2,
+        summary: '丙辛相合为威权之合，丙火辛金阴阳相配，合则刚柔并济，主权威统率。',
+        interpretation: '丙辛相合也是奇仪相合的一种。丙为月奇（权威、领导力），' +
+            '辛为白虎（执行力、锐气），合则刚柔并济。代表权威与执行的完美配合，' +
+            '适合管理、组织协调、带团队、指挥调度。',
+        manifestation: '管理与执行配合良好；如上下级沟通顺畅、' + '军队指挥有序、组织执行力强、领导力得到充分发挥。',
+    },
+    丁_壬: {
+        name: '日月并行',
+        type: 'neutral',
+        score: 2,
+        summary: '丁为月奇星奇之光，壬为天河之水，丁壬相合水火既济，主光明通泰智慧明达。',
+        interpretation: '丁壬相合又称日月并行，属于奇仪相合的一种。' +
+            '丁为星奇（灵性、智慧），壬为水（流动、智慧），' +
+            '水火既济代表阴阳平衡、智慧开启。主谋事能成、灵感涌现、' +
+            '思路清晰，适合策划、创作、研究、决策。',
+        manifestation: '思路清晰视野开阔，关键时刻灵感迸发；如重大决策做出正确判断、' +
+            '学术研究突破瓶颈、创造性工作获得灵感、问题迎刃而解。',
+    },
+};
+// ============================================================================
+// 5. 核心导出函数
+// ============================================================================
+/**
+ * 获取天盘干与地盘干的组合格局
+ *
+ * 在奇门遁甲中，天盘干随九星飞转至某宫，与该宫地盘干形成特定的生克关系。
+ * 部分组合有传统的命名格局（如青龙返首、白虎猖狂等），
+ * 其余按五行生克关系自动判定。
+ *
+ * @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 function getStemPairPattern(heavenStem, earthStem) {
+    // 参数校验
+    if (!heavenStem || !earthStem)
+        return null;
+    if (heavenStem === '甲' || earthStem === '甲')
+        return null;
+    if (!stemElements[heavenStem] || !stemElements[earthStem])
+        return null;
+    // 优先查找命名格局
+    const key = `${heavenStem}_${earthStem}`;
+    const named = NAMED_PATTERNS[key];
+    if (named) {
+        return { ...named };
+    }
+    // 无命名格局则按五行生克自动生成
+    return getAutoPattern(heavenStem, earthStem);
+}
+/**
+ * 获取所有81种天盘干与地盘干组合的格局列表
+ *
+ * @returns 全部81种格局对象数组（按天盘干分组排列）
+ *
+ * @example
+ * ```ts
+ * const allPairs = listAllStemPairs();
+ * console.log(allPairs.length); // 81
+ * ```
+ */
+export function listAllStemPairs() {
+    const results = [];
+    for (const heavenStem of HEAVEN_STEMS) {
+        for (const earthStem of EARTH_STEMS) {
+            const pattern = getStemPairPattern(heavenStem, earthStem);
+            // 内部调用不会返回 null
+            if (pattern) {
+                results.push(pattern);
+            }
+        }
+    }
+    return results;
+}
+//# sourceMappingURL=stem-pair-patterns.js.map

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

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

package/dist/divination/algorithms/qimen/helpers/ying-qi.d.ts

@@ -0,0 +1,78 @@
+/**
+ * @file 应期判断（《奇门遁甲大全》应期章、《奇门旨归》）
+ * @description 综合多种方法估算应期时间：
+ *   1. 用神落宫数 → 远近基线
+ *   2. 值符落宫数 → 辅助基线
+ *   3. 值使落宫数 → 辅助基线
+ *   4. 庚格定应期：阳日看庚下（地盘庚），阴日看庚上（天盘庚），地支逢冲为应
+ *   5. 马星加快、空亡填实/冲实、伏吟延迟、反吟加快
+ *   6. 吉格加快、凶格延迟
+ */
+export interface YingQiEstimate {
+    /** 最短应期（日） */
+    minDays: number;
+    /** 最长应期（日） */
+    maxDays: number;
+    /** 应期节奏 */
+    rhythm: '快' | '中' | '慢';
+    /** 判断依据列表 */
+    sources: string[];
+    /** 综合描述 */
+    description: string;
+}
+/**
+ * 估算应期
+ *
+ * @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 declare function estimateYingQi(jiuGongGe: Array<{
+    gong: number;
+    tianPan: {
+        stem: string;
+        star: string;
+    };
+    diPan: {
+        stem: string;
+    };
+}>, useShenPalace?: number, options?: {
+    /** 是否伏吟 */
+    isFuyin?: boolean;
+    /** 是否反吟 */
+    isFanyin?: boolean;
+    /** 是否有马星冲动 */
+    hasHorse?: boolean;
+    /** 是否有空亡 */
+    hasVoid?: boolean;
+    /** 值符落宫 */
+    zhiFuLandingPalace?: number;
+    /** 值使落宫 */
+    zhiShiLandingPalace?: number;
+    /** 时干支（如 "甲子"） */
+    hourGanZhi?: string;
+    /** 经典格局列表 */
+    classicPatterns?: Array<{
+        name: string;
+        score: number;
+    }>;
+    /** 空亡地支列表（用于细化说明填实时间） */
+    voidBranches?: string[];
+}): YingQiEstimate;
+//# sourceMappingURL=ying-qi.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ying-qi.d.ts","sourceRoot":"","sources":["../../../../../src/divination/algorithms/qimen/helpers/ying-qi.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA+BH,MAAM,WAAW,cAAc;IAC7B,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,cAAc;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW;IACX,MAAM,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IACxB,aAAa;IACb,OAAO,EAAE,MAAM,EAAE,CAAC;IAClB,WAAW;IACX,WAAW,EAAE,MAAM,CAAC;CACrB;AAMD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,cAAc,CAC5B,SAAS,EAAE,KAAK,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;IACxC,KAAK,EAAE;QAAE,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CACzB,CAAC,EACF,aAAa,CAAC,EAAE,MAAM,EACtB,OAAO,CAAC,EAAE;IACR,WAAW;IACX,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW;IACX,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,cAAc;IACd,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,YAAY;IACZ,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,WAAW;IACX,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,WAAW;IACX,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B,kBAAkB;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,eAAe,CAAC,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzD,yBAAyB;IACzB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB,GACA,cAAc,CAiQhB"}