dsh-metaphysics 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -2,6 +2,20 @@
 
 版本按「一组可感知的改动」发，README 与市场条目描述随能力同步。
 
+## 0.17.0（未发布）
+
+对应「晚子时开关 / 验前事 / 生时校正」三条用户反馈：
+
+- **晚子时开关**：面板与独立页新增「晚子时换日」（八字/紫微/合盘）与奇门「归当日/归次日」；
+  之前引擎已支持 `lateZi` / `lateZiHourMode`，但 UI 没有暴露，用户无法自己调
+- **验前事**：工具参数 `verifyPast`（年数）+ 面板/独立页「验前事」区块——列出过去若干年的
+  流年信号（冲/合/刑、档位、十神），用户自评「准/不准/不确定」，用 `verifyFit` 算贴合度并给建议；
+  **只读，不重排、不改盘**；贴合度低时先提示核对出生时间/时区/晚子时
+- **生时校正**：`engine/rectify.js` + 工具参数 `rectify`/`events`——对候选时辰逐一排盘，
+  按固定规则（事件类别 × 当年十神/关系/档位）打分，返回候选排序与并列说明；
+  规则显式可复核，明确「只缩小范围、不替代出生记录」
+- 测试：新增 `test/verify.test.mjs` 25 条；全量 53 个文件 / 1362 条 PASS
+
 ## 0.16.0（已发布）
 
 报告化改版，对应与 Seeself 对比后的 R1–R8：

package/README.md

