dsh-metaphysics 0.14.2 → 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.2 (+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 } = __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],
@@ -1942,6 +2132,11 @@ function buildLiuyao(input = {}) {
 
   const liushenStart = LIUSHEN_START[dayGanZhi.stem] ?? 0;
 
+  const dayIdx = sexagenaryIndex(STEMS.indexOf(dayGanZhi.stem), BRANCHES.indexOf(dayGanZhi.branch));
+  const xun = dayIdx >= 0 ? Math.floor(dayIdx / 10) : -1;
+  const xunKong = xunKongOf(`${dayGanZhi.stem}${dayGanZhi.branch}`);
+  const xunShou = xun >= 0 ? ganzhiName(xun * 10).name : '';
+
   function decorate(hex, movingSet) {
     const rows = [];
     for (let i = 0; i < 6; i++) {
@@ -1987,6 +2182,8 @@ function buildLiuyao(input = {}) {
       movingPositions: moving.map((i) => i + 1),
     },
     dayGanZhi: { name: dayGanZhi.name, stem: dayGanZhi.stem, branch: dayGanZhi.branch },
+    xunShou,
+    xunKong,
     ben: {
       name: ben.name,
       upper: ben.upper,
@@ -2019,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;
@@ -2036,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 = [
@@ -2194,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);
@@ -3151,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 = ['', '乾', '兑', '离', '震', '巽', '坎', '艮', '坤'];
@@ -3193,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
@@ -3261,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),
@@ -3274,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 = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -3332,7 +3525,6 @@ const DAY_NIGHT_MAP = {
 
 const RI_LU = { 甲: '寅', 乙: '卯', 丙: '巳', 丁: '午', 戊: '巳', 己: '午', 庚: '申', 辛: '酉', 壬: '亥', 癸: '子' };
 const YANG_REN = { 甲: '卯', 乙: '辰', 丙: '午', 丁: '未', 戊: '午', 己: '未', 庚: '酉', 辛: '戌', 壬: '子', 癸: '丑' };
-const SAN_HE = { 申: '水', 子: '水', 辰: '水', 寅: '火', 午: '火', 戌: '火', 巳: '金', 酉: '金', 丑: '金', 亥: '木', 卯: '木', 未: '木' };
 const SAN_HE_SHEN = {
   水: { 驿马: '寅', 桃花: '酉', 华盖: '辰', 劫煞: '巳', 亡神: '亥' },
   火: { 驿马: '申', 桃花: '卯', 华盖: '戌', 劫煞: '亥', 亡神: '巳' },
@@ -3349,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.桃花, '咸池，主情缘');
@@ -3360,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 = { 子: '午', 午: '子', 丑: '未', 未: '丑', 寅: '申', 申: '寅', 卯: '酉', 酉: '卯', 辰: '戌', 戌: '辰', 巳: '亥', 亥: '巳' };
@@ -3439,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) {
@@ -3512,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);
@@ -3603,12 +3788,14 @@ function buildDaliuren(input) {
   };
 }
 
-return { ZHI, GAN, TIAN_JIANG, JIANG_FULL, JIEQI_YUE_JIANG, calcShensha, buildDaliuren };
+return { ZHI, GAN, TIAN_JIANG, JIANG_FULL, JIEQI_YUE_JIANG, GAN_JI_GONG, calcShensha, buildDaliuren };
 })();
 
 __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 = { 子: '水', 丑: '土', 寅: '木', 卯: '木', 辰: '土', 巳: '火', 午: '火', 未: '土', 申: '金', 酉: '金', 戌: '土', 亥: '水' };
@@ -3619,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);
@@ -3627,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)) {
@@ -3650,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 });
 
