mingyu-core 0.1.3 → 0.1.5

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

@@ -1,12 +1,13 @@
 /**
  * @file 奇门遁甲排盘算法（主入口）
- * @description 基于转盘法，实现时家奇门完整排盘，含定局、布盘、格局识别、方位建议、应期判断。
+ * @description 基于转盘法，实现时家/日家/月家/年家奇门完整排盘，
+ * 含定局、布盘、格局识别、方位建议、应期判断。
  * @流派 转盘奇门（拆补法定局）
  * @古籍依据 《烟波钓叟歌》《遁甲演义》《奇门遁甲秘籍大全》
  *
  * @核心流程
- * 1. 定局数（拆补法）：根据节气和日干支三元确定阴阳遁和局数
- * 2. 寻值符值使：由时辰干支旬首定位值符星和值使门
+ * 1. 定局数（拆补法/月家法/年家法）：根据 scope 选择不同定局方式
+ * 2. 寻值符值使：由对应级别的干支旬首定位值符星和值使门
  * 3. 排九宫格：布地盘三奇六仪 -> 定值符值使落宫 -> 排天盘九星 -> 排人盘八门 -> 排神盘八神
  * 4. 识格局：基础标签（伏吟/反吟/门迫等）+ 经典双元格局（九遁、三奇格局、门迫、击刑、入墓）
  * 5. 辅助分析：方位吉凶、应期估算
@@ -20,7 +21,7 @@
  *   "三奇得使最为良，玉女守门喜非常"        —— 吉格判据
  *   "十干入墓主事迟，击刑之处防官非"        —— 凶格判据
  */
-import type { QimenData, QimenJiuGongGe } from '../../../types/divination';
+import type { QimenData, QimenJiuGongGe, QimenScope } from '../../../types/divination';
 import type { QimenMethod } from './helpers/layout';
 /**
  * 根据地支解析所属宫位
@@ -48,6 +49,9 @@ declare function getHorseBranch(sourceBranch: string): string;
 /**
  * 生成奇门遁甲完整排盘
  *
+ * 支持时家（hour）、日家（day）、月家（month）、年家（year）四种级别。
+ * 默认时家奇门（精确到时辰），使用拆补法定局。
+ *
  * 遵循拆补法定局、转盘法排盘，完整输出九宫四盘（天地人神）、
  * 格局标签、经典格局（九遁、三奇、门迫、击刑、入墓等）、
  * 宫位洞察、方位吉凶指引和应期估算。
@@ -57,11 +61,13 @@ declare function getHorseBranch(sourceBranch: string): string;
  * 1. **时间信息**：《歌》"先须掌上排九宫，纵横十五在其中"
  *    - 获取公历、农历、节气、干支等完整时间数据
  *
- * 2. **定局数（拆补法）**：《歌》"阴阳二遁分顺逆，一气三元人莫测"
- *    - 根据当前节气与日干支三元确定阴阳遁和局数
+ * 2. **定局数**：《歌》"阴阳二遁分顺逆，一气三元人莫测"
+ *    - 时家/日家：拆补法（以节气为界）
+ *    - 月家：月支循环定局
+ *    - 年家：年干分组 + 三元甲子周期
  *
  * 3. **寻值符值使（旬首法）**：《歌》"直符直使各有时，时干直符时支使"
- *    - 由时辰干支的旬首定位值符星和值使门
+ *    - 由对应级别干支的旬首定位值符星和值使门
  *
  * 4. **排九宫格（转盘法）**：《歌》"星随符转，门随地转，八神随遁顺逆"
  *    - 布地盘三奇六仪 -> 定值符值使落宫 -> 排天盘九星 -> 排人盘八门 -> 排神盘八神
@@ -71,46 +77,36 @@ declare function getHorseBranch(sourceBranch: string): string;
  * 6. **基础格局标签**：《歌》"星反吟兮门反吟，门迫宫兮事难行"
  *    - 伏吟/反吟、门迫、击刑、入墓、三奇得、符使同宫、三奇得使、马星
  *
- * 7. **经典格局（advanced）**：《歌》"天遁地遁与人遁，龙遁虎遁与风遁"
- *    - 九大遁格、三奇得使/升殿/入墓/会甲、符使同宫、天乙飞干/伏干、
- *      玉女守门、门宫生克、击刑、入墓等
+ * 7. **经典格局**：《歌》"天遁地遁与人遁，龙遁虎遁与风遁"
+ *    - 九大遁格、三奇得使/升殿/入墓/会甲、符使同宫等
  *
- * 8. **天地盘干关系**：每个宫位天盘干与地盘干的五行生克/奇仪相合/入墓/击刑
+ * 8. **天地盘干关系**：每个宫位天盘干与地盘干的五行生克
  *
- * 9. **宫位洞察**：综合门、神、星、格局标签判定各宫有利/风险/关注等级
+ * 9. **宫位洞察**：综合门、神、星、格局标签判定各宫等级
  *
  * 10. **方位建议**：《歌》"八门若遇开休生，诸事逢之总称情"
- *     - 按门、神、星、三奇综合评分，推荐 Top 3 吉方与 1 个避方
+ *     - 按门、神、星、三奇综合评分，推荐吉方与避方
  *
  * 11. **应期估算**：《奇门遁甲大全》庚格应期法
- *     - 用神落宫基线 + 值符值使调整 + 庚格定应期 + 伏吟/反吟/马星/空亡微调
  *
  * @param customDate 自定义时间（可选，默认当前时间）
  * @param method     排盘方法，默认 'zhuanpan'（转盘法）
+ * @param scope      排盘级别，默认 'hour'（时家奇门）
  * @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,
- * // }
+ *
+ * // 日家奇门
+ * const result = generateQimen(undefined, 'zhuanpan', 'day');
+ *
+ * // 年家奇门
+ * const result = generateQimen(new Date('2025-01-01'), 'zhuanpan', 'year');
  * ```
  */
