guanwei 1.1.1

package/shared/core/types.ts

@@ -0,0 +1,206 @@
+// 观微 · shared/core 通用类型（前后端共享，物理单一副本）
+
+export type ArtId =
+  | 'bazi' | 'ziwei' | 'qimen' | 'meihua' | 'liuyao'
+  | 'liuren' | 'xiaoliuren' | 'astrology' | 'tarot';
+
+// 出生地点（省市县区 → 经纬度）
+export interface GeoLocation {
+  province: string;
+  city: string;
+  district: string;
+  lng: number;   // 东经正数
+  lat: number;   // 北纬正数
+}
+
+// 真太阳时结果
+export interface TrueSolarTime {
+  beijingHours: number;      // 北京时间（小时，含分钟小数）
+  localMeanHours: number;    // 本地平太阳时
+  trueSolarHours: number;    // 真太阳时
+  eotMinutes: number;        // 均时差（分钟）
+  hourIndex: number;         // 校正后时辰序 0=子
+  dateOffset: number;        // 相对北京时间的日期偏移（0 或 ±1）
+}
+
+// 八字输入输出
+export interface BaziInput {
+  y: number; m: number; d: number;
+  hourIndex: number;         // 0-11
+  time?: string;              // 精确出生时刻 HH:MM（有 location 时以此做真太阳时校正）
+  gender: '男' | '女';
+  location?: GeoLocation;    // 提供时做真太阳时校正
+}
+export interface BaziResult {
+  yearGZ: string; monthGZ: string; dayGZ: string; hourGZ: string;
+  dayGan: string; dayGanWx: string;
+  wxCount: Record<string, number>;
+  shishen: { gan: string; name: string }[];
+  strength: '身强' | '身弱' | '中和';
+  support: number; drain: number;
+  nayin: string;
+  correctedHourIndex: number;
+  trueSolar?: TrueSolarTime;
+  // ─── 补齐层（2026-08-20 排盘要点调研）───
+  canggan: { zhi: string; gans: { gan: string; wx: string; shishen: string; qi: '本气' | '中气' | '余气' }[] }[];  // 四支藏干 + 十神
+  wxWeighted: Record<string, number>;          // 含藏干权重的五行分
+  strengthDetail: { score: number; ling: number; gen: number; shi: number; reasons: string[] };  // 旺衰拆解
+  yongshen: { wx: string; shishen: string; xi: string[]; ji: string[]; tiaohou: string; reason: string };  // 用神/喜忌
+  dayun: { gz: string; ganShishen: string; zhiShishen: string; startAge: number; startYear: number; endYear: number; forward: boolean }[];  // 大运
+  qiYun: { startAge: number; startMonth: number; detail: string };  // 起运
+  liunian: { year: number; gz: string; ganShishen: string; zhiShishen: string };  // 流年（当前年）
+  shensha: { name: string; zhi: string; type: '吉' | '平' | '凶' }[];  // 神煞
+  taiyuan: string;   // 胎元
+  minggong: string;  // 命宫
+  shengong: string;  // 身宫
+  geju: { name: string; gan: string; shishen: string; basis: string };  // 月令取格
+}
+
+// 紫微输入输出
+export interface ZiweiInput {
+  ganzhi: string;            // 如 癸酉
+  month: number; day: number; hour: number;
+  time?: string;              // 精确出生时刻 HH:MM（有 location 时以此校正时辰）
+  location?: GeoLocation;
+  gender?: '男' | '女';
+  birthYear?: number;        // 公历出生年（算虚岁/流年用）
+  solarDate?: [number, number, number];  // 公历出生日期（完整真太阳时含均时差用）
+}
+export interface ZiweiResult {
+  ming: number;              // 命宫地支位 0=寅
+  zwPos: number;             // 紫微宫位
+  zwStars: Record<string, number>;
+  palaces: Record<number, number>;
+  juName: string; nayin: string;
+  correctedHour: number;
+  dayun?: { palaceIdx: number; start: number; end: number }[];
+  curDayunIdx?: number;
+  nominalAge?: number;
+  liunianIdx?: number;
+  liunianPalaceName?: string;
+  liunianStars?: string[];
+  startAge?: number;
+  forward?: boolean;
+  // ─── 补齐层（2026-08-20 排盘要点调研）───
+  shen: number;                          // 身宫地支位 0=寅
+  mingGZ: string;                         // 命宫干支（五行局之源）
+  fuStars: Record<string, number>;       // 辅星位置（0=寅起）
+  sihua: { lu: string; quan: string; ke: string; ji: string };   // 生年四化星名
+  sihuaPos: { lu?: number; quan?: number; ke?: number; ji?: number };  // 四化落宫位
+  brightness: Record<string, string>;    // 十四主星亮度（'庙'|'旺'|'得'|'利'|'平'|'陷'）
+  geju: { key: string; name: string; ji: '吉' | '凶' | '平'; desc: string; why: string }[];  // 格局
+}
+
+// 奇门输入输出
+export interface QimenInput { datetime: string | Date }
+export interface QimenResult {
+  yin: boolean; ju: number; jqName: string;
+  dayGZ: string; hourGZ: string;
+  xunShou: string; xunshouName: string;
+  zfStar: string; zsMen: string; zfPalace: number;
+  pan: Record<number, { yi: string; men: string; star: string }>;
+  // ─── 补齐层（2026-08-20）───
+  zsPalace: number;              // 值使门落宫（时干加临）
+  tianYi: Record<number, string>; // 天盘奇仪（暗干）
+  shen: Record<number, string>;   // 八神布宫
+}
+
+// 梅花输入输出
+export interface MeihuaInput {
+  mode: 'time' | 'num';
+  n1?: number; n2?: number; n3?: number;
+  now?: Date;
+}
+export interface MeihuaResult {
+  upper: number; lower: number; move: number;
+  benGua: GuaEntry; bianGua: GuaEntry; huGua: GuaEntry | null;
+  tiGua: number; yongGua: number; tiWx: string; yongWx: string;
+  shengke: string; benYao: number[];
+  // ─── 补齐层（2026-08-20）───
+  monthWx?: string;              // 起卦月支五行
+  tiWangShuai?: '旺' | '相' | '休' | '囚' | '死';    // 体卦旺衰（月令）
+  yongWangShuai?: '旺' | '相' | '休' | '囚' | '死';  // 用卦旺衰
+  wangShuaiNote?: string;        // 旺衰吉凶加成说明
+}
+
+// 六十四卦条目
+export interface GuaEntry {
+  up: number; down: number;
+  name: string; ci: string; xiang: string;
+}
+
+// 六爻输出
+export interface LiuyaoResult {
+  yao: number[];
+  names: { v: number; nm: string; backs: number }[];
+  benGua: GuaEntry; bianGua: GuaEntry; dongYao: number[];
+  // ─── 补齐层（2026-08-20 纳甲筮法）───
+  najia?: {
+    gong: string;               // 卦宫
+    lines: { gz: string; ganWx: string; zhiWx: string; liuqin: string; shen: string; isShi: boolean; isYing: boolean; kong: boolean }[];  // 初→上
+    shiPos: number; yingPos: number;
+    dayGZ: string; monthZhi: string;    // 起卦日干支/月支
+    yuePo: string[];                    // 月破地支
+    xunKong: string[];                  // 旬空地支
+    shiLiQin: string;                   // 世爻六亲（用神参考）
+  };
+}
+
+// 大六壬输出
+export interface LiurenResult {
+  dayGZ: string; hourGZ: string;
+  jiang: string; jqName: string;
+  tianpan: Record<number, string>;
+  ganJi: string; ke1: string; ke2: string; ke3: string; ke4: string;
+  chuan1: string; chuan2: string; chuan3: string;
+  // ─── 补齐层（2026-08-20）───
+  guiRen: string;                // 贵人（昼夜贵人地支）
+  isDay: boolean;                // 昼占/夜占
+  tianJiang: Record<number, string>;  // 十二天将布宫（地盘支 → 天将）
+  chuanJiang: { chuan: string; jiang: string }[];  // 三传所乘天将
+  keti: string;     // 课体（伏吟/反吟/常课）
+  ketiNote: string; // 课体断语
+}
+
+// 小六壬输出
+export interface XiaoliurenResult {
+  a: number; b: number; c: number;
+  idx: number; name: string;
+  detail: { ji: string; wx: string; num: string; dir: string; poem: string; text: string };
+}
+
+// 星盘输出
+export interface AstrologyResult {
+  planets: [string, string, number, string][];
+  asc: number; sun: number; moon: number;
+  lstHours: number;
+  aspects: [string, string, string, string][];
+  mc?: number;         // 中天黄经
+  epsilon?: number;    // 黄赤交角（度）
+  // ─── 补齐层（2026-08-20 星盘细化）───
+  houseSystem: 'whole-sign';      // 当前宫位制：整宫制（以上升点为 1 宫头，每宫 30°）
+  houses: { num: number; cusp: number; sign: string; ruler: string; rulerLng: number }[];  // 十二宫
+  planetDetails: {
+    cn: string; sym: string; color: string;
+    lng: number; sign: string; degree: number;   // 黄经/星座/宫内经度
+    house: number;                                // 落宫 1-12
+    retrograde: boolean;                          // 逆行
+    dignity: { status: '庙' | '旺' | '陷' | '弱' | ''; note: string };  // 古典庙旺
+  }[];
+  ascSign: string; sunSign: string; moonSign: string;  // 上升/太阳/月亮星座
+}
+
+// 塔罗输出
+export interface TarotCardData {
+  name: string; en: string; num?: string;
+  up: string; rev: string;
+  major: boolean; suit?: string;
+  reversed: boolean;
+}
+
+// 通用引擎契约
+export interface ArtEngine<TInput, TResult> {
+  id: ArtId;
+  calc(input: TInput, rng?: () => number): TResult;
+  validate?(input: TInput): string[];
+}

