guanwei 1.1.1

package/server/src/index.ts

@@ -0,0 +1,71 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+// 轻量 .env 加载（无第三方依赖）
+(() => {
+  try {
+    const __dirname = path.dirname(fileURLToPath(import.meta.url));
+    const envFile = path.join(__dirname, '..', '.env');
+    const content = fs.readFileSync(envFile, 'utf-8');
+    content.split('\n').forEach(line => {
+      const m = /^\s*([A-Z_]+)\s*=\s*(.+)\s*$/.exec(line);
+      if (m && process.env[m[1]] === undefined) process.env[m[1]] = m[2].replace(/^["']|["']$/g, '');
+    });
+    console.log('· 已加载 .env（LLM_PROVIDER=' + (process.env.LLM_PROVIDER || '未配置') + '）');
+  } catch { /* 无 .env 时忽略 */ }
+})();
+
+import express from 'express';
+import cors from 'cors';
+import tarotRouter from './routes/tarot.js';
+import aiRouter from './routes/ai.js';
+import usersRouter from './routes/users.js';
+import divineRouter from './routes/divine.js';
+import hourRouter from './routes/hour.js';
+
+const app = express();
+const PORT = process.env.PORT || 3018;
+
+app.use(cors());
+app.use(express.json());
+
+// 请求日志（联调排查用）
+app.use((req, res, next) => {
+  res.on('finish', () => {
+    console.log('[' + new Date().toLocaleTimeString() + '] ' + req.method + ' ' + req.originalUrl + ' → ' + res.statusCode);
+  });
+  next();
+});
+
+// /api 根信息（便于浏览器直接访问确认后端）
+app.get('/api', (_req, res) => {
+  res.json({
+    name: '观微后端',
+    status: 'ok',
+    endpoints: ['/api/health', '/api/ai/providers', '/api/ai/interpret', '/api/ai/interpret/stream', '/api/users/*', '/api/divine'],
+    time: Date.now(),
+  });
+});
+
+app.get('/api/health', (_req, res) => {
+  res.json({ status: 'ok', timestamp: Date.now() });
+});
+
+app.use('/api/tarot', tarotRouter);
+app.use('/api/ai', aiRouter);
+app.use('/api/users', usersRouter);
+app.use('/api/divine', divineRouter);
+app.use('/api', hourRouter);
+
+app.listen(PORT, () => {
+  console.log(`
+  🎴 玄冥占星后端服务已启动
+  
+  地址: http://localhost:${PORT}
+  健康检查: http://localhost:${PORT}/api/health
+  塔罗API: http://localhost:${PORT}/api/tarot
+  `);
+});
+
+export default app;

package/server/src/routes/ai.ts

@@ -0,0 +1,376 @@
+// AI 解读路由：/api/ai/interpret（非流式）+ /api/ai/interpret/stream（SSE）
+import { Router } from 'express';
+import { buildMessages, buildReportMessages, buildStep1Messages, buildStep2Messages } from '../services/promptBuilder.js';
+import { chatOnce, chatStream, activeProvider, providerStatus, lastFinishReason } from '../services/llmProvider.js';
+import { getDivination, attachReport, markAiFailed } from '../services/divineStore.js';
+import { verifyRelatives, fixFamilyRelatives } from '../services/relativesCheck.js';
+
+const router = Router();
+
+// Provider 健康状态
+router.get('/providers', (_req, res) => {
+  res.json({ providers: providerStatus(), active: activeProvider()?.id ?? null });
+});
+
+// 非流式解读（保底通道）
+router.post('/interpret', async (req, res) => {
+  const { artId, question, divineId, semantic, profile, report, fit, username } = req.body;
+  if (!artId) return res.status(400).json({ error: '缺少必要参数' });
+  try {
+    // 从 SQLite 读排盘数据（v6：不再信任前端直传 resultRaw）
+    let resultRaw: unknown = null;
+    let recProfile: unknown = undefined;
+    if (divineId) {
+      const rec = getDivination(divineId);
+      if (!rec) return res.status(400).json({ error: 'DIVINE_NOT_FOUND', message: '起占记录不存在，请重新起占' });
+      if (username && rec.username !== username) return res.status(403).json({ error: 'FORBIDDEN' });
+      resultRaw = rec.resultRaw;
+      recProfile = rec.profile;
+    } else {
+      return res.status(400).json({ error: 'DIVINE_REQUIRED', message: '请先起占（divineId 缺失）' });
+    }
+    // 统一报告模式：两步管线（Step1 盘面解析 → Step2 深度报告），Step1 失败降级单步
+    const kind = ['bazi', 'ziwei', 'astrology'].includes(artId) ? 'mingpan' : 'zhanwen';
+    let step1Text = '';
+    try {
+      step1Text = await getStep1(divineId, artId, question || '', resultRaw, recProfile);
+    } catch (e1: any) {
+      console.warn('[ai] Step1 盘面解析失败，降级为单步模式:', e1.message);
+    }
+    const messages = step1Text
+      ? buildStep2Messages(artId, question || '', resultRaw, step1Text, recProfile, semantic, fit)
+      : buildReportMessages(artId, question || '', resultRaw, profile, semantic, fit);
+    const text = await chatOnce(messages);
+    const parsed = parseReport(text, kind);
+    // 六亲事实校验：模型长输出常编造宫位/主星（如把父母宫写成无主星），检测到矛盾则定向重写 family 区块
+    const relErrs = verifyRelatives(artId, resultRaw, parsed);
+    if (relErrs.length && relErrs.length <= 6) {
+      console.warn('[ai] 六亲表述矛盾，定向修正:', relErrs.join('；'));
+      const fixed = await fixFamilyRelatives(artId, resultRaw, parsed, relErrs);
+      if (fixed) parsed.family = fixed as any;
+    } else if (relErrs.length > 6) {
+      console.warn('[ai] 六亲校验异常项过多（' + relErrs.length + ' 条，疑误报），跳过修正:', relErrs.slice(0, 3).join('；'));
+    }
+    if (parsed.quality === 'poor') {
+      console.error('[ai] 输出不符合报告结构，拒绝返回（不入库）');
+      markAiFailed(divineId, artId, kind, '质量评分未达标', text.slice(0, 4000));
+      return res.status(502).json({ error: 'AI_REPORT_INVALID', message: 'AI 输出不符合报告结构，请重试' });
+    }
+    // 达标 → 报告回写存储（quality=ok 才入库）
+    attachReport(divineId, parsed, 'ok');
+    res.json({ provider: activeProvider()?.id, report: parsed, sections: parseSections(text) });
+  } catch (e: any) {
+    if (e.message === 'AI_UNCONFIGURED') {
+      return res.status(503).json({ error: 'AI_UNCONFIGURED', message: '未配置 AI 服务，请设置 LLM_PROVIDER 与对应 Key' });
+    }
+    console.error('[ai/interpret]', e);
+    res.status(502).json({ error: 'AI_FAILED', message: 'AI 解读暂未应机' });
+  }
+});
+
+// SSE 流式解读：逐字推送（含 start / done 事件）
+router.post('/interpret/stream', async (req, res) => {
+  const { artId, question, divineId, semantic, profile, report, fit, username } = req.body;
+  if (!artId) {
+    res.status(400).json({ error: '缺少必要参数' });
+    return;
+  }
+  // 从 SQLite 读排盘数据（v6：divineId 必填）
+  const rec = divineId ? getDivination(divineId) : null;
+  if (!rec) {
+    res.status(400).json({ error: 'DIVINE_NOT_FOUND', message: '起占记录不存在，请重新起占' });
+    return;
+  }
+  if (username && rec.username !== username) {
+    res.status(403).json({ error: 'FORBIDDEN' });
+    return;
+  }
+  const resultRaw = rec.resultRaw;
+  try {
+    // 两步管线（2026-08-20）：Step1 盘面解析（内部非流式，短输出，带缓存）→ Step2 深度报告（流式）
+    let step1Text = '';
+    try {
+      step1Text = await getStep1(divineId, artId, question || '', resultRaw, rec.profile);
+    } catch (e1: any) {
+      console.warn('[ai] Step1 盘面解析失败，降级为单步模式:', e1.message);
+      step1Text = '';
+    }
+    const messages = step1Text
+      ? buildStep2Messages(artId, question || '', resultRaw, step1Text, rec.profile, semantic, fit)
+      : buildReportMessages(artId, question || '', resultRaw, profile, semantic, fit);
+    res.setHeader('Content-Type', 'text/event-stream');
+    res.setHeader('Cache-Control', 'no-cache');
+    res.setHeader('Connection', 'keep-alive');
+    res.write(`data: ${JSON.stringify({ type: 'start', provider: activeProvider()?.id })}\n\n`);
+    let full = '';
+    for await (const chunk of chatStream(messages)) {
+      full += chunk;
+      res.write(`data: ${JSON.stringify({ type: 'char', char: chunk })}\n\n`);
+    }
+    // 统一结构化报告：后端完成文本清洗与结构归一，前端只做渲染
+    const kind2 = ['bazi', 'ziwei', 'astrology'].includes(artId) ? 'mingpan' : 'zhanwen';
+    const rep = parseReport(full, kind2);
+    // 六亲事实校验与修正（同非流式路径）
+    const relErrs = verifyRelatives(artId, resultRaw, rep);
+    if (relErrs.length && relErrs.length <= 6) {
+      console.warn('[ai/stream] 六亲表述矛盾，定向修正:', relErrs.join('；'));
+      const fixed = await fixFamilyRelatives(artId, resultRaw, rep, relErrs);
+      if (fixed) rep.family = fixed as any;
+    } else if (relErrs.length > 6) {
+      console.warn('[ai/stream] 六亲校验异常项过多（' + relErrs.length + ' 条，疑误报），跳过修正:', relErrs.slice(0, 3).join('；'));
+    }
+    const sections = parseSections(full);
+    const truncated = lastFinishReason === 'length';
+    // 质量门槛：ok → 报告回写入库；poor/截断 → 不入库 + fail 留档
+    if (rep.quality === 'ok' && !truncated) {
+      attachReport(divineId, rep, 'ok');
+    } else {
+      const reason = truncated ? '输出截断（finish_reason=length）' : '质量评分未达标';
+      markAiFailed(divineId, artId, kind2, reason, full.slice(0, 4000));
+    }
+    res.write(`data: ${JSON.stringify({ type: 'done', report: rep, sections, full, truncated, quality: rep.quality || 'ok' })}\n\n`);
+    res.end();
+  } catch (e: any) {
+    if (e.message === 'AI_UNCONFIGURED') {
+      // 流已开始则发送错误事件；否则返回 503
+      if (res.headersSent) {
+        res.write(`data: ${JSON.stringify({ type: 'error', code: 'AI_UNCONFIGURED', message: '未配置 AI 服务' })}\n\n`);
+        res.end();
+      } else {
+        res.status(503).json({ error: 'AI_UNCONFIGURED' });
+      }
+      return;
+    }
+    console.error('[ai/stream]', e);
+    if (res.headersSent) {
+      res.write(`data: ${JSON.stringify({ type: 'error', code: 'AI_FAILED', message: 'AI 解读暂未应机' })}\n\n`);
+      res.end();
+    } else {
+      res.status(502).json({ error: 'AI_FAILED' });
+    }
+  }
+});
+
+
+// 报告解析：按两套 Schema 归一化（命盘类/占问类），字段缺失兜底
+interface RawReading { summary: string; keyPoints: string[] }
+
+// ─── Step1 盘面解析缓存 ───
+// 同一 divineId + 同一问题复用同一份盘面解析：多次解读的输入一致 → 输出不再互相矛盾
+// （Step1 每次调用结果都不同是「一会严格一会宽松」的主因之一）
+const step1Cache = new Map<string, string>();
+const STEP1_CACHE_MAX = 300;
+async function getStep1(divineId: string, artId: string, question: string, resultRaw: unknown, profile: unknown): Promise<string> {
+  const key = divineId + '|' + (question || '');
+  const hit = step1Cache.get(key);
+  if (hit) return hit;
+  try {
+    const text = await chatOnce(buildStep1Messages(artId, question, resultRaw, profile));
+    if (step1Cache.size > STEP1_CACHE_MAX) step1Cache.clear();
+    step1Cache.set(key, text);
+    return text;
+  } catch (e: any) {
+    console.warn('[ai] Step1 盘面解析失败，降级为单步模式:', e.message);
+    return '';
+  }
+}
+
+export interface AIReportNormalized {
+  kind: 'mingpan' | 'zhanwen';
+  title: string;
+  overview: string;
+  rawReading: RawReading;
+  character?: { summary: string; traits: { name: string; desc: string }[]; coreConflict?: string; emotion?: string };
+  family?: { background?: string; parents?: string; imprint?: string };
+  mind?: { action?: string; pattern?: string; growth?: string };
+  lifeStages?: { stage: string; age: string; summary: string }[];
+  career?: { summary: string; direction: string; advice: string };
+  love?: { summary: string; advice: string };
+  wealth?: { summary: string; advice: string };
+  health?: { summary: string; advice: string };
+  situation?: string;
+  trend?: string;
+  timing?: string;
+  advice: string;
+  conclusion: string;
+  disclaimer: string;
+  suitability?: { suitable: boolean | 'partial'; note: string; suggestion: string };
+  quality?: 'ok' | 'poor';
+}
+
+// 后端文本清洗：剥离 Markdown 格式标记（**、*、#、>、- 等），保留纯文本
+function stripMd(s: string): string {
+  return s
+    .replace(/\*\*/g, '')
+    .replace(/^#{1,6}\s+/gm, '')
+    .replace(/^>\s*/gm, '')
+    .replace(/^[-*+]\s+/gm, '')
+    .replace(/^\d+\.\s+/gm, '')
+    .replace(/`([^`]*)`/g, '$1')
+    .replace(/!?\[([^\]]*)\]\([^)]*\)/g, '$1')
+    .replace(/\s{2,}/g, ' ')
+    .trim();
+}
+
+function str(v: unknown, fb = ''): string {
+  return v === undefined || v === null ? fb : stripMd(String(v));
+}
+
+// 严格判断输出是否满足 Schema 关键要求（命盘：character+lifeStages 或 career/love/wealth；占问：situation/trend/timing）
+function reportMeetsSchema(obj: any, kind: 'mingpan' | 'zhanwen'): boolean {
+  if (!obj || typeof obj !== 'object' || Array.isArray(obj)) return false;
+  if (kind === 'mingpan') {
+    const ch = obj.character;
+    const okChar = ch && (typeof ch.summary === 'string' && ch.summary.length > 10 || Array.isArray(ch.traits) && ch.traits.length > 0);
+    const okLife = Array.isArray(obj.lifeStages) && obj.lifeStages.length > 0;
+    const okDomains = obj.career || obj.love || obj.wealth;
+    return okChar && okLife && okDomains;
+  }
+  return typeof obj.situation === 'string' && obj.situation.length > 10
+    && typeof obj.trend === 'string' && obj.trend.length > 10
+    && typeof obj.timing === 'string' && obj.timing.length > 10;
+}
+function stripJson(text: string): string {
+  const t = text.trim().replace(/^```json\s*/i, '').replace(/\s*```$/, '');
+  return t;
+}
+
+export function parseReport(text: string, kind: 'mingpan' | 'zhanwen'): AIReportNormalized {
+  const cleaned = text.trim().replace(/^```json\s*/i, '').replace(/```\s*$/, '');
+  let obj: any = {};
+  try { obj = JSON.parse(cleaned); } catch {
+    return { kind, title: '观微解读报告', overview: cleaned, rawReading: { summary: cleaned, keyPoints: [] }, advice: '', conclusion: '', disclaimer: '凡占问所得，仅供修身养性、怡情遣兴之用，不构成决策依据。' };
+  }
+  if (Array.isArray(obj.chapters) && obj.chapters.length && !obj.rawReading) {
+    const body = obj.chapters.map((ch: any) => '【' + (ch.skill || '') + '】' + str(ch.content)).join('\n');
+    return {
+      kind,
+      title: str(obj.title, '观微解读报告'),
+      overview: str(obj.overview) || body.slice(0, 200),
+      rawReading: { summary: body, keyPoints: [] },
+      advice: str(obj.conclusion, ''),
+      conclusion: str(obj.conclusion, ''),
+      disclaimer: str(obj.disclaimer, '凡占问所得，仅供修身养性、怡情遣兴之用，不构成决策依据。'),
+    };
+  }
+  const raw = (obj.rawReading || {}) as any;
+  const out: AIReportNormalized = {
+    kind,
+    title: str(obj.title, '观微解读报告'),
+    overview: str(obj.overview),
+    rawReading: { summary: str(raw.summary), keyPoints: Array.isArray(raw.keyPoints) ? raw.keyPoints.map((k: unknown) => String(k)) : [] },
+    advice: str(obj.advice),
+    conclusion: str(obj.conclusion),
+    disclaimer: str(obj.disclaimer, '凡占问所得，仅供修身养性、怡情遣兴之用，不构成决策依据。'),
+  };
+  if (kind === 'mingpan') {
+    const ch = (obj.character || {}) as any;
+    out.character = {
+      summary: str(ch.summary),
+      traits: Array.isArray(ch.traits) ? ch.traits.filter((t: any) => t && t.name).map((t: any) => ({ name: String(t.name), desc: str(t.desc) })) : [],
+      coreConflict: str(ch.coreConflict),
+      emotion: str(ch.emotion),
+    };
+    const fam = (obj.family || {}) as any;
+    out.family = { background: str(fam.background), parents: str(fam.parents), imprint: str(fam.imprint) };
+    const mind = (obj.mind || {}) as any;
+    out.mind = { action: str(mind.action), pattern: str(mind.pattern), growth: str(mind.growth) };
+    out.lifeStages = Array.isArray(obj.lifeStages) ? obj.lifeStages.filter((s: any) => s && s.stage).map((s: any) => ({ stage: String(s.stage), age: str(s.age), summary: str(s.summary) })) : [];
+    const career = (obj.career || {}) as any;
+    out.career = { summary: str(career.summary), direction: str(career.direction), advice: str(career.advice) };
+    const love = (obj.love || {}) as any;
+    out.love = { summary: str(love.summary), advice: str(love.advice) };
+    const wealth = (obj.wealth || {}) as any;
+    const health = (obj.health || {}) as any;
+    out.health = { summary: str(health.summary), advice: str(health.advice) };
+    out.wealth = { summary: str(wealth.summary), advice: str(wealth.advice) };
+  } else {
+    out.situation = str(obj.situation);
+    out.trend = str(obj.trend);
+    out.timing = str(obj.timing);
+  }
+  // 兜底：AI 返回的自定义字段（如 minggong/dayun/liunian）转为通用章节，保证任何输出都有结构化展示
+  const KNOWN = new Set(['title', 'overview', 'rawReading', 'character', 'family', 'mind', 'lifeStages', 'career', 'love', 'wealth', 'health', 'advice', 'conclusion', 'disclaimer', 'suitability', 'situation', 'trend', 'timing', 'chapters', 'sections', 'kind']);
+  const extra: { skill: string; content: string }[] = [];
+  Object.keys(obj).forEach((k: string) => {
+    if (KNOWN.has(k)) return;
+    const v = obj[k];
+    if (typeof v === 'string' && v.length > 10) extra.push({ skill: k, content: v });
+  });
+  if (extra.length) (out as any).extraSections = extra;
+  const sui = (obj.suitability || {}) as any;
+  if (obj.suitability) {
+    out.suitability = {
+      suitable: sui.suitable === true || sui.suitable === 'partial' ? sui.suitable : false,
+      note: str(sui.note),
+      suggestion: str(sui.suggestion),
+    };
+  }
+  // 质量评分：关键字段缺失/为空 -> poor（前端据此提示本次解读可能不完整）
+  let score = 0;
+  const has = (v: unknown) => typeof v === 'string' && stripMd(v).length > 10;
+  if (has(out.overview)) score += 15;
+  if (out.rawReading && (has(out.rawReading.summary) || (out.rawReading.keyPoints?.length || 0) > 0)) score += 15;
+  if (kind === 'mingpan') {
+    if (out.character && (has(out.character.summary) || (out.character.traits?.length || 0) > 0)) score += 20;
+    if (out.lifeStages && out.lifeStages.length > 0 && out.lifeStages.some(s => has(s.summary))) score += 20;
+    if (has(out.career?.summary) || has(out.love?.summary) || has(out.wealth?.summary)) score += 15;
+    if (has(out.health?.summary)) score += 5;
+    // 模板要求的扩展维度（原生家庭 / 心智模式）：AI 已认真展开的内容不应被丢弃或判劣
+    if (out.family && (has(out.family.background) || has(out.family.parents) || has(out.family.imprint))) score += 5;
+    if (out.mind && (has(out.mind.action) || has(out.mind.pattern) || has(out.mind.growth))) score += 5;
+  } else {
+    if (has(out.situation)) score += 20;
+    if (has(out.trend)) score += 20;
+    if (has(out.timing)) score += 15;
+  }
+  if (has(out.advice)) score += 10;
+  if (has(out.conclusion)) score += 5;
+  out.quality = score >= 60 ? 'ok' : 'poor';
+  return out;
+}
+export function parseSections(text: string): { title: string; content: string }[] {
+  const cleaned = text.trim().replace(/^```json\s*/i, '').replace(/\s*```$/, '');
+  try {
+    const obj = JSON.parse(cleaned);
+    if (Array.isArray(obj.sections)) {
+      return obj.sections.filter((s: any) => s && s.title && s.content).map((s: any) => ({ title: String(s.title), content: String(s.content) }));
+    }
+    // 结构化报告 JSON → 多章节（兼容旧 JS 不读 report 字段时也能分节展示）
+    const out: { title: string; content: string }[] = [];
+    const str = (v: unknown): string => (typeof v === 'string' ? v : v ? JSON.stringify(v) : '');
+    const push = (t: string, v: unknown) => { const s = str(v); if (s && s.length > 2) out.push({ title: t, content: s }); };
+    push('总览', obj.overview);
+    if (obj.rawReading) push('原始解读', typeof obj.rawReading === 'string' ? obj.rawReading : obj.rawReading.summary);
+    if (obj.character) {
+      const ch = obj.character;
+      const traits = Array.isArray(ch.traits) ? ch.traits.map((t: any) => t?.name + '：' + (t?.desc || '')).join('\n') : '';
+      push('性格', ch.summary + (traits ? '\n' + traits : ''));
+    }
+    if (obj.family) {
+      const fam = obj.family;
+      const parts = [fam.background && '家境与氛围：' + fam.background, fam.parents && '父母关系：' + fam.parents, fam.imprint && '家庭印记：' + fam.imprint].filter(Boolean);
+      push('原生家庭', parts.join('\n\n'));
+    }
+    if (obj.mind) {
+      const mind = obj.mind;
+      const parts = [mind.action && '行动力与坚持：' + mind.action, mind.pattern && '行为循环：' + mind.pattern, mind.growth && '成长方向：' + mind.growth].filter(Boolean);
+      push('心智与行动模式', parts.join('\n\n'));
+    }
+    if (Array.isArray(obj.lifeStages)) push('人生阶段', obj.lifeStages.map((s: any) => '【' + s.stage + (s.age ? '（' + s.age + '）' : '') + '】' + s.summary).join('\n'));
+    if (obj.career) push('事业', (obj.career.summary || '') + (obj.career.direction ? '\n方向：' + obj.career.direction : '') + (obj.career.advice ? '\n建议：' + obj.career.advice : ''));
+    if (obj.love) push('爱情', (obj.love.summary || '') + (obj.love.advice ? '\n建议：' + obj.love.advice : ''));
+    if (obj.wealth) push('财富', (obj.wealth.summary || '') + (obj.wealth.advice ? '\n建议：' + obj.wealth.advice : ''));
+    push('现状', obj.situation);
+    push('趋势', obj.trend);
+    push('时机', obj.timing);
+    push('建议', obj.advice);
+    push('结语', obj.conclusion);
+    push('声明', obj.disclaimer);
+    if (out.length) return out;
+  } catch { /* 非 JSON，走散文兜底 */ }
+  // 兜底：整段为一节
+  return [{ title: 'AI 参详', content: cleaned || 'AI 未返回内容' }];
+}
+
+export default router;

package/server/src/routes/divine.ts

@@ -0,0 +1,140 @@
+// 排盘路由：登录用户起占 → 后端引擎计算 → SQLite 入库 → 返回 resultRaw + display
+import { Router } from 'express';
+import { baziCalc } from '../../../shared/core/engine/bazi.js';
+import { ziweiCalc } from '../../../shared/core/engine/ziwei.js';
+import { astrologyCalc } from '../../../shared/core/engine/astrology.js';
+import { qimenCalc } from '../../../shared/core/engine/qimen.js';
+import { meihuaCalc } from '../../../shared/core/engine/meihua.js';
+import { liuyaoCalc } from '../../../shared/core/engine/liuyao.js';
+import { liurenCalc } from '../../../shared/core/engine/liuren.js';
+import { xiaoliurenCalc } from '../../../shared/core/engine/xiaoliuren.js';
+import { tarotDraw } from '../../../shared/core/engine/tarot.js';
+import { allTarotSpreads } from '../../../shared/core/data/tarotSpreads.js';
+import { createDivination, listDivinations, getDivination, deleteDivination } from '../services/divineStore.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DB_FILE = path.join(__dirname, '..', 'data', 'db.json');
+
+const router = Router();
+const MINGPAN_ARTS = ['bazi', 'ziwei', 'astrology'];
+
+// 宽松建档：前端本地注册的用户在此同步建档（与 users.ts upsert 同策略）
+function ensureUser(username: string): boolean {
+  if (!username || typeof username !== 'string') return false;
+  try {
+    const db = JSON.parse(fs.readFileSync(DB_FILE, 'utf-8'));
+    if (db.users.some((u: any) => u.username === username)) return true;
+    db.users.push({ username, passHash: '', createdAt: Date.now(), profile: {}, samples: [], records: [] });
+    fs.writeFileSync(DB_FILE, JSON.stringify(db, null, 2));
+    console.log('[divine] 自动建档:', username);
+    return true;
+  } catch { return false; }
+}
+
+// POST /api/divine —— 起占入库
+router.post('/', (req, res) => {
+  const { artId, inputs, profile, question, username, profileId } = req.body || {};
+  // 游客不允许
+  if (!ensureUser(username)) {
+    return res.status(401).json({ error: 'UNAUTHORIZED', message: '请先入馆（登录）再起占' });
+  }
+  if (!artId || !inputs) return res.status(400).json({ error: '缺少必要参数' });
+
+  let resultRaw: unknown;
+  try {
+    switch (artId) {
+      case 'bazi': {
+        const i = inputs as any;
+        resultRaw = baziCalc({ y: i.y, m: i.m, d: i.d, hourIndex: i.hourIndex, time: i.time, gender: i.gender, location: i.location });
+        break;
+      }
+      case 'ziwei': {
+        const i = inputs as any;
+        resultRaw = ziweiCalc({ ganzhi: i.ganzhi, month: i.month, day: i.day, hour: i.hour, time: i.time, location: i.location, gender: i.gender, birthYear: i.birthYear });
+        break;
+      }
+      case 'astrology': {
+        const i = inputs as any;
+        resultRaw = astrologyCalc(i.y, i.m, i.d, i.hour || 0, i.min || 0, i.lng, i.lat);
+        break;
+      }
+      case 'qimen': {
+        resultRaw = qimenCalc({ datetime: (inputs as any).datetime || new Date() });
+        break;
+      }
+      case 'meihua': {
+        const i = inputs as any;
+        resultRaw = meihuaCalc({ mode: i.mode || 'time', n1: i.n1, n2: i.n2, n3: i.n3, now: i.now ? new Date(i.now) : undefined });
+        break;
+      }
+      case 'liuyao': {
+        const now = new Date();
+        resultRaw = liuyaoCalc(undefined, { y: now.getFullYear(), m: now.getMonth() + 1, d: now.getDate() });
+        break;
+      }
+      case 'liuren': {
+        resultRaw = liurenCalc((inputs as any).datetime || new Date());
+        break;
+      }
+      case 'xiaoliuren': {
+        const i = inputs as any;
+        resultRaw = xiaoliurenCalc(i.mode || 'time', i.m, i.d, i.h, i.n1, i.n2, i.n3);
+        break;
+      }
+      case 'tarot': {
+        const i = inputs as any;
+        const cards = tarotDraw(Math.max(1, i.n || 3));
+        const spread = allTarotSpreads().find((s: any) => s.id === i.spread) || allTarotSpreads()[0];
+        resultRaw = { spread: spread || { id: 'three', name: '圣三角', description: '', positions: [] }, cards };
+        break;
+      }
+      default:
+        return res.status(400).json({ error: '术无此名' });
+    }
+  } catch (e: any) {
+    console.error('[divine] 推演异常:', e);
+    return res.status(500).json({ error: 'DIVINE_FAILED', message: '推演未应机' });
+  }
+
+  const kind = MINGPAN_ARTS.includes(artId) ? 'mingpan' : 'zhanwen';
+  const rec = createDivination({
+    username, artId, kind,
+    question: question || undefined,
+    profileId: profileId || 'main',
+    profile: profile || undefined,
+    params: inputs,
+    resultRaw,
+  });
+  res.json({ ok: true, divineId: rec.id, resultRaw, display: rec.display });
+});
+
+// GET /api/divine?username=&page=&pageSize= —— 占卜历史
+router.get('/', (req, res) => {
+  const username = String(req.query.username || '');
+  const page = Number(req.query.page || 1);
+  const pageSize = Number(req.query.pageSize || 20);
+  if (!ensureUser(username)) return res.status(401).json({ error: 'UNAUTHORIZED' });
+  res.json(listDivinations(username, page, pageSize, String(req.query.profileId || '')));
+});
+
+// GET /api/divine/:id —— 详情（排盘 + AI 报告）
+router.get('/:id', (req, res) => {
+  const rec = getDivination(req.params.id);
+  if (!rec) return res.status(404).json({ error: 'DIVINE_NOT_FOUND' });
+  // 归属校验：query username 必须与记录一致
+  if (req.query.username !== rec.username) return res.status(403).json({ error: 'FORBIDDEN' });
+  res.json({ ...rec, resultRaw: rec.resultRaw, display: rec.display, report: rec.report || null });
+});
+
+// DELETE /api/divine/:id?username= —— 删除（校验归属）
+router.delete('/:id', (req, res) => {
+  const username = String(req.query.username || '');
+  const ok = deleteDivination(req.params.id, username);
+  if (!ok) return res.status(404).json({ error: 'DIVINE_NOT_FOUND' });
+  res.json({ ok: true });
+});
+
+export default router;

package/server/src/routes/hour.ts

@@ -0,0 +1,40 @@
+// 时辰反推路由：POST /api/hour-infer
+import { Router } from 'express';
+import { inferHour, type HourInferEvent } from '../services/hourInference.js';
+
+const router = Router();
+
+router.post('/hour-infer', (req, res) => {
+  const { y, m, d, gender, location, candidates, events } = req.body || {};
+  if (!y || !m || !d || !gender) {
+    return res.status(400).json({ error: '缺少必要参数（y/m/d/gender）' });
+  }
+  if (!Array.isArray(events) || events.length === 0) {
+    return res.status(400).json({ error: '请至少提供一条关键人生事件' });
+  }
+  const cleanEvents: HourInferEvent[] = events
+    .map((e: any) => ({
+      year: Number(e?.year),
+      text: String(e?.text || '').slice(0, 60),
+      type: ['health', 'love', 'job', 'family', 'money', 'study', 'move', 'breakup'].includes(e?.type) ? e.type : undefined,
+    }))
+    .filter((e: HourInferEvent) => Number.isFinite(e.year) && e.year >= 1900 && e.year <= 2100 && e.text);
+  if (cleanEvents.length === 0) {
+    return res.status(400).json({ error: '事件格式不正确（需 年份 + 描述）' });
+  }
+  try {
+    const result = inferHour({
+      y: Number(y), m: Number(m), d: Number(d),
+      gender: gender === '女' ? '女' : '男',
+      location: location || null,
+      candidates: Array.isArray(candidates) ? candidates.map(Number).filter(n => Number.isInteger(n) && n >= 0 && n <= 11) : undefined,
+      events: cleanEvents,
+    });
+    res.json(result);
+  } catch (e: any) {
+    console.error('[hour-infer]', e);
+    res.status(500).json({ error: 'INFER_FAILED', message: '时辰推演未应机' });
+  }
+});
+
+export default router;