dsh-metaphysics 0.15.0 → 0.17.0

package/engine/crosscheck.js

@@ -0,0 +1,133 @@
+// 八字 × 紫微 交叉验证：两套体系各自看同一件事，把「同向 / 有张力 / 只有一边有信号」摆在一起。
+//
+// 注意口径：这不是数学意义上的「一致性检验」，两套体系的取象单位不同（十神 vs 星曜宫位）。
+// 这里只做三件事：把两边对同一维度的说法并列、标出方向、注明各自的依据。
+import { ZIWEI_STARS } from './interpret-data.js';
+
+const groupsOf = (bazi) => (bazi && bazi.frame && bazi.frame.godStats && bazi.frame.godStats.groups) || {};
+const topOf = (groups) => Object.entries(groups).sort((a, b) => Number(b[1]) - Number(a[1]))[0] || null;
+const zwPalace = (zw, name) => (zw.palaces || []).find((p) => p.palace === name) || null;
+const zwMain = (p) => (p && p.stars ? p.stars.filter((s) => s.type === '主星').map((s) => s.name) : []);
+const countSha = (p) => (p && p.stars ? p.stars.filter((s) => s.type === '煞星').length : 0);
+const tierOf = (bazi) => {
+  const age = Number(bazi.liunian && bazi.liunian[0] ? bazi.liunian[0].age : NaN);
+  const list = (bazi.dayun && bazi.dayun.list) || [];
+  let cur = null;
+  for (const d of list) if (Number.isFinite(age) && Number(d.startAge) <= age) cur = d;
+  return cur ? (cur.luck && cur.luck.tier) || '平' : '—';
+};
+const daxianOf = (zw) => {
+  const age = Number(zw.liunian && zw.liunian[0] ? zw.liunian[0].age : NaN);
+  for (const p of zw.palaces || []) {
+    const d = p.daxian || {};
+    if (Number.isFinite(age) && Number(d.start) <= age && age <= Number(d.end)) return p;
+  }
+  return null;
+};
+
+/**
+ * @param {object} bazi buildBazi 的结果
+ * @param {object} zw buildZiwei 的结果
+ * @returns {{items: Array<{key:string,label:string,bazi:string,ziwei:string,stance:string,note:string}>}}
+ */
+export function crossCheck(bazi, zw) {
+  const groups = groupsOf(bazi);
+  const top = topOf(groups);
+  const items = [];
+  const push = (key, label, baziText, ziweiText, stance, note) => items.push({ key, label, bazi: baziText, ziwei: ziweiText, stance, note });
+
+  // ① 事业：八字看十神里的官杀/食伤，紫微看官禄宫主星
+  {
+    const career = zwPalace(zw, '官禄');
+    const main = zwMain(career);
+    const baziStrong = Number(groups['官杀'] || 0) + Number(groups['食伤'] || 0) >= 2;
+    const ziweiHas = main.length > 0;
+    const stance = baziStrong && ziweiHas ? '同向' : !baziStrong && !ziweiHas ? '同向' : '有张力';
+    push('career', '事业主线',
+      `${top ? `十神以${top[0]}最重（${top[1]}）` : '十神未取到'}；官杀+食伤权重 ${(Number(groups['官杀'] || 0) + Number(groups['食伤'] || 0)).toFixed(1)}`,
+      main.length ? `官禄宫主星 ${main.join('、')}${ZIWEI_STARS[main[0]] ? `（${ZIWEI_STARS[main[0]].work}）` : ''}` : '官禄无正曜',
+      stance,
+      stance === '同向' ? '两边都指向（或都不强调）事业主线，方向可互参' : '一边强调事业主线、一边信号弱，建议以信号强的一边为主，另一边作补充');
+  }
+
+  // ② 财富：八字看财星权重，紫微看财帛宫主星与煞星
+  {
+    const wealth = zwPalace(zw, '财帛');
+    const main = zwMain(wealth);
+    const sha = countSha(wealth);
+    const w = Number(groups['财'] || 0);
+    const baziStrong = w >= 2;
+    const ziweiStrong = main.length > 0;
+    const stance = baziStrong && ziweiStrong ? '同向' : !baziStrong && !ziweiStrong ? '同向' : '有张力';
+    push('wealth', '财运结构',
+      `财星权重 ${w}${baziStrong ? '（偏强）' : '（偏弱）'}`,
+      `${main.length ? `财帛主星 ${main.join('、')}` : '财帛无正曜'}${sha ? `；煞星 ${sha} 颗` : ''}`,
+      stance,
+      '两套体系对「财」的定义不同：八字看十神财星，紫微看财帛宫，只作对照，不作数值合并');
+  }
+
+  // ③ 感情：八字看配偶星，紫微看夫妻宫主星
+  {
+    const spouse = zwPalace(zw, '夫妻');
+    const main = zwMain(spouse);
+    const isMale = bazi.input && bazi.input.gender === 'male';
+    const key = isMale ? '财' : '官杀';
+    const v = Number(groups[key] || 0);
+    const baziStrong = v >= 2;
+    const ziweiStrong = main.length > 0;
+    const stance = baziStrong && ziweiStrong ? '同向' : !baziStrong && !ziweiStrong ? '同向' : '有张力';
+    push('love', '感情线索',
+      `${isMale ? '妻' : '夫'}星（${key}）权重 ${v}${baziStrong ? '（不弱）' : '（偏弱）'}`,
+      main.length ? `夫妻宫主星 ${main.join('、')}${ZIWEI_STARS[main[0]] ? `（${ZIWEI_STARS[main[0]].love}）` : ''}` : '夫妻宫无正曜',
+      stance,
+      stance === '同向' ? '两边对感情的强弱判断接近' : '一边说缘分不弱、一边主星信号弱，宜按「多主动创造场景」处理');
+  }
+
+  // ④ 身体：八字看最弱五行，紫微看疾厄宫主星与煞星
+  {
+    const wx = bazi.wuxing || {};
+    const weakest = Object.entries(wx).sort((a, b) => Number(a[1]) - Number(b[1]))[0];
+    const health = zwPalace(zw, '疾厄');
+    const main = zwMain(health);
+    const sha = countSha(health);
+    push('health', '身体关注点',
+      weakest ? `最弱五行 ${weakest[0]}（${weakest[1]}）` : '五行未取到',
+      `${main.length ? `疾厄主星 ${main.join('、')}` : '疾厄无正曜'}${sha ? `；煞星 ${sha} 颗` : ''}`,
+      '互补',
+      '两边指向的器官/系统不一定相同，合并起来看更稳；任何健康问题以体检与医生为准');
+  }
+
+  // ⑤ 节奏：八字当前大运档位 vs 紫微当前大限的煞星密度
+  {
+    const t = tierOf(bazi);
+    const d = daxianOf(zw);
+    const sha = d ? countSha(d) : 0;
+    const good = ['吉', '大吉'];
+    const bad = ['忌', '大忌'];
+    const baziGood = good.includes(t);
+    const baziBad = bad.includes(t);
+    const ziweiHeavy = sha >= 2;
+    let stance = '有张力';
+    let note = '一边顺、一边压，按「大方向跟顺的一边、具体动作避开压的年份」处理';
+    if ((baziGood && !ziweiHeavy) || (baziBad && ziweiHeavy) || (!baziGood && !baziBad && !ziweiHeavy)) {
+      stance = '同向';
+      note = '两边对当前阶段的松紧判断接近';
+    }
+    push('rhythm', '当前节奏',
+      `大运档位 ${t}`,
+      `${d ? `大限在${d.palace}` : '大限未取到'}${sha ? `；煞星 ${sha} 颗` : '；无煞星'}`,
+      stance, note);
+  }
+
+  return { items };
+}
+
+export default crossCheck;
+
+/** 把交叉验证结果拼成可读文本（interpret 的分节与工具输出共用） */
+export function crossText(cross) {
+  if (!cross || !Array.isArray(cross.items)) return '';
+  return cross.items
+    .map((i) => `· ${i.label}：八字——${i.bazi}；紫微——${i.ziwei}；判断：${i.stance}（${i.note}）`)
+    .join('\n');
+}

