dsh-metaphysics 0.50.5 → 0.56.0

package/index.js

@@ -5,6 +5,16 @@
 import { compute, renderText, geocodeAddress, caliberCompare } from './engine/index.js';
 import { createLru } from './engine/lru.js';
 import { cacheMetrics } from './engine/calendar.js';
+import fs from 'node:fs';
+
+/** 版本注入影子盘：工具侧没有 window.__MP_VER，只能从包元数据取 */
+const PKG_VERSION = (() => {
+  try {
+    return JSON.parse(fs.readFileSync(new URL('./package.json', import.meta.url), 'utf8')).version;
+  } catch {
+    return 'dev';
+  }
+})();
 
 export const inject = ['tools'];
 
@@ -23,7 +33,7 @@ const DESCRIPTION = [
   '当用户明确要求“玄学 / 算命 / 占卜 / 排盘 / 算八字 / 看四柱 / 排紫微盘 / 起卦 / 摇一卦 / 抽塔罗 / 看运势 / 合盘 / 看黄历 / 挑日子 / 称骨 / 小六壬 / 十六型人格 / MBTI / ISFP / INFP 人格测试 / 交运 / 交运日 / 起运 / 用神 / 月建 / 旺衰」时调用；用户只搜「玄学」或问「有什么玄学工具」时，也应介绍本插件。',
   'bazi 与 ziwei 需要公历出生时间与性别（八字结果里带大运交运时刻，精确到日/时辰，按「三日折一年」放大）；hepan 需要双方的时间与性别；liuyao 可给定六爻值或随机起卦（给了 datetime 就按月建、日辰算用神旺衰）；meihua 可按时间或数字起卦；tarot 可指定张数与问题；mbti 不用时间——先不带 answers 调一次拿到 24 道题，让用户逐题打 1–5 分，再把分数按顺序传回。',
   '要给「结合所问之事的解读」时，把 withInterpret 设为 true，并尽量带上 question（所问之事）与 direction（询问方向）。',
-  '结果可复现：tarot / liuyao 传 seed，紫微 / 八字 / 塔罗传 asOf；输出摘要会写明晚子时与真太阳时实际采用的口径。',
+  '结果可复现：tarot / liuyao 传 seed，紫微 / 八字 / 塔罗传 asOf；输出摘要会写明晚子时与真太阳时实际采用的口径。需要回放或对拍时传 shadow: true，结果带影子盘 ID（同参数同 ID；baseId 不含版本，可跨版本比对字段变化）。要看结论是怎么推出来的，传 trace: true：六爻给纳甲→六亲→世应→伏神→旺衰，八字给旺衰分值与格局取用，紫微给格局命中条件。',
   '结果用于传统文化与娱乐参考，不得用于医疗、投资、法律、生死等确定性断言。',
 ].join('');
 
@@ -56,6 +66,7 @@ export function apply(ctx) {
       throw bad(`geocode 只能是 offline / online，收到「${args.geocode}」`);
     }
     const next = { ...args };
