dsh-metaphysics 0.46.5 → 0.50.1

package/engine/almanac.js

@@ -3,9 +3,10 @@
 // 提供：农历日期、年/月/日干支（年按立春界，另列春节界生肖）、节气、建除十二神、
 // 冲煞（冲什么生肖 / 煞在何方）、财神与喜神方位、建除简表宜忌、每日一卦。
 //
-// 诚实边界：本插件不依赖 lunar-javascript，逐日神煞（吉神凶煞）、二十八宿值日、
-// 彭祖百忌、胎神等全量黄历数据未收录——输出里如实标注「未收录」，不臆造。
-// 宜忌只按「建除十二神」通行简表给出（传统择日的第一层判据），不是逐日全量黄历。
+// 诚实边界：本插件不依赖 lunar-javascript；逐日全量吉神凶煞与彭祖百忌未收录——
+// 输出里如实标注「未收录」，不臆造。值日十二神、二十八宿、胎神、吉神方位按通行表收录
+// （见返回值的 scope）。宜忌只按「建除十二神」通行简表给出（传统择日的第一层判据），
+// 不是逐日全量黄历。
 import { solarToLunar } from './lunar.js';
 import { nayinOf } from './nayin.js';
 import {
@@ -110,7 +111,7 @@ export function tianShenOf(branch, anchorBranch) {
   return { name, type, luck: type === '黄道' ? '吉' : '凶' };
 }
 
-/** 二十八宿：值日宿按「日支 + 星期」轮转（四组各七宿）。 */
+/** 二十八宿：值日宿按「日支 + 星期」轮转（四组各七宿）。宿名按通行「宿·五行·动物」写法（壁水貐、胃土雉）。 */
 export const MANSIONS = {
   角: { luck: '吉', zheng: '木', animal: '蛟', gong: '东' }, 亢: { luck: '凶', zheng: '金', animal: '龙', gong: '东' },
   氐: { luck: '凶', zheng: '土', animal: '貉', gong: '东' }, 房: { luck: '吉', zheng: '日', animal: '兔', gong: '东' },
@@ -118,9 +119,9 @@ export const MANSIONS = {
   箕: { luck: '吉', zheng: '水', animal: '豹', gong: '东' }, 斗: { luck: '吉', zheng: '木', animal: '獬', gong: '北' },
   牛: { luck: '凶', zheng: '金', animal: '牛', gong: '北' }, 女: { luck: '凶', zheng: '土', animal: '蝠', gong: '北' },
   虚: { luck: '凶', zheng: '日', animal: '鼠', gong: '北' }, 危: { luck: '凶', zheng: '月', animal: '燕', gong: '北' },
-  室: { luck: '吉', zheng: '火', animal: '猪', gong: '北' }, 壁: { luck: '吉', zheng: '水', animal: '獝', gong: '北' },
+  室: { luck: '吉', zheng: '火', animal: '猪', gong: '北' }, 壁: { luck: '吉', zheng: '水', animal: '貐', gong: '北' },
   奎: { luck: '凶', zheng: '木', animal: '狼', gong: '西' }, 娄: { luck: '吉', zheng: '金', animal: '狗', gong: '西' },
-  胃: { luck: '吉', zheng: '土', animal: '彘', gong: '西' }, 昴: { luck: '凶', zheng: '日', animal: '鸡', gong: '西' },
+  胃: { luck: '吉', zheng: '土', animal: '雉', gong: '西' }, 昴: { luck: '凶', zheng: '日', animal: '鸡', gong: '西' },
   毕: { luck: '吉', zheng: '月', animal: '乌', gong: '西' }, 觜: { luck: '凶', zheng: '火', animal: '猴', gong: '西' },
   参: { luck: '吉', zheng: '水', animal: '猿', gong: '西' }, 井: { luck: '吉', zheng: '木', animal: '犴', gong: '南' },
   鬼: { luck: '凶', zheng: '金', animal: '羊', gong: '南' }, 柳: { luck: '凶', zheng: '土', animal: '獐', gong: '南' },

package/engine/bazi.js

@@ -28,6 +28,24 @@ export const HIDDEN_STEMS = {
   亥: ['壬', '甲'],
 };
 
+// 人元司权的 30 日表：余气 → 中气 → 本气，按「节」当日起算。
+// 各家对日数分法不一（另有 7/7/16、9/3/18 等），这里固定通行 30 日表；
+// 只作解释层的一层细节，不参与取格。亥月的余气戊不在本柱藏干表中，两表各照原样。
+export const RENYUAN_TABLE = {
+  寅: [['戊', 7], ['丙', 7], ['甲', 16]],
+  卯: [['甲', 10], ['乙', 20]],
+  辰: [['乙', 9], ['癸', 3], ['戊', 18]],
+  巳: [['戊', 5], ['庚', 9], ['丙', 16]],
+  午: [['丙', 10], ['己', 9], ['丁', 11]],
+  未: [['丁', 9], ['乙', 3], ['己', 18]],
+  申: [['戊', 7], ['壬', 3], ['庚', 20]],
+  酉: [['庚', 10], ['辛', 20]],
+  戌: [['辛', 9], ['丁', 3], ['戊', 18]],
+  亥: [['戊', 7], ['甲', 5], ['壬', 18]],
+  子: [['壬', 10], ['癸', 20]],
+  丑: [['癸', 9], ['辛', 3], ['己', 18]],
+};
+
 export const STEM_ELEMENT = {
   甲: '木', 乙: '木', 丙: '火', 丁: '火', 戊: '土',
   己: '土', 庚: '金', 辛: '金', 壬: '水', 癸: '水',
@@ -204,6 +222,45 @@ export function applyTrueSolar(jd, longitude) {
   };
 }
 
+/**
+ * 人元司权：生在本月第几日、哪一藏干当权。
+ * 日数按「节令日」与出生日的日差计，节当日为第 1 日；固定 30 日表，
+ * 第 31 日以后不再硬分摊，按本气算并标 beyond。
+ * @param {string} monthBranch 月支（寅…丑）
+ * @param {number} birthJdn 出生日的儒略日数（含真太阳时修正后的日）
+ * @param {number} termJd 本月「节」的儒略日
+ */
+export function renyuanOf(monthBranch, birthJdn, termJd) {
+  const table = RENYUAN_TABLE[monthBranch];
+  if (!table) return null;
+  const segments = [];
+  let from = 1;
+  for (const [stem, days] of table) {
+    segments.push({ stem, element: STEM_ELEMENT[stem], from, to: from + days - 1 });
+    from += days;
+  }
+  const tableDays = from - 1;
+  const day = Math.max(1, Math.floor(birthJdn) - Math.floor(termJd + 0.5) + 1);
+  const beyond = day > tableDays;
+  const idx = beyond ? segments.length - 1 : segments.findIndex((s) => day >= s.from && day <= s.to);
+  const seg = segments[idx] || segments[segments.length - 1];
+  const next = segments[idx + 1] || null;
+  return {
+    month: monthBranch,
+    day,
+    tableDays,
+    segments,
+    active: seg.stem,
+    activeElement: seg.element,
+    segment: { from: seg.from, to: seg.to },
+    next: next ? { stem: next.stem, element: next.element, from: next.from, inDays: next.from - day } : null,
+    // 司权表与本柱藏干表口径不同：亥月的余气戊只出现在司权表里
+    inHidden: (HIDDEN_STEMS[monthBranch] || []).includes(seg.stem),
+    beyond,
+    note: '人元司权按「节」当日起算，节当日为第 1 日，日差用本盘所用时刻（含真太阳时）所在日计；本插件固定 30 日表（余气 → 中气 → 本气），第 31 日以后按本气算。只作解释层的一层细节，不改取格。',
+  };
+}
+
 /**
  * 排四柱八字
  * @param {object} input { year,month,day,hour,minute, gender:'male'|'female', longitude?, lateZi?:boolean, trueSolar?:boolean }
@@ -526,6 +583,10 @@ export function buildBazi(input) {
   const bodyStemIdx = (yinStem + ((bodyIdx - 2 + 12) % 12)) % 10;
   const shengong = ganzhiName(sexagenaryIndex(bodyStemIdx, bodyIdx));
 
+  // 人元司权：按节令到出生日的日差定当权藏干（节当日为第 1 日）
+  const renyuan = renyuanOf(BRANCHES[monthBranchIdx], jdnBase, prevJieTerm.jd);
+  if (renyuan) renyuan.term = { name: prevJieTerm.name, time: formatJd(prevJieTerm.jd) };
+
   return {
     system: 'bazi',
     relations: buildRelations(pillars),
@@ -558,6 +619,7 @@ export function buildBazi(input) {
       // 与 NAOJ 历要项对拍实测节气最多偏 13.5 分钟，20 分钟留出余量。
       nearBoundaryMinutes: Math.round(Math.min(jd - prevJieTerm.jd, nextJieTerm.jd - jd) * 1440),
     },
+    renyuan,
     pillars,
     dayMaster: { stem: dayStem, element: STEM_ELEMENT[dayStem], yinYang: isYangStem(dayStem) ? '阳' : '阴' },
     wuxing,

package/engine/classics.js

@@ -121,6 +121,16 @@ export const CLASSICS = [
     plain: '成格不等于一路顺：成中带忌（官逢财又逢伤、官被合之类）就打了折；败格也未必无救——印来解伤、合来清煞，败中还能转成。',
     url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53629.html',
   },
+  {
+    id: 'zp-zaji',
+    book: 'ziping',
+    chapter: '十六、论杂气如何取用',
+    scene: '用神',
+    tags: [],
+    quote: '何谓透干？如甲生辰月，透戊则用偏财，透癸则用正印，透乙则用月劫是也。何谓会支？如甲生辰月，逢申与子会局，则用水印是也。一透则一用，兼透则兼用，透而又会，则透与会并用。',
+    plain: '四墓（辰戌丑未）所藏不止一气，所以叫杂气：取用先看哪一藏干透到天干，透一个用一个；没有透干，再看地支有没有与月支会成三合局，会成什么局就取局中那一气。透干与会支同时成立时两样并用。原文对「兼透」只给原则，没有给取舍次序。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/zipingzhenquan/53636.html',
+  },
   {
     id: 'zp-bianhua',
     book: 'ziping',
@@ -397,6 +407,20 @@ export const CLASSICS = [
     plain: '从财格要财会成局、日干无气；一见根气就破格，原文用「命损无猜」这种重话写明。以丁生酉月、柱多庚辛为例：只能弃命相从，行北方财官旺地为入格，南行则灾。',
     url: 'https://www.diancang.xyz/xuanxuewushu/sanmingtonghui/7652.html',
   },
+  // —— 三命通会 · 总论岁运：岁运提示一节的原文出处。
+  // 原文的「返吟 / 伏吟」按「岁运与日柱相对 / 岁运压日」说，与本插件「干支相同为伏吟、天克地冲为反吟」
+  // 不是同一套定义；口径照本插件，原文照录不改写，两者在 plain 里并列说明。
+  // 这一条不进五条上限的取条表：它只在盘面有岁运信号时随「岁运提示」一起出现。
+  {
+    id: 'smt-suiyun',
+    book: 'sanming',
+    chapter: '卷二·总论岁运',
+    scene: '岁运',
+    tags: [],
+    quote: '行运以生月为运元，最怕行运与太岁冲克，若岁运冲月必祸；若岁运与日相对，谓之返吟，岁运压日，谓之伏吟，二者不利六亲，非横破财，不为吉兆。',
+    plain: '大运以生月为起点，最怕与流年（太岁）冲克：原文说岁运冲月为祸，又把「岁运与日柱相对」叫返吟、「岁运压日」叫伏吟。这两句是按「对日柱」说的，与本插件「干支相同为伏吟、天克地冲为反吟」不是同一套定义（本插件取后者）；末句「不利六亲、破财」是旧说的重话，只作变动提示，不作断语。',
+    url: 'https://www.diancang.xyz/xuanxuewushu/sanmingtonghui/7539.html',
+  },
 ];
 
 const BY_ID = CLASSICS.reduce((m, e) => { m[e.id] = e; return m; }, {});
@@ -433,6 +457,14 @@ export function classicOf(id) {
   return BY_ID[id] || null;
 }
 
+// 岁运提示的原文：盘面出现岁运并临 / 运年反吟 / 流年伏吟反吟时随该节给出，不占五条上限。
+// 没有信号就不给——这段原文讲的正是冲克，没冲没克时挂出来只会误导。
+export function suiyunClassicOf(r) {
+  const liunian = r && Array.isArray(r.liunian) ? r.liunian : [];
+  const hit = liunian.some((l) => l && l.suiyun && Array.isArray(l.suiyun.signals) && l.suiyun.signals.length);
+  return hit ? classicOf('smt-suiyun') : null;
+}
+
 function tagOf(gejuName) {
   const name = String(gejuName || '');
   if (GEJU_KEY[name]) return GEJU_KEY[name];
@@ -451,7 +483,8 @@ function chapterTitle(e) {
 }
 
 // 根据一张八字结果挑原文：特殊结构（专旺/从格）先取单章，再月令格（子平真诠 + 三命通会对照），
-// 再调候（寒暖/燥湿），最后「用神总纲」一位按盘取：有化气格取论用神变化、见组合取论用神成败救应、其余取通用总纲；去重、限量。
+// 再调候（寒暖/燥湿），最后「用神总纲」一位按盘四选一：有化气格取论用神变化、辰戌丑未月取论杂气如何取用、
+// 见组合取论用神成败救应、其余取通用总纲；去重、限量。
 export function classicsFor(r, limit = 5) {
   if (!r) return [];
   const out = [];
@@ -489,12 +522,16 @@ export function classicsFor(r, limit = 5) {
   if (tgEntry) {
     push(tgEntry, `本盘忌${tg.foe}克用${tg.use}，局中${tg.bridge}${tg.weight}分可作通关，故取${CLASSIC_BOOKS.ditian.name}「通关」一条`);
   }
-  // 用神总纲位只放一条：同一个格，化气看「变化」、有组合看「成败救应」，都没有才回到四吉四凶总纲。
-  // 不另加位次，是因为格局两条 + 气候两条正好占满 5 条上限；总纲与具体结构二选一，避免泛论挤掉针对这张盘的话。
+  // 用神总纲位只放一条，按盘四选一：化气看「变化」、四墓杂气看「杂气取用」、有组合看「成败救应」，
+  // 都没有才回到四吉四凶总纲。不另加位次，是因为格局两条 + 气候两条正好占满 5 条上限。
   const huagi = gejuList.find((g) => g && g.kind === '化气格');
   const combo = gejuList.find((g) => g && g.kind === '组合');
+  const monthBranch = r.monthBranch || (r.frame && r.frame.monthBranch) || (r.pillars && r.pillars.month && r.pillars.month.branch);
+  const zaMonth = ['辰', '未', '戌', '丑'].includes(monthBranch);
   if (huagi) {
     push(classicOf('zp-bianhua'), `本盘列有「${huagi.name}」：用神由月令合化而变，总纲一位改取${CLASSIC_BOOKS.ziping.name}论用神变化`);
+  } else if (zaMonth) {
+    push(classicOf('zp-zaji'), `月令${monthBranch}属四墓杂气，取用先看透干、再看会支，总纲一位取${CLASSIC_BOOKS.ziping.name}论杂气如何取用`);
   } else if (combo) {
     push(classicOf('zp-chengbai'), `本盘另有「${combo.name}」组合：成格还要看带忌与救应，总纲一位改取${CLASSIC_BOOKS.ziping.name}论用神成败救应`);
   } else {

package/engine/crosscheck.js

@@ -106,16 +106,33 @@ export function crossCheck(bazi, zw) {
     const bad = ['忌', '大忌'];
     const baziGood = good.includes(t);
     const baziBad = bad.includes(t);
+    const baziKnown = t !== '—';
     const ziweiHeavy = sha >= 2;
+    const ziweiKnown = !!d;
     let stance = '有张力';
-    let note = '一边顺、一边压，按「大方向跟顺的一边、具体动作避开压的年份」处理';
-    if ((baziGood && !ziweiHeavy) || (baziBad && ziweiHeavy) || (!baziGood && !baziBad && !ziweiHeavy)) {
+    let note = '';
+    if (!baziKnown || !ziweiKnown) {
+      // 一边没取到就谈不上「同向 / 有张力」——只并列现有的一侧，并写清缺的是哪边
+      stance = '互补';
+      const missing = !baziKnown && !ziweiKnown
+        ? '八字当前大运与紫微当前大限都没取到'
+        : !baziKnown
+          ? `八字当前大运未取到（${t}），只有紫微一侧可参考`
+          : '紫微当前大限未取到，只有八字一侧可参考';
+      note = `${missing}：这一项只作提醒，不下两边对照的结论`;
+    } else if (baziGood && ziweiHeavy) {
+      note = '八字这边顺、紫微大限煞星偏多：大方向可参考八字，具体动作按紫微标出的位置收一收';
+    } else if (baziBad && !ziweiHeavy) {
+      note = '八字这边偏紧、紫微大限没见到明显煞星：先按八字收着走，紫微一侧的平静不等于没有压力';
+    } else if (!baziGood && !baziBad && ziweiHeavy) {
+      note = '八字大运为平、紫微大限煞星偏多：只把紫微这一侧当作提醒，不据此判断阶段好坏';
+    } else {
       stance = '同向';
       note = '两边对当前阶段的松紧判断接近';
     }
     push('rhythm', '当前节奏',
       `大运档位 ${t}`,
-      `${d ? `大限在${d.palace}` : '大限未取到'}${sha ? `；煞星 ${sha} 颗` : '；无煞星'}`,
+      d ? `大限在${d.palace}${sha ? `；煞星 ${sha} 颗` : '；无煞星'}` : '大限未取到',
       stance, note);
   }
 
@@ -131,3 +148,12 @@ export function crossText(cross) {
     .map((i) => `· ${i.label}：八字——${i.bazi}；紫微——${i.ziwei}；判断：${i.stance}（${i.note}）`)
     .join('\n');
 }
+
+/**
+ * 交叉验证分节。文本给 Markdown/工具输出，items 给面板画对照卡——
+ * 同一份数据两个去处，免得面板再去拆文本。
+ */
+export function crossSection(cross) {
+  const items = cross && Array.isArray(cross.items) ? cross.items : [];
+  return { key: 'crossSystem', label: '八字 × 紫微 交叉验证', text: crossText(cross), items };
+}

package/engine/geju.js

@@ -9,6 +9,7 @@
 
 import { judgeClimate, arbitrate } from './tiaohou.js';
 import { qtOf } from './qiongtong.js';
+import { sanheGroupOf } from './sanhe.js';
 
 const STEMS = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
 const BRANCHES = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
@@ -87,6 +88,25 @@ export function elementRoles(dayStem) {
 
 // ── 月令格 ───────────────────────────────────────────────────
 
+// 四墓（杂气）月：辰戌丑未所藏多、用神不一，取用先看透干，再看会支。
+// 会支只认三合局——子平真诠十六「逢申与子会局」的例子即三合，三会方与兼透兼用仍不纳入。
+const ZA_MONTHS = ['辰', '未', '戌', '丑'];
+
+function huiCandidate(pillars, monthBranch, cands) {
+  if (!ZA_MONTHS.includes(monthBranch)) return null;
+  const group = sanheGroupOf(monthBranch);
+  if (!group) return null;
+  const others = ['year', 'day', 'hour'];
+  const need = group.branches.filter((b) => b !== monthBranch);
+  if (!need.every((b) => others.some((k) => pillars[k].branch === b))) return null;
+  const cand = cands.find((c) => STEM_ELEMENT[c.stem] === group.element);
+  if (!cand) return null;
+  const where = others
+    .filter((k) => need.includes(pillars[k].branch))
+    .map((k) => `${({ year: '年', day: '日', hour: '时' })[k]}支${pillars[k].branch}`);
+  return { ...cand, group, where };
+}
+
 function monthPattern(pillars, dayStem, monthBranch) {
   const hidden = HIDDEN[monthBranch] || [];
   const cands = hidden.map((stem, i) => ({
@@ -98,10 +118,13 @@ function monthPattern(pillars, dayStem, monthBranch) {
   const others = ['year', 'month', 'hour'];
   const exposedKey = others.find((k) => cands.some((c) => c.stem === pillars[k].stem));
   const base = cands[0];
-  const use = exposedKey ? cands.find((c) => c.stem === pillars[exposedKey].stem) : base;
+  const hui = exposedKey ? null : huiCandidate(pillars, monthBranch, cands);
+  const use = exposedKey ? cands.find((c) => c.stem === pillars[exposedKey].stem) : (hui || base);
+  const usedBy = exposedKey ? '透干' : (hui ? '会支' : '本气');
   const exposedPos = exposedKey ? { year: '年', month: '月', hour: '时' }[exposedKey] : null;
 
-  if (base.god === '比肩') {
+  // 建禄只认日干的禄位；戊土辰月、己土未月这类「本气比肩但不在禄位」的杂气月不再冒称建禄
+  if (base.god === '比肩' && LUSHEN_BRANCH[dayStem] === monthBranch) {
     return {
       name: '建禄格',
       kind: '月令格',
@@ -118,10 +141,31 @@ function monthPattern(pillars, dayStem, monthBranch) {
     }
     return { name: '月劫格', kind: '月令格', evidence: `月令${monthBranch}本气${base.stem}为劫财` };
   }
+  if (usedBy === '本气' && base.god === '比肩') {
+    return {
+      name: '比肩格',
+      kind: '月令格',
+      evidence: `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}为比肩，但${dayStem}禄在${LUSHEN_BRANCH[dayStem]}、不在${monthBranch}，属杂气月比肩当权`,
+    };
+  }
+  // 子平十六：「透乙则用月劫」——杂气月由透干或会支取到劫财时，仍作月劫论
+  if (usedBy !== '本气' && use.god === '劫财') {
+    const via = exposedKey ? `透于${exposedPos}干` : `${hui.where.join('、')}会成${hui.group.element}局`;
+    return {
+      name: '月劫格',
+      kind: '月令格',
+      evidence: `月令${monthBranch}藏${hidden.join('')}，${use.pos}${use.stem}（劫财）${via}，劫财为用，作月劫论`,
+    };
+  }
   const name = `${use.god}格`;
-  const ex = exposedKey
-    ? `月令${monthBranch}藏${hidden.join('')}，${use.pos}${use.stem}（${use.god}）透于${exposedPos}干`
-    : `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}（${base.god}）未透干，以月令本气取格`;
+  let ex;
+  if (exposedKey) {
+    ex = `月令${monthBranch}藏${hidden.join('')}，${use.pos}${use.stem}（${use.god}）透于${exposedPos}干`;
+  } else if (hui) {
+    ex = `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}（${base.god}）未透干，而${hui.where.join('、')}会成${hui.group.element}局，取${use.pos}${use.stem}（${use.god}）为用`;
+  } else {
+    ex = `月令${monthBranch}藏${hidden.join('')}，本气${base.stem}（${base.god}）未透干，以月令本气取格`;
+  }
   return { name, kind: '月令格', evidence: ex };
 }
 

package/engine/index.js

@@ -1,6 +1,6 @@
 // 统一入口：解析参数、分派到各体系、生成可读摘要
 import { buildBazi } from './bazi.js';
-import { buildLiuyao, tossLines, bodyLabels, yongshenOf, yongshenStrength, fushenAccess, hexagramStrength, jinTuiPower } from './liuyao.js';
+import { buildLiuyao, tossLines, bodyLabels, yongshenOf, yongshenStrength, fushenAccess, hexagramStrength, jinTuiPower, yingqiWindow } from './liuyao.js';
 import { buildZiwei, BRIGHTNESS, flowOf, asOfParts, ZIWEI_SCHOOL_DEFAULTS } from './ziwei.js';
 import { drawTarot } from './tarot.js';
 import { buildMeihua } from './meihua.js';
@@ -13,7 +13,7 @@ import { toJDN, ganzhiName, dayGanzhiIndex } from './calendar.js';
 import { randomOf, isSeed } from './random.js';
 import { interpret, DIRECTIONS, DIRECTION_DEFAULT } from './interpret.js';
 import { followup, askPrompt } from './followup.js';
-import { crossCheck, crossText } from './crosscheck.js';
+import { crossCheck, crossText, crossSection } from './crosscheck.js';
 import { pastSignals, verifyFit } from './verify.js';
 import { rectifyBirth } from './rectify.js';
 import { buildAlmanac } from './almanac.js';
@@ -24,7 +24,7 @@ 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 { classicsFor, classicsText, suiyunClassicOf, CLASSIC_BOOKS } from './classics.js';
 import { buildTrend } from './trend.js';
 import { buildFengshui } from './fengshui.js';
 import { buildName } from './name.js';
@@ -126,6 +126,10 @@ function baziText(r) {
     ? `神煞（${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 ry = r.renyuan;
+  const renyuanLine = ry
+    ? `人元：${ry.month}月第${ry.day}日，${ry.active}${ry.activeElement}司权（${ry.segments.map((s) => `${s.stem}${s.from}–${s.to}`).join(' ')}）${ry.beyond ? '；已过 30 日表，按本气算' : ''}`
+    : '';
   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('　')}`,
@@ -148,6 +152,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}`,
+    ...(renyuanLine ? [renyuanLine] : []),
     `大运：${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('　')}`,
@@ -155,8 +160,10 @@ function baziText(r) {
       const hits = r.liunian.filter((l) => l.suiyun && l.suiyun.signals && l.suiyun.signals.length);
       if (!hits.length) return '岁运提示：近十年无岁运并临、运年反吟或流年伏吟/反吟（只标干支，不判吉凶）';
       const label = (s) => `${s.type}${s.type.startsWith('流年') && s.target ? `(${s.target})` : ''}`;
+      const e = suiyunClassicOf(r);
+      const src = e ? `｜古籍见《${CLASSIC_BOOKS[e.book].name}·${e.chapter}》` : '';
       return '岁运提示（只标干支变动，不判吉凶）：' + hits
-        .map((l) => `${l.year}${l.ganzhi} ${l.suiyun.signals.map(label).join('/')}`).join('；');
+        .map((l) => `${l.year}${l.ganzhi} ${l.suiyun.signals.map(label).join('/')}`).join('；') + src;
     })(),
     '（格局、用神、行运吉凶为扶抑＋简化调候的量化提示，非断语。）',
   ].join('\n') + near;
@@ -408,6 +415,11 @@ function liuyaoText(r) {
   if (jt && Array.isArray(jt.lines) && jt.lines.length) {
     out.push(`进退力重：${jt.lines.map((l) => `${l.position}爻${l.from}→${l.to}${l.type}·${l.verdict}`).join(' · ')}`);
   }
+  // 应期线索：只列地支与快慢，不给日期
+  const yq = r.yingqi;
+  if (yq && Array.isArray(yq.triggers) && yq.triggers.length) {
+    out.push(`应期线索：${yq.tempo} · ${yq.triggers.map((t) => `${t.labels.join('/')}${t.branch}`).join(' · ')}（只列地支，不出日期）`);
+  }
   return out.filter(Boolean).join('\n');
 }
 
@@ -428,6 +440,9 @@ export function compute(args = {}) {
     r.classics = classicsFor(r);
     const ct = classicsText(r.classics);
     if (ct) r.summary = `${r.summary}\n【古籍】\n${ct}`;
+    // 岁运提示的原文不占五条上限：只在盘面真有岁运信号时挂到结果上，摘要、解析层与面板各自取用
+    const syc = suiyunClassicOf(r);
+    if (syc) r.suiyunClassic = { ...syc, bookName: CLASSIC_BOOKS[syc.book].name };
   }
   // 超出 ΔT 覆盖范围时把精度提示顶到摘要最前，别让远期盘悄悄出错
   if (r && r.precision && r.precision.level === 'approx' && r.summary) {
@@ -462,7 +477,7 @@ export function compute(args = {}) {
       : 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) });
+      r.interpret.sections.push(crossSection(r.cross));
     }
   }
   // 验前事：把过去若干年的流年信号摊开（只读，不改盘）
@@ -745,6 +760,9 @@ function computeRaw(args = {}) {
       // 伏神出伏条件：飞伏生克叠月建日辰，只判条件、不出应期
       const chufu = fushenAccess(result, ug, { monthBranch, dayBranch: result.dayGanZhi.branch });
       if (chufu) result.fushenAccess = chufu;
+      // 应期线索：只列逢值/逢冲/逢合与旬空的出空/冲空，再给快慢方向，不换算日期
+      const yq = yingqiWindow(result, ug, { monthBranch });
+      if (yq) result.yingqi = yq;
     }
     if (args.seed !== undefined && args.seed !== null && args.seed !== '') result.seed = Number(args.seed);
     return { ...result, ...(asOf ? { asOf } : {}), summary: liuyaoText(result) };
@@ -1196,7 +1214,7 @@ export { geocodeAddress, resolveAddress };
 export { buildBazi, buildLiuyao, tossLines };
 export { followup, askPrompt };
 export { pastSignals, verifyFit, rectifyBirth };
-export { crossCheck, crossText };
+export { crossCheck, crossText, crossSection };
 export { buildAlmanac, buildZeri, buildChenggu, buildXiaoliuren, buildStar, buildNumerology, buildConvert };
 export { buildTrend, buildFengshui, buildName };
 

package/engine/interpret-knowledge.js

@@ -15,10 +15,10 @@ export const KNOWLEDGE = [
     id: 'bazi-yueling-siquan',
     system: 'bazi', dims: ['overall', 'career'],
     gist: '月令不是「一个月」，是当月最有权的那一个字。',
-    detail: '月令藏干按本气、中气、余气分日用事，本气当权的时间最长。所以判旺衰先看日主在月令是得令还是失令——得令者未看全局，已有三分底气。',
+    detail: '月令藏干按本气、中气、余气分日用事，本气当权的时间最长。所以判旺衰先看日主在月令是得令还是失令——得令者未看全局，已有三分底气。本插件按 30 日表算出「生在本月第几日、哪一干当权」，给的是月内轮值这一层细节；旺衰与取格仍以月令本气、透干与会支为主，不随轮值改判。',
     source: '《子平真诠》论用神；人元司权分日之说见《渊海子平》',
     status: 'variant',
-    note: '各家对中气、余气各主几日分法不同（有 7/7/16、9/3/18 等多说），本插件只取「本气当权」这一层，未细分日数。',
+    note: '各家对中气、余气各主几日分法不同（有 7/7/16、9/3/18 等多说）；本插件固定通行 30 日表（如寅月戊7丙7甲16），节当日为第 1 日，第 31 日以后按本气算、不硬分摊。司权表与本柱藏干表口径不同（子月壬、卯月甲、午月丙、酉月庚、亥月戊只出现在司权表里），两表各照原样；取格不随轮值改判。',
   },
   {
     id: 'bazi-tonggen-tougan',
@@ -66,8 +66,8 @@ export const KNOWLEDGE = [
     id: 'bazi-suiyun',
     system: 'bazi', dims: ['overall', 'career'],
     gist: '大运管十年基调，流年管当年触发。',
-    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（当值大运与流年干支相同）、运年反吟（大运与流年天克地冲）、流年伏吟（流年与原局某柱干支相同）与流年反吟（流年与原局某柱天克地冲），是传统上标记「变动较大」的年份，属于提示而非断语。本插件逐年标出四类信号：当值大运按该年立春到次年立春的区间取，交运落在年内时前后两步并列；只标干支重复与对冲，不折分数。',
-    source: '岁运并临、伏吟反吟见《三命通会》《渊海子平》',
+    detail: '大运像换了条路，流年像这条路上某一段的天气。岁运并临（当值大运与流年干支相同）、运年反吟（大运与流年天克地冲）、流年伏吟（流年与原局某柱干支相同）与流年反吟（流年与原局某柱天克地冲），是传统上标记「变动较大」的年份，属于提示而非断语。本插件逐年标出四类信号：当值大运按该年立春到次年立春的区间取，交运落在年内时前后两步并列；只标干支重复与对冲，不折分数。原文里「返吟」指岁运与日柱相对、「伏吟」指岁运压日，与本插件「干支相同为伏吟、天克地冲为反吟」不是同一套定义，两者并列、不合并。',
+    source: '《三命通会》卷二·总论岁运（https://www.diancang.xyz/xuanxuewushu/sanmingtonghui/7539.html）；岁运并临之说出自《渊海子平》',
     status: 'variant',
     note: '「岁运并临主大凶」是流传最广也最被滥用的说法，本插件只作变动提示，不断吉凶；大运与原局之间的伏吟反吟未逐年标注，四柱十神层面的引化也未叠入。',
   },
@@ -125,6 +125,15 @@ export const KNOWLEDGE = [
     status: 'variant',
     note: '化气格成立条件各家宽严不一（是否要求月令为化神、日主是否允许有根），本插件只列条件、附原文，不据此断定化气已成。',
   },
+  {
+    id: 'bazi-zaji-quyong',
+    system: 'bazi', dims: ['overall', 'career'],
+    gist: '辰戌丑未是杂气月：先看透干，再看会支。',
+    detail: '四墓（辰戌丑未）每个字都藏着不止一气，用神不一，所以叫杂气。子平真诠的取法是：藏干透到天干的先用（甲生辰月，透戊用偏财、透癸用正印、透乙用月劫）；没有透干，再看地支有没有与月支会成三合局（辰月逢申子会水，就取水印）。本插件按「透干 → 三合会支 → 本气」的次序取格，依据里写明走的是哪一条，并把《论杂气如何取用》附在结果里。',
+    source: '《子平真诠》十六、论杂气如何取用',
+    status: 'variant',
+    note: '原文说「兼透则兼用」，但只给一个格名时总要落到一个藏干；本插件只取最先透出的那一干，会支也只认三合、不认三会方，且不判原文所说的「有情 / 无情」，取舍次序各家另有说法。',
+  },
   {
     id: 'bazi-zhuanwang-yuanwen',
     system: 'bazi', dims: ['overall', 'career'],
@@ -290,10 +299,10 @@ export const KNOWLEDGE = [
     id: 'liuyao-yingqi',
     system: 'liuyao', dims: ['overall', 'career'],
     gist: '应期是「什么时候见分晓」，不是「哪天」。',
-    detail: '近事以日计、远事以月计；常见取法是等用神逢值、逢冲、逢合之期，或等忌神受制之期。应期法各家互有出入，同一卦不同取法可以差出很远，所以只作时间窗口的提示。',
+    detail: '近事以日计、远事以月计；常见取法是等用神逢值、逢冲、逢合之期，或等忌神受制之期。本插件只做前一半：把用神（不上卦则取伏神）的逢值、逢冲、逢合三支列出，旬空另标出空与冲空，再按月建五态给「偏速 / 偏缓 / 待解 / 未定」一个快慢方向；忌神受制与具体日期仍未做。应期法各家互有出入，同一卦不同取法可以差出很远，所以只作时间窗口的提示。',
     source: '《卜筮正宗》应期章；《增删卜易》',
     status: 'variant',
-    note: '应期取法（值日、冲、合、填实、旬空出空）各家优先级不同，本插件不做具体日期推算。',
+    note: '应期取法（值日、冲、合、填实、旬空出空）各家优先级不同，本插件只并列触发支、不排先后，也不换算日期；近事以日计、远事以月计，用哪把尺由事情远近决定，不代选。',
   },
   {
     id: 'liuyao-liushen',
@@ -450,10 +459,10 @@ export const KNOWLEDGE = [
     id: 'liuyao-yingqi-exact',
     system: 'liuyao', dims: [],
     gist: '具体应期（哪一天应验）本插件尚未推算。',
-    detail: '应期需要综合用神旺衰、动变、旬空出空、日月冲合多层条件，且各家取法不同。当前只给时间窗口的方向性提示，不给具体日期——与其给一个看起来精确、实则拍脑袋的日子，不如留白。',
+    detail: '应期需要综合用神旺衰、动变、旬空出空、日月冲合多层条件，且各家取法不同。当前只给时间窗口的方向性提示（逢值 / 逢冲 / 逢合的触发支，加一个快慢方向），不给具体日期——与其给一个看起来精确、实则拍脑袋的日子，不如留白。',
     source: '待补：《卜筮正宗》应期章逐条实现 + 已录 128 条卦例对拍（源 138 条）',
     status: 'todo',
-    note: '扩展方向：用《卜筮正宗》卦例里有明确应验日期的条目做回归，先验证再输出。',
+    note: '扩展方向：用《卜筮正宗》卦例里有明确应验日期的条目做回归，先验证再输出。0.50.0 已给出触发支与快慢方向，仍不输出日期。',
   },
 ];
 

package/engine/interpret-plain.js

@@ -90,6 +90,19 @@ function jinTuiPlain(r) {
   return `动爻的进退还要看时令：${jp.lines.map((l) => `${l.position}爻${l.from}→${l.to}${l.type}，${sayOf(l)}`).join('；')}。`;
 }
 
+// 应期线索 → 一句白话：只给快慢与可留意的支，不换算日期
+function yingqiPlain(r) {
+  const yq = r && r.yingqi;
+  if (!yq || !Array.isArray(yq.triggers) || !yq.triggers.length) return '';
+  const when = yq.tempo === '偏速' ? '大体偏近，近事更容易先见分晓'
+    : yq.tempo === '偏缓' ? '大体偏远，别指望立刻见分晓'
+      : yq.tempo === '待解' ? '眼下还有月破或旬空，得先等条件解除'
+        : '缺月建，快慢暂不定';
+  const branches = yq.triggers.map((t) => t.branch).join('、');
+  const fu = yq.viaFushen ? '（用神是伏神，先要出得来）' : '';
+  return `应期上${when}；传统会留意${branches}这几个地支${fu}——这只是提示，不换算成具体哪天。`;
+}
+
 // 全卦逐爻旺衰 → 一句白话：整张卦的气偏在哪一头（与用神那一句分开说）
 function hexStrengthPlain(hs) {
   if (!hs || !hs.counts) return '';
@@ -200,7 +213,7 @@ export function buildAnswer(r, ask, ctx = {}) {
       head + `先说结论：本卦是${s(ben.name, '—')}` +
         `${ben.palace ? `（${ben.palace}）` : ''}` +
         `${moving.length ? `，第 ${moving.join('、')} 爻动，变为${s(bian.name, '—')}` : '，六爻安静没有动爻'}。` +
-        `${plainBody}${usePlainOf(r.useGod, r.fushenAccess)}${useStrengthPlain(r.useGodStrength)}${jinTuiPlain(r)}${hexStrengthPlain(r.hexStrength)}`,
+        `${plainBody}${usePlainOf(r.useGod, r.fushenAccess)}${useStrengthPlain(r.useGodStrength)}${jinTuiPlain(r)}${yingqiPlain(r)}${hexStrengthPlain(r.hexStrength)}`,
       '断卦的落点在「世爻」（代表你）和「动爻」（事情的推动点），下面「看盘顺序」就按这个次序展开。',
     ].join('');
   }
@@ -268,7 +281,7 @@ export function buildPlain(r, ask, ctx = {}) {
     const plainBody = bodyPlainOf(labels);
     return `${s(ben.name, '这一卦')}讲的是一个「${moving.length ? '正在动、还会变' : '暂时不动、先看清'}」的局面——` +
       `${moving.length ? '有动爻，说明事情还有转圜空间，不是死局。' : '六爻安静，说明当下更该观察而不是硬推。'}` +
-      `${plainBody}${usePlainOf(r.useGod, r.fushenAccess)}${useStrengthPlain(r.useGodStrength)}${jinTuiPlain(r)}${hexStrengthPlain(r.hexStrength)}`;
+      `${plainBody}${usePlainOf(r.useGod, r.fushenAccess)}${useStrengthPlain(r.useGodStrength)}${jinTuiPlain(r)}${yingqiPlain(r)}${hexStrengthPlain(r.hexStrength)}`;
   }
   return '';
 }