guanwei 1.1.1

package/shared/core/engine/daily.ts

@@ -0,0 +1,133 @@
+// 每日星相 / 每日运势 / 每日星座（almanac + 行星近似 + 运势模板）
+import { Solar } from 'lunar-typescript';
+import { almanacOf } from './calendar';
+import { astrologyCalc } from './astrology';
+import { ZODIAC } from '../data/zodiac';
+import { mod } from '../data/ganzhi';
+
+export interface DailyAlmanac {
+  lunarText: string;
+  ganzhi: string;           // 干支日
+  shengxiao: string;
+  jieQi: string | null;
+  yueXiang: string;         // 月相
+  yi: string[];
+  ji: string[];
+  chong: string;
+  sha: string;
+  xingZuo: string;          // 当日太阳星座
+}
+
+export function dailyAlmanac(d = new Date()): DailyAlmanac {
+  const y = d.getFullYear(), m = d.getMonth() + 1, day = d.getDate();
+  const a = almanacOf(y, m, day);
+  const lunar = a.lunarText;
+  // 月相：lunar-typescript getYueXiang
+  const yueXiang = Solar.fromYmdHms(y, m, day, 12, 0, 0).getLunar().getYueXiang() || '';
+  return {
+    lunarText: lunar,
+    ganzhi: a.ganzhiDay,
+    shengxiao: a.shengxiao,
+    jieQi: a.jieQi,
+    yueXiang,
+    yi: a.yi.slice(0, 6),
+    ji: a.ji.slice(0, 6),
+    chong: a.chong,
+    sha: a.sha,
+    xingZuo: a.xingZuo,
+  };
+}
+
+export interface DailySky {
+  sunSign: string;
+  moonSign: string;
+  planets: { name: string; sign: string; deg: number }[];
+  yueXiang: string;
+}
+
+// 当日天象（行星近似位置）
+export function dailySky(d = new Date()): DailySky {
+  const y = d.getFullYear(), m = d.getMonth() + 1, day = d.getDate();
+  const r = astrologyCalc(y, m, day, 12, 0);
+  const planets = r.planets.map(([name]) => {
+    const p = r.planets.find(x => x[0] === name)!;
+    const s = Math.floor(mod(p[2], 360) / 30);
+    return { name, sign: ZODIAC[s][0], deg: Math.floor(mod(p[2], 30)) };
+  });
+  const sunSign = ZODIAC[Math.floor(r.sun / 30)][0];
+  const moonSign = ZODIAC[Math.floor(r.moon / 30)][0];
+  return { sunSign, moonSign, planets, yueXiang: dailyAlmanac(d).yueXiang };
+}
+
+// 十二星座当日运势模板（现代解读层语言）
+const FORTUNE_TEMPLATES: Record<string, string[]> = {
+  白羊座: [
+    '今日行动力充沛，适合推进搁置的计划。沟通时稍放缓语速，能避免不必要的摩擦。',
+    '精力旺盛但易急躁，重要决定放在午后做更稳妥。运动或户外活动有助于释放压力。',
+  ],
+  金牛座: [
+    '今日宜守成，财务上有小而稳的收获。亲近自然或整理居所，能让内心更加安定。',
+    '务实的一天，把待办一件件做完会很有成就感。注意饮食规律，别让忙碌挤掉三餐。',
+  ],
+  双子座: [
+    '今日思维活跃，适合学习、写作与交流。信息量较大，留意分辨哪些值得当真。',
+    '灵感如泉涌，不妨把想法记录下来。与旧友联系可能带来新的合作机会。',
+  ],
+  巨蟹座: [
+    '今日情绪感知敏锐，适合处理家庭与情感事务。表达需求比默默猜测更能靠近彼此。',
+    '内心柔软的一天，给自己留一点独处的时间。回忆过往时，记得只带走温暖的部分。',
+  ],
+  狮子座: [
+    '今日气场强大，适合展示才华与担当。在人群中你的声音会被听见，注意倾听他人的回应。',
+    '创造力旺盛，适合创作与表达。适度放下主角光环，合作反而更顺利。',
+  ],
+  处女座: [
+    '今日条理清晰，适合处理细节与规划。对完美的追求是礼物，但别让它变成苛责自己的鞭子。',
+    '效率很高的一天，适合整理与优化。留意健康信号，久坐后记得起身活动。',
+  ],
+  天秤座: [
+    '今日人际和谐，适合合作与协商。犹豫时先明确自己真正想要什么，平衡才有支点。',
+    '审美在线，适合布置环境或改善形象。一段需要平衡的关系值得你花时间经营。',
+  ],
+  天蝎座: [
+    '今日洞察力深邃，适合深入思考与解决问题。信任直觉，也记得给证据留位置。',
+    '内在力量强的一天，适合处理棘手事务。转化正在进行，允许旧模式慢慢离开。',
+  ],
+  射手座: [
+    '今日向往远方，适合学习、旅行或拓展视野。乐观是你的天赋，行动是它的翅膀。',
+    '好奇心旺盛，新的可能性正在浮现。先迈出一步，路线会在途中清晰。',
+  ],
+  摩羯座: [
+    '今日宜务实推进，长期目标值得投入时间。稳扎稳打的节奏，会在未来显现复利。',
+    '责任感强的一天，注意别把工作扛成一个人的事。适度示弱，团队会更稳固。',
+  ],
+  水瓶座: [
+    '今日思维独特，适合创新与独立工作。你的想法也许超前，耐心解释会让同路人更多。',
+    '社交能量足，群体活动带来启发。保持开放，也保留自己的节奏。',
+  ],
+  双鱼座: [
+    '今日共情力强，适合艺术、冥想与助人。记得给自己也留一份温柔，别把感受都让渡出去。',
+    '直觉敏锐的一天，梦境与灵感值得记录。边界感是保护，不是冷漠。',
+  ],
+};
+
+export interface DailyFortune {
+  sign: string;
+  text: string;
+  personalized: boolean;
+}
+
+/**
+ * 每日运势
+ * @param d 日期
+ * @param userSign 用户太阳星座（登录后按出生信息计算；未登录为当日太阳星座）
+ */
+export function dailyFortune(d = new Date(), userSign?: string): DailyFortune {
+  const sky = dailySky(d);
+  const sign = userSign || sky.sunSign + '座';
+  const pool = FORTUNE_TEMPLATES[sign] || FORTUNE_TEMPLATES['白羊座']!;
+  // 按日期取模板（同日稳定）
+  const daySeed = d.getDate() + d.getMonth() * 31;
+  const text = pool[daySeed % pool.length] + ' 黄历示：' + (dailyAlmanac(d).yi.slice(0, 2).join('、')) + '为宜。';
+  return { sign, text, personalized: !!userSign };
+}