-export declare function generateQimen(customDate?: Date, method?: QimenMethod): QimenData;
+export declare function generateQimen(customDate?: Date, method?: QimenMethod, scope?: QimenScope): QimenData;
+export type { QimenScope };
 export { getHorseBranch, resolveQimenBranchPalace };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/divination/algorithms/qimen/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,cAAc,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAEvF,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AA0BpD;;;;;;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;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2DG;AACH,wBAAgB,aAAa,CAC3B,UAAU,CAAC,EAAE,IAAI,EACjB,MAAM,GAAE,WAAwB,EAChC,KAAK,GAAE,UAAmB,GACzB,SAAS,CA+JX;AAyFD,YAAY,EAAE,UAAU,EAAE,CAAC;AAM3B,OAAO,EAAE,cAAc,EAAE,wBAAwB,EAAE,CAAC"}

package/dist/divination/algorithms/qimen/index.js

@@ -1,12 +1,13 @@
 /**
  * @file 奇门遁甲排盘算法（主入口）
- * @description 基于转盘法，实现时家奇门完整排盘，含定局、布盘、格局识别、方位建议、应期判断。
+ * @description 基于转盘法，实现时家/日家/月家/年家奇门完整排盘，
+ * 含定局、布盘、格局识别、方位建议、应期判断。
  * @流派 转盘奇门（拆补法定局）
  * @古籍依据 《烟波钓叟歌》《遁甲演义》《奇门遁甲秘籍大全》
  *
  * @核心流程
- * 1. 定局数（拆补法）：根据节气和日干支三元确定阴阳遁和局数
- * 2. 寻值符值使：由时辰干支旬首定位值符星和值使门
+ * 1. 定局数（拆补法/月家法/年家法）：根据 scope 选择不同定局方式
+ * 2. 寻值符值使：由对应级别的干支旬首定位值符星和值使门
  * 3. 排九宫格：布地盘三奇六仪 -> 定值符值使落宫 -> 排天盘九星 -> 排人盘八门 -> 排神盘八神
  * 4. 识格局：基础标签（伏吟/反吟/门迫等）+ 经典双元格局（九遁、三奇格局、门迫、击刑、入墓）
  * 5. 辅助分析：方位吉凶、应期估算
@@ -23,7 +24,8 @@
 import { getDivinationTime } from '../../../calendar/timeManager.js';
 import { getVoidBranches } from '../../../calendar/lunar.js';
 import { diPanPalaces } from './helpers/_constants.js';
-import { getQimenJuShu, getZhiFuZhiShi, getDunJiaStem } from './helpers/jushu.js';
+import { getQimenJuShu, getZhiFuZhiShi, getZhiFuZhiShiByGanZhi, getDunJiaStem } from './helpers/jushu.js';
+import { getMonthQimenJuShu, getYearQimenJuShu } from './helpers/jushu-extended.js';
 import { arrangeJiuGongGe } from './helpers/layout.js';
 import { getQimenPatternTags, buildPatternDetails, buildPalaceInsights } from './helpers/patterns.js';
 import { getStemRelations, getClassicPatterns } from './helpers/classic-patterns.js';
@@ -117,6 +119,9 @@ function mapStemRelations(relations) {
 /**
  * 生成奇门遁甲完整排盘
  *
+ * 支持时家（hour）、日家（day）、月家（month）、年家（year）四种级别。
+ * 默认时家奇门（精确到时辰），使用拆补法定局。
+ *
  * 遵循拆补法定局、转盘法排盘，完整输出九宫四盘（天地人神）、
  * 格局标签、经典格局（九遁、三奇、门迫、击刑、入墓等）、
  * 宫位洞察、方位吉凶指引和应期估算。
@@ -126,11 +131,13 @@ function mapStemRelations(relations) {
  * 1. **时间信息**：《歌》"先须掌上排九宫，纵横十五在其中"
  *    - 获取公历、农历、节气、干支等完整时间数据
  *
- * 2. **定局数（拆补法）**：《歌》"阴阳二遁分顺逆，一气三元人莫测"
- *    - 根据当前节气与日干支三元确定阴阳遁和局数
+ * 2. **定局数**：《歌》"阴阳二遁分顺逆，一气三元人莫测"
+ *    - 时家/日家：拆补法（以节气为界）
+ *    - 月家：月支循环定局
+ *    - 年家：年干分组 + 三元甲子周期
  *
  * 3. **寻值符值使（旬首法）**：《歌》"直符直使各有时，时干直符时支使"
- *    - 由时辰干支的旬首定位值符星和值使门
+ *    - 由对应级别干支的旬首定位值符星和值使门
  *
  * 4. **排九宫格（转盘法）**：《歌》"星随符转，门随地转，八神随遁顺逆"
  *    - 布地盘三奇六仪 -> 定值符值使落宫 -> 排天盘九星 -> 排人盘八门 -> 排神盘八神
@@ -140,154 +147,97 @@ function mapStemRelations(relations) {
  * 6. **基础格局标签**：《歌》"星反吟兮门反吟，门迫宫兮事难行"
  *    - 伏吟/反吟、门迫、击刑、入墓、三奇得、符使同宫、三奇得使、马星
  *
- * 7. **经典格局（advanced）**：《歌》"天遁地遁与人遁，龙遁虎遁与风遁"
- *    - 九大遁格、三奇得使/升殿/入墓/会甲、符使同宫、天乙飞干/伏干、
- *      玉女守门、门宫生克、击刑、入墓等
+ * 7. **经典格局**：《歌》"天遁地遁与人遁，龙遁虎遁与风遁"
+ *    - 九大遁格、三奇得使/升殿/入墓/会甲、符使同宫等
  *
- * 8. **天地盘干关系**：每个宫位天盘干与地盘干的五行生克/奇仪相合/入墓/击刑
+ * 8. **天地盘干关系**：每个宫位天盘干与地盘干的五行生克
  *
- * 9. **宫位洞察**：综合门、神、星、格局标签判定各宫有利/风险/关注等级
+ * 9. **宫位洞察**：综合门、神、星、格局标签判定各宫等级
  *
  * 10. **方位建议**：《歌》"八门若遇开休生，诸事逢之总称情"
- *     - 按门、神、星、三奇综合评分，推荐 Top 3 吉方与 1 个避方
+ *     - 按门、神、星、三奇综合评分，推荐吉方与避方
  *
  * 11. **应期估算**：《奇门遁甲大全》庚格应期法
- *     - 用神落宫基线 + 值符值使调整 + 庚格定应期 + 伏吟/反吟/马星/空亡微调
  *
  * @param customDate 自定义时间（可选，默认当前时间）
  * @param method     排盘方法，默认 'zhuanpan'（转盘法）
+ * @param scope      排盘级别，默认 'hour'（时家奇门）
  * @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,
- * // }
+ *
+ * // 日家奇门
+ * const result = generateQimen(undefined, 'zhuanpan', 'day');
+ *
+ * // 年家奇门
+ * const result = generateQimen(new Date('2025-01-01'), 'zhuanpan', 'year');
  * ```
  */
