dsh-metaphysics 0.15.0 → 0.17.0

package/engine/rectify.js

@@ -0,0 +1,130 @@
+// 生时校正（仅八字）：给一组「过去发生过的事」，把候选时辰逐一排盘、按同一套信号规则打分，
+// 输出候选排序，帮助缩小出生时辰的范围。
+//
+// 必须说清的三件事：
+//   1. 这是**缩小范围**的参考，不替代出生记录；命中数相同或接近时，不要硬选一个；
+//   2. 只有时柱（以及跨 23:00 时的日柱）会变，年/月柱通常不变，所以候选之间的差异集中在晚运、子女、事业后半段；
+//   3. 打分规则是显式、固定的（见 matchEvent），不是拟合；换一套规则排序可能变。
+import { buildBazi } from './bazi.js';
+
+const KINDS = ['career', 'wealth', 'love', 'move', 'health', 'other'];
+const HOURS = [0, 1, 2, 4, 6, 8, 10, 12, 14, 16, 18, 20, 22, 23];
+
+const TEN_GOD = (l) => l.stemTenGod || '';
+const has = (l, re) => re.test((l.relations || []).join(''));
+const tier = (l) => (l.luck && l.luck.tier) || '平';
+
+/**
+ * 单条「过去发生的事」在某个候选盘里的信号是否吻合（规则固定、可复核）。
+ * @param {object} l 某年的流年条目
+ * @param {string} kind career | wealth | love | move | health | other
+ */
+export function matchEvent(l, kind) {
+  if (!l) return false;
+  const tg = TEN_GOD(l);
+  const t = tier(l);
+  switch (kind) {
+    case 'career': return /官|杀|食|伤/.test(tg) || has(l, /冲|合/) || t === '大吉' || t === '大忌';
+    case 'wealth': return /财|食|伤/.test(tg) || t === '大吉' || t === '吉';
+    case 'love': return /财|官|杀/.test(tg) || has(l, /合|冲/);
+    case 'move': return has(l, /冲|合/);
+    case 'health': return has(l, /刑|害|冲/) || t === '大忌' || t === '忌';
+    default: return t === '大吉' || t === '大忌' || has(l, /冲|刑|合/);
+  }
+}
+
+/**
+ * @param {object} opts
+ * @param {{year:number,month:number,day:number,minute?:number}} opts.base 出生日期（时辰待定）
+ * @param {'male'|'female'} opts.gender
+ * @param {Array<{year:number, kind:string}>} opts.events 过去发生的事（年份 + 类别）
+ * @param {number[]} [opts.hours] 候选小时（默认 0/1/2/4/…/22/23）
+ * @param {boolean} [opts.lateZi] 晚子时是否换日
+ * @param {boolean} [opts.trueSolar]
+ * @param {string} [opts.address]
+ * @param {number} [opts.longitude]
+ * @param {object} [opts.geo]
+ */
+export function rectifyBirth(opts) {
+  const base = opts && opts.base;
+  const events = (opts && opts.events) || [];
+  const gender = opts && opts.gender;
+  if (!base || !Number.isInteger(base.year) || !Number.isInteger(base.month) || !Number.isInteger(base.day)) {
+    const e = new Error('生时校正需要出生日期 { year, month, day }');
+    e.code = 'E_INPUT';
+    throw e;
+  }
+  if (!gender) {
+    const e = new Error('生时校正需要性别');
+    e.code = 'E_INPUT';
+    throw e;
+  }
+  const clean = events
+    .filter((x) => x && Number.isInteger(Number(x.year)))
+    .map((x) => ({ year: Number(x.year), kind: KINDS.includes(x.kind) ? x.kind : 'other' }));
+  if (!clean.length) {
+    const e = new Error('生时校正需要至少一条「过去发生的事」（年份 + 类别）');
+    e.code = 'E_INPUT';
+    throw e;
+  }
+  const nowYear = Math.min(...clean.map((x) => x.year));
+  const hours = Array.isArray(opts.hours) && opts.hours.length
+    ? opts.hours.filter((h) => Number.isInteger(h) && h >= 0 && h <= 23)
+    : HOURS;
+
+  const candidates = hours.map((hour) => {
+    const chart = buildBazi({
+      ...base,
+      hour,
+      minute: 0,
+      gender,
+      lateZi: opts.lateZi !== false,
+      trueSolar: opts.trueSolar !== false,
+      address: typeof opts.address === 'string' ? opts.address : undefined,
+      longitude: typeof opts.longitude === 'number' ? opts.longitude : undefined,
+      geo: opts.geo && typeof opts.geo === 'object' ? opts.geo : undefined,
+      nowYear,
+    });
+    const matched = [];
+    const missed = [];
+    for (const ev of clean) {
+      const l = (chart.liunian || []).find((x) => Number(x.year) === ev.year);
+      (matchEvent(l, ev.kind) ? matched : missed).push(ev);
+    }
+    return {
+      hour,
+      label: `${String(hour).padStart(2, '0')}:00 起`,
+      dayGanzhi: chart.pillars.day.ganzhi,
+      hourGanzhi: chart.pillars.hour.ganzhi,
+      score: clean.length ? matched.length / clean.length : 0,
+      hits: matched.length,
+      total: clean.length,
+      matchedYears: matched.map((x) => x.year),
+      missedYears: missed.map((x) => x.year),
+    };
+  });
+  candidates.sort((a, b) => b.score - a.score || a.hour - b.hour);
+
+  const days = [...new Set(candidates.map((c) => c.dayGanzhi))];
+  const best = candidates[0];
+  const second = candidates[1];
+  const tie = second && second.score === best.score;
+
+  return {
+    system: 'bazi',
+    base,
+    events: clean,
+    hours,
+    candidates,
+    best: best || null,
+    tie,
+    dayChanged: days.length > 1,
+    note: `候选 ${candidates.length} 个：命中数最高 ${best ? best.hits : 0}/${clean.length}${tie ? `（有并列：${candidates.filter((c) => c.score === best.score).map((c) => c.hour).join('、')} 点）` : ''}。` +
+      (days.length > 1 ? `注意：跨 23:00 的候选会改变日柱（${days.join(' / ')}），这类差异比时柱更关键。` : '候选之间只差时柱（日柱未变）。') +
+      ' 这是缩小范围的参考，不替代出生记录；命中数接近时不要硬选。',
+  };
+}
+
+/** 事件类别（与工具 schema 的 kind 枚举一致）；导出时不起别名，打包器只支持直接导出 */
+export const RECTIFY_KINDS = KINDS;
+export default rectifyBirth;