package/shared/core/engine/liuren.ts

@@ -0,0 +1,86 @@
+// 大六壬：月将加时（中气定将）· 四课三传（简式）
+import { GAN, ZHI, mod } from '../data/ganzhi';
+import { LR_JIANGS, LR_JIANG_SUN, LR_GANJI } from '../data/liuren';
+import { daysSince, currentJieqiNameExact } from './calendar';
+import type { LiurenResult } from '../types';
+
+export function liurenCalc(dt: string | Date): LiurenResult {
+  const d = dt instanceof Date ? dt : new Date(dt);
+  const y = d.getFullYear(), m = d.getMonth() + 1, day = d.getDate();
+  const h = d.getHours();
+  const hourIndex = Math.floor(((h + 1) % 24) / 2); // 0=子
+  /* 日干支 */
+  const dIdx = mod(daysSince(y, m, day) + 55, 60);
+  const dayGZ = GAN[dIdx % 10] + ZHI[dIdx % 12];
+  const dgIdx = GAN.indexOf(dayGZ[0] as any);
+  const hgIdx = mod((dgIdx % 5) * 2 + hourIndex, 10);
+  const hourGZ = GAN[hgIdx] + ZHI[hourIndex];
+  /* 月将：中气定将（太阳过宫）；1/1-1/19 属上年冬至后 → 丑将，1/20 大寒后 → 子将 */
+  const v = m * 100 + day;
+  let jiang = '丑';
+  if (v >= 120 && v < 219) jiang = '子';
+  else if (v >= 219) {
+    for (let i = LR_JIANG_SUN.length - 2; i >= 0; i--) {
+      const [, jm, jd2, jz] = LR_JIANG_SUN[i];
+      if (v >= jm * 100 + jd2) { jiang = jz; break; }
+    }
+  }
+  const jiangIdx = ZHI.indexOf(jiang as any);
+  const jqName = currentJieqiNameExact(y, m, day);
+  /* 天盘：月将加时顺布 */
+  const tianpan: Record<number, string> = {};
+  for (let i = 0; i < 12; i++) tianpan[mod(hourIndex + i, 12)] = ZHI[mod(jiangIdx + i, 12)];
+  /* 四课 */
+  const ganJi = LR_GANJI[dayGZ[0]];
+  const ke1 = tianpan[ZHI.indexOf(ganJi as any)];
+  const ke2 = tianpan[ZHI.indexOf(ke1 as any)];
+  const ke3 = tianpan[ZHI.indexOf(dayGZ[1] as any)];
+  const ke4 = tianpan[ZHI.indexOf(ke3 as any)];
+  /* 三传（简式取传：依次取四课初传、中传、末传上神） */
+  const chuan1 = ke1, chuan2 = ke2, chuan3 = ke3;
+
+  /* ── 补齐层：贵人 + 十二天将 ── */
+  // 贵人起法（日干）：甲戊庚牛羊 乙己鼠猴乡 丙丁猪鸡位 壬癸兔蛇藏 六辛逢马虎
+  const GUIREN: Record<string, [string, string]> = {
+    甲: ['丑', '未'], 戊: ['丑', '未'], 庚: ['丑', '未'],
+    乙: ['子', '申'], 己: ['子', '申'],
+    丙: ['亥', '酉'], 丁: ['亥', '酉'],
+    壬: ['卯', '巳'], 癸: ['卯', '巳'],
+    辛: ['午', '寅'],
+  };
+  // 昼占：卯时至酉时前（hourIndex 2..7）；夜占：酉时至卯时前
+  const isDay = hourIndex >= 2 && hourIndex < 8;
+  const guiRen = (GUIREN[dayGZ[0]] || ['丑', '未'])[isDay ? 0 : 1];
+  // 天将序列（贵人起）：贵人 螣蛇 朱雀 六合 勾陈 青龙 天空 白虎 太常 玄武 太阴 天后
+  const JIANG_SEQ = ['贵人', '螣蛇', '朱雀', '六合', '勾陈', '青龙', '天空', '白虎', '太常', '玄武', '太阴', '天后'];
+  // 贵人加临天盘后定顺逆：贵人落支在亥子丑寅卯辰 → 顺布；巳午未申酉戌 → 逆布
+  const grIdx = ZHI.indexOf(guiRen as any);
+  const grPan = tianpan[grIdx];          // 贵人在天盘所加之支
+  const grPanIdx = ZHI.indexOf(grPan as any);
+  const forwardJiang = [10, 11, 0, 1, 2, 3].includes(grPanIdx); // 亥子丑寅卯辰顺
+  const tianJiang: Record<number, string> = {};
+  for (let i = 0; i < 12; i++) {
+    const step = forwardJiang ? i : -i;
+    tianJiang[mod(grPanIdx + step, 12)] = JIANG_SEQ[i];
+  }
+  const chuanJiang = [chuan1, chuan2, chuan3].map(ch => {
+    const cz = ZHI.indexOf(ch as any);
+    return { chuan: ch, jiang: tianJiang[cz] || '' };
+  });
+
+  /* ── 补齐层：课体分类（2026-08-20）── */
+  const hourZhi = ZHI[hourIndex];
+  let keti = '常课';
+  if (jiang === hourZhi) keti = '伏吟课';
+  else if (mod(ZHI.indexOf(jiang as any) - hourIndex, 12) === 6) keti = '反吟课';
+  const ketiNote = keti === '伏吟课' ? '天地盘同位，诸事迟滞反复，宜静待其变，不宜躁进。'
+    : keti === '反吟课' ? '天地盘相冲，事有反复翻覆，来去无常，宜缓不宜急。'
+    : '四课三传乘常气，事机明朗，顺其自然即可。';
+
+  return { dayGZ, hourGZ, jiang, jqName, tianpan, ganJi, ke1, ke2, ke3, ke4, chuan1, chuan2, chuan3, guiRen, isDay, tianJiang, chuanJiang, keti, ketiNote };
+}
+
+export const jiangName = (zhi: string): string => {
+  const row = LR_JIANGS.find(j => j[1] === zhi);
+  return row ? row[0] : zhi;
+}