package/src/App.tsx

@@ -0,0 +1,69 @@
+// 观微 · 应用路由（HashRouter，映射参考项目 hash 语义）
+// 路由表：
+//   /           首页（含 #home-arts / #home-fa 锚点）
+//   /about      缘起
+//   /classics   古籍（列表 / 详情 :id）
+//   /academy    学馆（列表 / 课程 :id）
+//   /history    历史（列表 / 详情 :id）
+//   /art/:artId 九术模块（进入滚动置顶；切换保留状态）
+import { HashRouter, Routes, Route, useLocation } from 'react-router-dom';
+import { useEffect } from 'react';
+import Backdrop from '@/components/Backdrop';
+import InkVein from '@/components/InkVein';
+import { SongDialogProvider } from '@/components/SongDialog';
+import ErrorBoundary from '@/components/ErrorBoundary';
+import SiteNav from '@/components/SiteNav';
+import SiteFooter from '@/components/SiteFooter';
+import HomePage from '@/pages/HomePage';
+import AboutPage from '@/pages/AboutPage';
+import ModulePage from '@/pages/ModulePage';
+import DemoPage from '@/pages/DemoPage';
+import ClassicsPage from '@/pages/ClassicsPage';
+import AcademyPage from '@/pages/AcademyPage';
+import HistoryPage from '@/pages/HistoryPage';
+import AuthPage from '@/pages/AuthPage';
+import SpreadEditorPage from '@/pages/SpreadEditorPage';
+
+// 进入九术模块视图时滚动置顶（instant，无动画）
+function ScrollTopOnArt() {
+  const location = useLocation();
+  useEffect(() => {
+    if (location.pathname.startsWith('/art/')) {
+      window.scrollTo({ top: 0, behavior: 'instant' as ScrollBehavior });
+    }
+  }, [location.pathname]);
+  return null;
+}
+
+export default function App() {
+  return (
+    <HashRouter>
+      <SongDialogProvider>
+      <ScrollTopOnArt />
+      <Backdrop />
+      <InkVein />
+      <SiteNav />
+      <main>
+        <ErrorBoundary>
+        <Routes>
+          <Route path="/" element={<HomePage />} />
+          <Route path="/about" element={<AboutPage />} />
+          <Route path="/classics" element={<ClassicsPage />} />
+          <Route path="/classics/:id" element={<ClassicsPage />} />
+          <Route path="/academy" element={<AcademyPage />} />
+          <Route path="/academy/:id" element={<AcademyPage />} />
+          <Route path="/history" element={<HistoryPage />} />
+          <Route path="/history/:id" element={<HistoryPage />} />
+          <Route path="/auth" element={<AuthPage />} />
+          <Route path="/spread-editor" element={<SpreadEditorPage />} />
+          <Route path="/demo" element={<DemoPage />} />
+          <Route path="/art/:artId" element={<ModulePage />} />
+          <Route path="*" element={<HomePage />} />
+        </Routes>
+        </ErrorBoundary>
+      </main>
+      <SiteFooter />
+      </SongDialogProvider>
+    </HashRouter>
+  );
+}

