mingpan 0.1.3 → 0.1.5

package/dist/tools/divinationTools.js

@@ -0,0 +1,205 @@
+"use strict";
+/**
+ * 占卜類 MCP 工具：六爻、梅花易數、大六壬
+ *
+ * 設計原則：占卜工具的時間參數為「起卦/起課時間」，
+ * 節氣、干支等曆法量一律由 MCP 自動推得（LLM 手推干支極易出錯）。
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerDivinationTools = registerDivinationTools;
+const zod_1 = require("zod");
+const LiuyaoService_1 = require("../services/liuyao/LiuyaoService");
+const liuyaoTextRenderer_1 = require("../output/liuyaoTextRenderer");
+const MeihuaService_1 = require("../services/meihua/MeihuaService");
+const meihuaTextRenderer_1 = require("../output/meihuaTextRenderer");
+const DaliurenService_1 = require("../services/daliuren/DaliurenService");
+const daliurenTextRenderer_1 = require("../output/daliurenTextRenderer");
+const schemas_1 = require("./schemas");
+const liuyaoService = new LiuyaoService_1.LiuyaoService();
+const meihuaService = new MeihuaService_1.MeihuaService();
+const yaoValue = zod_1.z.union([zod_1.z.literal(6), zod_1.z.literal(7), zod_1.z.literal(8), zod_1.z.literal(9)]);
+function registerDivinationTools(server) {
+    // ============= 六爻 =============
+    server.registerTool('liuyao_basic', {
+        title: '六爻排盤',
+        description: `六爻排盤（基礎排盤）。
+
+輸入六個爻值和起卦時間，返回完整的六爻盤面：
+- 本卦/變卦（含卦名、卦宮、五行）
+- 六爻納甲（每爻地支及五行）
+- 六親（父母/兄弟/子孫/妻財/官鬼）
+- 六神（青龍/朱雀/勾陳/螣蛇/白虎/玄武）
+- 世應位置
+- 動爻標註
+- 日干支、月建、旬空
+
+爻值說明：
+- 6 = 老陰（動爻，陰變陽）
+- 7 = 少陽（靜爻，陽）
+- 8 = 少陰（靜爻，陰）
+- 9 = 老陽（動爻，陽變陰）
+
+輸入順序：自下而上（初爻到上爻）
+起卦時間默認北京時間，可提供 timezone 换算。
+
+輸出為 Markdown 格式，便於 AI 分析解讀。`,
+        inputSchema: {
+            yaoValues: zod_1.z.tuple([yaoValue, yaoValue, yaoValue, yaoValue, yaoValue, yaoValue])
+                .describe('六個爻值（自下而上，初爻到上爻）。6=老陰(動), 7=少陽(靜), 8=少陰(靜), 9=老陽(動)'),
+            ...schemas_1.birthTimeFields,
+        },
+    }, async (args) => (0, schemas_1.textResult)('liuyao_basic', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const result = liuyaoService.calculate({
+            yaoValues: args.yaoValues,
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            isLunar: false,
+        });
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, liuyaoTextRenderer_1.renderLiuyaoText)(result);
+    }));
+    // ============= 梅花易數 =============
+    server.registerTool('meihua_basic', {
+        title: '梅花易數排盤',
+        description: `梅花易數排盤（基礎排盤）。
+
+支持兩種起卦方式：
+1. 時間起卦（method='time'）：根據農曆年月日時起卦
+2. 數字起卦（method='number'）：根據兩個數字起卦
+
+返回完整的梅花盤面：
+- 本卦/變卦/互卦
+- 上卦/下卦（含卦象、五行）
+- 動爻位置
+- 體用分析（體卦、用卦、五行生剋關係）
+- 起卦數據詳情
+
+時間起卦算法（農曆）：
+- 上卦 = (年支序數 + 月 + 日) % 8
+- 下卦 = (年支序數 + 月 + 日 + 時辰序數) % 8
+- 動爻 = (年支序數 + 月 + 日 + 時辰序數) % 6
+
+輸出為 Markdown 格式，便於 AI 分析解讀。`,
+        inputSchema: {
+            method: zod_1.z.enum(['time', 'number']).describe("起卦方式：time=時間起卦，number=數字起卦"),
+            year: schemas_1.yearField.optional().describe('起卦年份（公曆，time 模式必填）'),
+            month: schemas_1.monthField.optional().describe('起卦月份（1-12，time 模式必填）'),
+            day: schemas_1.dayField.optional().describe('起卦日期（1-31，time 模式必填）'),
+            hour: schemas_1.hourField.optional().describe('起卦時辰（0-23，time 模式必填）'),
+            isLunar: zod_1.z.boolean().optional().default(false).describe('輸入是否為農曆，默認 false'),
+            timezone: zod_1.z.string().optional().describe('IANA 時區名（time 模式，默認北京時間）'),
+            upperNumber: zod_1.z.number().int().min(1).optional().describe('上卦數（number 模式必填）'),
+            lowerNumber: zod_1.z.number().int().min(1).optional().describe('下卦數（number 模式必填）'),
+            yaoNumber: zod_1.z.number().int().min(1).optional().describe('動爻數（可選，默認用上下卦數之和）'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('meihua_basic', async () => {
+        let year = args.year;
+        let month = args.month;
+        let day = args.day;
+        let hour = args.hour;
+        let isLunar = args.isLunar;
+        // 時間模式：入口層完成時區歸一化後再交給服務層
+        if (args.method === 'time' && year !== undefined && month !== undefined && day !== undefined && hour !== undefined) {
+            const { normalized } = (0, schemas_1.normalizeBirthInfo)({
+                year, month, day, hour,
+                isLunar,
+                timezone: args.timezone,
+            });
+            year = normalized.year;
+            month = normalized.month;
+            day = normalized.day;
+            hour = normalized.hour;
+            isLunar = false;
+        }
+        const result = meihuaService.calculate({
+            method: args.method,
+            year,
+            month,
+            day,
+            hour,
+            isLunar,
+            upperNumber: args.upperNumber,
+            lowerNumber: args.lowerNumber,
+            yaoNumber: args.yaoNumber,
+        });
+        return (0, meihuaTextRenderer_1.renderMeihuaText)(result);
+    }));
+    // ============= 大六壬 =============
+    server.registerTool('daliuren_basic', {
+        title: '大六壬排盤',
+        description: `大六壬排盤（基礎排盤）。
+
+大六壬是中國古老三大占卜術之一，與奇門遁甲、太乙神數並稱三式。
+
+【推薦用法】直接輸入公曆起課時間，系統自動推得節氣、月將、日干支、時干支：
+- year/month/day/hour（+ 可選 minute、timezone、isLunar）
+
+【專家模式】也可顯式指定曆法量（一般無需使用）：
+- jieqi：節氣（如：立春、驚蟄，簡繁均可）
+- dayGanZhi / hourGanZhi：完整干支（如：甲子、乙丑）
+
+返回完整的六壬盤面：
+- 天地盤（月將加時辰起盤）
+- 四課（日干支推演）
+- 三傳（九宗門推演：賊尅、比用、涉害、遙尅、昴星、別責、八專、伏吟、返吟）
+- 十二天將（貴人、螣蛇、朱雀、六合、勾陳、青龍、天空、白虎、太常、玄武、太陰、天后）
+- 格局判斷
+- 神煞（日馬、月馬、丁馬、華蓋、閃電）
+
+本工具只負責排盤，斷課解讀交給 Agent。
+
+輸出為 Markdown 格式，便於 AI 分析解讀。`,
+        inputSchema: {
+            // 推薦：時間輸入
+            year: schemas_1.yearField.optional().describe('起課年份（公曆，推薦用法）'),
+            month: schemas_1.monthField.optional().describe('起課月份（1-12）'),
+            day: schemas_1.dayField.optional().describe('起課日期（1-31）'),
+            hour: schemas_1.hourField.optional().describe('起課時辰（0-23）'),
+            minute: zod_1.z.number().int().min(0).max(59).optional().describe('分鐘（0-59），默認 0'),
+            isLunar: zod_1.z.boolean().optional().default(false).describe('輸入是否為農曆，默認 false'),
+            timezone: zod_1.z.string().optional().describe('IANA 時區名（默認北京時間）'),
+            // 專家模式：顯式曆法量
+            jieqi: zod_1.z.string().optional().describe('【專家模式】節氣（如：立春、驚蟄，簡繁均可）'),
+            lunarMonth: zod_1.z.number().int().min(1).max(12).optional().describe('【專家模式】農曆月份（1-12）'),
+            dayGanZhi: zod_1.z.string().optional().describe('【專家模式】日干支（如：甲子、乙丑）'),
+            hourGanZhi: zod_1.z.string().optional().describe('【專家模式】時干支（如：甲子、乙丑）'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('daliuren_basic', async () => {
+        const daliurenService = new DaliurenService_1.DaliurenService();
+        // 推薦路徑：由時間自動推節氣/月將/干支
+        const hasTime = args.year !== undefined && args.month !== undefined && args.day !== undefined && args.hour !== undefined;
+        if (hasTime) {
+            const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)({
+                year: args.year,
+                month: args.month,
+                day: args.day,
+                hour: args.hour,
+                minute: args.minute,
+                isLunar: args.isLunar,
+                timezone: args.timezone,
+            });
+            const result = daliurenService.calculateFromTime({
+                year: normalized.year,
+                month: normalized.month,
+                day: normalized.day,
+                hour: normalized.hour,
+                minute: normalized.minute,
+            });
+            return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, daliurenTextRenderer_1.renderDaliurenText)(result);
+        }
+        // 專家模式：顯式曆法量
+        if (args.jieqi && args.lunarMonth !== undefined && args.dayGanZhi && args.hourGanZhi) {
+            const result = daliurenService.calculate({
+                jieqi: args.jieqi,
+                lunarMonth: args.lunarMonth,
+                dayGanZhi: args.dayGanZhi,
+                hourGanZhi: args.hourGanZhi,
+            });
+            return (0, daliurenTextRenderer_1.renderDaliurenText)(result);
+        }
+        throw new Error('輸入不完整：請提供起課時間（year/month/day/hour），或完整專家參數（jieqi + lunarMonth + dayGanZhi + hourGanZhi）');
+    }));
+}
+//# sourceMappingURL=divinationTools.js.map

package/dist/tools/divinationTools.js.map

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

package/dist/tools/qimenTools.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 奇門遁甲 MCP 工具
+ *
+ * 工具列表：
+ * - qimen_basic     基礎排盤（九宮布局、三奇六儀、八門九星八神、格局檢測）
+ * - qimen_yongshen  用神分析（按事類，僅確定性信息）
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerQimenTools(server: McpServer): void;
+//# sourceMappingURL=qimenTools.d.ts.map

package/dist/tools/qimenTools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qimenTools.d.ts","sourceRoot":"","sources":["../../src/tools/qimenTools.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAwBzE,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,SAAS,GAAG,IAAI,CAmH1D"}

package/dist/tools/qimenTools.js

@@ -0,0 +1,132 @@
+"use strict";
+/**
+ * 奇門遁甲 MCP 工具
+ *
+ * 工具列表：
+ * - qimen_basic     基礎排盤（九宮布局、三奇六儀、八門九星八神、格局檢測）
+ * - qimen_yongshen  用神分析（按事類，僅確定性信息）
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.registerQimenTools = registerQimenTools;
+const zod_1 = require("zod");
+const QimenService_1 = require("../services/qimen/QimenService");
+const qimenTextRenderer_1 = require("../output/qimenTextRenderer");
+const schemas_1 = require("./schemas");
+const SHI_LEI_VALUES = [
+    '求财', '婚姻', '疾病', '出行', '诉讼', '考试', '工作',
+    '失物', '置业', '求官', '孕产', '寻人', '合作', '其他',
+];
+const panTypeField = zod_1.z.enum(['时盘', '日盘', '月盘', '年盘']).optional().default('时盘')
+    .describe('盤類型：时盘（默認）、日盘、月盘、年盘');
+const panStyleField = zod_1.z.enum(['转盘', '飞盘']).optional().default('转盘')
+    .describe('盤式：转盘（默認，遵循《神奇之門》）或飞盘');
+const zhiRunMethodField = zod_1.z.enum(['chaibu', 'maoshan']).optional().default('chaibu')
+    .describe('置閏方法：chaibu=拆補法（默認），maoshan=茅山法');
+const shiLeiField = zod_1.z.enum(SHI_LEI_VALUES).describe('事類（用於確定用神）');
+function registerQimenTools(server) {
+    server.registerTool('qimen_basic', {
+        title: '奇門遁甲排盤',
+        description: `奇門遁甲排盤（基礎排盤）。
+
+奇門遁甲是中國古代三式之一，與大六壬、太乙神數並稱，用於預測和決策。
+
+輸入時間信息，返回完整的奇門盤面：
+- 陰陽遁和局數（根據節氣判定）
+- 九宮布局（地盤干、天盤干）
+- 八門飛布（休、生、傷、杜、景、死、驚、開）
+- 九星飛布（天蓬、天芮、天沖、天輔、天禽、天心、天柱、天任、天英）
+- 八神排布（值符、螣蛇、太陰、六合、白虎、玄武、九地、九天）
+- 旬首信息（符頭、值符星、值使門、空亡）
+- 日干/時干落宮
+- 格局判斷（吉格/凶格約20-30種）
+
+支持選項：
+- 盤類型：時盤（默認）、日盤、月盤、年盤
+- 盤式：轉盤（默認，遵循《神奇之門》）或飛盤
+- 置閏法：拆補法（默認）或茅山法
+
+盤類型說明：
+- 時盤：以時辰為主導，適用於即時預測
+- 日盤：以日干支為主導，適用於當日吉凶
+- 月盤：以月干支為主導，適用於月度運勢
+- 年盤：以年干支為主導，適用於年度規劃
+
+盤式說明：
+- 轉盤：天盤、八門、九星按物理方向旋轉（《神奇之門》派）
+- 飛盤：天盤、八門、九星按宮位數字飛布（傳統飛宮法）
+
+輸出為 Markdown 格式，含 ASCII 九宮格，便於 AI 分析解讀。`,
+        inputSchema: {
+            ...schemas_1.birthTimeFields,
+            panType: panTypeField,
+            panStyle: panStyleField,
+            zhiRunMethod: zhiRunMethodField,
+        },
+    }, async (args) => (0, schemas_1.textResult)('qimen_basic', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const qimenService = new QimenService_1.QimenService();
+        const result = qimenService.calculate({
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+            isLunar: false,
+            panType: args.panType,
+            panStyle: args.panStyle,
+            zhiRunMethod: args.zhiRunMethod,
+        });
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, qimenTextRenderer_1.renderQimenText)(result);
+    }));
+    server.registerTool('qimen_yongshen', {
+        title: '奇門用神分析',
+        description: `奇門遁甲用神分析。
+
+在基礎排盤基礎上，根據事類選取用神並分析：
+
+**支持 14 種事類**：
+求財、婚姻、疾病、出行、訴訟、考試、工作、失物、置業、求官、孕產、尋人、合作、其他
+
+**分析內容**（僅確定性事實）：
+- 主用神/輔用神識別及落宮（依《神奇之門》通行用神表）
+- 用神旺相休囚死狀態（依月令）
+- 用神空亡、入墓、擊刑檢測
+- 與日干生克關係
+- 主客落宮與生克關係（涉及雙方的事類）
+- 年命落宮（可選）
+
+定位說明：用神吉凶、格局利弊等判斷無權威統一口徑，
+請由 AI 結合盤面（含格局檢測）自行分析。
+
+輸出為結構化 Markdown，便於 AI 斷卦分析。`,
+        inputSchema: {
+            ...schemas_1.birthTimeFields,
+            panType: panTypeField,
+            panStyle: panStyleField,
+            zhiRunMethod: zhiRunMethodField,
+            shiLei: shiLeiField,
+            nianGan: zod_1.z.enum(['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'])
+                .optional().describe('年干（用於年命分析，可選）'),
+            includeShenSha: zod_1.z.boolean().optional().default(true).describe('是否包含神煞分析'),
+        },
+    }, async (args) => (0, schemas_1.textResult)('qimen_yongshen', async () => {
+        const { normalized, sourceTimezone } = (0, schemas_1.normalizeBirthInfo)(args);
+        const qimenService = new QimenService_1.QimenService();
+        const result = qimenService.calculateWithYongShen({
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+            isLunar: false,
+            panType: args.panType,
+            panStyle: args.panStyle,
+            zhiRunMethod: args.zhiRunMethod,
+        }, args.shiLei, {
+            nianGan: args.nianGan,
+            includeShenSha: args.includeShenSha,
+        });
+        return (0, schemas_1.timezoneNote)(sourceTimezone) + (0, qimenTextRenderer_1.renderQimenYongShenText)(result);
+    }));
+}
+//# sourceMappingURL=qimenTools.js.map

package/dist/tools/qimenTools.js.map

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

package/dist/tools/schemas.d.ts

@@ -0,0 +1,99 @@
+/**
+ * MCP 工具共享 Schema 與輔助函數
+ *
+ * 各領域工具模組（bazi/ziwei/liuyao/meihua/daliuren/qimen）復用此處的
+ * 字段級 Zod schema 與出生信息歸一化邏輯。
+ *
+ * 設計說明：
+ * - registerTool 的 inputSchema 為 ZodRawShape（字段名 → Zod schema），
+ *   因此此處導出字段級 schema 而非 z.object
+ * - 時間歸一化（農曆轉公曆、時區換算）統一在入口層完成，
+ *   服務層只消費北京時間規範分量
+ */
+import { z } from 'zod';
+import type { CallToolResult } from '@modelcontextprotocol/sdk/types.js';
+export declare const yearField: z.ZodNumber;
+export declare const monthField: z.ZodNumber;
+export declare const dayField: z.ZodNumber;
+export declare const hourField: z.ZodNumber;
+export declare const minuteField: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+export declare const genderField: z.ZodEnum<{
+    male: "male";
+    female: "female";
+}>;
+export declare const longitudeField: z.ZodOptional<z.ZodNumber>;
+export declare const nameField: z.ZodOptional<z.ZodString>;
+export declare const isLunarField: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+export declare const timezoneField: z.ZodOptional<z.ZodString>;
+/** 出生/起卦時間字段（公曆或農曆，含可選時區） */
+export declare const birthTimeFields: {
+    year: z.ZodNumber;
+    month: z.ZodNumber;
+    day: z.ZodNumber;
+    hour: z.ZodNumber;
+    minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    isLunar: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timezone: z.ZodOptional<z.ZodString>;
+};
+/** 完整出生信息字段（含性別與可選經度/姓名） */
+export declare const baseBirthInfoFields: {
+    gender: z.ZodEnum<{
+        male: "male";
+        female: "female";
+    }>;
+    longitude: z.ZodOptional<z.ZodNumber>;
+    name: z.ZodOptional<z.ZodString>;
+    year: z.ZodNumber;
+    month: z.ZodNumber;
+    day: z.ZodNumber;
+    hour: z.ZodNumber;
+    minute: z.ZodDefault<z.ZodOptional<z.ZodNumber>>;
+    isLunar: z.ZodDefault<z.ZodOptional<z.ZodBoolean>>;
+    timezone: z.ZodOptional<z.ZodString>;
+};
+export interface NormalizableBirthInfo {
+    year: number;
+    month: number;
+    day: number;
+    hour: number;
+    minute?: number;
+    isLunar?: boolean;
+    timezone?: string;
+}
+export interface NormalizedBirthInfo<T> {
+    normalized: T;
+    /** 原始輸入是否為農曆 */
+    isLunarInput: boolean;
+    /** 發生時區換算時的來源時區 */
+    sourceTimezone?: string;
+}
+/**
+ * 歸一化出生信息：農曆→公曆、時區→北京時間
+ * 每個工具 handler 開頭調用，得到統一的北京時間分量
+ */
+export declare function normalizeBirthInfo<T extends NormalizableBirthInfo>(input: T): NormalizedBirthInfo<T>;
+/**
+ * 包裝工具回調：成功返回文本結果，異常返回 isError 結果
+ * （與協議錯誤區分，便於 LLM 看到可讀的失敗原因並自行修正參數）
+ */
+export declare function textResult(toolName: string, fn: () => Promise<string> | string): Promise<CallToolResult>;
+/** 時區換算提示（僅當發生換算時輸出，避免 Agent 對出生時間產生困惑） */
+export declare function timezoneNote(sourceTimezone?: string, isLunarInput?: boolean): string;
+/** 由公曆年推年干支（以 1984 甲子年為基準） */
+export declare function getYearStemBranch(year: number): {
+    stem: string;
+    branch: string;
+};
+/** 解析干支年輸入（"乙巳" 或公曆年數字） */
+export declare function parseGanzhiYear(input: string | number): {
+    year: number;
+    ganzhi: string;
+};
+/** 解析干支月輸入（"丙寅" 或月序數字 1-12，1=寅月） */
+export declare function parseGanzhiMonth(input: string | number): number;
+/** 五虎遁年起月：由公曆年與月序（1=寅月）推月干支 */
+export declare function getMonthStemBranch(year: number, monthNum: number): {
+    stem: string;
+    branch: string;
+};
+//# sourceMappingURL=schemas.d.ts.map

