dsh-metaphysics 0.14.3 → 0.16.0

package/client.js

@@ -7,6 +7,167 @@ window.__ModuleLoader__.load({
     if (!React) return { inject: [], apply() {} };
     const h = React.createElement;
     const __mods = {};
+__mods.fail = (function () {
+
+const fail = (code, message) => {
+  const e = new Error(message);
+  e.code = code;
+  return e;
+};
+
+return { fail };
+})();
+
+__mods.validate = (function () {
+const { fail } = __mods.fail;
+
+const MIN_YEAR = 1600;
+const MAX_YEAR = 2400;
+
+function isLeapYear(year) {
+  return (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+}
+
+function daysInMonth(year, month) {
+  if (month === 2) return isLeapYear(year) ? 29 : 28;
+  return [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1] || 0;
+}
+
+const show = (v) => (typeof v === 'string' ? `「${v}」` : String(v));
+const HINT = '引擎只接受解析好的公历字段 { year, month, day, hour?, minute? }；字符串请先交给宿主层的 parseDateTime 解析';
+
+function assertCivil(input, who = '') {
+  const p = who ? `${who} 的` : '';
+  if (!input || typeof input !== 'object' || Array.isArray(input)) {
+    const got = input === null ? 'null' : Array.isArray(input) ? '数组' : typeof input;
+    throw fail('E_INPUT', `${p}入参必须是对象（收到 ${got}）；${HINT}`);
+  }
+  const hour = input.hour === undefined ? 0 : input.hour;
+  const minute = input.minute === undefined ? 0 : input.minute;
+  for (const [key, value] of [['year', input.year], ['month', input.month], ['day', input.day], ['hour', hour], ['minute', minute]]) {
+    if (!Number.isInteger(value)) throw fail('E_INPUT', `${p}${key} 必须是整数（收到 ${show(value)}）；${HINT}`);
+  }
+  if (input.year < MIN_YEAR || input.year > MAX_YEAR) {
+    throw fail('E_INPUT', `${p}year 超出支持范围 ${MIN_YEAR}–${MAX_YEAR}（收到 ${input.year}）；更早的年份时区与历法口径不可靠`);
+  }
+  if (input.month < 1 || input.month > 12) {
+    throw fail('E_INPUT', `${p}month 超出范围 1–12（收到 ${input.month}）`);
+  }
+  const max = daysInMonth(input.year, input.month);
+  if (input.day < 1 || input.day > max) {
+    throw fail('E_INPUT', `${p}日期不存在：${input.year}-${input.month}-${input.day}（${input.year} 年 ${input.month} 月只有 ${max} 天）`);
+  }
+  if (hour < 0 || hour > 23) throw fail('E_INPUT', `${p}hour 超出范围 0–23（收到 ${hour}）`);
+  if (minute < 0 || minute > 59) throw fail('E_INPUT', `${p}minute 超出范围 0–59（收到 ${minute}）`);
+  return input;
+}
+
+return { MIN_YEAR, MAX_YEAR, isLeapYear, daysInMonth, assertCivil };
+})();
+
+__mods.lru = (function () {
+
+function createLru({ max = 64, ttlMs = 0, name = 'lru', now = () => Date.now() } = {}) {
+  const map = new Map();
+  const stats = { name, hits: 0, misses: 0, evictions: 0, expirations: 0 };
+
+  const expired = (entry) => ttlMs > 0 && now() - entry.at > ttlMs;
+
+  return {
+    name,
+    max,
+    ttlMs,
+    get(key) {
+      const entry = map.get(key);
+      if (!entry || expired(entry)) {
+        if (entry) { map.delete(key); stats.expirations += 1; }
+        stats.misses += 1;
+        return undefined;
+      }
+      map.delete(key);
+      map.set(key, entry);
+      stats.hits += 1;
+      return entry.value;
+    },
+    set(key, value) {
+      if (map.has(key)) map.delete(key);
+      map.set(key, { value, at: now() });
+      while (map.size > max) {
+        map.delete(map.keys().next().value);
+        stats.evictions += 1;
+      }
+      return value;
+    },
+    has(key) {
+      const entry = map.get(key);
+      if (!entry) return false;
+      if (expired(entry)) { map.delete(key); stats.expirations += 1; return false; }
+      return true;
+    },
+    delete(key) { return map.delete(key); },
+    clear() { map.clear(); },
+    get size() { return map.size; },
+    stats() {
+      const total = stats.hits + stats.misses;
+      return {
+        name,
+        size: map.size,
+        max,
+        hits: stats.hits,
+        misses: stats.misses,
+        evictions: stats.evictions,
+        expirations: stats.expirations,
+        hitRate: total ? stats.hits / total : 0,
+      };
+    },
+  };
+}
+
+return { createLru };
+})();
+
+__mods.nayin = (function () {
+
+const NAYIN_NAMES = [
+  '海中金', '炉中火', '大林木', '路旁土', '剑锋金',
+  '山头火', '涧下水', '城头土', '白蜡金', '杨柳木',
+  '泉中水', '屋上土', '霹雳火', '松柏木', '长流水',
+  '沙中金', '山下火', '平地木', '壁上土', '金箔金',
+  '覆灯火', '天河水', '大驿土', '钗钏金', '桑柘木',
+  '大溪水', '沙中土', '天上火', '石榴木', '大海水',
+];
+
+function nayinOf(ganzhiIdx) {
+  const i = ((Number(ganzhiIdx) % 60) + 60) % 60;
+  const name = NAYIN_NAMES[Math.floor(i / 2)];
+  return { name, element: name[2] };
+}
+
+return { NAYIN_NAMES, nayinOf };
+})();
+
+__mods.sanhe = (function () {
+
+const SANHE_GROUPS = [
+  { branches: ['申', '子', '辰'], element: '水' },
+  { branches: ['亥', '卯', '未'], element: '木' },
+  { branches: ['寅', '午', '戌'], element: '火' },
+  { branches: ['巳', '酉', '丑'], element: '金' },
+];
+
+const SANHE = Object.fromEntries(SANHE_GROUPS.map((g) => [g.branches.join(''), g.element]));
+
+const SANHE_ELEMENT = Object.fromEntries(
+  SANHE_GROUPS.flatMap((g) => g.branches.map((b) => [b, g.element])),
+);
+
+function sanheGroupOf(branch) {
+  return SANHE_GROUPS.find((g) => g.branches.includes(branch)) || null;
+}
+
+return { SANHE_GROUPS, SANHE, SANHE_ELEMENT, sanheGroupOf };
+})();
+
 __mods['vsop-earth'] = (function () {
 const L0 = [
   [1.75347045673,0,0],[0.03341656453,4.66925680415,6283.0758499914],[0.00034894275,4.62610242189,12566.1516999828],[0.00003417572,2.82886579754,3.523118349],
@@ -49,6 +210,7 @@ return { earthL };
 
 __mods.calendar = (function () {
 const { earthL } = __mods['vsop-earth'];
+const { createLru } = __mods.lru;
 
 const STEMS = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
 const BRANCHES = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -165,19 +327,26 @@ function localOffsetFor(jdUt) {
   return jdUt < CUTOVER_JD ? OFFSET_BEIJING_LOCAL : OFFSET_MODERN;
 }
 
-const TERM_INSTANT_CACHE = new Map();
-const TERM_INSTANT_CACHE_MAX = 4096;
+const TERM_INSTANT_CACHE = createLru({ max: 4096, name: 'termInstant' });
+
+const TERM_CONVERGE_DEG = 1e-5;
+
+const TERM_GUESS_CACHE = new Map();
+const TROPICAL_YEAR = 365.2422;
 
 function computeTermInstantJd(year, index) {
   const target = termLongitude(index);
   const anchor = toJDN(year, 1, 5) - 0.5 + index * 15.2184;
-  let jd = anchor;
+  const prev = TERM_GUESS_CACHE.get(index);
+  let jd = prev !== undefined ? prev + TROPICAL_YEAR : anchor;
+  if (Math.abs(jd - anchor) > 20) jd = anchor;
   for (let n = 0; n < 12; n++) {
     let diff = target - sunLongitude(jd);
     diff = ((((diff + 180) % 360) + 360) % 360) - 180;
     jd += diff / 0.98564736;
-    if (Math.abs(diff) < 1e-7) break;
+    if (Math.abs(diff) < TERM_CONVERGE_DEG) break;
   }
+  TERM_GUESS_CACHE.set(index, jd);
   const jdUt = jd - deltaTSeconds(year) / 86400;
   return jdUt + localOffsetFor(jdUt);
 }
@@ -187,9 +356,6 @@ function termInstantJd(year, index) {
   const hit = TERM_INSTANT_CACHE.get(key);
   if (hit !== undefined) return hit;
   const jd = computeTermInstantJd(year, index);
-  if (TERM_INSTANT_CACHE.size >= TERM_INSTANT_CACHE_MAX) {
-    TERM_INSTANT_CACHE.delete(TERM_INSTANT_CACHE.keys().next().value);
-  }
   TERM_INSTANT_CACHE.set(key, jd);
   return jd;
 }
@@ -218,26 +384,58 @@ function equationOfTime(year, month, day) {
   return 9.87 * Math.sin(2 * B) - 7.53 * Math.cos(B) - 1.5 * Math.sin(B);
 }
 
-const TERM_WINDOW_CACHE = new Map();
-const TERM_WINDOW_CACHE_MAX = 8;
-
-function termWindow(year) {
-  const cached = TERM_WINDOW_CACHE.get(year);
-  if (cached) return cached;
-  const list = [];
-  for (let y = year - 1; y <= year + 1; y++) {
-    for (let i = 0; i < 24; i++) {
-      list.push({ year: y, index: i, name: TERM_NAMES[i], jd: termInstantJd(y, i) });
+const TERM_WINDOW_CACHE = createLru({ max: 8, name: 'termWindow' });
+const TERM_YEAR_CACHE = createLru({ max: 32, name: 'termYear' });
+const ALL_TERM_INDEXES = Array.from({ length: 24 }, (_, i) => i);
+const JIE_TERM_INDEXES = ALL_TERM_INDEXES.filter((i) => i % 2 === 0);
+
+function termYearList(year, jieOnly) {
+  const key = jieOnly ? `${year}|jie` : `${year}|all`;
+  const hit = TERM_YEAR_CACHE.get(key);
+  if (hit) return hit;
+  if (jieOnly) {
+    const full = TERM_YEAR_CACHE.get(`${year}|all`);
+    if (full) {
+      const jie = full.filter((t) => t.index % 2 === 0);
+      TERM_YEAR_CACHE.set(key, jie);
+      return jie;
     }
   }
-  list.sort((a, b) => a.jd - b.jd);
-  if (TERM_WINDOW_CACHE.size >= TERM_WINDOW_CACHE_MAX) {
-    TERM_WINDOW_CACHE.delete(TERM_WINDOW_CACHE.keys().next().value);
+  const list = [];
+  for (const i of (jieOnly ? JIE_TERM_INDEXES : ALL_TERM_INDEXES)) {
+    list.push({ year, index: i, name: TERM_NAMES[i], jd: termInstantJd(year, i) });
   }
-  TERM_WINDOW_CACHE.set(year, list);
+  list.sort((a, b) => a.jd - b.jd);
+  TERM_YEAR_CACHE.set(key, list);
+  return list;
+}
+
+function termWindow(year, opts = {}) {
+  const jieOnly = opts.jieOnly === true;
+  const cacheKey = jieOnly ? `${year}|jie` : year;
+  const cached = TERM_WINDOW_CACHE.get(cacheKey);
+  if (cached) return cached;
+  const list = [
+    ...termYearList(year - 1, jieOnly),
+    ...termYearList(year, jieOnly),
+    ...termYearList(year + 1, jieOnly),
+  ];
+  list.sort((a, b) => a.jd - b.jd);
+  TERM_WINDOW_CACHE.set(cacheKey, list);
   return list;
 }
 
+function xunKongOf(ganzhi) {
+  if (typeof ganzhi !== 'string' || ganzhi.length < 2) return [];
+  const s = STEMS.indexOf(ganzhi[0]);
+  const b = BRANCHES.indexOf(ganzhi[1]);
+  if (s < 0 || b < 0) return [];
+  const idx = sexagenaryIndex(s, b);
+  if (idx < 0) return [];
+  const head = Math.floor(idx / 10) * 10;
+  return [BRANCHES[(head + 10) % 12], BRANCHES[(head + 11) % 12]];
+}
+
 function previousJie(terms, jd) {
   let found = null;
   for (const t of terms) {
@@ -262,7 +460,11 @@ function formatJd(jd) {
   return `${p.year}-${pad(p.month)}-${pad(p.day)} ${pad(p.hour)}:${pad(p.minute)}`;
 }
 
-return { STEMS, BRANCHES, TERM_NAMES, termLongitude, toJDN, fromJDN, sexagenaryIndex, ganzhiName, dayGanzhiIndex, sunLongitude, deltaTSeconds, OFFSET_MODERN, OFFSET_BEIJING_LOCAL, CUTOVER_JD, localOffsetFor, termInstantJd, jdToParts, partsToJd, equationOfTime, termWindow, previousJie, nextJie, formatJd };
+function cacheMetrics() {
+  return [TERM_INSTANT_CACHE.stats(), TERM_YEAR_CACHE.stats(), TERM_WINDOW_CACHE.stats()];
+}
+
+return { STEMS, BRANCHES, TERM_NAMES, termLongitude, toJDN, fromJDN, sexagenaryIndex, ganzhiName, dayGanzhiIndex, sunLongitude, deltaTSeconds, OFFSET_MODERN, OFFSET_BEIJING_LOCAL, CUTOVER_JD, localOffsetFor, termInstantJd, jdToParts, partsToJd, equationOfTime, termWindow, xunKongOf, previousJie, nextJie, formatJd, cacheMetrics };
 })();
 
 __mods.lunar = (function () {
@@ -544,7 +746,7 @@ function resolveAddress(input) {
 
 const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
-const USER_AGENT = 'dsh-metaphysics/0.14.3 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.16.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;
@@ -1326,9 +1528,12 @@ return { tenGod, elementRoles, scoreLuck, analyzeBaziFrame };
 })();
 
 __mods.bazi = (function () {
-const { STEMS, BRANCHES, TERM_NAMES, ganzhiName, dayGanzhiIndex, jdToParts, partsToJd, sexagenaryIndex, termWindow, previousJie, nextJie, equationOfTime, formatJd } = __mods.calendar;
+const { STEMS, BRANCHES, TERM_NAMES, ganzhiName, dayGanzhiIndex, jdToParts, partsToJd, sexagenaryIndex, termWindow, previousJie, nextJie, equationOfTime, formatJd, xunKongOf } = __mods.calendar;
 const { resolveAddress } = __mods.geo;
 const { computeBaziShensha } = __mods.shensha;
+const { assertCivil } = __mods.validate;
+const { nayinOf } = __mods.nayin;
+const { SANHE } = __mods.sanhe;
 const { analyzeBaziFrame, scoreLuck } = __mods.geju;
 
 const HIDDEN_STEMS = {
@@ -1367,7 +1572,6 @@ const ROOT_HIDDEN_WEIGHT = [1.2, 0.6, 0.3];
 const STEM_HE = { 甲己: '土', 乙庚: '金', 丙辛: '水', 丁壬: '木', 戊癸: '火' };
 const STEM_CHONG_PAIRS = ['甲庚', '乙辛', '丙壬', '丁癸'];
 const BRANCH_HE = { 子丑: '土', 寅亥: '木', 卯戌: '火', 辰酉: '金', 巳申: '水', 午未: '土' };
-const SANHE = { 申子辰: '水', 亥卯未: '木', 寅午戌: '火', 巳酉丑: '金' };
 const SANHUI = { 寅卯辰: '木', 巳午未: '火', 申酉戌: '金', 亥子丑: '水' };
 const BRANCH_CHONG = ['子午', '丑未', '寅申', '卯酉', '辰戌', '巳亥'];
 const BRANCH_HAI = ['子未', '丑午', '寅巳', '卯辰', '申亥', '酉戌'];
@@ -1469,17 +1673,8 @@ function tenGod(dayStem, otherStem) {
   return '?';
 }
 
-const NAYIN_NAMES = [
-  '海中金', '炉中火', '大林木', '路旁土', '剑锋金',
-  '山头火', '涧下水', '城头土', '白蜡金', '杨柳木',
-  '泉中水', '屋上土', '霹雳火', '松柏木', '长流水',
-  '沙中金', '山下火', '平地木', '壁上土', '金箔金',
-  '覆灯火', '天河水', '大驿土', '钗钏金', '桑柘木',
-  '大溪水', '沙中土', '天上火', '石榴木', '大海水',
-];
-
 function nayin(ganzhiIdx) {
-  return NAYIN_NAMES[Math.floor((((ganzhiIdx % 60) + 60) % 60) / 2)];
+  return nayinOf(ganzhiIdx).name;
 }
 
 const JIE_TO_MONTH_BRANCH = { 0: 1, 2: 2, 4: 3, 6: 4, 8: 5, 10: 6, 12: 7, 14: 8, 16: 9, 18: 10, 20: 11, 22: 0 };
@@ -1520,6 +1715,7 @@ function applyTrueSolar(jd, longitude) {
 }
 
 function buildBazi(input) {
+  assertCivil(input);
   const { year, month, day, hour = 0, minute = 0, gender = 'male' } = input;
   const lateZi = input.lateZi !== false;
   const useTrueSolar = input.trueSolar !== false;
@@ -1532,7 +1728,7 @@ function buildBazi(input) {
   const solar = useTrueSolar ? applyTrueSolar(civilJd, longitude) : { offsetMinutes: 0, jd: civilJd, note: '未启用真太阳时' };
   const jd = solar.jd;
 
-  const terms = termWindow(year);
+  const terms = termWindow(year, { jieOnly: true });
   const prevJieTerm = previousJie(terms, jd);
   const nextJieTerm = nextJie(terms, jd);
 
@@ -1626,12 +1822,6 @@ function buildBazi(input) {
     return CHANGSHENG[((step % 12) + 12) % 12];
   }
 
-  function xunKong(ganzhi) {
-    const idx = sexagenaryIndex(STEMS.indexOf(ganzhi[0]), BRANCHES.indexOf(ganzhi[1]));
-    const start = Math.floor(idx / 10) * 10;
-    return [BRANCHES[(start + 10) % 12], BRANCHES[(start + 11) % 12]];
-  }
-
   const monthBranch = pillars.month.branch;
 
   const shensha = computeBaziShensha(pillars, kongwang);
@@ -1640,7 +1830,7 @@ function buildBazi(input) {
     const pl = pillars[key];
     pl.dishi = changsheng(dayStem, pl.branch);
     pl.zizuo = changsheng(pl.stem, pl.branch);
-    pl.kongwang = xunKong(pl.ganzhi);
+    pl.kongwang = xunKongOf(pl.ganzhi);
     pl.shensha = shensha.detail[key].map((x) => x.name);
     pl.shenshaDetail = shensha.detail[key];
   }
@@ -1798,7 +1988,7 @@ return { HIDDEN_STEMS, STEM_ELEMENT, BRANCH_ELEMENT, buildRelations, tenGod, nay
 })();
 
 __mods.liuyao = (function () {
-const { STEMS, BRANCHES, toJDN, ganzhiName, dayGanzhiIndex, sexagenaryIndex } = __mods.calendar;
+const { STEMS, BRANCHES, toJDN, ganzhiName, dayGanzhiIndex, sexagenaryIndex, xunKongOf } = __mods.calendar;
 
 const TRIGRAM_BITS = {
   乾: [1, 1, 1], 兑: [1, 1, 0], 离: [1, 0, 1], 震: [1, 0, 0],
@@ -1944,9 +2134,7 @@ function buildLiuyao(input = {}) {
 
   const dayIdx = sexagenaryIndex(STEMS.indexOf(dayGanZhi.stem), BRANCHES.indexOf(dayGanZhi.branch));
   const xun = dayIdx >= 0 ? Math.floor(dayIdx / 10) : -1;
-  const xunKong = xun >= 0
-    ? [BRANCHES[(10 - 2 * xun + 12) % 12], BRANCHES[(11 - 2 * xun + 12) % 12]]
-    : [];
+  const xunKong = xunKongOf(`${dayGanZhi.stem}${dayGanZhi.branch}`);
   const xunShou = xun >= 0 ? ganzhiName(xun * 10).name : '';
 
   function decorate(hex, movingSet) {
@@ -2028,6 +2216,8 @@ __mods.ziwei = (function () {
 const { STEMS, BRANCHES, ganzhiName, sexagenaryIndex, jdToParts, partsToJd, formatJd } = __mods.calendar;
 const { solarToLunar } = __mods.lunar;
 const { applyTrueSolar } = __mods.bazi;
+const { assertCivil } = __mods.validate;
+const { nayinOf } = __mods.nayin;
 const { resolveAddress } = __mods.geo;
 
 const fix = (i) => ((i % 12) + 12) % 12;
@@ -2045,18 +2235,8 @@ const BUREAU = {
   火: { name: '火六局', number: 6 },
 };
 
-const NAYIN_NAMES = [
-  '海中金', '炉中火', '大林木', '路旁土', '剑锋金',
-  '山头火', '涧下水', '城头土', '白蜡金', '杨柳木',
-  '泉中水', '屋上土', '霹雳火', '松柏木', '长流水',
-  '沙中金', '山下火', '平地木', '壁上土', '金箔金',
-  '覆灯火', '天河水', '大驿土', '钗钏金', '桑柘木',
-  '大溪水', '沙中土', '天上火', '石榴木', '大海水',
-];
-
 function nayinElement(ganzhiIdx) {
-  const name = NAYIN_NAMES[Math.floor((((ganzhiIdx % 60) + 60) % 60) / 2)];
-  return { name, element: name[2] };
+  return nayinOf(ganzhiIdx);
 }
 
 const ZIWEI_GROUP = [
@@ -2203,6 +2383,7 @@ function xiaoxianAge(branchIndex, triad, gender) {
 }
 
 function buildZiwei(input) {
+  assertCivil(input);
   const { year: cy, month: cm, day: cd, hour: ch = 0, minute: cmin = 0, gender = 'male' } = input;
   const useTrueSolar = input.trueSolar !== false;
   const geo = input.geo || (input.address ? resolveAddress(input.address) : null);
@@ -3160,6 +3341,7 @@ return { MAJOR, SUITS, MINOR, ROMAN, SPREADS, tarotDeck, tarotReading, drawTarot
 __mods.meihua = (function () {
 const { BRANCHES } = __mods.calendar;
 const { solarToLunar } = __mods.lunar;
+const { fail } = __mods.fail;
 const { hexagramFromBits } = __mods.liuyao;
 
 const TRI_NAME = ['', '乾', '兑', '离', '震', '巽', '坎', '艮', '坤'];
@@ -3202,7 +3384,7 @@ function buildMeihua(input = {}) {
   if (mode === 'number') {
     const a = Number(input.upper);
     const b = Number(input.lower);
-    if (!Number.isFinite(a) || !Number.isFinite(b)) throw new Error('数字起卦需要两个数字（upper / lower）');
+    if (!Number.isFinite(a) || !Number.isFinite(b)) throw fail('E_INPUT', '数字起卦需要两个数字（upper / lower），例如 upper=3、lower=5');
     upperNum = mod8(a);
     lowerNum = mod8(b);
     moving = Number.isFinite(Number(input.changing)) && Number(input.changing) > 0
@@ -3270,9 +3452,9 @@ function buildMeihua(input = {}) {
 }
 
 function parseDateTime(text) {
-  if (typeof text !== 'string' || !text.trim()) throw new Error('时间起卦需要 datetime');
+  if (typeof text !== 'string' || !text.trim()) throw fail('E_INPUT', '时间起卦需要 datetime，例如 2026-10-24T11:43');
   const m = text.trim().match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T\s](\d{1,2}):(\d{1,2}))?$/);
-  if (!m) throw new Error(`无法解析 datetime：「${text}」`);
+  if (!m) throw fail('E_INPUT', `无法解析 datetime：「${text}」，请用 2026-10-24T11:43 这种格式`);
   return {
     year: Number(m[1]), month: Number(m[2]), day: Number(m[3]),
     hour: Number(m[4] ?? 0), minute: Number(m[5] ?? 0),
@@ -3283,7 +3465,9 @@ return { TRI_NAME, TRI_ELEMENT, TRI_BITS, buildMeihua };
 })();
 
 __mods.daliuren = (function () {
-const { toJDN, dayGanzhiIndex, ganzhiName, termWindow, formatJd } = __mods.calendar;
+const { toJDN, dayGanzhiIndex, ganzhiName, termWindow, formatJd, xunKongOf } = __mods.calendar;
+const { assertCivil } = __mods.validate;
+const { SANHE_ELEMENT } = __mods.sanhe;
 
 const GAN = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
 const ZHI = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -3341,7 +3525,6 @@ const DAY_NIGHT_MAP = {
 
 const RI_LU = { 甲: '寅', 乙: '卯', 丙: '巳', 丁: '午', 戊: '巳', 己: '午', 庚: '申', 辛: '酉', 壬: '亥', 癸: '子' };
 const YANG_REN = { 甲: '卯', 乙: '辰', 丙: '午', 丁: '未', 戊: '午', 己: '未', 庚: '酉', 辛: '戌', 壬: '子', 癸: '丑' };
-const SAN_HE = { 申: '水', 子: '水', 辰: '水', 寅: '火', 午: '火', 戌: '火', 巳: '金', 酉: '金', 丑: '金', 亥: '木', 卯: '木', 未: '木' };
 const SAN_HE_SHEN = {
   水: { 驿马: '寅', 桃花: '酉', 华盖: '辰', 劫煞: '巳', 亡神: '亥' },
   火: { 驿马: '申', 桃花: '卯', 华盖: '戌', 劫煞: '亥', 亡神: '巳' },
@@ -3358,7 +3541,7 @@ function calcShensha(dayGz) {
   };
   if (RI_LU[gan]) push('日禄', RI_LU[gan], '日干临官之位');
   if (YANG_REN[gan]) push('羊刃', YANG_REN[gan], '日干帝旺之位');
-  const trio = SAN_HE_SHEN[SAN_HE[zhi]];
+  const trio = SAN_HE_SHEN[SANHE_ELEMENT[zhi]];
   if (trio) {
     push('驿马', trio.驿马, '日支三合冲位，主迁动');
     push('桃花', trio.桃花, '咸池，主情缘');
@@ -3369,11 +3552,6 @@ function calcShensha(dayGz) {
   return out;
 }
 
-const XUN_KONG = {
-  甲子: ['戌', '亥'], 甲戌: ['申', '酉'], 甲申: ['午', '未'],
-  甲午: ['辰', '巳'], 甲辰: ['寅', '卯'], 甲寅: ['子', '丑'],
-};
-
 const JIA_ZI_60 = Array.from({ length: 60 }, (_, i) => GAN[i % 10] + ZHI[i % 12]);
 
 const ZHI_CHONG = { 子: '午', 午: '子', 丑: '未', 未: '丑', 寅: '申', 申: '寅', 卯: '酉', 酉: '卯', 辰: '戌', 戌: '辰', 巳: '亥', 亥: '巳' };
@@ -3448,10 +3626,7 @@ function analyze(ke) {
 }
 
 function xunKong(dayGz, zhi) {
-  const idx = JIA_ZI_60.indexOf(dayGz);
-  if (idx < 0) return null;
-  const head = JIA_ZI_60[Math.floor(idx / 10) * 10];
-  return (XUN_KONG[head] || []).includes(zhi) ? zhi : null;
+  return xunKongOf(dayGz).includes(zhi) ? zhi : null;
 }
 
 function chuan(pos, zhi, tdp, dayGan, dayGz) {
@@ -3521,6 +3696,7 @@ function fanYin(ke, dayGan, dayZhi, stats, isFB) {
 }
 
 function buildDaliuren(input) {
+  assertCivil(input);
   const { year, month, day, hour = 0, minute = 0 } = input;
   const lateZi = input.lateZi !== false;
   const jdnBase = toJDN(year, month, day);
@@ -3618,6 +3794,8 @@ return { ZHI, GAN, TIAN_JIANG, JIANG_FULL, JIEQI_YUE_JIANG, GAN_JI_GONG, calcShe
 __mods.hepan = (function () {
 const { buildBazi } = __mods.bazi;
 const { STEMS, BRANCHES } = __mods.calendar;
+const { assertCivil } = __mods.validate;
+const { SANHE_GROUPS } = __mods.sanhe;
 
 const WX_GAN = { 甲: '木', 乙: '木', 丙: '火', 丁: '火', 戊: '土', 己: '土', 庚: '金', 辛: '金', 壬: '水', 癸: '水' };
 const WX_ZHI = { 子: '水', 丑: '土', 寅: '木', 卯: '木', 辰: '土', 巳: '火', 午: '火', 未: '土', 申: '金', 酉: '金', 戌: '土', 亥: '水' };
@@ -3628,7 +3806,6 @@ const LIU_HE = [['子', '丑'], ['寅', '亥'], ['卯', '戌'], ['辰', '酉'],
 const CHONG = [['子', '午'], ['丑', '未'], ['寅', '申'], ['卯', '酉'], ['辰', '戌'], ['巳', '亥']];
 const HAI = [['子', '未'], ['丑', '午'], ['寅', '巳'], ['卯', '辰'], ['申', '亥'], ['酉', '戌']];
 const PO = [['子', '酉'], ['卯', '午'], ['辰', '丑'], ['未', '戌'], ['寅', '亥'], ['巳', '申']];
-const SAN_HE = [['申', '子', '辰'], ['寅', '午', '戌'], ['巳', '酉', '丑'], ['亥', '卯', '未']];
 const XING = [['寅', '巳', '申'], ['丑', '戌', '未'], ['子', '卯']];
 
 const pairIn = (list, a, b) => list.some((g) => g.includes(a) && g.includes(b) && a !== b);
@@ -3636,8 +3813,8 @@ const pairIn = (list, a, b) => list.some((g) => g.includes(a) && g.includes(b) &
 function zhiRelation(a, b) {
   if (a === b) return { name: '同支', score: 0, text: '日支相同，性情相近，容易互相理解，也容易同时卡在同一处' };
   if (pairIn(LIU_HE, a, b)) return { name: '六合', score: 20, text: '日支六合，相处自然、彼此补位' };
-  for (const g of SAN_HE) {
-    if (g.includes(a) && g.includes(b)) return { name: '半合', score: 14, text: '日支同属三合局，易有共同语言' };
+  if (SANHE_GROUPS.some((g) => g.branches.includes(a) && g.branches.includes(b))) {
+    return { name: '半合', score: 14, text: '日支同属三合局，易有共同语言' };
   }
   if (pairIn(CHONG, a, b)) return { name: '相冲', score: -15, text: '日支相冲，节奏与需求容易错位，需要刻意协调' };
   if (pairIn(XING, a, b)) {
@@ -3659,6 +3836,8 @@ function wxToMe(other, me) {
 }
 
 function buildHepan(input) {
+  assertCivil(input && input.a, 'a');
+  assertCivil(input && input.b, 'b');
   const A = buildBazi({ ...input.a, gender: input.a.gender });
   const B = buildBazi({ ...input.b, gender: input.b.gender });
 
@@ -3754,6 +3933,7 @@ return { buildHepan };
 
 __mods['ziwei-hepan'] = (function () {
 const { buildZiwei } = __mods.ziwei;
+const { assertCivil } = __mods.validate;
 
 const NAMES = ['命宫', '兄弟', '夫妻', '子女', '财帛', '疾厄', '迁移', '交友', '官禄', '田宅', '福德', '父母'];
 const MUT_MEAN = {
@@ -3774,6 +3954,8 @@ function landOn(host, branch) {
 }
 
 function buildZiweiHepan(input) {
+  assertCivil(input && input.a, 'a');
+  assertCivil(input && input.b, 'b');
   const A = buildZiwei({ ...input.a });
   const B = buildZiwei({ ...input.b });
 
@@ -3869,6 +4051,7 @@ return { buildZiweiHepan };
 __mods.qimen = (function () {
 const { termInstantJd, termWindow, jdToParts, partsToJd, formatJd, ganzhiName, sexagenaryIndex, STEMS, BRANCHES } = __mods.calendar;
 const { solarToLunar } = __mods.lunar;
+const { assertCivil } = __mods.validate;
 
 const TIAN_GAN = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
 const DI_ZHI = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -3904,6 +4087,7 @@ const indexOfGz = (gz) => {
 };
 
 function buildSnapshot({ year, month, day, hour, minute, lateZiHourMode = 'same-day' }) {
+  assertCivil({ year, month, day, hour, minute });
   const jd = partsToJd({ year, month, day, hour, minute });
 
   const baseJdn = partsToJd({ year, month, day, hour: 12, minute: 0 });
@@ -4158,6 +4342,7 @@ const findGong = (obj, val) =>
   Object.keys(obj).find((k) => obj[k] === val || (val === '天芮' && obj[k] === '禽芮')) || '9';
 
 function buildQimen(input) {
+  if (!input.snapshot) assertCivil(input);
   const snapshot = input.snapshot || buildSnapshot(input);
   const hourIdx = input.hourIndex != null ? input.hourIndex : Math.floor((((input.hour ?? 0) + 1) % 24) / 2);
   const hourGz = snapshot.hours[hourIdx] ? snapshot.hours[hourIdx].ganZhi : snapshot.hours[snapshot.hours.length - 1].ganZhi;
@@ -4676,6 +4861,455 @@ const TAROT_ELEMENT_FOCUS = {
 return { TRIGRAM, YAO_POSITION, MOVING_NATURE, HEX64, HEX_BY_CORE, ZIWEI_STARS, WUXING_INDUSTRY, WUXING_ORGAN, TENGOD_STYLE, LIUREN_JIANG, DISCLAIMER, TAROT_ELEMENT_FOCUS };
 })();
 
+__mods['interpret-plain'] = (function () {
+
+const s = (v, fallback = '') => (v === undefined || v === null || v === '' ? fallback : String(v));
+const join = (arr) => (Array.isArray(arr) ? arr.filter(Boolean).join('') : '');
+const has = (v) => (Array.isArray(v) ? v.length > 0 : v !== undefined && v !== null && v !== '');
+
+const STRENGTH_PLAIN = {
+  身强: '底子偏足、抗压能力好，但容易自己给自己加码，学会收力比使劲更重要',
+  偏强: '底子略足，扛得住事，也容易把事都往自己身上揽',
+  中和: '力量比较匀，属于「给什么环境就长出什么样子」的类型',
+  偏弱: '底子偏薄，靠外部支援比硬扛有效，选对圈子与节奏很关键',
+  身弱: '底子偏薄，先修恢复力再谈冲刺，硬撑的性价比最低',
+};
+
+const DIR_SECTION = {
+  wealth: '「工作与职业选择」与「时间窗」',
+  career: '「事业发展」与「时间窗」',
+  love: '「爱情与感情」',
+  health: '「健康状况」',
+  study: '「事业发展」与「时间窗」',
+  travel: '「整体运势」与「时间窗」',
+  general: '「整体运势」与「看盘顺序」',
+};
+
+function buildAnswer(r, ask, ctx = {}) {
+  if (!r || !r.system) return '';
+  const q = s(ask && ask.question).trim();
+  const dir = (ask && ask.direction) || 'general';
+  const where = r.system === 'bazi'
+    ? (DIR_SECTION[dir] || DIR_SECTION.general)
+    : '下面与你的问题最贴近的那一节';
+  const head = q ? `你问的是「${q}」。` : '';
+
+  if (r.system === 'bazi') {
+    const dm = r.dayMaster || {};
+    const st = r.strength || {};
+    const ys = (r.frame && r.frame.yongshen) || {};
+    const favor = join(ys.favor);
+    const avoid = join(ys.avoid);
+    const ln = (r.liunian || [])[0];
+    const parts = [
+      head + `先说结论：你是${s(dm.stem)}${s(dm.element)}日主，命局${s(st.level, '待定')}` +
+        `${favor ? `，顺${favor}、忌${avoid}——往${favor}的方向安排事情会更省力` : ''}。`,
+      ln && ln.ganzhi
+        ? `${s(ln.year)} 年是${ln.ganzhi}年（${s(ln.luck && ln.luck.tier, '平')}），这是「大环境」这一层。`
+        : '',
+      `具体到你问的这件事，重点看${where}。`,
+    ];
+    return parts.filter(Boolean).join('');
+  }
+
+  if (r.system === 'ziwei') {
+    const soul = r.soul || {};
+    const body = r.body || {};
+    const bureau = r.bureau || {};
+    const md = r.lifeMaster || '';
+    return [
+      head + `先说结论：你的命宫落${s(soul.branch, '—')}宫` +
+        `${bureau.name ? `、${bureau.name}` : ''}${md ? `，命主${md}` : ''}` +
+        `${body.lands ? `，身宫落在「${body.lands}」——这张盘的重心在这件事上` : ''}。`,
+      `具体到你问的这件事，重点看${where}。`,
+    ].join('');
+  }
+
+  if (r.system === 'liuyao') {
+    const ben = r.ben || {};
+    const moving = (r.cast && r.cast.movingPositions) || [];
+    const bian = r.bian || {};
+    return [
+      head + `先说结论：本卦是${s(ben.name, '—')}` +
+        `${ben.palace ? `（${ben.palace}）` : ''}` +
+        `${moving.length ? `，第 ${moving.join('、')} 爻动，变为${s(bian.name, '—')}` : '，六爻安静没有动爻'}。`,
+      '断卦的落点在「世爻」（代表你）和「动爻」（事情的推动点），下面「看盘顺序」就按这个次序展开。',
+    ].join('');
+  }
+
+  return head ? `${head}下面按五个维度拆开看，重点看${where}。` : `下面按五个维度拆开看，重点看${where}。`;
+}
+
+function buildPlain(r, ask, ctx = {}) {
+  if (!r || !r.system) return '';
+  if (r.system === 'bazi') {
+    const st = r.strength || {};
+    const ys = (r.frame && r.frame.yongshen) || {};
+    const favor = join(ys.favor);
+    const avoid = join(ys.avoid);
+    const strength = STRENGTH_PLAIN[st.level] || '力量偏中性';
+    const tiaohou = ys.tiaohou && ys.tiaohou.note ? `另外，${ys.tiaohou.note}，所以「暖一点、亮一点」的环境通常更舒服。` : '';
+    return `你的命局属于「${s(st.level, '中性')}」：${strength}。` +
+      `${favor ? `能补${favor}的环境（行业、方位、作息、相处的人）会让你省力；${avoid ? `而${avoid}偏重的场合容易空耗，能绕就绕。` : ''}` : ''}` +
+      tiaohou;
+  }
+  if (r.system === 'ziwei') {
+    const soul = r.soul || {};
+    const body = r.body || {};
+    return `紫微看的是「你与环境怎么互动」。命宫落${s(soul.branch, '—')}宫，说明你做事的第一反应是从这个宫位的气质出发` +
+      `${body.lands ? `；身宫在「${body.lands}」，意味着真正让你上心的，是${body.lands}这件事` : ''}。`;
+  }
+  if (r.system === 'liuyao') {
+    const ben = r.ben || {};
+    const moving = (r.cast && r.cast.movingPositions) || [];
+    return `${s(ben.name, '这一卦')}讲的是一个「${moving.length ? '正在动、还会变' : '暂时不动、先看清'}」的局面——` +
+      `${moving.length ? '有动爻，说明事情还有转圜空间，不是死局。' : '六爻安静，说明当下更该观察而不是硬推。'}`;
+  }
+  return '';
+}
+
+function dimensionPlain(key, r, ctx = {}) {
+  if (!r || r.system !== 'bazi') return '';
+  const ys = (r.frame && r.frame.yongshen) || {};
+  const favor = join(ys.favor);
+  const avoid = join(ys.avoid);
+  const st = r.strength || {};
+  if (key === 'overall') return `一句话：底子${s(st.level, '中性')}，往${favor || '有利方向'}走省力。`;
+  if (key === 'work') return `一句话：挑${favor || '喜用'}属性的活儿，比硬碰${avoid || '忌神'}省力。`;
+  if (key === 'career') return `一句话：你的上升方式，偏向把${favor || '长处'}做成看得见的成果。`;
+  if (key === 'love') return '一句话：关系里先看清自己要什么，再决定推进速度。';
+  if (key === 'health') return '一句话：作息稳定比任何调理都优先。';
+  return '';
+}
+
+const GLOSSARY = [
+  ['日主', '你出生那天对应的天干，代表「你自己」，整张盘都围着它转。'],
+  ['用神', '这张盘里最需要补的那一类力量，顺着它做事更省力。'],
+  ['忌神', '补得越多越别扭的那一类力量，不是坏东西，只是对你性价比低。'],
+  ['调候', '按出生季节调温补缺：冬天的盘怕冷，夏天的盘怕燥。'],
+  ['格局', '把整张盘的结构归成一个类型，用来看「你适合怎么打」。'],
+  ['十神', '把五行关系翻译成人事：财＝资源、官杀＝规则与压力、印＝支持、食伤＝表达、比劫＝同伴。'],
+  ['月令', '出生的月份，是判断强弱最关键的一个位置。'],
+  ['日支', '日柱的地支，也叫「配偶宫」，看亲密关系的第一落点。'],
+  ['大运', '十年一换的大阶段，决定这十年顺不顺手。'],
+  ['流年', '每一年的干支，看当年的具体环境。'],
+  ['空亡', '落到空亡的字，力量打折，事情容易「看着有、抓不住」。'],
+  ['伏神', '卦里没出现的六亲，藏在同宫首卦的对应爻下，用时才看得见。'],
+  ['世应', '世爻代表你，应爻代表对方或外部环境。'],
+  ['动爻', '会变的爻，是事情「往哪走」的推动点。'],
+  ['纳甲', '给六个爻配上天干地支，六亲与生克才有依据。'],
+  ['四化', '禄权科忌四种变化，标记星曜在这一步运里扮演什么角色。'],
+  ['大限', '紫微里的十年阶段，作用类似八字的「大运」。'],
+];
+
+const GLOSSARY_BY_SYSTEM = {
+  liuyao: {
+    用神: '你问的这件事对应的那一类六亲，断卦先把它找出来。',
+    月令: '起卦时的月份，用来看各爻旺不旺。',
+    日支: '起卦当天的地支，与月建一起决定爻的力量。',
+    大运: '六爻不看大运，这里只取当前这一件事的象。',
+    流年: '六爻一般不看流年，看的是眼下这一卦的时段。',
+  },
+  ziwei: {
+    用神: '紫微斗数以「用神宫」的强弱看事情，不取五行喜忌那套。',
+    日主: '紫微斗数不看日主，看的是命宫与星曜组合。',
+    十神: '紫微斗数用四化与星情，不用十神。',
+  },
+};
+
+function buildGlossary(texts, system) {
+  const body = (Array.isArray(texts) ? texts : [texts]).filter(Boolean).join('');
+  if (!body) return [];
+  const override = GLOSSARY_BY_SYSTEM[system] || {};
+  return GLOSSARY
+    .filter(([term]) => body.includes(term))
+    .map(([term, plain]) => ({ term, plain: override[term] || plain }))
+    .slice(0, 10);
+}
+
+const FOLLOWUPS = {
+  career: ['这份工作要不要动，明年哪几个月是窗口？', '和上级的关系该硬碰还是绕开？', '现在转方向，代价主要在哪儿？'],
+  wealth: ['这笔钱现在投出去合适吗？', '我的财主要来自工资还是副业？', '今年哪段时间最容易破财？'],
+  love: ['这段关系能走到哪一步？', '什么时候适合把关系定下来？', '我在关系里最容易忽略什么？'],
+  health: ['哪段时间身体最需要留意？', '作息怎么调最划算？', '查体和作息之外，还有什么是能自己控制的？'],
+  study: ['今年再考一次，胜算在哪、短板在哪？', '复习节奏该怎么排？', '要不要换目标院校或岗位？'],
+  travel: ['这次出门顺不顺，哪天走更好？', '换个城市生活，合不合适？'],
+  general: ['今年最该抓的一件事是什么？', '最该避开的坑在哪？', '接下来三个月，什么时间点值得留意？'],
+};
+
+function buildFollowups(r, ask) {
+  const dir = (ask && ask.direction) || 'general';
+  const list = FOLLOWUPS[dir] || FOLLOWUPS.general;
+  return list.slice(0, 3);
+}
+
+return { buildAnswer, buildPlain, dimensionPlain, buildGlossary, buildFollowups };
+})();
+
+__mods['interpret-knowledge'] = (function () {
+
+const KNOWLEDGE = [
+  {
+    id: 'bazi-yueling-siquan',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '月令不是「一个月」，是当月最有权的那一个字。',
+    detail: '月令藏干按本气、中气、余气分日用事，本气当权的时间最长。所以判旺衰先看日主在月令是得令还是失令——得令者未看全局，已有三分底气。',
+    source: '《子平真诠》论用神；人元司权分日之说见《渊海子平》',
+    status: 'variant',
+    note: '各家对中气、余气各主几日分法不同（有 7/7/16、9/3/18 等多说），本插件只取「本气当权」这一层，未细分日数。',
+  },
+  {
+    id: 'bazi-tonggen-tougan',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '天干是露在外面的样子，地支是藏在地下的根。',
+    detail: '同一个五行，透在天干叫「显」，扎在地支叫「有根」。只有天干没有地支，是看着有、使不上劲；只有地支不通天干，是有实力、不显眼。判断一个人能不能扛事，看的就是根有多深。',
+    source: '《滴天髓》「天干得一比肩，不如得支中一墓库」一路的取象',
+    status: 'settled',
+  },
+  {
+    id: 'bazi-wangxiang',
+    system: 'bazi', dims: ['overall', 'health'],
+    gist: '旺相休囚死是五行在当月的五种状态，不是吉凶等级。',
+    detail: '以月令五行为基准：当令者旺、我生者相、生我者休、克我者囚、我克者死。它是「此刻谁说话有分量」的相对排序，换个季节就整体重排，不能当固定评价。',
+    source: '《五行大义》旺相休囚死；历代命书沿用',
+    status: 'settled',
+  },
+  {
+    id: 'bazi-shensha',
+    system: 'bazi', dims: ['overall', 'love'],
+    gist: '神煞是标签，不是判决。',
+    detail: '神煞给盘面加注脚（如「这个组合常被叫作天乙贵人」），吉凶仍要看格局、旺衰、行运三件事。单见一颗凶煞不足以断凶，单见一颗吉星也不足以断吉——这是历代命书反复强调、而市面软件常忽略的一条。',
+    source: '《三命通会》神煞篇；《子平真诠》力主「神煞不主吉凶」',
+    status: 'settled',
+  },
+  {
+    id: 'bazi-geju',
+    system: 'bazi', dims: ['career'],
+    gist: '先看月令能不能取格，取不到才论从格、化气。',
+    detail: '月令有可用之神（透干或会支有力），按正格论；月令无用、全局一边倒，才考虑从格；日干与相邻天干五合、且月令有化神之气，才论化气格。顺序颠倒会把普通格局误判成特殊格局。',
+    source: '《子平真诠》「论用神」；从化条件见《滴天髓》',
+    status: 'variant',
+    note: '化气格成立条件各家宽严不一（是否要求月令为化神、是否允许有根），本插件按「有合且月令得化神之气」从严处理。',
+  },
+  {
+    id: 'bazi-tiaohou',
+    system: 'bazi', dims: ['overall', 'health'],
+    gist: '冬夏生人先调温，其余先看扶抑。',
+    detail: '调候是针对出生季节的温度校正：冬生水冷木寒，先要火来解冻；夏生火炎土燥，先要水来润泽。调候与扶抑冲突时，多数命书主张先调候，因为寒暖失衡时，再怎么补强弱也难受。',
+    source: '《穷通宝鉴》（拦江网）调候用神体系',
+    status: 'variant',
+    note: '调候与扶抑的优先级各家有争论，也有主张以扶抑为主、调候为辅的。本插件同时给出两者，不替你定谁优先。',
+  },
+  {
+    id: 'bazi-suiyun',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '大运管十年基调，流年管当年触发。',
+    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（大运与流年干支相同）与伏吟反吟（干支重复或与原局对冲）是传统上标记「变动较大」的年份，属于提示而非断语。',
+    source: '岁运并临、伏吟反吟见《三命通会》《渊海子平》',
+    status: 'variant',
+    note: '「岁运并临主大凶」是流传最广也最被滥用的说法，本插件只作变动提示，不断吉凶。',
+  },
+  {
+    id: 'bazi-liuqin',
+    system: 'bazi', dims: ['love'],
+    gist: '六亲有「星」也有「宫」，两处一起看才立体。',
+    detail: '星是十神（男命财为妻、女命官杀为夫、印为母一类），宫是四柱位置（年月日时对应祖上、父母、配偶、子女）。星宫同参：星现而宫破，缘分有但过程有阻；宫稳而星不现，关系平淡而少波折。',
+    source: '星宫同参见《子平真诠》《滴天髓》',
+    status: 'variant',
+    note: '女命以官杀为夫是主流，亦有以日支为主、官杀为辅的取法；本插件按主流取，并在文案中说明。',
+  },
+  {
+    id: 'bazi-kongwang',
+    system: 'bazi', dims: ['overall'],
+    gist: '空亡不是「没有」，是力道打折、抓不实。',
+    detail: '日柱所在旬之外的两个地支为旬空。落空之支力量减弱，但逢冲、逢合、逢填实之期可以「出空」，届时又恢复作用。所以空亡要看它是否被救，不宜一见到空就断无。',
+    source: '旬空出空之说见《渊海子平》；六爻《卜筮正宗》用法相通',
+    status: 'variant',
+    note: '空亡是否逢空即空，各家分歧较大，本插件只标注空亡，不做吉凶推断。',
+  },
+  {
+    id: 'bazi-xingchong',
+    system: 'bazi', dims: ['overall', 'love'],
+    gist: '合能解冲，冲也能破合——关系不是单向的。',
+    detail: '刑冲合害要按力的大小与先后比：两支相冲，若有第三支与其中一支相合，冲力被牵制；反之先合后冲，合局也会被冲散。三合成局通常要求月令或日主参与，否则只是拱合，力量有限。',
+    source: '《三命通会》论刑冲合害',
+    status: 'settled',
+  },
+
+  {
+    id: 'ziwei-sanfang',
+    system: 'ziwei', dims: ['overall', 'career'],
+    gist: '看一个宫，要看它对面和左右三个宫。',
+    detail: '三方四正＝本宫加对宫、三合两宫。命宫的三方是财帛、官禄、迁移，代表钱、事、外出的环境；只看本宫会漏掉一半信息，因为紫微断的是宫与宫之间的互动，不是单宫星曜的堆叠。',
+    source: '《紫微斗数全书》三方四正说',
+    status: 'settled',
+  },
+  {
+    id: 'ziwei-sihua',
+    system: 'ziwei', dims: ['overall', 'career'],
+    gist: '四化是变化的方向，不是吉凶等级。',
+    detail: '生年四化定先天基调（禄主得、权主掌、科主名、忌主执），宫干四化定后天演变；自化是宫干化出的星就在本宫，主此宫之事自己会起变化。同一个忌，落在六亲宫与落在财帛宫，含义完全不同。',
+    source: '《紫微斗数全书》四化篇；宫干飞化见飞星派',
+    status: 'variant',
+    note: '三合派重星情与格局、飞星派重宫干飞化，两派读法差异明显。本插件给出生年四化与宫干自化，未做完整飞星串连。',
+  },
+  {
+    id: 'ziwei-miaowang',
+    system: 'ziwei', dims: ['overall'],
+    gist: '庙旺得利平不陷，说的是星在这个宫舒不舒服。',
+    detail: '同一颗星落在不同宫位，发挥程度差别很大。庙旺是得地，平陷是不得地；不得地不等于不好，只是这颗星的长处不容易发挥，需要借三方吉星来补。',
+    source: '《紫微斗数全书》诸星庙旺表',
+    status: 'variant',
+    note: '太阳、太阴在少数宫位的庙旺标注各家有出入；本插件只标十四主星，不硬标辅星。',
+  },
+  {
+    id: 'ziwei-daxian',
+    system: 'ziwei', dims: ['career'],
+    gist: '大限定十年主题，流年定当年事件。',
+    detail: '大限看这十年主要在忙什么，流年看其中某一年被什么触发。两者的四化会叠在同一些宫位上，叠加处就是这十年里的关键点——只看流年而不看大限，容易把小事放大。',
+    source: '《紫微斗数全书》大限流年篇',
+    status: 'settled',
+  },
+  {
+    id: 'ziwei-shengong',
+    system: 'ziwei', dims: ['overall'],
+    gist: '命宫是「你本来是谁」，身宫是「你后来把力气放在哪」。',
+    detail: '身宫不独立成宫，而是寄在某一宫里（如寄财帛、寄官禄）。它标出中年之后的着力点：命宫强而身宫弱，多为主观强但落地慢；身宫得地，做事更容易见效。',
+    source: '《紫微斗数全书》命身宫说',
+    status: 'variant',
+    note: '身宫寄宫的取法各家一致，但身宫与命宫谁更重，各家侧重不同。',
+  },
+  {
+    id: 'ziwei-kongjie',
+    system: 'ziwei', dims: ['overall', 'career'],
+    gist: '空劫主计划外的变动，遇禄则财来财去。',
+    detail: '地空地劫在紫微里代表落空与抽离：落财帛多主钱财不易积累，落官禄多主方向反复。若与禄存、化禄同宫，常见进得快、出得也快；与忌同宫则容易因变动而受挫。',
+    source: '《紫微斗数全书》空劫条',
+    status: 'variant',
+    note: '空劫是否见禄反吉，各家说法不一，本插件只提示变动性质，不判吉凶。',
+  },
+
+  {
+    id: 'liuyao-yongshen',
+    system: 'liuyao', dims: ['overall'],
+    gist: '问什么，就以那一类六亲为用神。',
+    detail: '问财看妻财、问事业官位看官鬼、问文书房产看父母、问子女下属看子孙、问同辈朋友看兄弟。用神两现时，取动者、取临世者、取旺者；用神不上卦，则从本宫首卦取伏神。这一步定错，后面全盘白算。',
+    source: '《卜筮正宗》用神章；《增删卜易》同',
+    status: 'settled',
+  },
+  {
+    id: 'liuyao-wangshuai',
+    system: 'liuyao', dims: ['overall'],
+    gist: '月建管当令，日辰管生杀。',
+    detail: '月建决定这一爻在这个月有没有气；日辰能生能克能冲能合，作用更直接。月破之爻当月无力；日冲则看动静——静爻被日冲为暗动，动爻被日冲为冲散。',
+    source: '《卜筮正宗》月建日辰章',
+    status: 'settled',
+  },
+  {
+    id: 'liuyao-dongbian',
+    system: 'liuyao', dims: ['overall'],
+    gist: '动爻是「事情自己在动」的那一处。',
+    detail: '动爻能生克静爻，静爻不能反克动爻。变爻对动爻有回头生、回头克两种反作用；化进神（如寅化卯）主加强，化退神（如卯化寅）主减弱。一爻独发看此爻，多爻乱动则看用神受不受伤。',
+    source: '《卜筮正宗》动变章；《增删卜易》进神退神',
+    status: 'settled',
+  },
+  {
+    id: 'liuyao-fushen',
+    system: 'liuyao', dims: ['overall'],
+    gist: '伏神是藏在下面、要借力才出得来的那一爻。',
+    detail: '用神不上卦，就从本宫首卦的同位取伏神。伏神要得出——得日月生扶、或飞神生伏神、或伏神自身旺相，才有用；伏在忌神之下且被克，则虽有如无。',
+    source: '《卜筮正宗》伏神章',
+    status: 'settled',
+  },
+  {
+    id: 'liuyao-yingqi',
+    system: 'liuyao', dims: ['overall', 'career'],
+    gist: '应期是「什么时候见分晓」，不是「哪天」。',
+    detail: '近事以日计、远事以月计；常见取法是等用神逢值、逢冲、逢合之期，或等忌神受制之期。应期法各家互有出入，同一卦不同取法可以差出很远，所以只作时间窗口的提示。',
+    source: '《卜筮正宗》应期章；《增删卜易》',
+    status: 'variant',
+    note: '应期取法（值日、冲、合、填实、旬空出空）各家优先级不同，本插件不做具体日期推算。',
+  },
+  {
+    id: 'liuyao-liushen',
+    system: 'liuyao', dims: ['overall', 'love'],
+    gist: '六神是这件事的味道，不是主角。',
+    detail: '青龙主喜庆与正事、朱雀主口舌与文书、勾陈主田土与迟滞、螣蛇主虚惊与缠绕、白虎主伤损与急迫、玄武主暗昧与失脱。六神只作取象的修饰，断吉凶仍以六亲旺衰生克为主。',
+    source: '《卜筮正宗》六神章',
+    status: 'settled',
+  },
+
+  {
+    id: 'meihua-tiyong',
+    system: 'meihua', dims: ['overall'],
+    gist: '动的那一卦为用，不动的那一卦为体。',
+    detail: '体代表自己、用代表所问之事。体克用主可控、用克体主受制、用生体主得助、体生用主付出。再看互卦与变卦判断中段与结局——梅花只取象不排盘，落点比六爻粗。',
+    source: '《梅花易数》体用篇',
+    status: 'settled',
+  },
+  {
+    id: 'daliuren-sike',
+    system: 'daliuren', dims: ['overall'],
+    gist: '四课看事从哪来，三传看事往哪去。',
+    detail: '四课由日干日支的阴阳与天地盘相叠而得；三传依九宗门（贼克、比用、涉害、遥克等）取初传，再顺推中传末传。三传之间的生克与空亡，是判断事情走向的主线。',
+    source: '《大六壬大全》；九宗门取传法',
+    status: 'settled',
+  },
+  {
+    id: 'qimen-yinyang',
+    system: 'qimen', dims: ['overall'],
+    gist: '冬至后阳遁、夏至后阴遁，局数由节气与三元定。',
+    detail: '一年分阴阳两遁，各九局；局数取决于当前节气与上中下三元（符头定元）。取局流派有拆补、超神接气、置闰三种，同一时刻可能排出不同局数——这不是算错，是流派差异。',
+    source: '《烟波钓叟歌》；拆补与置闰见《奇门遁甲统宗》',
+    status: 'variant',
+    note: '三种取局法在节气交接前后差异最明显，本插件同时实现三种，可在参数里指定。',
+  },
+  {
+    id: 'tarot-orientation',
+    system: 'tarot', dims: ['overall'],
+    gist: '逆位常见的两种读法：削弱，或转向内。',
+    detail: '一派认为逆位是正位力量的减弱与阻塞；另一派主张逆位是同一原型的内向化、未表达。同一张逆位牌，两种读法给出的建议方向可能相反，所以牌阵解读要先把口径讲清楚。',
+    source: '韦特体系传统；逆位读法属近代流派分歧',
+    status: 'variant',
+    note: '逆位是否参与解读本身就有分歧（有牌阵传统完全不用逆位）。本插件按削弱加内向综合取象，并在开头声明。',
+  },
+  {
+    id: 'liuyao-yingqi-exact',
+    system: 'liuyao', dims: [],
+    gist: '具体应期（哪一天应验）本插件尚未推算。',
+    detail: '应期需要综合用神旺衰、动变、旬空出空、日月冲合多层条件，且各家取法不同。当前只给时间窗口的方向性提示，不给具体日期——与其给一个看起来精确、实则拍脑袋的日子，不如留白。',
+    source: '待补：《卜筮正宗》应期章逐条实现 + 138 条卦例对拍',
+    status: 'todo',
+    note: '扩展方向：用《卜筮正宗》卦例里有明确应验日期的条目做回归，先验证再输出。',
+  },
+  {
+    id: 'bazi-dayun-jiaoqi',
+    system: 'bazi', dims: [],
+    gist: '起运时间按「三日折一年」折算，未做交运日的时辰级校正。',
+    detail: '传统折算为三天折一年、一天折四月、一时辰折十天。本插件按此折算到年月，不含交运当日的时辰细分，因此起运年份在边界处可能相差一年内。',
+    source: '《渊海子平》起运法；交运日细算各家不一',
+    status: 'todo',
+    note: '扩展方向：补交运日的时辰级推算，并用已知案例核对。',
+  },
+];
+
+function knowledgeFor(system, dimKey) {
+  return KNOWLEDGE.filter((k) => k.system === system && k.dims.includes(dimKey));
+}
+
+function caveatsFor(system) {
+  return KNOWLEDGE.filter((k) => k.system === system && k.status !== 'settled');
+}
+
+const STATUS_LABEL = {
+  settled: '诸家一致',
+  variant: '各家有异说',
+  todo: '待核实',
+};
+
+return { KNOWLEDGE, knowledgeFor, caveatsFor, STATUS_LABEL };
+})();
+
 __mods.interpret = (function () {
 
 const { HEX64, HEX_BY_CORE, TRIGRAM, YAO_POSITION, MOVING_NATURE, ZIWEI_STARS, WUXING_INDUSTRY, WUXING_ORGAN, TENGOD_STYLE, LIUREN_JIANG, TAROT_ELEMENT_FOCUS, DISCLAIMER } = __mods['interpret-data'];
@@ -4815,6 +5449,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));
   const list = Array.isArray(r.dayun?.list) ? r.dayun.list : [];
@@ -5006,15 +5641,44 @@ 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,
   };
 }
 
@@ -5202,6 +5866,10 @@ function ziweiInterpret(r) {
         return `大限：${dx || '—'}。\n近五年流年：${yrs || '—'}。\n读法：大限定十年的主题，流年四化指出今年往哪边偏；两层方向相反时，以守住大限主题为主。`;
       })(),
     },
+    {
+      key: 'quant', label: '量化口径',
+      text: '紫微这边只数「宫位里有什么」：大限看落宫与四化命中数、流年看命宫与四化星数；不把星曜折算成分数，也不预测金额与疾病诊断。四化命中数只是结构计数，不等于吉凶强度。',
+    },
     {
       key: 'limits', label: '未纳入',
       text: '本盘没有计算：飞星四化（宫干引发的连锁）、小限与大限的加权、流日流时的具体事项定位，以及双星组合的强弱细分。四化表取中州派常用口径，其他流派（如飞星派）结论会不同；这些不改变盘面事实，只影响轻重，所以只作方向参考。',
@@ -5237,9 +5905,54 @@ 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,
   };
 }
 
@@ -5717,10 +6430,99 @@ const BUILDERS = {
 };
 
 const { interpretQimen } = __mods['qimen-interpret'];
+const { buildAnswer, buildPlain, buildGlossary, buildFollowups, dimensionPlain } = __mods['interpret-plain'];
+const { knowledgeFor, caveatsFor, STATUS_LABEL } = __mods['interpret-knowledge'];
+
+function enrichPlain(result, r, ask) {
+  if (!result) return result;
+  const dims = (result.dimensions || []).map((d) => {
+    const p = dimensionPlain(d.key, r, {});
+    const know = knowledgeFor(r.system, d.key).map((k) => ({
+      id: k.id,
+      gist: k.gist,
+      detail: k.detail,
+      source: k.source,
+      status: k.status,
+      statusLabel: STATUS_LABEL[k.status] || k.status,
+      note: k.note || '',
+    }));
+    return { ...d, ...(p ? { plain: p } : {}), ...(know.length ? { knowledge: know } : {}) };
+  });
+  const texts = [
+    result.lead,
+    ...dims.map((d) => [d.label, d.text, d.advice, d.plain, ...(d.knowledge || []).map((k) => k.detail)].filter(Boolean).join('')),
+    ...(result.sections || []).map((x) => x.text),
+  ].filter(Boolean);
+
+  const caveats = caveatsFor(r.system);
+  const caveatLine = caveats.length
+    ? caveats.slice(0, 4).map((k) => `· ${k.gist}（${STATUS_LABEL[k.status] || k.status}）${k.note ? `——${k.note}` : ''}`).join('\n')
+    : '';
+  const secs = [...(result.sections || [])];
+  if (caveatLine) {
+    secs.push({
+      key: 'caveats',
+      label: '这套规则有多稳',
+      text: `下列几条各家说法不一，本插件取其中一派并把分歧标出来，供你判断可信度：\n${caveatLine}`,
+    });
+  }
+  const todos = caveats.filter((k) => k.status === 'todo');
+  if (todos.length) {
+    secs.push({
+      key: 'todo',
+      label: '尚未实现（不猜）',
+      text: todos.map((k) => `· ${k.gist}${k.note ? `——${k.note}` : ''}`).join('\n'),
+    });
+  }
+
+  return {
+    ...result,
+    dimensions: dims,
+    sections: secs,
+    answer: result.answer || buildAnswer(r, ask, {}),
+    plain: result.plain || buildPlain(r, ask, {}),
+    followups: buildFollowups(r, ask),
+    glossary: buildGlossary(texts, r.system),
+    knowledgeCount: dims.reduce((n, d) => n + ((d.knowledge || []).length), 0),
+    caveats: caveats.map((k) => ({ id: k.id, gist: k.gist, status: k.status, statusLabel: STATUS_LABEL[k.status] || k.status })),
+  };
+}
+
+const TECHNIQUE = {
+  bazi: '八字（月令 · 十神 · 大运流年）',
+  ziwei: '紫微（宫位 · 四化 · 大限流年）',
+  liuyao: '六爻（卦宫 · 世应 · 动爻 · 日辰）',
+  meihua: '梅花（体用 · 互卦 · 变卦）',
+  daliuren: '六壬（月将加时 · 四课 · 三传）',
+  qimen: '奇门（九宫 · 值符值使 · 用神）',
+  tarot: '塔罗（牌阵 · 正逆位 · 元素）',
+  hepan: '合盘（日主 · 夫妻宫 · 五行互补）',
+};
+
+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);
 
 function interpret(r, opts) {
   if (!isObj(r) || !r.system) return null;
-  if (r.system === 'qimen') return interpretQimen(r, opts);
+  const ask = askOf(opts);
+  if (r.system === 'qimen') return withReportMeta(interpretQimen(r, opts), r, ask);
   const fn = BUILDERS[r.system];
   if (!fn) return null;
   let body;
@@ -5735,28 +6537,312 @@ function interpret(r, opts) {
       lead: '这一盘的解析暂未生成，请稍后重试。',
       dimensions: [],
       sections: [],
+      outline: [],
+      tables: [],
+      technique: TECHNIQUE[r.system] || '',
       disclaimer: DISCLAIMER,
       error: String(e && e.message),
-      ask: askOf(opts),
+      ask,
     };
   }
-  const tuned = applyAsk(body.dimensions || [], askOf(opts), body.lead || '');
-  return {
-    moduleType: MODULE_TYPE[r.system] || 'natal',
-    system: r.system,
-    systemLabel: SYSTEM_LABEL[r.system] || r.system,
-    title: '解析与详解',
+  const tuned = applyAsk(body.dimensions || [], ask, body.lead || '');
+  return withReportMeta({
     lead: tuned.lead,
     dimensions: tuned.dims,
     sections: body.sections || [],
-    disclaimer: DISCLAIMER,
-    ask: askOf(opts),
-  };
+    outline: body.outline || [],
+    tables: body.tables || [],
+  }, r, ask);
 }
 
 return { DIMENSIONS, MODULE_TYPE, SYSTEM_LABEL, DIRECTIONS, DIRECTION_DEFAULT, dirOf, hexInfo, interpret };
 })();
 
+__mods.followup = (function () {
+const { ZIWEI_STARS } = __mods['interpret-data'];
+
+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: '弱',
+  };
+}
+
+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 };
+}
+
+return { followup };
+})();
+
+__mods.crosscheck = (function () {
+const { ZIWEI_STARS } = __mods['interpret-data'];
+
+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;
+};
+
+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} 颗` : ''}`,
+      '互补',
+      '两边指向的器官/系统不一定相同，合并起来看更稳；任何健康问题以体检与医生为准');
+  }
+
+  {
+    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 };
+}
+
+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');
+}
+
+return { crossCheck, crossText };
+})();
+
 __mods.index = (function () {
 const { buildBazi } = __mods.bazi;
 const { buildLiuyao, tossLines } = __mods.liuyao;
@@ -5771,15 +6857,13 @@ const { geocodeAddress, resolveAddress } = __mods.geo;
 const { toJDN, ganzhiName, dayGanzhiIndex } = __mods.calendar;
 const { randomOf, isSeed } = __mods.random;
 const { interpret, DIRECTIONS, DIRECTION_DEFAULT } = __mods.interpret;
+const { followup } = __mods.followup;
+const { crossCheck, crossText } = __mods.crosscheck;
+const { fail } = __mods.fail;
+const { assertCivil } = __mods.validate;
 
 const pad = (n) => String(n).padStart(2, '0');
 
-const fail = (code, message) => {
-  const e = new Error(message);
-  e.code = code;
-  return e;
-};
-
 const GENDERS = ['male', 'female'];
 
 function daysInMonth(year, month) {
@@ -6034,19 +7118,59 @@ 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 (typeof args.ask === 'string' && args.ask.trim()) r.followup = followup(r, args.ask);
   return r;
 }
 
 function interpretText(i) {
   if (!i) return '';
   const out = [`【${i.title || '解析与详解'}】${i.ask && i.ask.echo ? i.ask.echo : ''}`];
+  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('；')}` : '';
-    out.push(`${d.label}：${d.text}${d.advice ? `　建议：${d.advice}` : ''}${evidence}`);
+    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 || [])
+      .map((k) => `\n　规则·${k.gist}〔${k.statusLabel}〕${k.detail}　出处：${k.source}${k.note ? `　注：${k.note}` : ''}`)
+      .join('');
+    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('　'));
+  }
+  if (Array.isArray(i.glossary) && i.glossary.length) {
+    out.push('名词解释：' + i.glossary.map((g) => `${g.term}＝${g.plain}`).join('　'));
+  }
   if (i.disclaimer) out.push(i.disclaimer);
   return out.join('\n');
 }
@@ -6218,12 +7342,20 @@ function computeRaw(args = {}) {
 
 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}` : ''}`);
+  }
+  return parts.filter(Boolean).join('\n\n');
 }
 
-return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAddress, resolveAddress, buildBazi, buildLiuyao, tossLines, parseDateTime, compute, interpretText, renderText };
+return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAddress, resolveAddress, buildBazi, buildLiuyao, tossLines, followup, crossCheck, crossText, parseDateTime, compute, interpretText, renderText };
 })();
 
     const Engine = __mods.index;
@@ -6574,6 +7706,17 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 .mp-it-focus{margin-left:6px;font-size:12px;color:var(--lu);border:1px solid rgba(var(--lu-rgb),.35);border-radius:999px;padding:1px 9px;font-family:system-ui,sans-serif}
 .mp-it-dim.focus{background:linear-gradient(90deg,rgba(var(--lu-rgb),.06),transparent 60%);border-left:2px solid var(--lu);padding-left:10px}
 .mp-it-lead{padding:11px 16px;font-size:13px;color:var(--ink2);border-bottom:1px dashed var(--line)}
+.mp-it-ans{margin:12px 16px 0;padding:12px 14px;border-left:3px solid var(--red);background:var(--band);font-size:13.5px;line-height:1.9;text-align:justify}
+.mp-it-ans b{display:block;font-size:11px;letter-spacing:.12em;color:var(--red);font-family:system-ui,sans-serif;margin-bottom:5px;font-weight:600}
+.mp-it-plain{margin:10px 16px 0;padding:11px 14px;border:1px dashed var(--line);border-radius:8px;font-size:13px;line-height:1.9;color:var(--ink2);text-align:justify}
+.mp-it-plain b{color:var(--lu);font-weight:600;margin-right:6px}
+.mp-it-dplain{margin-bottom:6px;font-size:12.5px;line-height:1.8;color:var(--lu)}
+.mp-it-fu{margin:4px 16px 12px;padding:11px 14px;background:var(--band);border-radius:8px}
+.mp-it-fu b{display:block;font-size:11px;letter-spacing:.12em;color:var(--label);font-family:system-ui,sans-serif;margin-bottom:6px;font-weight:600}
+.mp-it-fu li{font-size:12.5px;line-height:1.85;margin-left:16px;color:var(--ink2)}
+.mp-it-gloss{margin:0 16px 12px;font-size:12px;line-height:1.85;color:var(--muted)}
+.mp-it-gloss summary{cursor:pointer;font-family:system-ui,sans-serif;letter-spacing:.06em;color:var(--label);margin-bottom:6px}
+.mp-it-gloss span{color:var(--ink2);font-weight:600;margin-right:4px}
 .mp-it-err{margin:12px 16px;padding:9px 12px;border-left:2px solid var(--red);background:var(--soul);font-size:12.5px;line-height:1.8;color:var(--ink2)}
 .mp-it-err b{color:var(--red);margin-right:6px}
 .mp-it-body{padding:2px 16px 12px}
@@ -6586,11 +7729,62 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 .mp-it-dev{margin-top:7px;font-size:12px;line-height:1.75;color:var(--muted)}
 .mp-it-dev b{color:var(--label);font-weight:600;margin-right:7px;font-family:system-ui,sans-serif;font-size:11px;letter-spacing:.1em}
 .mp-it-adv{margin-top:8px;padding:9px 12px;background:var(--band);border-left:2px solid var(--red);font-size:13px;line-height:1.85}
+.mp-it-know{margin-top:8px;display:flex;flex-direction:column;gap:6px}
+.know-row{display:flex;gap:8px;align-items:flex-start;font-size:12px;line-height:1.8;color:var(--ink2)}
+.know-status{flex:none;margin-top:2px;padding:1px 6px;border-radius:4px;font-size:10.5px;letter-spacing:.04em;font-family:system-ui,sans-serif;border:1px solid var(--line);color:var(--muted);white-space:nowrap}
+.know-status.settled{color:var(--good)}
+.know-status.variant{color:var(--warn)}
+.know-status.todo{color:var(--red)}
+.know-body b{display:block;font-size:12.5px;color:var(--ink);font-weight:600;margin-bottom:2px}
+.know-body i{display:block;font-style:normal;color:var(--muted);font-size:11.5px;margin-top:2px}
+.know-body em{display:block;font-style:normal;color:var(--warn);font-size:11.5px;margin-top:2px}
 .mp-it-adv b{color:var(--red);font-weight:600;margin-right:7px;font-family:system-ui,sans-serif;font-size:12px;letter-spacing:.1em}
 .mp-it-secs{border-top:1px solid var(--line);padding:12px 16px 2px;background:var(--card)}
 .mp-it-sec{margin-bottom:11px}
 .mp-it-sh{font-size:13px;font-weight:700;color:var(--lu);letter-spacing:.06em;margin-bottom:4px}
 .mp-it-stext{font-size:13px;line-height:1.9;color:var(--ink2);text-align:justify}
+.mp-outline{margin:12px 16px 0;border:1px solid var(--line);border-left:3px solid var(--lu);border-radius:8px;background:var(--card);padding:10px 12px}
+.mp-outline-h{font-size:12px;font-weight:700;letter-spacing:.12em;color:var(--lu);margin-bottom:6px;font-family:system-ui,sans-serif}
+.mp-outline-row{display:grid;grid-template-columns:56px minmax(0,1fr);gap:8px;padding:3px 0;font-size:13px;line-height:1.7;color:var(--ink2)}
+.mp-outline-row b{color:var(--label);font-weight:600;font-family:system-ui,sans-serif}
+.mp-toc{display:flex;flex-wrap:wrap;gap:6px 10px;margin:10px 16px 0;padding:8px 10px;border:1px dashed var(--line);border-radius:8px;font-size:12px;font-family:system-ui,sans-serif}
+.mp-toc a{color:var(--lu);text-decoration:none;border-bottom:1px dotted rgba(var(--lu-rgb),.5)}
+.mp-toc a:hover{color:var(--ink)}
+.mp-it-ev{margin-top:7px;border:1px solid var(--line);border-radius:6px;background:var(--band);font-size:12px;font-family:system-ui,sans-serif}
+.mp-it-ev>summary{cursor:pointer;padding:6px 9px;color:var(--muted);list-style:none}
+.mp-it-ev>summary::-webkit-details-marker{display:none}
+.mp-it-ev>summary::before{content:'▸ ';color:var(--label)}
+.mp-it-ev[open]>summary::before{content:'▾ '}
+.mp-it-ev-body{padding:2px 9px 8px;display:flex;flex-direction:column;gap:4px}
+.mp-it-ev-item{color:var(--ink2);line-height:1.7;padding-left:12px;position:relative}
+.mp-it-ev-item::before{content:'·';position:absolute;left:2px;color:var(--label)}
+.mp-it-ev-tech{margin-top:4px;color:var(--label);font-size:11px;letter-spacing:.06em}
+.mp-it-conf{font-size:11px;font-family:system-ui,sans-serif;border-radius:999px;padding:1px 8px;margin-left:6px;border:1px solid var(--line);color:var(--muted)}
+.mp-it-conf.c-强{color:var(--lu);border-color:rgba(var(--lu-rgb),.4)}
+.mp-it-conf.c-中{color:var(--label);border-color:var(--line)}
+.mp-it-conf.c-弱{color:var(--red);border-color:rgba(var(--red-rgb),.4)}
+.mp-tables{border-top:1px solid var(--line);padding:12px 16px 4px;background:var(--card)}
+.mp-table-wrap{margin-bottom:12px}
+.mp-table-h{font-size:12px;font-weight:700;letter-spacing:.1em;color:var(--lu);margin-bottom:5px;font-family:system-ui,sans-serif}
+.mp-table-scroll{overflow-x:auto;border:1px solid var(--line);border-radius:6px}
+.mp-table{width:100%;border-collapse:collapse;font-size:12px;line-height:1.6;color:var(--ink2);font-family:system-ui,sans-serif}
+.mp-table th,.mp-table td{padding:5px 9px;text-align:left;vertical-align:top;border-bottom:1px solid var(--line);white-space:nowrap}
+.mp-table th{background:var(--band);color:var(--label);font-weight:600;font-size:11px;letter-spacing:.06em}
+.mp-table tbody tr:last-child td{border-bottom:none}
+.mp-table tbody tr:nth-child(even) td{background:rgba(0,0,0,.02)}
+@media print{
+  .mp-toc{display:none}
+  .mp-it.folded .mp-it-wrap{display:block}
+  .mp-table-scroll{overflow:visible}
+  .mp-table th,.mp-table td{white-space:normal}
+  .mp-table-wrap,.mp-it-sec,.mp-it-dim{break-inside:avoid}
+  .mp-table-wrap{page-break-inside:avoid}
+}
+.mp-fu{margin:12px 16px;border:1px solid var(--line);border-left:3px solid var(--lu);border-radius:8px;background:var(--card);padding:10px 12px;font-size:13px;line-height:1.8;color:var(--ink2)}
+.mp-fu.miss{border-left-color:var(--red)}
+.mp-fu-h{font-size:12px;font-weight:700;letter-spacing:.08em;color:var(--lu);margin-bottom:4px;font-family:system-ui,sans-serif}
+.mp-fu.miss .mp-fu-h{color:var(--red)}
+.mp-fu-ev{margin-top:5px;font-size:12px;color:var(--muted);font-family:system-ui,sans-serif}
 .mp-it-dis{padding:11px 16px;border-top:1px solid var(--line);background:var(--band);font-size:12px;line-height:1.75;color:var(--muted);font-family:system-ui,sans-serif}
 
 @media (max-width:640px){
@@ -7437,16 +8631,34 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 
   pp.interpretHTML = function (it, opt) {
     if (!it) return '';
-    if (!(it.dimensions && it.dimensions.length) && !it.error) return '';
+    const hasBody = (it.dimensions && it.dimensions.length) || (it.sections && it.sections.length);
+    if (!hasBody && !it.error && !it.answer) return '';
     const folded = !!(opt && opt.folded);
-    const dims = it.dimensions.map((d, i) => `<div class="mp-it-dim${d.focused ? ' focus' : ''}">
-      <div class="mp-it-dh"><span class="mp-it-dno">${i + 1}</span><span class="mp-it-dlabel">${esc(d.label)}</span>${d.focused ? '<span class="mp-it-focus">最贴近你的问题</span>' : ''}</div>
+    const dims = (it.dimensions || []).map((d, i) => `<div class="mp-it-dim${d.focused ? ' focus' : ''}">
+      <div class="mp-it-dh"><span class="mp-it-dno">${i + 1}</span><span class="mp-it-dlabel">${esc(d.label)}</span>${d.focused ? '<span class="mp-it-focus">最贴近你的问题</span>' : ''}${d.confidence ? `<span class="mp-it-conf c-${esc(d.confidence)}">置信度 ${esc(d.confidence)}</span>` : ''}</div>
+      ${d.plain ? `<div class="mp-it-dplain">${esc(d.plain)}</div>` : ''}
       <div class="mp-it-dtext">${esc(d.text)}</div>
-      ${(d.evidence && d.evidence.length) ? `<div class="mp-it-dev"><b>依据</b>${d.evidence.map((x) => esc(x)).join('；')}</div>` : ''}
+      ${(d.evidence && d.evidence.length) ? `<details class="mp-it-ev"><summary>依据 · ${esc(d.evidence.length)} 条盘面事实</summary><div class="mp-it-ev-body">${d.evidence.map((x) => `<span class="mp-it-ev-item">${esc(x)}</span>`).join('')}<span class="mp-it-ev-tech">技法：${esc(it.technique || it.systemLabel || '')}</span></div></details>` : ''}
+      ${(d.knowledge && d.knowledge.length) ? `<div class="mp-it-know">${d.knowledge.map((k) => `<div class="know-row"><span class="know-status ${k.status}">${esc(k.statusLabel)}</span><span class="know-body"><b>${esc(k.gist)}</b>${esc(k.detail)}${k.source ? `<i>出处：${esc(k.source)}</i>` : ''}${k.note ? `<em>注：${esc(k.note)}</em>` : ''}</span></div>`).join('')}</div>` : ''}
       ${d.advice ? `<div class="mp-it-adv"><b>建议</b>${esc(d.advice)}</div>` : ''}
     </div>`).join('');
+    const outline = (it.outline && it.outline.length)
+      ? `<div class="mp-outline"><div class="mp-outline-h">一页读懂</div>${it.outline.map((o) => `<div class="mp-outline-row"><b>${esc(o.label)}</b><span>${esc(o.text)}</span></div>`).join('')}</div>`
+      : '';
+    const toc = (it.sections && it.sections.length)
+      ? `<nav class="mp-toc" aria-label="报告目录">${it.sections.map((s) => `<a href="#mp-sec-${esc(s.key)}">${esc(s.label)}</a>`).join('')}</nav>`
+      : '';
+    const tables = (it.tables && it.tables.length)
+      ? `<div class="mp-tables">${it.tables.filter((t) => Array.isArray(t.rows) && t.rows.length).map((t) => `<div class="mp-table-wrap">
+          <div class="mp-table-h">${esc(t.title)}</div>
+          <div class="mp-table-scroll"><table class="mp-table">
+            <thead><tr>${t.columns.map((c) => `<th>${esc(c)}</th>`).join('')}</tr></thead>
+            <tbody>${t.rows.map((row) => `<tr>${row.map((c) => `<td>${esc(c)}</td>`).join('')}</tr>`).join('')}</tbody>
+          </table></div>
+        </div>`).join('')}</div>`
+      : '';
     const secs = (it.sections && it.sections.length)
-      ? `<div class="mp-it-secs">${it.sections.map((s) => `<div class="mp-it-sec">
+      ? `<div class="mp-it-secs">${it.sections.map((s) => `<div class="mp-it-sec" id="mp-sec-${esc(s.key)}">
         <div class="mp-it-sh">${esc(s.label)}</div>
         <div class="mp-it-stext">${esc(s.text)}</div>
       </div>`).join('')}</div>`
@@ -7456,6 +8668,14 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
     const askLine = (ask && (ask.question || (ask.direction && ask.direction !== 'general')))
       ? `<div class="mp-it-ask"><span class="ask-q">问题：${ask.question ? esc(ask.question) : '<span class="ask-none">（未填写）</span>'}</span><span class="ask-sep">｜</span><span class="ask-d">询问方向：${esc(ask.directionLabel || '综合')}</span></div>`
       : '';
+    const answer = it.answer ? `<div class="mp-it-ans"><b>先答所问</b>${esc(it.answer)}</div>` : '';
+    const plain = it.plain ? `<div class="mp-it-plain"><b>说人话</b>${esc(it.plain)}</div>` : '';
+    const fu = (it.followups && it.followups.length)
+      ? `<div class="mp-it-fu"><b>还可以这样追问</b><ul>${it.followups.map((q) => `<li>${esc(q)}</li>`).join('')}</ul></div>`
+      : '';
+    const gloss = (it.glossary && it.glossary.length)
+      ? `<details class="mp-it-gloss"><summary>名词解释（${it.glossary.length} 条）</summary>${it.glossary.map((g) => `<div><span>${esc(g.term)}</span>${esc(g.plain)}</div>`).join('')}</details>`
+      : '';
     return `<div class="mp-it${folded ? ' folded' : ''}">
       <button type="button" class="mp-it-head" aria-expanded="${folded ? 'false' : 'true'}">
         <span class="mp-it-arrow" aria-hidden="true">▾</span>
@@ -7464,18 +8684,143 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
       </button>
       <div class="mp-it-wrap">
         ${askLine}
+        ${answer}
+        ${plain}
         ${it.lead ? `<div class="mp-it-lead">${esc(it.lead)}</div>` : ''}
         ${it.error ? `<div class="mp-it-err"><b>⚠ 解析生成失败</b>${esc(it.error)}——上方盘面数据本身可用</div>` : ''}
+        ${outline}
+        ${toc}
         <div class="mp-it-body">${dims}</div>
         ${secs}
+        ${tables}
+        ${fu}
+        ${gloss}
         <div class="mp-it-dis">${esc(it.disclaimer)}</div>
       </div>
     </div>`;
   };
 
+  pp.followupHTML = function (fx) {
+    if (!fx) return '';
+    const ev = (fx.evidence && fx.evidence.length)
+      ? `<div class="mp-fu-ev">依据：${fx.evidence.map((x) => esc(x)).join('；')}　置信度：${esc(fx.confidence || '弱')}</div>`
+      : '';
+    return `<div class="mp-fu${fx.ok ? '' : ' miss'}">
+      <div class="mp-fu-h">追问 · ${esc(fx.question)}</div>
+      <div class="mp-fu-a">${esc(fx.answer)}</div>
+      ${ev}
+    </div>`;
+  };
+
   pp.resultWithInterpret = function (html, it, opt) {
     return (html || '') + pp.interpretHTML(it, opt);
   };
+
+  pp.summaryCardPNG = function (r, it) {
+    try {
+      if (typeof document === 'undefined' || !document.createElement) return '';
+      const outline = (it && it.outline) || [];
+      const tables = ((it && it.tables) || []).filter((t) => Array.isArray(t.rows) && t.rows.length);
+      const systemLabel = (it && it.systemLabel) || (r && r.system) || '命理报告';
+      const W = 900;
+      const PAD = 44;
+      const line = 26;
+      const font = (size, bold) => `${bold ? '600 ' : ''}${size}px "PingFang SC","Microsoft YaHei","Noto Sans CJK SC",sans-serif`;
+      const canvas = document.createElement('canvas');
+      const ctx = canvas.getContext ? canvas.getContext('2d') : null;
+      if (!ctx) return '';
+      const wrap = (text, maxWidth) => {
+        const out = [];
+        let cur = '';
+        for (const ch of String(text)) {
+          const test = cur + ch;
+          if (ctx.measureText(test).width > maxWidth && cur) { out.push(cur); cur = ch; } else cur = test;
+        }
+        if (cur) out.push(cur);
+        return out.length ? out : [''];
+      };
+      ctx.font = font(15);
+      let bodyH = 0;
+      const outlineBlocks = outline.map((o) => {
+        const lines = wrap(o.text, W - PAD * 2 - 70);
+        bodyH += Math.min(lines.length, 2) * line + 10;
+        return { o, lines: lines.slice(0, 2) };
+      });
+      const table = tables[0] || null;
+      const tableRows = table ? table.rows.slice(0, 6) : [];
+      const tableH = table ? 54 + tableRows.length * 34 : 0;
+      const H = 150 + bodyH + (outlineBlocks.length ? 34 : 0) + tableH + 120;
+
+      canvas.width = W;
+      canvas.height = H;
+      ctx.fillStyle = 'rgb(255,255,255)';
+      ctx.fillRect(0, 0, W, H);
+      ctx.fillStyle = 'rgb(31,111,63)';
+      ctx.fillRect(0, 0, W, 8);
+
+      let y = 52;
+      ctx.fillStyle = 'rgb(27,27,27)';
+      ctx.font = font(28, true);
+      ctx.fillText(`${systemLabel} · 摘要`, PAD, y);
+      y += 30;
+      ctx.fillStyle = 'rgb(111,106,96)';
+      ctx.font = font(14);
+      const meta = [r && r.input && r.input.datetime ? `出生/起局：${r.input.datetime}` : '', '本地计算 · 可复现'].filter(Boolean).join('　');
+      ctx.fillText(meta, PAD, y);
+      y += 34;
+
+      if (outlineBlocks.length) {
+        ctx.fillStyle = 'rgb(31,111,63)';
+        ctx.font = font(16, true);
+        ctx.fillText('一页读懂', PAD, y);
+        y += 26;
+        for (const { o, lines } of outlineBlocks) {
+          ctx.fillStyle = 'rgb(138,131,120)';
+          ctx.font = font(14, true);
+          ctx.fillText(o.label, PAD, y);
+          ctx.fillStyle = 'rgb(63,58,51)';
+          ctx.font = font(15);
+          lines.forEach((text, i) => ctx.fillText(text, PAD + 70, y + i * line));
+          y += lines.length * line + 10;
+        }
+        y += 8;
+      }
+
+      if (table) {
+        ctx.fillStyle = 'rgb(31,111,63)';
+        ctx.font = font(16, true);
+        ctx.fillText(table.title, PAD, y);
+        y += 24;
+        ctx.fillStyle = 'rgb(138,131,120)';
+        ctx.font = font(13);
+        ctx.fillText(table.columns.join(' · '), PAD, y);
+        y += 8;
+        ctx.strokeStyle = 'rgb(229,225,216)';
+        ctx.beginPath(); ctx.moveTo(PAD, y); ctx.lineTo(W - PAD, y); ctx.stroke();
+        y += 22;
+        ctx.fillStyle = 'rgb(63,58,51)';
+        ctx.font = font(14);
+        for (const row of tableRows) {
+          const text = row.filter(Boolean).join(' · ');
+          const clipped = wrap(text, W - PAD * 2)[0];
+          ctx.fillText(clipped, PAD, y);
+          y += 34;
+        }
+      }
+
+      y = H - 62;
+      ctx.strokeStyle = 'rgb(229,225,216)';
+      ctx.beginPath(); ctx.moveTo(PAD, y - 18); ctx.lineTo(W - PAD, y - 18); ctx.stroke();
+      ctx.fillStyle = 'rgb(138,131,120)';
+      ctx.font = font(12);
+      ctx.fillText('内容用于传统文化学习与自我探索，不构成医疗、投资、法律或人事决策依据。', PAD, y + 6);
+      ctx.fillText('dsh-metaphysics · 本机计算，未上传任何数据', PAD, y + 26);
+
+      return canvas.toDataURL ? canvas.toDataURL('image/png') : '';
+    } catch (e) {
+      return '';
+    }
+  };
 })();
 
 const HIST_KEY = 'dsh-metaphysics/history-v1';
@@ -7560,6 +8905,11 @@ const CSS = `
 .mp-empty b{display:block;font-size:15px;color:var(--dsw-alias-label-primary);margin-bottom:6px;font-weight:600}
 .mp-note{margin-top:12px;padding:9px 14px;border-radius:10px;font-size:12px;background:color-mix(in srgb,var(--dsw-alias-state-warning-primary) 14%,transparent);color:var(--dsw-alias-state-warning-primary)}
 .mp-bar{display:flex;gap:8px;align-items:center;margin-top:14px}
+.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-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)}
 .mp-cast{margin:0 0 14px;padding-left:2px;font-size:12.5px;line-height:1.7;color:var(--dsw-alias-label-secondary)}
 .mp-cast b{color:var(--dsw-alias-label-primary);font-weight:600}
@@ -7645,6 +8995,9 @@ function App() {
   const [hpChart, setHpChart] = useState('bazi');
   const [qimenRule, setQimenRule] = useState('chaibu');
   const [trueSolar, setTrueSolar] = useState(true);
+  const [crossOn, setCrossOn] = useState(false);
+  const [askText, setAskText] = useState('');
+  const [fx, setFx] = useState(null);
   const [onlineGeo, setOnlineGeo] = useState(false);
   const [lines, setLines] = useState('');
   const [result, setResult] = useState(null);
@@ -7670,19 +9023,21 @@ function App() {
   const usesTimeInput = !(tab === 'meihua' && mhMode === 'number');
   const showDT = tab !== 'tarot' && usesTimeInput;
 
-  const run = async (kind, override, modeOverride) => {
+  const run = async (kind, override, modeOverride, over) => {
     const k = kind || tab;
     const mh = modeOverride || mhMode;
     const dt = override ? override : { date, time };
+    const genderV = over && over.gender ? over.gender : gender;
+    const addressV = over && typeof over.address === 'string' ? over.address : address;
     try {
       const datetime = `${dt.date}T${dt.time}`;
       const args = { system: k };
       if (k !== 'tarot') args.datetime = datetime;
       if (k === 'bazi' || k === 'ziwei' || k === 'hepan') {
-        args.gender = gender;
+        args.gender = genderV;
         args.trueSolar = trueSolar;
-        if (address.trim()) {
-          args.address = address.trim();
+        if (addressV.trim()) {
+          args.address = addressV.trim();
           try {
             const g = await Engine.geocodeAddress(args.address, { online: onlineGeo });
             if (g && typeof g.lon === 'number') { args.longitude = g.lon; args.geo = g; }
@@ -7690,6 +9045,7 @@ function App() {
             console.error('[metaphysics] 地址解析失败，退回内置表', e);
           }
         }
+        if (k !== 'hepan') args.cross = crossOn;
       }
       if (k === 'liuyao') {
         const parsed = Core.parseLines(lines);
@@ -7740,8 +9096,12 @@ function App() {
         ? { question: needAsk(k) ? question.trim() : '', direction }
         : undefined;
       const it = Engine.interpret ? Engine.interpret(r, ask) : null;
+      if (it && r.cross && Engine.crossText) {
+        it.sections = [...(it.sections || []), { key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: Engine.crossText(r.cross) }];
+      }
       const timed = kindOf(k) === 'cast' && (k !== 'meihua' || mh === 'time');
       setResult({ kind: k, r, it, at: dt, timed });
+      setFx(null);
       setError('');      setCopied('');
       if (k !== 'tarot') {
         const entry = {
@@ -7804,6 +9164,17 @@ function App() {
     run(tab);
   };
 
+  const openSample = () => {
+    const sample = { date: '1990-05-12', time: '14:30' };
+    setTab('bazi');
+    setGender('male');
+    setAddress('河北石家庄');
+    setManual((m) => Object.assign({}, m, { birth: sample }));
+    setDate(sample.date);
+    setTime(sample.time);
+    run('bazi', sample, null, { gender: 'male', address: '河北石家庄' });
+  };
+
   const switchMode = (m) => {
     setMhMode(m);
     run(tab, { date, time }, m);
@@ -7848,6 +9219,46 @@ function App() {
     } catch (e) { setCopied('复制失败'); }
   };
 
+  const doAsk = () => {
+    if (!result || !result.r || !askText.trim()) return;
+    try {
+      setFx(Engine.followup ? Engine.followup(result.r, askText.trim()) : null);
+    } catch (e) { setFx({ question: askText.trim(), ok: false, answer: '追问失败：' + (e && e.message ? e.message : e), evidence: [], confidence: '弱' }); }
+  };
+
+  const downloadReport = () => {
+    if (!result || !result.r) return;
+    try {
+      const text = Engine.renderText ? Engine.renderText(result.r) : (result.r.summary || '');
+      const blob = new Blob([text], { type: 'text/markdown;charset=utf-8' });
+      const a = document.createElement('a');
+      a.href = URL.createObjectURL(blob);
+      a.download = `命理报告-${result.r.system}.md`;
+      document.body.appendChild(a);
+      a.click();
+      a.remove();
+      setTimeout(() => URL.revokeObjectURL(a.href), 2000);
+    } catch (e) {
+      console.error('[metaphysics] 导出失败', e);
+    }
+  };
+
+  const downloadCard = () => {
+    if (!result || !result.r) return;
+    try {
+      const url = PP.summaryCardPNG ? PP.summaryCardPNG(result.r, result.it) : '';
+      if (!url) { setCopied('当前环境不支持 Canvas 导出'); return; }
+      const a = document.createElement('a');
+      a.href = url;
+      a.download = `命理摘要-${result.r.system}.png`;
+      document.body.appendChild(a);
+      a.click();
+      a.remove();
+    } catch (e) {
+      console.error('[metaphysics] 长图导出失败', e);
+    }
+  };
+
   const field = (label, node) => h('label', { className: 'mp-field' }, h('span', { className: 'mp-lbl' }, label), node);
 
   const replay = (x) => {
@@ -7901,6 +9312,12 @@ function App() {
           className: 'mp-input', placeholder: '如 河北石家庄 / 成都', value: address,
           onChange: (e) => setAddress(e.target.value),
         })) : null,
+        (tab === 'bazi' || tab === 'ziwei') ? h('label', { className: 'mp-field mp-checks' },
+          h('input', {
+            type: 'checkbox', checked: crossOn,
+            onChange: (e) => setCrossOn(e.target.checked),
+          }),
+          h('span', { className: 'mp-lbl' }, '八字 × 紫微 交叉验证')) : null,
         tab === 'hepan' ? field('对方出生日期', h('input', {
           className: 'mp-input', type: 'date', value: pDate, onChange: (e) => setPDate(e.target.value),
         })) : null,
@@ -7973,6 +9390,10 @@ function App() {
           onBlur: (e) => refreshInterpret(undefined, e.target.value),
         })) : null,
       h('div', { key: 'actions', className: 'mp-actions' },
+        h('button', {
+          className: 'mp-btn ghost', style: { fontSize: 12, padding: '5px 12px', marginRight: 8 },
+          onClick: openSample, title: '用固定示例盘看完整报告（不改动你已填的数据）',
+        }, '看示例'),
         h('button', { className: 'mp-btn', onClick: go, title: '时间仍为自动时，点它会取当下再起卦' },
           tab === 'tarot' ? '抽牌' : tab === 'bazi' || tab === 'ziwei' ? '排盘' : tab === 'hepan' ? '合盘' : '起卦'))),
 
@@ -8029,7 +9450,26 @@ function App() {
 
     result ? h('div', { key: 'bar', className: 'mp-bar' },
       h('button', { className: 'mp-btn ghost', style: { fontSize: 12, padding: '5px 12px' }, onClick: copyResult },
-        copied || '复制文字结果')) : null,
+        copied || '复制文字结果'),
+      h('button', {
+        className: 'mp-btn ghost', style: { fontSize: 12, padding: '5px 12px', marginLeft: 8 },
+        onClick: downloadReport, title: '导出盘面 + 解析（含一页读懂、三张表）为 Markdown',
+      }, '导出 .md'),
+      h('button', {
+        className: 'mp-btn ghost', style: { fontSize: 12, padding: '5px 12px', marginLeft: 8 },
+        onClick: downloadCard, title: '生成 PNG 摘要卡（一页读懂 + 首张表），适合直接分享',
+      }, '存为摘要长图')) : null,
+
+    result ? h('div', { key: 'ask', className: 'mp-askbox' },
+      h('input', {
+        className: 'mp-input', value: askText, maxLength: 120,
+        placeholder: '追问：如 2027 年事业怎么样（回车提交）',
+        onChange: (e) => setAskText(e.target.value),
+        onKeyDown: (e) => { if (e.key === 'Enter') doAsk(); },
+      }),
+      h('button', { className: 'mp-btn ghost', style: { fontSize: 12, padding: '5px 12px' }, onClick: doAsk }, '追问')) : null,
+
+    fx ? h('div', { key: 'fx', className: 'mp-fx', dangerouslySetInnerHTML: { __html: PP.followupHTML(fx) } }) : null,
 
     (!result && !error) ? h('div', { key: 'ph', className: 'mp-dim', style: { marginTop: 24, fontSize: 12 } },
       '选择体系后点「排盘」。所有计算在本机完成，不上传任何数据。') : null,