package/src/arts/registry.ts

@@ -0,0 +1,31 @@
+// 九术组件注册表：面板与结果渲染（ModulePage 与 HistoryPage 共用）
+import type { ComponentType } from 'react';
+import { BaziPanel, BaziResult } from '@/components/arts/BaziArt';
+import { ZiweiPanel, ZiweiResult } from '@/components/arts/ZiweiArt';
+import { QimenPanel, QimenResultView } from '@/components/arts/QimenArt';
+import { MeihuaPanel, MeihuaResult } from '@/components/arts/MeihuaArt';
+import { LiuyaoPanel, LiuyaoResult } from '@/components/arts/LiuyaoArt';
+import { LiurenPanel, LiurenResult } from '@/components/arts/LiurenArt';
+import { XiaoliurenPanel, XiaoliurenResult } from '@/components/arts/XiaoliurenArt';
+import { AstrologyPanel, AstrologyResult } from '@/components/arts/AstrologyArt';
+import { TarotPanel, TarotResult } from '@/components/arts/TarotArt';
+
+export interface ArtPair {
+  Panel: ComponentType<{ onDivine: (fn: () => unknown) => void }>;
+  Result: ComponentType<{ data: any }>;
+  placeholder: string;
+}
+
+export const ART_PAIRS: Record<string, ArtPair> = {
+  bazi:       { Panel: BaziPanel, Result: BaziResult, placeholder: '静候四柱 · 观五行流转' },
+  ziwei:      { Panel: ZiweiPanel, Result: ZiweiResult, placeholder: '静候星布 · 观十四主星' },
+  qimen:      { Panel: QimenPanel, Result: QimenResultView, placeholder: '静候局成 · 观九宫遁甲' },
+  meihua:     { Panel: MeihuaPanel, Result: MeihuaResult, placeholder: '静候心动 · 观梅花开落' },
+  liuyao:     { Panel: LiuyaoPanel, Result: LiuyaoResult, placeholder: '静候钱落 · 观六爻成象' },
+  liuren:     { Panel: LiurenPanel, Result: LiurenResult, placeholder: '静候课起 · 观天地人盘' },
+  xiaoliuren: { Panel: XiaoliurenPanel, Result: XiaoliurenResult, placeholder: '静候指落 · 观掌诀玄机' },
+  astrology:  { Panel: AstrologyPanel, Result: AstrologyResult, placeholder: '静候星布 · 观天穹为书' },
+  tarot:      { Panel: TarotPanel, Result: TarotResult, placeholder: '静候牌启 · 观镜照本心' },
+};
+
+export const artPairOf = (artId: string): ArtPair | undefined => ART_PAIRS[artId];