package/engine/followup.js

@@ -0,0 +1,173 @@
+// 追问：围绕已经算好的一盘，回答「某一年 / 某个方面」的具体问题。
+//
+// 约束：这里不重新排盘、不调用模型、不引入新算法——只从盘面已有字段里取数，
+// 并明确写出「依据的是哪一条」。找不到就直说找不到，并给出可问的范围。
+import { ZIWEI_STARS } from './interpret-data.js';
+
+const TOPICS = [
+  { key: 'career', label: '事业', words: ['事业', '工作', '跳槽', '升职', '创业', '职业', '岗位', '离职', '加薪', '面试', 'offer'] },
+  { key: 'wealth', label: '财富', words: ['财', '钱', '收入', '投资', '买房', '存款', '亏', '赚', '分红'] },
+  { key: 'love', label: '感情', words: ['感情', '婚', '恋', '对象', '分手', '复合', '姻缘', '结婚', '桃花'] },
+  { key: 'health', label: '健康', words: ['健康', '病', '身体', '手术', '失眠', '体检', '医院'] },
+  { key: 'study', label: '学业', words: ['学业', '考试', '学习', '考研', '考公', '证书', '升学'] },
+  { key: 'travel', label: '出行', words: ['出行', '搬家', '旅行', '出国', '迁', '远行'] },
+];
+
+const ZW_PALACE_BY_TOPIC = { career: '官禄', wealth: '财帛', love: '夫妻', health: '疾厄', study: '官禄', travel: '迁移', overall: '命宫' };
+
+const parseYear = (q, r) => {
+  const m = String(q).match(/(20\d{2})\s*年?/);
+  if (m) return Number(m[1]);
+  const base = Array.isArray(r.liunian) && r.liunian[0] ? Number(r.liunian[0].year) : null;
+  if (!base) return null;
+  if (/明年/.test(q)) return base + 1;
+  if (/后年/.test(q)) return base + 2;
+  if (/去年/.test(q)) return base - 1;
+  if (/今年|本年/.test(q)) return base;
+  return null;
+};
+
+const topicOf = (q) => TOPICS.find((t) => t.words.some((w) => String(q).includes(w))) || null;
+
+function baziAnswer(r, q) {
+  const year = parseYear(q, r);
+  const topic = topicOf(q);
+  const liunian = Array.isArray(r.liunian) ? r.liunian : [];
+  const dayun = Array.isArray(r.dayun?.list) ? r.dayun.list : [];
+  const years = liunian.map((l) => l.year);
+  if (year && !liunian.some((l) => Number(l.year) === year)) {
+    return {
+      ok: false, year, topic,
+      answer: `这一盘已排的流年范围是 ${years[0]}–${years[years.length - 1]}，没有 ${year} 年。可以把问题改到范围内，或用 asOf 指定你想看的年份重新排盘。`,
+      evidence: [`已排流年：${years.join('、')}`], confidence: '弱',
+    };
+  }
+  if (year) {
+    const l = liunian.find((x) => Number(x.year) === year);
+    const d = dayun.find((x) => Number(x.startAge) <= Number(l.age) && Number(l.age) <= Number(x.startAge) + 9) || null;
+    const tier = l.luck?.tier || '平';
+    const reasons = (l.luck?.reasons || []).slice(0, 3);
+    const rel = (l.relations || []).join('、');
+    const topicLine = topic ? topicSentence(r, topic.key) : '';
+    return {
+      ok: true, year, topic,
+      answer: `${year} 年（${l.ganzhi}）流年，十神为${l.stemTenGod || '—'}，档位「${tier}」；所行大运 ${d ? `${d.ganzhi}（${d.luck?.tier || '平'}）` : '未取到'}。` +
+        `${reasons.length ? `理由：${reasons.join('，')}。` : ''}${rel ? `与该年地支相关的原局关系：${rel}。` : ''}${topicLine}`,
+      evidence: [
+        `流年 ${l.year} ${l.ganzhi}·${l.stemTenGod || ''}·${tier}`,
+        d ? `大运 ${d.ganzhi}·${d.luck?.tier || '平'}` : '',
+        rel ? `原局关系 ${rel}` : '',
+        topic ? `问题方向：${topic.label}` : '',
+      ].filter(Boolean),
+      confidence: d && reasons.length ? '强' : '中',
+    };
+  }
+  if (topic) {
+    // 维度只有「整体/工作/事业/感情/健康」，财富与学业、出行没有独立维度：
+    // 就近取一条最相关的维度，再补一句该方面的盘面值，避免答非所问。
+    const near = { wealth: 'overall', study: 'work', travel: 'overall' }[topic.key] || topic.key;
+    const dim = (r.interpret?.dimensions || []).find((x) => x.key === topic.key || x.key === near);
+    if (dim) {
+      const groups = (r.frame && r.frame.godStats && r.frame.godStats.groups) || {};
+      const quant = topic.key === 'wealth'
+        ? ` 财星权重 ${Number(groups['财'] || 0)}（只作结构参考，不含金额）。`
+        : '';
+      return {
+        ok: true, year: null, topic,
+        answer: `按${topic.label}这条线看：${dim.text}${quant}${dim.advice ? ` 建议：${dim.advice}` : ''}`,
+        evidence: (dim.evidence || []).slice(0, 4), confidence: dim.confidence || '中',
+      };
+    }
+  }
+  return {
+    ok: false, year: null, topic,
+    answer: `这个问题里没有识别到具体的年份或方面。可以这样问：「2027 年事业怎么样」「财运如何」「感情在 2028 年」；已排流年是 ${years[0]}–${years[years.length - 1]}。`,
+    evidence: [`可问年份：${years.join('、')}`], confidence: '弱',
+  };
+}
+
+function ziweiAnswer(r, q) {
+  const year = parseYear(q, r);
+  const topic = topicOf(q);
+  const liunian = Array.isArray(r.liunian) ? r.liunian : [];
+  if (year && !liunian.some((l) => Number(l.year) === year)) {
+    return {
+      ok: false, year, topic,
+      answer: `这一盘的流年表覆盖 ${liunian[0]?.year}–${liunian[liunian.length - 1]?.year}，没有 ${year} 年；可以换一个年份，或用 asOf 指定起点重新排盘。`,
+      evidence: [`流年表：${liunian.map((l) => l.year).join('、')}`], confidence: '弱',
+    };
+  }
+  if (year) {
+    const l = liunian.find((x) => Number(x.year) === year);
+    const dx = l.daxian || {};
+    return {
+      ok: true, year, topic,
+      answer: `${year} 年（${l.ganzhi}，${l.age} 岁）流年命宫落在「${l.lifePalace ? l.lifePalace.palace : '—'}」，四化为 ${(l.mutagen || []).join('、') || '不明显'}；所行大限${dx.palace ? `在${dx.palace}（${dx.start}–${dx.end} 岁）` : '未取到'}。${topic ? `与「${topic.label}」对应的宫位信号见下条依据。` : ''}`,
+      evidence: [
+        `流年命宫 ${l.lifePalace ? l.lifePalace.palace : '—'}（${l.lifePalace ? l.lifePalace.branch : '—'}）`,
+        `四化 ${(l.mutagen || []).join('、') || '不明显'}`,
+        dx.palace ? `大限 ${dx.palace}·${dx.start}–${dx.end}岁` : '',
+      ].filter(Boolean),
+      confidence: (l.mutagen || []).length >= 3 ? '强' : '中',
+    };
+  }
+  if (topic) {
+    const name = ZW_PALACE_BY_TOPIC[topic.key] || '命宫';
+    const p = (r.palaces || []).find((x) => x.palace === name);
+    if (p) {
+      const stars = (p.stars || []).filter((s) => s.type === '主星').map((s) => s.name);
+      const trait = stars.map((s) => ZIWEI_STARS[s]?.trait).filter(Boolean).slice(0, 2).join('；');
+      return {
+        ok: true, year: null, topic,
+        answer: `「${topic.label}」看${name}：主星${stars.length ? stars.join('、') : '无正曜（借对宫）'}${trait ? `——${trait}` : ''}。宫支${p.branch}，${p.stems ? '' : ''}生年四化与煞星的影响需结合报告里的对应分节一起看。`,
+        evidence: [`${name} ${p.branch}·${stars.join('、') || '无正曜'}`, ...(p.shensha || []).slice(0, 3)],
+        confidence: stars.length ? '强' : '弱',
+      };
+    }
+  }
+  return {
+    ok: false, year: null, topic,
+    answer: '没有识别到具体年份或方面。可以问「2028 年事业」「感情怎么样」「财运在 2030 年」；也可以直接问某个宫位，如「夫妻宫」。',
+    evidence: [], confidence: '弱',
+  };
+}
+
+function topicSentence(r, key) {
+  const map = { career: '事业', wealth: '财富', love: '感情', health: '健康', study: '学业', travel: '出行' };
+  return `这段时间可以重点对照报告里「${map[key] || '整体'}」一节看。`;
+}
+
+function genericAnswer(r, q) {
+  const topic = topicOf(q);
+  const sections = Array.isArray(r.interpret?.sections) ? r.interpret.sections : [];
+  const hit = topic
+    ? sections.find((s) => s.label.includes(topic.label) || s.text.includes(topic.label))
+    : null;
+  if (hit) {
+    return { ok: true, year: null, topic, answer: hit.text, evidence: [`引用分节：${hit.label}`], confidence: '中' };
+  }
+  const first = sections[0];
+  return {
+    ok: false, year: null, topic,
+    answer: first
+      ? `这一盘的追问需要落到具体方面（事业 / 财富 / 感情 / 健康 / 学业 / 出行）。先看「${first.label}」这一节，或把问题说得更具体一点。`
+      : '这一盘暂时没有可追问的分节；先看完整解析，再问具体方面。',
+    evidence: [], confidence: '弱',
+  };
+}
+
+/**
+ * 回答一个追问。
+ * @param {object} r 已算好的盘（compute 的结果，带不带 interpret 都行）
+ * @param {string} question 用户问题
+ * @returns {{question:string, ok:boolean, year:number|null, topic:object|null, answer:string, evidence:string[], confidence:string}}
+ */
+export function followup(r, question) {
+  const q = String(question || '').trim();
+  const result = r && r.system === 'bazi' ? baziAnswer(r, q)
+    : r && r.system === 'ziwei' ? ziweiAnswer(r, q)
+      : genericAnswer(r, q);
+  return { question: q, ...result };
+}
+
+export default followup;

