dsh-metaphysics 0.13.5 → 0.14.2

package/engine/ziwei.js

@@ -745,10 +745,10 @@ export function enrichLiunian(chart) {
 // 流日命宫起子时 → 顺数至该时辰。四化一律取落点宫的原局宫干。
 // 这条链是紫微看「这个月/这一天/这个时辰」的标准入口，缺了它就只能看到流年。
 
-function asOfParts(v) {
+export function asOfParts(v) {
   if (!v) return null;
   if (typeof v === 'object') return v;
-  const m = String(v).match(/(\d{4})-(\d{1,2})-(\d{1,2})(?:[T ](\d{1,2}):(\d{1,2}))?/);
+  const m = String(v).match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T ](\d{1,2}):(\d{1,2}))?$/);
   if (!m) return null;
   return {
     year: Number(m[1]), month: Number(m[2]), day: Number(m[3]),

package/index.js

@@ -9,14 +9,71 @@ export const inject = ['tools'];
 const TOOL_NAME = 'metaphysics_chart';
 
 const DESCRIPTION = [
-  '排中国传统命理盘与塔罗：四柱八字（bazi）、紫微斗数（ziwei）、六爻纳甲（liuyao）、梅花易数（meihua）、大六壬（daliuren）或塔罗抽牌（tarot）。',
-  '当用户明确要求“排盘 / 算八字 / 看四柱 / 排紫微盘 / 起卦 / 摇一卦 / 抽塔罗 / 看运势”时调用。',
-  'bazi 与 ziwei 需要公历出生时间；liuyao 可给定六爻值或随机起卦；meihua 可按时间或数字起卦；tarot 可指定张数与问题。',
+  '排中国传统命理盘与塔罗：四柱八字（bazi）、紫微斗数（ziwei）、六爻纳甲（liuyao）、梅花易数（meihua）、大六壬（daliuren）、奇门遁甲（qimen）、合盘（hepan）或塔罗抽牌（tarot）。',
+  '当用户明确要求“排盘 / 算八字 / 看四柱 / 排紫微盘 / 起卦 / 摇一卦 / 抽塔罗 / 看运势 / 合盘”时调用。',
+  'bazi 与 ziwei 需要公历出生时间与性别；hepan 需要双方的时间与性别；liuyao 可给定六爻值或随机起卦；meihua 可按时间或数字起卦；tarot 可指定张数与问题。',
   '要给「结合所问之事的解读」时，把 withInterpret 设为 true，并尽量带上 question（所问之事）与 direction（询问方向）。',
+  '结果可复现：tarot / liuyao 传 seed，紫微 / 八字 / 塔罗传 asOf；输出摘要会写明晚子时与真太阳时实际采用的口径。',
   '结果用于传统文化与娱乐参考，不得用于医疗、投资、法律、生死等确定性断言。',
 ].join('');
 
 export function apply(ctx) {
+  const bad = (message) => {
+    const e = new Error(message);
+    e.code = 'E_INPUT';
+    return e;
+  };
+
+  /**
+   * 地址解析缓存：同一次会话里反复排盘（尤其是合盘两侧）不必重复请求。
+   * 只缓存联网结果；离线查表本身是常数级开销。
+   */
+  const GEO_TTL_MS = 6 * 60 * 60 * 1000;
+  const geoCache = new Map();
+  async function geocodeCached(address, opts) {
+    const key = `${String(address).trim()}|${opts.online ? 'online' : 'offline'}`;
+    const hit = geoCache.get(key);
+    const now = Date.now();
+    if (hit && now - hit.at < GEO_TTL_MS) return hit.value;
+    const value = await geocodeAddress(address, opts);
+    if (geoCache.size >= 200) geoCache.delete(geoCache.keys().next().value);
+    geoCache.set(key, { at: now, value });
+    return value;
+  }
+
+  /** 工具主体的实际流程：参数整形 → 地址解析（默认离线） → 排盘 */
+  async function run(args) {
+    if (!args || typeof args !== 'object' || Array.isArray(args)) throw bad('参数必须是对象');
+    if (args.geocode !== undefined && args.geocode !== 'offline' && args.geocode !== 'online') {
+      throw bad(`geocode 只能是 offline / online，收到「${args.geocode}」`);
+    }
+    const next = { ...args };
+    // 默认离线：内置表覆盖到地级市，足够真太阳时用；联网是把出生地原文发给第三方，必须显式开启
+    const wantsOnline = next.geocode === 'online';
+    const resolveGeo = async (person) => {
+      if (!wantsOnline) return; // 离线：引擎自己会查内置表
+      if (typeof person.address !== 'string' || !person.address.trim()) return;
+      if (typeof person.longitude === 'number') return;
+      try {
+        const geo = await geocodeCached(person.address, { online: true });
+        if (geo && typeof geo.lon === 'number') {
+          person.longitude = geo.lon;
+          person.geo = geo;
+        }
+      } catch (e) {
+        // 联网失败不影响排盘，退回内置表
+      }
+    };
+    if (next.system === 'bazi' || next.system === 'ziwei' || next.system === 'hepan') {
+      await resolveGeo(next);
+    }
+    if (next.system === 'hepan' && next.partner && typeof next.partner === 'object') {
+      next.partner = { ...next.partner }; // 不改调用方传进来的对象
+      await resolveGeo(next.partner);
+    }
+    return compute(next);
+  }
+
   const definition = {
     name: TOOL_NAME,
     description: DESCRIPTION,
@@ -25,8 +82,8 @@ export function apply(ctx) {
       properties: {
         system: {
           type: 'string',
-          enum: ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren'],
-          description: 'bazi = 四柱八字；ziwei = 紫微斗数；liuyao = 六爻；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬。',
+          enum: ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren', 'hepan', 'qimen'],
+          description: 'bazi = 四柱八字；ziwei = 紫微斗数；liuyao = 六爻；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需同时给 partner；qimen = 奇门遁甲（时家转盘，拆补法）。',
         },
         datetime: {
           type: 'string',
@@ -36,12 +93,18 @@ export function apply(ctx) {
         gender: {
           type: 'string',
           enum: ['male', 'female'],
-          description: '性别，决定大运与大限顺逆。bazi / ziwei 必填。',
+          description: '性别，决定大运与大限顺逆。bazi / ziwei / hepan 必填，不能用默认值代替。',
         },
         address: {
           type: 'string',
           description:
-            '出生地地址，如「河北石家庄」「成都」「新疆喀什」。用于推算经度并按真太阳时排盘（bazi 与 ziwei 都适用）；只写到省市即可，内置地级市坐标表。与 longitude 同时给出时以 longitude 为准。',
+            '出生地地址，如「河北石家庄」「成都」「新疆喀什」。用于推算经度并按真太阳时排盘（bazi / ziwei / hepan 都适用，合盘的 partner.address 同理）；只写到省市即可，内置地级市坐标表。与 longitude 同时给出时以 longitude 为准。',
+        },
+        geocode: {
+          type: 'string',
+          enum: ['offline', 'online'],
+          description:
+            '地址解析方式，默认 offline：只用内置坐标表（最细到地级市，够真太阳时用）。online 会向 OpenStreetMap Nominatim 发一次查询，可精确到区县/路名；出生地原文会发给第三方，仅在用户明确要求精确到区县时开启。',
         },
         longitude: {
           type: 'number',
@@ -50,7 +113,8 @@ export function apply(ctx) {
         },
         lateZi: {
           type: 'boolean',
-          description: '23:00 后是否算次日（晚子时换日），默认 true。',
+          description:
+            '23:00 后是否算次日（晚子时换日）。八字/大六壬默认 true（换日）；奇门默认 false（归当日），也可用 lateZiHourMode 指定。输出摘要会写明实际采用的口径。',
         },
         trueSolar: {
           type: 'boolean',
@@ -77,7 +141,32 @@ export function apply(ctx) {
         },
         asOf: {
           type: 'string',
-          description: '紫微流月/流日/流时的基准时刻，形如 2026-10-22T16:00；省略则按调用时的本机当前时刻。要复现某一时刻的推演结果时请显式给出。',
+          description: '基准时刻，形如 2026-10-22T16:00。紫微用它定流月/流日/流时；八字用它钉死「流年从哪年起排」；塔罗用它记录 castAt（抽牌时刻）。省略则按调用时的本机当前时刻——要复现某一次结果就显式给出。',
+        },
+        seed: {
+          type: 'number',
+          description: '随机种子，仅 tarot / liuyao 使用。给了同一个 seed，抽牌或摇卦的结果可完整复现（便于回放与对拍）；不传则真随机。',
+        },
+        juMethod: {
+          type: 'string',
+          enum: ['chaibu', 'chaoshen', 'zhirun'],
+          description: '奇门取局流派：chaibu 拆补（默认）、chaoshen 超神接气、zhirun 置闰。仅 qimen 使用。',
+        },
+        lateZiHourMode: {
+          type: 'string',
+          enum: ['same-day', 'next-day'],
+          description: '奇门晚子时（23:00–24:00）归当日还是次日，默认 same-day。仅 qimen 使用。',
+        },
+        partner: {
+          type: 'object',
+          description: '合盘时的对方信息：datetime 与 gender 必填，address 可选（与主方一样按出生地修正真太阳时）。仅 hepan 使用。',
+          properties: {
+            datetime: { type: 'string', description: '对方公历本地时间，如 1998-05-20T10:30' },
+            gender: { type: 'string', enum: ['male', 'female'], description: '对方性别（决定对方大运/大限顺逆）' },
+            address: { type: 'string', description: '对方出生地（省/市即可）' },
+            trueSolar: { type: 'boolean', description: '对方是否启用真太阳时' },
+          },
+          required: ['datetime', 'gender'],
         },
         mode: {
           type: 'string',
@@ -104,25 +193,20 @@ export function apply(ctx) {
       render: (_args, value) => [{ type: 'text', text: renderText(value) }],
     },
     async execute(args) {
-      if (!args || typeof args !== 'object') throw new Error('参数必须是对象');
-      const next = { ...args };
-      // 地址 -> 经度：先查内置表，地址更细或未命中时联网（Nominatim）
-      if ((next.system === 'bazi' || next.system === 'ziwei')
-        && typeof next.address === 'string' && next.address.trim()
-        && typeof next.longitude !== 'number') {
-        try {
-          const geo = await geocodeAddress(next.address, { online: true });
-          if (geo && typeof geo.lon === 'number') {
-            next.longitude = geo.lon;
-            next.geo = geo;
-          }
-        } catch (e) {
-          // 联网失败不影响排盘，退回内置表
-        }
+      try {
+        // 必须 await：直接 `return run(args)` 会让异步拒绝绕过下面的 catch
+        return await run(args);
+      } catch (e) {
+        // 统一错误面：带错误码的入参错误直接透传文案，内部异常也带上码，避免堆栈式消息直出给模型
+        const code = (e && e.code) || 'E_INTERNAL';
+        const message = (e && e.message) || String(e);
+        throw new Error(`[${code}] ${message}`);
       }
-      return compute(next);
     },
   };
 
   ctx.effect(() => ctx.tools.register(definition));
 }
+
+
+

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Metaphysics Charts",
-    "description": "Six systems in one plugin: BaZi (hidden stems, ten gods, 12 stages, 42 shensha, strength, pattern and useful-god, luck scoring), Zi Wei Dou Shu (49 stars with brightness, four 12-god cycles, 34 patterns, decade and annual/monthly/daily/hourly mutagen), LiuYao, MeiHua YiShu, Da Liu Ren and Tarot, plus an ask-driven interpretation layer. Computed locally and exposed as an agent tool with a Web panel."
+    "description": "Eight systems in one plugin: BaZi (hidden stems, ten gods, 12 stages, 42 shensha, strength, pattern and useful-god, luck scoring), Zi Wei Dou Shu (49 stars with brightness, four 12-god cycles, 34 patterns, decade and annual/monthly/daily/hourly mutagen), LiuYao, MeiHua YiShu, Da Liu Ren, Qi Men Dun Jia (three ju-selection schools), compatibility charts (BaZi and Zi Wei), and Tarot, plus an ask-driven interpretation layer. Computed locally with networking off by default, exposed as an agent tool with a Web panel."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
-    "title": "命理排盘 · 八字紫微六爻梅花六壬塔罗",
-    "description": "六套体系一站排盘：八字（藏干十神、十二长生、42 神煞、旺衰、格局用神、大运流年吉凶评分）、紫微斗数（49 星曜与主星庙旺、四层十二神、34 格局、大限、流年流月流日流时四化）、六爻纳甲、梅花易数、大六壬（天地盘/四课/三传）与塔罗；另有所问之事驱动的解析与详解。纯本地计算，作为 Agent 工具供对话调用，并提供可切换本命/大限/流年视图的 Web 面板。"
+    "title": "命理排盘 · 八字紫微六爻梅花六壬奇门合盘塔罗",
+    "description": "八套体系一站排盘：八字（藏干十神、十二长生、42 神煞、旺衰、格局用神、大运流年吉凶评分）、紫微斗数（49 星曜与主星庙旺、四层十二神、34 格局、大限、流年流月流日流时四化）、六爻纳甲、梅花易数、大六壬（天地盘/四课/三传）、奇门遁甲（拆补/超神接气/置闰三派取局）、合盘（八字与紫微两套）与塔罗；另有所问之事驱动的解析与详解。纯本地计算、默认不联网，作为 Agent 工具供对话调用，并提供可切换本命/大限/流年视图的 Web 面板。"
   }
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.13.5",
+  "version": "0.14.2",
   "type": "module",
-  "description": "命理排盘 for DeepSeek Harness: BaZi four pillars (42 shensha, pattern / useful-god / luck scoring), Zi Wei Dou Shu (34 patterns, 大限, 流年四化), LiuYao with real line rendering, MeiHua YiShu, Da Liu Ren (heaven-earth plate, four lessons, three transmissions) and Tarot, Ask（所问之事 + 询问方向）driven interpretation, plus a plain-language 解析与详解 module (five dimensions + hexagram/card sections) — as an agent tool plus a Web panel.",
+  "description": "命理排盘 for DeepSeek Harness: eight systems — BaZi four pillars (42 shensha, pattern / useful-god / luck scoring), Zi Wei Dou Shu (34 patterns, 大限, 流年/流月/流日/流时四化), LiuYao with real line rendering, MeiHua YiShu, Da Liu Ren, Qi Men Dun Jia (chaibu / chaoshen / zhirun), compatibility charts (BaZi + Zi Wei) and Tarot; Ask（所问之事 + 询问方向）driven interpretation, plus a plain-language 解析与详解 module. Reproducible via seed/asOf. All computed locally, networking off by default — as an agent tool plus a Web panel.",
   "keywords": [
     "dsh-plugin",
     "dsh-bundle",
@@ -42,12 +42,6 @@
     "node": ">=18",
     "dsh": ">=0.2.0"
   },
-  "scripts": {
-    "build": "node tools/build-client.mjs",
-    "build:html": "node tools/build-html.mjs",
-    "test": "node tools/test-all.mjs",
-    "release": "node tools/release.mjs"
-  },
   "exports": {
     ".": "./index.js",
     "./client": "./client.js",
@@ -75,5 +69,15 @@
       "immediately": true,
       "inject": []
     }
+  },
+  "scripts": {
+    "build": "node tools/build-client.mjs",
+    "build:html": "node tools/build-html.mjs",
+    "test": "node tools/test-all.mjs",
+    "test:ci": "node tools/test-all.mjs && node tools/check-assertions.mjs && node tools/verify-tests-can-fail.mjs && node tools/check-html-sinks.mjs && node tools/check-patterns.mjs",
+    "test:baseline": "node tools/check-assertions.mjs --update",
+    "check:html": "node tools/check-html-sinks.mjs",
+    "check:patterns": "node tools/check-patterns.mjs",
+    "release": "node tools/release.mjs"
   }
-}
+}