package/dist/tools/schemas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"schemas.d.ts","sourceRoot":"","sources":["../../src/tools/schemas.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oCAAoC,CAAC;AAOzE,eAAO,MAAM,SAAS,aAAiE,CAAC;AACxF,eAAO,MAAM,UAAU,aAAqD,CAAC;AAC7E,eAAO,MAAM,QAAQ,aAAqD,CAAC;AAC3E,eAAO,MAAM,SAAS,aAAqD,CAAC;AAC5E,eAAO,MAAM,WAAW,0CAAgF,CAAC;AACzG,eAAO,MAAM,WAAW;;;EAAoD,CAAC;AAC7E,eAAO,MAAM,cAAc,4BAAwE,CAAC;AACpG,eAAO,MAAM,SAAS,4BAA6C,CAAC;AAEpE,eAAO,MAAM,YAAY,2CAAmE,CAAC;AAE7F,eAAO,MAAM,aAAa,4BAEzB,CAAC;AAEF,6BAA6B;AAC7B,eAAO,MAAM,eAAe;;;;;;;;CAQ3B,CAAC;AAEF,4BAA4B;AAC5B,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;CAK/B,CAAC;AAMF,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,mBAAmB,CAAC,CAAC;IACpC,UAAU,EAAE,CAAC,CAAC;IACd,gBAAgB;IAChB,YAAY,EAAE,OAAO,CAAC;IACtB,mBAAmB;IACnB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,CAAC,SAAS,qBAAqB,EAAE,KAAK,EAAE,CAAC,GAAG,mBAAmB,CAAC,CAAC,CAAC,CAyBpG;AAWD;;;GAGG;AACH,wBAAsB,UAAU,CAC9B,QAAQ,EAAE,MAAM,EAChB,EAAE,EAAE,MAAM,OAAO,CAAC,MAAM,CAAC,GAAG,MAAM,GACjC,OAAO,CAAC,cAAc,CAAC,CAYzB;AAED,2CAA2C;AAC3C,wBAAgB,YAAY,CAAC,cAAc,CAAC,EAAE,MAAM,EAAE,YAAY,CAAC,EAAE,OAAO,GAAG,MAAM,CAGpF;AAUD,8BAA8B;AAC9B,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMhF;AAED,2BAA2B;AAC3B,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAcxF;AAED,oCAAoC;AACpC,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,CAO/D;AAED,+BAA+B;AAC/B,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAQnG"}

