dsh-metaphysics 0.21.0 → 0.34.0

package/engine/bazi.js

@@ -6,7 +6,7 @@ import {
 } from './calendar.js';
 import { resolveAddress } from './geo.js';
 import { computeBaziShensha } from './shensha.js';
-import { assertCivil } from './validate.js';
+import { assertCivil, daysInMonth } from './validate.js';
 import { applyDst } from './dst.js';
 import { nayinOf } from './nayin.js';
 import { SANHE } from './sanhe.js';
@@ -277,6 +277,22 @@ export function buildBazi(input) {
   // 四舍五入到 12 个月时必须进位，否则显示「X 岁 12 个月起运」
   if (startAgeMonths >= 12) { startAgeMonths -= 12; startAgeYears += 1; }
 
+  // 交运：三日折一年。
+  // 古法三条换算是同一比例的三种说法——3 日折 1 年、1 日折 4 个月、1 时辰折 10 日：
+  // 把「出生 → 起运那一侧的节令」的真实间隔按 365.2422/3（≈121.7474）倍放大，
+  // 就是起运那一刻；放大后的 1/12 恰好 121.7474/12 ≈ 10.15 天，即「一时辰十日」。
+  // 一年取回归年 365.2422 日（交运日细算各家不一，这里固定这一个口径并写明）。
+  const JIAO_YEAR_DAYS = 365.2422;
+  const JIAO_SCALE = JIAO_YEAR_DAYS / 3;
+  const jiaoFromTerm = forward ? nextJieTerm : prevJieTerm;
+  const jiaoJd = jd + spanDays * JIAO_SCALE;
+  const jiaoParts = jdToParts(jiaoJd);
+  // 每步大运在「同月同日同时刻」换；公历闰日（2 月 29 日生）退到 2 月 28 日
+  const addYearsClamped = (p, n) => {
+    const y = p.year + n;
+    return { year: y, month: p.month, day: Math.min(p.day, daysInMonth(y, p.month)), hour: p.hour, minute: p.minute };
+  };
+
   const dayun = [];
   for (let i = 1; i <= 8; i++) {
     const idx = (((monthIdx + (forward ? i : -i)) % 60) + 60) % 60;
@@ -289,6 +305,9 @@ export function buildBazi(input) {
       branch: g.branch,
       stemTenGod: tenGod(dayStem, g.stem),
       nayin: nayin(idx),
+      // 这一步大运的起止交运时刻（与摘要/面板同源，可直接拿来对年表）
+      fromDate: formatJd(partsToJd(addYearsClamped(jiaoParts, (i - 1) * 10))),
+      toDate: formatJd(partsToJd(addYearsClamped(jiaoParts, i * 10))),
     });
   }
 
@@ -503,10 +522,22 @@ export function buildBazi(input) {
       rule: `${isYangYear ? '阳' : '阴'}年${gender === 'male' ? '男' : '女'}${forward ? '顺排' : '逆排'}`,
       startAge: { years: startAgeYears, months: startAgeMonths },
       toNextJieDays: Math.round(spanDays * 100) / 100,
+      // 交运时刻（日/时辰级）：上方 startAge 是四舍五入到月的旧字段，两者同源、不互相覆盖
+      jiao: {
+        at: formatJd(jiaoJd),
+        jd: Math.round(jiaoJd * 1e6) / 1e6,
+        scaleDaysPerDay: JIAO_SCALE,
+        yearDays: JIAO_YEAR_DAYS,
+        spanDays: Math.round(spanDays * 1e4) / 1e4,
+        from: { name: jiaoFromTerm.name, time: formatJd(jiaoFromTerm.jd) },
+        frame: solar.offsetMinutes ? '真太阳时' : '平太阳时',
+        offsetMinutes: solar.offsetMinutes,
+        note: '三日折一年：出生到节令的真实间隔按 365.2422/3 放大后加到出生时刻；同一比例即「一日折四月、一时辰折十日」，每步大运在同月同日同时刻换',
+      },
       list: dayun,
     },
     strength,
-    frame,
+    frame,
     climate: frame.yongshen.climate || frame.yongshen.tiaohou || null,
     liunian,
     liunianFrom: thisYear,

package/engine/classics.js

