dsh-metaphysics 0.14.3 → 0.16.0

package/engine/index.js

@@ -1,513 +1,566 @@
-// 统一入口：解析参数、分派到各体系、生成可读摘要
-import { buildBazi } from './bazi.js';
-import { buildLiuyao, tossLines } from './liuyao.js';
-import { buildZiwei, BRIGHTNESS, flowOf, asOfParts } from './ziwei.js';
-import { drawTarot } from './tarot.js';
-import { buildMeihua } from './meihua.js';
-import { buildDaliuren } from './daliuren.js';
-import { buildHepan } from './hepan.js';
-import { buildZiweiHepan } from './ziwei-hepan.js';
-import { buildQimen } from './qimen.js';
-import { geocodeAddress, resolveAddress } from './geo.js';
-import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
-import { randomOf, isSeed } from './random.js';
-import { interpret, DIRECTIONS, DIRECTION_DEFAULT } from './interpret.js';
-
-export { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf };
-
-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) {
-  if (month === 2) {
-    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
-    return leap ? 29 : 28;
-  }
-  return [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
-}
-
-/**
- * 性别是必填项：它决定大运/大限的顺逆，缺省按某一方排等于给出一张错盘。
- * 之前用 `=== 'female' ? 'female' : 'male'` 兜底，静默把未填性别的人按男命排。
- */
-function requireGender(value, who = '') {
-  if (GENDERS.includes(value)) return value;
-  const got = value === undefined || value === null || value === '' ? '（未提供）' : `「${value}」`;
-  throw fail('E_INPUT', `${who ? who + '的' : ''}gender 必须是 male 或 female${got}；性别决定大运/大限顺逆，不能靠默认值`);
-}
-
-/** 解析 'YYYY-MM-DDTHH:mm' / 'YYYY-MM-DD HH:mm' / 'YYYY-MM-DD' */
-export function parseDateTime(text) {
-  if (typeof text !== 'string' || !text.trim()) {
-    throw fail('E_INPUT', '缺少 datetime（公历日期时间），例如 1990-05-12T14:30');
-  }
-  const m = text.trim().match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T\s](\d{1,2}):(\d{1,2})(?::(\d{1,2}))?)?$/);
-  if (!m) throw fail('E_INPUT', `无法解析 datetime：「${text}」，请用 1990-05-12T14:30 这种格式`);
-  const out = {
-    year: Number(m[1]), month: Number(m[2]), day: Number(m[3]),
-    hour: Number(m[4] ?? 0), minute: Number(m[5] ?? 0),
-  };
-  if (out.month < 1 || out.month > 12) throw fail('E_INPUT', `月份超出范围：${out.month}`);
-  // 只校验 1..31 会让 1990-02-30、2026-04-31 这类日期静默滚到下个月，整盘错位且无人察觉
-  const maxDay = daysInMonth(out.year, out.month);
-  if (out.day < 1 || out.day > maxDay) {
-    throw fail('E_INPUT', `日期不存在：${out.year}-${out.month}-${out.day}（${out.year} 年 ${out.month} 月只有 ${maxDay} 天）`);
-  }
-  if (out.hour > 23 || out.minute > 59) throw fail('E_INPUT', `时间超出范围：${out.hour}:${out.minute}`);
-  // ΔT（地球自转改正）表只覆盖 1900–2100，超出后按端点值外推，精度不可保证
-  if (out.year < 1600 || out.year > 2400) {
-    throw fail('E_RANGE', `年份 ${out.year} 超出可计算范围（1600–2400）`);
-  }
-  if (out.year < 1900 || out.year > 2100) {
-    out.precision = {
-      level: 'approx',
-      note: `ΔT 模型仅覆盖 1900–2100，${out.year} 年按端点值外推，节气与朔望时刻可能有分钟级偏差，月柱在交节前后需复核`,
-    };
-  }
-  return out;
-}
-
-function baziText(r) {
-  const P = r.pillars;
-  const line = (label, p) =>
-    `${label}：${p.ganzhi}　${p.stemTenGod ? `十神 ${p.stemTenGod}　` : ''}藏干 ${p.hidden.map((h) => `${h.stem}(${h.tenGod})`).join(' ')}　纳音 ${p.nayin}`
-    + `　地势 ${p.dishi}　自坐 ${p.zizuo}　空亡 ${p.kongwang.join('')}`
-    + (p.shensha && p.shensha.length ? `　神煞 ${p.shensha.join('、')}` : '');
-  const wuxing = Object.entries(r.wuxing).map(([k, v]) => `${k}${v}`).join(' ');
-  const palaces = r.palaces
-    ? `【胎元】${r.palaces.taiyuan.ganzhi}　命宫 ${r.palaces.minggong.ganzhi}　身宫 ${r.palaces.shengong.ganzhi}`
-    : '';
-  const dayun = r.dayun.list.slice(0, 8)
-    .map((d) => `${d.startAge}岁 ${d.ganzhi}(${d.stemTenGod})${d.luck ? `·${d.luck.tier}` : ''}${d.relations && d.relations.length ? `[${d.relations.join('')}]` : ''}`).join('　');
-  // 阈值 20 分钟：与 NAOJ 历要项对拍实测，本引擎节气最多偏早 13.5 分钟（Meeus 低精度上限约 14 分钟）
-  const near = r.jieqi.nearBoundaryMinutes < 20
-    ? `\n⚠ 出生时刻距「节」仅 ${r.jieqi.nearBoundaryMinutes} 分钟，而节气时刻本身有最多约 14 分钟的偏差，月柱与年柱建议人工复核。`
-    : '';
-  const SHORT = { year: '年', month: '月', day: '日', hour: '时' };
-  const shenshaLine = r.shensha && r.shensha.groups && r.shensha.groups.length
-    ? `神煞（${r.shensha.count} 见）：` + r.shensha.groups.map((g) =>
-      `${g.cat}｜` + g.items.map((i) => `${i.name}(${i.pillars.map((k) => SHORT[k]).join('')})`).join('、')).join('；')
-    : '神煞：—';
-  const gejuLine = r.frame ? [
-    `格局：${r.frame.primary ? `${r.frame.primary.name}（${r.frame.primary.evidence}）` : '—'}`,
-    `　　　${r.frame.geju.map((g) => `${g.name}[${g.kind}]`).join('　')}`,
-    `用神：喜${r.frame.yongshen.favor.join('')}（${r.frame.yongshen.favorTenGods.join('、')}）　忌${r.frame.yongshen.avoid.join('')}（${r.frame.yongshen.avoidTenGods.join('、')}）　${r.frame.yongshen.method}`,
-    `　　　${r.frame.yongshen.detail}`,
-    `十神权重：${Object.entries(r.frame.godStats.groups).map(([k, v]) => `${k}${v}`).join(' ')}`,
-  ] : [];
-  return [
-    `【四柱】${P.year.ganzhi} ${P.month.ganzhi} ${P.day.ganzhi} ${P.hour.ganzhi}`,
-    `日主：${r.dayMaster.stem}${r.dayMaster.element}（${r.dayMaster.yinYang}）　空亡：${r.kongwang.join('')}`,
-    line('年柱', P.year), line('月柱', P.month), line('日柱', P.day), line('时柱', P.hour),
-    `五行：${wuxing}`,
-    ...(palaces ? [palaces] : []),
-    `日主强弱：${r.strength.level}（${r.strength.score}）　${r.strength.detail}`,
-    ...gejuLine,
-    `天干关系：${(r.relations && r.relations.stems.length) ? r.relations.stems.join('　') : '—'}`,
-    `地支关系：${(r.relations && r.relations.branches.length) ? r.relations.branches.join('　') : '—'}`,
-    shenshaLine,
-    `真太阳时：${r.solarTime.trueSolarText}（${r.input.geo ? r.input.geo.note + '；' : ''}${r.solarTime.note}）　晚子时：${r.input.lateZi ? '23:00 后算次日' : '23:00 后仍算当日'}`,
-    `节气：上一节 ${r.jieqi.previous.name} ${r.jieqi.previous.time}　下一节 ${r.jieqi.next.name} ${r.jieqi.next.time}`,
-    `大运：${r.dayun.rule}（${r.dayun.direction}），${r.dayun.startAge.years}岁${r.dayun.startAge.months}个月起运`,
-    `　${dayun}`,
-    `流年：${r.liunian.slice(0, 10).map((l) => `${l.year}${l.ganzhi}(${l.stemTenGod})${l.luck ? `·${l.luck.tier}` : ''}`).join('　')}`,
-    '（格局、用神、行运吉凶为扶抑＋简化调候的量化提示，非断语。）',
-  ].join('\n') + near;
-}
-
-function ziweiText(r) {
-  const lunarText = `${r.lunar.year}年${r.lunar.isLeap ? '闰' : ''}${r.lunar.month}月${r.lunar.day}日`;
-  const starText = (stars) => (stars.length
-    ? stars.map((s) => `${s.name}${s.mutagen ? `化${s.mutagen}` : ''}`).join(' ')
-    : '—');
-  const shenshaText = (s) =>
-    `神煞：长生(${s.changsheng}) 博士(${s.boshi}) 将前(${s.jiangqian}) 岁前(${s.suiqi})`;
-  const rows = [];
-  for (const p of r.palaces) {
-    const mark = p.isSoul ? '【命】' : p.isBody ? '【身】' : '　　';
-    rows.push(`  ${p.palace} ${p.branch} ${p.ganzhi} ${mark} 大限${String(p.daxian.start).padStart(2)}-${p.daxian.end} 小限${String(p.xiaoxian.age).padStart(2)}  ${starText(p.stars)}`);
-    rows.push(`     ${shenshaText(p.shensha)}`);
-  }
-  const liunian = (r.liunian ?? []).slice(0, 6).map((l) =>
-    `  ${l.year} ${l.ganzhi} ${String(l.age).padStart(2)}岁 命宫${l.lifePalace.branch}(${l.lifePalace.palace}) 流禄${l.liulu} 流羊${l.liuyang} 流陀${l.liutuo} ｜ ${l.mutagen.map((m) => m.replace('化', '')).join(' ')}`
-    + (l.mutagenHits ? `　四化落宫 ${l.mutagenHits.map((m) => `${m.star}${m.type}→${m.palace || '未上盘'}`).join('、')}` : '')
-    + (l.sanfangMainStars ? `　三方主星 ${l.sanfangMainStars.join('')}` : ''));
-  const patterns = (r.patterns ?? []).length
-    ? r.patterns.map((p) => `${p.name}（${p.tone === 'good' ? '吉格' : p.tone === 'bad' ? '忌格' : '中'}：${p.evidence}）`).join('；')
-    : '无明显格局（按内置规则）';
-  const daxian = (r.daxianList ?? []).slice(0, 8).map((d) =>
-    `  ${d.branch}宫（${d.palace}）${d.ages[0]}-${d.ages[1]}岁 ${d.ganzhi} 会${d.mainStars.join('') || '—'} 化 ${d.mutagenHits.map((m) => `${m.star}${m.type}→${m.palace || '未上盘'}`).join('、')}`);
-  return [
-    `【农历】${lunarText}（月首 ${r.lunar.monthStart}）　时支：${r.hourBranch}　年干支：${r.yearGanzhi}`,
-    `【时刻】${r.solarTime ? `${r.solarTime.civilText} → 真太阳时 ${r.solarTime.trueSolarText}${r.input.geo ? '（' + r.input.geo.note + '）' : ''}` : ''}`,
-    `【命宫】${r.soul.branch}（${r.soul.ganzhi}·${r.soul.nayin}）　【身宫】${r.body.branch}（落${r.body.lands}）　【五行局】${r.bureau.name}`,
-    `【紫微】${r.ziwei}　【天府】${r.tianfu}　【命主】${r.lifeMaster}　【身主】${r.bodyMaster}`,
-    `【大限】${r.daxian.rule}，${r.daxian.startAge}岁起　【小限】${r.xiaoxianRule.direction}`,
-    `【昌曲】文昌${r.changqu.wenchang.branch}（${r.changqu.wenchang.palace}${r.changqu.wenchang.mutagen ? '·化' + r.changqu.wenchang.mutagen : ''}）　文曲${r.changqu.wenqu.branch}（${r.changqu.wenqu.palace}${r.changqu.wenqu.mutagen ? '·化' + r.changqu.wenqu.mutagen : ''}）`,
-    `　　　${r.changqu.relation}　入命三方：${r.changqu.inSoulSanfang ? '是' : '否'}　吸收面：${r.changqu.absorb.label}（${r.changqu.absorb.reason}）`,
-    '十二宫：',
-    ...rows,
-    '大限（按起运年龄排序，前 8 限，宫干四化落宫）：',
-    ...daxian,
-    '流年（前 6 年，完整 12 年在结构化数据里）：',
-    ...liunian,
-    `【格局】${patterns}`,
-    r.patternSummary ? `【结构统计】吉格 ${r.patternSummary.good.length}、忌格 ${r.patternSummary.bad.length}；${r.patternSummary.note}` : '',
-    r.lunar.note ? `注：${r.lunar.note}` : '',
-  ].filter(Boolean).join('\n');
-}
-
-function qimenText(r) {
-  const P = r.palaces;
-  const cell = (x) => `${x.palace}宫 ${x.star || '—'}／${x.gate || '—'}／${x.god || '—'}${x.kong ? ' 空' : ''}${x.ma ? ' 马' : ''}`;
-  return [
-    `【四柱】${r.siZhu.year} ${r.siZhu.month} ${r.siZhu.day} ${r.siZhu.time}`,
-    `【局数】${r.ju}　节气 ${r.jieqi}（${r.jieqiTime}）`,
-    `【值符】${r.zhiFu.star}（${r.zhiFu.gong}宫）　【值使】${r.zhiShi.gate}（${r.zhiShi.gong}宫）　旬首 ${r.xunshou}`,
-    `【空亡】${r.kongWang.join('') || '—'}　驿马 ${r.ma.zhi || '—'}（${r.ma.gong || '—'}宫）`,
-    `【九宫】${P.map(cell).join('　')}`,
-    `※ 晚子时：${r.lateZiHourMode === 'next-day' ? '23:00 后归次日' : '23:00 后仍归当日'}（可用 lateZiHourMode / lateZi 指定）`,
-    `※ ${r.rules[r.rules.length - 1]}`,
-  ].join('\n');
-}
-
-function hepanText(r) {
-  if (r.chart === 'ziwei') {
-    const d = (x) => `${x.label}：${x.score >= 0 ? '+' : ''}${x.score}　${x.text}`;
-    return [
-      `【紫微合盘】${r.score.level}（${r.score.total}/100）`,
-      `你　命宫 ${r.a.soul.branch}（${r.a.soulStars.join('、') || '无主星'}）　夫妻 ${r.a.spouseStars.join('、') || '无主星'}　${r.a.bureau}`,
-      `对方 命宫 ${r.b.soul.branch}（${r.b.soulStars.join('、') || '无主星'}）　夫妻 ${r.b.spouseStars.join('、') || '无主星'}　${r.b.bureau}`,
-      ...r.dimensions.map(d),
-      ...r.interactions.map((h) => `　· ${h.text}`),
-      ...r.notes.map((n) => `※ ${n}`),
-    ].join('\n');
-  }
-  const d = (x) => `${x.label}：${x.score >= 0 ? '+' : ''}${x.score}　${x.text}`;
-  const solarLine = (side) => {
-    if (!side || !side.solarNote) return '—';
-    return `${side.longitude == null ? '未含经度修正' : `${side.longitude}°E`}（${side.solarNote}）`;
-  };
-  return [
-    `【合盘】${r.score.level}（${r.score.total}/100）`,
-    `你　${r.a.pillars.join(' ')}　日主 ${r.a.dayMaster}　日支 ${r.a.dayBranch}　${r.a.strength || ''}`,
-    `对方 ${r.b.pillars.join(' ')}　日主 ${r.b.dayMaster}　日支 ${r.b.dayBranch}　${r.b.strength || ''}`,
-    `真太阳时：你 ${solarLine(r.a)}；对方 ${solarLine(r.b)}`,
-    ...r.dimensions.map(d),
-    ...r.notes.map((n) => `※ ${n}`),
-  ].join('\n');
-}
-
-function daliurenText(r) {
-  const sc = r.sanChuan;
-  const one = (c) => `${c.zhi}(${c.jiang}${c.liuQin}${c.xunKong ? '空' : ''})`;
-  return [
-    `【日时】${r.dayGanZhi}日　${r.hourZhi}时（${r.dayNight}贵）　月将 ${r.yueJiang.name}${r.yueJiang.zhi}　节气 ${r.jieqi.name}　${r.lateZi === false ? '晚子时不换日' : '晚子时换日'}`,
-    `【三传】初 ${one(sc.chu)} → 中 ${one(sc.zhong)} → 末 ${one(sc.mo)}`,
-    `【四课】${r.siKe.map((k) => `${k.position}课 ${k.shang}上${k.xia}下(${k.relation}·${k.jiang})`).join('　')}`,
-    `【天地盘】${r.pan.map((p) => `${p.di}:${p.tian}(${p.jiang})`).join(' ')}`,
-    `【格局】${r.geJu.name}·${r.geJu.detail}`,
-    ...((r.shensha && r.shensha.length) ? [`【神煞】${r.shensha.map((x) => `${x.name}${x.branch}`).join('　')}`] : []),
-  ].join('\n');
-}
-
-function meihuaText(r) {
-  const lines = [
-    `【起卦】${r.source}`,
-    `【本卦】${r.ben.name}（上${r.ben.upper} 下${r.ben.lower}）　动爻：${r.movingName}`,
-    `【互卦】${r.hu.name}　【变卦】${r.bian.name}　【错卦】${r.cuo.name}　【综卦】${r.zong.name}`,
-    `【体用】体 ${r.bodyUse.body.trigram}${r.bodyUse.body.element}　用 ${r.bodyUse.use.trigram}${r.bodyUse.use.element}　${r.bodyUse.level}`,
-    `　　　　${r.bodyUse.relation}`,
-  ];
-  const bars = r.lines.slice().reverse().map((l) =>
-    `  ${l.name} ${l.yinYang === '阳' ? '━━━━━' : '━━  ━━'}${l.moving ? ' ←动' : ''}`);
-  return [...lines, '【爻】', ...bars].join('\n');
-}
-
-function tarotText(r) {
-  const lines = [
-    r.question ? `【所问】${r.question}` : '（未填写提问）',
-    `【牌阵】${r.spread}${r.castAt ? `　抽牌于 ${r.castAt}` : ''}`,
-  ];
-  for (const c of r.cards) {
-    lines.push(`  ${c.position}：${c.name}（${c.orientation}）　${c.keywords.join('、')}`);
-  }
-  if (r.reading && r.reading.length) {
-    lines.push('【解读】');
-    for (const p of r.reading) lines.push(`  ${p}`);
-  }
-  return lines.join('\n');
-}
-
-function liuyaoText(r) {
-  const fmt = (hex) => {
-    const rows = hex.lines.slice().reverse().map((l) => {
-      const mark = l.position === hex.shi ? '世' : l.position === hex.ying ? '应' : '　';
-      return `  ${l.name} ${mark} ${l.symbol} ${l.ganzhi}${l.element} ${l.liuqin}/${l.liushen}`;
-    });
-    return [`${hex.name}（${hex.palace}·${hex.palaceElement}）`, ...rows].join('\n');
-  };
-  const out = [
-    `起卦：${r.cast.notation.join('、')}（自下而上）`,
-    `日辰：${r.dayGanZhi.name}`,
-    r.xunShou ? `旬首：${r.xunShou}　旬空：${(r.xunKong || []).join('') || '—'}` : '',
-    r.question ? `所问：${r.question}` : '',
-    '本卦：',
-    fmt(r.ben),
-  ];
-  if (r.bian) out.push(`动爻：第 ${r.cast.movingPositions.join('、')} 爻`, '变卦（六亲以变卦自身宫论）：', fmt(r.bian));
-  else out.push('六爻安静，无变卦。');
-  return out.filter(Boolean).join('\n');
-}
-
-/** 工具输出必须是无损 JSON：去掉 undefined / 函数等不可序列化的值 */
-function jsonSafe(value) {
-  return JSON.parse(JSON.stringify(value));
-}
-
-/**
- * 统一排盘入口
- * @param {object} args
- * @param {'bazi'|'ziwei'|'liuyao'} args.system
- * @param {string} [args.datetime]
- */
-export function compute(args = {}) {
-  const r = jsonSafe(computeRaw(args));
-  // 超出 ΔT 覆盖范围时把精度提示顶到摘要最前，别让远期盘悄悄出错
-  if (r && r.precision && r.precision.level === 'approx' && r.summary) {
-    r.summary = `⚠ ${r.precision.note}\n${r.summary}`;
-  }
-  // 没有经度就没有真太阳时：时柱可能整柱偏（海外出生尤其常见），必须显式告警而不是藏在括号里
-  if (r && (r.system === 'bazi' || r.system === 'ziwei') && r.input && r.input.longitude == null && r.summary) {
-    r.summary = `⚠ 未提供出生地或经度：按东八区平太阳时排盘，时柱可能与本命盘相差一个时辰；海外出生请先把当地时间换算成东八区标准时。\n${r.summary}`;
-  }
-  // 显式要求时才附加解析模块，避免默认输出过长；「所问之事」与「询问方向」一并传进去
-  if (args.withInterpret) {
-    r.interpret = interpret(r, {
-      question: typeof args.question === 'string' ? args.question : '',
-      direction: typeof args.direction === 'string' ? args.direction : 'general',
-    });
-  }
-  return r;
-}
-
-/** 解析与详解的紧凑文本（给模型看，不塞整块 JSON） */
-export function interpretText(i) {
-  if (!i) return '';
-  const out = [`【${i.title || '解析与详解'}】${i.ask && i.ask.echo ? i.ask.echo : ''}`];
-  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}`);
-  }
-  for (const s of i.sections || []) out.push(`${s.label}：${s.text}`);
-  if (i.disclaimer) out.push(i.disclaimer);
-  return out.join('\n');
-}
-
-const JU_METHODS = ['chaibu', 'chaoshen', 'zhirun'];
-const TAROT_COUNTS = [1, 3, 5];
-const LATE_ZI_MODES = ['same-day', 'next-day'];
-
-/** asOf 只接受能解析成真实日期的字符串；非法值以前会静默回退到「此刻」 */
-function checkAsOf(asOf) {
-  if (asOf === undefined || asOf === null || asOf === '') return undefined;
-  const parts = asOfParts(asOf);
-  if (!parts) throw fail('E_ASOF', `无法解析 asOf：「${asOf}」，请用 2026-10-22T16:00 这种格式`);
-  const { year, month, day } = parts;
-  if (!(month >= 1 && month <= 12) || !(day >= 1 && day <= daysInMonth(year, month))) {
-    throw fail('E_ASOF', `asOf 指向的日期不存在：${asOf}`);
-  }
-  return parts;
-}
-
-function computeRaw(args = {}) {
-  const system = args.system;
-  if (system === 'bazi') {
-    const dt = parseDateTime(args.datetime);
-    const asOf = checkAsOf(args.asOf);
-    const result = buildBazi({
-      ...dt,
-      gender: requireGender(args.gender),
-      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
-      address: typeof args.address === 'string' ? args.address : undefined,
-      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
-      lateZi: args.lateZi !== false,
-      trueSolar: args.trueSolar !== false,
-      // 流年表默认从「今年」起排；要复现历史结论就把基准年钉死
-      nowYear: asOf ? asOf.year : undefined,
-    });
-    return { ...result, ...(asOf ? { asOf } : {}), precision: dt.precision, summary: baziText(result) };
-  }
-  if (system === 'ziwei') {
-    const dt = parseDateTime(args.datetime);
-    const asOf = checkAsOf(args.asOf);
-    const result = buildZiwei({
-      ...dt,
-      gender: requireGender(args.gender),
-      leapAsNext: args.leapAsNext === true,
-      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
-      address: typeof args.address === 'string' ? args.address : undefined,
-      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
-      trueSolar: args.trueSolar,
-      // 流月/流日/流时的基准时刻：默认本机此刻，可用 asOf 指定以便复现
-      asOf,
-    });
-    return { ...result, precision: dt.precision, summary: ziweiText(result) };
-  }
-  if (system === 'tarot') {
-    const count = args.count === undefined || args.count === null || args.count === '' ? 3 : Number(args.count);
-    if (!TAROT_COUNTS.includes(count)) {
-      throw fail('E_COUNT', `塔罗张数只能是 1 / 3 / 5，收到「${args.count}」`);
-    }
-    if (!isSeed(args.seed)) throw fail('E_INPUT', `seed 必须是数字，收到「${args.seed}」`);
-    const asOf = checkAsOf(args.asOf);
-    // 抽牌不看时间：castAt 只记录此刻（或 asOf），避免误用出生时间；给了 seed 就能复现同一次抽牌
-    const result = drawTarot({ count, question: args.question, at: args.asOf, random: randomOf(args.seed) });
-    if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
-    return { ...result, ...(asOf ? { asOf } : {}), summary: tarotText(result) };
-  }
-  if (system === 'daliuren') {
-    const dt = parseDateTime(args.datetime);
-    const lateZi = args.lateZi !== false;
-    const result = buildDaliuren({ ...dt, lateZi });
-    result.lateZi = lateZi;
-    return { ...result, precision: dt.precision, summary: daliurenText(result) };
-  }
-  if (system === 'qimen') {
-    const dt = parseDateTime(args.datetime);
-    if (args.juMethod !== undefined && !JU_METHODS.includes(args.juMethod)) {
-      throw fail('E_INPUT', `juMethod 只能是 chaibu / chaoshen / zhirun，收到「${args.juMethod}」`);
-    }
-    // 全插件只有"晚子时"这一件事，参数名不该按体系分裂：
-    // lateZiHourMode 是奇门的历史参数名，lateZi 是八字/六壬的；两者互为别名。
-    const mode = args.lateZiHourMode !== undefined
-      ? args.lateZiHourMode
-      : args.lateZi === true ? 'next-day' : args.lateZi === false ? 'same-day' : undefined;
-    if (mode !== undefined && !LATE_ZI_MODES.includes(mode)) {
-      throw fail('E_INPUT', `lateZiHourMode 只能是 same-day / next-day，收到「${mode}」`);
-    }
-    const lateZiHourMode = mode === 'next-day' ? 'next-day' : 'same-day';
-    const result = buildQimen({ ...dt, lateZiHourMode, juMethod: args.juMethod });
-    result.lateZiHourMode = lateZiHourMode;
-    return { ...result, summary: qimenText(result) };
-  }
-  if (system === 'hepan') {
-    const partner = args.partner;
-    if (!partner || typeof partner !== 'object') {
-      throw fail('E_PARTNER', '合盘需要 partner：{ datetime, gender, address? }，其中 partner.datetime 是对方的公历出生时间');
-    }
-    if (!partner.datetime) {
-      throw fail('E_PARTNER', '缺少 partner.datetime（对方的公历出生时间），例如 partner: {"datetime":"1992-03-03T10:00","gender":"female"}');
-    }
-    const pa = parseDateTime(args.datetime);
-    const pb = parseDateTime(partner.datetime);
-    const chart = args.chart === 'ziwei' ? 'ziwei' : 'bazi';
-    // 性别决定双方大运/大限顺逆，两边都不能用默认值
-    const sideA = {
-      ...pa,
-      gender: requireGender(args.gender, '你（主方）'),
-      trueSolar: args.trueSolar,
-      lateZi: args.lateZi,
-      address: typeof args.address === 'string' ? args.address : undefined,
-      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
-      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
-    };
-    const sideB = {
-      ...pb,
-      gender: requireGender(partner.gender, '对方'),
-      trueSolar: partner.trueSolar,
-      lateZi: partner.lateZi,
-      address: typeof partner.address === 'string' ? partner.address : undefined,
-      longitude: typeof partner.longitude === 'number' ? partner.longitude : undefined,
-      geo: partner.geo && typeof partner.geo === 'object' ? partner.geo : undefined,
-    };
-    const result = chart === 'ziwei' ? buildZiweiHepan({ a: sideA, b: sideB }) : buildHepan({ a: sideA, b: sideB });
-    return { ...result, summary: hepanText(result) };
-  }
-  if (system === 'meihua') {
-    let result;
-    try {
-      result = buildMeihua({
-        mode: args.mode === 'number' ? 'number' : 'time',
-        datetime: args.datetime,
-        upper: args.upper,
-        lower: args.lower,
-        changing: args.changing,
-      });
-    } catch (e) {
-      throw fail('E_INPUT', `梅花起卦参数不完整：${e && e.message ? e.message : e}`);
-    }
-    return { ...result, summary: meihuaText(result) };
-  }
-  if (system === 'liuyao') {
-    if (!isSeed(args.seed)) throw fail('E_INPUT', `seed 必须是数字，收到「${args.seed}」`);
-    let lines;
-    if (args.lines === undefined || args.lines === null) {
-      // 没给爻值 = 随机摇卦；给了 seed 则同一次摇卦可复现
-      lines = tossLines(randomOf(args.seed));
-    } else {
-      if (!Array.isArray(args.lines)) {
-        throw fail('E_LINES', 'lines 必须是数组：自下而上 6 个爻值（6 老阴 / 7 少阳 / 8 少阴 / 9 老阳）');
-      }
-      if (args.lines.length !== 6) {
-        // 以前这里会静默改随机摇卦：用户手抖少填一个，拿到的却是一张"看起来正常"的随机盘
-        throw fail('E_LINES', `六爻需要正好 6 个爻值（自下而上），收到 ${args.lines.length} 个；留空则由引擎随机摇卦`);
-      }
-      lines = args.lines.map(Number);
-    }
-    let dayGanZhi;
-    let asOf = null;
-    // 六神按「起卦日」的日干起：给了 datetime 用它，给了 asOf 用 asOf，都没有才回落到本机当天
-    const stamp = args.datetime ? parseDateTime(args.datetime) : checkAsOf(args.asOf);
-    if (stamp) {
-      if (!args.datetime) asOf = stamp;
-      const g = ganzhiName(dayGanzhiIndex(toJDN(stamp.year, stamp.month, stamp.day)));
-      dayGanZhi = { stem: g.stem, branch: g.branch, name: g.name };
-    }
-    let result;
-    try {
-      result = buildLiuyao({ lines, question: args.question, dayGanZhi });
-    } catch (e) {
-      throw fail('E_LINES', e && e.message ? e.message : e);
-    }
-    if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
-    return { ...result, ...(asOf ? { asOf } : {}), summary: liuyaoText(result) };
-  }
-  if (!system) {
-    throw fail('E_INPUT', '缺少 system，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）。');
-  }
-  throw fail('E_SYSTEM', `未知体系「${system}」，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）。`);
-}
-
-/** 给模型的紧凑文本（去掉大字段，保留摘要；带解析时附上解析） */
-export function renderText(result) {
-  const base = result.summary ?? JSON.stringify(result, null, 2);
-  if (!result.interpret) return base;
-  const extra = interpretText(result.interpret);
-  return extra ? `${base}\n\n${extra}` : base;
-}
-
-/** 对外暴露：地址解析（异步，含联网） */
-export { geocodeAddress, resolveAddress };
-
-export { buildBazi, buildLiuyao, tossLines };
-
-
-
-
-
-
-
-
-
+// 统一入口：解析参数、分派到各体系、生成可读摘要
+import { buildBazi } from './bazi.js';
+import { buildLiuyao, tossLines } from './liuyao.js';
+import { buildZiwei, BRIGHTNESS, flowOf, asOfParts } from './ziwei.js';
+import { drawTarot } from './tarot.js';
+import { buildMeihua } from './meihua.js';
+import { buildDaliuren } from './daliuren.js';
+import { buildHepan } from './hepan.js';
+import { buildZiweiHepan } from './ziwei-hepan.js';
+import { buildQimen } from './qimen.js';
+import { geocodeAddress, resolveAddress } from './geo.js';
+import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
+import { randomOf, isSeed } from './random.js';
+import { interpret, DIRECTIONS, DIRECTION_DEFAULT } from './interpret.js';
+import { followup } from './followup.js';
+import { crossCheck, crossText } from './crosscheck.js';
+import { fail } from './fail.js';
+import { assertCivil } from './validate.js';
+
+export { interpret, DIRECTIONS, DIRECTION_DEFAULT, BRIGHTNESS, flowOf };
+
+const pad = (n) => String(n).padStart(2, '0');
+
+const GENDERS = ['male', 'female'];
+
+function daysInMonth(year, month) {
+  if (month === 2) {
+    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    return leap ? 29 : 28;
+  }
+  return [31, 28, 31, 30, 31, 30, 31, 31, 30, 31, 30, 31][month - 1];
+}
+
+/**
+ * 性别是必填项：它决定大运/大限的顺逆，缺省按某一方排等于给出一张错盘。
+ * 之前用 `=== 'female' ? 'female' : 'male'` 兜底，静默把未填性别的人按男命排。
+ */
+function requireGender(value, who = '') {
+  if (GENDERS.includes(value)) return value;
+  const got = value === undefined || value === null || value === '' ? '（未提供）' : `「${value}」`;
+  throw fail('E_INPUT', `${who ? who + '的' : ''}gender 必须是 male 或 female${got}；性别决定大运/大限顺逆，不能靠默认值`);
+}
+
+/** 解析 'YYYY-MM-DDTHH:mm' / 'YYYY-MM-DD HH:mm' / 'YYYY-MM-DD' */
+export function parseDateTime(text) {
+  if (typeof text !== 'string' || !text.trim()) {
+    throw fail('E_INPUT', '缺少 datetime（公历日期时间），例如 1990-05-12T14:30');
+  }
+  const m = text.trim().match(/^(\d{4})-(\d{1,2})-(\d{1,2})(?:[T\s](\d{1,2}):(\d{1,2})(?::(\d{1,2}))?)?$/);
+  if (!m) throw fail('E_INPUT', `无法解析 datetime：「${text}」，请用 1990-05-12T14:30 这种格式`);
+  const out = {
+    year: Number(m[1]), month: Number(m[2]), day: Number(m[3]),
+    hour: Number(m[4] ?? 0), minute: Number(m[5] ?? 0),
+  };
+  if (out.month < 1 || out.month > 12) throw fail('E_INPUT', `月份超出范围：${out.month}`);
+  // 只校验 1..31 会让 1990-02-30、2026-04-31 这类日期静默滚到下个月，整盘错位且无人察觉
+  const maxDay = daysInMonth(out.year, out.month);
+  if (out.day < 1 || out.day > maxDay) {
+    throw fail('E_INPUT', `日期不存在：${out.year}-${out.month}-${out.day}（${out.year} 年 ${out.month} 月只有 ${maxDay} 天）`);
+  }
+  if (out.hour > 23 || out.minute > 59) throw fail('E_INPUT', `时间超出范围：${out.hour}:${out.minute}`);
+  // ΔT（地球自转改正）表只覆盖 1900–2100，超出后按端点值外推，精度不可保证
+  if (out.year < 1600 || out.year > 2400) {
+    throw fail('E_RANGE', `年份 ${out.year} 超出可计算范围（1600–2400）`);
+  }
+  if (out.year < 1900 || out.year > 2100) {
+    out.precision = {
+      level: 'approx',
+      note: `ΔT 模型仅覆盖 1900–2100，${out.year} 年按端点值外推，节气与朔望时刻可能有分钟级偏差，月柱在交节前后需复核`,
+    };
+  }
+  return out;
+}
+
+function baziText(r) {
+  const P = r.pillars;
+  const line = (label, p) =>
+    `${label}：${p.ganzhi}　${p.stemTenGod ? `十神 ${p.stemTenGod}　` : ''}藏干 ${p.hidden.map((h) => `${h.stem}(${h.tenGod})`).join(' ')}　纳音 ${p.nayin}`
+    + `　地势 ${p.dishi}　自坐 ${p.zizuo}　空亡 ${p.kongwang.join('')}`
+    + (p.shensha && p.shensha.length ? `　神煞 ${p.shensha.join('、')}` : '');
+  const wuxing = Object.entries(r.wuxing).map(([k, v]) => `${k}${v}`).join(' ');
+  const palaces = r.palaces
+    ? `【胎元】${r.palaces.taiyuan.ganzhi}　命宫 ${r.palaces.minggong.ganzhi}　身宫 ${r.palaces.shengong.ganzhi}`
+    : '';
+  const dayun = r.dayun.list.slice(0, 8)
+    .map((d) => `${d.startAge}岁 ${d.ganzhi}(${d.stemTenGod})${d.luck ? `·${d.luck.tier}` : ''}${d.relations && d.relations.length ? `[${d.relations.join('')}]` : ''}`).join('　');
+  // 阈值 20 分钟：与 NAOJ 历要项对拍实测，本引擎节气最多偏早 13.5 分钟（Meeus 低精度上限约 14 分钟）
+  const near = r.jieqi.nearBoundaryMinutes < 20
+    ? `\n⚠ 出生时刻距「节」仅 ${r.jieqi.nearBoundaryMinutes} 分钟，而节气时刻本身有最多约 14 分钟的偏差，月柱与年柱建议人工复核。`
+    : '';
+  const SHORT = { year: '年', month: '月', day: '日', hour: '时' };
+  const shenshaLine = r.shensha && r.shensha.groups && r.shensha.groups.length
+    ? `神煞（${r.shensha.count} 见）：` + r.shensha.groups.map((g) =>
+      `${g.cat}｜` + g.items.map((i) => `${i.name}(${i.pillars.map((k) => SHORT[k]).join('')})`).join('、')).join('；')
+    : '神煞：—';
+  const gejuLine = r.frame ? [
+    `格局：${r.frame.primary ? `${r.frame.primary.name}（${r.frame.primary.evidence}）` : '—'}`,
+    `　　　${r.frame.geju.map((g) => `${g.name}[${g.kind}]`).join('　')}`,
+    `用神：喜${r.frame.yongshen.favor.join('')}（${r.frame.yongshen.favorTenGods.join('、')}）　忌${r.frame.yongshen.avoid.join('')}（${r.frame.yongshen.avoidTenGods.join('、')}）　${r.frame.yongshen.method}`,
+    `　　　${r.frame.yongshen.detail}`,
+    `十神权重：${Object.entries(r.frame.godStats.groups).map(([k, v]) => `${k}${v}`).join(' ')}`,
+  ] : [];
+  return [
+    `【四柱】${P.year.ganzhi} ${P.month.ganzhi} ${P.day.ganzhi} ${P.hour.ganzhi}`,
+    `日主：${r.dayMaster.stem}${r.dayMaster.element}（${r.dayMaster.yinYang}）　空亡：${r.kongwang.join('')}`,
+    line('年柱', P.year), line('月柱', P.month), line('日柱', P.day), line('时柱', P.hour),
+    `五行：${wuxing}`,
+    ...(palaces ? [palaces] : []),
+    `日主强弱：${r.strength.level}（${r.strength.score}）　${r.strength.detail}`,
+    ...gejuLine,
+    `天干关系：${(r.relations && r.relations.stems.length) ? r.relations.stems.join('　') : '—'}`,
+    `地支关系：${(r.relations && r.relations.branches.length) ? r.relations.branches.join('　') : '—'}`,
+    shenshaLine,
+    `真太阳时：${r.solarTime.trueSolarText}（${r.input.geo ? r.input.geo.note + '；' : ''}${r.solarTime.note}）　晚子时：${r.input.lateZi ? '23:00 后算次日' : '23:00 后仍算当日'}`,
+    `节气：上一节 ${r.jieqi.previous.name} ${r.jieqi.previous.time}　下一节 ${r.jieqi.next.name} ${r.jieqi.next.time}`,
+    `大运：${r.dayun.rule}（${r.dayun.direction}），${r.dayun.startAge.years}岁${r.dayun.startAge.months}个月起运`,
+    `　${dayun}`,
+    `流年：${r.liunian.slice(0, 10).map((l) => `${l.year}${l.ganzhi}(${l.stemTenGod})${l.luck ? `·${l.luck.tier}` : ''}`).join('　')}`,
+    '（格局、用神、行运吉凶为扶抑＋简化调候的量化提示，非断语。）',
+  ].join('\n') + near;
+}
+
+function ziweiText(r) {
+  const lunarText = `${r.lunar.year}年${r.lunar.isLeap ? '闰' : ''}${r.lunar.month}月${r.lunar.day}日`;
+  const starText = (stars) => (stars.length
+    ? stars.map((s) => `${s.name}${s.mutagen ? `化${s.mutagen}` : ''}`).join(' ')
+    : '—');
+  const shenshaText = (s) =>
+    `神煞：长生(${s.changsheng}) 博士(${s.boshi}) 将前(${s.jiangqian}) 岁前(${s.suiqi})`;
+  const rows = [];
+  for (const p of r.palaces) {
+    const mark = p.isSoul ? '【命】' : p.isBody ? '【身】' : '　　';
+    rows.push(`  ${p.palace} ${p.branch} ${p.ganzhi} ${mark} 大限${String(p.daxian.start).padStart(2)}-${p.daxian.end} 小限${String(p.xiaoxian.age).padStart(2)}  ${starText(p.stars)}`);
+    rows.push(`     ${shenshaText(p.shensha)}`);
+  }
+  const liunian = (r.liunian ?? []).slice(0, 6).map((l) =>
+    `  ${l.year} ${l.ganzhi} ${String(l.age).padStart(2)}岁 命宫${l.lifePalace.branch}(${l.lifePalace.palace}) 流禄${l.liulu} 流羊${l.liuyang} 流陀${l.liutuo} ｜ ${l.mutagen.map((m) => m.replace('化', '')).join(' ')}`
+    + (l.mutagenHits ? `　四化落宫 ${l.mutagenHits.map((m) => `${m.star}${m.type}→${m.palace || '未上盘'}`).join('、')}` : '')
+    + (l.sanfangMainStars ? `　三方主星 ${l.sanfangMainStars.join('')}` : ''));
+  const patterns = (r.patterns ?? []).length
+    ? r.patterns.map((p) => `${p.name}（${p.tone === 'good' ? '吉格' : p.tone === 'bad' ? '忌格' : '中'}：${p.evidence}）`).join('；')
+    : '无明显格局（按内置规则）';
+  const daxian = (r.daxianList ?? []).slice(0, 8).map((d) =>
+    `  ${d.branch}宫（${d.palace}）${d.ages[0]}-${d.ages[1]}岁 ${d.ganzhi} 会${d.mainStars.join('') || '—'} 化 ${d.mutagenHits.map((m) => `${m.star}${m.type}→${m.palace || '未上盘'}`).join('、')}`);
+  return [
+    `【农历】${lunarText}（月首 ${r.lunar.monthStart}）　时支：${r.hourBranch}　年干支：${r.yearGanzhi}`,
+    `【时刻】${r.solarTime ? `${r.solarTime.civilText} → 真太阳时 ${r.solarTime.trueSolarText}${r.input.geo ? '（' + r.input.geo.note + '）' : ''}` : ''}`,
+    `【命宫】${r.soul.branch}（${r.soul.ganzhi}·${r.soul.nayin}）　【身宫】${r.body.branch}（落${r.body.lands}）　【五行局】${r.bureau.name}`,
+    `【紫微】${r.ziwei}　【天府】${r.tianfu}　【命主】${r.lifeMaster}　【身主】${r.bodyMaster}`,
+    `【大限】${r.daxian.rule}，${r.daxian.startAge}岁起　【小限】${r.xiaoxianRule.direction}`,
+    `【昌曲】文昌${r.changqu.wenchang.branch}（${r.changqu.wenchang.palace}${r.changqu.wenchang.mutagen ? '·化' + r.changqu.wenchang.mutagen : ''}）　文曲${r.changqu.wenqu.branch}（${r.changqu.wenqu.palace}${r.changqu.wenqu.mutagen ? '·化' + r.changqu.wenqu.mutagen : ''}）`,
+    `　　　${r.changqu.relation}　入命三方：${r.changqu.inSoulSanfang ? '是' : '否'}　吸收面：${r.changqu.absorb.label}（${r.changqu.absorb.reason}）`,
+    '十二宫：',
+    ...rows,
+    '大限（按起运年龄排序，前 8 限，宫干四化落宫）：',
+    ...daxian,
+    '流年（前 6 年，完整 12 年在结构化数据里）：',
+    ...liunian,
+    `【格局】${patterns}`,
+    r.patternSummary ? `【结构统计】吉格 ${r.patternSummary.good.length}、忌格 ${r.patternSummary.bad.length}；${r.patternSummary.note}` : '',
+    r.lunar.note ? `注：${r.lunar.note}` : '',
+  ].filter(Boolean).join('\n');
+}
+
+function qimenText(r) {
+  const P = r.palaces;
+  const cell = (x) => `${x.palace}宫 ${x.star || '—'}／${x.gate || '—'}／${x.god || '—'}${x.kong ? ' 空' : ''}${x.ma ? ' 马' : ''}`;
+  return [
+    `【四柱】${r.siZhu.year} ${r.siZhu.month} ${r.siZhu.day} ${r.siZhu.time}`,
+    `【局数】${r.ju}　节气 ${r.jieqi}（${r.jieqiTime}）`,
+    `【值符】${r.zhiFu.star}（${r.zhiFu.gong}宫）　【值使】${r.zhiShi.gate}（${r.zhiShi.gong}宫）　旬首 ${r.xunshou}`,
+    `【空亡】${r.kongWang.join('') || '—'}　驿马 ${r.ma.zhi || '—'}（${r.ma.gong || '—'}宫）`,
+    `【九宫】${P.map(cell).join('　')}`,
+    `※ 晚子时：${r.lateZiHourMode === 'next-day' ? '23:00 后归次日' : '23:00 后仍归当日'}（可用 lateZiHourMode / lateZi 指定）`,
+    `※ ${r.rules[r.rules.length - 1]}`,
+  ].join('\n');
+}
+
+function hepanText(r) {
+  if (r.chart === 'ziwei') {
+    const d = (x) => `${x.label}：${x.score >= 0 ? '+' : ''}${x.score}　${x.text}`;
+    return [
+      `【紫微合盘】${r.score.level}（${r.score.total}/100）`,
+      `你　命宫 ${r.a.soul.branch}（${r.a.soulStars.join('、') || '无主星'}）　夫妻 ${r.a.spouseStars.join('、') || '无主星'}　${r.a.bureau}`,
+      `对方 命宫 ${r.b.soul.branch}（${r.b.soulStars.join('、') || '无主星'}）　夫妻 ${r.b.spouseStars.join('、') || '无主星'}　${r.b.bureau}`,
+      ...r.dimensions.map(d),
+      ...r.interactions.map((h) => `　· ${h.text}`),
+      ...r.notes.map((n) => `※ ${n}`),
+    ].join('\n');
+  }
+  const d = (x) => `${x.label}：${x.score >= 0 ? '+' : ''}${x.score}　${x.text}`;
+  const solarLine = (side) => {
+    if (!side || !side.solarNote) return '—';
+    return `${side.longitude == null ? '未含经度修正' : `${side.longitude}°E`}（${side.solarNote}）`;
+  };
+  return [
+    `【合盘】${r.score.level}（${r.score.total}/100）`,
+    `你　${r.a.pillars.join(' ')}　日主 ${r.a.dayMaster}　日支 ${r.a.dayBranch}　${r.a.strength || ''}`,
+    `对方 ${r.b.pillars.join(' ')}　日主 ${r.b.dayMaster}　日支 ${r.b.dayBranch}　${r.b.strength || ''}`,
+    `真太阳时：你 ${solarLine(r.a)}；对方 ${solarLine(r.b)}`,
+    ...r.dimensions.map(d),
+    ...r.notes.map((n) => `※ ${n}`),
+  ].join('\n');
+}
+
+function daliurenText(r) {
+  const sc = r.sanChuan;
+  const one = (c) => `${c.zhi}(${c.jiang}${c.liuQin}${c.xunKong ? '空' : ''})`;
+  return [
+    `【日时】${r.dayGanZhi}日　${r.hourZhi}时（${r.dayNight}贵）　月将 ${r.yueJiang.name}${r.yueJiang.zhi}　节气 ${r.jieqi.name}　${r.lateZi === false ? '晚子时不换日' : '晚子时换日'}`,
+    `【三传】初 ${one(sc.chu)} → 中 ${one(sc.zhong)} → 末 ${one(sc.mo)}`,
+    `【四课】${r.siKe.map((k) => `${k.position}课 ${k.shang}上${k.xia}下(${k.relation}·${k.jiang})`).join('　')}`,
+    `【天地盘】${r.pan.map((p) => `${p.di}:${p.tian}(${p.jiang})`).join(' ')}`,
+    `【格局】${r.geJu.name}·${r.geJu.detail}`,
+    ...((r.shensha && r.shensha.length) ? [`【神煞】${r.shensha.map((x) => `${x.name}${x.branch}`).join('　')}`] : []),
+  ].join('\n');
+}
+
+function meihuaText(r) {
+  const lines = [
+    `【起卦】${r.source}`,
+    `【本卦】${r.ben.name}（上${r.ben.upper} 下${r.ben.lower}）　动爻：${r.movingName}`,
+    `【互卦】${r.hu.name}　【变卦】${r.bian.name}　【错卦】${r.cuo.name}　【综卦】${r.zong.name}`,
+    `【体用】体 ${r.bodyUse.body.trigram}${r.bodyUse.body.element}　用 ${r.bodyUse.use.trigram}${r.bodyUse.use.element}　${r.bodyUse.level}`,
+    `　　　　${r.bodyUse.relation}`,
+  ];
+  const bars = r.lines.slice().reverse().map((l) =>
+    `  ${l.name} ${l.yinYang === '阳' ? '━━━━━' : '━━  ━━'}${l.moving ? ' ←动' : ''}`);
+  return [...lines, '【爻】', ...bars].join('\n');
+}
+
+function tarotText(r) {
+  const lines = [
+    r.question ? `【所问】${r.question}` : '（未填写提问）',
+    `【牌阵】${r.spread}${r.castAt ? `　抽牌于 ${r.castAt}` : ''}`,
+  ];
+  for (const c of r.cards) {
+    lines.push(`  ${c.position}：${c.name}（${c.orientation}）　${c.keywords.join('、')}`);
+  }
+  if (r.reading && r.reading.length) {
+    lines.push('【解读】');
+    for (const p of r.reading) lines.push(`  ${p}`);
+  }
+  return lines.join('\n');
+}
+
+function liuyaoText(r) {
+  const fmt = (hex) => {
+    const rows = hex.lines.slice().reverse().map((l) => {
+      const mark = l.position === hex.shi ? '世' : l.position === hex.ying ? '应' : '　';
+      return `  ${l.name} ${mark} ${l.symbol} ${l.ganzhi}${l.element} ${l.liuqin}/${l.liushen}`;
+    });
+    return [`${hex.name}（${hex.palace}·${hex.palaceElement}）`, ...rows].join('\n');
+  };
+  const out = [
+    `起卦：${r.cast.notation.join('、')}（自下而上）`,
+    `日辰：${r.dayGanZhi.name}`,
+    r.xunShou ? `旬首：${r.xunShou}　旬空：${(r.xunKong || []).join('') || '—'}` : '',
+    r.question ? `所问：${r.question}` : '',
+    '本卦：',
+    fmt(r.ben),
+  ];
+  if (r.bian) out.push(`动爻：第 ${r.cast.movingPositions.join('、')} 爻`, '变卦（六亲以变卦自身宫论）：', fmt(r.bian));
+  else out.push('六爻安静，无变卦。');
+  return out.filter(Boolean).join('\n');
+}
+
+/** 工具输出必须是无损 JSON：去掉 undefined / 函数等不可序列化的值 */
+function jsonSafe(value) {
+  return JSON.parse(JSON.stringify(value));
+}
+
+/**
+ * 统一排盘入口
+ * @param {object} args
+ * @param {'bazi'|'ziwei'|'liuyao'} args.system
+ * @param {string} [args.datetime]
+ */
+export function compute(args = {}) {
+  const r = jsonSafe(computeRaw(args));
+  // 超出 ΔT 覆盖范围时把精度提示顶到摘要最前，别让远期盘悄悄出错
+  if (r && r.precision && r.precision.level === 'approx' && r.summary) {
+    r.summary = `⚠ ${r.precision.note}\n${r.summary}`;
+  }
+  // 没有经度就没有真太阳时：时柱可能整柱偏（海外出生尤其常见），必须显式告警而不是藏在括号里
+  if (r && (r.system === 'bazi' || r.system === 'ziwei') && r.input && r.input.longitude == null && r.summary) {
+    r.summary = `⚠ 未提供出生地或经度：按东八区平太阳时排盘，时柱可能与本命盘相差一个时辰；海外出生请先把当地时间换算成东八区标准时。\n${r.summary}`;
+  }
+  // 显式要求时才附加解析模块，避免默认输出过长；「所问之事」与「询问方向」一并传进去
+  if (args.withInterpret) {
+    r.interpret = interpret(r, {
+      question: typeof args.question === 'string' ? args.question : '',
+      direction: typeof args.direction === 'string' ? args.direction : 'general',
+    });
+  }
+  // 八字 × 紫微交叉验证：同一份出生信息再排另一套盘，并列两边对同一件事的说法
+  if (args.cross === true && (r.system === 'bazi' || r.system === 'ziwei')) {
+    const cdt = parseDateTime(args.datetime);
+    const common = {
+      ...cdt,
+      gender: requireGender(args.gender),
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+      trueSolar: args.trueSolar !== false,
+    };
+    const asOf = checkAsOf(args.asOf);
+    const other = r.system === 'bazi'
+      ? buildZiwei({ ...common, leapAsNext: args.leapAsNext === true, asOf })
+      : buildBazi({ ...common, lateZi: args.lateZi !== false, nowYear: asOf ? asOf.year : undefined });
+    r.cross = crossCheck(r.system === 'bazi' ? r : other, r.system === 'ziwei' ? r : other);
+    if (r.interpret) {
+      r.interpret.sections.push({ key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: crossText(r.cross) });
+    }
+  }
+  // 追问：围绕已算好的盘回答「某一年 / 某方面」的具体问题
+  if (typeof args.ask === 'string' && args.ask.trim()) r.followup = followup(r, args.ask);
+  return r;
+}
+
+/** 解析与详解的紧凑文本（给模型看，不塞整块 JSON） */
+export function interpretText(i) {
+  if (!i) return '';
+  const out = [`【${i.title || '解析与详解'}】${i.ask && i.ask.echo ? i.ask.echo : ''}`];
+  // 直答放在最前：先回答「你问的事」，再说依据，避免读者读到最后才知道结论
+  if (i.answer) out.push(`▶ 先答所问：${i.answer}`);
+  if (i.plain) out.push(`▶ 说人话：${i.plain}`);
+  if (i.lead) out.push(i.lead);
+  // 一页读懂：报告顶部的五条结论，先给读的人一个「整体形状」
+  if (Array.isArray(i.outline) && i.outline.length) {
+    out.push('一页读懂：' + i.outline.map((o) => `${o.label}·${o.text}`).join('　'));
+  }
+  // 解析生成失败时不能只返回一个空壳：盘面数据仍然可用，但要让调用方知道"这段没生成出来"
+  if (i.error) out.push(`⚠ 解析生成失败：${i.error}（上方盘面数据本身可用）`);
+  for (const d of i.dimensions || []) {
+    const evidence = Array.isArray(d.evidence) && d.evidence.length ? `\n　依据：${d.evidence.join('；')}${d.confidence ? `　置信度：${d.confidence}` : ''}` : '';
+    const plain = d.plain ? `（${d.plain}）` : '';
+    // 知识条目：「为什么这样断」＋出处＋可信度标注，是结论与依据之外的第三层
+    const know = (d.knowledge || [])
+      .map((k) => `\n　规则·${k.gist}〔${k.statusLabel}〕${k.detail}　出处：${k.source}${k.note ? `　注：${k.note}` : ''}`)
+      .join('');
+    out.push(`${d.label}：${plain}${d.text}${d.advice ? `　建议：${d.advice}` : ''}${evidence}${know}`);
+  }
+  for (const s of i.sections || []) out.push(`${s.label}：${s.text}`);
+  // 三张表：大运 / 流年 / 触发事件（纯文本对齐，工具输出也能直接读）
+  for (const t of i.tables || []) {
+    if (!Array.isArray(t.rows) || !t.rows.length) continue;
+    out.push(`【${t.title}】`);
+    out.push([t.columns.join(' | '), ...t.rows.map((r) => r.join(' | '))].join('\n'));
+  }
+  if (Array.isArray(i.followups) && i.followups.length) {
+    out.push('还可以这样追问：' + i.followups.map((q) => `「${q}」`).join('　'));
+  }
+  if (Array.isArray(i.glossary) && i.glossary.length) {
+    out.push('名词解释：' + i.glossary.map((g) => `${g.term}＝${g.plain}`).join('　'));
+  }
+  if (i.disclaimer) out.push(i.disclaimer);
+  return out.join('\n');
+}
+
+const JU_METHODS = ['chaibu', 'chaoshen', 'zhirun'];
+const TAROT_COUNTS = [1, 3, 5];
+const LATE_ZI_MODES = ['same-day', 'next-day'];
+
+/** asOf 只接受能解析成真实日期的字符串；非法值以前会静默回退到「此刻」 */
+function checkAsOf(asOf) {
+  if (asOf === undefined || asOf === null || asOf === '') return undefined;
+  const parts = asOfParts(asOf);
+  if (!parts) throw fail('E_ASOF', `无法解析 asOf：「${asOf}」，请用 2026-10-22T16:00 这种格式`);
+  const { year, month, day } = parts;
+  if (!(month >= 1 && month <= 12) || !(day >= 1 && day <= daysInMonth(year, month))) {
+    throw fail('E_ASOF', `asOf 指向的日期不存在：${asOf}`);
+  }
+  return parts;
+}
+
+function computeRaw(args = {}) {
+  const system = args.system;
+  if (system === 'bazi') {
+    const dt = parseDateTime(args.datetime);
+    const asOf = checkAsOf(args.asOf);
+    const result = buildBazi({
+      ...dt,
+      gender: requireGender(args.gender),
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+      lateZi: args.lateZi !== false,
+      trueSolar: args.trueSolar !== false,
+      // 流年表默认从「今年」起排；要复现历史结论就把基准年钉死
+      nowYear: asOf ? asOf.year : undefined,
+    });
+    return { ...result, ...(asOf ? { asOf } : {}), precision: dt.precision, summary: baziText(result) };
+  }
+  if (system === 'ziwei') {
+    const dt = parseDateTime(args.datetime);
+    const asOf = checkAsOf(args.asOf);
+    const result = buildZiwei({
+      ...dt,
+      gender: requireGender(args.gender),
+      leapAsNext: args.leapAsNext === true,
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+      trueSolar: args.trueSolar,
+      // 流月/流日/流时的基准时刻：默认本机此刻，可用 asOf 指定以便复现
+      asOf,
+    });
+    return { ...result, precision: dt.precision, summary: ziweiText(result) };
+  }
+  if (system === 'tarot') {
+    const count = args.count === undefined || args.count === null || args.count === '' ? 3 : Number(args.count);
+    if (!TAROT_COUNTS.includes(count)) {
+      throw fail('E_COUNT', `塔罗张数只能是 1 / 3 / 5，收到「${args.count}」`);
+    }
+    if (!isSeed(args.seed)) throw fail('E_INPUT', `seed 必须是数字，收到「${args.seed}」`);
+    const asOf = checkAsOf(args.asOf);
+    // 抽牌不看时间：castAt 只记录此刻（或 asOf），避免误用出生时间；给了 seed 就能复现同一次抽牌
+    const result = drawTarot({ count, question: args.question, at: args.asOf, random: randomOf(args.seed) });
+    if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
+    return { ...result, ...(asOf ? { asOf } : {}), summary: tarotText(result) };
+  }
+  if (system === 'daliuren') {
+    const dt = parseDateTime(args.datetime);
+    const lateZi = args.lateZi !== false;
+    const result = buildDaliuren({ ...dt, lateZi });
+    result.lateZi = lateZi;
+    return { ...result, precision: dt.precision, summary: daliurenText(result) };
+  }
+  if (system === 'qimen') {
+    const dt = parseDateTime(args.datetime);
+    if (args.juMethod !== undefined && !JU_METHODS.includes(args.juMethod)) {
+      throw fail('E_INPUT', `juMethod 只能是 chaibu / chaoshen / zhirun，收到「${args.juMethod}」`);
+    }
+    // 全插件只有"晚子时"这一件事，参数名不该按体系分裂：
+    // lateZiHourMode 是奇门的历史参数名，lateZi 是八字/六壬的；两者互为别名。
+    const mode = args.lateZiHourMode !== undefined
+      ? args.lateZiHourMode
+      : args.lateZi === true ? 'next-day' : args.lateZi === false ? 'same-day' : undefined;
+    if (mode !== undefined && !LATE_ZI_MODES.includes(mode)) {
+      throw fail('E_INPUT', `lateZiHourMode 只能是 same-day / next-day，收到「${mode}」`);
+    }
+    const lateZiHourMode = mode === 'next-day' ? 'next-day' : 'same-day';
+    const result = buildQimen({ ...dt, lateZiHourMode, juMethod: args.juMethod });
+    result.lateZiHourMode = lateZiHourMode;
+    return { ...result, summary: qimenText(result) };
+  }
+  if (system === 'hepan') {
+    const partner = args.partner;
+    if (!partner || typeof partner !== 'object') {
+      throw fail('E_PARTNER', '合盘需要 partner：{ datetime, gender, address? }，其中 partner.datetime 是对方的公历出生时间');
+    }
+    if (!partner.datetime) {
+      throw fail('E_PARTNER', '缺少 partner.datetime（对方的公历出生时间），例如 partner: {"datetime":"1992-03-03T10:00","gender":"female"}');
+    }
+    const pa = parseDateTime(args.datetime);
+    const pb = parseDateTime(partner.datetime);
+    const chart = args.chart === 'ziwei' ? 'ziwei' : 'bazi';
+    // 性别决定双方大运/大限顺逆，两边都不能用默认值
+    const sideA = {
+      ...pa,
+      gender: requireGender(args.gender, '你（主方）'),
+      trueSolar: args.trueSolar,
+      lateZi: args.lateZi,
+      address: typeof args.address === 'string' ? args.address : undefined,
+      longitude: typeof args.longitude === 'number' ? args.longitude : undefined,
+      geo: args.geo && typeof args.geo === 'object' ? args.geo : undefined,
+    };
+    const sideB = {
+      ...pb,
+      gender: requireGender(partner.gender, '对方'),
+      trueSolar: partner.trueSolar,
+      lateZi: partner.lateZi,
+      address: typeof partner.address === 'string' ? partner.address : undefined,
+      longitude: typeof partner.longitude === 'number' ? partner.longitude : undefined,
+      geo: partner.geo && typeof partner.geo === 'object' ? partner.geo : undefined,
+    };
+    const result = chart === 'ziwei' ? buildZiweiHepan({ a: sideA, b: sideB }) : buildHepan({ a: sideA, b: sideB });
+    return { ...result, summary: hepanText(result) };
+  }
+  if (system === 'meihua') {
+    let result;
+    try {
+      result = buildMeihua({
+        mode: args.mode === 'number' ? 'number' : 'time',
+        datetime: args.datetime,
+        upper: args.upper,
+        lower: args.lower,
+        changing: args.changing,
+      });
+    } catch (e) {
+      throw fail('E_INPUT', `梅花起卦参数不完整：${e && e.message ? e.message : e}`);
+    }
+    return { ...result, summary: meihuaText(result) };
+  }
+  if (system === 'liuyao') {
+    if (!isSeed(args.seed)) throw fail('E_INPUT', `seed 必须是数字，收到「${args.seed}」`);
+    let lines;
+    if (args.lines === undefined || args.lines === null) {
+      // 没给爻值 = 随机摇卦；给了 seed 则同一次摇卦可复现
+      lines = tossLines(randomOf(args.seed));
+    } else {
+      if (!Array.isArray(args.lines)) {
+        throw fail('E_LINES', 'lines 必须是数组：自下而上 6 个爻值（6 老阴 / 7 少阳 / 8 少阴 / 9 老阳）');
+      }
+      if (args.lines.length !== 6) {
+        // 以前这里会静默改随机摇卦：用户手抖少填一个，拿到的却是一张"看起来正常"的随机盘
+        throw fail('E_LINES', `六爻需要正好 6 个爻值（自下而上），收到 ${args.lines.length} 个；留空则由引擎随机摇卦`);
+      }
+      lines = args.lines.map(Number);
+    }
+    let dayGanZhi;
+    let asOf = null;
+    // 六神按「起卦日」的日干起：给了 datetime 用它，给了 asOf 用 asOf，都没有才回落到本机当天
+    const stamp = args.datetime ? parseDateTime(args.datetime) : checkAsOf(args.asOf);
+    if (stamp) {
+      if (!args.datetime) asOf = stamp;
+      const g = ganzhiName(dayGanzhiIndex(toJDN(stamp.year, stamp.month, stamp.day)));
+      dayGanZhi = { stem: g.stem, branch: g.branch, name: g.name };
+    }
+    let result;
+    try {
+      result = buildLiuyao({ lines, question: args.question, dayGanZhi });
+    } catch (e) {
+      throw fail('E_LINES', e && e.message ? e.message : e);
+    }
+    if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
+    return { ...result, ...(asOf ? { asOf } : {}), summary: liuyaoText(result) };
+  }
+  if (!system) {
+    throw fail('E_INPUT', '缺少 system，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）。');
+  }
+  throw fail('E_SYSTEM', `未知体系「${system}」，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）。`);
+}
+
+/** 给模型的紧凑文本（去掉大字段，保留摘要；带解析时附上解析） */
+export function renderText(result) {
+  const base = result.summary ?? JSON.stringify(result, null, 2);
+  const parts = [base];
+  if (result.interpret) {
+    const extra = interpretText(result.interpret);
+    if (extra) parts.push(extra);
+  }
+  if (result.cross) parts.push(`【八字 × 紫微 交叉验证】\n${crossText(result.cross)}`);
+  if (result.followup) {
+    const f = result.followup;
+    parts.push(`【追问】${f.question}\n${f.answer}${f.evidence && f.evidence.length ? `\n　依据：${f.evidence.join('；')}　置信度：${f.confidence}` : ''}`);
+  }
+  return parts.filter(Boolean).join('\n\n');
+}
+
+/** 对外暴露：地址解析（异步，含联网） */
+export { geocodeAddress, resolveAddress };
+
+export { buildBazi, buildLiuyao, tossLines };
+export { followup };
+export { crossCheck, crossText };
+
+
+
+
+
+
+
+
+