dsh-metaphysics 0.67.0 → 0.68.0

package/engine/wuyunliuqi.js

@@ -0,0 +1,426 @@
+// 五运六气（运气学说）· 本地确定性 · 通行口径
+//
+// 提供：运气年（大寒界）、年干支、岁运（中运）太过/不及、司天与在泉、主运/客运五步、
+// 主气/客气六步、当前所处的运与气、天符/岁会/同天符/同岁会/太乙天符，以及气候与病位倾向。
+//
+// 诚实边界：本文件只做「按规则推盘」这一层。运气学说里的方药、运气合参、
+// 《素问·六元正纪大论》六十年逐年全文与「刚柔失守」「升降不前」等推演未收录（见 scope）。
+// 病位与气候倾向照传统说法转述，是象征与经验归纳，不是医学判断。
+import { fail } from './fail.js';
+import {
+  STEMS, BRANCHES, termInstantJd, ganzhiName, formatJd,
+} from './calendar.js';
+import { assertCivil, daysInMonth } from './validate.js';
+
+/** 主气六步的固定次序（《素问·六微旨大论》）：厥阴 → 少阴 → 少阳 → 太阴 → 阳明 → 太阳。 */
+export const ZHU_QI_ORDER = ['厥阴风木', '少阴君火', '少阳相火', '太阴湿土', '阳明燥金', '太阳寒水'];
+
+/** 客气（三阴三阳）的轮转次序：厥阴 → 少阴 → 太阴 → 少阳 → 阳明 → 太阳。 */
+export const QI_ORDER = ['厥阴风木', '少阴君火', '太阴湿土', '少阳相火', '阳明燥金', '太阳寒水'];
+
+/** 主运五步的固定次序：木（角）→ 火（徵）→ 土（宫）→ 金（商）→ 水（羽）。 */
+export const ZHU_YUN_ORDER = ['木', '火', '土', '金', '水'];
+
+/** 天干化五运（《素问·天元纪大论》）：甲己化土、乙庚化金、丙辛化水、丁壬化木、戊癸化火。 */
+export const YUN_OF_STEM = {
+  甲: '土', 己: '土',
+  乙: '金', 庚: '金',
+  丙: '水', 辛: '水',
+  丁: '木', 壬: '木',
+  戊: '火', 癸: '火',
+};
+
+/** 地支化六气之「司天」（子午少阴、丑未太阴、寅申少阳、卯酉阳明、辰戌太阳、巳亥厥阴）。 */
+export const SITIAN_INDEX_OF_BRANCH = [1, 2, 3, 4, 5, 0];
+
+/** 五运的乐音与所主脏腑、气候（传统对应，只作命名与取象）。 */
+export const YUN_INFO = {
+  木: { tone: '角', organ: '肝', nature: '风', text: '木运' },
+  火: { tone: '徵', organ: '心', nature: '热', text: '火运' },
+  土: { tone: '宫', organ: '脾', nature: '湿', text: '土运' },
+  金: { tone: '商', organ: '肺', nature: '燥', text: '金运' },
+  水: { tone: '羽', organ: '肾', nature: '寒', text: '水运' },
+};
+
+/** 六气所主脏腑与气候。 */
+export const QI_INFO = {
+  厥阴风木: { wuxing: '木', organ: '肝', nature: '风', short: '风木' },
+  少阴君火: { wuxing: '火', organ: '心', nature: '热', short: '君火' },
+  太阴湿土: { wuxing: '土', organ: '脾', nature: '湿', short: '湿土' },
+  少阳相火: { wuxing: '火', organ: '三焦', nature: '火', short: '相火' },
+  阳明燥金: { wuxing: '金', organ: '肺', nature: '燥', short: '燥金' },
+  太阳寒水: { wuxing: '水', organ: '肾', nature: '寒', short: '寒水' },
+};
+
+/**
+ * 岁运太过/不及的取象：太过则本气偏胜、克其所胜；不及则本气不足、所不胜乘之。
+ * 每条都只写「传统上常这样描述」，不写「必然出现」。
+ */
+export const YUN_EFFECT = {
+  木: {
+    tai: { climate: '风气偏胜，草木早荣', organ: '肝气偏旺，脾土受克', sign: '易怒、胁胀、食少、肢体震颤' },
+    bu: { climate: '风气不足，燥气乘之', organ: '肝木不及，肺金偏胜', sign: '筋脉拘急、目干、情绪低落' },
+  },
+  火: {
+    tai: { climate: '火气偏胜，暑热早至', organ: '心火偏旺，肺金受克', sign: '心烦、失眠、咳喘、口疮' },
+    bu: { climate: '火气不足，寒气乘之', organ: '心火不及，肾水偏胜', sign: '心悸、畏寒、胸闷、精神不振' },
+  },
+  土: {
+    tai: { climate: '雨湿偏多，土气壅滞', organ: '脾湿偏胜，肾水受克', sign: '腹胀、身重、大便黏、四肢困倦' },
+    bu: { climate: '土气不足，风气乘之', organ: '脾土不及，肝木偏胜', sign: '飧泄、乏力、腹鸣、食后胀' },
+  },
+  金: {
+    tai: { climate: '燥气偏胜，天气清凉', organ: '肺燥偏胜，肝木受克', sign: '干咳、鼻干、皮肤干、筋急' },
+    bu: { climate: '金气不足，火气乘之', organ: '肺金不及，心火偏胜', sign: '咳逆、鼻塞、咽干、易感外邪' },
+  },
+  水: {
+    tai: { climate: '寒气偏胜，冰霜早降', organ: '肾寒偏胜，心火受克', sign: '畏寒、水肿、腰冷、心悸' },
+    bu: { climate: '水气不足，湿土乘之', organ: '肾水不及，脾土偏胜', sign: '腰膝无力、小便不利、下肢沉' },
+  },
+};
+
+/** 六气司天时传统上说的气候与病位（《素问·五常政大论》《至真要大论》通行转述）。 */
+export const QI_CLIMATE = {
+  厥阴风木: { climate: '风气流行，草木动摇', sign: '眩晕、抽搐、胁痛、过敏类症状偏多' },
+  少阴君火: { climate: '热气偏胜，暑热早来', sign: '心烦、口疮、失眠、咽痛偏多' },
+  太阴湿土: { climate: '湿气偏胜，阴雨多', sign: '腹胀、身重、泄泻、关节酸沉偏多' },
+  少阳相火: { climate: '火气偏胜，炎热', sign: '头痛、目赤、耳鸣、疮疡偏多' },
+  阳明燥金: { climate: '燥气偏胜，干燥少雨', sign: '干咳、鼻干、皮肤裂、便秘偏多' },
+  太阳寒水: { climate: '寒气偏胜，霜雪多', sign: '畏寒、关节痛、腹痛、水肿偏多' },
+};
+
+/** 本文件覆盖到哪一层。 */
+export const WUYUNLIUQI_SCOPE = {
+  covered: [
+    '运气年（大寒为界）与年干支',
+    '岁运（中运）五行与太过/不及、五音太少',
+    '司天、在泉',
+    '主运五步与客运五步（含每步起止时刻）',
+    '主气六步与客气六步（含每步起止时刻）',
+    '当前时刻所处的运与气',
+    '天符 / 岁会 / 同天符 / 同岁会 / 太乙天符',
+  ],
+  notCovered: [
+    '《素问·六元正纪大论》六十年逐年全文与「先立其年，以明其气」的逐气病证条辨',
+    '刚柔失守、升降不前、不迁正、不退位等岁气交司推演',
+    '运气合参的方药与针灸取穴',
+    '地域与体质差异对运气的修正',
+  ],
+  note: '病位、气候与症状倾向都是传统说法的转述，用来对照季节与身体感受，不是诊断结论。',
+};
+
+const YUN_DAYS = 365.25 / 5; // 73.05 日一运
+const QI_DAYS = 365.25 / 6; // 60.875 日一气
+
+function stemIndex(stem) {
+  const i = STEMS.indexOf(stem);
+  if (i < 0) throw fail('E_INPUT', `天干「${stem}」不在十干之内`);
+  return i;
+}
+
+function branchIndex(branch) {
+  const i = BRANCHES.indexOf(branch);
+  if (i < 0) throw fail('E_INPUT', `地支「${branch}」不在十二支之内`);
+  return i;
+}
+
+/** 公历年 → 该年干支（甲子起 1984，年界按立春，与八字侧同源）。 */
+export function yearGanzhiOf(year) {
+  const idx = (((year - 4) % 60) + 60) % 60;
+  return ganzhiName(idx);
+}
+
+/** 中运（岁运）：由年干化运，阳干太过、阴干不及。 */
+export function zhongyunOf(stem) {
+  const si = stemIndex(stem);
+  const wuxing = YUN_OF_STEM[stem];
+  const tai = si % 2 === 0; // 甲丙戊庚壬为阳干（索引 0/2/4/6/8）
+  const info = YUN_INFO[wuxing];
+  return {
+    gan: stem,
+    wuxing,
+    tone: info.tone,
+    tai,
+    name: `${wuxing}运${tai ? '太过' : '不及'}`,
+    taiShao: `${tai ? '太' : '少'}${info.tone}`,
+    organ: info.organ,
+    nature: info.nature,
+  };
+}
+
+/** 司天与在泉：由年支定，在泉为司天的对宫（相隔三步）。 */
+export function sitianOf(branch) {
+  const bi = branchIndex(branch);
+  const sitIdx = SITIAN_INDEX_OF_BRANCH[bi % 6];
+  const zaiIdx = (sitIdx + 3) % 6;
+  return {
+    sitIdx,
+    zaiIdx,
+    sitian: QI_ORDER[sitIdx],
+    zaiquan: QI_ORDER[zaiIdx],
+  };
+}
+
+/** 主运五步：初运木，按相生序，每步 73.05 日，从大寒起算。 */
+function zhuYunSteps(startJd) {
+  return ZHU_YUN_ORDER.map((wuxing, i) => {
+    const info = YUN_INFO[wuxing];
+    const start = startJd + i * YUN_DAYS;
+    const end = start + YUN_DAYS;
+    return {
+      no: i + 1,
+      wuxing,
+      name: `${wuxing}运`,
+      tone: info.tone,
+      taiShao: `太${info.tone}`,
+      startJd: start,
+      endJd: end,
+      startTime: formatJd(start),
+      endTime: formatJd(end),
+      days: Math.round(YUN_DAYS * 100) / 100,
+    };
+  });
+}
+
+/** 客运五步：以岁运为初运，按五行相生轮转，太少相生（太过生不及、不及生太过）。 */
+function keYunSteps(zhongyun, startJd) {
+  const startIdx = ZHU_YUN_ORDER.indexOf(zhongyun.wuxing);
+  return Array.from({ length: 5 }, (_, i) => {
+    const wuxing = ZHU_YUN_ORDER[(startIdx + i) % 5];
+    const info = YUN_INFO[wuxing];
+    const tai = i % 2 === 0 ? zhongyun.tai : !zhongyun.tai;
+    const start = startJd + i * YUN_DAYS;
+    const end = start + YUN_DAYS;
+    return {
+      no: i + 1,
+      wuxing,
+      tai,
+      name: `${wuxing}运${tai ? '太过' : '不及'}`,
+      tone: info.tone,
+      taiShao: `${tai ? '太' : '少'}${info.tone}`,
+      startTime: formatJd(start),
+      endTime: formatJd(end),
+    };
+  });
+}
+
+/** 主气六步：初之气厥阴风木，按固定次序，每步 60.875 日。 */
+function zhuQiSteps(startJd) {
+  return ZHU_QI_ORDER.map((qi, i) => {
+    const info = QI_INFO[qi];
+    const start = startJd + i * QI_DAYS;
+    const end = start + QI_DAYS;
+    return {
+      no: i + 1,
+      qi,
+      wuxing: info.wuxing,
+      organ: info.organ,
+      nature: info.nature,
+      name: `${qi}`,
+      startTime: formatJd(start),
+      endTime: formatJd(end),
+      days: Math.round(QI_DAYS * 100) / 100,
+    };
+  });
+}
+
+/** 客气六步：三之气为司天、终之气为在泉，初之气由司天倒退两步。 */
+function keQiSteps(sitIdx, startJd) {
+  const first = ((sitIdx - 2) % 6 + 6) % 6;
+  return Array.from({ length: 6 }, (_, i) => {
+    const qi = QI_ORDER[(first + i) % 6];
+    const info = QI_INFO[qi];
+    const start = startJd + i * QI_DAYS;
+    const end = start + QI_DAYS;
+    return {
+      no: i + 1,
+      qi,
+      wuxing: info.wuxing,
+      organ: info.organ,
+      nature: info.nature,
+      name: qi,
+      sitian: i === 2,
+      zaiquan: i === 5,
+      startTime: formatJd(start),
+      endTime: formatJd(end),
+    };
+  });
+}
+
+/** 年支的「本位五行」：子水午火卯木酉金、辰戌丑未土；寅申巳亥为长生位，不参与岁会。 */
+const BRANCH_BENWEI = {
+  子: '水', 午: '火', 卯: '木', 酉: '金',
+  辰: '土', 戌: '土', 丑: '土', 未: '土',
+  寅: null, 申: null, 巳: null, 亥: null,
+};
+
+/**
+ * 五运六气的「运气年」：以大寒为界（不是立春、不是正月初一）。
+ * 交大寒之前仍算上一运气年。
+ */
+export function yunYearOf(year, jd) {
+  const daHan = termInstantJd(year, 1);
+  if (jd >= daHan) {
+    return { nian: year, startJd: daHan, endJd: termInstantJd(year + 1, 1) };
+  }
+  return { nian: year - 1, startJd: termInstantJd(year - 1, 1), endJd: daHan };
+}
+
+/** 特殊格局：天符 / 岁会 / 同天符 / 同岁会 / 太乙天符。 */
+export function specialOf(zhongyun, sitian, zaiquan, branch) {
+  const yunWx = zhongyun.wuxing;
+  const sitWx = QI_INFO[sitian].wuxing;
+  const zaiWx = QI_INFO[zaiquan].wuxing;
+  const benwei = BRANCH_BENWEI[branch] || null;
+  const tianFu = yunWx === sitWx;
+  const suiHui = !!benwei && yunWx === benwei;
+  const tongTianFu = zhongyun.tai && yunWx === zaiWx;
+  const tongSuiHui = !zhongyun.tai && yunWx === zaiWx;
+  const taiYi = tianFu && suiHui;
+  const notes = [];
+  if (taiYi) {
+    notes.push('太乙天符：中运与司天同气、又与年支本位同气，传统上视为六十年里最「重」的一类年份之一，气候与病气的变化都容易被放大。');
+  } else if (tianFu) {
+    notes.push('天符：中运与司天同气。传统上说这一年本气专一而偏胜，气候变化来得整齐。');
+  }
+  if (suiHui) {
+    notes.push('岁会：中运与年支本位同气。传统上说这一年气令与地域相应，来得比较「正」。');
+  }
+  if (tongTianFu) {
+    notes.push('同天符：阳年太过之运与在泉同气，下半年（在泉主事）容易延续上半年的偏胜。');
+  }
+  if (tongSuiHui) {
+    notes.push('同岁会：阴年不及之运与在泉同气，本气本已不足，下半年又被同一气拖住，恢复更慢。');
+  }
+  return { tianFu, suiHui, tongTianFu, tongSuiHui, taiYi, notes };
+}
+
+/**
+ * 排一年的五运六气。
+ * @param {{year:number, month:number, day:number, hour?:number, minute?:number}} input
+ */
+export function buildWuyunliuqi(input) {
+  assertCivil(input, '五运六气');
+  const { year, month, day } = input;
+  if (day > daysInMonth(year, month)) {
+    throw fail('E_INPUT', `非法日期：${year} 年 ${month} 月没有 ${day} 日`);
+  }
+  const hour = Number.isInteger(input.hour) ? input.hour : 12;
+  const minute = Number.isInteger(input.minute) ? input.minute : 0;
+  if (hour < 0 || hour > 23) throw fail('E_INPUT', 'hour 要在 0–23 之间');
+  if (minute < 0 || minute > 59) throw fail('E_INPUT', 'minute 要在 0–59 之间');
+
+  // 当日正午的 jd 作参考点；有具体时刻时用它，判断「当前在第几气」更准
+  const jd = termInstantJd(year, 1) * 0
+    + (function () {
+      // 用公历日期构造本地时间轴 jd：以当日 00:00 为整数、按 24 小时折算
+      const jdn = (function (y, m, d) {
+        const a = Math.floor((14 - m) / 12);
+        const yy = y + 4800 - a;
+        const mm = m + 12 * a - 3;
+        return d + Math.floor((153 * mm + 2) / 5) + 365 * yy + Math.floor(yy / 4)
+          - Math.floor(yy / 100) + Math.floor(yy / 400) - 32045;
+      })(year, month, day);
+      return jdn - 0.5 + (hour * 60 + minute) / 1440;
+    })();
+
+  const yun = yunYearOf(year, jd);
+  const gz = yearGanzhiOf(yun.nian);
+  const zhongyun = zhongyunOf(gz.stem);
+  const sit = sitianOf(gz.branch);
+
+  const zhuYun = zhuYunSteps(yun.startJd);
+  const keYun = keYunSteps(zhongyun, yun.startJd);
+  const zhuQi = zhuQiSteps(yun.startJd);
+  const keQi = keQiSteps(sit.sitIdx, yun.startJd);
+
+  const dayInYear = jd - yun.startJd;
+  const yunNo = Math.min(5, Math.max(1, Math.floor(dayInYear / YUN_DAYS) + 1));
+  const qiNo = Math.min(6, Math.max(1, Math.floor(dayInYear / QI_DAYS) + 1));
+  const curZhuYun = zhuYun[yunNo - 1];
+  const curKeYun = keYun[yunNo - 1];
+  const curZhuQi = zhuQi[qiNo - 1];
+  const curKeQi = keQi[qiNo - 1];
+
+  const eff = YUN_EFFECT[zhongyun.wuxing][zhongyun.tai ? 'tai' : 'bu'];
+  const sitClimate = QI_CLIMATE[sit.sitian];
+  const zaiClimate = QI_CLIMATE[sit.zaiquan];
+  const special = specialOf(zhongyun, sit.sitian, sit.zaiquan, gz.branch);
+
+  // 客气加临主气：只看「同气 / 相生 / 相克」，给一层很轻的提示，不做病证条辨
+  const curKeQx = QI_INFO[curKeQi.qi].wuxing;
+  const curZhuQx = QI_INFO[curZhuQi.qi].wuxing;
+  const sheng = { 木: '火', 火: '土', 土: '金', 金: '水', 水: '木' };
+  const ke = { 木: '土', 土: '水', 水: '火', 火: '金', 金: '木' };
+  let lin = '相安';
+  if (curKeQx === curZhuQx) lin = '同气';
+  else if (sheng[curKeQx] === curZhuQx) lin = '客生主（顺）';
+  else if (sheng[curZhuQx] === curKeQx) lin = '主生客（泄）';
+  else if (ke[curKeQx] === curZhuQx) lin = '客克主（逆）';
+  else if (ke[curZhuQx] === curKeQx) lin = '主克客（从）';
+
+  const comboName = `${sit.sitian}司天 · ${zhongyun.name}`;
+  const comboText = `这一运气年是「${gz.name}」年：中运${zhongyun.name}（${zhongyun.taiShao}），${sit.sitian}司天、${sit.zaiquan}在泉。`
+    + `传统上把这样的组合读成「${eff.climate}」，司天一侧偏「${sitClimate.climate}」，在泉一侧偏「${zaiClimate.climate}」。`;
+
+  return {
+    system: 'wuyunliuqi',
+    meta: {
+      datetime: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')} ${String(hour).padStart(2, '0')}:${String(minute).padStart(2, '0')}`,
+      nian: yun.nian,
+      ganzhi: gz.name,
+      stem: gz.stem,
+      branch: gz.branch,
+      isYang: zhongyun.tai,
+      startTime: formatJd(yun.startJd),
+      endTime: formatJd(yun.endJd),
+      dayInYear: Math.round(dayInYear * 100) / 100,
+    },
+    year: {
+      ganzhi: gz.name,
+      stem: gz.stem,
+      branch: gz.branch,
+      nian: yun.nian,
+      startTime: formatJd(yun.startJd),
+      endTime: formatJd(yun.endJd),
+      note: '运气年以大寒为界：交大寒之前仍算上一运气年，与八字按立春定年柱不同。',
+    },
+    zhongyun: {
+      ...zhongyun,
+      effect: eff,
+      text: `中运${zhongyun.name}（${zhongyun.taiShao}），主${zhongyun.organ}，气候偏${zhongyun.nature}。`,
+    },
+    sitian: {
+      qi: sit.sitian,
+      ...QI_INFO[sit.sitian],
+      climate: sitClimate,
+      text: `${sit.sitian}司天：上半年（三之气起）主事，气候偏${QI_INFO[sit.sitian].nature}。`,
+    },
+    zaiquan: {
+      qi: sit.zaiquan,
+      ...QI_INFO[sit.zaiquan],
+      climate: zaiClimate,
+      text: `${sit.zaiquan}在泉：下半年（终之气）主事，气候偏${QI_INFO[sit.zaiquan].nature}。`,
+    },
+    zhuYun,
+    keYun,
+    zhuQi,
+    keQi,
+    current: {
+      dayInYear: Math.round(dayInYear * 100) / 100,
+      yunNo,
+      qiNo,
+      zhuYun: curZhuYun,
+      keYun: curKeYun,
+      zhuQi: curZhuQi,
+      keQi: curKeQi,
+      lin,
+      text: `此刻在第 ${yunNo} 运（主运${curZhuYun.name} / 客运${curKeYun.name}）、第 ${qiNo} 气（主气${curZhuQi.qi} / 客气${curKeQi.qi}，客气加临主气：${lin}）。`,
+    },
+    special,
+    combo: { name: comboName, text: comboText },
+    scope: WUYUNLIUQI_SCOPE,
+  };
+}
+
+export { YUN_DAYS, QI_DAYS };