@@ -75,7 +75,10 @@ Chinese metaphysics for [DeepSeek Harness](https://github.com/deepseek-ai/deepse
 - **追问**：工具参数 `ask`、面板与独立页的追问输入框——围绕**已算好的盘**回答「2027 年事业怎么样」「财运如何」这类问题；只取盘面已有字段（流年/大运/宫位/分节），不重排、不猜测；年份超出已排范围或没识别到方面时，明确说找不到并给出可问范围
 - **八字 × 紫微 交叉验证**：工具参数 `cross`（或面板勾选）会用同一份出生信息再排另一套盘，对事业/财富/感情/身体/节奏五项并列对照，标注「同向 / 有张力 / 互补」；只作对照，不把两套体系折算成同一个分数
 - **量化口径**：只量化引擎已有数据（十神权重、大运/流年档位、宫位与四化计数），**不换算金额、不给健康诊断**；报告里有「量化口径」分节写明这条边界
-- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、52 个测试文件/1335 条断言、五道闸、口径与已知边界），离线可开
+- **方法与验证**：独立页内置同页「方法与验证」（体系、128 条卦例对拍、53 个测试文件/1362 条断言、五道闸、口径与已知边界），离线可开
+- **晚子时开关**：面板与独立页都能切「23:00 后算次日/当日」；奇门另可切「归当日/归次日」——这是排盘口径，不是结果重算
+- **验前事**：八字报告下方列出过去 6 年流年信号，用户自评「准/不准/不确定」，算一个贴合度提示；只读、不改盘
+- **生时校正**：输入过去 2–3 件大事（年份 + 类别），对候选时辰逐一排盘并按固定规则打分，返回候选排序——用于缩小时辰范围，不替代出生记录
 - **导出**：面板与独立页都能「导出 .md」（盘面 + 一页读懂 + 三张表 + 交叉验证 + 追问）；独立页另有打印/存 PDF
 - **推导可复核**：八字/紫微另有「看盘顺序」「时间窗」「交叉校验」「未纳入」四段——先看什么后看什么、未来几步大运与近五年流年、喜忌分量与运年是否同向、以及这套算法**没有**计算什么；六爻/六壬对应给「看卦/看课顺序」与「未纳入」。这些都从盘面数据推出，不新增断语
 - **卦象**（六爻/梅花/大六壬）额外给：卦名与卦辞大意、爻辞与动爻、体用关系、互卦与变卦、落到生活里

package/client.js

@@ -746,7 +746,7 @@ function resolveAddress(input) {
 
 const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
-const USER_AGENT = 'dsh-metaphysics/0.16.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.17.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;
@@ -6843,6 +6843,169 @@ function crossText(cross) {
 return { crossCheck, crossText };
 })();
 
+__mods.verify = (function () {
+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 '信号平缓';
+};
+
+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),
+    }));
+}
+
+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 } };
+}
+
+return { KIND_LABEL, pastSignals, verifyFit };
+})();
+
+__mods.rectify = (function () {
+const { buildBazi } = __mods.bazi;
+
+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) || '平';
+
+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, /冲|刑|合/);
+  }
+}
+
+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(' / ')}），这类差异比时柱更关键。` : '候选之间只差时柱（日柱未变）。') +
+      ' 这是缩小范围的参考，不替代出生记录；命中数接近时不要硬选。',
+  };
+}
+
+const RECTIFY_KINDS = KINDS;
+
+return { matchEvent, rectifyBirth, RECTIFY_KINDS };
+})();
+
 __mods.index = (function () {
 const { buildBazi } = __mods.bazi;
 const { buildLiuyao, tossLines } = __mods.liuyao;
@@ -6859,6 +7022,8 @@ const { randomOf, isSeed } = __mods.random;
 const { interpret, DIRECTIONS, DIRECTION_DEFAULT } = __mods.interpret;
 const { followup } = __mods.followup;
 const { crossCheck, crossText } = __mods.crosscheck;
+const { pastSignals, verifyFit } = __mods.verify;
+const { rectifyBirth } = __mods.rectify;
 const { fail } = __mods.fail;
 const { assertCivil } = __mods.validate;
 
@@ -7137,6 +7302,39 @@ function compute(args = {}) {
       r.interpret.sections.push({ key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: crossText(r.cross) });
     }
   }
+  if (Number.isInteger(args.verifyPast) && args.verifyPast > 0 && r.system === 'bazi') {
+    const years = Math.min(Math.max(args.verifyPast, 1), 10);
+    const from = Number(r.liunianFrom) - years;
+    const pastChart = buildBazi({
+      ...parseDateTime(args.datetime),
+      gender: requireGender(args.gender),
+      lateZi: args.lateZi !== false,
+      trueSolar: args.trueSolar !== false,
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+      nowYear: from,
+    });
+    r.past = {
+      rows: pastSignals(pastChart, Number(r.liunianFrom) - 1),
+      years,
+      until: Number(r.liunianFrom) - 1,
+    };
+  }
+  if (args.rectify === true && r.system === 'bazi') {
+    const base = parseDateTime(args.datetime);
+    r.rectify = rectifyBirth({
+      base: { year: base.year, month: base.month, day: base.day, minute: base.minute },
+      gender: requireGender(args.gender),
+      events: Array.isArray(args.events) ? args.events : [],
+      hours: Array.isArray(args.rectifyHours) ? args.rectifyHours : undefined,
+      lateZi: args.lateZi !== false,
+      trueSolar: args.trueSolar !== false,
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+    });
+  }
   if (typeof args.ask === 'string' && args.ask.trim()) r.followup = followup(r, args.ask);
   return r;
 }
@@ -7352,10 +7550,21 @@ function renderText(result) {
     const f = result.followup;
     parts.push(`【追问】${f.question}\n${f.answer}${f.evidence && f.evidence.length ? `\n　依据：${f.evidence.join('；')}　置信度：${f.confidence}` : ''}`);
   }
+  if (result.past && Array.isArray(result.past.rows) && result.past.rows.length) {
+    parts.push(`【验前事】过去 ${result.past.years} 年的流年信号（只读，不改盘）\n` +
+      result.past.rows.map((r) => `· ${r.year} ${r.ganzhi} · ${r.theme}（${r.tier}${r.tenGod ? `，${r.tenGod}` : ''}）`).join('\n') +
+      '\n用法：在面板里勾「准 / 不准 / 不确定」后算贴合度；贴合度低时先核对出生时间、时区与晚子时口径。');
+  }
+  if (result.rectify && Array.isArray(result.rectify.candidates)) {
+    const rc = result.rectify;
+    parts.push(`【生时校正】候选时辰 ${rc.candidates.length} 个（固定规则打分，只缩小范围）\n` +
+      rc.candidates.slice(0, 8).map((c) => `· ${c.label} 时柱 ${c.hourGanzhi} / 日柱 ${c.dayGanzhi} · 命中 ${c.hits}/${c.total}`).join('\n') +
+      `\n${rc.note}`);
+  }
   return parts.filter(Boolean).join('\n\n');
 }
 
-return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAddress, resolveAddress, buildBazi, buildLiuyao, tossLines, followup, crossCheck, crossText, parseDateTime, compute, interpretText, renderText };
+return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAddress, resolveAddress, buildBazi, buildLiuyao, tossLines, followup, pastSignals, verifyFit, rectifyBirth, crossCheck, crossText, parseDateTime, compute, interpretText, renderText };
 })();
 
     const Engine = __mods.index;
@@ -8908,6 +9117,19 @@ const CSS = `
 .mp-askbox{display:flex;gap:8px;align-items:center;margin-top:12px}
 .mp-askbox .mp-input{flex:1;min-width:0}
 .mp-fx{margin-top:10px}
