dsh-metaphysics 0.17.0 → 0.18.0

package/engine/numerology.js

@@ -0,0 +1,60 @@
+// 生命数字（西方数字学）：生命路径数 / 生日数 / 态度数，11、22、33 主数保留。
+// 纯本地确定性；与八字/紫微是两套不可互证的体系，输出里明确提示。
+import { daysInMonth } from './validate.js';
+
+/** 1–9 与主数 11/22/33 的数义（白话提炼）。 */
+export const NUMBER_MEANING = {
+  1: { title: '开创者', keywords: '独立、主见、起步快', tendency: '习惯自己拍板，适合从零开始的事。', lesson: '课题是学会合作与示弱，别把「我能行」当唯一答案。' },
+  2: { title: '协调者', keywords: '细腻、共情、善配合', tendency: '擅长读空气、做黏合剂，团队里离不开的角色。', lesson: '课题是别过度讨好、别把委屈攒成怨气。' },
+  3: { title: '表达者', keywords: '活跃、创意、感染力', tendency: '靠表达与点子吃饭，越有舞台越发光。', lesson: '课题是持续力与收尾，别让兴趣过载成半成品。' },
+  4: { title: '建构者', keywords: '务实、秩序、靠得住', tendency: '擅长把混乱理成流程，慢工出细活。', lesson: '课题是别过度求稳、别用规则捆住自己和别人。' },
+  5: { title: '探索者', keywords: '自由、变化、新鲜感', tendency: '适应力强，喜欢移动与尝鲜，厌烦一成不变。', lesson: '课题是承诺与专注，别把「换一个」当解药。' },
+  6: { title: '照顾者', keywords: '责任、顾家、审美', tendency: '天然把身边人放进自己的责任清单。', lesson: '课题是别替别人扛过头，爱不等于包办。' },
+  7: { title: '探究者', keywords: '内省、钻研、独处', tendency: '需要个人空间，喜欢把问题想透再动。', lesson: '课题是信任与敞开，别用距离保护自己。' },
+  8: { title: '经营者', keywords: '资源、格局、执行力', tendency: '对钱与权有直觉，擅长把资源盘活。', lesson: '课题是平衡控制欲，别用成果定义自我价值。' },
+  9: { title: '理想者', keywords: '情怀、包容、完成感', tendency: '看得远，愿意为更大的意义投入。', lesson: '课题是落地与界限，别在付出里丢了自己。' },
+  11: { title: '直觉者（主数）', keywords: '敏感、灵感、感召力', tendency: '直觉极准，容易成为别人的灯，但情绪消耗也大。', lesson: '课题是把天赋落地成具体作品，而不是只停在感受。' },
+  22: { title: '实践家（主数）', keywords: '愿景、系统、扛大梁', tendency: '能把大想法拆成可行工程，压力与能力同步放大。', lesson: '课题是别被宏大目标压住，先完成小闭环。' },
+  33: { title: '疗愈者（主数）', keywords: '大爱、教导、承担', tendency: '为他人承担是本能，适合教导与疗愈型角色。', lesson: '课题是先照顾好自己，别把牺牲当价值。' },
+};
+
+/** 逐位求和；11/22/33 保留为主数（不再归约）。 */
+export function reduceNumber(n, keepMasters = true) {
+  let v = Math.abs(Math.trunc(n));
+  while (v > 9) {
+    if (keepMasters && (v === 11 || v === 22 || v === 33)) return v;
+    v = String(v).split('').reduce((s, c) => s + Number(c), 0);
+  }
+  return v;
+}
+
+const digitSum = (n) => String(Math.abs(Math.trunc(n))).split('').reduce((s, c) => s + Number(c), 0);
+
+/**
+ * 生命数字主函数（公历出生日期）。
+ * @param {{year:number, month:number, day:number}} input
+ */
+export function buildNumerology(input) {
+  const { year, month, day } = input || {};
+  if (!Number.isInteger(year) || !Number.isInteger(month) || !Number.isInteger(day)
+    || year < 1900 || year > 2100 || month < 1 || month > 12 || day < 1 || day > daysInMonth(year, month)) {
+    throw new Error('生命数字需要真实存在的公历出生日期（year 1900–2100、month、day）——请向用户询问，勿猜');
+  }
+  const lifePath = reduceNumber(digitSum(year) + digitSum(month) + digitSum(day));
+  const birthday = reduceNumber(day);
+  const attitude = reduceNumber(month + day);
+  const parts = [
+    { key: 'lifePath', name: '生命路径数', number: lifePath, meaning: NUMBER_MEANING[lifePath] },
+    { key: 'birthday', name: '生日数', number: birthday, meaning: NUMBER_MEANING[birthday] },
+    { key: 'attitude', name: '态度数', number: attitude, meaning: NUMBER_MEANING[attitude] },
+  ];
+  return {
+    system: 'numerology',
+    meta: { date: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}`, system: '西方数字学' },
+    numbers: { lifePath, birthday, attitude },
+    parts,
+    primary: parts[0],
+    sources: ['生命路径=出生年月日逐位求和归约；生日数=日归约；态度数=月+日归约（11/22/33 保留）'],
+    disclaimer: '生命数字属西方数字学体系，与八字/紫微等东方术数口径不同、不可互相印证；仅供自我认识参考。',
+  };
+}

package/engine/rectify.js

@@ -80,6 +80,7 @@ export function rectifyBirth(opts) {
       gender,
       lateZi: opts.lateZi !== false,
       trueSolar: opts.trueSolar !== false,
+      dst: opts.dst !== false,
       address: typeof opts.address === 'string' ? opts.address : undefined,
       longitude: typeof opts.longitude === 'number' ? opts.longitude : undefined,
       geo: opts.geo && typeof opts.geo === 'object' ? opts.geo : undefined,

package/engine/star.js

@@ -0,0 +1,82 @@
+// 星座档案 + 当日娱乐向基调：纯本地确定性（同一天同一星座结果永远一致）。
+// 星座按太阳过宫的通行日期区间（公历）；当日基调由日期哈希生成，不是随机数。
+import { daysInMonth } from './validate.js';
+
+/** 12 星座（区间含起止日；摩羯跨年由两端分别匹配）。 */
+export const SIGNS = [
+  { name: '白羊座', element: '火象', planet: '火星', range: [3, 21, 4, 19], keywords: '热血、开拓、直来直往', compatible: '狮子、射手、天秤' },
+  { name: '金牛座', element: '土象', planet: '金星', range: [4, 20, 5, 20], keywords: '沉稳、务实、惜物恋旧', compatible: '处女、摩羯、巨蟹' },
+  { name: '双子座', element: '风象', planet: '水星', range: [5, 21, 6, 21], keywords: '灵动、好奇、能言善变', compatible: '天秤、水瓶、白羊' },
+  { name: '巨蟹座', element: '水象', planet: '月亮', range: [6, 22, 7, 22], keywords: '顾家、念旧、外柔内韧', compatible: '天蝎、双鱼、金牛' },
+  { name: '狮子座', element: '火象', planet: '太阳', range: [7, 23, 8, 22], keywords: '大方、自信、天生舞台感', compatible: '白羊、射手、天秤' },
+  { name: '处女座', element: '土象', planet: '水星', range: [8, 23, 9, 22], keywords: '细致、挑剔、完美主义', compatible: '金牛、摩羯、巨蟹' },
+  { name: '天秤座', element: '风象', planet: '金星', range: [9, 23, 10, 23], keywords: '优雅、权衡、社交高手', compatible: '双子、水瓶、狮子' },
+  { name: '天蝎座', element: '水象', planet: '冥王星', range: [10, 24, 11, 22], keywords: '深挚、洞察、爱憎分明', compatible: '巨蟹、双鱼、处女' },
+  { name: '射手座', element: '火象', planet: '木星', range: [11, 23, 12, 21], keywords: '乐观、自由、远方体质', compatible: '白羊、狮子、水瓶' },
+  { name: '摩羯座', element: '土象', planet: '土星', range: [12, 22, 1, 19], keywords: '自律、坚忍、大器晚成', compatible: '金牛、处女、天蝎' },
+  { name: '水瓶座', element: '风象', planet: '天王星', range: [1, 20, 2, 18], keywords: '独立、前卫、脑洞担当', compatible: '双子、天秤、射手' },
+  { name: '双鱼座', element: '水象', planet: '海王星', range: [2, 19, 3, 20], keywords: '温柔、共情、浪漫滤镜', compatible: '巨蟹、天蝎、金牛' },
+];
+
+/** 日期 → 星座条目；非法日期返回 null。 */
+export function signOfDate(month, day) {
+  for (const s of SIGNS) {
+    const [m1, d1, m2, d2] = s.range;
+    if ((month === m1 && day >= d1) || (month === m2 && day <= d2)) return s;
+  }
+  return null;
+}
+
+/** 日期哈希（同日同结果；Math.imul 保证 32 位乘法不丢精度）。 */
+function daySeed(y, m, d, salt) {
+  let x = ((y * 73856093) ^ (m * 19349663) ^ (d * 83492791) ^ Math.imul(salt, 2654435761)) >>> 0;
+  x = Math.imul(x ^ (x >>> 13), 0x5bd1e995);
+  return (x ^ (x >>> 15)) >>> 0;
+}
+
+const COLORS = ['晨雾白', '海盐蓝', '苔原绿', '落日橘', '琥珀黄', '黛蓝', '藕荷粉', '石墨灰', '橄榄绿', '雾紫'];
+const TONE_TEXT = {
+  5: '势头极好，主动出击。',
+  4: '顺风缓行，乘势而为。',
+  3: '平顺持中，稳字当头。',
+  2: '略有阻滞，慢即是快。',
+  1: '宜静宜守，养精蓄锐。',
+};
+
+/**
+ * 星座 + 当日基调。
+ * @param {{year:number, month:number, day:number}} input 公历日期
+ */
+export function buildStar(input) {
+  const { year, month, day } = input || {};
+  if (!Number.isInteger(year) || !Number.isInteger(month) || !Number.isInteger(day)
+    || year < 1900 || year > 2100 || month < 1 || month > 12 || day < 1 || day > daysInMonth(year, month)) {
+    throw new Error('星座需要真实存在的公历日期（year 1900–2100、month、day）——请向用户询问');
+  }
+  const sign = signOfDate(month, day);
+  if (!sign) throw new Error(`无法识别星座：${year}-${month}-${day}`);
+  const dims = ['事业', '感情', '财运', '健康'].map((k, i) => {
+    const stars = (daySeed(year, month, day, i + 1) % 5) + 1;
+    return { name: k, stars, text: TONE_TEXT[stars] };
+  });
+  return {
+    system: 'star',
+    meta: { date: `${year}-${String(month).padStart(2, '0')}-${String(day).padStart(2, '0')}` },
+    sign: {
+      name: sign.name,
+      element: sign.element,
+      planet: sign.planet,
+      keywords: sign.keywords,
+      compatible: sign.compatible,
+      range: `${sign.range[0]}月${sign.range[1]}日–${sign.range[2]}月${sign.range[3]}日`,
+    },
+    daily: {
+      tone: TONE_TEXT[(daySeed(year, month, day, 9) % 5) + 1],
+      dims,
+      luckyColor: COLORS[daySeed(year, month, day, 10) % COLORS.length],
+      luckyNumber: (daySeed(year, month, day, 11) % 9) + 1,
+    },
+    sources: ['星座区间：太阳过宫通行日期', '当日基调：日期哈希确定性生成（同日同结果）'],
+    disclaimer: '星座档案为通行天文口径；当日基调纯娱乐向，同日同结果，不构成任何现实预测。',
+  };
+}

package/engine/trend.js

@@ -0,0 +1,193 @@
+// 人生 K 线：把「大运 + 流年」的十神对日主的影响折算成逐年 0–100 分，
+// 再画成开高低收的蜡烛形态与 ASCII 迷你图。
+//
+// 口径：这是一套**简化启发式**——十神计分表固定、正负号随日主旺衰方向翻转，
+// 只用于看形态与相对起伏；分高不等于真实吉凶，旺衰落在换档边界时连排序都不给。
+import { buildBazi, HIDDEN_STEMS, tenGod } from './bazi.js';
+import { ganzhiName, sexagenaryIndex, STEMS, BRANCHES } from './calendar.js';
+
+// ── 十神计分表 ────────────────────────────────────────────────
+// 三张表各自求和接近 0，保证分数有正负双向起伏；符号随日主旺衰方向翻转：
+//   偏弱 → 喜生扶（印 / 比劫）为正，忌克泄耗（官杀 / 食伤 / 财）为负；
+//   偏强 → 喜克泄耗为正，忌生扶为负；
+//   中和 → 财官印温和加分，杀伤伤官小扣。
+const SHISHEN_WEAK = {
+  正印: 2, 偏印: 2, 比肩: 2, 劫财: 1,
+  食神: -1, 伤官: -2, 偏财: -2, 正财: -2,
+  正官: -1, 七杀: -3,
+};
+const SHISHEN_STRONG = {
+  正印: -2, 偏印: -2, 比肩: -2, 劫财: -1,
+  食神: 1, 伤官: 1, 偏财: 2, 正财: 2,
+  正官: 2, 七杀: 1,
+};
+const SHISHEN_NEUTRAL = {
+  正印: 1, 偏印: 0, 比肩: 0, 劫财: -1,
+  食神: 1, 伤官: -2, 偏财: 1, 正财: 2,
+  正官: 2, 七杀: -2,
+};
+
+const FAVOR = { 身强: 'strong', 偏强: 'strong', 中和: 'neutral', 偏弱: 'weak', 身弱: 'weak' };
+const TABLE_OF = { strong: SHISHEN_STRONG, neutral: SHISHEN_NEUTRAL, weak: SHISHEN_WEAK };
+
+/** 旺衰分档的换档阈值：分数贴着阈值时，多一个干支就换表，整套符号翻转。 */
+const LEVEL_CUTS = [0.5, 1.5, 2.5, 4];
+const BOUNDARY_EPS = 0.3;
+
+const clamp = (v, lo, hi) => Math.max(lo, Math.min(hi, v));
+
+/** 干支（天干 + 地支本气）对日主的十神；地支取本气藏干，与四柱十神口径一致。 */
+function tenGodOfZhi(dayStem, branch) {
+  const main = HIDDEN_STEMS[branch] && HIDDEN_STEMS[branch][0];
+  return main ? tenGod(dayStem, main) : null;
+}
+
+const yearGanzhi = (year) => ganzhiName(((year - 4) % 60 + 60) % 60);
+
+/** 把大运表补到覆盖 toAge（引擎默认只排 8 步 / 80 年）。 */
+function extendDayun(list, direction, toAge) {
+  const out = list.slice();
+  const step = direction === '逆行' ? -1 : 1;
+  let guard = 0;
+  while (out.length && out[out.length - 1].startAge <= toAge && guard < 24) {
+    const last = out[out.length - 1];
+    // last.ganzhi 是「甲辰」这样的名字，不是六十甲子序号：先换回序号再顺/逆推一步
+    const lastIdx = sexagenaryIndex(STEMS.indexOf(last.ganzhi[0]), BRANCHES.indexOf(last.ganzhi[1]));
+    const nextIdx = (lastIdx + step + 60) % 60;
+    const g = ganzhiName(nextIdx);
+    out.push({ step: last.step + 1, startAge: last.startAge + 10, ganzhi: g.name, stem: g.stem, branch: g.branch, stemTenGod: last.stemTenGod });
+    guard++;
+  }
+  return out;
+}
+
+/**
+ * 人生 K 线主函数。
+ * @param {{year:number,month:number,day:number,hour?:number,minute?:number,gender:'male'|'female',
+ *          toAge?:number,lateZi?:boolean,trueSolar?:boolean,dst?:boolean,
+ *          address?:string,longitude?:number,geo?:object}} input
+ */
+export function buildTrend(input) {
+  const gender = input.gender;
+  if (gender !== 'male' && gender !== 'female') {
+    throw new Error('人生 K 线需要性别：大运顺逆由性别决定，不可缺省');
+  }
+  const toAge = clamp(Number.isInteger(input.toAge) ? input.toAge : 100, 10, 100);
+  const r = buildBazi({
+    year: input.year,
+    month: input.month,
+    day: input.day,
+    hour: Number.isInteger(input.hour) ? input.hour : 12,
+    minute: Number.isInteger(input.minute) ? input.minute : 0,
+    gender,
+    lateZi: input.lateZi !== false,
+    trueSolar: input.trueSolar !== false,
+    dst: input.dst !== false,
+    address: typeof input.address === 'string' ? input.address : undefined,
+    longitude: typeof input.longitude === 'number' ? input.longitude : undefined,
+    geo: input.geo && typeof input.geo === 'object' ? input.geo : undefined,
+  });
+
+  const dayStem = r.pillars.day.stem;
+  const table = TABLE_OF[FAVOR[r.strength.level] || 'neutral'];
+  const rawBound = 5 * Math.max(...Object.values(table).map(Math.abs));
+  const scoreOf = (god) => table[god] ?? 0;
+  const boundary = LEVEL_CUTS.some((c) => Math.abs(r.strength.score - c) <= BOUNDARY_EPS);
+
+  const dayun = extendDayun(r.dayun.list, r.dayun.direction, toAge);
+  const segments = dayun
+    .map((d, i) => ({
+      ganZhi: d.ganzhi,
+      startAge: d.startAge,
+      endAge: (dayun[i + 1] ? dayun[i + 1].startAge : d.startAge + 10) - 1,
+    }))
+    .filter((s) => s.startAge <= toAge);
+
+  const birthYear = Number(String(r.solarTime.civilText).slice(0, 4));
+  const points = [];
+  let prev = 50;
+  for (let age = 1; age <= toAge; age++) {
+    const year = birthYear + age - 1;
+    const gz = yearGanzhi(year);
+    const seg = segments.find((s) => age >= s.startAge && age <= s.endAge) || null;
+    const godGan = tenGod(dayStem, gz.stem);
+    const godZhi = tenGodOfZhi(dayStem, gz.branch);
+    const dyGodGan = seg ? tenGod(dayStem, seg.ganZhi[0]) : null;
+    const dyGodZhi = seg ? tenGodOfZhi(dayStem, seg.ganZhi[1]) : null;
+
+    const raw = scoreOf(godGan) + scoreOf(godZhi)
+      + (seg ? (scoreOf(dyGodGan) + scoreOf(dyGodZhi)) * 1.5 : 0);
+    const score = clamp(Math.round(((raw + rawBound) / (rawBound * 2)) * 100), 2, 99);
+    points.push({
+      age,
+      year,
+      ganZhi: gz.name,
+      dayunGanZhi: seg ? seg.ganZhi : null,
+      shiShenGan: godGan,
+      shiShenZhi: godZhi,
+      score,
+      kline: {
+        open: prev,
+        close: score,
+        high: clamp(score + 4, 0, 100),
+        low: clamp(score - 4, 0, 100),
+      },
+    });
+    prev = score;
+  }
+
+  const sorted = points.slice().sort((a, b) => b.score - a.score);
+  return {
+    system: 'trend',
+    meta: {
+      birth: String(r.solarTime.civilText).slice(0, 10),
+      gender,
+      dayMaster: `${dayStem}（${r.dayMaster.yinYang}${r.dayMaster.element}）`,
+      strength: { level: r.strength.level, score: r.strength.score, boundary },
+      toAge,
+      ...(boundary
+        ? {
+          boundaryNote:
+            `旺衰分 ${r.strength.score} 正落在换档阈值附近（阈值 ${LEVEL_CUTS.join(' / ')}，容差 ${BOUNDARY_EPS}）：`
+            + '多一个同类干支或少一个就会换计分表，整套正负号随之翻转——因此这里不出「最好 / 最差年份」的排序结论。',
+        }
+        : {}),
+    },
+    segments,
+    points,
+    highlights: boundary
+      ? { suppressed: '旺衰落在换档边界，年份排序不可靠，不给顺位 / 谨慎年份', best: [], worst: [] }
+      : {
+        best: sorted.slice(0, 3).map((p) => `${p.age}岁（${p.year}，${p.ganZhi}，${p.score}分）`),
+        worst: sorted.slice(-3).reverse().map((p) => `${p.age}岁（${p.year}，${p.ganZhi}，${p.score}分）`),
+      },
+    sparkline: asciiSparkline(points),
+    sources: [
+      '运势分：流年 / 大运干支十神对日主的简化启发式计分（旺衰方向决定正负号）',
+      'K 线形态：收盘 = 当年分，开盘 = 上年分，高低各 ±4（确定性生成）',
+    ],
+    disclaimer: boundary
+      ? '人生 K 线为简化启发式的可视化；本盘旺衰判定处于换档边界，趋势与年份排序均不可靠，仅供展示，不构成任何现实决策依据。'
+      : '人生 K 线为简化启发式的可视化，趋势形态仅供娱乐参考，不构成任何现实决策依据；十年大运内每年分值不等于真实吉凶。',
+  };
+}
+
+/** ASCII 迷你 K 线：每年一个方块（▁▂▃▄▅▆▇█），按大运分段成行。 */
+function asciiSparkline(points) {
+  const BLOCKS = ['▁', '▂', '▃', '▄', '▅', '▆', '▇', '█'];
+  const lines = [];
+  const groups = [];
+  for (const p of points) {
+    const key = p.dayunGanZhi || '起运前';
+    const last = groups[groups.length - 1];
+    if (!last || last.key !== key) groups.push({ key, points: [] });
+    groups[groups.length - 1].points.push(p);
+  }
+  for (const g of groups) {
+    const bars = g.points
+      .map((p) => BLOCKS[clamp(Math.floor((p.score / 100) * BLOCKS.length), 0, BLOCKS.length - 1)])
+      .join('');
+    lines.push(`${g.key}（${g.points[0].age}–${g.points[g.points.length - 1].age}岁）：${bars}`);
+  }
+  return lines;
+}

package/engine/xiaoliuren.js

@@ -0,0 +1,64 @@
+// 小六壬（诸葛马前课）：月/日/时（或报三个数）掐指落宫，六宫循环。
+// 口径：通行掌诀；断语为白话提炼（非原文照录）。轻量快占，属民俗参考。
+import { solarToLunar } from './lunar.js';
+import { hourToBranch } from './almanac.js';
+import { BRANCHES } from './calendar.js';
+
+/** 六宫：吉凶 + 白话断语。 */
+export const PALACES = {
+  大安: { luck: '吉', text: '事事昌顺，宜静守不宜妄动；所问之事根基稳，缓一缓更妥。' },
+  留连: { luck: '凶', text: '事多牵扯反复，暗中有耗；宜守不宜进，防拖延与口舌。' },
+  速喜: { luck: '吉', text: '喜事将至，行动宜快；所问之事三日内外见分晓。' },
+  赤口: { luck: '凶', text: '口舌是非、官讼之象；宜谨言慎行，凡事留凭证。' },
+  小吉: { luck: '吉', text: '小有助力，慢慢来能成；合作与人际有贵人。' },
+  空亡: { luck: '凶', text: '落空之象，谋事多不成；宜停一停，改期再议。' },
+};
+
+export const PALACE_ORDER = ['大安', '留连', '速喜', '赤口', '小吉', '空亡'];
+
+const pick = (n) => PALACE_ORDER[(((n - 1) % 6) + 6) % 6];
+
+/**
+ * 小六壬主函数。
+ * @param {{mode:'time'|'number', date?:string, hour?:number, num1?:number, num2?:number, num3?:number, question?:string}} input
+ *   time 模式下 date 与 hour 必须成对（缺时辰则同一天任何时刻同宫，等于静默代填）。
+ */
+export function buildXiaoliuren(input) {
+  const mode = input.mode === 'number' ? 'number' : 'time';
+  let m;
+  let d;
+  let h;
+  let originText;
+  if (mode === 'time') {
+    if (typeof input.hour !== 'number' || !Number.isInteger(input.hour) || input.hour < 0 || input.hour > 23) {
+      throw new Error('时间起课必须同时给 date 与 hour（0–23）：掐指按时辰推进，缺时辰不可代填');
+    }
+    const mt = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(String(input.date || '').trim());
+    if (!mt) throw new Error('时间起课需要 date（公历 YYYY-MM-DD）——请向用户询问日期');
+    const lunar = solarToLunar(Number(mt[1]), Number(mt[2]), Number(mt[3]));
+    const branch = hourToBranch(input.hour);
+    m = lunar.month;
+    d = lunar.day;
+    h = BRANCHES.indexOf(branch) + 1;
+    originText = `农历${lunar.month}月${lunar.day}日 ${branch}时：月${m} → 日${d} → 时${h} 掐指落宫`;
+  } else {
+    const nums = [input.num1, input.num2, input.num3].map(Number);
+    if (nums.some((x) => !Number.isInteger(x) || x < 1 || x > 99)) {
+      throw new Error('报数起课需要三个 1–99 的正整数（随口报即可）——缺数请向用户索要，不要代填');
+    }
+    [m, d, h] = nums;
+    originText = `报数 ${m}、${d}、${h}：依次按月/日/时位掐指落宫`;
+  }
+  const p1 = pick(m);
+  const p2 = pick(PALACE_ORDER.indexOf(p1) + 1 + d - 1);
+  const p3 = pick(PALACE_ORDER.indexOf(p2) + 1 + h - 1);
+  const info = PALACES[p3];
+  return {
+    system: 'xiaoliuren',
+    meta: { mode: mode === 'time' ? '时间起课' : '报数起课', question: input.question || null, originText },
+    steps: [p1, p2, p3],
+    result: { palace: p3, luck: info.luck, text: info.text },
+    sources: ['掌诀口径：通行马前课（白话提炼，非原文照录）'],
+    disclaimer: '小六壬为轻量快占，属民俗娱乐参考；重要事项请综合现实信息判断。',
+  };
+}

package/engine/zeri.js

@@ -0,0 +1,127 @@
+// 择日：逐日按黄历「建除简表宜忌」+ 建除神适配 + 冲属相排除打分排序。
+// 口径透明：这是排序引导，不是吉凶断语；未收录逐日神煞，冲煞按日支对生肖。
+import { fromJDN, toJDN } from './calendar.js';
+import { buildAlmanac, SHENGXIAO } from './almanac.js';
+
+/** 支持的事项：直接宜词 + 关联宜词（黄历措辞）。 */
+export const TASKS = {
+  嫁娶: { yi: ['嫁娶', '结亲', '订盟', '纳采'], related: ['会亲友', '裁衣'], category: 'marriage' },
+  订婚: { yi: ['订盟', '纳采'], related: ['嫁娶', '会亲友'], category: 'marriage' },
+  开业: { yi: ['开市', '立券', '交易'], related: ['纳财', '挂匾'], category: 'business' },
+  入宅: { yi: ['入宅', '移徙'], related: ['安床', '修造', '扫舍'], category: 'move' },
+  搬家: { yi: ['移徙', '入宅'], related: ['安床', '修造'], category: 'move' },
+  动土: { yi: ['动土', '修造'], related: ['竖柱', '上梁'], category: 'construction' },
+  装修: { yi: ['修造', '修饰垣墙'], related: ['动土'], category: 'construction' },
+  安葬: { yi: ['安葬', '破土'], related: ['立碑', '埋穴'], category: 'burial' },
+  出行: { yi: ['出行'], related: ['上任', '赴任'], category: 'travel' },
+  祭祀: { yi: ['祭祀'], related: ['祈福', '求嗣'], category: 'worship' },
+  签约: { yi: ['立券', '交易'], related: ['纳财', '开市'], category: 'contract' },
+  求医: { yi: ['求医', '疗病'], related: ['针灸'], category: 'medical' },
+  纳财: { yi: ['纳财', '收账'], related: ['开市', '立券'], category: 'contract' },
+};
+
+/** 建除十二神按事项大类的通行适配（简化口径）。 */
+const ZHIXING_FAVOR = {
+  marriage: ['满', '定', '成', '开'],
+  business: ['开', '成', '满', '收'],
+  move: ['定', '成', '开', '除'],
+  construction: ['建', '除', '成', '开'],
+  burial: ['除', '定', '闭', '破'],
+  travel: ['建', '成', '开', '除'],
+  worship: ['除', '满', '平', '定', '执', '成', '开'],
+  contract: ['定', '成', '收', '开'],
+  medical: ['除', '开'],
+};
+
+const VERDICT = (score, ctx) => {
+  if (ctx.chongSelf) {
+    return { verdict: '回避', text: `当日冲${ctx.chongSelf}（当事人属相）：传统择日径直排除，不进推荐与可用名单。`, excluded: true };
+  }
+  if (score >= 3) return { verdict: '推荐', text: '宜项与建除相配，此日对所问事项顺遂。', excluded: false };
+  if (score >= 1) {
+    return {
+      verdict: '可用',
+      text: ctx.jiHit.length ? `可考虑，但当日忌${ctx.jiHit.join('、')}：宜项加分、忌项减分，未抵消干净。` : '未见冲克，可用；若有更好的日子，优先取推荐日。',
+      excluded: false,
+    };
+  }
+  if (score >= 0) return { verdict: '平平', text: ctx.jiHit.length ? `当日忌${ctx.jiHit.join('、')}，宜项不相干，不作首选。` : '宜忌不相干，无助力也无冲克。', excluded: false };
+  return { verdict: '回避', text: ctx.jiHit.length ? `当日忌${ctx.jiHit.join('、')}，对所问事项不宜。` : '减分项多于加分项，此日不宜。', excluded: false };
+};
+
+/**
+ * 择日主函数。
+ * @param {{task:string, startDate:string, days?:number, shengXiao?:string}} input
+ *   startDate 必填（公历 YYYY-MM-DD），避免引擎在无时钟环境下静默取「今天」。
+ */
+export function buildZeri(input) {
+  const task = input.task;
+  if (!TASKS[task]) throw new Error(`不支持的事项「${task}」。支持：${Object.keys(TASKS).join('、')}`);
+  const m = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(String(input.startDate || '').trim());
+  if (!m) throw new Error('择日需要 startDate（公历 YYYY-MM-DD）——请向用户询问起算日，不要代填');
+  const start = { year: Number(m[1]), month: Number(m[2]), day: Number(m[3]) };
+  const days = Math.max(1, Math.min(60, Number.isInteger(input.days) ? input.days : 30));
+  const shengXiaoRaw = typeof input.shengXiao === 'string' ? input.shengXiao.trim() : '';
+  const shengXiao = shengXiaoRaw || null;
+  if (shengXiao && !SHENGXIAO.includes(shengXiao)) throw new Error(`shengXiao 须为生肖名：${SHENGXIAO.join('、')}`);
+
+  const spec = TASKS[task];
+  const zhixingSet = ZHIXING_FAVOR[spec.category];
+  const startJdn = toJDN(start.year, start.month, start.day);
+  const list = [];
+  for (let i = 0; i < days; i++) {
+    const p = fromJDN(startJdn + i);
+    const a = buildAlmanac(p);
+    let score = 0;
+    const reasons = [];
+    const yiHit = spec.yi.filter((w) => a.yi.includes(w));
+    if (yiHit.length) { score += 2; reasons.push(`宜${yiHit.join('、')}（+2）`); }
+    const relHit = spec.related.filter((w) => a.yi.includes(w));
+    if (relHit.length) { score += 1; reasons.push(`关联宜项${relHit.join('、')}（+1）`); }
+    const jiHit = [...spec.yi, ...spec.related].filter((w) => a.ji.includes(w));
+    if (jiHit.length) { score -= 3; reasons.push(`忌${jiHit.join('、')}（-3）`); }
+    const chongSelf = shengXiao && a.chong.shengXiao === shengXiao ? shengXiao : null;
+    if (chongSelf) { score -= 2; reasons.push(`冲${shengXiao}（当事人属相，径直排除）`); }
+    if (zhixingSet.includes(a.zhiXing)) { score += 1; reasons.push(`建除${a.zhiXing}神利${task}（+1）`); }
+    if (a.zhiXing === '破' && spec.category !== 'burial') { score -= 1; reasons.push('破日（-1）'); }
+    if (a.zhiXing === '危' && spec.category !== 'travel' && spec.category !== 'worship') { score -= 1; reasons.push('危日（-1）'); }
+
+    const v = VERDICT(score, { chongSelf, jiHit });
+    list.push({
+      date: a.meta.date,
+      weekday: a.meta.weekday,
+      lunar: a.lunar.text,
+      dayGanZhi: a.ganzhi.day,
+      zhiXing: a.zhiXing,
+      yi: a.yi,
+      ji: a.ji,
+      chong: a.chong.shengXiao,
+      score,
+      reasons,
+      verdict: v.verdict,
+      verdictText: v.text,
+      ...(v.excluded ? { excluded: true } : {}),
+    });
+  }
+
+  const ranked = list.slice().sort((x, y) => y.score - x.score || (x.date < y.date ? -1 : 1));
+  return {
+    system: 'zeri',
+    meta: {
+      task,
+      startDate: `${start.year}-${String(start.month).padStart(2, '0')}-${String(start.day).padStart(2, '0')}`,
+      days,
+      shengXiao,
+      scope: shengXiao
+        ? `宜忌按建除简表；已给当事人属相（${shengXiao}），凡当日冲该属相径直排除。评分仅用于排序引导。`
+        : '宜忌按建除简表；未给当事人属相，未做冲属相排除。评分仅用于排序引导。',
+    },
+    best: ranked.filter((d) => d.verdict === '推荐' && !d.excluded).slice(0, 5).map((d) => d.date),
+    usable: ranked.filter((d) => d.verdict === '可用' && !d.excluded).slice(0, 5).map((d) => d.date),
+    avoid: list.filter((d) => d.verdict === '回避').map((d) => `${d.date}（${d.reasons.join('；') || '综合减分'}）`),
+    days: list,
+    excludedCount: list.filter((d) => d.excluded).length,
+    sources: ['宜忌：建除十二神通行简表', '建除适配与冲煞：传统通行口径', '排序：宜忌加减分 + 属相排除（确定性）'],
+    disclaimer: '择日为传统黄历口径的本地计算，属民俗参考；评分只用于排序，不构成择日结论。',
+  };
+}

package/engine/ziwei.js

@@ -2,6 +2,7 @@
 import { STEMS, BRANCHES, ganzhiName, sexagenaryIndex, jdToParts, partsToJd, formatJd } from './calendar.js';
 import { solarToLunar } from './lunar.js';
 import { applyTrueSolar } from './bazi.js';
+import { applyDst } from './dst.js';
 import { assertCivil } from './validate.js';
 import { nayinOf } from './nayin.js';
 import { resolveAddress } from './geo.js';
@@ -203,7 +204,10 @@ export function buildZiwei(input) {
   const longitude = typeof input.longitude === 'number'
     ? input.longitude
     : (geo && typeof geo.lon === 'number' ? geo.lon : undefined);
-  const civilJd = partsToJd({ year: cy, month: cm, day: cd, hour: ch, minute: cmin });
+  const civilJdRaw = partsToJd({ year: cy, month: cm, day: cd, hour: ch, minute: cmin });
+  // 1986–1991 中国夏令时：先按钟面时间校正，再叠加真太阳时
+  const dst = input.dst === false ? { applied: false, note: null } : applyDst({ year: cy, month: cm, day: cd, hour: ch, minute: cmin });
+  const civilJd = dst.applied ? partsToJd({ year: dst.year, month: dst.month, day: dst.day, hour: dst.hour, minute: dst.minute }) : civilJdRaw;
   const solar = useTrueSolar
     ? applyTrueSolar(civilJd, longitude)
     : { offsetMinutes: 0, jd: civilJd, note: '未启用真太阳时' };
@@ -458,12 +462,13 @@ export function buildZiwei(input) {
       address: input.address || null,
       geo,
       trueSolar: useTrueSolar,
+      dst: { applied: !!dst.applied, note: dst.note || null },
     },
     solarTime: {
       civilText: `${cy}-${String(cm).padStart(2, '0')}-${String(cd).padStart(2, '0')} ${String(ch).padStart(2, '0')}:${String(cmin).padStart(2, '0')}`,
       trueSolarText: formatJd(solar.jd),
       offsetMinutes: solar.offsetMinutes,
-      note: solar.note,
+      note: dst.applied ? `${dst.note}；${solar.note}` : solar.note,
     },
     lunar: {
       year: lunarRaw.lunarYear,