dsh-metaphysics 0.56.0 → 0.58.0

package/engine/zeri.js

@@ -81,23 +81,68 @@ const VERDICT = (score, ctx) => {
  * @param {{task:string, startDate:string, days?:number, shengXiao?:string}} input
  *   startDate 必填（公历 YYYY-MM-DD），避免引擎在无时钟环境下静默取「今天」。
  */
+/** 严格解析公历日期：2 月 30 日这类不存在的日子直接判非法，不滚到下个月 */
+function parseYmd(raw) {
+  const m = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(String(raw || '').trim());
+  if (!m) return null;
+  const year = Number(m[1]);
+  const month = Number(m[2]);
+  const day = Number(m[3]);
+  if (month < 1 || month > 12 || day < 1) return null;
+  const back = fromJDN(toJDN(year, month, day));
+  return back.year === year && back.month === month && back.day === day ? { year, month, day } : null;
+}
+
+const ymd = (p) => `${p.year}-${String(p.month).padStart(2, '0')}-${String(p.day).padStart(2, '0')}`;
+
+/**
+ * 择日主函数。
+ * @param {{task:string, startDate:string, days?:number, shengXiao?:string,
+ *   candidates?:string[]}} input
+ *   startDate 必填（公历 YYYY-MM-DD），避免引擎在无时钟环境下静默取「今天」。
+ *   candidates 给了就只比这几个候选日（2–12 个，去重、保持输入顺序），startDate 与 days 不参与。
+ */
 export function buildZeri(input) {
   const task = input.task;
   if (!TASKS[task]) throw new Error(`不支持的事项「${task}」。支持：${Object.keys(TASKS).join('、')}`);
-  const m = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(String(input.startDate || '').trim());
-  if (!m) throw new Error('择日需要 startDate（公历 YYYY-MM-DD）——请向用户询问起算日，不要代填');
-  const start = { year: Number(m[1]), month: Number(m[2]), day: Number(m[3]) };
-  const days = Math.max(1, Math.min(60, Number.isInteger(input.days) ? input.days : 30));
   const shengXiaoRaw = typeof input.shengXiao === 'string' ? input.shengXiao.trim() : '';
   const shengXiao = shengXiaoRaw || null;
   if (shengXiao && !SHENGXIAO.includes(shengXiao)) throw new Error(`shengXiao 须为生肖名：${SHENGXIAO.join('、')}`);
 
+  // 候选日模式：只比用户给的这几天，不再按区间扫
+  let candidates = null;
+  if (input.candidates !== undefined && input.candidates !== null) {
+    if (!Array.isArray(input.candidates)) {
+      throw new Error('candidates 须为日期数组，例如 ["2026-12-01","2026-12-08","2026-12-15"]');
+    }
+    if (input.candidates.length < 2) throw new Error('candidates 至少给 2 个候选日；只想看一天请用 startDate + days: 1');
+    if (input.candidates.length > 12) throw new Error('candidates 最多 12 个候选日；更多请用 startDate + days 扫区间');
+    const seen = new Set();
+    candidates = [];
+    for (const raw of input.candidates) {
+      const p = parseYmd(raw);
+      if (!p) throw new Error(`候选日不是真实存在的公历日期：「${raw}」，请用 2026-12-01 这种格式`);
+      const key = ymd(p);
+      if (seen.has(key)) continue;
+      seen.add(key);
+      candidates.push(p);
+    }
+    if (candidates.length < 2) throw new Error('候选日去重后不足 2 天；至少要两个不同的日子才谈得上比较');
+  }
+
+  let start = null;
+  let days = 0;
+  if (!candidates) {
+    const m = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(String(input.startDate || '').trim());
+    if (!m) throw new Error('择日需要 startDate（公历 YYYY-MM-DD）——请向用户询问起算日，不要代填');
+    start = { year: Number(m[1]), month: Number(m[2]), day: Number(m[3]) };
+    days = Math.max(1, Math.min(60, Number.isInteger(input.days) ? input.days : 30));
+  }
+
   const spec = TASKS[task];
   const zhixingSet = ZHIXING_FAVOR[spec.category];
-  const startJdn = toJDN(start.year, start.month, start.day);
-  const list = [];
-  for (let i = 0; i < days; i++) {
-    const p = fromJDN(startJdn + i);
+
+  const makeRow = (p) => {
     const a = buildAlmanac(p);
     let score = 0;
     const reasons = [];
@@ -114,7 +159,7 @@ export function buildZeri(input) {
     if (a.zhiXing === '危' && spec.category !== 'travel' && spec.category !== 'worship') { score -= 1; reasons.push('危日（-1）'); }
 
     const v = VERDICT(score, { chongSelf, jiHit });
-    list.push({
+    return {
       date: a.meta.date,
       weekday: a.meta.weekday,
       lunar: a.lunar.text,
@@ -128,17 +173,47 @@ export function buildZeri(input) {
       verdict: v.verdict,
       verdictText: v.text,
       ...(v.excluded ? { excluded: true } : {}),
-    });
-  }
+    };
+  };
+
+  const list = candidates
+    ? candidates.map(makeRow)
+    : Array.from({ length: days }, (_, i) => makeRow(fromJDN(toJDN(start.year, start.month, start.day) + i)));
 
   const ranked = list.slice().sort((x, y) => y.score - x.score || (x.date < y.date ? -1 : 1));
+  const startDate = candidates
+    ? candidates.slice().sort((x, y) => (ymd(x) < ymd(y) ? -1 : 1)).map(ymd)[0]
+    : ymd(start);
+
+  // 候选日比较：只在这几天里比，给出最高分和同分者；不换算成「好多少」
+  let compare = null;
+  if (candidates) {
+    const pool = ranked.filter((d) => !d.excluded);
+    const top = pool[0] || null;
+    const scores = list.map((d) => d.score);
+    compare = {
+      mode: 'candidates',
+      count: list.length,
+      best: top ? {
+        date: top.date,
+        score: top.score,
+        verdict: top.verdict,
+        ties: pool.filter((d) => d.score === top.score).map((d) => d.date),
+      } : null,
+      spread: Math.max(...scores) - Math.min(...scores),
+      note: '候选日只在这几天里比：分数来自建除宜忌与冲煞，胜出只表示更合所问事项，不代表「好多少」。',
+    };
+  }
+
   return {
     system: 'zeri',
     meta: {
       task,
-      startDate: `${start.year}-${String(start.month).padStart(2, '0')}-${String(start.day).padStart(2, '0')}`,
-      days,
+      mode: candidates ? 'candidates' : 'range',
+      startDate,
+      days: list.length,
       shengXiao,
+      ...(candidates ? { candidates: candidates.map(ymd) } : {}),
       scope: shengXiao
         ? `宜忌按建除简表；已给当事人属相（${shengXiao}），凡当日冲该属相径直排除。评分仅用于排序引导。`
         : '宜忌按建除简表；未给当事人属相，未做冲属相排除。评分仅用于排序引导。',
@@ -147,6 +222,7 @@ export function buildZeri(input) {
     usable: ranked.filter((d) => d.verdict === '可用' && !d.excluded).slice(0, 5).map((d) => d.date),
     avoid: list.filter((d) => d.verdict === '回避').map((d) => `${d.date}（${d.reasons.join('；') || '综合减分'}）`),
     days: list,
+    ...(compare ? { compare } : {}),
     excludedCount: list.filter((d) => d.excluded).length,
     sources: ['宜忌：建除十二神通行简表', '建除适配与冲煞：传统通行口径', '排序：宜忌加减分 + 属相排除（确定性）'],
     disclaimer: '择日为传统黄历口径的本地计算，属民俗参考；评分只用于排序，不构成择日结论。',

package/index.js

@@ -2,9 +2,10 @@
  * Host 半：把排盘引擎注册成一个模型可调用的工具。
  * 纯计算；唯一的网络行为是按需把地址解析成经度（失败即退回内置坐标表）。
  */
-import { compute, renderText, geocodeAddress, caliberCompare } from './engine/index.js';
+import { compute, renderText, geocodeAddress, caliberCompare, resolveHandle } from './engine/index.js';
 import { createLru } from './engine/lru.js';
 import { cacheMetrics } from './engine/calendar.js';
+import { parseRevision, displayValue } from './engine/revise.js';
 import fs from 'node:fs';
 
 /** 版本注入影子盘：工具侧没有 window.__MP_VER，只能从包元数据取 */
@@ -33,7 +34,9 @@ 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；输出摘要会写明晚子时与真太阳时实际采用的口径。需要回放或对拍时传 shadow: true，结果带影子盘 ID（同参数同 ID；baseId 不含版本，可跨版本比对字段变化）。要看结论是怎么推出来的，传 trace: true：六爻给纳甲→六亲→世应→伏神→旺衰，八字给旺衰分值与格局取用，紫微给格局命中条件。',
+  '用户用一句话改参数（「换成紫微看 2030 年事业」「女命」「晚子时算次日」「出生在成都」「不用真太阳时」「详细解读一下」）时，把原话放进 revise（可配合 handle），引擎翻译成参数补丁并在结果 revision 里回报改了哪些、没认哪些；不要自己把原话拆成猜测的参数。',
+  '追问同一张盘：结果里有 handle，下次传 handle + 增量即可（例如 { handle, asOf: 2030 }、{ handle, withInterpret: true, question: "何时换工作" }、{ handle, system: "ziwei" } 看同一时间另一套盘），不必让用户重报出生信息；句柄带校验位，截断或改字会报 E_HANDLE。',
+  '结果可复现：tarot / liuyao 传 seed，紫微 / 八字 / 塔罗传 asOf；输出摘要会写明晚子时与真太阳时实际采用的口径。需要回放或对拍时传 shadow: true，结果带影子盘 ID（同参数同 ID；baseId 不含版本，可跨版本比对字段变化）。要看结论是怎么推出来的，传 trace: true：六爻给纳甲→六亲→世应→伏神→旺衰，八字给旺衰分值与格局取用，紫微给格局命中条件，奇门与大六壬给盘面层与取用层；同时回传 traceText（同一份层的 Markdown，可直接贴进对话或文档）。',
   '结果用于传统文化与娱乐参考，不得用于医疗、投资、法律、生死等确定性断言。',
 ].join('');
 
@@ -65,7 +68,30 @@ export function apply(ctx) {
     if (args.geocode !== undefined && args.geocode !== 'offline' && args.geocode !== 'online') {
       throw bad(`geocode 只能是 offline / online，收到「${args.geocode}」`);
     }
-    const next = { ...args };
+    // 句柄先并回完整参数：后面的地址解析、日期补全与口径对照都按同一份参数走，
+    // 否则追问时只带 handle 会漏掉出生地（真太阳时）与 system 判断
+    let next;
+    try {
+      next = { ...resolveHandle(args) };
+    } catch (e) {
+      throw e && e.code ? e : bad(`handle 无法使用：${String((e && e.message) || e)}`);
+    }
+    // 一句话改参：先落到参数上，后面的地址解析、日期补全才按改后的体系走；
+    // 改了什么同时留给对外回显（compute 里也会再算一遍，结果相同，这里以宿主这份为准）
+    let revision = null;
+    if (typeof next.revise === 'string' && next.revise.trim()) {
+      const rev = parseRevision(next.revise);
+      const before = { ...next };
+      next = { ...next, ...rev.patch };
+      revision = {
+        text: rev.text,
+        applied: rev.labels.map((l) => {
+          const from = before[l.key] === undefined ? null : before[l.key];
+          return { ...l, from, fromDisplay: displayValue(l.key, from) };
+        }),
+        ignored: rev.ignored,
+      };
+    }
     if (next.shadow === true && !next.shadowVersion) next.shadowVersion = PKG_VERSION;
     // 默认离线：内置表覆盖到地级市，足够真太阳时用；联网是把出生地原文发给第三方，必须显式开启
     const wantsOnline = next.geocode === 'online';
@@ -110,6 +136,7 @@ export function apply(ctx) {
       next.fortuneYear = now.getFullYear();
     }
     const out = compute(next);
+    if (revision) out.revision = revision;
     // 显式要求时才做口径对照：每次要额外排 2–3 张盘，默认不付这笔开销
     if (next.diff === true) {
       const cmp = caliberCompare(next);
@@ -124,6 +151,16 @@ export function apply(ctx) {
     parameters: {
       type: 'object',
       properties: {
+        handle: {
+          type: 'string',
+          description:
+            '排盘句柄：上一次结果里的 handle（形如 mc1.xxx.yyy）。带上它就不必重报出生时间、性别、出生地——只传这次要改的增量参数（如 asOf、direction、withInterpret、question，或换 system 看同一时间另一套盘）。句柄里带着输入本身（是编码不是加密），校验失败会报 E_HANDLE。',
+        },
+        revise: {
+          type: 'string',
+          description:
+            '一句话改参：用户说「换成紫微看 2030 年事业」「女命」「晚子时算次日」「出生在成都」「不用真太阳时」时，把原话放这里（可配合 handle），引擎把它翻成具体参数补丁再排盘。只认明确句式，识别不到就原样按旧参数排，并在结果 revision 里写明改了哪些、没认哪些——不要自己脑补参数。出生年份/时辰改不了（一句话给不出分秒），要改请直接传 datetime。',
+        },
         system: {
           type: 'string',
           enum: ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren', 'hepan', 'qimen', 'almanac', 'zeri', 'chenggu', 'xiaoliuren', 'star', 'numerology', 'mbti', 'trend', 'fengshui', 'name', 'convert'],
@@ -193,11 +230,16 @@ export function apply(ctx) {
         },
         startDate: {
           type: 'string',
-          description: '仅 zeri 使用：起算日（公历 YYYY-MM-DD）。省略则由宿主补今天。',
+          description: '仅 zeri 使用：起算日（公历 YYYY-MM-DD）。省略则由宿主补今天；给了 candidates 时不需要。',
         },
         days: {
           type: 'number',
-          description: '仅 zeri 使用：往后考察天数，1–60，默认 30。',
+          description: '仅 zeri 使用：往后考察天数，1–60，默认 30；给了 candidates 时忽略。',
+        },
+        candidates: {
+          type: 'array',
+          items: { type: 'string' },
+          description: '仅 zeri 使用：候选日比较（2–12 个真实公历日期，如 ["2026-12-01","2026-12-08"]）。给了就只比这几天，结果多一个 compare（这一组最优、同分者、分差）与逐日并排；不替代 startDate 扫区间。',
         },
         shengXiao: {
           type: 'string',
@@ -235,7 +277,7 @@ export function apply(ctx) {
         },
         trace: {
           type: 'boolean',
-          description: '推导链：六爻返回纳甲→六亲→世应→伏神→旺衰，八字返回旺衰分值与格局取用，紫微返回格局命中条件。每层含 field / rule / inputs / result / source；只读盘面，不重算、不改盘。默认 false。',
+          description: '推导链：六爻返回纳甲→六亲→世应→伏神→旺衰，八字返回旺衰分值与格局取用，紫微返回格局命中条件，奇门与大六壬返回盘面层与取用层。每层含 field / rule / inputs / result / source；另回传 traceText（同源 Markdown）。只读盘面，不重算、不改盘。默认 false。',
         },
         verifyPast: {
           type: 'number',
@@ -293,6 +335,17 @@ export function apply(ctx) {
           },
           required: ['datetime', 'gender'],
         },
+        partner2: {
+          type: 'object',
+          description: '三方合盘（可选）：第三个人的出生信息，字段与 partner 相同。给了就多回 triple——你×对方、你×第三方、对方×第三方三对分数并列，不合成「三人总分」。仅 hepan 使用；null 与省略等价，不要传 null。',
+          properties: {
+            datetime: { type: 'string', description: '第三方公历本地时间，如 1988-09-09T08:00' },
+            gender: { type: 'string', enum: ['male', 'female'], description: '第三方性别' },
+            address: { type: 'string', description: '第三方出生地（省/市即可）' },
+            trueSolar: { type: 'boolean', description: '第三方是否启用真太阳时' },
+          },
+          required: ['datetime', 'gender'],
+        },
         mode: {
           type: 'string',
           enum: ['time', 'number'],

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.56.0",
+  "version": "0.58.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": [
@@ -67,12 +67,15 @@
     "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: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 && node tools/check-perf.mjs",
     "test:baseline": "node tools/check-assertions.mjs --update",
+    "bench": "node tools/bench.mjs",
     "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"
+    "check:perf": "node tools/check-perf.mjs",
+    "release": "node tools/release.mjs",
+    "rollback:plan": "node tools/release-rollback.mjs"
   },
   "exports": {
     ".": "./index.js",