+.mp-verify,.mp-rect{margin-top:12px;padding:12px;border:1px solid var(--dsw-alias-border-l1);border-radius:10px;background:var(--dsw-alias-bg-layer-2)}
+.mp-verify-h{font-size:12px;font-weight:700;letter-spacing:.08em;color:var(--dsw-alias-label-secondary);margin-bottom:8px}
+.mp-verify-row{display:flex;align-items:center;justify-content:space-between;gap:8px;font-size:12.5px;padding:3px 0}
+.mp-verify-btns{display:flex;gap:4px}
+.mp-chip{font-size:11.5px;padding:2px 8px;border-radius:999px;border:1px solid var(--dsw-alias-border-l1);background:transparent;color:var(--dsw-alias-label-secondary);cursor:pointer}
+.mp-chip.on{background:var(--dsw-alias-brand-primary);color:#fff;border-color:transparent}
+.mp-verify-foot{display:flex;align-items:flex-start;gap:8px;margin-top:8px;flex-wrap:wrap}
+.mp-verify-fit{font-size:12px;color:var(--dsw-alias-label-secondary);line-height:1.7;flex:1;min-width:0}
+.mp-rect-row{display:flex;gap:6px;margin-bottom:6px}
+.mp-rect-row .mp-input{flex:1;min-width:0}
+.mp-rect-cand{font-size:12px;padding:5px 8px;border-radius:6px;background:var(--dsw-alias-bg-layer-1);margin-top:4px;color:var(--dsw-alias-label-secondary)}
+.mp-rect-cand.best{border-left:3px solid var(--dsw-alias-brand-primary);color:var(--dsw-alias-label-primary)}
+.mp-rect-err{color:var(--dsw-alias-label-secondary);font-size:12px}
 .mp-checks{flex-direction:row;align-items:center;gap:7px;font-size:12.5px}
 .mp-checks input{width:15px;height:15px;accent-color:var(--dsw-alias-brand-primary)}
 .mp-auto{margin:-8px 0 14px;padding-left:2px;font-size:12.5px;line-height:1.7;color:var(--dsw-alias-label-secondary)}
@@ -8995,9 +9217,15 @@ function App() {
   const [hpChart, setHpChart] = useState('bazi');
   const [qimenRule, setQimenRule] = useState('chaibu');
   const [trueSolar, setTrueSolar] = useState(true);
+  const [lateZi, setLateZi] = useState(true);
+  const [qLateZi, setQLateZi] = useState('same-day');
   const [crossOn, setCrossOn] = useState(false);
   const [askText, setAskText] = useState('');
   const [fx, setFx] = useState(null);
+  const [pastMarks, setPastMarks] = useState({});
+  const [fit, setFit] = useState(null);
+  const [rectEvents, setRectEvents] = useState([{ year: '2019', kind: 'career' }, { year: '2022', kind: 'love' }]);
+  const [rectRes, setRectRes] = useState(null);
   const [onlineGeo, setOnlineGeo] = useState(false);
   const [lines, setLines] = useState('');
   const [result, setResult] = useState(null);
@@ -9046,13 +9274,14 @@ function App() {
           }
         }
         if (k !== 'hepan') args.cross = crossOn;
+        args.lateZi = lateZi;
       }
       if (k === 'liuyao') {
         const parsed = Core.parseLines(lines);
         if (parsed.lines) args.lines = parsed.lines;
         else if (parsed.warning) setNotice(parsed.warning);
       }