package/src/assets/react.svg

@@ -0,0 +1 @@
+<svg xmlns="http://www.w3.org/2000/svg" xmlns:xlink="http://www.w3.org/1999/xlink" aria-hidden="true" role="img" class="iconify iconify--logos" width="35.93" height="32" preserveAspectRatio="xMidYMid meet" viewBox="0 0 256 228"><path fill="#00D8FF" d="M210.483 73.824a171.49 171.49 0 0 0-8.24-2.597c.465-1.9.893-3.777 1.273-5.621c6.238-30.281 2.16-54.676-11.769-62.708c-13.355-7.7-35.196.329-57.254 19.526a171.23 171.23 0 0 0-6.375 5.848a155.866 155.866 0 0 0-4.241-3.917C100.759 3.829 77.587-4.822 63.673 3.233C50.33 10.957 46.379 33.89 51.995 62.588a170.974 170.974 0 0 0 1.892 8.48c-3.28.932-6.445 1.924-9.474 2.98C17.309 83.498 0 98.307 0 113.668c0 15.865 18.582 31.778 46.812 41.427a145.52 145.52 0 0 0 6.921 2.165a167.467 167.467 0 0 0-2.01 9.138c-5.354 28.2-1.173 50.591 12.134 58.266c13.744 7.926 36.812-.22 59.273-19.855a145.567 145.567 0 0 0 5.342-4.923a168.064 168.064 0 0 0 6.92 6.314c21.758 18.722 43.246 26.282 56.54 18.586c13.731-7.949 18.194-32.003 12.4-61.268a145.016 145.016 0 0 0-1.535-6.842c1.62-.48 3.21-.974 4.76-1.488c29.348-9.723 48.443-25.443 48.443-41.52c0-15.417-17.868-30.326-45.517-39.844Zm-6.365 70.984c-1.4.463-2.836.91-4.3 1.345c-3.24-10.257-7.612-21.163-12.963-32.432c5.106-11 9.31-21.767 12.459-31.957c2.619.758 5.16 1.557 7.61 2.4c23.69 8.156 38.14 20.213 38.14 29.504c0 9.896-15.606 22.743-40.946 31.14Zm-10.514 20.834c2.562 12.94 2.927 24.64 1.23 33.787c-1.524 8.219-4.59 13.698-8.382 15.893c-8.067 4.67-25.32-1.4-43.927-17.412a156.726 156.726 0 0 1-6.437-5.87c7.214-7.889 14.423-17.06 21.459-27.246c12.376-1.098 24.068-2.894 34.671-5.345a134.17 134.17 0 0 1 1.386 6.193ZM87.276 214.515c-7.882 2.783-14.16 2.863-17.955.675c-8.075-4.657-11.432-22.636-6.853-46.752a156.923 156.923 0 0 1 1.869-8.499c10.486 2.32 22.093 3.988 34.498 4.994c7.084 9.967 14.501 19.128 21.976 27.15a134.668 134.668 0 0 1-4.877 4.492c-9.933 8.682-19.886 14.842-28.658 17.94ZM50.35 144.747c-12.483-4.267-22.792-9.812-29.858-15.863c-6.35-5.437-9.555-10.836-9.555-15.216c0-9.322 13.897-21.212 37.076-29.293c2.813-.98 5.757-1.905 8.812-2.773c3.204 10.42 7.406 21.315 12.477 32.332c-5.137 11.18-9.399 22.249-12.634 32.792a134.718 134.718 0 0 1-6.318-1.979Zm12.378-84.26c-4.811-24.587-1.616-43.134 6.425-47.789c8.564-4.958 27.502 2.111 47.463 19.835a144.318 144.318 0 0 1 3.841 3.545c-7.438 7.987-14.787 17.08-21.808 26.988c-12.04 1.116-23.565 2.908-34.161 5.309a160.342 160.342 0 0 1-1.76-7.887Zm110.427 27.268a347.8 347.8 0 0 0-7.785-12.803c8.168 1.033 15.994 2.404 23.343 4.08c-2.206 7.072-4.956 14.465-8.193 22.045a381.151 381.151 0 0 0-7.365-13.322Zm-45.032-43.861c5.044 5.465 10.096 11.566 15.065 18.186a322.04 322.04 0 0 0-30.257-.006c4.974-6.559 10.069-12.652 15.192-18.18ZM82.802 87.83a323.167 323.167 0 0 0-7.227 13.238c-3.184-7.553-5.909-14.98-8.134-22.152c7.304-1.634 15.093-2.97 23.209-3.984a321.524 321.524 0 0 0-7.848 12.897Zm8.081 65.352c-8.385-.936-16.291-2.203-23.593-3.793c2.26-7.3 5.045-14.885 8.298-22.6a321.187 321.187 0 0 0 7.257 13.246c2.594 4.48 5.28 8.868 8.038 13.147Zm37.542 31.03c-5.184-5.592-10.354-11.779-15.403-18.433c4.902.192 9.899.29 14.978.29c5.218 0 10.376-.117 15.453-.343c-4.985 6.774-10.018 12.97-15.028 18.486Zm52.198-57.817c3.422 7.8 6.306 15.345 8.596 22.52c-7.422 1.694-15.436 3.058-23.88 4.071a382.417 382.417 0 0 0 7.859-13.026a347.403 347.403 0 0 0 7.425-13.565Zm-16.898 8.101a358.557 358.557 0 0 1-12.281 19.815a329.4 329.4 0 0 1-23.444.823c-7.967 0-15.716-.248-23.178-.732a310.202 310.202 0 0 1-12.513-19.846h.001a307.41 307.41 0 0 1-10.923-20.627a310.278 310.278 0 0 1 10.89-20.637l-.001.001a307.318 307.318 0 0 1 12.413-19.761c7.613-.576 15.42-.876 23.31-.876H128c7.926 0 15.743.303 23.354.883a329.357 329.357 0 0 1 12.335 19.695a358.489 358.489 0 0 1 11.036 20.54a329.472 329.472 0 0 1-11 20.722Zm22.56-122.124c8.572 4.944 11.906 24.881 6.52 51.026c-.344 1.668-.73 3.367-1.15 5.09c-10.622-2.452-22.155-4.275-34.23-5.408c-7.034-10.017-14.323-19.124-21.64-27.008a160.789 160.789 0 0 1 5.888-5.4c18.9-16.447 36.564-22.941 44.612-18.3ZM128 90.808c12.625 0 22.86 10.235 22.86 22.86s-10.235 22.86-22.86 22.86s-22.86-10.235-22.86-22.86s10.235-22.86 22.86-22.86Z"></path></svg>

