mingpan 0.1.2 → 0.1.4

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;AAUD;;;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,162 @@
+"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 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 = new Date().getFullYear();
+    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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"}

package/dist/tools/ziweiTools.d.ts

@@ -0,0 +1,14 @@
+/**
+ * 紫微斗数 MCP 工具
+ *
+ * 工具列表：
+ * - ziwei_basic      基礎排盤（十二宮、主星、四化）
+ * - ziwei_daxian     大限列表
+ * - ziwei_xiaoxian   小限列表
+ * - ziwei_liunian    流年列表
+ * - ziwei_liuyue     流月列表（農曆月）
+ * - ziwei_liuri      流日列表（農曆日）
+ */
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export declare function registerZiweiTools(server: McpServer): void;
+//# sourceMappingURL=ziweiTools.d.ts.map

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

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