package/shared/core/engine/liuyao.ts

@@ -0,0 +1,93 @@
+// 六爻：三枚铜钱摇卦（rng 可注入，保证测试可复现）+ 纳甲筮法（补齐层）
+import { GUA_LOOKUP } from '../data/gua64';
+import { GONG_SH, NAJIA, GONG_WX, SHEN_LIU, GAN_WX, ZHI_WX, liuqin } from '../data/liuyao';
+import { daysSince, monthBranchOf } from './calendar';
+import type { LiuyaoResult } from '../types';
+
+const GAN = ['甲', '乙', '丙', '丁', '戊', '己', '庚', '辛', '壬', '癸'];
+const ZHI = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
+const mod = (a: number, n: number) => ((a % n) + n) % n;
+
+// 起卦日期信息（可选）：日干支/月支 → 六神/月破/旬空
+export interface LiuyaoDateInfo { y: number; m: number; d: number }
+
+const BIT_TO_BA: Record<number, number> = { 7: 1, 6: 2, 5: 3, 4: 4, 3: 5, 2: 6, 1: 7, 0: 8 };
+
+// mulberry32 固定种子随机（测试用）
+export function mulberry32(seed: number): () => number {
+  let a = seed >>> 0;
+  return () => {
+    a |= 0; a = (a + 0x6D2B79F5) | 0;
+    let t = Math.imul(a ^ (a >>> 15), 1 | a);
+    t = (t + Math.imul(t ^ (t >>> 7), 61 | t)) ^ t;
+    return ((t ^ (t >>> 14)) >>> 0) / 4294967296;
+  };
+}
+
+export function liuyaoCalc(rng: () => number = Math.random, date?: LiuyaoDateInfo): LiuyaoResult {
+  const yao: number[] = [];
+  const names: { v: number; nm: string; backs: number }[] = [];
+  for (let i = 0; i < 6; i++) {
+    const backs = Math.floor(rng() * 4); // 0-3
+    let v: number, nm: string;
+    if (backs === 0) { v = 0; nm = '老阴'; }
+    else if (backs === 1) { v = 1; nm = '少阳'; }
+    else if (backs === 2) { v = 0; nm = '少阴'; }
+    else { v = 1; nm = '老阳'; }
+    yao.push(v);
+    names.push({ v, nm, backs });
+  }
+  const lB = BIT_TO_BA[yao[0] * 4 + yao[1] * 2 + yao[2]];
+  const uB = BIT_TO_BA[yao[3] * 4 + yao[4] * 2 + yao[5]];
+  const benGua = GUA_LOOKUP[uB * 10 + lB]!;
+  const bianYao = yao.map((v, i) => (names[i].nm === '老阴' || names[i].nm === '老阳') ? 1 - v : v);
+  const lB2 = BIT_TO_BA[bianYao[0] * 4 + bianYao[1] * 2 + bianYao[2]];
+  const uB2 = BIT_TO_BA[bianYao[3] * 4 + bianYao[4] * 2 + bianYao[5]];
+  const bianGua = GUA_LOOKUP[uB2 * 10 + lB2]!;
+  const dongYao: number[] = [];
+  names.forEach((n, i) => { if (n.nm === '老阴' || n.nm === '老阳') dongYao.push(i + 1); });
+
+  // ─── 补齐层：纳甲筮法（需起卦日期）───
+  let najia: LiuyaoResult['najia'] = undefined;
+  if (date) {
+    const gs = GONG_SH[benGua.name];
+    if (gs) {
+      const gz6 = NAJIA[gs.gong] || [];
+      // 日干支（历元 +55）与月支
+      const dIdx = mod(daysSince(date.y, date.m, date.d) + 55, 60);
+      const dayGZ = GAN[dIdx % 10] + ZHI[dIdx % 12];
+      const monthZhi = ZHI[mod(2 + monthBranchOf(date.y, date.m, date.d, 12), 12)];
+      // 六神（日干起，初爻→上爻）
+      const shenSeq = SHEN_LIU[dayGZ[0]] || [];
+      // 月破：月支之冲（±6）
+      const mIdx = ZHI.indexOf(monthZhi);
+      const yuePo = [ZHI[mod(mIdx + 6, 12)]];
+      // 旬空：日柱所在旬
+      const xunStart = dIdx - (dIdx % 10);
+      const xunKong = [ZHI[mod(xunStart + 10, 12)], ZHI[mod(xunStart + 11, 12)]];
+      // 世应
+      const shiPos = gs.shi;
+      const yingPos = mod(shiPos + 2, 6) + 1;
+      const gongWx = GONG_WX[gs.gong] || '金';
+      const lines = gz6.map((gz, i) => {
+        const zhi = gz[1];
+        return {
+          gz,
+          ganWx: GAN_WX[gz[0]] || '',
+          zhiWx: ZHI_WX[zhi] || '',
+          liuqin: liuqin(gongWx, ZHI_WX[zhi] || ''),
+          shen: shenSeq[i] || '',
+          isShi: i + 1 === shiPos,
+          isYing: i + 1 === yingPos,
+          kong: xunKong.includes(zhi),
+        };
+      });
+      najia = {
+        gong: gs.gong, lines, shiPos, yingPos,
+        dayGZ, monthZhi, yuePo, xunKong,
+        shiLiQin: lines[shiPos - 1]?.liuqin || '',
+      };
+    }
+  }
+  return { yao, names, benGua, bianGua, dongYao, najia };
+}