package/engine/geo.js

@@ -143,7 +143,7 @@ const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
 /** OpenStreetMap Nominatim：免密钥、支持中文。失败返回 null。
  *  UA 按 OSM 使用政策要求写明应用与联系方式（改版本时同步这里）。 */
-const USER_AGENT = 'dsh-metaphysics/0.15.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

@@ -12,6 +12,10 @@ import { geocodeAddress, resolveAddress } from './geo.js';
 import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
 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';
 
@@ -291,6 +295,63 @@ export function compute(args = {}) {
       direction: typeof args.direction === 'string' ? args.direction : 'general',
     });
   }
+  // 八字 × 紫微交叉验证：同一份出生信息再排另一套盘，并列两边对同一件事的说法
+  if (args.cross === true && (r.system === 'bazi' || r.system === 'ziwei')) {
+    const cdt = parseDateTime(args.datetime);
+    const common = {
+      ...cdt,
+      gender: requireGender(args.gender),
+      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,
+      trueSolar: args.trueSolar !== false,
+    };
+    const asOf = checkAsOf(args.asOf);
+    const other = r.system === 'bazi'
+      ? buildZiwei({ ...common, leapAsNext: args.leapAsNext === true, asOf })
+      : buildBazi({ ...common, lateZi: args.lateZi !== false, nowYear: asOf ? asOf.year : undefined });
+    r.cross = crossCheck(r.system === 'bazi' ? r : other, r.system === 'ziwei' ? r : other);
+    if (r.interpret) {
+      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;
 }
 
@@ -302,10 +363,14 @@ export function interpretText(i) {
   if (i.answer) out.push(`▶ 先答所问：${i.answer}`);
   if (i.plain) out.push(`▶ 说人话：${i.plain}`);
   if (i.lead) out.push(i.lead);
+  // 一页读懂：报告顶部的五条结论，先给读的人一个「整体形状」
+  if (Array.isArray(i.outline) && i.outline.length) {
+    out.push('一页读懂：' + i.outline.map((o) => `${o.label}·${o.text}`).join('　'));
+  }
   // 解析生成失败时不能只返回一个空壳：盘面数据仍然可用，但要让调用方知道"这段没生成出来"
   if (i.error) out.push(`⚠ 解析生成失败：${i.error}（上方盘面数据本身可用）`);
   for (const d of i.dimensions || []) {
-    const evidence = Array.isArray(d.evidence) && d.evidence.length ? `\n　依据：${d.evidence.join('；')}` : '';
+    const evidence = Array.isArray(d.evidence) && d.evidence.length ? `\n　依据：${d.evidence.join('；')}${d.confidence ? `　置信度：${d.confidence}` : ''}` : '';
     const plain = d.plain ? `（${d.plain}）` : '';
     // 知识条目：「为什么这样断」＋出处＋可信度标注，是结论与依据之外的第三层
     const know = (d.knowledge || [])
@@ -314,6 +379,12 @@ export function interpretText(i) {
     out.push(`${d.label}：${plain}${d.text}${d.advice ? `　建议：${d.advice}` : ''}${evidence}${know}`);
   }
   for (const s of i.sections || []) out.push(`${s.label}：${s.text}`);
+  // 三张表：大运 / 流年 / 触发事件（纯文本对齐，工具输出也能直接读）
+  for (const t of i.tables || []) {
+    if (!Array.isArray(t.rows) || !t.rows.length) continue;
+    out.push(`【${t.title}】`);
+    out.push([t.columns.join(' | '), ...t.rows.map((r) => r.join(' | '))].join('\n'));
+  }
   if (Array.isArray(i.followups) && i.followups.length) {
     out.push('还可以这样追问：' + i.followups.map((q) => `「${q}」`).join('　'));
   }
@@ -502,15 +573,39 @@ function computeRaw(args = {}) {
 /** 给模型的紧凑文本（去掉大字段，保留摘要；带解析时附上解析） */
 export function renderText(result) {
   const base = result.summary ?? JSON.stringify(result, null, 2);
-  if (!result.interpret) return base;
-  const extra = interpretText(result.interpret);
-  return extra ? `${base}\n\n${extra}` : base;
+  const parts = [base];
+  if (result.interpret) {
+    const extra = interpretText(result.interpret);
+    if (extra) parts.push(extra);
+  }
+  if (result.cross) parts.push(`【八字 × 紫微 交叉验证】\n${crossText(result.cross)}`);
+  if (result.followup) {
+    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');
 }
 
 /** 对外暴露：地址解析（异步，含联网） */
 export { geocodeAddress, resolveAddress };
 
 export { buildBazi, buildLiuyao, tossLines };
+export { followup };
+export { pastSignals, verifyFit, rectifyBirth };
+export { crossCheck, crossText };
 
 
 

package/engine/interpret.js

@@ -162,6 +162,7 @@ function baziInterpret(r) {
   const primary = pick(frame, 'primaryName', '未取定');
   const gender = pick(r.input, 'gender', '');
   const isMale = gender === 'male';
+  const spouseKey = isMale ? '财' : '官杀';
 
   // 当前大运与流年
   const age = Number(pick(r.liunian?.[0], 'age', NaN));
@@ -368,15 +369,47 @@ function baziInterpret(r) {
       key: 'geju', label: '格局依据',
       text: (Array.isArray(frame.geju) ? frame.geju : []).map((g) => `${g.name}（${g.kind}）：${g.evidence}`).join('；') || '未取到格局',
     },
+    {
+      key: 'quant', label: '量化口径',
+      text: `本报告的量化只到「档位」：事业看十神权重（${topName} ${top[0]?.[1] ?? '—'}）、财富看财星权重（${groups['财'] ?? 0}）、感情看配偶星权重（${spouseKey} ${groups[spouseKey] ?? 0}）；大运/流年用「大吉 / 吉 / 平 / 忌」四档。不换算金额、不给健康诊断——那需要地域、家庭、行业与体检数据，命盘本身推不出来。`,
+    },
     {
       key: 'limits', label: '未纳入',
       text: '本盘没有计算：流月与流日、神煞的加权轻重、地支藏干的动态引化（合冲后再论）。取用以扶抑为主、调候只做简化提示，各派取法不同；真太阳时未含历史时区与夏令时。把这些补上会改变"强弱"的边际判断，所以这里只给方向，不下断语。',
     },
   ];
 
+  // 一页读懂：报告顶部的五条结论（整体 / 事业 / 财富 / 感情 / 节奏）。
+  // 只做「摘要」，不引入新判断——全部取自下面已经算好的字段。
+  const outline = [
+    { key: 'overall', label: '整体', text: `${level}，喜${join(favor) || '—'}、忌${join(avoid) || '—'}` },
+    { key: 'career', label: '事业', text: `主格${primary}，${topName}偏旺` },
+    { key: 'wealth', label: '财富', text: `财星权重 ${groups['财'] ?? 0}${favor.includes('金') ? '，喜金助财' : ''}` },
+    { key: 'love', label: '感情', text: `${spouseKey}星权重 ${groups[spouseKey] ?? 0}，日支 ${pick(r.pillars?.day, 'branch', '—')}` },
+    { key: 'rhythm', label: '节奏', text: `当前${pick(cur, 'ganzhi', '—')}（${curTier}），${pick(ln, 'year', '')} ${pick(ln, 'ganzhi', '')}（${lnTier}）` },
+  ];
+  // 三张表：大运 / 流年 / 触发事件。都是「把已有字段摊平」，不新增算法。
+  const tables = [
+    {
+      key: 'dayun', title: '大运表', columns: ['大运', '年龄', '十神', '档位', '理由'],
+      rows: list.map((d) => [d.ganzhi, `${d.startAge}–${d.startAge + 9}`, d.stemTenGod || '', d.luck?.tier || '平', (d.luck?.reasons || []).join('，')]),
+    },
+    {
+      key: 'liunian', title: '流年表（近十年）', columns: ['年份', '干支', '十神', '档位', '与原局'],
+      rows: (r.liunian || []).slice(0, 10).map((l) => [String(l.year), l.ganzhi, l.stemTenGod || '', l.luck?.tier || '平', (l.relations || []).join('、')]),
+    },
+  ];
+  const triggerRows = (r.liunian || [])
+    .filter((l) => Array.isArray(l.relations) && l.relations.length)
+    .slice(0, 10)
+    .map((l) => [String(l.year), l.relations.join('、'), `流年${l.ganzhi}与原局地支：${l.relations.join('、')}`]);
+  if (triggerRows.length) {
+    tables.push({ key: 'triggers', title: '触发事件表', columns: ['年份', '触发', '依据'], rows: triggerRows });
+  }
+
   return {
     lead: `下面按五个维度拆开说。所有内容来自你这张命盘的结构，讲的是倾向与建议，不是预言——方向供你参考，怎么走在你自己。`,
-    dimensions, sections,
+    dimensions, sections, outline, tables,
   };
 }
 
@@ -586,6 +619,10 @@ function ziweiInterpret(r) {
         return `大限：${dx || '—'}。\n近五年流年：${yrs || '—'}。\n读法：大限定十年的主题，流年四化指出今年往哪边偏；两层方向相反时，以守住大限主题为主。`;
       })(),
     },
+    {
+      key: 'quant', label: '量化口径',
+      text: '紫微这边只数「宫位里有什么」：大限看落宫与四化命中数、流年看命宫与四化星数；不把星曜折算成分数，也不预测金额与疾病诊断。四化命中数只是结构计数，不等于吉凶强度。',
+    },
     {
       key: 'limits', label: '未纳入',
       text: '本盘没有计算：飞星四化（宫干引发的连锁）、小限与大限的加权、流日流时的具体事项定位，以及双星组合的强弱细分。四化表取中州派常用口径，其他流派（如飞星派）结论会不同；这些不改变盘面事实，只影响轻重，所以只作方向参考。',
@@ -623,9 +660,56 @@ function ziweiInterpret(r) {
     });
   }
 
+  // 一页读懂：五条结论（整体 / 事业 / 财富 / 感情 / 节奏），全部取自下面已算好的字段
+  const outline = [
+    { key: 'overall', label: '整体', text: `命宫${soulStar}${soulOwn ? '' : '（借对宫）'}${S.trait ? `，${S.trait}` : ''}` },
+    { key: 'career', label: '事业', text: `官禄${careerStar || '无正曜'}` },
+    { key: 'wealth', label: '财富', text: `财帛${wealthStar || '无正曜'}` },
+    { key: 'love', label: '感情', text: `夫妻${spouseStar || '无正曜'}` },
+    {
+      key: 'rhythm', label: '节奏',
+      text: daxianPalace && daxianPalace.daxian
+        ? `当前大限${daxianPalace.palace}（${daxianPalace.daxian.start}–${daxianPalace.daxian.end}岁）${r.liunian?.[0]?.year ? `，${r.liunian[0].year} 流年` : ''}`
+        : '当前大限未取到',
+    },
+  ];
+  // 三张表：大限 / 流年 / 触发事件（大限四化）。只摊平已有字段，不加新判断。
+  const daxianSorted = (r.daxianList || []).slice().sort((a, b) => a.ages[0] - b.ages[0]);
+  const tables = [
+    {
+      key: 'daxian', title: '大限表', columns: ['大限', '年龄', '会主星', '四化'],
+      rows: daxianSorted.map((d) => [
+        d.palace,
+        `${d.ages[0]}–${d.ages[1]}`,
+        (d.mainStars || []).join('、'),
+        (d.mutagenHits || []).map((m) => `${m.star}${m.type}→${m.palace}`).join('、'),
+      ]),
+    },
+    {
+      key: 'liunian', title: '流年表（近六年）', columns: ['年份', '干支', '年龄', '命宫', '四化'],
+      rows: (r.liunian || []).slice(0, 6).map((l) => [
+        String(l.year),
+        l.ganzhi,
+        String(l.age),
+        l.lifePalace ? l.lifePalace.palace : '—',
+        (l.mutagen || []).join('、'),
+      ]),
+    },
+  ];
+  const triggerRows = daxianSorted
+    .flatMap((d) => (d.mutagenHits || []).map((m) => [
+      `${d.palace}（${d.ages[0]}–${d.ages[1]}岁）`,
+      `${m.star}化${m.type}→${m.palace}`,
+      `大限${d.palace}引动`,
+    ]))
+    .slice(0, 12);
+  if (triggerRows.length) {
+    tables.push({ key: 'triggers', title: '触发事件表（大限四化）', columns: ['大限', '触发', '依据'], rows: triggerRows });
+  }
+
   return {
     lead: `紫微斗数看的是你与环境的互动方式。下面按五个维度拆开，讲的是性格与处境的倾向，具体怎么选仍然在你。`,
-    dimensions, sections,
+    dimensions, sections, outline, tables,
   };
 }
 