@@ -0,0 +1,264 @@
+// 古籍原文库：《子平真诠》《滴天髓》里与「格局取用」「十神喜忌」「寒暖燥湿」直接相关的条目。
+// 原文照录（公共版权：清·沈孝瞻《子平真诠》、明·京图《滴天髓》通行本），仅供文化研究与参考。
+// 出处以中华典藏网在线本为准（逐条给 url），异文处不合并、不改写；plain 是本站自撰白话，不是原文。
+
+export const CLASSIC_BOOKS = {
+  ziping: { name: '子平真诠', author: '清·沈孝瞻', base: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/' },
+  ditian: { name: '滴天髓', author: '明·京图（通行本）', base: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/' },
+};
+
+export const CLASSICS = [
+  {
+    id: 'zp-yongshen',
+    book: 'ziping',
+    chapter: '八、论用神',
+    scene: '用神',
+    tags: [],
+    quote: '八字用神，专求月令，以日干配月令地支，而生克不同，格局分焉。财官印食，此用神之善而顺用之者也；煞伤劫刃，用神之不善而逆用之者也。',
+    plain: '用神从月令里找：财、官、印、食四吉神顺用（生之护之），煞、伤、劫、刃四凶神逆用（制之化之）。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53628.html',
+  },
+  {
+    id: 'zp-zhenguan',
+    book: 'ziping',
+    chapter: '三十一、论正官',
+    scene: '格局',
+    tags: ['正官'],
+    quote: '以刑冲破害为忌，则以生之护之为喜矣。存其喜而去其忌则贵，而贵之中又有高低者，何也？',
+    plain: '正官格最忌刑冲破害，喜财生官、印护官；去忌存喜才谈得上贵，贵的层次还要看财印是否并透、有无伤官七煞混杂。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53651.html',
+  },
+  {
+    id: 'zp-cai',
+    book: 'ziping',
+    chapter: '三十三、论财',
+    scene: '格局',
+    tags: ['财'],
+    quote: '财为我克，使用之物也，以能生官，所以为美。为财帛，为妻妾，为才能，为驿马，皆财类也。',
+    plain: '财是我所克、能为我用之物，因能生官而美；它同时代表钱财、配偶、才能、走动，不只「钱」一项。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53653.html',
+  },
+  {
+    id: 'zp-yin',
+    book: 'ziping',
+    chapter: '三十五、论印绶',
+    scene: '格局',
+    tags: ['印'],
+    quote: '印绶喜其生身，正偏同为美格，故财与印不分偏正，同为一格而论之。',
+    plain: '印能生身，正印偏印都算美格，不分偏正而论；印格的关键在身印强弱与官杀、食伤、财的配合。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53655.html',
+  },
+  {
+    id: 'zp-shishen',
+    book: 'ziping',
+    chapter: '三十七、论食神',
+    scene: '格局',
+    tags: ['食神'],
+    quote: '食神本属泄气，以其能生正财，所以喜之。故食神生财，美格也。财要有根，不必偏正叠出，如身强食旺而财透，大贵之格。',
+    plain: '食神本是泄气，可贵在能生财；食神生财要财有根，身强、食旺、财透三者齐，格局才大。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53657.html',
+  },
+  {
+    id: 'zp-pianguan',
+    book: 'ziping',
+    chapter: '三十九、论偏官',
+    scene: '格局',
+    tags: ['七杀', '偏官'],
+    quote: '煞以攻身，似非美物，百大贵之格，多存七煞。盖控制得宜，煞为我用，如大英雄大豪杰，似难驾驭，而处之有方，则惊天动地之功，忽焉而就。',
+    plain: '七煞攻身，看着不美，但大贵之格多有七煞——能控制住就为我所用，像驾驭豪杰，处之有方就能成大事。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53659.html',
+  },
+  {
+    id: 'zp-shangguan',
+    book: 'ziping',
+    chapter: '四十一、论伤官',
+    scene: '格局',
+    tags: ['伤官'],
+    quote: '伤官虽非吉神，实为秀气，故文人学士，多于伤官格内得之。而夏木见水，冬金见火，则又为秀之尤秀者也。',
+    plain: '伤官不是吉神，却是秀气所在，文人多出伤官格；夏木得水、冬金得火，是秀气里更秀的两种。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53661.html',
+  },
+  {
+    id: 'zp-yangren',
+    book: 'ziping',
+    chapter: '四十三、论阳刃',
+    scene: '格局',
+    tags: ['劫财', '阳刃'],
+    quote: '阳刃者，劫我正财之神，乃正财之七煞也。禄前一位，惟五阳有之，故为阳刃。不曰劫而曰刃，劫之甚也。刃宜伏制，官煞皆宜，财印相随，尤为贵显。',
+    plain: '阳刃是劫财之极（只有五阳干有），宜用官煞制伏；财印相随而不相碍，格局更显。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53663.html',
+  },
+  {
+    id: 'zp-lujie',
+    book: 'ziping',
+    chapter: '四十五、论建禄月劫',
+    scene: '格局',
+    tags: ['比肩', '建禄', '月劫'],
+    quote: '故建禄与月劫，可同一格，不必加分，皆以透干支，别取财官煞食为用。',
+    plain: '建禄、月劫同看一格，月令本身不算用神，要另看透出的财官煞食取用。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53665.html',
+  },
+  {
+    id: 'zp-qihou',
+    book: 'ziping',
+    chapter: '十四、论用神配气候得失',
+    scene: '调候',
+    tags: [],
+    quote: '论命惟以月令用神为主，然亦须配气候而互参之。譬如英雄豪杰，生得其时，自然事半功倍；遭时不顺，虽有奇才，成功不易。',
+    plain: '月令用神为主，但必须配气候参看；同样的格局，生在得时的气候里事半功倍，逆着气候就费劲。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53634.html',
+  },
+  {
+    id: 'dt-hannuan',
+    book: 'ditian',
+    chapter: '通神论·寒暖',
+    scene: '调候',
+    tags: [],
+    quote: '天道有寒暖，生育万物，人道行之，不可过也。',
+    plain: '天有寒暖才能生养万物，人命里寒暖也不能过——过寒过热都要调。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-zaoshi',
+    book: 'ditian',
+    chapter: '通神论·燥湿',
+    scene: '调候',
+    tags: [],
+    quote: '地道有燥湿，生成品汇，人道得之，不可偏也。',
+    plain: '地有燥湿才有品类生成，人命得燥湿之气也不能偏。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-shuaiwang',
+    book: 'ditian',
+    chapter: '通神论·衰旺',
+    scene: '调候',
+    tags: [],
+    quote: '能知旺衰之真机，其于三命之奥，思过半矣。',
+    plain: '真正看懂旺衰的机关，命理之奥就过了一半——旺衰不是数个数，要看真机。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-zhonghe',
+    book: 'ditian',
+    chapter: '通神论·中和',
+    scene: '调候',
+    tags: [],
+    quote: '既识中和之正理，而于五行之妙，有全能焉。',
+    plain: '懂得中和的道理，五行的妙处就都在其中了。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-guansha',
+    book: 'ditian',
+    chapter: '通神论·官杀',
+    scene: '十神',
+    tags: ['正官', '七杀'],
+    quote: '官杀混杂来问我，有可有不可。',
+    plain: '官杀混杂不是一律不好，要看能不能去留取清。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-shangguan',
+    book: 'ditian',
+    chapter: '通神论·伤官',
+    scene: '十神',
+    tags: ['伤官'],
+    quote: '伤官见官最难辨，可见不可见。',
+    plain: '伤官见官是最难分辨的一条：有的能见，有的不能见，不能一句「伤官见官为祸百端」了事。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-yueling',
+    book: 'ditian',
+    chapter: '通神论·月令',
+    scene: '用神',
+    tags: [],
+    quote: '月令乃提纲之府，譬之宅也，人元为用事之神，宅之定向也，不可以不卜。',
+    plain: '月令像宅子，藏干是用事之神，像宅子的朝向，必须细看。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-tiyong',
+    book: 'ditian',
+    chapter: '通神论·体用',
+    scene: '用神',
+    tags: [],
+    quote: '道有体用，不可以一端论也，要在扶之抑之得其宜。',
+    plain: '体用不能只看一头，关键是扶抑得宜。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+  {
+    id: 'dt-jingshen',
+    book: 'ditian',
+    chapter: '通神论·精神',
+    scene: '用神',
+    tags: [],
+    quote: '人有精神，不可以一偏求也，要在损之益之得其中。',
+    plain: '看精神不能偏执一端，要在损益之间求其中。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/ditiansui/153091.html',
+  },
+];
+
+const BY_ID = CLASSICS.reduce((m, e) => { m[e.id] = e; return m; }, {});
+
+// 格局名 → tags 键（本引擎的格局名都带「格」）
+const GEJU_KEY = {
+  正官格: '正官',
+  七杀格: '七杀',
+  偏官格: '偏官',
+  正财格: '财',
+  偏财格: '财',
+  正印格: '印',
+  偏印格: '印',
+  食神格: '食神',
+  伤官格: '伤官',
+  阳刃格: '阳刃',
+  月劫格: '月劫',
+  建禄格: '建禄',
+};
+
+export function classicOf(id) {
+  return BY_ID[id] || null;
+}
+
+function tagOf(gejuName) {
+  const name = String(gejuName || '');
+  if (GEJU_KEY[name]) return GEJU_KEY[name];
+  const bare = name.replace(/格$/, '');
+  return GEJU_KEY[bare + '格'] || bare;
+}
+
+// 根据一张八字结果挑原文：先格局（格局条），再调候（寒暖/燥湿），最后用神通则；去重、限量。
+export function classicsFor(r, limit = 4) {
+  if (!r) return [];
+  const out = [];
+  const seen = new Set();
+  const push = (entry, why) => {
+    if (!entry || seen.has(entry.id) || out.length >= limit) return;
+    seen.add(entry.id);
+    out.push({ ...entry, why });
+  };
+  const gejuList = Array.isArray(r.geju) ? r.geju : (r.frame && Array.isArray(r.frame.geju) ? r.frame.geju : []);
+  for (const g of gejuList) {
+    if (!g || (g.kind && g.kind !== '月令格')) continue;
+    const tag = tagOf(g.name);
+    const hit = CLASSICS.find((e) => e.scene === '格局' && e.tags.includes(tag));
+    if (hit) push(hit, `你的月令格局是「${g.name}」，故取${CLASSIC_BOOKS[hit.book].name}论${hit.chapter.replace(/^.*、/, '')}`);
+  }
+  const cli = r.climate || (r.frame && r.frame.yongshen && (r.frame.yongshen.climate || r.frame.yongshen.tiaohou));
+  if (cli && cli.kind && cli.kind !== '平和') {
+    const cold = !!(cli.cold || cli.kind.indexOf('寒') >= 0);
+    const hot = !!(cli.hot || cli.kind.indexOf('热') >= 0);
+    push(classicOf(cold ? 'dt-hannuan' : 'dt-zaoshi'), `本盘气候判为「${cli.kind}」，故取${CLASSIC_BOOKS.ditian.name}寒暖燥湿一条`);
+    push(classicOf('zp-qihou'), '气候与月令用神要互参，故取子平真诠「用神配气候」一条');
+    if (hot) push(classicOf('dt-hannuan'), '本盘偏热，寒暖一条正对');
+  }
+  push(classicOf('zp-yongshen'), '用神从月令取、四吉顺用四凶逆用，是通用总纲');
+  return out;
+}
+
+export function classicsText(rows) {
+  if (!rows || !rows.length) return '';
+  return rows.map((e) => `《${CLASSIC_BOOKS[e.book].name}·${e.chapter}》「${e.quote}」`).join('\n');
+}

package/engine/geo.js

@@ -143,7 +143,7 @@ const DETAIL = /(区|县|镇|乡|村|小区|街道|路|号|巷|弄|组|队)/;
 
 /** OpenStreetMap Nominatim：免密钥、支持中文。失败返回 null。
  *  UA 按 OSM 使用政策要求写明应用与联系方式（改版本时同步这里）。 */
-const USER_AGENT = 'dsh-metaphysics/0.21.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
+const USER_AGENT = 'dsh-metaphysics/0.23.0 (+https://github.com/xuanfu-web/dsh-metaphysics)';
 
 async function onlineLookup(text, { timeoutMs = 2500 } = {}) {
   if (typeof fetch !== 'function') return null;

package/engine/index.js

@@ -1,13 +1,13 @@
 // 统一入口：解析参数、分派到各体系、生成可读摘要
 import { buildBazi } from './bazi.js';
-import { buildLiuyao, tossLines } from './liuyao.js';
+import { buildLiuyao, tossLines, bodyLabels, yongshenOf, yongshenStrength } 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 { buildQimen, buildSnapshot } from './qimen.js';
 import { geocodeAddress, resolveAddress } from './geo.js';
 import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
 import { randomOf, isSeed } from './random.js';
@@ -22,7 +22,9 @@ import { buildChenggu } from './chenggu.js';
 import { buildXiaoliuren } from './xiaoliuren.js';
 import { buildStar } from './star.js';
 import { buildNumerology } from './numerology.js';
+import { buildMbti, mbtiPaper } from './mbti.js';
 import { buildConvert } from './convert.js';
+import { classicsFor, classicsText } from './classics.js';
 import { buildTrend } from './trend.js';
 import { buildFengshui } from './fengshui.js';
 import { buildName } from './name.js';
@@ -96,6 +98,10 @@ function baziText(r) {
     : '';
   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('　');
+  // 交运时刻（日/时辰级）：旧结果没有 dayun.jiao，缺省就只说「起运」，不硬凑
+  const jiao = r.dayun.jiao && r.dayun.jiao.at
+    ? `；交运 ${r.dayun.jiao.at}（${r.dayun.jiao.frame}，距${r.dayun.jiao.from.name} ${r.dayun.jiao.spanDays} 天，三日折一年）`
+    : '';
   // 阈值 20 分钟：与 NAOJ 历要项对拍实测，本引擎节气最多偏早 13.5 分钟（Meeus 低精度上限约 14 分钟）
   const near = r.jieqi.nearBoundaryMinutes < 20
     ? `\n⚠ 出生时刻距「节」仅 ${r.jieqi.nearBoundaryMinutes} 分钟，而节气时刻本身有最多约 14 分钟的偏差，月柱与年柱建议人工复核。`
@@ -127,7 +133,7 @@ function baziText(r) {
     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}个月起运`,
+    `大运：${r.dayun.rule}（${r.dayun.direction}），${r.dayun.startAge.years}岁${r.dayun.startAge.months}个月起运${jiao}`,
     `　${dayun}`,
     `流年：${r.liunian.slice(0, 10).map((l) => `${l.year}${l.ganzhi}(${l.stemTenGod})${l.luck ? `·${l.luck.tier}` : ''}`).join('　')}`,
     '（格局、用神、行运吉凶为扶抑＋简化调候的量化提示，非断语。）',
@@ -156,6 +162,18 @@ function ziweiText(r) {
     : '无明显格局（按内置规则）';
   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('、')}`);
+  // 命宫四化飞星：宫干化出的星落在哪一宫，一路串下去成环为止
+  const flyLine = (() => {
+    const fc = r.flyChains;
+    if (!fc) return '';
+    const one = (t) => {
+      const ch = fc[t];
+      if (!ch || !ch.steps.length) return '';
+      return `${t}：${ch.path.join('→')}${ch.closed ? '（成环）' : ''}`;
+    };
+    const text = ['禄', '权', '科', '忌'].map(one).filter(Boolean).join('　');
+    return text ? `【命宫飞星】${text}` : '';
+  })();
   return [
     `【农历】${lunarText}（月首 ${r.lunar.monthStart}）　时支：${r.hourBranch}　年干支：${r.yearGanzhi}`,
     `【时刻】${r.solarTime ? `${r.solarTime.civilText} → 真太阳时 ${r.solarTime.trueSolarText}${r.input.geo ? '（' + r.input.geo.note + '）' : ''}` : ''}`,
@@ -164,6 +182,7 @@ function ziweiText(r) {
     `【大限】${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}）`,
+    flyLine,
     '十二宫：',
     ...rows,
     '大限（按起运年龄排序，前 8 限，宫干四化落宫）：',
@@ -176,6 +195,17 @@ function ziweiText(r) {
   ].filter(Boolean).join('\n');
 }
 
+const STATE_ORDER = ['旺', '相', '休', '囚', '死'];
+/** 门/星的月令五态，按 旺相休囚死 顺序拼成一行 */
+function stateLine(r) {
+  const st = r.states;
+  const mo = r.month;
+  if (!st || !mo) return '无月令数据';
+  const fmt = (g) => STATE_ORDER.filter((k) => g && Array.isArray(g[k]) && g[k].length)
+    .map((k) => `${k} ${g[k].join('/')}`).join('　');
+  return `月令 ${mo.branch}（${mo.element}）　门 ${fmt(st.gate) || '—'}　星 ${fmt(st.star) || '—'}　干 ${fmt(st.stem) || '—'}`;
+}
+
 function qimenText(r) {
   const P = r.palaces;
   const cell = (x) => `${x.palace}宫 ${x.star || '—'}／${x.gate || '—'}／${x.god || '—'}${x.kong ? ' 空' : ''}${x.ma ? ' 马' : ''}`;
@@ -184,6 +214,8 @@ function qimenText(r) {
     `【局数】${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 || '—'}宫）`,
+    `【宫位条件】击刑 ${(r.conditions && r.conditions.jiXing || []).map((x) => `${x.palace}宫${x.stem}`).join('、') || '无'}　入墓 ${(r.conditions && r.conditions.ruMu || []).map((x) => `${x.palace}宫${x.stem}`).join('、') || '无'}`,
+    `【旺衰】${stateLine(r)}`,
     `【九宫】${P.map(cell).join('　')}`,
     `※ 晚子时：${r.lateZiHourMode === 'next-day' ? '23:00 后归次日' : '23:00 后仍归当日'}（可用 lateZiHourMode / lateZi 指定）`,
     `※ ${r.rules[r.rules.length - 1]}`,
@@ -285,6 +317,27 @@ function liuyaoText(r) {
   ];
   if (r.bian) out.push(`动爻：第 ${r.cast.movingPositions.join('、')} 爻`, '变卦（六亲以变卦自身宫论）：', fmt(r.bian));
   else out.push('六爻安静，无变卦。');
+  // 结果里已带 labels；只有旧数据或裸对象调用时才现算一份
+  const body = (r.body && Array.isArray(r.body.labels)) ? r.body.labels : bodyLabels(r.body);
+  out.push(`卦体：${body.length ? body.join(' · ') : '无六冲、六合、伏吟、反吟'}`);
+  // 用神：按询问方向取六亲（感情分男女、出行以世为用），不上卦时给伏神
+  const ug = r.useGod || yongshenOf(r, {});
+  if (ug && ug.liuqin) {
+    const where = ug.found.length
+      ? ug.found.map((f) => `${f.position}爻${f.ganzhi}${f.element}${f.kong ? '（空）' : ''}`).join('、')
+      : (ug.fushen.length ? ug.fushen.map((f) => `伏 ${f.position}爻${f.ganzhi}${f.element}（${f.relation || '飞伏关系未知'}）`).join('、') : '不上卦');
+    out.push(`用神：${ug.byShi ? '世爻' : ug.liuqin}（${ug.ask}）→ ${where}${ug.side ? `（${ug.side}）` : ''}`);
+    const head = ug.byShi ? '用神 世爻' : `用神 ${ug.liuqin}`;
+    const extra = ug.labels.filter((x) => x !== head && !x.startsWith(head));
+    if (extra.length) out.push(`用神联动：${extra.join(' · ')}`);
+    const strength = r.useGodStrength;
+    if (strength && strength.labels.length) {
+      const m = strength.month && strength.month.branch ? `月建 ${strength.month.branch}（${strength.month.element}）　` : '';
+      out.push(`用神旺衰：${m}${strength.labels.join(' · ')}`);
+    }
+  } else {
+    out.push('用神：未取（未指明所问之事；用「询问方向」指定后即按六亲取用）');
+  }
   return out.filter(Boolean).join('\n');
 }
 
@@ -301,6 +354,11 @@ function jsonSafe(value) {
  */
 export function compute(args = {}) {
   const r = jsonSafe(computeRaw(args));
+  if (r && r.system === 'bazi') {
+    r.classics = classicsFor(r);
+    const ct = classicsText(r.classics);
+    if (ct) r.summary = `${r.summary}\n【古籍】\n${ct}`;
+  }
   // 超出 ΔT 覆盖范围时把精度提示顶到摘要最前，别让远期盘悄悄出错
   if (r && r.precision && r.precision.level === 'approx' && r.summary) {
     r.summary = `⚠ ${r.precision.note}\n${r.summary}`;
@@ -589,6 +647,23 @@ function computeRaw(args = {}) {
     } catch (e) {
       throw fail('E_LINES', e && e.message ? e.message : e);
     }
+    // 用神挂在结果上：摘要、面板、解析三层读同一份，避免各自取一次走散
+    const ug = yongshenOf(result, { direction: args.direction, gender: args.gender });
+    if (ug.liuqin) {
+      result.useGod = ug;
+      // 月建按节气换月、与八字同源：从同一个 snapshot 取月支，取不到就只按日辰算
+      let monthBranch = null;
+      if (stamp) {
+        try {
+          const snap = buildSnapshot({ year: stamp.year, month: stamp.month, day: stamp.day, hour: stamp.hour, minute: stamp.minute });
+          monthBranch = (snap.monthGanZhi || '')[1] || null;
+        } catch {
+          monthBranch = null;
+        }
+      }
+      const strength = yongshenStrength(result, ug, { monthBranch, dayBranch: result.dayGanZhi.branch });
+      if (strength) result.useGodStrength = strength;
+    }
     if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
     return { ...result, ...(asOf ? { asOf } : {}), summary: liuyaoText(result) };
   }
@@ -663,6 +738,15 @@ function computeRaw(args = {}) {
     const result = buildNumerology({ year: dt.year, month: dt.month, day: dt.day });
     return { ...result, summary: numerologyText(result) };
   }
+  if (system === 'mbti') {
+    // 没给答案就先发问卷：让模型把 24 题交给用户逐题打分，而不是自己编一个类型
+    if (args.answers === undefined || args.answers === null) {
+      const paper = mbtiPaper();
+      return { ...paper, summary: mbtiPaperText(paper) };
+    }
+    const result = buildMbti({ answers: args.answers });
+    return { ...result, summary: mbtiText(result) };
+  }
   if (system === 'trend') {
     const dt = parseDateTime(args.datetime);
     const result = buildTrend({
@@ -703,12 +787,21 @@ function computeRaw(args = {}) {
   }
   if (system === 'name') {
     const action = args.action === 'generate' ? 'generate' : 'assess';
-    const birth = args.datetime ? parseDateTime(args.datetime) : {};
+    const birth = args.datetime
+      ? parseDateTime(args.datetime)
+      : (Number.isInteger(args.year) && Number.isInteger(args.month) && Number.isInteger(args.day)
+        ? {
+          year: args.year, month: args.month, day: args.day,
+          ...(Number.isInteger(args.hour) ? { hour: args.hour } : {}),
+          ...(Number.isInteger(args.minute) ? { minute: args.minute } : {}),
+        }
+        : {});
     const result = buildName({
       action,
       surname: args.surname,
       givenName: args.givenName,
       limit: args.limit,
+      charElements: args.charElements && typeof args.charElements === 'object' ? args.charElements : undefined,
       ...birth,
       ...(args.gender === 'male' || args.gender === 'female' ? { gender: args.gender } : {}),
       ...(args.datetime ? {
@@ -723,9 +816,9 @@ function computeRaw(args = {}) {
     return { ...result, summary: nameText(result) };
   }
   if (!system) {
-    throw fail('E_INPUT', '缺少 system，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）、almanac（黄历）、zeri（择日）、chenggu（称骨）、xiaoliuren（小六壬）、star（星座）、numerology（生命数字）、trend（人生 K 线）、fengshui（风水）、name（起名）、convert（公农历互转）。');
+    throw fail('E_INPUT', '缺少 system，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）、almanac（黄历）、zeri（择日）、chenggu（称骨）、xiaoliuren（小六壬）、star（星座）、numerology（生命数字）、mbti（十六型人格问卷）、trend（人生 K 线）、fengshui（风水）、name（起名）、convert（公农历互转）。');
   }
-  throw fail('E_SYSTEM', `未知体系「${system}」，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）、almanac（黄历）、zeri（择日）、chenggu（称骨）、xiaoliuren（小六壬）、star（星座）、numerology（生命数字）、trend（人生 K 线）、fengshui（风水）、name（起名）、convert（公农历互转）。`);
+  throw fail('E_SYSTEM', `未知体系「${system}」，可选：bazi（四柱八字）、ziwei（紫微斗数）、liuyao（六爻）、meihua（梅花易数）、daliuren（大六壬）、qimen（奇门遁甲）、hepan（合盘）、tarot（塔罗）、almanac（黄历）、zeri（择日）、chenggu（称骨）、xiaoliuren（小六壬）、star（星座）、numerology（生命数字）、mbti（十六型人格问卷）、trend（人生 K 线）、fengshui（风水）、name（起名）、convert（公农历互转）。`);
 }
 
 /** 黄历文本 */
@@ -831,6 +924,43 @@ function numerologyText(r) {
   ].join('\n');
 }
 
+/** 十六型人格文本 */
+function mbtiText(r) {
+  const dims = r.dims.map((d) => {
+    const side = d.picked === d.left ? d.leftSay : d.rightSay;
+    const pct = Math.round(d.pct * 100);
+    return `${d.left}/${d.right} 取 ${d.picked}（${d.strength} ${pct}%，净分 ${d.sum}）　${side}`;
+  });
+  const p = r.profile;
+  const stack = Array.isArray(p.stack) && p.stack.length
+    ? p.stack.map((f, i) => `${i === 0 ? '主导 ' : ''}${f.code}`).join(' → ') + `\n　${p.stack.map((f) => `${f.code}：${f.say}`).join('\n　')}`
+    : '';
+  return [
+    `【十六型人格】${r.type}（${p.title}）· ${p.keywords}　已答 ${r.answered}/${r.total} 题`,
+    `一句：${p.oneLine}`,
+    '【四维】',
+    ...dims,
+    `【优势】${p.strengths.join('；')}`,
+    `【留意】${p.blindspots.join('；')}`,
+    `【课题】${p.growth}`,
+    `【认知功能】${stack}`,
+    `【工作】${p.work}`,
+    `【关系】${p.love}`,
+    `【学习】${p.study}`,
+    `注：${r.note}`,
+  ].join('\n');
+}
+
+/** 问卷文本（还没答题时） */
+function mbtiPaperText(paper) {
+  return [
+    `【十六型人格问卷】${paper.total} 题，每题按 1（完全不像我）到 5（很像我）打分`,
+    ...paper.questions.map((q) => `${q.no}. ${q.text}`),
+    `请把 ${paper.total} 个分数按顺序交给 answers（如 [4,2,5,3,…]）；可以跳过某些题（填 null），至少答 12 题。`,
+    `注：${paper.note}`,
+  ].join('\n');
+}
+
 /** 人生 K 线文本 */
 function trendText(r) {
   const s = r.meta.strength;
@@ -886,9 +1016,18 @@ function nameText(r) {
       ...r.notes.map((n) => `※ ${n}`),
     ].join('\n');
   }
+  const srcLabel = (c) => (c.source === 'lib' ? '字库' : c.source === 'user' ? '用户指定' : '未收录');
+  const charLine = (c) => {
+    const el = c.element === '未收录' ? '未收录（不猜五行）' : `${c.element}（${srcLabel(c)}）`;
+    const fit = c.favorable === true ? '合喜用' : c.favorable === false ? '不合喜用' : '不判';
+    const sug = c.suggest && c.suggest.length
+      ? `　可换：${c.suggest.map((x) => `${x.char}（${x.element}）`).join('、')}`
+      : '';
+    return `· ${c.char}：${el}｜${fit}｜${c.meaning}${sug}`;
+  };
   return [
     `【名字评估】${r.fullName}`,
-    ...r.chars.map((c) => `· ${c.char}：五行 ${c.element}${c.element !== '未收录' ? `（喜用${c.favorable ? '中' : '外'}）` : ''}，${c.meaning}`),
+    ...r.chars.map(charLine),
     r.bazi ? `【八字】日主 ${r.bazi.dayMaster && r.bazi.dayMaster.stem ? `${r.bazi.dayMaster.stem}（${r.bazi.dayMaster.element}）` : r.bazi.dayMaster}，旺衰 ${r.bazi.strength.level}（${r.bazi.strength.score}），${r.bazi.basis}` : '',
     `【结论】${r.verdict}`,
     ...r.notes.map((n) => `※ ${n}`),