package/shared/core/engine/meihua.ts

@@ -0,0 +1,87 @@
+// 梅花易数：时间 / 报数起卦（本卦/互卦/变卦 + 体用生克）
+import { GUA_LOOKUP, BAGUA, type GuaEntry } from '../data/gua64';
+import { ZHI, mod } from '../data/ganzhi';
+import { Solar } from 'lunar-typescript';
+import type { MeihuaInput, MeihuaResult } from '../types';
+
+// 八卦 0-7 编码（自下而上，阳1阴0）
+const GUA_BITS: Record<number, number[]> = { 1: [1,1,1], 2: [1,1,0], 3: [1,0,1], 4: [1,0,0], 5: [0,1,1], 6: [0,1,0], 7: [0,0,1], 8: [0,0,0] };
+const BIT_TO_BA: Record<number, number> = { 7: 1, 6: 2, 5: 3, 4: 4, 3: 5, 2: 6, 1: 7, 0: 8 };
+
+function guaFromYao(yao: number[]): GuaEntry | null {
+  const l = yao[0] * 4 + yao[1] * 2 + yao[2];
+  const u = yao[3] * 4 + yao[4] * 2 + yao[5];
+  return GUA_LOOKUP[BIT_TO_BA[u] * 10 + BIT_TO_BA[l]] || null;
+}
+
+export function meihuaCalc(input: MeihuaInput): MeihuaResult {
+  let upper: number, lower: number, move: number;
+  if (input.mode === 'time') {
+    const d = input.now || new Date();
+    const y = d.getFullYear(), m = d.getMonth() + 1, day = d.getDate(), h = d.getHours();
+    const hourIndex = Math.floor(((h + 1) % 24) / 2) + 1;
+    // 传统邵雍法：年支数 + 农历月 + 农历日（2026-08-20 修正：原误用公历月日）
+    const lunar = Solar.fromYmdHms(y, m, day, h, 0, 0).getLunar();
+    const lm = Math.abs(lunar.getMonth());
+    const lday = lunar.getDay();
+    const yzNum = ZHI.indexOf(lunar.getYearInGanZhi()[1] as any) + 1;
+    const sum1 = yzNum + lm + lday;
+    upper = mod(sum1 - 1, 8) + 1;
+    const sum2 = sum1 + hourIndex;
+    lower = mod(sum2 - 1, 8) + 1;
+    move = mod(sum2 - 1, 6) + 1;
+  } else {
+    upper = mod(((input.n1 ?? 1) - 1), 8) + 1;
+    lower = mod(((input.n2 ?? 1) - 1), 8) + 1;
+    move = mod(((input.n3 ?? 1) - 1), 6) + 1;
+  }
+  const lb = GUA_BITS[lower], ub = GUA_BITS[upper];
+  const benYao = [lb[0], lb[1], lb[2], ub[0], ub[1], ub[2]];
+  const bianYao = benYao.map((v, i) => i === move - 1 ? 1 - v : v);
+  const huLower = [benYao[1], benYao[2], benYao[3]];
+  const huUpper = [benYao[2], benYao[3], benYao[4]];
+  const benGua = guaFromYao(benYao)!;
+  const bianGua = guaFromYao(bianYao)!;
+  const huGua = GUA_LOOKUP[BIT_TO_BA[huUpper[0] * 4 + huUpper[1] * 2 + huUpper[2]] * 10 + BIT_TO_BA[huLower[0] * 4 + huLower[1] * 2 + huLower[2]]] || null;
+  /* 体用：动爻在初/二/三爻 → 用在下卦；四/五/上 → 用在上卦 */
+  const yongIsLower = move <= 3;
+  const tiGua = yongIsLower ? upper : lower;
+  const yongGua = yongIsLower ? lower : upper;
+  const tiWx = BAGUA[tiGua].wx, yongWx = BAGUA[yongGua].wx;
+  const wxOrder2 = ['木', '火', '土', '金', '水'];
+  const rel = mod(wxOrder2.indexOf(yongWx) - wxOrder2.indexOf(tiWx), 5);
+  const shengkeMap: Record<number, string> = { 1: '用生体，吉', 4: '体克用，吉', 2: '用克体，凶', 3: '体生用，泄气' };
+  const shengke = shengkeMap[rel] || '体用比和，平';
+
+  /* ── 补齐层：旺衰时令（月令卦气）── */
+  let monthWx: string | undefined;
+  let tiWangShuai: MeihuaResult['tiWangShuai'];
+  let yongWangShuai: MeihuaResult['yongWangShuai'];
+  let wangShuaiNote: string | undefined;
+  if (input.mode === 'time') {
+    const d = input.now || new Date();
+    const lunar = Solar.fromYmdHms(d.getFullYear(), d.getMonth() + 1, d.getDate(), d.getHours(), 0, 0).getLunar();
+    // 月支五行（农历月：寅=正月...丑=腊月）
+    const ZHI2 = ['寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥', '子', '丑'];
+    const lm = Math.abs(lunar.getMonth());
+    const mz = ZHI2[(lm - 1 + 12) % 12];
+    const ZHI_WX: Record<string, string> = { 寅: '木', 卯: '木', 辰: '土', 巳: '火', 午: '火', 未: '土', 申: '金', 酉: '金', 戌: '土', 亥: '水', 子: '水', 丑: '土' };
+    monthWx = ZHI_WX[mz];
+    // 旺相休囚死：旺=同令 相=令生 休=生令者 囚=克令者 死=被令克
+    const wxOrder = ['木', '火', '土', '金', '水'];
+    const mIdx = wxOrder.indexOf(monthWx as any);
+    const wsOf = (wx: string): '旺' | '相' | '休' | '囚' | '死' => {
+      const rel2 = mod(wxOrder.indexOf(wx) - mIdx, 5);
+      return rel2 === 0 ? '旺' : rel2 === 1 ? '死' : rel2 === 2 ? '囚' : rel2 === 3 ? '休' : '相';
+    };
+    tiWangShuai = wsOf(tiWx);
+    yongWangShuai = wsOf(yongWx);
+    // 吉凶加成：体旺用衰→大吉；体衰用旺→力不从心
+    const tiRank = ['旺', '相', '休', '囚', '死'].indexOf(tiWangShuai);
+    const yongRank = ['旺', '相', '休', '囚', '死'].indexOf(yongWangShuai);
+    if (tiRank < yongRank) wangShuaiNote = '体卦' + tiWangShuai + '、用卦' + yongWangShuai + '：体气胜于用气，所占之事主方占优，吉象更实。';
+    else if (tiRank > yongRank) wangShuaiNote = '体卦' + tiWangShuai + '、用卦' + yongWangShuai + '：用气胜于体气，所占之事客方势强，宜缓图之。';
+    else wangShuaiNote = '体用卦气同' + tiWangShuai + '：势均力敌，成败系于' + (tiWangShuai === '旺' ? '当下时令之助' : '行运之机');
+  }
+  return { upper, lower, move, benGua, bianGua, huGua, tiGua, yongGua, tiWx, yongWx, shengke, benYao, monthWx, tiWangShuai, yongWangShuai, wangShuaiNote };
+}