package/src/components/Backdrop.tsx

@@ -0,0 +1,27 @@
+// 全局底景：宣纸纹理 + 水墨远山（浮动）+ 墨尘粒子 + 光晕
+import Motes from './Motes';
+
+export default function Backdrop() {
+  return (
+    <>
+      <div id="paper-grain" aria-hidden="true" />
+      <Motes />
+      <span className="hero-glow hero-glow--left" aria-hidden="true" />
+      <span className="hero-glow hero-glow--right" aria-hidden="true" />
+      <svg id="mountains" viewBox="0 0 1440 320" preserveAspectRatio="xMidYMax slice" aria-hidden="true">
+        <defs>
+          <linearGradient id="mg1" x1="0" y1="0" x2="0" y2="1">
+            <stop offset="0" stopColor="#96A88F" stopOpacity="0" />
+            <stop offset="1" stopColor="#96A88F" stopOpacity=".30" />
+          </linearGradient>
+          <linearGradient id="mg2" x1="0" y1="0" x2="0" y2="1">
+            <stop offset="0" stopColor="#7C9792" stopOpacity="0" />
+            <stop offset="1" stopColor="#7C9792" stopOpacity=".22" />
+          </linearGradient>
+        </defs>
+        <path d="M0,220 C160,140 300,120 420,168 C540,216 640,140 760,120 C880,100 960,150 1080,170 C1200,190 1320,150 1440,190 L1440,320 L0,320 Z" fill="url(#mg1)" />
+        <path d="M0,260 C140,200 260,210 400,236 C560,264 680,210 820,200 C980,190 1100,240 1240,228 C1320,222 1380,240 1440,250 L1440,320 L0,320 Z" fill="url(#mg2)" />
+      </svg>
+    </>
+  );
+}

package/src/components/BambooArt.tsx