-      if (k === 'qimen') args.juMethod = qimenRule;
+      if (k === 'qimen') { args.juMethod = qimenRule; args.lateZiHourMode = qLateZi; }
       if (k === 'tarot') args.count = Number(count);
       if (k === 'hepan') {
         args.chart = hpChart;
@@ -9101,7 +9330,7 @@ function App() {
       }
       const timed = kindOf(k) === 'cast' && (k !== 'meihua' || mh === 'time');
       setResult({ kind: k, r, it, at: dt, timed });
-      setFx(null);
+      setFx(null); setFit(null); setPastMarks({}); setRectRes(null);
       setError('');      setCopied('');
       if (k !== 'tarot') {
         const entry = {
@@ -9259,6 +9488,34 @@ function App() {
     }
   };
 
+  const btnStyle = { fontSize: 12, padding: '5px 12px' };
+
+  const calcFit = () => {
+    if (!result || !result.r || !result.r.past) return;
+    setFit(Engine.verifyFit ? Engine.verifyFit(result.r.past.rows, pastMarks) : null);
+  };
+
+  const runRectify = () => {
+    if (!result || result.kind !== 'bazi') return;
+    try {
+      const [y, m, d] = String(date).split('-').map(Number);
+      const [, mm] = String(time).split(':').map(Number);
+      const events = rectEvents
+        .filter((e) => Number(e.year))
+        .map((e) => ({ year: Number(e.year), kind: e.kind }));
+      setRectRes(Engine.rectifyBirth ? Engine.rectifyBirth({
+        base: { year: y, month: m, day: d, minute: Number.isFinite(mm) ? mm : 0 },
+        gender,
+        events,
+        lateZi,
+        trueSolar,
+        address: address.trim() || undefined,
+      }) : { error: '当前客户端未加载生时校正模块' });
+    } catch (e) {
+      setRectRes({ error: e && e.message ? e.message : String(e) });
+    }
+  };
+
   const field = (label, node) => h('label', { className: 'mp-field' }, h('span', { className: 'mp-lbl' }, label), node);
 
   const replay = (x) => {
@@ -9345,6 +9602,10 @@ function App() {
               onChange: () => setQimenRule(value),
             }),
             h('span', null, label)))),
+          h('div', { className: 'mp-field' }, h('span', { className: 'mp-lbl' }, '晚子时'),
+            h('select', { className: 'mp-input', value: qLateZi, onChange: (e) => setQLateZi(e.target.value) },
+              h('option', { value: 'same-day' }, '23:00 后归当日'),
+              h('option', { value: 'next-day' }, '23:00 后归次日'))),
           h('details', { className: 'mp-qmhelp' },
             h('summary', null, '三种规则有什么区别？'),
             h('p', null, '决定符头与节气如何对齐、是否插入闰局；同一个时刻在不同规则下可能得到不同局数。默认「拆补」与工具层一致。'))) : null,