package/shared/core/engine/qimen.ts

@@ -0,0 +1,78 @@
+// 奇门遁甲：演示级九宫起局（精确节气定阴阳遁，三候取局）
+import { GAN, ZHI, mod } from '../data/ganzhi';
+import { QM_SEASONS, QM_STARS, QM_MEN, LUOSHU } from '../data/qimen';
+import { daysSince, currentJieqiNameExact } from './calendar';
+import type { QimenInput, QimenResult } from '../types';
+
+export function qimenCalc(input: QimenInput): QimenResult {
+  const d = input.datetime instanceof Date ? input.datetime : new Date(input.datetime);
+  const y = d.getFullYear(), m = d.getMonth() + 1, day = d.getDate();
+  const h = d.getHours();
+  /* 日干支 */
+  const dIdx = mod(daysSince(y, m, day) + 55, 60);
+  const dayGZ = GAN[dIdx % 10] + ZHI[dIdx % 12];
+  /* 时干支 */
+  const hourIndex = Math.floor(((h + 1) % 24) / 2);
+  const dgIdx = GAN.indexOf(dayGZ[0] as any);
+  const hgIdx = mod((dgIdx % 5) * 2 + hourIndex, 10);
+  const hourGZ = GAN[hgIdx] + ZHI[hourIndex];
+  /* 节气 → 阴阳遁（精确：当前所处节气） */
+  const jqName = currentJieqiNameExact(y, m, day);
+  const season = QM_SEASONS.find(s => s.name === jqName);
+  if (!season) throw new Error('节气未找到: ' + jqName);
+  const yin = season.yin;
+  /* 候（三元）：按日数粗略取元 */
+  const xun = Math.floor(day / 5) % 3;
+  const ju = season.ju[xun];
+  /* 旬首六仪（由时干定） */
+  const xunshouMap: Record<string, string> = { 戊: '甲子', 己: '甲戌', 庚: '甲申', 辛: '甲午', 壬: '甲辰', 癸: '甲寅' };
+  const hourGan = hourGZ[0];
+  const xunShou = ['戊', '己', '庚', '辛', '壬', '癸'].includes(hourGan) ? hourGan : '戊';
+  /* 地盘布奇仪：阳遁顺布（1→8→3→4→9→2→7→6→中5），阴遁逆布 */
+  const qiyiOrder = ['戊', '己', '庚', '辛', '壬', '癸', '丁', '丙', '乙'];
+  const yiAt: Record<number, string> = {};
+  const pan: QimenResult['pan'] = {};
+  for (let i = 0; i < 9; i++) {
+    const palace = yin ? mod(ju - 1 - i, 9) + 1 : mod(ju - 1 + i, 9) + 1;
+    yiAt[palace] = qiyiOrder[i];
+    pan[palace] = { yi: qiyiOrder[i], men: '', star: '' };
+  }
+  /* 值符宫 = 旬首六仪所在宫；值符星/值使门 = 该宫九星八门 */
+  const zfPalace = Number(Object.keys(yiAt).find(p => yiAt[Number(p)] === xunShou) || 1);
+  const zfStar = QM_STARS[zfPalace - 1];
+  const zsMen = QM_MEN[zfPalace - 1];
+  /* 八门：从值符宫起按宫序顺布；九星按洛书固定 */
+  const menOrder = ['休', '生', '伤', '杜', '景', '死', '惊', '开'];
+  const starOrder = ['天蓬', '天任', '天冲', '天辅', '天英', '天芮', '天柱', '天心'];
+  LUOSHU.forEach((p, i) => {
+    pan[p].star = starOrder[i];
+    const mIdx = mod(i - (LUOSHU.indexOf(zfPalace) - 1), 8);
+    pan[p].men = menOrder[mIdx];
+  });
+  pan[5] = { yi: '中', star: '天禽', men: '' };
+
+  /* ── 补齐层：值使落宫 + 天盘奇仪（暗干）+ 八神 ── */
+  // 值使门随时干落宫：时干在地盘所在宫
+  const zsPalace = Number(Object.keys(yiAt).find(p => yiAt[Number(p)] === hourGZ[0]) || zfPalace);
+  // 天盘奇仪（暗干）：从值符宫（值符随时干）起，阳遁顺布、阴遁逆布（洛书序）
+  const tianYi: Record<number, string> = {};
+  const qiyiFromXun = qiyiOrder.slice(qiyiOrder.indexOf(xunShou)); // 旬首起
+  const seq = [...qiyiFromXun, ...qiyiOrder.slice(0, qiyiOrder.indexOf(xunShou))]; // 六仪三奇环序
+  const zsIdx = LUOSHU.indexOf(zsPalace);
+  LUOSHU.forEach((p, i) => {
+    const step = yin ? mod(zsIdx - i, 9) : mod(zsIdx + i, 9);
+    tianYi[p] = seq[step];
+  });
+  tianYi[5] = '';
+  // 八神：值符 螣蛇 太阴 六合 白虎 玄武 九地 九天；从值符宫起，阳顺阴逆布八宫（中宫不入）
+  const shenSeq = ['值符', '螣蛇', '太阴', '六合', '白虎', '玄武', '九地', '九天'];
+  const shen: Record<number, string> = {};
+  const shenPalaces = LUOSHU.filter(p => p !== 5);
+  const zfIdx = shenPalaces.indexOf(zfPalace);
+  shenPalaces.forEach((p, i) => {
+    const step = yin ? mod(zfIdx - i, 8) : mod(zfIdx + i, 8);
+    shen[p] = shenSeq[step];
+  });
+  shen[5] = '';
+  return { yin, ju, jqName, dayGZ, hourGZ, xunShou, xunshouName: xunshouMap[xunShou] || '', zfStar, zsMen, zfPalace, pan, zsPalace, tianYi, shen };
+}