-export function generateQimen(customDate, method = 'zhuanpan') {
+export function generateQimen(customDate, method = 'zhuanpan', scope = 'hour') {
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 1：获取统一占卜时间信息
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》："先须掌上排九宫，纵横十五在其中。
-    //   次将八卦论八节，一气统三为正宗。"
     const { timeInfo, ganzhi, timestamp } = getDivinationTime(customDate);
     const { jieQi } = timeInfo;
+    // 根据 scope 确定"主动干支"（用于定局、寻符使、空亡、驿马）
+    const activeGanZhi = getActiveGanZhi(ganzhi, scope);
     // ──────────────────────────────────────────────────────────────────────────
-    // 步骤 2：定局数（拆补法）
+    // 步骤 2：定局数
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》：
-    //   "阴阳二遁分顺逆，一气三元人莫测。
-    //    五日都来换一元，接气超神为准则。"
-    //
-    // 拆补法以节气为界，不置闰：
-    //   - 阳遁：冬至 -> 芒种（顺布六仪，逆布三奇）
-    //   - 阴遁：夏至 -> 大雪（逆布六仪，顺布三奇）
-    const jushuResult = getQimenJuShu({
-        jieQi,
-        ganzhi: { day: ganzhi.day },
-        solar: {
-            year: timeInfo.solar.year,
-            month: timeInfo.solar.month,
-            day: timeInfo.solar.day,
-        },
-    });
+    const jushuResult = getJushuForScope(scope, ganzhi, timeInfo);
+    const { isYangDun, juShu, yuan } = jushuResult;
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 3：寻值符与值使（旬首法）
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》："直符直使各有时，时干直符时支使。"
-    //
-    // 值符（九星之主）与值使（八门之主）由时辰干支的旬首决定：
-    //   旬首地支 -> 地盘宫位 -> 该宫星为值符、门为值使
-    const { zhiFu, zhiShi, specialConditions } = getZhiFuZhiShi(ganzhi.hour);
+    const zhiFuShiResult = getZhiFuShiForScope(scope, activeGanZhi, ganzhi);
+    const { zhiFu, zhiShi, specialConditions } = zhiFuShiResult;
+    // ── 后续步骤 4-12 与 scope 无关，共用同一套排盘逻辑 ──
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 4：排九宫格（转盘法）
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》：
-    //   "星随符转，门随地转，八神随遁顺逆"
-    //
-    // 转盘法五大步骤：
-    //   1) 布地盘三奇六仪（阳顺阴逆）
-    //   2) 定值符落宫（时干遁干所在宫）与值使落宫（时支所在宫）
-    //   3) 排天盘九星（值符为把手，九星整体旋转）
-    //   4) 排人盘八门（值使为把手，沿洛书轨迹排列）
-    //   5) 排神盘八神（值符神随天盘值符星，阳顺阴逆排列）
-    const jiuGongGe = arrangeJiuGongGe(jushuResult.isYangDun, jushuResult.juShu, zhiFu, zhiShi, { hour: ganzhi.hour }, method);
+    const jiuGongGe = arrangeJiuGongGe(isYangDun, juShu, zhiFu, zhiShi, { hour: activeGanZhi }, method);
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 5：辅助数据（空亡、驿马）
     // ──────────────────────────────────────────────────────────────────────────
-    const hourZhi = ganzhi.hour.charAt(1);
-    const hourGanForFind = getDunJiaStem(ganzhi.hour);
-    // 空亡：时辰干支所在旬对应的空亡地支
-    // 用于判断宫位能量虚浮、不宜行动
-    const voidBranches = getVoidBranches(ganzhi.hour) || [];
+    const activeZhi = activeGanZhi.charAt(1);
+    const activeGanForFind = getDunJiaStem(activeGanZhi);
+    const voidBranches = getVoidBranches(activeGanZhi) || [];
     const voidPalaces = voidBranches
         .map((branch) => resolveQimenBranchPalace(branch, jiuGongGe))
         .filter((item) => Boolean(item));
-    // 驿马（天马）：时支对应的驿马地支
-    // 《烟波钓叟歌》："天马方为动应之神，驿马冲则事速"
-    const horseBranch = getHorseBranch(hourZhi);
+    const horseBranch = getHorseBranch(activeZhi);
     const horsePalace = horseBranch ? resolveQimenBranchPalace(horseBranch, jiuGongGe) : null;
-    // 值符落宫与值使落宫（用于后续格局判断和应期估算）
     const zhiFuLandingPalace = jiuGongGe.find((gong) => gong.tianPan.star === zhiFu)?.gong;
     if (zhiFuLandingPalace === undefined) {
         throw new Error(`找不到值符星 "${zhiFu}" 落宫。`);
     }
-    const zhiShiLandingPalace = diPanPalaces[hourZhi];
+    const zhiShiLandingPalace = diPanPalaces[activeZhi];
     if (zhiShiLandingPalace === undefined) {
-        throw new Error(`找不到时支 "${hourZhi}" 对应的地盘宫位。`);
+        throw new Error(`找不到 "${activeZhi}" 对应的地盘宫位。`);
     }
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 6：基础格局标签
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》：
-    //   "星反吟兮门反吟，门迫宫兮事难行"
-    //   "击刑之处防官非，十干入墓主事迟"
-    //   "三奇得使最为良，符使同宫事必成"
-    //
-    // 检测以下标签：
-    //   星伏吟/星反吟、门伏吟/门反吟、门迫、
-    //   击刑、入墓、三奇得、符使同宫、三奇得使、马星
     const patternTags = getQimenPatternTags({
         zhiFu,
         zhiShi,
         zhiFuLandingPalace,
         zhiShiLandingPalace,
         jiuGongGe,
-        hourGanForFind,
+        hourGanForFind: activeGanForFind,
         horsePalace: horsePalace?.palace,
         horsePalaceName: horsePalace?.name,
     });
     // ──────────────────────────────────────────────────────────────────────────
-    // 步骤 7：标签详情（面向用户的简要解读）
+    // 步骤 7：标签详情
     // ──────────────────────────────────────────────────────────────────────────
     const patternDetails = buildPatternDetails(patternTags);
     // ──────────────────────────────────────────────────────────────────────────
-    // 步骤 8：经典格局（advanced patterns）
+    // 步骤 8：经典格局
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》：
-    //   "天遁地遁与人遁，龙遁虎遁与风遁，云遁鬼遁与神遁"   —— 九遁
-    //   "三奇得使最为良，玉女守门喜非常"                     —— 三奇/玉女
-    //   "十干入墓主事迟，击刑之处防官非"                    —— 入墓/击刑
-    //   "门迫宫兮事难行"                                     —— 门迫
-    //
-    // 综合识别：九遁、三奇得使/升殿/入墓/会甲、符使同宫、
-    // 天乙飞干格/伏干格、天辅时、玉女守门、门迫、门宫相生、击刑、入墓
     const dayStem = ganzhi.day.charAt(0);
     const classicPatternContext = {
         jiuGongGe,
@@ -298,21 +248,13 @@ export function generateQimen(customDate, method = 'zhuanpan') {
     const classicPatternsRaw = getClassicPatterns(classicPatternContext);
     const classicPatterns = mapClassicPatterns(classicPatternsRaw);
     // ──────────────────────────────────────────────────────────────────────────
-    // 步骤 9：天地盘干关系（每宫天盘干 vs 地盘干）
+    // 步骤 9：天地盘干关系
     // ──────────────────────────────────────────────────────────────────────────
-    // 每个宫位输出天盘干与地盘干的主要关系：
-    //   五行生克（克上/克下/生上/生下/比和）
-    //   奇仪相合、入墓、击刑
-    // 最多每宫输出一条主关系 + 边缘关系
     const stemRelationsRaw = getStemRelations(jiuGongGe);
     const stemRelations = mapStemRelations(stemRelationsRaw);
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 10：宫位洞察
     // ──────────────────────────────────────────────────────────────────────────
-    // 综合门、神、星和模式标签，逐宫判定：
-    //   有利（绿色）：吉门/吉神，适合行动
-    //   关注（黄色）：值符所在，全局核心观察位
-    //   风险（红色）：凶门/凶神/门迫/击刑/入墓，宜谨慎
     const palaceInsights = buildPalaceInsights({
         jiuGongGe,
         zhiFu,
@@ -322,21 +264,10 @@ export function generateQimen(customDate, method = 'zhuanpan') {
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 11：方位建议
     // ──────────────────────────────────────────────────────────────────────────
-    // 《烟波钓叟歌》："八门若遇开休生，诸事逢之总称情"
-    //
-    // 综合评分（门/神/星/三奇/空亡/经典格局）：
-    //   吉方：Top 3 高分区位，含推荐用途
-    //   避方：1 个最低分区位，含风险原因
     const directions = buildDirectionAdvice(jiuGongGe, voidBranches, classicPatternsRaw);
     // ──────────────────────────────────────────────────────────────────────────
     // 步骤 12：应期估算
     // ──────────────────────────────────────────────────────────────────────────
-    // 《奇门遁甲大全》应期章：
-    //   1. 用神落宫基线（内宫 1-3 速应，中宫 4-6 渐进，外宫 7-9 迟应）
-    //   2. 值符值使落宫调整
-    //   3. 庚格定应期（阳日看庚下、阴日看庚上，地支逢冲为应）
-    //   4. 伏吟延迟 / 反吟加快 / 马星加快 / 空亡填实
-    //   5. 经典格局影响（吉格加快 / 凶格延迟）
     const isFuyin = patternTags.some((t) => t.includes('伏吟'));
     const isFanyin = patternTags.some((t) => t.includes('反吟'));
     const hasVoid = voidBranches.length > 0;
@@ -348,7 +279,7 @@ export function generateQimen(customDate, method = 'zhuanpan') {
         hasVoid,
         zhiFuLandingPalace,
         zhiShiLandingPalace,
-        hourGanZhi: ganzhi.hour,
+        hourGanZhi: activeGanZhi,
         classicPatterns: classicPatternsRaw,
         voidBranches,
     });
@@ -356,6 +287,7 @@ export function generateQimen(customDate, method = 'zhuanpan') {
     // 步骤 13：返回完整 QimenData
     // ──────────────────────────────────────────────────────────────────────────
     return {
+        scope,
         timeInfo: {
             solarTerm: jushuResult.jieQi || jieQi,
             epoch: jushuResult.yuan,
@@ -370,7 +302,7 @@ export function generateQimen(customDate, method = 'zhuanpan') {
         palaceInsights,
         voidBranches,
         voidPalaces,
-        horseStar: horsePalace ? { ...horsePalace, sourceBranch: hourZhi } : undefined,
+        horseStar: horsePalace ? { ...horsePalace, sourceBranch: activeZhi } : undefined,
         specialConditions,
         jiuGongGe,
         classicPatterns,
@@ -381,6 +313,77 @@ export function generateQimen(customDate, method = 'zhuanpan') {
     };
 }
 // ============================================================================
+// 内部辅助函数（不同 scope 对应的定局/寻符使逻辑）
+// ============================================================================
+/** 根据 scope 获取主动干支 */
+function getActiveGanZhi(ganzhi, scope) {
+    switch (scope) {
+        case 'year': return ganzhi.year;
+        case 'month': return ganzhi.month;
+        case 'day': return ganzhi.day;
+        default: return ganzhi.hour;
+    }
+}
+/** 根据 scope 获取定局结果 */
+function getJushuForScope(scope, ganzhi, timeInfo) {
+    switch (scope) {
+        case 'year': {
+            const r = getYearQimenJuShu(ganzhi.year);
+            return { ...r, jieQi: timeInfo.jieQi };
+        }
+        case 'month': {
+            const r = getMonthQimenJuShu(ganzhi.month, ganzhi.year);
+            return { ...r, jieQi: timeInfo.jieQi };
+        }
+        case 'day':
+        case 'hour':
+        default: {
+            return getQimenJuShu({
+                jieQi: timeInfo.jieQi,
+                ganzhi: { day: ganzhi.day },
+                solar: {
+                    year: timeInfo.solar.year,
+                    month: timeInfo.solar.month,
+                    day: timeInfo.solar.day,
+                },
+            });
+        }
+    }
+}
+/** 根据 scope 获取值符值使 */
+function getZhiFuShiForScope(scope, activeGanZhi, ganzhi) {
+    const defaultSpecialConditions = {
+        isLiuJiaHour: false,
+        isLiuGuiHour: false,
+        isShiGanRuMu: false,
+        isWuBuYuShi: false,
+        description: '',
+    };
+    switch (scope) {
+        case 'hour': {
+            // 时家奇门：支持特殊时辰检查
+            const result = getZhiFuZhiShi(activeGanZhi);
+            return {
+                zhiFu: result.zhiFu,
+                zhiShi: result.zhiShi,
+                specialConditions: result.specialConditions,
+            };
+        }
+        case 'day':
+        case 'month':
+        case 'year':
+        default: {
+            // 日/月/年家：使用通用旬首法（不检查特殊时辰条件）
+            const result = getZhiFuZhiShiByGanZhi(activeGanZhi);
+            return {
+                zhiFu: result.zhiFu,
+                zhiShi: result.zhiShi,
+                specialConditions: defaultSpecialConditions,
+            };
+        }
+    }
+}
+// ============================================================================
 // 导出内部工具（供外部模块或测试使用）
 // ============================================================================
 export { getHorseBranch, resolveQimenBranchPalace };

package/dist/divination/algorithms/qimen/index.js.map

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

package/dist/divination/algorithms/ssgw.d.ts

@@ -1,6 +1,22 @@
 import type { SsgwData } from '../../types/divination';
 /**
  * 随机求签 - 模拟真实的求签过程
+ *
+ * 从三山国王 92 支签文中随机抽取一条作为占卜结果，
+ * 自动附带求签时间的干支和 Unix 时间戳。
+ *
+ * @param customDate 自定义求签时间（可选），不传则使用当前时间。
+ *   传入后签文结果的 `ganzhi` 和 `timestamp` 会基于该时间生成。
+ * @returns 完整的签文结果 SsgwData，包含签号、标题、签诗、典故、详解和求签时间干支。
+ *
+ * @example
+ * ```ts
+ * // 当前时间求签
+ * const sign = drawRandomSign();
+ *
+ * // 指定时间求签
+ * const sign = drawRandomSign(new Date('2025-06-15T10:00:00'));
+ * ```
  */
-export declare function drawRandomSign(): SsgwData;
+export declare function drawRandomSign(customDate?: Date): SsgwData;
 //# sourceMappingURL=ssgw.d.ts.map

package/dist/divination/algorithms/ssgw.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssgw.d.ts","sourceRoot":"","sources":["../../../src/divination/algorithms/ssgw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAoBvD;;GAEG;AACH,wBAAgB,cAAc,IAAI,QAAQ,CASzC"}
+{"version":3,"file":"ssgw.d.ts","sourceRoot":"","sources":["../../../src/divination/algorithms/ssgw.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAC;AAoBvD;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,cAAc,CAAC,UAAU,CAAC,EAAE,IAAI,GAAG,QAAQ,CAS1D"}

package/dist/divination/algorithms/ssgw.js

@@ -16,9 +16,25 @@ const ssgwSigns = SSGW_SIGNS.map((sign) => ({
 }));
 /**
  * 随机求签 - 模拟真实的求签过程
+ *
+ * 从三山国王 92 支签文中随机抽取一条作为占卜结果，
+ * 自动附带求签时间的干支和 Unix 时间戳。
+ *
+ * @param customDate 自定义求签时间（可选），不传则使用当前时间。
+ *   传入后签文结果的 `ganzhi` 和 `timestamp` 会基于该时间生成。
+ * @returns 完整的签文结果 SsgwData，包含签号、标题、签诗、典故、详解和求签时间干支。
+ *
+ * @example
+ * ```ts
+ * // 当前时间求签
+ * const sign = drawRandomSign();
+ *
+ * // 指定时间求签
+ * const sign = drawRandomSign(new Date('2025-06-15T10:00:00'));
+ * ```
  */
-export function drawRandomSign() {
-    const { ganzhi, timestamp } = getDivinationTime();
+export function drawRandomSign(customDate) {
+    const { ganzhi, timestamp } = getDivinationTime(customDate);
     const randomIndex = Math.floor(Math.random() * ssgwSigns.length);
     const sign = ssgwSigns[randomIndex];
     return {

package/dist/divination/algorithms/ssgw.js.map

@@ -1 +1 @@
-{"version":3,"file":"ssgw.js","sourceRoot":"","sources":["../../../src/divination/algorithms/ssgw.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;GAMG;AAEH,MAAM,SAAS,GAA6C,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,MAAM,EAAE,IAAI,CAAC,EAAE;IACf,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC,OAAO;IAClB,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,OAAO,EAAE,IAAI,CAAC,OAAO;CACtB,CAAC,CAAC,CAAC;AAEJ;;GAEG;AACH,MAAM,UAAU,cAAc;IAC5B,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,iBAAiB,EAAE,CAAC;IAClD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,OAAO;QACL,GAAG,IAAI;QACP,SAAS;QACT,MAAM;KACP,CAAC;AACJ,CAAC"}
+{"version":3,"file":"ssgw.js","sourceRoot":"","sources":["../../../src/divination/algorithms/ssgw.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAE/D;;;;;;GAMG;AAEH,MAAM,SAAS,GAA6C,UAAU,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IACpF,MAAM,EAAE,IAAI,CAAC,EAAE;IACf,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,IAAI,EAAE,IAAI,CAAC,OAAO;IAClB,KAAK,EAAE,IAAI,CAAC,KAAK;IACjB,OAAO,EAAE,IAAI,CAAC,OAAO;CACtB,CAAC,CAAC,CAAC;AAEJ;;;;;;;;;;;;;;;;;;GAkBG;AACH,MAAM,UAAU,cAAc,CAAC,UAAiB;IAC9C,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAAC,UAAU,CAAC,CAAC;IAC5D,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,SAAS,CAAC,MAAM,CAAC,CAAC;IACjE,MAAM,IAAI,GAAG,SAAS,CAAC,WAAW,CAAC,CAAC;IACpC,OAAO;QACL,GAAG,IAAI;QACP,SAAS;QACT,MAAM;KACP,CAAC;AACJ,CAAC"}