@@ -1198,10 +1282,43 @@ function enrichPlain(result, r, ask) {
   };
 }
 
+/** 各体系采用的技法标签：证据卡第一行要写「这条结论是用什么方法得出的」 */
+const TECHNIQUE = {
+  bazi: '八字（月令 · 十神 · 大运流年）',
+  ziwei: '紫微（宫位 · 四化 · 大限流年）',
+  liuyao: '六爻（卦宫 · 世应 · 动爻 · 日辰）',
+  meihua: '梅花（体用 · 互卦 · 变卦）',
+  daliuren: '六壬（月将加时 · 四课 · 三传）',
+  qimen: '奇门（九宫 · 值符值使 · 用神）',
+  tarot: '塔罗（牌阵 · 正逆位 · 元素）',
+  hepan: '合盘（日主 · 夫妻宫 · 五行互补）',
+};
+
+/** 置信度：只按公开证据条数分档，不引入新算法——3 条以上「强」、2 条「中」、其余「弱」 */
+const confidenceOf = (dim) => {
+  const n = Array.isArray(dim && dim.evidence) ? dim.evidence.length : 0;
+  return n >= 3 ? '强' : n >= 2 ? '中' : '弱';
+};
+
+const withReportMeta = (body, r, ask) => enrichPlain({
+  ...body,
+  moduleType: MODULE_TYPE[r.system] || 'natal',
+  system: r.system,
+  systemLabel: SYSTEM_LABEL[r.system] || r.system,
+  title: '解析与详解',
+  dimensions: (body.dimensions || []).map((d) => ({ ...d, confidence: d.confidence || confidenceOf(d) })),
+  sections: body.sections || [],
+  outline: body.outline || [],
+  tables: body.tables || [],
+  technique: TECHNIQUE[r.system] || SYSTEM_LABEL[r.system] || r.system,
+  disclaimer: body.disclaimer || DISCLAIMER,
+  ask,
+}, r, ask);
+
 export function interpret(r, opts) {
   if (!isObj(r) || !r.system) return null;
   const ask = askOf(opts);
-  if (r.system === 'qimen') return enrichPlain(interpretQimen(r, opts), r, ask);
+  if (r.system === 'qimen') return withReportMeta(interpretQimen(r, opts), r, ask);
   const fn = BUILDERS[r.system];
   if (!fn) return null;
   let body;
@@ -1216,22 +1333,21 @@ export function interpret(r, opts) {
       lead: '这一盘的解析暂未生成，请稍后重试。',
       dimensions: [],
       sections: [],
+      outline: [],
+      tables: [],
+      technique: TECHNIQUE[r.system] || '',
       disclaimer: DISCLAIMER,
       error: String(e && e.message),
       ask,
     };
   }
   const tuned = applyAsk(body.dimensions || [], ask, body.lead || '');
-  return enrichPlain({
-    moduleType: MODULE_TYPE[r.system] || 'natal',
-    system: r.system,
-    systemLabel: SYSTEM_LABEL[r.system] || r.system,
-    title: '解析与详解',
+  return withReportMeta({
     lead: tuned.lead,
     dimensions: tuned.dims,
     sections: body.sections || [],
-    disclaimer: DISCLAIMER,
-    ask,
+    outline: body.outline || [],
+    tables: body.tables || [],
   }, r, ask);
 }