@@ -0,0 +1,41 @@
+// 水墨竹影装饰（缘起等页面右侧）：手绘风 SVG 竹 + 石 + 山
+export default function BambooArt({ className = '' }: { className?: string }) {
+  return (
+    <div className={'bamboo-art ' + className} aria-hidden="true">
+      <svg viewBox="0 0 320 520" fill="none" xmlns="http://www.w3.org/2000/svg">
+        {/* 远山淡影 */}
+        <path d="M0,470 C60,430 120,445 180,425 C240,405 285,420 320,400 L320,520 L0,520 Z" fill="#96A88F" opacity=".12" />
+        <path d="M0,495 C80,465 160,480 240,462 C280,453 300,462 320,455 L320,520 L0,520 Z" fill="#7C9792" opacity=".10" />
+        {/* 竹节 */}
+        {[0, 1, 2, 3, 4].map(i => {
+          const x = 88 + i * 34;
+          const top = 40 + i * 14;
+          const bottom = 500 - i * 30;
+          return (
+            <g key={i} stroke="#5F7660" strokeWidth="3.5" strokeLinecap="round" fill="none" opacity=".75">
+              <path d={"M" + x + "," + top + " C" + (x - 6) + "," + ((top + bottom) / 2) + " " + (x + 8) + "," + ((top + bottom) / 2 + 20) + " " + x + "," + bottom} />
+              {/* 节环 */}
+              <path d={"M" + (x - 5) + ",150 C" + x + ",146 " + x + ",146 " + (x + 5) + ",150"} strokeWidth="2" opacity=".5" />
+              <path d={"M" + (x - 4) + ",268 C" + x + ",265 " + x + ",265 " + (x + 4) + ",268"} strokeWidth="2" opacity=".5" />
+              <path d={"M" + (x - 3) + ",386 C" + x + ",383 " + x + ",383 " + (x + 3) + ",386"} strokeWidth="2" opacity=".5" />
+            </g>
+          );
+        })}
+        {/* 竹叶 */}
+        {[
+          [60, 190, 40, 210, 55, 240], [120, 140, 95, 150, 108, 175], [180, 230, 160, 240, 172, 262],
+          [240, 120, 218, 130, 230, 152], [70, 320, 52, 330, 66, 350], [150, 300, 128, 308, 140, 328],
+          [230, 260, 210, 270, 222, 290], [100, 80, 80, 92, 94, 112], [200, 170, 178, 180, 190, 200],
+          [250, 340, 232, 348, 244, 366], [60, 420, 44, 430, 58, 448], [170, 400, 152, 410, 164, 428],
+        ].map((pts, i) => (
+          <path key={i} d={"M" + pts[0] + "," + pts[1] + " Q" + pts[2] + "," + pts[3] + " " + pts[4] + "," + pts[5] + " Q" + pts[2] + "," + pts[3] + " " + pts[0] + "," + pts[1]} fill="#5F7660" opacity=".6" />
+        ))}
+        {/* 石 */}
+        <path d="M40,505 C60,470 95,465 115,490 C100,505 70,510 40,505 Z" fill="#8C9A8A" opacity=".18" />
+        {/* 小印 */}
+        <rect x="248" y="470" width="34" height="34" rx="2" stroke="#A5402D" strokeWidth="1.5" opacity=".55" />
+        <text x="265" y="492" textAnchor="middle" fontSize="16" fill="#A5402D" opacity=".55" style={{ fontFamily: 'Kaiti SC, KaiTi, serif' }}>观微</text>
+      </svg>
+    </div>
+  );
+}

package/src/components/CalendarInput.tsx