package/engine/verify.js

@@ -0,0 +1,64 @@
+// 验前事：把过去几年的流年信号摊开，让用户自己标「准 / 不准 / 不确定」，
+// 只算一个贴合度提示，**不改盘、不重排、不自动调整结论**。
+//
+// 口径说明：这里说的「准」是用户对自己经历的主观确认，不是事实核验；
+// 贴合度低时优先怀疑输入（出生时间、时区、晚子时口径），而不是推翻整张盘。
+const KIND_LABEL = {
+  career: '事业变动',
+  wealth: '财运起伏',
+  love: '感情变化',
+  move: '搬迁 / 出行',
+  health: '健康问题',
+  other: '其他大事',
+};
+
+const THEME = (l) => {
+  const rel = (l.relations || []).join('');
+  if (/冲/.test(rel)) return '有冲：变动 / 摩擦';
+  if (/刑/.test(rel)) return '有刑：内耗 / 反复';
+  if (/合/.test(rel)) return '有合：合作 / 牵引';
+  const tier = l.luck && l.luck.tier;
+  if (tier === '大吉' || tier === '吉') return '流年偏顺';
+  if (tier === '大忌' || tier === '忌') return '流年偏压';
+  return '信号平缓';
+};
+
+/** 把某张盘（需已含过去年份的 liunian）摊成可勾选的信号行 */
+export function pastSignals(chart, untilYear) {
+  const until = Number(untilYear) || Infinity;
+  return (chart.liunian || [])
+    .filter((l) => Number(l.year) <= until)
+    .map((l) => ({
+      year: Number(l.year),
+      ganzhi: l.ganzhi,
+      tier: (l.luck && l.luck.tier) || '平',
+      tenGod: l.stemTenGod || '',
+      relations: l.relations || [],
+      theme: THEME(l),
+    }));
+}
+
+/**
+ * 按用户的勾选算贴合度。
+ * @param {Array<{year:number}>} rows pastSignals 的结果
+ * @param {Record<string,'yes'|'no'|'unsure'>} marks 年份 → 勾选
+ */
+export function verifyFit(rows, marks) {
+  const list = Array.isArray(rows) ? rows : [];
+  const m = marks || {};
+  const picked = list.filter((r) => m[r.year] === 'yes' || m[r.year] === 'no');
+  const yes = picked.filter((r) => m[r.year] === 'yes').length;
+  const no = picked.length - yes;
+  const rate = picked.length ? yes / picked.length : null;
+  const level = rate == null ? '未评' : rate >= 0.7 ? '高' : rate >= 0.4 ? '中' : '低';
+  let advice = '';
+  if (rate == null) advice = '先勾几项「准 / 不准 / 不确定」，再看得出的贴合度。';
+  else if (level === '高') advice = '前事与流年信号对得较顺，可以按这张盘继续看；有分歧时以事实为准。';
+  else if (level === '中') advice = '有一部分对得上：先用「追问」核对具体年份，再决定信到什么程度。';
+  else advice = '对得不多：优先核对出生时间、出生地（时区/真太阳时）与晚子时口径，而不是改结论。';
+  return { answered: picked.length, yes, no, rate, level, advice, labels: { ...KIND_LABEL } };
+}
+
+export { KIND_LABEL };
+
+export default pastSignals;