@@ -3745,6 +3933,7 @@ return { buildHepan };
 
 __mods['ziwei-hepan'] = (function () {
 const { buildZiwei } = __mods.ziwei;
+const { assertCivil } = __mods.validate;
 
 const NAMES = ['命宫', '兄弟', '夫妻', '子女', '财帛', '疾厄', '迁移', '交友', '官禄', '田宅', '福德', '父母'];
 const MUT_MEAN = {
@@ -3765,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 });
 
@@ -3860,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 = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -3895,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 });
@@ -4149,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;
@@ -4667,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'];
@@ -4939,6 +5582,55 @@ function baziInterpret(r) {
 
   const sections = [
     ...(cross.length ? [{ key: 'cross', label: '交叉判断', text: cross.join('　') }] : []),
+    {
+      key: 'reasoning', label: '看盘顺序',
+      text: [
+        `① 先看月令：${st.parts && st.parts.season ? `${st.parts.season.branch}月，日主${dm.element}${st.parts.season.word}（${st.parts.season.weight}）` : '月令已定'}，得旺衰 ${level}（${pick(st, 'score', '—')} 分）。这一步定的是"你有没有力气"。`,
+        `② 再定用神：身强则取泄、耗、制——喜${join(favor)}（${join(ys.favorRoles || [])}），忌${join(avoid)}（${join(ys.avoidRoles || [])}）。这一步定的是"往哪走省力"。`,
+        `③ 看格局：主格${primary}${(() => {
+          const others = (Array.isArray(frame.geju) ? frame.geju : []).map((g) => g.name).filter((n) => n && n !== primary);
+          return others.length ? `，另有${others.join('、')}` : '';
+        })()}。格局与前两步同向时可信度更高；冲突时以用神为先。`,
+        `④ 看大运：当前${pick(cur, 'ganzhi', '—')}（${curTier}）${ln && ln.year ? `，${ln.year} 年流年${ln.ganzhi}为${lnTier}` : ''}。行运的吉凶不看名字，看它落在喜用还是忌神（下方「时间窗」给了理由）。`,
+        `⑤ 落到维度：工作看喜用五行与十神权重；感情看配偶星与日支；健康看最旺与最弱的五行。五维度都只是这套推导的应用，不是另一套算法。`,
+      ].join('\n'),
+    },
+    {
+      key: 'timeline', label: '时间窗',
+      text: (() => {
+        const curSpan = cur && cur.startAge != null ? `${cur.startAge}–${cur.startAge + 9}岁，${curTier}${curLuck.reasons && curLuck.reasons.length ? `；${curLuck.reasons.join('，')}` : ''}` : '—';
+        const nextTwo = (ahead || []).slice(0, 2).map((d) => `${d.ganzhi}（${d.startAge}–${d.startAge + 9}岁，${d.luck?.tier || '平'}）`).join(' → ') || '—';
+        const years = (r.liunian || []).slice(0, 5).map((l) => {
+          const lk = isObj(l.luck) ? l.luck : {};
+          const why = (lk.reasons || []).slice(0, 2).join('，');
+          return `${l.year} ${l.ganzhi}·${l.stemTenGod || ''}·${lk.tier || '平'}${why ? `（${why}）` : ''}`;
+        }).join('；');
+        return `当前大运：${pick(cur, 'ganzhi', '—')}（${curSpan}）。后续两步：${nextTwo}。\n近五年流年：${years || '—'}。\n读法：大运管"这十年的大环境"，流年管"今年的具体天气"；两者打架时，以能否动到用神为准。`;
+      })(),
+    },
+    {
+      key: 'checks', label: '交叉校验',
+      text: (() => {
+        const favorScore = favor.reduce((sum, el) => sum + (Number(wx[el]) || 0), 0);
+        const avoidScore = avoid.reduce((sum, el) => sum + (Number(wx[el]) || 0), 0);
+        const out = [];
+        out.push(favorScore < avoidScore
+          ? `喜用合计 ${favorScore.toFixed?.(1) ?? favorScore} 低于忌神合计 ${avoidScore.toFixed?.(1) ?? avoidScore}：原局里"顺风的条件"偏少，靠行运与外部环境补更现实，别硬扛。`
+          : `喜用合计 ${favorScore} 不低于忌神合计 ${avoidScore}：原局自带可用的条件，行运只是把它放大或压住。`);
+        if (curTier && lnTier) {
+          const good = ['吉', '大吉'];
+          if (good.includes(curTier) && !good.includes(lnTier)) out.push('大运顺、当年逆：方向可以按大运走，具体动作挑流年的顺月做，不必因为一年不顺就推翻长期计划。');
+          else if (!good.includes(curTier) && good.includes(lnTier)) out.push('大运逆、当年顺：今年适合借势处理具体事务，但不宜把长期结构性问题押在这一年解决。');
+          else if (!good.includes(curTier) && !good.includes(lnTier)) out.push('大运与流年都偏逆：以守住基本盘为主，减少新增承诺。');
+          else out.push('大运与流年同向偏顺：可以把想做但一直拖着的事排上日程。');
+        }
+        const tiao = ys.tiaohou && ys.tiaohou.element;
+        if (tiao) out.push(favor.includes(tiao)
+          ? `调候喜${tiao}，与扶抑用神同向：取用上不打架，${tiao}相关的行业与环境优先。`
+          : `调候喜${tiao}，不在扶抑的喜用里：两套取法有分歧，这里以扶抑为主，${tiao}只作环境上的小幅偏好。`);
+        return out.join('　');
+      })(),
+    },
     {
       key: 'yongshen', label: '用神与忌神',
       text: `喜用：${join(favor)}（对应十神：${join(ys.favorTenGods || ys.favorRoles || [])}）；忌：${join(avoid)}（对应十神：${join(ys.avoidTenGods || ys.avoidRoles || [])}）。` +
@@ -4948,6 +5640,10 @@ function baziInterpret(r) {
       key: 'geju', label: '格局依据',
       text: (Array.isArray(frame.geju) ? frame.geju : []).map((g) => `${g.name}（${g.kind}）：${g.evidence}`).join('；') || '未取到格局',
     },
+    {
+      key: 'limits', label: '未纳入',
+      text: '本盘没有计算：流月与流日、神煞的加权轻重、地支藏干的动态引化（合冲后再论）。取用以扶抑为主、调候只做简化提示，各派取法不同；真太阳时未含历史时区与夏令时。把这些补上会改变"强弱"的边际判断，所以这里只给方向，不下断语。',
+    },
   ];
 
   return {
@@ -5112,6 +5808,38 @@ function ziweiInterpret(r) {
   const sections = [
     { key: 'palaces', label: '关键宫位', text: `命宫${soulStar}　官禄${careerStar || '无正曜'}　财帛${wealthStar || '无正曜'}　夫妻${spouseStar || '无正曜'}　疾厄${healthStar || '无正曜'}` },
     { key: 'patterns', label: '格局', text: patText },
+    {
+      key: 'reasoning', label: '看盘顺序',
+      text: [
+        `① 先看命宫：${soulFrom}${S.trait ? `，底色是「${S.trait}」` : ''}。命宫回答的是"你是谁"，不是"会遇到什么"。`,
+        `② 再看三方四正：${(soul && soul.sanfang) ? soul.sanfang.join('、') : '命/财/官/迁'}，会到的主星是${(() => {
+          const names = (soul && soul.sanfang ? soul.sanfang : [])
+            .map((n) => zwMainStar(zwPalace(r, n)))
+            .filter(Boolean);
+          const uniq = [...new Set(names)];
+          return uniq.length ? uniq.join('、') : '无正曜';
+        })()}——这是你与外界打交道时的常用手法。`,
+        natalSihuaText ? `③ 生年四化：${natalSihuaText}。四化比星曜更能指出"你在意什么、哪里会反复"。` : '③ 生年四化：本盘四化信号不明显。',
+        `④ 大限：${daxianPalace ? `${daxianPalace.palace}（${daxianPalace.daxian.start}–${daxianPalace.daxian.end}岁）` : '当前阶段'}。紫微里大限比流年重：十年的主题定下来，流年只是其中一年的天气。`,
+        lnMutagen ? `⑤ 流年四化：${lnMutagen}${r.flow && r.flow.month ? `；流月命宫 ${r.flow.month.ganzhi}${r.flow.month.palace ? `（${r.flow.month.palace}）` : ''}` : ''}。` : '⑤ 流年四化：信号不明显。',
+        '⑥ 落到维度：工作看命宫与官禄的配合；感情看夫妻宫与煞星；健康看疾厄宫——五维度都是上面几步的应用。',
+      ].join('\n'),
+    },
+    {
+      key: 'timeline', label: '时间窗',
+      text: (() => {
+        const list = (r.daxianList || []).slice().sort((a, b) => a.ages[0] - b.ages[0]);
+        const idx = list.findIndex((d) => Number.isFinite(age) && age >= d.ages[0] && age <= d.ages[1]);
+        const pick3 = list.slice(idx >= 0 ? idx : 0, (idx >= 0 ? idx : 0) + 3);
+        const dx = pick3.map((d) => `${d.palace} ${d.ages[0]}–${d.ages[1]}岁·会${(d.mainStars || []).join('') || '—'}${(d.mutagenHits || []).length ? `·${d.mutagenHits.map((m) => m.star + m.type).join('')}` : ''}`).join(' → ');
+        const yrs = (r.liunian || []).slice(0, 5).map((l) => `${l.year} ${l.ganzhi} ${l.age}岁·命宫${l.lifePalace ? l.lifePalace.palace : '—'}`).join('；');
+        return `大限：${dx || '—'}。\n近五年流年：${yrs || '—'}。\n读法：大限定十年的主题，流年四化指出今年往哪边偏；两层方向相反时，以守住大限主题为主。`;
+      })(),
+    },
+    {
+      key: 'limits', label: '未纳入',
+      text: '本盘没有计算：飞星四化（宫干引发的连锁）、小限与大限的加权、流日流时的具体事项定位，以及双星组合的强弱细分。四化表取中州派常用口径，其他流派（如飞星派）结论会不同；这些不改变盘面事实，只影响轻重，所以只作方向参考。',
+    },
   ];
   if (natalSihua.length) {
     const ke = natalSihua.find((m) => m.type === '科') || null;
@@ -5200,6 +5928,9 @@ function liuyaoInterpret(r) {
   const movingLiuqin = moving?.liuqin || '';
   const movingLiushen = moving?.liushen || '';
   const dayGZ = pick(r.dayGanZhi, 'name', '');
+  const cnt = (k) => lines.filter((l) => l.liuqin === k).length;
+  const lineEv = (l) => (l ? `${l.position}爻${l.liuqin}${l.liushen ? '·' + l.liushen : ''}${l.moving ? '（动）' : ''}` : '—');
+  const ev = (...xs) => xs.filter((x) => x != null && x !== '');
 
   sections.push({
     key: 'liuqin', label: '六亲取用',
@@ -5207,18 +5938,45 @@ function liuyaoInterpret(r) {
       `如果你心里有具体问题，可以对号入座：${Object.entries(LIUQIN_USE).map(([k, v]) => `${k}主${v.split('，')[0]}`).join('；')}。`,
   });
 
+  sections.push({
+    key: 'reasoning', label: '看卦顺序',
+    text: [
+      `① 先定卦宫：本卦「${ben.name || '—'}」属${String(pick(ben, 'palace', '—')).replace(/宫$/, '')}宫（${palaceEl || '—'}），六亲由此排定——宫变了，同一个字的六亲就变了。`,
+      `② 再看世应：世在${ben.shi}爻（${shiLine ? `${shiLine.liuqin}${shiLine.liushen ? `·${shiLine.liushen}` : ''}` : '—'}），应在${ben.ying}爻（${yingLine ? `${yingLine.liuqin}` : '—'}）；世代表你，应代表对方与环境。`,
+      `③ 看动爻：${moving ? `${moving.position}爻${moving.liuqin}${moving.liushen ? `（${moving.liushen}）` : ''}发动，事情的变化点在这里` : '六爻安静，短期不会有大的转折'}。`,
+      `④ 定用神：按所问之事取六亲——问工作看官鬼、文书看父母、求财与感情（男）看妻财、健康看官鬼与子孙；用神不上卦时，看伏神或借日月。`,
+      `⑤ 看日辰：${dayGZ || '—'}日起六神、定旬空；日辰能生克动爻，但不被爻所伤。`,
+      `⑥ 看变卦：${bian.name ? `变出「${bian.name}」，是事情后续的走向` : '本卦无变，以静卦论'}。以上每一步都能在下方「依据」里对上号。`,
+    ].join('\n'),
+  });
+  sections.push({
+    key: 'limits', label: '未纳入',
+    text: '本卦没有计算：月建对爻的旺衰（只用了日辰）、伏神与飞神的完整生克链、进神退神与反吟伏吟的细节，以及用神多重时的取舍权重。这些会改变"旺不旺"的判断，所以这里只给取象与方向。',
+  });
+
   const dimensions = [
     {
       key: 'overall', label: '整体运势',
       text: `这一卦是「${benInfo.full}」，${benInfo.meaning}。${movingLiushen ? `动爻带${movingLiushen}，事情带一点${movingLiushen === '青龙' ? '喜庆顺遂' : movingLiushen === '白虎' ? '压力与阻碍' : movingLiushen === '朱雀' ? '口舌与是非' : movingLiushen === '玄武' ? '不明朗、需要核实' : '反复与牵扯'}的色彩。` : ''}` +
         `日辰为${dayGZ}，卦宫属${palaceEl}，整体更像是${benInfo.scene}的阶段。`,
       advice: `${benInfo.scene}——顺着这句做就行。${moving ? '既然有动爻，说明事情还在变化，先观察几天再定也不迟。' : '暂无动爻，说明短期内不会有大的转折，维持现状反而是稳妥选择。'}`,
+      evidence: ev(
+        `本卦 ${ben.name || '—'}（${ben.upper || ''}/${ben.lower || ''}）`,
+        moving ? `动爻 ${lineEv(moving)}` : '无动爻',
+        `日辰 ${dayGZ || '—'}`,
+        `卦宫 ${pick(ben, 'palace', '—')}·${palaceEl || '—'}`,
+      ),
     },
     {
       key: 'work', label: '工作与职业选择',
       text: `问工作看官鬼与父母：本卦中${(lines.filter((l) => l.liuqin === '官鬼').length ? `官鬼出现${lines.filter((l) => l.liuqin === '官鬼').length}处，${lines.find((l) => l.liuqin === '官鬼').moving ? '且有发动，岗位或考核层面会有动作' : '但未发动，职位层面暂时平稳'}` : '未见官鬼，工作这件事在卦中不是主要矛盾')}；` +
         `${(lines.filter((l) => l.liuqin === '父母').length ? '父母（文书、合同、资质）有出现，涉及手续与材料的事要提前准备' : '父母未现，手续类事务暂无明显阻碍')}。`,
       advice: `如果正在看机会，建议先把合同、岗位职责这些落到纸面上的东西问清楚；${moving?.liuqin === '官鬼' ? '动爻在官鬼，工作层面近期有变动的迹象，可以主动谈，但别先辞再找。' : '工作层面暂无强动象，稳住手上的事更划算。'}`,
+      evidence: ev(
+        `官鬼 ${cnt('官鬼')} 现`,
+        `父母 ${cnt('父母')} 现`,
+        movingLiuqin ? `动爻六亲 ${movingLiuqin}` : '无动爻',
+      ),
     },
     {
       key: 'career', label: '事业发展',
@@ -5226,18 +5984,33 @@ function liuyaoInterpret(r) {
         `世应之间${shiLine && yingLine ? (shiLine.liuqin === yingLine.liuqin ? '同气相求，双方立场接近' : '立场有别，需要多沟通') : '信号不明'}，` +
         `${bianInfo ? `变卦「${bianInfo.full}」提示后续走向是${bianInfo.scene}` : '暂无变卦'}。`,
       advice: `事业上的建议是：${shiLine?.moving ? '你自己这边有主动变化的意思，那就把想法说出来、把动作做出来' : '先不动，把手上的事做扎实'}；${bianInfo ? `按${bianInfo.scene}的方向去准备，会比被动等结果好。` : ''}`,
+      evidence: ev(
+        `世 ${lineEv(shiLine)}`,
+        `应 ${lineEv(yingLine)}`,
+        bian.name ? `变卦 ${bian.name}` : '无变卦',
+      ),
     },
     {
       key: 'love', label: '爱情与感情',
       text: `问感情，男看妻财、女看官鬼。本卦中${(lines.filter((l) => l.liuqin === '妻财').length ? `妻财${lines.filter((l) => l.liuqin === '妻财').length}现${lines.find((l) => l.liuqin === '妻财').moving ? '且发动，感情层面有动静' : '但安静，关系暂时平缓'}` : '妻财未现，感情不是当前卦象的重点')}；` +
         `${(lines.filter((l) => l.liuqin === '官鬼').length ? '官鬼有现，对方或关系中的压力面是被看到的' : '官鬼未现')}。${benInfo.meaning}，放在关系里就是${benInfo.scene}。`,
       advice: `关系里${moving?.liuqin === '妻财' || moving?.liuqin === '官鬼' ? '近期有变化的可能，适合把话说开，别憋着' : '暂时平稳，可以按自己的节奏相处'}。卦象只给倾向，真正决定关系的是你们怎么沟通。`,
+      evidence: ev(
+        `妻财 ${cnt('妻财')} 现`,
+        `官鬼 ${cnt('官鬼')} 现`,
+        `世应 ${lineEv(shiLine)} / ${lineEv(yingLine)}`,
+      ),
     },
     {
       key: 'health', label: '健康状况',
       text: `问健康，看官鬼（病）与子孙（医药、消散）。本卦中${(lines.filter((l) => l.liuqin === '官鬼').length ? `官鬼有现${lines.find((l) => l.liuqin === '官鬼').moving ? '且发动，提示身体上可能有需要留意的地方' : '，但安静，暂无明显变化'}` : '官鬼未现，卦象未指向明显的身体问题')}；` +
         `${(lines.filter((l) => l.liuqin === '子孙').length ? '子孙有现，恢复与调养的出口是有的' : '子孙未现，休息与调养需要自己主动安排')}。${movingLiushen === '白虎' ? '动爻带白虎，尤其别忽视突发的身体信号。' : ''}`,
       advice: `这一卦在健康上的提醒是${(lines.filter((l) => l.liuqin === '官鬼').length ? '别硬扛，累了就休息，有机会就做一次检查' : '维持现有作息即可，别自己吓自己')}。任何不适请就医，卦象不能替代诊断。`,
+      evidence: ev(
+        `官鬼 ${cnt('官鬼')} 现`,
+        `子孙 ${cnt('子孙')} 现`,
+        movingLiushen ? `动爻六神 ${movingLiushen}` : '',
+      ),
     },
   ];
 
@@ -5286,30 +6059,53 @@ function meihuaInterpret(r) {
       text: `本卦「${benInfo.full}」，${benInfo.meaning}。体${bodyEl}用${useEl}，${relation}，判定为${mhLevel}。` +
         `${isJi ? '整体的倾向是顺的：外部环境对你不算苛刻，可以正常推进' : isXiong ? '整体有阻力：不是不能做，而是要多留余量与耐心' : '整体平稳，不会有大的起落'}。`,
       advice: `${benInfo.scene}。${isXiong ? '建议把节奏放慢，先解决卡点再谈推进' : isJi ? '可以趁势把想做的事往前推一步' : '按原计划走，不必刻意改变'}。`,
+      evidence: [
+        `本卦 ${benInfo.full}`,
+        `互卦 ${pick(hu, 'name', '—')}`,
+        `变卦 ${pick(bian, 'name', '—')}`,
+        `体${bodyEl} / 用${useEl}·${relation || '—'}`,
+        `判定 ${mhLevel || '—'}`,
+      ].filter(Boolean),
     },
     {
       key: 'work', label: '工作与职业选择',
       text: `梅花里工作看用卦与体卦的生克：现在用卦${useEl}${isJi ? '对体卦有利，说明当下的工作环境或岗位与你的匹配度还不错' : isXiong ? '与体卦相耗，说明眼下这份工作消耗感偏重' : '与体卦关系平和，属于不好不坏'}` +
         `。本卦${benInfo.meaning}，对应到工作里就是${benInfo.scene}。`,
       advice: `${isXiong ? '如果长期觉得被消耗，可以先在内部争取调整职责，再考虑外部机会' : isJi ? '适合主动争取更多责任或更好的岗位' : '把手上的事做好，等一个明确的信号再动'}。选工作时优先考虑让你舒服的环境，长期看比短期收益重要。`,
+      evidence: [`体卦 ${bodyEl}`, `用卦 ${useEl}`, `体用 ${relation || '—'}`],
     },
     {
       key: 'career', label: '事业发展',
       text: `变卦「${bianInfo ? bianInfo.full : ''}」代表事情的结局方向，${bianInfo ? bianInfo.meaning : ''}。互卦「${pick(hu, 'name', '')}」代表过程，${hexInfo(hu.name, hu.upper, hu.lower).meaning}。` +
         `合起来看：过程${hexInfo(hu.name, hu.upper, hu.lower).scene}，结果${bianInfo ? bianInfo.scene : '暂不明朗'}。`,
       advice: `按这个结构，建议${isJi ? '现在就把关键的一步迈出去' : isXiong ? '先补短板、攒条件，等下一轮再动' : '小步推进，边做边看'}。动爻在${pick(r, 'movingName', '某爻')}，变化点就在那里，值得重点关注。`,
+      evidence: [
+        `互卦 ${pick(hu, 'name', '—')}`,
+        `变卦 ${pick(bian, 'name', '—')}`,
+        `动爻 ${pick(r, 'movingName', '—')}`,
+      ],
     },
     {
       key: 'love', label: '爱情与感情',
       text: `感情上看体用是否相合：体${bodyEl}与用${useEl}之间是${relation}，${isJi ? '这种组合在关系里意味着双方相处比较顺，彼此能给到支撑' : isXiong ? '这种组合提示相处中有一方付出更多，需要留意平衡' : '关系处在常态，没有特别的张力'}` +
         `。本卦${benInfo.meaning}，放到两人之间就是${benInfo.scene}。`,
       advice: `${isXiong ? '别把不满攒着，找个合适的时机说清楚；也别指望对方猜' : isJi ? '可以主动推进关系，做一些共同的事' : '维持现在的相处节奏就好'}。卦象看的是当下的气氛，关系的走向取决于你们怎么经营。`,
+      evidence: [
+        `体 ${bodyEl} / 用 ${useEl}`,
+        `体用 ${relation || '—'}`,
+        `本卦 ${benInfo.full}`,
+      ],
     },
     {
       key: 'health', label: '健康状况',
       text: `梅花里健康看体卦的强弱：体卦${pick(bu.body, 'trigram', '')}属${bodyEl}，${isXiong ? '被用卦所耗，传统取象上提示近期精力消耗偏大' : isJi ? '得到生扶，精力状态相对好' : '平顺，无明显偏枯'}。` +
         `${WUXING_ORGAN[bodyEl] ? `${bodyEl}对应${WUXING_ORGAN[bodyEl].part}，${WUXING_ORGAN[bodyEl].note}。` : ''}这是取象提示，不是诊断。`,
       advice: `${isXiong ? '近期别硬撑，睡眠与饮食先稳住，有条件做一次常规体检' : '保持现在的作息即可，顺势多动一动更好'}。身体有明确的症状请直接看医生。`,
+      evidence: [
+        `体卦 ${pick(bu.body, 'trigram', '—')}属${bodyEl}`,
+        `用卦 ${pick(bu.use, 'trigram', '—')}属${useEl}`,
+        `体用 ${relation || '—'}`,
+      ],
     },
   ];
 
@@ -5327,6 +6123,12 @@ function daliurenInterpret(r) {
   const gj = isObj(r.geJu) ? r.geJu : {};
   const ke = Array.isArray(r.siKe) ? r.siKe : [];
   const jiangOf = (x) => LIUREN_JIANG[x?.jiangFull] || LIUREN_JIANG[x?.jiang] || '';
+  const chuQin = pick(chu, 'liuQin', '');
+  const moQin = pick(mo, 'liuQin', '');
+  const hasKong = !!(chu.xunKong || zhong.xunKong || mo.xunKong);
+  const scText = JSON.stringify(sc);
+  const has = (x) => scText.includes(x);
+  const chuan = `初${pick(chu, 'zhi', '—')} → 中${pick(zhong, 'zhi', '—')} → 末${pick(mo, 'zhi', '—')}`;
 
   const sections = [
     {
@@ -5340,12 +6142,23 @@ function daliurenInterpret(r) {
       key: 'geju', label: '课体与四课',
       text: `本课为${pick(gj, 'name', '未定')}${gj.detail ? `（${gj.detail}）` : ''}。${ke.length ? `四课：${ke.map((k, i) => `${i + 1}课 ${k.shang || ''}上${k.xia || ''}下`).join('　')}` : ''}`,
     },
+    {
+      key: 'reasoning', label: '看课顺序',
+      text: [
+        `① 先看月将加时：月将${pick(r.yueJiang, 'name', '—')}${pick(r.yueJiang, 'zhi', '')}加在${pick(r, 'hourZhi', '—')}时上，定出天地盘——后面所有关系都从这张盘推。`,
+        `② 再看四课：日干寄宫起一课，日支起二课，依次得三、四课；四课是"事情的四个面"。`,
+        `③ 看三传：初传${pick(chu, 'zhi', '—')}（${chuQin || '—'}）起，中传${pick(zhong, 'zhi', '—')}（${pick(zhong, 'liuQin', '—')}），末传${pick(mo, 'zhi', '—')}（${moQin || '—'}）落——发端、过程、结局。`,
+        `④ 定课体：${pick(gj, 'name', '未定')}${gj.detail ? `（${gj.detail}）` : ''}；课体决定这件事"以什么方式"推进，不是吉凶标签。`,
+        `⑤ 看神将：月将、贵人与旬空决定信号强弱；旬空处多为"看着有、实则虚"，须核实。`,
+        '⑥ 落到维度：工作看官鬼与青龙、朱雀；感情看六合、天后与妻财；健康看白虎与子孙——都是上面几步的应用。',
+      ].join('\n'),
+    },
+    {
+      key: 'limits', label: '未纳入',
+      text: '本课没有计算：年命与行年（命上神）、神煞的加权轻重、伏吟反吟的细分，以及课体之间的互涉。三传只取九宗门里的主要取法，其他流派（如以贵神起课）结论可能不同；这些只影响轻重，不改变课面事实。',
+    },
   ];
 
-  const chuQin = pick(chu, 'liuQin', '');
-  const moQin = pick(mo, 'liuQin', '');
-  const hasKong = !!(chu.xunKong || zhong.xunKong || mo.xunKong);
-
   const dimensions = [
     {
       key: 'overall', label: '整体运势',
@@ -5353,6 +6166,12 @@ function daliurenInterpret(r) {
         `${hasKong ? '课中有旬空，提示事情里有「看着有、实则虚」的部分，涉及承诺与数字的要核实。' : '课中无旬空，事情相对实在。'}` +
         `整体倾向是：${/吉|生|合/.test(jiangOf(chu) + jiangOf(mo)) ? '开局与结局的象都不差，可以正常推进' : /虎|蛇|勾|空/.test(jiangOf(chu) + jiangOf(mo)) ? '过程中有牵绊与不明朗处，宜慢不宜快' : '平顺中带一点摩擦' }。`,
       advice: `${hasKong ? '先把信息核实清楚，别在含糊的基础上做决定' : '按你原本的计划推进即可'}。${/虎/.test(jiangOf(chu)) ? '开局带白虎，头几天别硬碰，先观察。' : ''}事情的局面是动态的，这一课看的是当下这一刻的气象。`,
+      evidence: [
+        `课体 ${pick(gj, 'name', '—')}`,
+        `三传 ${chuan}`,
+        `月将 ${pick(r.yueJiang, 'name', '—')}`,
+        hasKong ? '课中见旬空' : '无旬空',
+      ],
     },
     {
       key: 'work', label: '工作与职业选择',
@@ -5360,12 +6179,22 @@ function daliurenInterpret(r) {
         `${/青龙/.test(JSON.stringify(sc)) ? '课中见青龙，工作层面有喜庆与进益的象' : '课中未见青龙，工作层面属常态推进'}；` +
         `${/朱雀/.test(JSON.stringify(sc)) ? '见朱雀，文书、沟通与口舌要留意，材料务必留底' : ''}`,
       advice: `涉及岗位与待遇的事，建议把口头承诺落成文字；${/朱雀/.test(JSON.stringify(sc)) ? '沟通时少说满话，多留余地。' : '正常沟通即可。'}选工作时优先考虑课象中显示出支撑力的方向。`,
+      evidence: [
+        `初传 ${pick(chu, 'zhi', '—')}·${chuQin || '未取'}·${jiangOf(chu) || '—'}`,
+        has('青龙') ? '见青龙' : '无青龙',
+        has('朱雀') ? '见朱雀' : '无朱雀',
+      ],
     },
     {
       key: 'career', label: '事业发展',
       text: `末传${pick(mo, 'zhi', '')}（${moQin || ''}·${jiangOf(mo) || ''}）主结局，${moQin === '官鬼' ? '结局落在官鬼，事业这条线会有明确的结果或位置变化' : moQin === '妻财' ? '结局落在妻财，更多体现为收入与资源的落袋' : moQin === '子孙' ? '结局落在子孙，压力会消散，适合收尾与转向' : '结局的信号相对中性'}。` +
         `${mo.xunKong ? '末传旬空，结局有落空的可能，别把预期定得太满。' : '末传不空，结果相对实在。'}`,
       advice: `按三传的顺序安排节奏：初传阶段先摸清情况，中传阶段处理摩擦，末传阶段收果。${mo.xunKong ? '对结果保留一点弹性，Plan B 提前想好。' : '可以朝着末传给出的方向去准备。'}`,
+      evidence: [
+        `末传 ${pick(mo, 'zhi', '—')}·${moQin || '未取'}·${jiangOf(mo) || '—'}`,
+        mo.xunKong ? '末传旬空' : '末传不空',
+        `三传 ${chuan}`,
+      ],
     },
     {
       key: 'love', label: '爱情与感情',
@@ -5373,12 +6202,22 @@ function daliurenInterpret(r) {
         `${/天后/.test(JSON.stringify(sc)) ? '见天后，有被照顾、被回应的象' : ''}${/玄武/.test(JSON.stringify(sc)) ? '见玄武，提示信息不明或有隐瞒，重要的事要当面问清' : ''}` +
         `${/妻财/.test(JSON.stringify(sc)) ? '课中见妻财，感情这条线是被看到的' : ''}。`,
       advice: `${/玄武/.test(JSON.stringify(sc)) ? '关系里有看不清的地方，别猜，直接问。' : '按你感受到的相处状态来判断就好。'}卦象只反映当下的气氛，关系如何取决于两个人怎么做。`,
+      evidence: [
+        has('六合') ? '见六合' : '无六合',
+        has('天后') ? '见天后' : '无天后',
+        has('妻财') ? '见妻财' : '无妻财',
+      ],
     },
     {
       key: 'health', label: '健康状况',
       text: `健康看白虎与子孙：本课${/白虎/.test(JSON.stringify(sc)) ? '见白虎，传统取象上提示身体有需要留意的地方，尤其突发的不适别忽视' : '未见白虎，卦象未指向明显的身体问题'}；` +
         `${/子孙/.test(JSON.stringify(sc)) ? '见子孙，医药与调养的出口是有的，恢复的象在' : '未见子孙，休息与调养需要自己主动安排'}。这些都是象征提示，不构成医学判断。`,
       advice: `${/白虎/.test(JSON.stringify(sc)) ? '近期别熬夜、别硬扛，有条件做一次检查' : '保持现有作息，适度运动即可'}。任何不适请就医，这一课不能替代诊断。`,
+      evidence: [
+        has('白虎') ? '见白虎' : '无白虎',
+        has('子孙') ? '见子孙' : '无子孙',
+        `课体 ${pick(gj, 'name', '—')}`,
+      ],
     },
   ];
 
@@ -5442,6 +6281,12 @@ function tarotInterpret(r) {
         `${reversed.length ? `其中${join(reversed.map((c) => `${c.name}（${c.position}）`))}是逆位，逆位不等于凶，更像那股力量还没顺过来或用力过猛，它是这张牌阵里最值得你先看的部分。` : '全部为正位，说明牌面呈现的状态与你当下的处境是通的。'}` +
         `${lack.length ? `元素上缺${join(lack)}，${lack.map((e) => TAROT_ELEMENT_FOCUS[e]?.area).filter(Boolean).join('、')}这一块容易被忽略。` : ''}`,
       advice: `${reversed.length ? `先把${reversed[0].name}指出的卡点处理掉（${(reversed[0].keywords || []).join('、')}），暂时不要加码推进` : '按牌面呈现的节奏走'}；${lack.length ? `补一点${lack[0]}的力量：${TAROT_ELEMENT_FOCUS[lack[0]]?.advice || ''}` : '把注意力放在能立刻做的小事上，先动一件'}。牌是镜子，照的是你此刻的状态。`,
+      evidence: [
+        `牌阵 ${n} 张（${cards.map((c) => c.position).join(' / ')}）`,
+        `主轴 ${axis ? `${axis.name}·${axis.position}·${axis.orientation}` : '—'}`,
+        `逆位 ${reversed.length} / 正位 ${upright.length}`,
+        lack.length ? `缺 ${join(lack)}` : '五行元素齐',
+      ],
     },
     {
       key: 'work', label: '工作与职业选择',
@@ -5449,6 +6294,11 @@ function tarotInterpret(r) {
         `${court.length ? `牌中有宫廷牌${join(court.map((c) => c.name))}，说明局面里有具体的人（也可能就是你自己的某个侧面）在起作用。` : ''}` +
         `${elCount.土 ? '有土元素，现实条件与资源是被这张牌阵看到的。' : '缺土元素，现实条件与资源这块容易估计不足。'}`,
       advice: `工作上建议：${elCount.土 ? '把计划落到预算与时间表上，别停在口头' : '先把现实条件摸清楚——薪资、工时、稳定性，再谈喜好'}；${dimBase('work') && !dimBase('work').upright ? '这张相关牌是逆位，说明当下的不适主要来自状态而非岗位本身，可以调状态再看。' : ''}`,
+      evidence: [
+        `工作相关牌 ${dimBase('work') ? `${dimBase('work').name}·${dimBase('work').position}·${dimBase('work').orientation}` : '无'}`,
+        `宫廷牌 ${court.length} 张`,
+        `土元素 ${elCount.土 || 0} 张`,
+      ],
     },
     {
       key: 'career', label: '事业发展',
@@ -5456,12 +6306,20 @@ function tarotInterpret(r) {
         `${major.length >= Math.ceil(n / 2) ? '大牌过半，事业这条线牵动的不只是岗位，还有你对自己要往哪走的判断' : '变化更多发生在具体事务层面，先把眼前的项目做成'}` +
         `${axis ? `；结局位置的「${axis.name}」给出的方向是${axis.core || ''}` : ''}。`,
       advice: `建议把${cards[0]?.position || '最初'}这一环的课题先收尾，再往${axis?.position || '结果'}的方向推进；${elCount.火 ? '火的能量在，适合主动出击一步' : '缺火时别等热情来，先用流程推着自己动'}。事业发展是长线，牌面只反映当前这一段。`,
+      evidence: [
+        `时间线 ${cards.map((c) => `${c.position}·${c.name}${c.orientation}`).join(' → ')}`,
+        `大阿卡纳 ${major.length}/${n}`,
+      ],
     },
     {
       key: 'love', label: '爱情与感情',
       text: `${dimBase('love') ? `与感情最相关的是「${dimBase('love').name}」（${dimBase('love').position}·${dimBase('love').orientation}）：${dimBase('love').core || (dimBase('love').keywords || []).join('、')}。` : '牌面上没有明确指向感情的牌，当下这段关系不是主要议题。'}` +
         `${elCount.水 ? '有水元素，情感与感受在这件事里占的分量不轻。' : '缺水元素，容易用理性压过感受，留意别忽略自己的情绪。'}`,
       advice: `${elCount.水 ? '先照顾好感受再谈效率：把想说的话说出口，比猜对方心思有效' : '给自己留一点感受情绪的时间，别把所有事都当任务处理'}；${dimBase('love') && !dimBase('love').upright ? '相关牌为逆位，提示关系里有没说开的地方，找个合适时机讲清楚。' : ''}关系取决于你们怎么做，牌只帮你把问题问清楚。`,
+      evidence: [
+        `感情相关牌 ${dimBase('love') ? `${dimBase('love').name}·${dimBase('love').position}·${dimBase('love').orientation}` : '无'}`,
+        `水元素 ${elCount.水 || 0} 张`,
+      ],
     },
     {
       key: 'health', label: '健康状况',
@@ -5469,6 +6327,11 @@ function tarotInterpret(r) {
         `${reversed.length >= 2 ? `${reversed.length} 张逆位，提示内在消耗偏大，身体往往是第一个反映出来的` : '整体状态与牌面呈现的相对一致'}` +
         `${elCount.土 || elCount.水 ? '' : '；缺土与水，作息与身体的基本盘容易被牺牲'}。这些是象征性的提示，不是诊断。`,
       advice: `${reversed.length >= 2 ? '建议先把睡眠与饮食稳住，别在这个阶段额外加压' : '维持现有作息，适度运动即可'}；${lack.length ? `补${lack[0]}所代表的${TAROT_ELEMENT_FOCUS[lack[0]]?.area || ''}：${TAROT_ELEMENT_FOCUS[lack[0]]?.advice || ''}` : ''}身体有明确不适请就医，牌面不能替代专业意见。`,
+      evidence: [
+        `健康相关牌 ${dimBase('health') ? `${dimBase('health').name}·${dimBase('health').position}` : '无'}`,
+        `逆位 ${reversed.length} 张`,
+        `元素 土${elCount.土 || 0} / 水${elCount.水 || 0}`,
+      ],
     },
   ];
 
@@ -5488,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;
@@ -5508,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,
@@ -5521,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 };
@@ -5542,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) {
@@ -5777,6 +6694,7 @@ function liuyaoText(r) {
   const out = [
     `起卦：${r.cast.notation.join('、')}（自下而上）`,
     `日辰：${r.dayGanZhi.name}`,
+    r.xunShou ? `旬首：${r.xunShou}　旬空：${(r.xunKong || []).join('') || '—'}` : '',
     r.question ? `所问：${r.question}` : '',
     '本卦：',
     fmt(r.ben),
@@ -5810,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');
 }
@@ -5998,6 +6928,34 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
 
     const Engine = __mods.index;
     window.Engine = Engine;
+(function () {
+  const NEED_ASK = { liuyao: true, meihua: true, daliuren: true, tarot: true };
+  const needAsk = (kind) => !!NEED_ASK[kind];
+
+  function parseLines(text) {
+    const raw = String(text == null ? '' : text).trim();
+    if (!raw) return { lines: null, warning: '' };
+    const v = raw.split(/[^0-9]+/).filter(Boolean).map(Number);
+    const bad = v.filter((n) => ![6, 7, 8, 9].includes(n));
+    if (v.length === 6 && bad.length === 0) return { lines: v, warning: '' };
+    return {
+      lines: null,
+      warning: v.length !== 6
+        ? `爻值需要正好 6 个数字（当前 ${v.length} 个），本次按随机摇卦。`
+        : `爻值只能是 6/7/8/9（收到 ${bad.join('/')}），本次按随机摇卦。`,
+    };
+  }
+
+  function toNumber(text) {
+    const raw = String(text == null ? '' : text).trim();
+    if (!raw) return null;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : null;
+  }
+
+  window.__MPCore = { NEED_ASK, needAsk, parseLines, toNumber };
+})();
+
 (function () {
   const CSS = `
 .pp,.mp-it{--ink:#1b1b1b;--ink2:#3f3a33;--muted:#6f6a60;--label:#8a8378;--faint:#a9a296;
@@ -6316,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}
@@ -6328,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}
@@ -6997,6 +7975,24 @@ return { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf, geocodeAd
     </div>`;
   };
 
+  pp.qimenFactsHTML = function (r) {
+    if (!r || !r.palaces) return '';
+    const row = (k, v) => `<div class="relation__row"><dt>${esc(k)}</dt><dd>${esc(v)}</dd></div>`;
+    const rows = [
+      ['局数', `${r.ju}${r.yuan ? `（${r.yuan}）` : ''}`],
+      ['节气', `${r.jieqi || '—'}${r.jieqiTime ? `（${r.jieqiTime}）` : ''}`],
+      ['四柱', `${r.siZhu ? `${r.siZhu.year} ${r.siZhu.month} ${r.siZhu.day} ${r.siZhu.time}` : '—'}`],
+      ['值符', r.zhiFu ? `${r.zhiFu.star} · ${r.zhiFu.gong}宫` : '—'],
+      ['值使', r.zhiShi ? `${r.zhiShi.gate} · ${r.zhiShi.gong}宫` : '—'],
+      ['旬首', r.xunshou || '—'],
+      ['空亡', (r.kongWang || []).join('') || '—'],
+      ['驿马', r.ma && r.ma.zhi ? `${r.ma.zhi}${r.ma.gong ? `（${r.ma.gong}宫）` : ''}` : '—'],
+      ['换局规则', r.juMethodNote || r.juMethod || '—'],
+      ['晚子时', r.lateZiHourMode === 'next-day' ? '23:00 后归次日' : '23:00 后仍归当日'],
+    ];
+    return `<dl class="relation mp-qm-facts" aria-label="奇门盘面事实">${rows.map(([k, v]) => row(k, v)).join('')}</dl>`;
+  };
+
   const QM_ROWS = [['4', '9', '2'], ['3', '5', '7'], ['8', '1', '6']];
   pp.qimenHTML = function (r) {
     const byGong = {};
@@ -7161,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)
@@ -7180,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>
@@ -7188,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>`;
@@ -7254,6 +8265,18 @@ const CSS = `
 .mp-seg{display:flex;width:100%;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;overflow:hidden;height:36px}
 .mp-seg button{flex:1;padding:0 8px;background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-size:13px;cursor:pointer}
 .mp-seg button.on{background:var(--dsw-alias-brand-primary);color:#fff}
+.mp-qmrule{grid-column:1 / -1;border:0;margin:0;padding:0;display:flex;flex-wrap:wrap;align-items:center;gap:10px 14px}
+.mp-qmrule legend{padding:0}
+.mp-qmopts{display:flex;flex-wrap:wrap;gap:8px}
+.mp-qmopt{display:inline-flex;align-items:center;gap:7px;padding:7px 12px;border:1px solid var(--dsw-alias-border-l1);border-radius:8px;font-size:13px;cursor:pointer;color:var(--dsw-alias-label-primary)}
+.mp-qmopt input{accent-color:var(--dsw-alias-brand-primary);margin:0}
+.mp-qmhelp{flex:1 1 100%;font-size:12.5px;color:var(--dsw-alias-label-secondary)}
+.mp-qmhelp summary{cursor:pointer}
+.mp-qmhelp p{margin:6px 0 0}
+.relation{display:flex;flex-direction:column;gap:6px;margin:14px 0 0;padding:12px;background:var(--dsw-alias-bg-layer-2);border-left:3px solid var(--dsw-alias-brand-primary);border-radius:8px}
+.relation__row{display:grid;grid-template-columns:96px minmax(0,1fr);gap:8px;align-items:baseline}
+.relation__row dt{margin:0;font-size:12.5px;color:var(--dsw-alias-label-secondary)}
+.relation__row dd{margin:0;font-size:13.5px;color:var(--dsw-alias-label-primary)}
 .mp-hist{margin-bottom:14px}
 .mp-hist-h{display:flex;align-items:center;justify-content:space-between;font-size:12px;color:var(--dsw-alias-label-secondary);margin-bottom:6px}
 .mp-hist-clear{background:transparent;border:none;color:var(--dsw-alias-label-secondary);font-size:12px;cursor:pointer;padding:0}
@@ -7321,6 +8344,7 @@ const TABS = [
   { k: 'liuyao', label: '六爻', timeLabel: '起卦时刻', hint: '六爻不需要出生时间：只用起卦当下的日辰定六神、月建定旺衰，卦由摇出。' },
   { k: 'meihua', label: '梅花', timeLabel: '起卦时刻', hint: '梅花用起卦时刻的年月日时数成卦，也可直接给两个数字起卦；与出生时间无关。' },
   { k: 'daliuren', label: '六壬', timeLabel: '起卦时刻', hint: '大六壬用起卦时刻的日干支、时支与月将起天地盘；同样与出生时间无关。' },
+  { k: 'qimen', label: '奇门', timeLabel: '起局时刻', hint: '奇门时家转盘：用起局时刻定节气、三元与局数；换局规则决定符头与节气如何对齐。' },
   { k: 'hepan', label: '合盘', timeLabel: '你的出生时刻', hint: '合盘按「日主 + 夫妻宫 + 五行互补」看两个人的相处与互补，需要双方出生信息。' },
     { k: 'tarot', label: '塔罗', timeLabel: '', hint: '塔罗不看时间，只记录抽牌时刻与你的提问。' },
 ];
@@ -7334,14 +8358,14 @@ function nowParts() {
 
 const TIME_KIND = {
   ziwei: 'birth', bazi: 'birth', hepan: 'birth',
-  liuyao: 'cast', meihua: 'cast', daliuren: 'cast',
+  liuyao: 'cast', meihua: 'cast', daliuren: 'cast', qimen: 'cast',
   tarot: 'none',
 };
 const SAMPLE = { date: '1990-05-12', time: '14:30' };
 const kindOf = (t) => TIME_KIND[t] || 'none';
 
-const NEED_ASK = { liuyao: true, meihua: true, daliuren: true, tarot: true };
-const needAsk = (t) => !!NEED_ASK[t];
+const Core = window.__MPCore || {};
+const needAsk = Core.needAsk || ((t) => false);
 
 function App() {
   const [tab, setTab] = useState('ziwei');
@@ -7354,6 +8378,7 @@ function App() {
   const [pGender, setPGender] = useState('female');
   const [pAddress, setPAddress] = useState('');
   const [hpChart, setHpChart] = useState('bazi');
+  const [qimenRule, setQimenRule] = useState('chaibu');
   const [trueSolar, setTrueSolar] = useState(true);
   const [onlineGeo, setOnlineGeo] = useState(false);
   const [lines, setLines] = useState('');
@@ -7388,7 +8413,7 @@ function App() {
       const datetime = `${dt.date}T${dt.time}`;
       const args = { system: k };
       if (k !== 'tarot') args.datetime = datetime;
-      if (k === 'bazi' || k === 'ziwei') {
+      if (k === 'bazi' || k === 'ziwei' || k === 'hepan') {
         args.gender = gender;
         args.trueSolar = trueSolar;
         if (address.trim()) {
@@ -7402,16 +8427,11 @@ function App() {
         }
       }
       if (k === 'liuyao') {
-        const parsed = lines.split(/[^0-9]+/).filter(Boolean).map(Number);
-        const bad = parsed.filter((n) => ![6, 7, 8, 9].includes(n));
-        if (parsed.length === 6 && bad.length === 0) {
-          args.lines = parsed;
-        } else if (lines.trim()) {
-          setNotice(parsed.length !== 6
-            ? `爻值需要正好 6 个数字（当前 ${parsed.length} 个），本次按随机摇卦。`
-            : `爻值只能是 6/7/8/9（收到 ${bad.join('/')}），本次按随机摇卦。`);
-        }
+        const parsed = Core.parseLines(lines);
+        if (parsed.lines) args.lines = parsed.lines;
+        else if (parsed.warning) setNotice(parsed.warning);
       }
+      if (k === 'qimen') args.juMethod = qimenRule;
       if (k === 'tarot') args.count = Number(count);
       if (k === 'hepan') {
         args.chart = hpChart;
@@ -7451,9 +8471,10 @@ function App() {
         }
       }
       const r = Engine.compute(args);
-      const it = Engine.interpret
-        ? Engine.interpret(r, needAsk(k) ? { question: question.trim(), direction } : undefined)
-        : null;
+      const ask = (needAsk(k) || k === 'qimen')
+        ? { question: needAsk(k) ? question.trim() : '', direction }
+        : undefined;
+      const it = Engine.interpret ? Engine.interpret(r, ask) : null;
       const timed = kindOf(k) === 'cast' && (k !== 'meihua' || mh === 'time');
       setResult({ kind: k, r, it, at: dt, timed });
       setError('');      setCopied('');
@@ -7540,8 +8561,11 @@ function App() {
   };
 
   const refreshInterpret = (dir, q) => {
-    if (!result || !needAsk(tab)) return;
-    const ask = { question: (q === undefined ? question : q).trim(), direction: dir === undefined ? direction : dir };
+    if (!result || !(needAsk(tab) || tab === 'qimen')) return;
+    const ask = {
+      question: needAsk(tab) ? (q === undefined ? question : q).trim() : '',
+      direction: dir === undefined ? direction : dir,
+    };
     const it = Engine.interpret ? Engine.interpret(result.r, ask) : null;
     setResult(Object.assign({}, result, { it }));
   };
@@ -7627,7 +8651,22 @@ function App() {
           className: 'mp-input', placeholder: '如 四川成都', value: pAddress,
           onChange: (e) => setPAddress(e.target.value),
         })) : null,
-        needAsk(tab) ? field('询问方向', h('select', {
+        tab === 'qimen' ? h('fieldset', { key: 'qmr', className: 'mp-qmrule' },
+          h('legend', { className: 'mp-lbl' }, '换局规则'),
+          h('div', { className: 'mp-qmopts', role: 'radiogroup', 'aria-label': '奇门换局规则' },
+            [['chaibu', '拆补'], ['chaoshen', '超神接气'], ['zhirun', '置闰']].map(([value, label]) => h('label', {
+              key: value, className: 'mp-qmopt',
+            },
+            h('input', {
+              type: 'radio', name: 'qimen_rule', value,
+              checked: qimenRule === value,
+              onChange: () => setQimenRule(value),
+            }),
+            h('span', null, label)))),
+          h('details', { className: 'mp-qmhelp' },
+            h('summary', null, '三种规则有什么区别？'),
+            h('p', null, '决定符头与节气如何对齐、是否插入闰局；同一个时刻在不同规则下可能得到不同局数。默认「拆补」与工具层一致。'))) : null,
+        needAsk(tab) || tab === 'qimen' ? field(tab === 'qimen' ? '询问方向（定用神）' : '询问方向', h('select', {
           className: 'mp-input', value: direction,
           onChange: (e) => { setDirection(e.target.value); refreshInterpret(e.target.value); },
         }, (Engine.DIRECTIONS || []).map((d) => h('option', { key: d.key, value: d.key }, d.label)))) : null,
@@ -7713,6 +8752,7 @@ function App() {
             : result.kind === 'bazi' ? PP.baziHTML(result.r)
               : result.kind === 'meihua' ? PP.meihuaHTML(result.r)
                 : result.kind === 'daliuren' ? PP.daliurenHTML(result.r)
+                  : result.kind === 'qimen' ? (PP.qimenHTML(result.r) + PP.qimenFactsHTML(result.r))
                   : result.kind === 'hepan' ? (result.r.chart === 'ziwei' ? PP.ziweiHepanHTML(result.r) : PP.hepanHTML(result.r))
                   : result.kind === 'tarot' ? PP.tarotHTML(result.r)
                     : PP.liuyaoHTML(result.r),