@@ -0,0 +1,131 @@
+// CalendarInput：公历日期输入（可手输 YYYY-MM-DD，也可点开自绘月历选择）
+import { useEffect, useRef, useState } from 'react';
+
+const WEEK_HEAD = ['日', '一', '二', '三', '四', '五', '六'];
+const MONTHS = ['一月', '二月', '三月', '四月', '五月', '六月', '七月', '八月', '九月', '十月', '十一月', '十二月'];
+
+interface Props {
+  value: string;
+  onChange: (iso: string) => void;
+  id?: string;
+}
+
+function parseISO(v: string): [number, number, number] {
+  const m = /^(\d{4})-(\d{2})-(\d{2})$/.exec(v);
+  return m ? [Number(m[1]), Number(m[2]), Number(m[3])] : [1990, 1, 1];
+}
+
+function daysInMonth(y: number, m: number) {
+  return new Date(y, m, 0).getDate();
+}
+
+export default function CalendarInput({ value, onChange, id }: Props) {
+  const [open, setOpen] = useState(false);
+  const [text, setText] = useState(value);
+  const [error, setError] = useState(false);
+  const ref = useRef<HTMLDivElement>(null);
+  const [y, m, d] = parseISO(value);
+  const [viewY, setViewY] = useState(y);
+  const [viewM, setViewM] = useState(m);
+
+  useEffect(() => {
+    setText(value);
+    const [vy, vm] = parseISO(value);
+    setViewY(vy); setViewM(vm);
+  }, [value]);
+
+  useEffect(() => {
+    if (!open) return;
+    const close = (e: MouseEvent) => {
+      if (ref.current && !ref.current.contains(e.target as Node)) setOpen(false);
+    };
+    document.addEventListener('mousedown', close);
+    return () => document.removeEventListener('mousedown', close);
+  }, [open]);
+
+  const commit = (iso: string) => {
+    onChange(iso);
+    setText(iso);
+    setError(false);
+  };
+
+  const handleText = (v: string) => {
+    setText(v);
+    const m = /^(\d{4})-(\d{1,2})-(\d{1,2})$/.exec(v);
+    if (m) {
+      const yy = Number(m[1]), mm = Number(m[2]), dd = Number(m[3]);
+      if (mm >= 1 && mm <= 12 && dd >= 1 && dd <= daysInMonth(yy, mm)) {
+        commit(yy + '-' + String(mm).padStart(2, '0') + '-' + String(dd).padStart(2, '0'));
+        return;
+      }
+    }
+    setError(true);
+  };
+
+  // 月历网格：从周日开始
+  const firstDay = new Date(viewY, viewM - 1, 1).getDay();
+  const total = daysInMonth(viewY, viewM);
+  const cells: (number | null)[] = [
+    ...Array.from({ length: firstDay }, () => null),
+    ...Array.from({ length: total }, (_, i) => i + 1),
+  ];
+  while (cells.length % 7 !== 0) cells.push(null);
+
+  const nav = (delta: number) => {
+    let ny = viewY, nm = viewM + delta;
+    if (nm < 1) { nm = 12; ny--; }
+    if (nm > 12) { nm = 1; ny++; }
+    setViewY(ny); setViewM(nm);
+  };
+
+  const isSelected = (dd: number) => viewY === y && viewM === m && dd === d;
+
+  return (
+    <div className="cal-input" ref={ref}>
+      <div className="cal-field">
+        <input
+          className={"input-line" + (error ? ' cal-error' : '')}
+          id={id}
+          placeholder="1990-06-15"
+          value={text}
+          onChange={e => handleText(e.target.value)}
+        />
+        <button type="button" className="cal-toggle" onClick={() => setOpen(v => !v)} aria-label="开月历">
+          <svg width="15" height="15" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round">
+            <rect width="18" height="18" x="3" y="4" rx="2" />
+            <path d="M16 2v4M8 2v4M3 10h18" />
+          </svg>
+        </button>
+      </div>
+      {error && <p className="hint" style={{ color: 'var(--cinnabar)' }}>历日未合 · 请书如 1990-06-15</p>}
+      {open && (
+        <div className="cal-panel">
+          <div className="cal-head">
+            <button type="button" className="cal-nav" onClick={() => nav(-1)} aria-label="上月">
+              <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="m15 18-6-6 6-6" /></svg>
+            </button>
+            <span className="cal-title">{viewY}年 {MONTHS[viewM - 1]}</span>
+            <button type="button" className="cal-nav" onClick={() => nav(1)} aria-label="下月">
+              <svg width="13" height="13" viewBox="0 0 24 24" fill="none" stroke="currentColor" strokeWidth="2" strokeLinecap="round" strokeLinejoin="round"><path d="m9 18 6-6-6-6" /></svg>
+            </button>
+          </div>
+          <div className="cal-week">
+            {WEEK_HEAD.map(w => <span key={w}>{w}</span>)}
+          </div>
+          <div className="cal-grid">
+            {cells.map((c, i) => c === null ? <span key={i} /> : (
+              <button
+                key={i}
+                type="button"
+                className={isSelected(c) ? 'sel' : ''}
+                onClick={() => { commit(viewY + '-' + String(viewM).padStart(2, '0') + '-' + String(c).padStart(2, '0')); setOpen(false); }}
+              >
+                {c}
+              </button>
+            ))}
+          </div>
+        </div>
+      )}
+    </div>
+  );
+}

package/src/components/DateInput.tsx