package/index.js

@@ -142,7 +142,34 @@ export function apply(ctx) {
           enum: ['general', 'wealth', 'career', 'love', 'health', 'study', 'travel'],
           description: '询问方向（仅配合 withInterpret 生效）：general 综合、wealth 财运、career 事业、love 感情、health 健康、study 学业、travel 出行。默认 general。',
         },
-        withInterpret: {
+        cross: {
+          type: 'boolean',
+          description: '八字 / 紫微专用：为同一份出生信息再排另一套盘，返回「八字 × 紫微 交叉验证」（同向 / 有张力 / 互补），不合并数值。',
+        },
+        verifyPast: {
+          type: 'number',
+          description: '验前事（仅八字）：传年数（如 6），返回过去 N 年的流年信号行，供用户勾选「准/不准」并算贴合度；只读，不改盘。',
+        },
+        rectify: {
+          type: 'boolean',
+          description: '生时校正（仅八字）：配合 events 使用，把候选时辰逐一排盘并按固定规则对过去事件打分，返回候选排序；用于缩小时辰范围，不替代出生记录。',
+        },
+        events: {
+          type: 'array',
+          description: '生时校正用的过去事件：年份 + 类别（career/wealth/love/move/health/other）。',
+          items: {
+            type: 'object',
+            properties: {
+              year: { type: 'integer', description: '事件发生的公历年份，如 2019' },
+              kind: { type: 'string', enum: ['career', 'wealth', 'love', 'move', 'health', 'other'], description: '事件类别' },
+            },
+            required: ['year'],
+          },
+        },
+        ask: {
+          type: 'string',
+          description: '追问：围绕已算好的盘回答「某一年 / 某方面」的问题，如「2027 年事业怎么样」「感情如何」。只取盘面已有字段，不重排、不猜测。',
+        },        withInterpret: {
           type: 'boolean',
           description: '是否附带「解析与详解」（五个维度 + 用神/格局等分节 + 免责声明）；默认 false，避免默认输出过长。',
         },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.15.0",
+  "version": "0.17.0",
   "type": "module",
   "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": [