package/dist/tools/schemas.js

@@ -0,0 +1,163 @@
+"use strict";
+/**
+ * MCP 工具共享 Schema 與輔助函數
+ *
+ * 各領域工具模組（bazi/ziwei/liuyao/meihua/daliuren/qimen）復用此處的
+ * 字段級 Zod schema 與出生信息歸一化邏輯。
+ *
+ * 設計說明：
+ * - registerTool 的 inputSchema 為 ZodRawShape（字段名 → Zod schema），
+ *   因此此處導出字段級 schema 而非 z.object
+ * - 時間歸一化（農曆轉公曆、時區換算）統一在入口層完成，
+ *   服務層只消費北京時間規範分量
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.baseBirthInfoFields = exports.birthTimeFields = exports.timezoneField = exports.isLunarField = exports.nameField = exports.longitudeField = exports.genderField = exports.minuteField = exports.hourField = exports.dayField = exports.monthField = exports.yearField = void 0;
+exports.normalizeBirthInfo = normalizeBirthInfo;
+exports.textResult = textResult;
+exports.timezoneNote = timezoneNote;
+exports.getYearStemBranch = getYearStemBranch;
+exports.parseGanzhiYear = parseGanzhiYear;
+exports.parseGanzhiMonth = parseGanzhiMonth;
+exports.getMonthStemBranch = getMonthStemBranch;
+const zod_1 = require("zod");
+const timeNormalization_1 = require("../utils/timeNormalization");
+// ============================================
+// 共享字段 Schema
+// ============================================
+exports.yearField = zod_1.z.number().int().min(1900).max(2100).describe('公曆年 1900-2100');
+exports.monthField = zod_1.z.number().int().min(1).max(12).describe('月 1-12');
+exports.dayField = zod_1.z.number().int().min(1).max(31).describe('日 1-31');
+exports.hourField = zod_1.z.number().int().min(0).max(23).describe('時 0-23');
+exports.minuteField = zod_1.z.number().int().min(0).max(59).optional().default(0).describe('分 0-59，默認 0');
+exports.genderField = zod_1.z.enum(['male', 'female']).describe('性別（影響大運順逆）');
+exports.longitudeField = zod_1.z.number().min(-180).max(180).optional().describe('出生地經度（真太陽時校正，可選）');
+exports.nameField = zod_1.z.string().optional().describe('命主姓名（可選）');
+exports.isLunarField = zod_1.z.boolean().optional().default(false).describe('輸入日期是否為農曆，默認公曆');
+exports.timezoneField = zod_1.z.string().optional().describe('IANA 時區名（如 America/New_York）。默認北京時間；設置後輸入時間按此時區換算為北京時間排盤。農曆輸入時忽略');
+/** 出生/起卦時間字段（公曆或農曆，含可選時區） */
+exports.birthTimeFields = {
+    year: exports.yearField,
+    month: exports.monthField,
+    day: exports.dayField,
+    hour: exports.hourField,
+    minute: exports.minuteField,
+    isLunar: exports.isLunarField,
+    timezone: exports.timezoneField,
+};
+/** 完整出生信息字段（含性別與可選經度/姓名） */
+exports.baseBirthInfoFields = {
+    ...exports.birthTimeFields,
+    gender: exports.genderField,
+    longitude: exports.longitudeField,
+    name: exports.nameField,
+};
+/**
+ * 歸一化出生信息：農曆→公曆、時區→北京時間
+ * 每個工具 handler 開頭調用，得到統一的北京時間分量
+ */
+function normalizeBirthInfo(input) {
+    const normalized = (0, timeNormalization_1.normalizeBirthDateTime)({
+        year: input.year,
+        month: input.month,
+        day: input.day,
+        hour: input.hour,
+        minute: input.minute,
+        isLunar: input.isLunar,
+        timezone: input.timezone,
+    });
+    return {
+        normalized: {
+            ...input,
+            year: normalized.year,
+            month: normalized.month,
+            day: normalized.day,
+            hour: normalized.hour,
+            minute: normalized.minute,
+            isLunar: false, // 歸一化後一律為公曆（北京時間）
+            timezone: undefined,
+        },
+        isLunarInput: normalized.isLunarInput,
+        sourceTimezone: normalized.sourceTimezone,
+    };
+}
+// ============================================
+// 結果輔助
+// ============================================
+const logger_1 = require("../shared/logger");
+const wallTime_1 = require("../utils/wallTime");
+const logger = new logger_1.Logger('mingpan');
+/**
+ * 包裝工具回調：成功返回文本結果，異常返回 isError 結果
+ * （與協議錯誤區分，便於 LLM 看到可讀的失敗原因並自行修正參數）
+ */
+async function textResult(toolName, fn) {
+    try {
+        const text = await fn();
+        return { content: [{ type: 'text', text }] };
+    }
+    catch (error) {
+        logger.error(`Tool ${toolName} failed`, error);
+        const message = error instanceof Error ? error.message : String(error);
+        return {
+            content: [{ type: 'text', text: `Error: ${message}` }],
+            isError: true,
+        };
+    }
+}
+/** 時區換算提示（僅當發生換算時輸出，避免 Agent 對出生時間產生困惑） */
+function timezoneNote(sourceTimezone, isLunarInput) {
+    if (!sourceTimezone)
+        return '';
+    return `> 注：輸入時間（${sourceTimezone}）已換算為北京時間後排盤。\n\n`;
+}
+// ============================================
+// 干支輔助（列表工具用）
+// ============================================
+const STEMS = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
+const BRANCHES = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
+const MONTH_BRANCHES = ['寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥', '子', '丑'];
+/** 由公曆年推年干支（以 1984 甲子年為基準） */
+function getYearStemBranch(year) {
+    const yearDiff = year - 1984;
+    return {
+        stem: STEMS[((yearDiff % 10) + 10) % 10],
+        branch: BRANCHES[((yearDiff % 12) + 12) % 12],
+    };
+}
+/** 解析干支年輸入（"乙巳" 或公曆年數字） */
+function parseGanzhiYear(input) {
+    if (typeof input === 'number') {
+        const { stem, branch } = getYearStemBranch(input);
+        return { year: input, ganzhi: stem + branch };
+    }
+    const currentYear = (0, wallTime_1.nowBeijingParts)().year;
+    for (let y = currentYear - 60; y <= currentYear + 60; y++) {
+        const { stem, branch } = getYearStemBranch(y);
+        if (stem + branch === input) {
+            return { year: y, ganzhi: input };
+        }
+    }
+    const { stem, branch } = getYearStemBranch(currentYear);
+    return { year: currentYear, ganzhi: stem + branch };
+}
+/** 解析干支月輸入（"丙寅" 或月序數字 1-12，1=寅月） */
+function parseGanzhiMonth(input) {
+    if (typeof input === 'number') {
+        return input;
+    }
+    const branch = input.substring(1, 2);
+    const idx = MONTH_BRANCHES.indexOf(branch);
+    return idx >= 0 ? idx + 1 : 1;
+}
+/** 五虎遁年起月：由公曆年與月序（1=寅月）推月干支 */
+function getMonthStemBranch(year, monthNum) {
+    const branch = MONTH_BRANCHES[(monthNum - 1) % 12];
+    const { stem: yearStem } = getYearStemBranch(year);
+    const firstMonthStemMap = {
+        0: 2, 1: 4, 2: 6, 3: 8, 4: 0, 5: 2, 6: 4, 7: 6, 8: 8, 9: 0,
+    };
+    const monthStemIndex = (firstMonthStemMap[STEMS.indexOf(yearStem)] + monthNum - 1) % 10;
+    return { stem: STEMS[monthStemIndex], branch };
+}
+//# sourceMappingURL=schemas.js.map

package/dist/tools/schemas.js.map

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