@@ -0,0 +1,103 @@
+// DateInput：出生日期输入（公历 / 农历双历法，lunar-typescript 互转，实时联动）
+import { useEffect, useState } from 'react';
+import { Solar, Lunar } from 'lunar-typescript';
+import SongSelect from '@/components/SongSelect';
+import CalendarInput from '@/components/CalendarInput';
+
+interface Props {
+  value: string;        // 公历 YYYY-MM-DD（对外统一输出公历）
+  onChange: (solarISO: string) => void;
+  id?: string;
+}
+
+const LUNAR_YEARS = Array.from({ length: 201 }, (_, i) => 1900 + i);
+const pad2 = (n: number) => String(n).padStart(2, '0');
+
+export default function DateInput({ value, onChange, id }: Props) {
+  const [mode, setMode] = useState<'solar' | 'lunar'>('solar');
+  const [y, m, d] = value ? value.split('-').map(Number) : [1990, 1, 1];
+
+  // 农历状态（由当前公历派生）
+  const [ly, setLy] = useState(1990);
+  const [lm, setLm] = useState(1);
+  const [ld, setLd] = useState(1);
+  const [leap, setLeap] = useState(false);
+
+  // 公历变化 → 同步农历
+  useEffect(() => {
+    try {
+      const l = Solar.fromYmd(y, m, d).getLunar();
+      const rawMonth = l.getMonth();
+      setLy(l.getYear());
+      setLm(Math.abs(rawMonth));
+      setLd(l.getDay());
+      setLeap(rawMonth < 0);
+    } catch { /* ignore */ }
+  }, [y, m, d]);
+
+  const lunarToSolar = (yy: number, mm: number, dd: number, isLeap: boolean): string => {
+    try {
+      // 闰月以负数月表示
+      const s = Lunar.fromYmd(yy, isLeap ? -mm : mm, dd).getSolar();
+      return s.getYear() + '-' + pad2(s.getMonth()) + '-' + pad2(s.getDay());
+    } catch {
+      return value;
+    }
+  };
+
+  // 农历选择变化 → 实时转公历输出（父组件 value 变化会再同步农历，闭环稳定）
+  useEffect(() => {
+    if (mode === 'lunar') {
+      const iso = lunarToSolar(ly, lm, ld, leap);
+      if (iso !== value) onChange(iso);
+    }
+    // eslint-disable-next-line react-hooks/exhaustive-deps
+  }, [mode, ly, lm, ld, leap]);
+
+  // 当年闰月检测（探测负数月）
+  const leapMonth = (() => {
+    for (let m = 1; m <= 12; m++) {
+      try { Lunar.fromYmd(ly, -m, 1); return m; } catch { /* 非闰月 */ }
+    }
+    return 0;
+  })();
+  const isLeapNow = leapMonth > 0 && lm === leapMonth;
+
+  const daysInMonth = (() => {
+    for (let dd = 30; dd >= 29; dd--) {
+      try { Lunar.fromYmd(ly, leap ? -lm : lm, dd); return dd; } catch { /* 继续探测 */ }
+    }
+    return 30;
+  })();
+
+  return (
+    <div>
+      <div style={{ display: 'flex', gap: '.5rem', marginBottom: '.5rem', maxWidth: 130 }}>
+        <SongSelect
+          value={mode}
+          options={[{ value: 'solar', label: '公历' }, { value: 'lunar', label: '农历' }]}
+          onChange={v => setMode(v as 'solar' | 'lunar')}
+        />
+      </div>
+      {mode === 'solar' ? (
+        <CalendarInput id={id} value={value} onChange={onChange} />
+      ) : (
+        <div className="field-row" style={{ gridTemplateColumns: '1fr 1fr 1fr' }}>
+          <div className="field"><SongSelect value={String(ly)} options={LUNAR_YEARS.map(v => ({ value: String(v), label: String(v) + '年' }))} onChange={v => setLy(Number(v))} /></div>
+          <div className="field"><SongSelect value={String(lm)} options={Array.from({ length: 12 }, (_, i) => ({ value: String(i + 1), label: (i + 1) + '月' }))} onChange={v => { setLm(Number(v)); setLeap(false); }} /></div>
+          <div className="field"><SongSelect value={String(ld)} options={Array.from({ length: Math.max(daysInMonth, ld) }, (_, i) => ({ value: String(i + 1), label: (i + 1) + '日' }))} onChange={v => setLd(Number(v))} /></div>
+        </div>
+      )}
+      {mode === 'lunar' && (
+        <p className="hint">
+          {ly}年{leap ? '闰' : ''}{lm}月{ld}日 即公历 <strong>{lunarToSolar(ly, lm, ld, leap)}</strong>
+          {isLeapNow && (
+            <button type="button" style={{ marginLeft: '.6rem', color: 'var(--cinnabar)', textDecoration: 'underline' }} onClick={() => setLeap(v => !v)}>
+              {leap ? '取平月' : '取闰月'}
+            </button>
+          )}
+        </p>
+      )}
+    </div>
+  );
+}

package/src/components/Disclaimer.tsx

@@ -0,0 +1,12 @@
+// 免责声明（观微三戒）
+export default function Disclaimer({ text }: { text?: string }) {
+  return (
+    <div className="disclaimer" role="note">
+      <span className="seal-mini">慎</span>
+      <div>
+        <strong>观微三戒：</strong>
+        {text ?? '凡占问所得，皆为先贤智慧之投影，仅供修身养性、怡情遣兴之用，不构成任何决策依据。心诚则灵，勿迷勿执；大事不决，请询人事、法律或专业人士。'}
+      </div>
+    </div>
+  );
+}

package/src/components/Empty.tsx

@@ -0,0 +1,8 @@
+import { cn } from '@/lib/utils'
+
+// Empty component
+export default function Empty() {
+  return (
+    <div className={cn('flex h-full items-center justify-center')}>Empty</div>
+  )
+}