package/shared/core/engine/questionFit.ts

@@ -0,0 +1,94 @@
+// 问题适配性分析：识别问题域 → 对照九术适配矩阵 → 判定适合度与建议
+
+export type QuestionDomain =
+  | 'timing' | 'direction' | 'lost' | 'decision' | 'love'
+  | 'career' | 'wealth' | 'health' | 'person' | 'mind' | 'general';
+
+export interface QuestionFit {
+  domain: QuestionDomain;
+  domainLabel: string;
+  suitable: boolean | 'partial';
+  reason: string;
+  suggestion: string;
+  betterArts: string[];
+}
+
+const DOMAIN_KEYWORDS: { domain: QuestionDomain; label: string; words: string[] }[] = [
+  { domain: 'timing', label: '时机择日', words: ['何时', '什么时候', '几时', '时机', '宜不宜', '该不该现在', '择日', '哪天'] },
+  { domain: 'direction', label: '方位出行', words: ['方位', '方向', '往哪', '去哪里', '哪个方向', '出行', '旅行', '出差', '搬家', '风水', '搬迁'] },
+  { domain: 'lost', label: '寻物', words: ['失物', '丢了', '找不到', '丢哪', '找回', '寻找', '不见了'] },
+  { domain: 'decision', label: '抉择决策', words: ['该不该', '要不要', '能不能', '是否', '选择', '抉择', '答应', '接受', '拒绝', '跳槽', '辞职', '值不值得', '可不可以'] },
+  { domain: 'love', label: '情感婚姻', words: ['感情', '爱情', '恋爱', '复合', '分手', '喜欢', '表白', '婚姻', '结婚', '前任', '对象', '暧昧', '相亲'] },
+  { domain: 'career', label: '事业学业', words: ['工作', '事业', '面试', '升职', 'offer', '老板', '同事', '创业', '考试', '考研', '晋升', '加薪', '项目', '合作'] },
+  { domain: 'wealth', label: '财运投资', words: ['钱', '财运', '投资', '股票', '基金', '赚钱', '收入', '债务', '还债', '买房', '理财', '生意'] },
+  { domain: 'health', label: '健康', words: ['健康', '病', '身体', '失眠', '手术', '治疗', '检查', '康复'] },
+  { domain: 'person', label: '人事关系', words: ['同事', '朋友', '合伙', '关系', '对方', '团队', '领导', '上司', '客户', '贵人', '婆媳'] },
+  { domain: 'mind', label: '心理自我', words: ['性格', '心理', '迷茫', '焦虑', '成长', '灵性', '自我', '状态', '怎么办', '心里', '情绪', '人生方向'] },
+];
+
+const FIT_MATRIX: Record<string, Partial<Record<QuestionDomain, boolean | 'partial'>>> = {
+  qimen:      { timing: true, direction: true, decision: true, wealth: true, career: true, lost: 'partial', person: 'partial', love: false, mind: false, health: false },
+  liuyao:     { decision: true, career: true, wealth: true, lost: true, person: true, love: 'partial', health: 'partial', timing: 'partial', direction: 'partial', mind: false },
+  meihua:     { decision: true, career: true, wealth: true, lost: true, love: true, person: true, timing: 'partial', direction: 'partial', health: 'partial', mind: 'partial' },
+  xiaoliuren: { timing: true, decision: true, lost: true, direction: 'partial', career: 'partial', wealth: 'partial', love: 'partial', mind: false, person: 'partial' },
+  liuren:     { person: true, career: true, decision: true, love: true, wealth: true, lost: true, health: 'partial', timing: 'partial', direction: 'partial', mind: 'partial' },
+  tarot:      { love: true, mind: true, decision: true, career: 'partial', wealth: 'partial', person: 'partial', health: 'partial', timing: false, direction: false, lost: false },
+  bazi:       { career: true, wealth: true, love: true, health: true, mind: true, person: 'partial', decision: 'partial', timing: 'partial', direction: 'partial', lost: false },
+  ziwei:      { career: true, wealth: true, love: true, health: true, mind: true, person: 'partial', decision: 'partial', timing: 'partial', direction: 'partial', lost: false },
+  astrology:  { career: true, wealth: true, love: true, health: true, mind: true, person: 'partial', decision: 'partial', timing: 'partial', direction: 'partial', lost: false },
+};
+
+export function detectDomain(question: string): { domain: QuestionDomain; label: string } {
+  const q = question || '';
+  // 最长关键词优先（更具体的语义胜出，如「人生方向」优先于「往哪」）
+  let best: { domain: QuestionDomain; label: string; len: number } | null = null;
+  for (const d of DOMAIN_KEYWORDS) {
+    for (const w of d.words) {
+      if (q.includes(w) && (!best || w.length > best.len)) {
+        best = { domain: d.domain, label: d.label, len: w.length };
+      }
+    }
+  }
+  return best ? { domain: best.domain, label: best.label } : { domain: 'general', label: '综合' };
+}
+const ART_STRENGTH: Record<string, { good: string; bad: string; suggest: string }> = {
+  qimen: { good: '择时出行、方位趋避、谋事成败、财运契机——凡问时机方位者最契', bad: '情感内心、性格心理之事', suggest: '若问感情，宜改为问「与某人发展之机，何时宜动、何方可往」；若问心理成长，宜用塔罗或命盘观照。' },
+  liuyao: { good: '一事之吉凶成败、谋事、寻物、考试、求财、讼事——凡问具体事务者最契', bad: '抽象的心理性格、长期人生格局', suggest: '若问性格人生，宜以八字/紫微/星盘观格局；若问内心状态，塔罗更宜观照。' },
+  meihua: { good: '心动即占，万象皆可问——时、事、情、财皆可成卦', bad: '（几乎无所不包，仅深度有限）', suggest: '若需更深之命理格局，可再以八字/紫微参详。' },
+  xiaoliuren: { good: '一时一事之吉凶、即时决策、寻物、出行——快捷问占最契', bad: '长期人生格局、深层心理', suggest: '若问长期格局，宜用八字/紫微排盘；若问深层心理，塔罗更宜。' },
+  liuren: { good: '人事往来、合作、婚姻、出行、疾病、失物——人事之王，人事问题最契', bad: '（所长人事，抽象心理为次）', suggest: '若问纯心理状态，塔罗或命盘观照更宜。' },
+  tarot: { good: '情感关系、内心观照、选择困惑、自我成长——镜鉴之心最契', bad: '择时、方位、失物等客观吉凶', suggest: '若问何时宜动、何方可往，宜用奇门遁甲；若问失物，六爻或小六壬更契。' },
+  bazi: { good: '性格格局、事业财运、婚姻感情、人生阶段——命理之经纬', bad: '一时一事的即时吉凶', suggest: '若问即时之事（如出行吉凶、能否成事），宜用六爻/小六壬/奇门起占。' },
+  ziwei: { good: '命盘格局、十二宫人生领域、大限流年——星命之宫垣', bad: '一时一事的即时吉凶', suggest: '若问即时之事，宜用六爻/小六壬/奇门起占。' },
+  astrology: { good: '性格天赋、人生轨迹、行星宫位相位——天穹为书', bad: '一时一事的即时吉凶', suggest: '若问即时之事，宜用六爻/小六壬/奇门起占。' },
+};
+
+export const artNameOf = (id: string): string => {
+  const map: Record<string, string> = {
+    bazi: '四柱八字', ziwei: '紫微斗数', qimen: '奇门遁甲', meihua: '梅花易数',
+    liuyao: '六爻', liuren: '大六壬', xiaoliuren: '小六壬', astrology: '星盘', tarot: '塔罗',
+  };
+  return map[id] || id;
+}
+
+export function analyzeQuestionFit(artId: string, question: string): QuestionFit {
+  const { domain, label } = detectDomain(question);
+  const matrix = FIT_MATRIX[artId] || {};
+  const suitable = matrix[domain] ?? 'partial';
+  const strength = ART_STRENGTH[artId] || ART_STRENGTH.qimen;
+  const artName = artNameOf(artId);
+  const betterArts = Object.keys(FIT_MATRIX).filter(a => a !== artId && FIT_MATRIX[a][domain] === true);
+  let reason: string;
+  let suggestion: string;
+  if (suitable === true) {
+    reason = '此问属「' + label + '」，恰契' + strength.good + '。';
+    suggestion = '';
+  } else if (suitable === 'partial') {
+    reason = '此问属「' + label + '」，与' + artName + '之道部分相契（' + strength.good + '）。以下解读以参详为度。';
+    suggestion = (betterArts.length ? '若求更应之占，可试' + betterArts.map(artNameOf).join('、') + '。' : '') + strength.suggest;
+  } else {
+    reason = '此问属「' + label + '」，与' + artName + '之道不甚相契（' + artName + '所长在' + strength.good + '；' + strength.bad + '非其所长）。以下解读仅供建议参详，不作定论。';
+    suggestion = (betterArts.length ? '建议更换问题方向：' + betterArts.map(artNameOf).join('、') + '更宜此类之问。' : '') + strength.suggest;
+  }
+  return { domain, domainLabel: label, suitable, reason, suggestion, betterArts };
+}