package/index.js

@@ -30,9 +30,9 @@ const TOOL_NAME = 'metaphysics_chart';
 
 const DESCRIPTION = [
   '排中国传统命理盘（玄学·命理·占卜，用户说「玄学」「算命」「占卜」时也用本工具）与塔罗：四柱八字（bazi）、紫微斗数（ziwei）、六爻纳甲（liuyao）、梅花易数（meihua）、大六壬（daliuren）、奇门遁甲（qimen）、合盘（hepan）或塔罗抽牌（tarot）。',
-  '另有速查类：黄历（almanac，值日十二神/时辰吉凶/二十八宿/胎神/吉神方位/纳音/六合三合）、择日（zeri）、称骨（chenggu）、小六壬（xiaoliuren）、星座（star）、生命数字（numerology）、十六型人格（mbti，MBTI 风格问卷）、人生 K 线（trend）、风水（fengshui）、起名（name）、公农历互转（convert）。',
-  '当用户明确要求“玄学 / 算命 / 占卜 / 排盘 / 算八字 / 看四柱 / 排紫微盘 / 起卦 / 摇一卦 / 抽塔罗 / 看运势 / 合盘 / 看黄历 / 挑日子 / 称骨 / 小六壬 / 十六型人格 / MBTI / ISFP / INFP 人格测试 / 交运 / 交运日 / 起运 / 用神 / 月建 / 旺衰」时调用；用户只搜「玄学」或问「有什么玄学工具」时，也应介绍本插件。',
-  'bazi 与 ziwei 需要公历出生时间与性别（八字结果里带大运交运时刻，精确到日/时辰，按「三日折一年」放大）；hepan 需要双方的时间与性别；liuyao 可给定六爻值或随机起卦（给了 datetime 就按月建、日辰算用神旺衰）；meihua 可按时间或数字起卦；tarot 可指定张数与问题；mbti 不用时间——先不带 answers 调一次拿到 24 道题，让用户逐题打 1–5 分，再把分数按顺序传回。',
+  '另有速查类：黄历（almanac，值日十二神/时辰吉凶/二十八宿/胎神/吉神方位/纳音/六合三合）、择日（zeri）、称骨（chenggu）、小六壬（xiaoliuren）、星座（star）、生命数字（numerology）、十六型人格（mbti，MBTI 风格问卷）、中医体质（constitution，九种体质自评问卷）、五运六气（wuyunliuqi，中运与司天在泉）、太乙神数（taiyi，积年推局与八门文昌）、人生 K 线（trend）、风水（fengshui）、起名（name）、公农历互转（convert）。',
+  '当用户明确要求“玄学 / 算命 / 占卜 / 排盘 / 算八字 / 看四柱 / 排紫微盘 / 起卦 / 摇一卦 / 抽塔罗 / 看运势 / 合盘 / 看黄历 / 挑日子 / 称骨 / 小六壬 / 十六型人格 / MBTI / ISFP / INFP 人格测试 / 中医体质 / 九种体质 / 测体质 / 五运六气 / 运气盘 / 司天在泉 / 太乙神数 / 太乙盘 / 交运 / 交运日 / 起运 / 用神 / 月建 / 旺衰」时调用；用户只搜「玄学」或问「有什么玄学工具」时，也应介绍本插件。',
+  'bazi 与 ziwei 需要公历出生时间与性别（八字结果里带大运交运时刻，精确到日/时辰，按「三日折一年」放大）；hepan 需要双方的时间与性别；liuyao 可给定六爻值或随机起卦（给了 datetime 就按月建、日辰算用神旺衰）；meihua 可按时间或数字起卦；tarot 可指定张数与问题；mbti 不用时间——先不带 answers 调一次拿到 24 道题，让用户逐题打 1–5 分，再把分数按顺序传回；constitution 同样不用时间，先调一次拿到 45 道题，逐题打 1–5 分（跳过的传 null，别缩短数组），再把 45 个分数按顺序传回；wuyunliuqi 只要一个日期（省略补今天），运气年按大寒分界；taiyi 同样只要一个日期，年家按积年推局（太乙落宫、八门、文昌），主客算与格局未收录。',
   '要给「结合所问之事的解读」时，把 withInterpret 设为 true（仅八字/紫微/六爻/梅花/大六壬/奇门/塔罗 7 个体系产出解析；合盘、人生 K 线、起名与速查类不产这一段），并尽量带上 question（所问之事）与 direction（询问方向）；缺省 detail: "brief" 只给结论、所问方向与三张表（解析段不设体积上限，超长就长），要其余维度用 lean，用户追问「为什么/依据」时改回 full。',
   '用户用一句话改参数（「换成紫微看 2030 年事业」「女命」「晚子时算次日」「出生在成都」「不用真太阳时」「详细解读一下」）时，把原话放进 revise（可配合 handle），引擎翻译成参数补丁并在结果 revision 里回报改了哪些、没认哪些；不要自己把原话拆成猜测的参数。',
   '追问同一张盘：结果里有 handle，下次传 handle + 增量即可（例如 { handle, asOf: 2030 }、{ handle, withInterpret: true, question: "何时换工作" }、{ handle, system: "ziwei" } 看同一时间另一套盘），不必让用户重报出生信息；句柄带校验位，截断或改字会报 E_HANDLE。',
@@ -41,8 +41,8 @@ const DESCRIPTION = [
   '结果用于传统文化与娱乐参考，不得用于医疗、投资、法律、生死等确定性断言。',
 ].join('');
 
-/** 19 个体系的固定顺序：system 枚举与 help 索引共用 */
-const SYSTEM_ENUM = ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren', 'hepan', 'qimen', 'almanac', 'zeri', 'chenggu', 'xiaoliuren', 'star', 'numerology', 'mbti', 'trend', 'fengshui', 'name', 'convert'];
+/** 22 个体系的固定顺序：system 枚举与 help 索引共用 */
+const SYSTEM_ENUM = ['bazi', 'ziwei', 'liuyao', 'tarot', 'meihua', 'daliuren', 'hepan', 'qimen', 'almanac', 'zeri', 'chenggu', 'xiaoliuren', 'star', 'numerology', 'mbti', 'constitution', 'wuyunliuqi', 'taiyi', 'trend', 'fengshui', 'name', 'convert'];
 
 /**
  * 顶层只留通用参数：出生信息、解读开关、句柄与多数体系共用的分析项。
@@ -62,7 +62,7 @@ const OPTION_KEYS = [
   'lines', 'task', 'startDate', 'days', 'candidates', 'shengXiao',
   'lunarYear', 'lunarMonth', 'lunarDay', 'isLeapMonth', 'num1', 'num2', 'num3',
   'juMethod', 'lateZiHourMode', 'partner2', 'chart', 'rectifyHours',
-  'upper', 'lower', 'changing', 'count',
+  'upper', 'lower', 'changing', 'count', 'spread',
   'leapMonth', 'leapAsNext', 'brightnessSchool', 'gengYearSihua', 'tianmaSchool',
   'tiankongSchool', 'jiekongSchool', 'kuiyueSchool', 'tianshiTianshang',
   'changshengSchool', 'lateZishi', 'shenzhuSchool', 'mingzhuSchool', 'zuoyaoSchool', 'liunianSihua',
@@ -97,7 +97,8 @@ const OPTION_HINTS = {
   upper: '仅 meihua 数字起卦：定上卦的数，与 lower 成对',
   lower: '仅 meihua 数字起卦：定下卦的数',
   changing: '仅 meihua 数字起卦：手动指定动爻 1–6',
-  count: '仅 tarot：牌数 1 / 3 / 5，默认 3',
+  count: '仅 tarot：牌数 1 / 3 / 5，默认 3；给了 spread 时以 spread 为准',
+  spread: '仅 tarot：牌阵 one 单张 / three 过去现在未来 / five 五张局势 / celtic 凯尔特十字(10) / either 二选一(5) / relation 关系阵(7) / timeflow 时间流(3)',
   leapMonth: '仅 ziwei：闰月口径 split / next / prev',
   leapAsNext: '仅 ziwei：旧写法，true 等同 leapMonth=next',
   brightnessSchool: '仅 ziwei：十四主星亮度流派 default/QS/XD1/ZZ/XD2',
@@ -137,7 +138,7 @@ const OPTION_HINTS = {
   year: '仅 name：公历出生年，配合 month/day/hour',
   month: '仅 name：公历出生月 1–12',
   day: '仅 name：公历出生日 1–31',
-  answers: '仅 mbti：按题目顺序的 24 个 1–5 分，跳过传 null',
+  answers: '仅 mbti / constitution：按题目顺序的 1–5 分（mbti 24 题、体质 45 题），跳过传 null',
 };
 
 const BIRTH_KEYS = ['datetime', 'gender', 'address', 'geocode', 'longitude', 'trueSolar', 'lateZi', 'dst', 'asOf', 'shadow'];
@@ -148,7 +149,7 @@ const SYSTEM_PARAMS = {
   bazi: [...BIRTH_KEYS, 'hourUnknown', 'verifyPast', 'rectify', 'events', 'rectifyHours', 'cross', 'diff', 'trace', ...READ_KEYS],
   ziwei: [...BIRTH_KEYS, 'leapMonth', 'leapAsNext', 'brightnessSchool', 'gengYearSihua', 'tianmaSchool', 'tiankongSchool', 'jiekongSchool', 'kuiyueSchool', 'tianshiTianshang', 'changshengSchool', 'lateZishi', 'shenzhuSchool', 'mingzhuSchool', 'zuoyaoSchool', 'liunianSihua', 'sihuaVariant', 'jieluSchool', 'suipoSchool', 'cross', 'diff', 'trace', ...READ_KEYS],
   liuyao: ['datetime', 'lines', 'seed', 'trace', ...READ_KEYS],
-  tarot: ['count', 'seed', ...READ_KEYS],
+  tarot: ['spread', 'count', 'seed', ...READ_KEYS],
   meihua: ['datetime', 'mode', 'upper', 'lower', 'changing', ...READ_KEYS],
   daliuren: ['datetime', 'trace', ...READ_KEYS],
   hepan: [...BIRTH_KEYS, 'partner', 'partner2', 'chart', 'leapMonth', 'ask'],
@@ -159,7 +160,10 @@ const SYSTEM_PARAMS = {
   xiaoliuren: ['datetime', 'date', 'hour', 'mode', 'num1', 'num2', 'num3', 'lateZi', 'question', 'shadow'],
   star: ['datetime', 'shadow'],
   numerology: ['datetime', 'shadow'],
-  mbti: ['answers', 'shadow'],
+  mbti: ['answers', 'shadow'],
+  constitution: ['answers', 'shadow'],
+  wuyunliuqi: ['datetime', 'shadow'],
+  taiyi: ['datetime', 'shadow'],
   trend: ['datetime', 'gender', 'address', 'geocode', 'longitude', 'trueSolar', 'hourUnknown', 'toAge', 'asOf', 'shadow', 'ask'],
   fengshui: ['action', 'datetime', 'gender', 'sitting', 'facing', 'fortuneYear', 'period', 'sittingOffset', 'sittingDegree', 'facingOffset', 'facingDegree', 'fortuneDate', 'fortuneTime', 'dst', 'shadow'],
   name: ['action', 'datetime', 'surname', 'givenName', 'limit', 'charElements', 'strokeOverrides', 'surnameStrokes', 'year', 'month', 'day', 'hour', 'minute', 'gender', 'address', 'geocode', 'longitude', 'trueSolar', 'dst', 'shadow'],
@@ -181,7 +185,10 @@ const SYSTEM_REQUIRED = {
   xiaoliuren: 'time 模式 datetime/date+hour；number 模式 num1–num3',
   star: '无（省略补今天）',
   numerology: '无（省略补今天）',
-  mbti: '无（先不带 answers 拿题）',
+  mbti: '无（先不带 answers 拿题）',
+  constitution: '无（先不带 answers 拿 45 道题）',
+  wuyunliuqi: '无（省略则用今天；要算别的年份就传那年的日期）',
+  taiyi: '无（省略则用今天；年家按积年推局，给哪一年的日期就算哪一年）',
   trend: 'datetime、gender',
   fengshui: 'natal 要 datetime + gender；advise/xuankong 要 sitting 或 facing',
   name: 'assess 要 surname + givenName；generate 要生辰（datetime 或 year/month/day）',
@@ -558,7 +565,7 @@ export function apply(ctx) {
         system: {
           type: 'string',
           enum: SYSTEM_ENUM,
-          description: 'bazi = 四柱八字（含调候寒暖与《穷通宝鉴》120 格用神）；ziwei = 紫微斗数；liuyao = 六爻（纳甲、卦体关系、用神落位与月建日辰旺衰）；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需同时给 partner；qimen = 奇门遁甲（时家转盘，拆补法）；almanac = 黄历（某日宜忌/冲煞/建除/节气）；zeri = 择日（某事项在日期区间或候选日内逐日打分排序；宜忌依《协纪辨方书》卷十一「用事」逐条神煞，轻重依卷十「宜忌」六等与德神制化）；chenggu = 袁天罡称骨（骨重 + 通行本称骨歌原文 + 白话释义）；xiaoliuren = 小六壬（时间或报数起课）；star = 星座当日基调；numerology = 生命数字；mbti = 十六型人格（MBTI 风格 24 题问卷：给 answers 出类型，不给则先返回题目）；trend = 人生 K 线（大运/流年走势可视化）；fengshui = 风水（八宅命卦/流年飞星/门主灶布局/玄空下卦，action 三选一）；name = 起名（391 字库的用字五行评估与候选生成；未收录字可传 charElements 指定五行）；convert = 公农历互转（solar2lunar 公历转农历 / lunar2solar 农历转公历）。',
+          description: 'bazi = 四柱八字（含调候与《穷通宝鉴》用神）；ziwei = 紫微斗数；liuyao = 六爻（纳甲、用神与旺衰）；tarot = 塔罗；meihua = 梅花易数；daliuren = 大六壬；hepan = 合盘（合婚），需给 partner；qimen = 奇门遁甲（时家转盘，拆补法）；almanac = 黄历（某日宜忌/冲煞/建除/节气）；zeri = 择日（区间或候选日逐日打分；宜忌依《协纪辨方书》用事与六等轻重）；chenggu = 袁天罡称骨（骨重 + 称骨歌 + 白话）；xiaoliuren = 小六壬（时间或报数）；star = 星座当日基调；numerology = 生命数字；mbti = 十六型人格（24 题：给 answers 出类型，不给先返回题目）；constitution = 中医体质（九种各 5 题：给 answers 出主次，不给先返回题目）；wuyunliuqi = 五运六气（大寒界；中运太过不及、司天在泉、客运客气六步）；taiyi = 太乙神数（积年推局；太乙落宫、八门、文昌）；trend = 人生 K 线（大运/流年走势）；fengshui = 风水（八宅/飞星/门主灶/玄空，action 三选一）；name = 起名（391 字库五行评估与候选；未收录字传 charElements）；convert = 公农历互转（solar2lunar / lunar2solar）。',
         },
         datetime: {
           type: 'string',
@@ -771,7 +778,12 @@ export function apply(ctx) {
         count: {
           type: 'number',
           enum: [1, 3, 5],
-          description: '塔罗张数：1 单张指引、3 过去现在未来、5 十字牌阵。默认 3。',
+          description: '塔罗张数：1 单张指引、3 过去现在未来、5 五张局势。默认 3。给了 spread 时以 spread 为准。',
+        },
+        spread: {
+          type: 'string',
+          enum: ['one', 'three', 'five', 'celtic', 'either', 'relation', 'timeflow'],
+          description: '塔罗牌阵（按问法选，张数由牌阵决定）：one 单张指引｜three 过去现在未来｜five 五张局势｜celtic 凯尔特十字 10 张｜either 二选一 5 张（A 的发展/结果、B 的发展/结果）｜relation 关系阵 7 张（你/对方/现状/双方期待/阻碍/走向）｜timeflow 时间流 3 张（眼下/这阵子/往后）。不给则按 count。',
         },
         leapMonth: {
           type: 'string',

package/locale/en.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "Metaphysics Charts (Xuanxue)",
-    "description": "Chinese metaphysics (xuanxue) — nineteen systems in one plugin: eight chart systems plus eleven quick references (almanac, solar–lunar conversion, date selection, bone-weight fortune, Xiao Liu Ren, horoscope, numerology, MBTI-style 16-type questionnaire, life-curve, feng shui, name analysis). Chart systems: BaZi (hidden stems, ten gods, 12 stages, 42 shensha, strength, pattern and useful-god, luck scoring), Zi Wei Dou Shu (49 stars with brightness, four 12-god cycles, 34 patterns, decade and annual/monthly/daily/hourly mutagen), LiuYao, MeiHua YiShu, Da Liu Ren, Qi Men Dun Jia (three ju-selection schools), compatibility charts (BaZi and Zi Wei), and Tarot, plus an ask-driven interpretation layer. Computed locally with networking off by default, exposed as an agent tool with a Web panel."
+    "description": "Chinese metaphysics (xuanxue) — twenty-two systems in one plugin: eight chart systems plus eleven quick references (almanac, solar–lunar conversion, date selection, bone-weight fortune, Xiao Liu Ren, horoscope, numerology, MBTI-style 16-type questionnaire, life-curve, feng shui, name analysis), plus a nine-type TCM body-constitution questionnaire, five-movements-six-qi (wuyun liuqi) yearly chart, and Taiyi Shenshu (accumulated-year ju, palace, eight gates, Wen Chang). Chart systems: BaZi (hidden stems, ten gods, 12 stages, 42 shensha, strength, pattern and useful-god, luck scoring), Zi Wei Dou Shu (49 stars with brightness, four 12-god cycles, 34 patterns, decade and annual/monthly/daily/hourly mutagen), LiuYao, MeiHua YiShu, Da Liu Ren, Qi Men Dun Jia (three ju-selection schools), compatibility charts (BaZi and Zi Wei), and Tarot, plus an ask-driven interpretation layer. Computed locally with networking off by default, exposed as an agent tool with a Web panel."
   }
 }

package/locale/zh.json

@@ -1,6 +1,6 @@
 {
   "meta": {
     "title": "命理排盘（玄学）· 八字紫微六爻梅花六壬奇门合盘塔罗",
-    "description": "玄学命理排盘：十九套体系一站排盘——既有的八套排盘（八字、紫微、六爻、梅花、大六壬、奇门、合盘、塔罗）之外，另有十一套速查（黄历、农历互转、择日、称骨、小六壬、星座、生命数字、人生K线、风水、起名、十六型人格）：八字（藏干十神、十二长生、42 神煞、旺衰、格局用神、大运流年吉凶评分）、紫微斗数（49 星曜与主星庙旺、四层十二神、34 格局、大限、流年流月流日流时四化）、六爻纳甲、梅花易数、大六壬（天地盘/四课/三传）、奇门遁甲（拆补/超神接气/置闰三派取局）、合盘（八字与紫微两套）与塔罗；另有所问之事驱动的解析与详解。纯本地计算、默认不联网，作为 Agent 工具供对话调用，并提供可切换本命/大限/流年视图的 Web 面板。紫微含飞星串连与三方四正复合飞化，六爻含用神旺衰与全卦逐爻旺衰。"
+    "description": "玄学命理排盘：二十二套体系一站排盘——既有的八套排盘（八字、紫微、六爻、梅花、大六壬、奇门、合盘、塔罗）之外，另有十一套速查（黄历、农历互转、择日、称骨、小六壬、星座、生命数字、人生K线、风水、起名、十六型人格），以及中医体质问卷、五运六气与太乙神数：八字（藏干十神、十二长生、42 神煞、旺衰、格局用神、大运流年吉凶评分）、紫微斗数（49 星曜与主星庙旺、四层十二神、34 格局、大限、流年流月流日流时四化）、六爻纳甲、梅花易数、大六壬（天地盘/四课/三传）、奇门遁甲（拆补/超神接气/置闰三派取局）、合盘（八字与紫微两套）与塔罗；另有所问之事驱动的解析与详解。纯本地计算、默认不联网，作为 Agent 工具供对话调用，并提供可切换本命/大限/流年视图的 Web 面板。紫微含飞星串连与三方四正复合飞化，六爻含用神旺衰与全卦逐爻旺衰。"
   }
 }

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "dsh-metaphysics",
-  "version": "0.67.0",
+  "version": "0.68.0",
   "type": "module",
-  "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: nineteen systems and eleven quick references (almanac, solar–lunar conversion, …), with climate adjustment (tiaohou), the 120 Qiongtong Baojian entries, 1,062-char name library with per-character pinyin, Kangxi stroke counts, five-grid (五格/三才) analysis and mechanical phonetics checks, a 78-card tarot library on the Rider-Waite-Smith base (per-card English name, image description, core meaning and astrological correspondence, cross-checked against three published sources; court cards carry no zodiac by design and the chart says so), classical quotes (Ziping Zhenquan / Di Tian Sui / San Ming Tong Hui), hexagram body relations (六冲/六合/伏吟/反吟/化进神/化退神) plus yongshen placement (用神落位) with month/day strength (月建日辰旺衰) and whole-hexagram per-line strength (全卦逐爻旺衰) and response-time clues (应期线索：逢值/逢冲/逢合 + 月建五态快慢) for liuyao, plus an MBTI-style 16-type questionnaire and exact dayun handover dates (交运日) with annual suiyun hints (岁运并临/伏吟反吟), palace conditions (击刑/入墓), month states (旺相休囚死) and stem–palace relations (天盘干与宫生克) for qimen, flying four-transformations with chained flights (四化飞星串连), three-way-four-corner composite flights (三方四正复合飞化), switchable leap-month policy (闰月按日切分/整月归次月/整月归本月) eleven school switches (亮度/庚干四化/天马/天空/截空旬空/魁钺/天伤天使/长生/晚子时/身主/杂曜全表) for ziwei, the last one opting in to a 61-star minor-star (杂曜) table where each of the twelve extra stars carries its placement verse and the palace it landed in (verses accepted only when at least two independent published editions give the same table, homonymous stars never merged), caliber diffs for bazi/ziwei/qimen (same inputs, one switch, root-field changes), shadow-chart IDs (same normalized params → same ID; version bumps auto-diff chart fields), step-by-step deduction traces (liuyao najia→liuqin→shiying→fushen→strength; bazi strength score and pattern/yongshen; ziwei pattern conditions), and a bundled offline single-file page (命理排盘.html), a panel-to-chat handoff that asks the Harness about a finished chart, per-tab lazy engine chunks so the first-screen client bundle stays under 100KB gzip, and a public verification report (128 classical hexagram cases, 312 Zi Wei charts × 34 patterns, 12 dayun handover cases) generated from the same source that gates CI.",
+  "description": "命理排盘（玄学 xuanxue）for DeepSeek Harness: twenty-two systems and eleven quick references (almanac, solar–lunar conversion, …), with climate adjustment (tiaohou), the 120 Qiongtong Baojian entries, 1,062-char name library with per-character pinyin, Kangxi stroke counts, five-grid (五格/三才) analysis and mechanical phonetics checks, a 78-card tarot library on the Rider-Waite-Smith base (per-card English name, image description, core meaning and astrological correspondence, cross-checked against three published sources; court cards carry no zodiac by design and the chart says so), classical quotes (Ziping Zhenquan / Di Tian Sui / San Ming Tong Hui), hexagram body relations (六冲/六合/伏吟/反吟/化进神/化退神) plus yongshen placement (用神落位) with month/day strength (月建日辰旺衰) and whole-hexagram per-line strength (全卦逐爻旺衰) and response-time clues (应期线索：逢值/逢冲/逢合 + 月建五态快慢) for liuyao, plus an MBTI-style 16-type questionnaire and exact dayun handover dates (交运日) with annual suiyun hints (岁运并临/伏吟反吟), palace conditions (击刑/入墓), month states (旺相休囚死) and stem–palace relations (天盘干与宫生克) for qimen, flying four-transformations with chained flights (四化飞星串连), three-way-four-corner composite flights (三方四正复合飞化), switchable leap-month policy (闰月按日切分/整月归次月/整月归本月) eleven school switches (亮度/庚干四化/天马/天空/截空旬空/魁钺/天伤天使/长生/晚子时/身主/杂曜全表) for ziwei, the last one opting in to a 61-star minor-star (杂曜) table where each of the twelve extra stars carries its placement verse and the palace it landed in (verses accepted only when at least two independent published editions give the same table, homonymous stars never merged), caliber diffs for bazi/ziwei/qimen (same inputs, one switch, root-field changes), shadow-chart IDs (same normalized params → same ID; version bumps auto-diff chart fields), step-by-step deduction traces (liuyao najia→liuqin→shiying→fushen→strength; bazi strength score and pattern/yongshen; ziwei pattern conditions), and a bundled offline single-file page (命理排盘.html), a panel-to-chat handoff that asks the Harness about a finished chart, per-tab lazy engine chunks so the first-screen client bundle stays under 110KB gzip, and a public verification report (128 classical hexagram cases, 312 Zi Wei charts × 34 patterns, 12 dayun handover cases) generated from the same source that gates CI.",
   "keywords": [
     "玄学",
     "玄学排盘",