dsh-metaphysics 0.14.3 → 0.15.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.15.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'];
@@ -5717,10 +6351,68 @@ 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 })),
+  };
+}
 
 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 enrichPlain(interpretQimen(r, opts), r, ask);
   const fn = BUILDERS[r.system];
   if (!fn) return null;
   let body;
@@ -5737,11 +6429,11 @@ function interpret(r, opts) {
       sections: [],
       disclaimer: DISCLAIMER,
       error: String(e && e.message),
-      ask: askOf(opts),
+      ask,
     };
   }
-  const tuned = applyAsk(body.dimensions || [], askOf(opts), body.lead || '');
-  return {
+  const tuned = applyAsk(body.dimensions || [], ask, body.lead || '');
+  return enrichPlain({
     moduleType: MODULE_TYPE[r.system] || 'natal',
     system: r.system,
     systemLabel: SYSTEM_LABEL[r.system] || r.system,
@@ -5750,8 +6442,8 @@ function interpret(r, opts) {
     dimensions: tuned.dims,
     sections: body.sections || [],
     disclaimer: DISCLAIMER,
-    ask: askOf(opts),
-  };
+    ask,
+  }, r, ask);
 }
 
 return { DIMENSIONS, MODULE_TYPE, SYSTEM_LABEL, DIRECTIONS, DIRECTION_DEFAULT, dirOf, hexInfo, interpret };
@@ -5771,15 +6463,11 @@ const { geocodeAddress, resolveAddress } = __mods.geo;
 const { toJDN, ganzhiName, dayGanzhiIndex } = __mods.calendar;
 const { randomOf, isSeed } = __mods.random;
 const { interpret, DIRECTIONS, DIRECTION_DEFAULT } = __mods.interpret;
+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) {
@@ -6040,13 +6728,25 @@ function compute(args = {}) {
 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 (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 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}`);
+  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');
 }
@@ -6574,6 +7274,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,6 +7297,15 @@ 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}
@@ -7437,12 +8157,15 @@ 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' : ''}">
+    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>
+      ${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.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 secs = (it.sections && it.sections.length)
@@ -7456,6 +8179,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,10 +8195,14 @@ 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>` : ''}
         <div class="mp-it-body">${dims}</div>
         ${secs}
+        ${fu}
+        ${gloss}
         <div class="mp-it-dis">${esc(it.disclaimer)}</div>
       </div>
     </div>`;