@@ -9378,6 +9639,9 @@ function App() {
       isBirth ? h('div', { className: 'mp-checks' },
         h('label', { title: '按出生地经度把钟表时间换算成真太阳时' },
           h('input', { type: 'checkbox', checked: trueSolar, onChange: (e) => setTrueSolar(e.target.checked) }), '真太阳时'),
+        isBirth ? h('label', { className: 'mp-field mp-checks' },
+          h('input', { type: 'checkbox', checked: lateZi, onChange: (e) => setLateZi(e.target.checked) }),
+          h('span', { className: 'mp-lbl' }, '晚子时换日')) : null,
         h('label', { title: '开启后会请求 OpenStreetMap，把区县/村落到更精确的坐标' },
           h('input', { type: 'checkbox', checked: onlineGeo, onChange: (e) => setOnlineGeo(e.target.checked) }), '联网精确到区县')) : null,
       needAsk(tab) ? h('div', { className: 'mp-askblock' },
@@ -9471,6 +9735,40 @@ function App() {
 
     fx ? h('div', { key: 'fx', className: 'mp-fx', dangerouslySetInnerHTML: { __html: PP.followupHTML(fx) } }) : null,
 
+    (result && result.kind === 'bazi' && result.r.past) ? h('div', { key: 'verify', className: 'mp-verify' },
+      h('div', { className: 'mp-verify-h' }, '验前事 · 过去几年的信号（只读，不改盘）'),
+      result.r.past.rows.map((row) => h('div', { key: row.year, className: 'mp-verify-row' },
+        h('span', { className: 'mp-verify-txt' }, `${row.year} ${row.ganzhi} · ${row.theme}`),
+        h('span', { className: 'mp-verify-btns' }, ['yes', 'no', 'unsure'].map((m) => h('button', {
+          key: m,
+          className: 'mp-chip' + (pastMarks[row.year] === m ? ' on' : ''),
+          onClick: () => setPastMarks(Object.assign({}, pastMarks, { [row.year]: m })),
+        }, m === 'yes' ? '准' : m === 'no' ? '不准' : '不确定'))))),
+      h('div', { className: 'mp-verify-foot' },
+        h('button', { className: 'mp-btn ghost', style: btnStyle, onClick: calcFit }, '算贴合度'),
+        fit ? h('span', { className: 'mp-verify-fit' }, `命中 ${fit.yes}/${fit.answered}（${fit.level}）：${fit.advice}`) : null)) : null,
+
+    (result && result.kind === 'bazi') ? h('div', { key: 'rect', className: 'mp-rect' },
+      h('div', { className: 'mp-verify-h' }, '生时校正 · 用过去的事反推时辰'),
+      rectEvents.map((ev, i) => h('div', { key: i, className: 'mp-rect-row' },
+        h('input', {
+          className: 'mp-input', type: 'number', min: 1900, max: 2100, value: ev.year,
+          onChange: (e) => setRectEvents(rectEvents.map((x, j) => (j === i ? Object.assign({}, x, { year: e.target.value }) : x))),
+        }),
+        h('select', {
+          className: 'mp-input', value: ev.kind,
+          onChange: (e) => setRectEvents(rectEvents.map((x, j) => (j === i ? Object.assign({}, x, { kind: e.target.value }) : x))),
+        }, [['career', '事业变动'], ['wealth', '财运'], ['love', '感情'], ['move', '搬迁/出行'], ['health', '健康'], ['other', '其他']]
+          .map(([v, l]) => h('option', { key: v, value: v }, l))))),
+      h('button', { className: 'mp-btn ghost', style: btnStyle, onClick: runRectify }, '计算候选时辰'),
+      rectRes ? (rectRes.error
+        ? h('div', { className: 'mp-rect-err' }, rectRes.error)
+        : h('div', { className: 'mp-rect-out' },
+          h('div', { className: 'mp-verify-fit' }, rectRes.note),
+          rectRes.candidates.slice(0, 6).map((c) => h('div', {
+            key: c.hour, className: 'mp-rect-cand' + (c === rectRes.best ? ' best' : ''),
+          }, `${c.label} · 时柱 ${c.hourGanzhi} · 日柱 ${c.dayGanzhi} · 命中 ${c.hits}/${c.total}`)))) : null) : null,
+
     (!result && !error) ? h('div', { key: 'ph', className: 'mp-dim', style: { marginTop: 24, fontSize: 12 } },
       '选择体系后点「排盘」。所有计算在本机完成，不上传任何数据。') : null,
   ];

package/engine/geo.js

@@ -143,7 +143,7 @@ const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
 /** OpenStreetMap Nominatim：免密钥、支持中文。失败返回 null。
  *  UA 按 OSM 使用政策要求写明应用与联系方式（改版本时同步这里）。 */
-const USER_AGENT = 'dsh-metaphysics/0.16.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.17.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;

package/engine/index.js

@@ -14,6 +14,8 @@ import { randomOf, isSeed } from './random.js';
 import { interpret, DIRECTIONS, DIRECTION_DEFAULT } from './interpret.js';
 import { followup } from './followup.js';
 import { crossCheck, crossText } from './crosscheck.js';
+import { pastSignals, verifyFit } from './verify.js';
+import { rectifyBirth } from './rectify.js';
 import { fail } from './fail.js';
 import { assertCivil } from './validate.js';
 
@@ -313,6 +315,41 @@ export function compute(args = {}) {
       r.interpret.sections.push({ key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: crossText(r.cross) });
     }
   }
+  // 验前事：把过去若干年的流年信号摊开（只读，不改盘）
+  if (Number.isInteger(args.verifyPast) && args.verifyPast > 0 && r.system === 'bazi') {
+    const years = Math.min(Math.max(args.verifyPast, 1), 10);
+    const from = Number(r.liunianFrom) - years;
+    const pastChart = buildBazi({
+      ...parseDateTime(args.datetime),
+      gender: requireGender(args.gender),
+      lateZi: args.lateZi !== false,
+      trueSolar: args.trueSolar !== false,
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+      nowYear: from,
+    });
+    r.past = {
+      rows: pastSignals(pastChart, Number(r.liunianFrom) - 1),
+      years,
+      until: Number(r.liunianFrom) - 1,
+    };
+  }
+  // 生时校正：候选时辰 × 过去事件，按固定规则打分（仅八字）
+  if (args.rectify === true && r.system === 'bazi') {
+    const base = parseDateTime(args.datetime);
+    r.rectify = rectifyBirth({
+      base: { year: base.year, month: base.month, day: base.day, minute: base.minute },
+      gender: requireGender(args.gender),
+      events: Array.isArray(args.events) ? args.events : [],
+      hours: Array.isArray(args.rectifyHours) ? args.rectifyHours : undefined,
+      lateZi: args.lateZi !== false,
+      trueSolar: args.trueSolar !== false,
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+    });
+  }
   // 追问：围绕已算好的盘回答「某一年 / 某方面」的具体问题
   if (typeof args.ask === 'string' && args.ask.trim()) r.followup = followup(r, args.ask);
   return r;
@@ -546,6 +583,19 @@ export function renderText(result) {
     const f = result.followup;
     parts.push(`【追问】${f.question}\n${f.answer}${f.evidence && f.evidence.length ? `\n　依据：${f.evidence.join('；')}　置信度：${f.confidence}` : ''}`);
   }
+  // 验前事：过去几年的信号（只读）；贴合度由用户在面板里勾选后算，这里只列事实
+  if (result.past && Array.isArray(result.past.rows) && result.past.rows.length) {
+    parts.push(`【验前事】过去 ${result.past.years} 年的流年信号（只读，不改盘）\n` +
+      result.past.rows.map((r) => `· ${r.year} ${r.ganzhi} · ${r.theme}（${r.tier}${r.tenGod ? `，${r.tenGod}` : ''}）`).join('\n') +
+      '\n用法：在面板里勾「准 / 不准 / 不确定」后算贴合度；贴合度低时先核对出生时间、时区与晚子时口径。');
+  }
+  // 生时校正：候选时辰的排序与命中数（固定规则，只缩小范围）
+  if (result.rectify && Array.isArray(result.rectify.candidates)) {
+    const rc = result.rectify;
+    parts.push(`【生时校正】候选时辰 ${rc.candidates.length} 个（固定规则打分，只缩小范围）\n` +
+      rc.candidates.slice(0, 8).map((c) => `· ${c.label} 时柱 ${c.hourGanzhi} / 日柱 ${c.dayGanzhi} · 命中 ${c.hits}/${c.total}`).join('\n') +
+      `\n${rc.note}`);
+  }
   return parts.filter(Boolean).join('\n\n');
 }
 
@@ -554,6 +604,7 @@ export { geocodeAddress, resolveAddress };
 
 export { buildBazi, buildLiuyao, tossLines };
 export { followup };
+export { pastSignals, verifyFit, rectifyBirth };
 export { crossCheck, crossText };
 
 

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

@@ -146,6 +146,26 @@ export function apply(ctx) {
           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 年事业怎么样」「感情如何」。只取盘面已有字段，不重排、不猜测。',

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.16.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": [