mingpan 0.1.1 → 0.1.3

package/README.md

@@ -1,14 +1,14 @@
 # 命盘 MCP Server
 
-[![Version](https://img.shields.io/badge/version-0.1.1-blue.svg)](https://github.com/ChesterRa/mingpan)
+[![Version](https://img.shields.io/badge/version-0.1.3-blue.svg)](https://github.com/ChesterRa/mingpan)
 [![License](https://img.shields.io/badge/license-Apache%202.0-green.svg)](LICENSE)
 
-**命盘（Mingpan）** 是一个中华传统命理计算 MCP 服务，为 Claude 等 AI 应用提供八字与紫微斗数的排盘计算能力。
+**命盘（Mingpan）** 是一个中华传统术数 MCP 服务，为 Claude 等 AI 应用提供命理排盘与占卜起卦的计算能力。
 
 ## 特性
 
 -  **MCP 原生**：无缝集成 Claude Desktop 及 Claude Code
-- 🌏 **繁体中文输出**：符合命理传统的专业术语
+- 🌏 **中文输出**：以简体为主，术语保持传统
 - 📊 **结构化文本**：便于 AI 理解与分析的格式
 
 ## 配置方法
@@ -44,49 +44,120 @@ claude mcp add mingpan -- npx -y mingpan
 
 > 请帮我排一个八字命盘，1992年4月12日7点30分，男性
 
+> 请帮我起一个奇门遁甲时盘，2024年6月21日10点
+
 ## 工具列表
 
-### 八字命理
+### 命理排盘
 
-| 工具 | 说明 |
-|------|------|
-| `bazi_basic` | 八字命盘排盘（四柱、藏干、十神、五行力量） |
-| `bazi_dayun` | 大运列表（十年一运） |
-| `bazi_liunian` | 流年列表（指定年份范围） |
-| `bazi_liuyue` | 流月列表（节气月，立春起算） |
-| `bazi_liuri` | 流日列表（指定月份内每日） |
+命理学基于出生时间推算人生运势，属于「命」的范畴。
 
-### 紫微斗数
+#### 八字命理
 
-| 工具 | 说明 |
-|------|------|
-| `ziwei_basic` | 紫微命盘排盘（十二宫、主星、辅星、四化） |
-| `ziwei_daxian` | 大限列表（十年一限） |
-| `ziwei_xiaoxian` | 小限列表（每年一宫） |
-| `ziwei_liunian` | 流年列表（指定年份范围） |
-| `ziwei_liuyue` | 流月列表（农历月） |
-| `ziwei_liuri` | 流日列表（农历日） |
+| 工具           | 说明                                       |
+| -------------- | ------------------------------------------ |
+| `bazi_basic`   | 八字命盘排盘（四柱、藏干、十神、五行力量） |
+| `bazi_dayun`   | 大运列表（十年一运）                       |
+| `bazi_liunian` | 流年列表（指定年份范围）                   |
+| `bazi_liuyue`  | 流月列表（节气月，立春起算）               |
+| `bazi_liuri`   | 流日列表（指定月份内每日）                 |
 
-## 输入参数
+#### 紫微斗数
+
+| 工具             | 说明                                     |
+| ---------------- | ---------------------------------------- |
+| `ziwei_basic`    | 紫微命盘排盘（十二宫、主星、辅星、四化） |
+| `ziwei_daxian`   | 大限列表（十年一限）                     |
+| `ziwei_xiaoxian` | 小限列表（每年一宫）                     |
+| `ziwei_liunian`  | 流年列表（指定年份范围）                 |
+| `ziwei_liuyue`   | 流月列表（农历月）                       |
+| `ziwei_liuri`    | 流日列表（农历日）                       |
+
+### 占卜起卦
+
+占卜术基于起卦时间或随机数推演卦象，属于「卜」的范畴。
+
+#### 六爻
+
+| 工具           | 说明                                                |
+| -------------- | --------------------------------------------------- |
+| `liuyao_basic` | 六爻排盘（本卦/变卦、纳甲、六亲、六神、世应、旬空） |
+
+六爻输入为六个爻值（自下而上）：
+- 6 = 老阴（动爻，阴变阳）
+- 7 = 少阳（静爻）
+- 8 = 少阴（静爻）
+- 9 = 老阳（动爻，阳变阴）
+
+#### 梅花易数
+
+| 工具           | 说明                                     |
+| -------------- | ---------------------------------------- |
+| `meihua_basic` | 梅花易数排盘（本卦/变卦/互卦、体用分析） |
 
-所有工具的基础输入：
+支持两种起卦方式：
+- 时间起卦：根据农历年月日时计算
+- 数字起卦：根据两个数字计算
+
+#### 大六壬
+
+| 工具             | 说明                                             |
+| ---------------- | ------------------------------------------------ |
+| `daliuren_basic` | 大六壬排盘（天地盘、四课、三传、十二天将、神煞） |
+
+大六壬为三式之首，需输入节气、农历月、日干支、时干支。
+
+#### 奇门遁甲
+
+| 工具            | 说明 |
+| --------------- | ---- |
+| `qimen_basic`   | 奇门遁甲排盘（九宫布局、三奇六仪、八门九星八神、格局判断） |
+| `qimen_yongshen`| 奇门用神分析（按事类选取用神，含主客、旺衰、空亡、入墓等） |
+| `qimen_zeri`    | 奇门择日（指定日期区间内筛选相对更佳的时机） |
+
+奇门遁甲为三式之一，盘式与规则主要参考张志春《神奇之门》，支持：时盘/日盘/月盘/年盘、转盘/飞盘、拆补法/茅山法。
+
+更多说明见：`docs/qimen-yongshen-guide.md`。
+
+## 输入参数
 
-| 参数 | 类型 | 必填 | 说明 |
-|------|------|------|------|
-| year | number | ✓ | 出生年份（1900-2100） |
-| month | number | ✓ | 出生月份（1-12） |
-| day | number | ✓ | 出生日期（1-31） |
-| hour | number | ✓ | 出生时辰（0-23） |
-| minute | number | | 出生分钟（0-59），默认 0 |
-| gender | string | ✓ | `male` / `female` |
-| longitude | number | | 出生地经度，用于真太阳时校正 |
+### 命理工具（八字/紫微）
+
+| 参数      | 类型    | 必填 | 说明                         |
+| --------- | ------- | ---- | ---------------------------- |
+| year      | number  | ✓    | 出生年份（1900-2100）        |
+| month     | number  | ✓    | 出生月份（1-12）             |
+| day       | number  | ✓    | 出生日期（1-31）             |
+| hour      | number  | ✓    | 出生时辰（0-23）             |
+| minute    | number  |      | 出生分钟（0-59），默认 0     |
+| gender    | string  | ✓    | `male` / `female`            |
+| longitude | number  |      | 出生地经度，用于真太阳时校正 |
+| isLunar   | boolean |      | 是否为农历输入，默认 false   |
+
+### 占卜工具（六爻/梅花/大六壬）
+
+占卜工具使用起卦时间而非出生时间，具体参数请参考各工具说明。
+
+### 奇门遁甲工具
+
+| 参数         | 类型    | 必填 | 说明 |
+| ------------ | ------- | ---- | ---- |
+| year         | number  | ✓    | 起盘年份（1900-2100） |
+| month        | number  | ✓    | 起盘月份（1-12） |
+| day          | number  | ✓    | 起盘日期（1-31） |
+| hour         | number  | ✓    | 起盘时辰（0-23） |
+| minute       | number  |      | 分钟（0-59），默认 0 |
+| isLunar      | boolean |      | 是否为农历输入，默认 false |
+| panType      | string  |      | `时盘` / `日盘` / `月盘` / `年盘`，默认 `时盘` |
+| panStyle     | string  |      | `转盘` / `飞盘`，默认 `转盘` |
+| zhiRunMethod | string  |      | `chaibu`（拆补法）/ `maoshan`（茅山法），默认 `chaibu` |
 
 ## 月份基准说明
 
-| 系统 | 月份基准 | 日期基准 |
-|------|----------|----------|
-| 八字 | 节气月（立春起算） | 公历日 |
-| 紫微 | 农历月（初一起算） | 农历日 |
+| 系统 | 月份基准           | 日期基准 |
+| ---- | ------------------ | -------- |
+| 八字 | 节气月（立春起算） | 公历日   |
+| 紫微 | 农历月（初一起算） | 农历日   |
 
 ## 开发
 
@@ -100,18 +171,21 @@ npm run dev  # 监听变化
 
 ## 依赖
 
-| 库 | 用途 |
-|------|------|
-| `@modelcontextprotocol/sdk` | MCP 协议实现 |
-| `lunar-javascript` | 农历/公历转换 |
-| `iztro` | 紫微斗数计算引擎 |
-| `zod` | 输入参数校验 |
+| 库                          | 用途             |
+| --------------------------- | ---------------- |
+| `@modelcontextprotocol/sdk` | MCP 协议实现     |
+| `lunar-javascript`          | 农历/公历转换    |
+| `iztro`                     | 紫微斗数计算引擎 |
+| `zod`                       | 输入参数校验     |
 
 ## 路线图
 
 - [x] 八字基础排盘与时运列表
 - [x] 紫微基础排盘与时运列表
-- [ ] 大六壬、六爻等其他术数系统
+- [x] 六爻排盘
+- [x] 梅花易数排盘
+- [x] 大六壬排盘
+- [x] 奇门遁甲排盘
 
 ## 许可证
 

package/dist/core/bazi/types.d.ts

@@ -69,7 +69,6 @@ export interface BaziCoreInput {
     minute?: number;
     gender?: 'male' | 'female';
     isLunar?: boolean;
-    timezone?: string;
     longitude?: number;
 }
 export interface BaziCoreResult {

package/dist/core/bazi/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/bazi/types.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/core/bazi/types.ts"],"names":[],"mappings":"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"}

package/dist/core/qimen/FlyingRule.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 洛书飞宫规则
+ * Luoshu flying rules for nine-palace calculations
+ */
+import type { GongWei } from './types';
+/**
+ * 洛书飞布顺序 (顺飞) - 8宫版本（不含中宫）
+ * 从任意宫开始，按此顺序飞布
+ * 1(坎) -> 8(艮) -> 3(震) -> 4(巽) -> 9(离) -> 2(坤) -> 7(兑) -> 6(乾)
+ */
+export declare const LUOSHU_ORDER: GongWei[];
+/**
+ * 洛书飞布顺序 (顺飞) - 9宫版本（含中宫）
+ * 用于三奇六仪天盘飞布
+ * 1(坎) -> 8(艮) -> 3(震) -> 4(巽) -> 5(中) -> 9(离) -> 2(坤) -> 7(兑) -> 6(乾)
+ */
+export declare const LUOSHU_ORDER_9: GongWei[];
+/**
+ * 中宫寄宫 (天禽寄坤二)
+ */
+export declare const ZHONG_GONG_JI: GongWei;
+/**
+ * 根据宫位获取飞布顺序中的索引
+ * @param gong 宫位 (1-9)
+ * @returns 索引 (0-7)，中宫返回 -1
+ */
+export declare function getLuoShuIndex(gong: GongWei): number;
+/**
+ * 根据索引获取飞布宫位
+ * @param index 索引（可以超过7，会自动取模）
+ * @returns 宫位
+ */
+export declare function getLuoShuGong(index: number): GongWei;
+/**
+ * 根据宫位获取9宫飞布顺序中的索引
+ * @param gong 宫位 (1-9)
+ * @returns 索引 (0-8)
+ */
+export declare function getLuoShuIndex9(gong: GongWei): number;
+/**
+ * 根据索引获取9宫飞布宫位
+ * @param index 索引（可以超过8，会自动取模）
+ * @returns 宫位
+ */
+export declare function getLuoShuGong9(index: number): GongWei;
+/**
+ * 顺飞：从某宫开始顺时针飞布
+ * @param startGong 起始宫位
+ * @param steps 步数
+ * @returns 目标宫位
+ */
+export declare function flyForward(startGong: GongWei, steps: number): GongWei;
+/**
+ * 逆飞：从某宫开始逆时针飞布
+ * @param startGong 起始宫位
+ * @param steps 步数
+ * @returns 目标宫位
+ */
+export declare function flyBackward(startGong: GongWei, steps: number): GongWei;
+//# sourceMappingURL=FlyingRule.d.ts.map

package/dist/core/qimen/FlyingRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlyingRule.d.ts","sourceRoot":"","sources":["../../../src/core/qimen/FlyingRule.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;;GAIG;AACH,eAAO,MAAM,YAAY,EAAE,OAAO,EAA6B,CAAC;AAEhE;;;;GAIG;AACH,eAAO,MAAM,cAAc,EAAE,OAAO,EAAgC,CAAC;AAErE;;GAEG;AACH,eAAO,MAAM,aAAa,EAAE,OAAW,CAAC;AAExC;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGpD;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAErD;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGrD;AAED;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAOrE;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAOtE"}

package/dist/core/qimen/FlyingRule.js

@@ -0,0 +1,94 @@
+"use strict";
+/**
+ * 洛书飞宫规则
+ * Luoshu flying rules for nine-palace calculations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ZHONG_GONG_JI = exports.LUOSHU_ORDER_9 = exports.LUOSHU_ORDER = void 0;
+exports.getLuoShuIndex = getLuoShuIndex;
+exports.getLuoShuGong = getLuoShuGong;
+exports.getLuoShuIndex9 = getLuoShuIndex9;
+exports.getLuoShuGong9 = getLuoShuGong9;
+exports.flyForward = flyForward;
+exports.flyBackward = flyBackward;
+/**
+ * 洛书飞布顺序 (顺飞) - 8宫版本（不含中宫）
+ * 从任意宫开始，按此顺序飞布
+ * 1(坎) -> 8(艮) -> 3(震) -> 4(巽) -> 9(离) -> 2(坤) -> 7(兑) -> 6(乾)
+ */
+exports.LUOSHU_ORDER = [1, 8, 3, 4, 9, 2, 7, 6];
+/**
+ * 洛书飞布顺序 (顺飞) - 9宫版本（含中宫）
+ * 用于三奇六仪天盘飞布
+ * 1(坎) -> 8(艮) -> 3(震) -> 4(巽) -> 5(中) -> 9(离) -> 2(坤) -> 7(兑) -> 6(乾)
+ */
+exports.LUOSHU_ORDER_9 = [1, 8, 3, 4, 5, 9, 2, 7, 6];
+/**
+ * 中宫寄宫 (天禽寄坤二)
+ */
+exports.ZHONG_GONG_JI = 2;
+/**
+ * 根据宫位获取飞布顺序中的索引
+ * @param gong 宫位 (1-9)
+ * @returns 索引 (0-7)，中宫返回 -1
+ */
+function getLuoShuIndex(gong) {
+    if (gong === 5)
+        return -1; // 中宫不在飞布顺序中
+    return exports.LUOSHU_ORDER.indexOf(gong);
+}
+/**
+ * 根据索引获取飞布宫位
+ * @param index 索引（可以超过7，会自动取模）
+ * @returns 宫位
+ */
+function getLuoShuGong(index) {
+    const normalizedIndex = ((index % 8) + 8) % 8;
+    return exports.LUOSHU_ORDER[normalizedIndex];
+}
+/**
+ * 根据宫位获取9宫飞布顺序中的索引
+ * @param gong 宫位 (1-9)
+ * @returns 索引 (0-8)
+ */
+function getLuoShuIndex9(gong) {
+    return exports.LUOSHU_ORDER_9.indexOf(gong);
+}
+/**
+ * 根据索引获取9宫飞布宫位
+ * @param index 索引（可以超过8，会自动取模）
+ * @returns 宫位
+ */
+function getLuoShuGong9(index) {
+    const normalizedIndex = ((index % 9) + 9) % 9;
+    return exports.LUOSHU_ORDER_9[normalizedIndex];
+}
+/**
+ * 顺飞：从某宫开始顺时针飞布
+ * @param startGong 起始宫位
+ * @param steps 步数
+ * @returns 目标宫位
+ */
+function flyForward(startGong, steps) {
+    let actualStart = startGong;
+    if (actualStart === 5) {
+        actualStart = exports.ZHONG_GONG_JI; // 中宫寄坤二
+    }
+    const startIdx = getLuoShuIndex(actualStart);
+    return getLuoShuGong(startIdx + steps);
+}
+/**
+ * 逆飞：从某宫开始逆时针飞布
+ * @param startGong 起始宫位
+ * @param steps 步数
+ * @returns 目标宫位
+ */
+function flyBackward(startGong, steps) {
+    let actualStart = startGong;
+    if (actualStart === 5) {
+        actualStart = exports.ZHONG_GONG_JI; // 中宫寄坤二
+    }
+    const startIdx = getLuoShuIndex(actualStart);
+    return getLuoShuGong(startIdx - steps);
+}
+//# sourceMappingURL=FlyingRule.js.map

package/dist/core/qimen/FlyingRule.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FlyingRule.js","sourceRoot":"","sources":["../../../src/core/qimen/FlyingRule.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AA4BH,wCAGC;AAOD,sCAGC;AAOD,0CAEC;AAOD,wCAGC;AAQD,gCAOC;AAQD,kCAOC;AAtFD;;;;GAIG;AACU,QAAA,YAAY,GAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAEhE;;;;GAIG;AACU,QAAA,cAAc,GAAc,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC;AAErE;;GAEG;AACU,QAAA,aAAa,GAAY,CAAC,CAAC;AAExC;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAa;IAC1C,IAAI,IAAI,KAAK,CAAC;QAAE,OAAO,CAAC,CAAC,CAAC,CAAC,YAAY;IACvC,OAAO,oBAAY,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACpC,CAAC;AAED;;;;GAIG;AACH,SAAgB,aAAa,CAAC,KAAa;IACzC,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,oBAAY,CAAC,eAAe,CAAC,CAAC;AACvC,CAAC;AAED;;;;GAIG;AACH,SAAgB,eAAe,CAAC,IAAa;IAC3C,OAAO,sBAAc,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACtC,CAAC;AAED;;;;GAIG;AACH,SAAgB,cAAc,CAAC,KAAa;IAC1C,MAAM,eAAe,GAAG,CAAC,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;IAC9C,OAAO,sBAAc,CAAC,eAAe,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,SAAkB,EAAE,KAAa;IAC1D,IAAI,WAAW,GAAG,SAAS,CAAC;IAC5B,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,WAAW,GAAG,qBAAa,CAAC,CAAC,QAAQ;IACvC,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,aAAa,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC;AACzC,CAAC;AAED;;;;;GAKG;AACH,SAAgB,WAAW,CAAC,SAAkB,EAAE,KAAa;IAC3D,IAAI,WAAW,GAAG,SAAS,CAAC;IAC5B,IAAI,WAAW,KAAK,CAAC,EAAE,CAAC;QACtB,WAAW,GAAG,qBAAa,CAAC,CAAC,QAAQ;IACvC,CAAC;IACD,MAAM,QAAQ,GAAG,cAAc,CAAC,WAAW,CAAC,CAAC;IAC7C,OAAO,aAAa,CAAC,QAAQ,GAAG,KAAK,CAAC,CAAC;AACzC,CAAC"}

package/dist/core/qimen/GongMapping.d.ts

@@ -0,0 +1,29 @@
+/**
+ * 九宫映射常量
+ * Gong (palace) mapping constants for Qimen calculations
+ */
+import type { GongWei, DiZhi, WuXing, TianGan } from './types';
+/**
+ * 九宫名称 (洛书顺序)
+ * 1-坎、2-坤、3-震、4-巽、5-中、6-乾、7-兑、8-艮、9-离
+ */
+export declare const GONG_NAMES: Record<GongWei, string>;
+/**
+ * 九宫五行
+ */
+export declare const GONG_WUXING: Record<GongWei, WuXing>;
+/**
+ * 地支 -> 宫位映射
+ */
+export declare const DI_ZHI_GONG: Record<DiZhi, GongWei>;
+/**
+ * 宫位冲对映射表
+ * 坎(1)↔离(9), 震(3)↔兑(7), 巽(4)↔乾(6), 坤(2)↔艮(8)
+ */
+export declare const CHONG_GONG_MAP: Record<GongWei, GongWei>;
+/**
+ * 天干五合映射表（奇仪相合）
+ * 甲己合不在此表中，因为甲遁于六仪，不会出现在盘面上
+ */
+export declare const GAN_HE_MAP: Partial<Record<TianGan, TianGan>>;
+//# sourceMappingURL=GongMapping.d.ts.map

package/dist/core/qimen/GongMapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GongMapping.d.ts","sourceRoot":"","sources":["../../../src/core/qimen/GongMapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAE/D;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAU9C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,OAAO,EAAE,MAAM,CAU/C,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,EAAE,MAAM,CAAC,KAAK,EAAE,OAAO,CAa9C,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,OAAO,CAUnD,CAAC;AAEF;;;GAGG;AACH,eAAO,MAAM,UAAU,EAAE,OAAO,CAAC,MAAM,CAAC,OAAO,EAAE,OAAO,CAAC,CASxD,CAAC"}

package/dist/core/qimen/GongMapping.js

@@ -0,0 +1,83 @@
+"use strict";
+/**
+ * 九宫映射常量
+ * Gong (palace) mapping constants for Qimen calculations
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.GAN_HE_MAP = exports.CHONG_GONG_MAP = exports.DI_ZHI_GONG = exports.GONG_WUXING = exports.GONG_NAMES = void 0;
+/**
+ * 九宫名称 (洛书顺序)
+ * 1-坎、2-坤、3-震、4-巽、5-中、6-乾、7-兑、8-艮、9-离
+ */
+exports.GONG_NAMES = {
+    1: '坎',
+    2: '坤',
+    3: '震',
+    4: '巽',
+    5: '中',
+    6: '乾',
+    7: '兑',
+    8: '艮',
+    9: '离',
+};
+/**
+ * 九宫五行
+ */
+exports.GONG_WUXING = {
+    1: '水', // 坎
+    2: '土', // 坤
+    3: '木', // 震
+    4: '木', // 巽
+    5: '土', // 中
+    6: '金', // 乾
+    7: '金', // 兑
+    8: '土', // 艮
+    9: '火', // 离
+};
+/**
+ * 地支 -> 宫位映射
+ */
+exports.DI_ZHI_GONG = {
+    '子': 1,
+    '丑': 8,
+    '寅': 8,
+    '卯': 3,
+    '辰': 4,
+    '巳': 4,
+    '午': 9,
+    '未': 2,
+    '申': 2,
+    '酉': 7,
+    '戌': 6,
+    '亥': 6,
+};
+/**
+ * 宫位冲对映射表
+ * 坎(1)↔离(9), 震(3)↔兑(7), 巽(4)↔乾(6), 坤(2)↔艮(8)
+ */
+exports.CHONG_GONG_MAP = {
+    1: 9, // 坎 ↔ 离
+    9: 1,
+    3: 7, // 震 ↔ 兑
+    7: 3,
+    4: 6, // 巽 ↔ 乾
+    6: 4,
+    2: 8, // 坤 ↔ 艮
+    8: 2,
+    5: 5, // 中宫无对冲
+};
+/**
+ * 天干五合映射表（奇仪相合）
+ * 甲己合不在此表中，因为甲遁于六仪，不会出现在盘面上
+ */
+exports.GAN_HE_MAP = {
+    '乙': '庚',
+    '庚': '乙',
+    '丙': '辛',
+    '辛': '丙',
+    '丁': '壬',
+    '壬': '丁',
+    '戊': '癸',
+    '癸': '戊',
+};
+//# sourceMappingURL=GongMapping.js.map

package/dist/core/qimen/GongMapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"GongMapping.js","sourceRoot":"","sources":["../../../src/core/qimen/GongMapping.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;AAIH;;;GAGG;AACU,QAAA,UAAU,GAA4B;IACjD,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;IACN,CAAC,EAAE,GAAG;CACP,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAA4B;IAClD,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;IACZ,CAAC,EAAE,GAAG,EAAE,IAAI;CACb,CAAC;AAEF;;GAEG;AACU,QAAA,WAAW,GAA2B;IACjD,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;IACN,GAAG,EAAE,CAAC;CACP,CAAC;AAEF;;;GAGG;AACU,QAAA,cAAc,GAA6B;IACtD,CAAC,EAAE,CAAC,EAAE,QAAQ;IACd,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,QAAQ;IACd,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,QAAQ;IACd,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,QAAQ;IACd,CAAC,EAAE,CAAC;IACJ,CAAC,EAAE,CAAC,EAAE,QAAQ;CACf,CAAC;AAEF;;;GAGG;AACU,QAAA,UAAU,GAAsC;IAC3D,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;IACR,GAAG,EAAE,GAAG;CACT,CAAC"}

package/dist/core/qimen/RotatingRule.d.ts

@@ -0,0 +1,76 @@
+/**
+ * 转盘式旋转规则
+ * Rotating rules for Zhuan Pan style Qimen calculations
+ *
+ * 转盘式与飞盘式的区别：
+ * - 飞盘式：按洛书数字顺序飞布 (1→8→3→4→9→2→7→6)
+ * - 转盘式：按物理方向旋转（九宫格上顺/逆时针）
+ *
+ * 九宫格物理布局：
+ * ```
+ * 巽4  离9  坤2
+ * 震3  中5  兑7
+ * 艮8  坎1  乾6
+ * ```
+ *
+ * 物理顺时针顺序（从坎1开始）：
+ * 1(坎) → 8(艮) → 3(震) → 4(巽) → 9(离) → 2(坤) → 7(兑) → 6(乾) → 回到1
+ *
+ * 参考：《神奇之门》（张志春著）
+ */
+import type { GongWei } from './types';
+/**
+ * 物理顺时针旋转顺序 - 8宫版本（不含中宫）
+ * 从坎1开始，顺时针：坎→艮→震→巽→离→坤→兑→乾
+ */
+export declare const PHYSICAL_CLOCKWISE_ORDER: GongWei[];
+/**
+ * 物理逆时针旋转顺序 - 8宫版本（不含中宫）
+ * 从坎1开始，逆时针：坎→乾→兑→坤→离→巽→震→艮
+ */
+export declare const PHYSICAL_COUNTER_CLOCKWISE_ORDER: GongWei[];
+/**
+ * 中宫寄宫 (天禽寄坤二)
+ */
+export declare const ZHONG_GONG_JI_ZHUAN: GongWei;
+/**
+ * 根据宫位获取物理顺时针顺序中的索引
+ * @param gong 宫位 (1-9)
+ * @returns 索引 (0-7)，中宫返回 -1
+ */
+export declare function getPhysicalClockwiseIndex(gong: GongWei): number;
+/**
+ * 根据索引获取物理顺时针方向的宫位
+ * @param index 索引（可以超过7，会自动取模）
+ * @returns 宫位
+ */
+export declare function getPhysicalClockwiseGong(index: number): GongWei;
+/**
+ * 根据宫位获取物理逆时针顺序中的索引
+ * @param gong 宫位 (1-9)
+ * @returns 索引 (0-7)，中宫返回 -1
+ */
+export declare function getPhysicalCounterClockwiseIndex(gong: GongWei): number;
+/**
+ * 根据索引获取物理逆时针方向的宫位
+ * @param index 索引（可以超过7，会自动取模）
+ * @returns 宫位
+ */
+export declare function getPhysicalCounterClockwiseGong(index: number): GongWei;
+/**
+ * 转盘式旋转：从某宫开始旋转指定步数
+ * @param startGong 起始宫位
+ * @param steps 步数
+ * @param isYang 是否阳遁（阳遁顺时针，阴遁逆时针）
+ * @returns 目标宫位
+ */
+export declare function rotate(startGong: GongWei, steps: number, isYang: boolean): GongWei;
+/**
+ * 计算两宫之间的旋转步数
+ * @param fromGong 起始宫位
+ * @param toGong 目标宫位
+ * @param isYang 是否阳遁
+ * @returns 步数
+ */
+export declare function getRotationSteps(fromGong: GongWei, toGong: GongWei, isYang: boolean): number;
+//# sourceMappingURL=RotatingRule.d.ts.map

package/dist/core/qimen/RotatingRule.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RotatingRule.d.ts","sourceRoot":"","sources":["../../../src/core/qimen/RotatingRule.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,SAAS,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,wBAAwB,EAAE,OAAO,EAA6B,CAAC;AAE5E;;;GAGG;AACH,eAAO,MAAM,gCAAgC,EAAE,OAAO,EAA6B,CAAC;AAEpF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,OAAW,CAAC;AAE9C;;;;GAIG;AACH,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAG/D;AAED;;;;GAIG;AACH,wBAAgB,gCAAgC,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAGtE;AAED;;;;GAIG;AACH,wBAAgB,+BAA+B,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGtE;AAED;;;;;;GAMG;AACH,wBAAgB,MAAM,CAAC,SAAS,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO,CAelF;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,MAAM,CAa5F"}