package/shared/core/engine/tarot.ts

@@ -0,0 +1,69 @@
+// 塔罗：78 张牌池构建与抽牌（rng 可注入）
+import type { TarotCardData } from '../types';
+
+export const MAJOR: [string, string, string, string, string][] = [
+  ['愚者', 'The Fool', '0', '新的开始，赤诚无惧', '轻率冒进，需防不测'],
+  ['魔术师', 'The Magician', 'Ⅰ', '万事俱备，主动创造', '空有巧言，志大才疏'],
+  ['女祭司', 'The High Priestess', 'Ⅱ', '静观内省，直觉为引', '心绪不宁，忽略心声'],
+  ['皇后', 'The Empress', 'Ⅲ', '丰饶滋养，温情守成', '过度依赖，失去自我'],
+  ['皇帝', 'The Emperor', 'Ⅳ', '秩序权威，稳如磐石', '刚愎自用，压迫过甚'],
+  ['教皇', 'The Hierophant', 'Ⅴ', '师道传承，循规蹈矩', '固步自封，迷信权威'],
+  ['恋人', 'The Lovers', 'Ⅵ', '因缘和合，抉择真心', '摇摆不定，两难纠缠'],
+  ['战车', 'The Chariot', 'Ⅶ', '意志坚定，克敌制胜', '方向迷失，欲速不达'],
+  ['力量', 'Strength', 'Ⅷ', '以柔克刚，心怀慈悲', '外强中干，情绪失控'],
+  ['隐士', 'The Hermit', 'Ⅸ', '独行求索，内观得光', '孤僻避世，灯下黑处'],
+  ['命运之轮', 'Wheel of Fortune', 'Ⅹ', '时来运转，顺势而为', '逆势而行，运去如山'],
+  ['正义', 'Justice', 'Ⅺ', '明辨是非，因果自承', '偏颇失衡，判而不公'],
+  ['倒吊人', 'The Hanged Man', 'Ⅻ', '换位而思，以退为进', '徒劳挣扎，自缚其身'],
+  ['死神', 'Death', 'XIII', '旧我蜕去，置之死地', '抗拒变化，僵而不化'],
+  ['节制', 'Temperance', 'XIV', '中和之道，细水长流', '过犹不及，失却分寸'],
+  ['恶魔', 'The Devil', 'XV', '欲望枷锁，直面其缚', '沉沦诱惑，作茧自缚'],
+  ['高塔', 'The Tower', 'XVI', '骤变破立，否极泰来', '自毁根基，殃及池鱼'],
+  ['星星', 'The Star', 'XVII', '希望如泉，静待天明', '希望渺茫，心灰意冷'],
+  ['月亮', 'The Moon', 'XVIII', '迷雾幻影，信直觉行', '自欺欺人，暗潮汹涌'],
+  ['太阳', 'The Sun', 'XIX', '光明坦途，赤子之心', '骄阳过盛，乐极生悲'],
+  ['审判', 'Judgement', 'XX', '觉醒回响，往事如鉴', '逃避清算，旧账难翻'],
+  ['世界', 'The World', 'XXI', '圆满成就，归于一统', '功亏一篑，未竟全功'],
+];
+
+export const SUIT: Record<string, { e: string; mean: string }> = {
+  权杖: { e: '火', mean: '行动 · 意志 · 热情' },
+  圣杯: { e: '水', mean: '情感 · 关系 · 直觉' },
+  宝剑: { e: '风', mean: '思虑 · 冲突 · 决断' },
+  钱币: { e: '土', mean: '物质 · 事业 · 收获' },
+};
+
+export const SUIT_NUM: Record<number, string> = {
+  1: '开端之机', 2: '权衡之局', 3: '萌芽之聚', 4: '安定之基', 5: '中道之争',
+  6: '馈赠之得', 7: '坚守之成', 8: '推进之势', 9: '独处之思', 10: '圆满之极',
+};
+
+export const COURT: Record<string, string> = {
+  侍从: '初学 · 讯息 · 探问', 骑士: '奔赴 · 行动 · 挑战', 王后: '滋养 · 内在 · 承接', 国王: '统御 · 外显 · 成就',
+};
+
+export function buildDeck(): Omit<TarotCardData, 'reversed'>[] {
+  const deck: Omit<TarotCardData, 'reversed'>[] = [];
+  MAJOR.forEach(c => deck.push({ name: c[0], en: c[1], num: c[2], up: c[3], rev: c[4], major: true }));
+  Object.keys(SUIT).forEach(s => {
+    const base: Record<string, string> = { 权杖: '谋事主动，进取之机', 圣杯: '情感流动，心之所向', 宝剑: '思虑交锋，慎言决断', 钱币: '落地生根，务实之得' };
+    for (let n = 1; n <= 10; n++) {
+      deck.push({ name: s + n, en: s + ' ' + n, up: base[s] + ' · ' + SUIT_NUM[n], rev: base[s] + ' · 此数未成', major: false, suit: s, num: String(n) });
+    }
+    Object.keys(COURT).forEach(k => {
+      deck.push({ name: s + k, en: s + ' ' + k, up: SUIT[s].mean + ' · ' + COURT[k], rev: SUIT[s].mean + ' · 此位未稳', major: false, suit: s, num: k });
+    });
+  });
+  return deck;
+}
+
+export function tarotDraw(n: number, rng: () => number = Math.random): TarotCardData[] {
+  const deck = buildDeck();
+  const picked: TarotCardData[] = [];
+  while (picked.length < n) {
+    const idx = Math.floor(rng() * deck.length);
+    const card = deck.splice(idx, 1)[0];
+    picked.push({ ...card, reversed: rng() < 0.5 });
+  }
+  return picked;
+}