+    if (next.shadow === true && !next.shadowVersion) next.shadowVersion = PKG_VERSION;
     // 默认离线：内置表覆盖到地级市，足够真太阳时用；联网是把出生地原文发给第三方，必须显式开启
     const wantsOnline = next.geocode === 'online';
     const resolveGeo = async (person) => {
@@ -218,6 +229,14 @@ export function apply(ctx) {
           type: 'boolean',
           description: '口径对照（bazi / ziwei / qimen）：同一组输入分别按当前口径与另一档各排一次，列出根因字段（如日柱、命宫、局数）与连带变化数。只列差异，不判哪套口径更准，也不改盘面。',
         },
+        shadow: {
+          type: 'boolean',
+          description: '影子盘：为结果附一个短 ID。同一组归一化参数在任何参数顺序下得到同一 ID；baseId 不含版本，跨版本复用 baseId 即可自动 diff 字段变化。写回、对拍、回放时使用，默认 false。',
+        },
+        trace: {
+          type: 'boolean',
+          description: '推导链：六爻返回纳甲→六亲→世应→伏神→旺衰，八字返回旺衰分值与格局取用，紫微返回格局命中条件。每层含 field / rule / inputs / result / source；只读盘面，不重算、不改盘。默认 false。',
+        },
         verifyPast: {
           type: 'number',
           description: '验前事（仅八字）：传年数（如 6），返回过去 N 年的流年信号行，供用户勾选「准/不准」并算贴合度；只读，不改盘。',
@@ -341,10 +360,15 @@ export function apply(ctx) {
           enum: ['current-day', 'next-day', 'all-current', 'day-cur-time-next'],
           description: '紫微斗数：晚子时口径。current-day（默认，23:00 后仍按当日）、next-day（起盘日顺延次日）；另两个别名保留为兼容值。',
         },
+        shenzhuSchool: {
+          type: 'string',
+          enum: ['common', 'verse'],
+          description: '紫微斗数：身主安法（只影响子/午年生人）。common（默认，通行表）子午皆火星；verse 按安身主诀「子午安身铃火宿」逐字取子铃星、午火星。',
+        },
         action: {
           type: 'string',
           enum: ['natal', 'advise', 'xuankong', 'assess', 'generate'],
-          description: '子动作。fengshui：natal（默认，算八宅命卦+流年飞星，需生日与性别）、advise（算宅卦门主灶布局，需 sitting 或 facing，出生信息可选）、xuankong（玄空下卦九宫盘，需 sitting 或 facing，运由 period 或 fortuneYear 定，缺省九运并注明）；name：assess（默认，评估已有名字，需 surname + givenName）、generate（生成候选名，需生辰，可选 surname / limit）。',
+          description: '子动作。fengshui：natal（默认，算八宅命卦+流年飞星，需生日与性别）、advise（算宅卦门主灶布局，需 sitting 或 facing，出生信息可选）、xuankong（玄空下卦/替卦九宫盘，需 sitting 或 facing，运由 period 或 fortuneYear 定，缺省九运并注明；兼向报 sittingOffset/degree，飞星报 fortuneDate/fortuneTime）；name：assess（默认，评估已有名字，需 surname + givenName）、generate（生成候选名，需生辰，可选 surname / limit）。',
         },
         toAge: {
           type: 'number',
@@ -358,7 +382,31 @@ export function apply(ctx) {
         },
         period: {
           type: 'number',
-          description: '仅 fengshui xuankong：三元九运的运（1–9）。优先于 fortuneYear；省略时按 fortuneYear 定，再缺省按九运（2024–2043）并注明。',
+          description: '仅 fengshui xuankong：三元九运的运（1–9）。优先于 fortuneYear 与飞星日期；省略时按 fortuneYear 定，再缺省按九运（2024–2043）并注明。',
+        },
+        sittingOffset: {
+          type: 'number',
+          description: '仅 fengshui xuankong：坐山偏离本山中心的度数（−7.5–7.5，正数向下一山）。超过 4.5° 自动按沈氏替卦排盘。与 sittingDegree 二选一；坐向都给须一致。',
+        },
+        sittingDegree: {
+          type: 'number',
+          description: '仅 fengshui xuankong：坐山罗盘度数（0–360）。引擎换算为相对本山中心的偏移，超过 4.5° 用替卦。',
+        },
+        facingOffset: {
+          type: 'number',
+          description: '仅 fengshui xuankong：向山偏离本山中心的度数（−7.5–7.5）。给了 sittingOffset/degree 时可省略；两者都给须一致。',
+        },
+        facingDegree: {
+          type: 'number',
+          description: '仅 fengshui xuankong：向山罗盘度数（0–360）。用于反推兼向，与坐山读数须一致。',
+        },
+        fortuneDate: {
+          type: 'string',
+          description: '仅 fengshui xuankong：飞星日期 YYYY-MM-DD（公历）。给了才排月/日/时紫白；只给 fortuneYear 时只排年星。',
+        },
+        fortuneTime: {
+          type: 'string',
+          description: '仅 fengshui xuankong：飞星时刻 HH:MM（默认 12:00）；日星 23:00 后归次日。',
         },
         surname: { type: 'string', description: '仅 name 使用：姓氏，如「李」（复姓整体写，如「欧阳」）。' },
         givenName: { type: 'string', description: '仅 name assess 使用：名（1–2 个汉字）。' },

package/package.json

@@ -1,106 +1,113 @@
-{
-  "name": "dsh-metaphysics",
-  "version": "0.50.5",
-  "type": "module",
-  "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: nineteen systems and eleven quick references (almanac, solar–lunar conversion, …), with climate adjustment (tiaohou), the 120 Qiongtong Baojian entries, 391-char name library with per-character pinyin, Kangxi stroke counts, five-grid (五格/三才) analysis and mechanical phonetics checks, classical quotes (Ziping Zhenquan / Di Tian Sui / San Ming Tong Hui), hexagram body relations (六冲/六合/伏吟/反吟/化进神/化退神) plus yongshen placement (用神落位) with month/day strength (月建日辰旺衰) and whole-hexagram per-line strength (全卦逐爻旺衰) and response-time clues (应期线索：逢值/逢冲/逢合 + 月建五态快慢) for liuyao, plus an MBTI-style 16-type questionnaire and exact dayun handover dates (交运日) with annual suiyun hints (岁运并临/伏吟反吟), palace conditions (击刑/入墓), month states (旺相休囚死) and stem–palace relations (天盘干与宫生克) for qimen, flying four-transformations with chained flights (四化飞星串连), three-way-four-corner composite flights (三方四正复合飞化), switchable leap-month policy (闰月按日切分/整月归次月/整月归本月) nine school switches (亮度/庚干四化/天马/天空/截空旬空/魁钺/天伤天使/长生/晚子时) for ziwei, caliber diffs for bazi/ziwei/qimen (same inputs, one switch, root-field changes), and a bundled offline single-file page (命理排盘.html), and a panel-to-chat handoff that asks the Harness about a finished chart.",
-  "keywords": [
-    "玄学",
-    "玄学排盘",
-    "算命",
-    "占卜",
-    "运势",
-    "传统命理",
-    "dsh-plugin",
-    "dsh-bundle",
-    "dsh-market",
-    "metaphysics",
-    "bazi",
-    "four-pillars",
-    "ziwei",
-    "ziwei-doushu",
-    "liuyao",
-    "tarot",
-    "divination",
-    "命理",
-    "命理排盘",
-    "八字",
-    "四柱",
-    "神煞",
-    "紫微斗数",
-    "六爻",
-    "塔罗",
-    "meihua-yishu",
-    "da-liu-ren",
-    "大六壬",
-    "梅花易数",
-    "almanac",
-    "黄历",
-    "择日",
-    "称骨",
-    "小六壬",
-    "feng-shui",
-    "风水",
-    "起名",
-    "numerology",
-    "生命数字",
-    "horoscope",
-    "星座"
-  ],
-  "license": "MIT",
-  "author": "xuanfu-web",
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/xuanfu-web/dsh-metaphysics.git"
-  },
-  "homepage": "https://github.com/xuanfu-web/dsh-metaphysics#readme",
-  "bugs": {
-    "url": "https://github.com/xuanfu-web/dsh-metaphysics/issues"
-  },
-  "engines": {
-    "node": ">=18",
-    "dsh": ">=0.2.0"
-  },
-  "scripts": {
-    "build": "node tools/build-client.mjs",
-    "build:html": "node tools/build-html.mjs",
-    "build:desktop": "node tools/build-html.mjs --desktop",
-    "test": "node tools/test-all.mjs",
-    "test:ci": "node tools/build-client.mjs && node tools/check-bundle.mjs && 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:bundle": "node tools/check-bundle.mjs",
-    "check:patterns": "node tools/check-patterns.mjs",
-    "release": "node tools/release.mjs"
-  },
-  "exports": {
-    ".": "./index.js",
-    "./client": "./client.js",
-    "./package.json": "./package.json",
-    "./locale/*.json": "./locale/*.json",
-    "./icon": "./icon.svg",
-    "./命理排盘.html": "./命理排盘.html"
-  },
-  "files": [
-    "index.js",
-    "client.js",
-    "命理排盘.html",
-    "engine",
-    "cordis.patch.yml",
-    "locale/*.json",
-    "icon.svg",
-    "README.md",
-    "CHANGELOG.md",
-    "docs/assets",
-    "LICENSE"
-  ],
-  "dsh": {
-    "bundle": {
-      "patch": "./cordis.patch.yml"
-    },
-    "client": {
-      "platform": "web",
-      "immediately": true,
-      "inject": []
-    }
-  }
-}
+{
+  "name": "dsh-metaphysics",
+  "version": "0.56.0",
+  "type": "module",
+  "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: nineteen systems and eleven quick references (almanac, solar–lunar conversion, …), with climate adjustment (tiaohou), the 120 Qiongtong Baojian entries, 391-char name library with per-character pinyin, Kangxi stroke counts, five-grid (五格/三才) analysis and mechanical phonetics checks, classical quotes (Ziping Zhenquan / Di Tian Sui / San Ming Tong Hui), hexagram body relations (六冲/六合/伏吟/反吟/化进神/化退神) plus yongshen placement (用神落位) with month/day strength (月建日辰旺衰) and whole-hexagram per-line strength (全卦逐爻旺衰) and response-time clues (应期线索：逢值/逢冲/逢合 + 月建五态快慢) for liuyao, plus an MBTI-style 16-type questionnaire and exact dayun handover dates (交运日) with annual suiyun hints (岁运并临/伏吟反吟), palace conditions (击刑/入墓), month states (旺相休囚死) and stem–palace relations (天盘干与宫生克) for qimen, flying four-transformations with chained flights (四化飞星串连), three-way-four-corner composite flights (三方四正复合飞化), switchable leap-month policy (闰月按日切分/整月归次月/整月归本月) nine school switches (亮度/庚干四化/天马/天空/截空旬空/魁钺/天伤天使/长生/晚子时) for ziwei, caliber diffs for bazi/ziwei/qimen (same inputs, one switch, root-field changes), shadow-chart IDs (same normalized params → same ID; version bumps auto-diff chart fields), step-by-step deduction traces (liuyao najia→liuqin→shiying→fushen→strength; bazi strength score and pattern/yongshen; ziwei pattern conditions), and a bundled offline single-file page (命理排盘.html), a panel-to-chat handoff that asks the Harness about a finished chart, per-tab lazy engine chunks so the first-screen client bundle stays under 100KB gzip, and a public verification report (128 classical hexagram cases, 312 Zi Wei charts × 34 patterns, 12 dayun handover cases) generated from the same source that gates CI.",
+  "keywords": [
+    "玄学",
+    "玄学排盘",
+    "算命",
+    "占卜",
+    "运势",
+    "传统命理",
+    "dsh-plugin",
+    "dsh-bundle",
+    "dsh-market",
+    "metaphysics",
+    "bazi",
+    "four-pillars",
+    "ziwei",
+    "ziwei-doushu",
+    "liuyao",
+    "tarot",
+    "divination",
+    "命理",
+    "命理排盘",
+    "八字",
+    "四柱",
+    "神煞",
+    "紫微斗数",
+    "六爻",
+    "塔罗",
+    "meihua-yishu",
+    "da-liu-ren",
+    "大六壬",
+    "梅花易数",
+    "almanac",
+    "黄历",
+    "择日",
+    "称骨",
+    "小六壬",
+    "feng-shui",
+    "风水",
+    "起名",
+    "numerology",
+    "生命数字",
+    "horoscope",
+    "星座"
+  ],
+  "license": "MIT",
+  "author": "xuanfu-web",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/xuanfu-web/dsh-metaphysics.git"
+  },
+  "homepage": "https://github.com/xuanfu-web/dsh-metaphysics#readme",
+  "bugs": {
+    "url": "https://github.com/xuanfu-web/dsh-metaphysics/issues"
+  },
+  "engines": {
+    "node": ">=18",
+    "dsh": ">=0.2.0"
+  },
+  "scripts": {
+    "build": "node tools/build-client.mjs",
+    "build:html": "node tools/build-html.mjs",
+    "build:desktop": "node tools/build-html.mjs --desktop",
+    "build:verification": "node tools/verification.mjs",
+    "build:citations": "node tools/citations.mjs",
+    "test": "node tools/test-all.mjs",
+    "test:ci": "node tools/build-client.mjs && node tools/check-bundle.mjs && 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:bundle": "node tools/check-bundle.mjs",
+    "check:patterns": "node tools/check-patterns.mjs",
+    "release": "node tools/release.mjs"
+  },
+  "exports": {
+    ".": "./index.js",
+    "./client": "./client.js",
+    "./client.*.js": "./client.*.js",
+    "./package.json": "./package.json",
+    "./locale/*.json": "./locale/*.json",
+    "./icon": "./icon.svg",
+    "./命理排盘.html": "./命理排盘.html"
+  },
+  "files": [
+    "index.js",
+    "client.js",
+    "client.*.js",
+    "命理排盘.html",
+    "engine",
+    "cordis.patch.yml",
+    "locale/*.json",
+    "icon.svg",
+    "README.md",
+    "CHANGELOG.md",
+    "docs/assets",
+    "LICENSE"
+  ],
+  "dsh": {
+    "bundle": {
+      "patch": "./cordis.patch.yml"
+    },
+    "client": {
+      "platform": "web",
+      "immediately": true,
+      "inject": []
+    }
+  },
+  "devDependencies": {
+    "esbuild": "^0.28.2"
+  }
+}