guanwei 1.1.1

package/server/src/routes/tarot.ts

@@ -0,0 +1,129 @@
+import { Router } from 'express';
+import { tarotCards } from '../data/tarotCards.js';
+import { defaultSpreads } from '../data/spreads.js';
+import { drawCards, generateInterpretation } from '../utils/tarotEngine.js';
+import { analyzeQuestion } from '../utils/semanticAnalyzer.js';
+import type { QuestionCategory, Spread } from '../types/index.js';
+
+const router = Router();
+
+router.get('/cards', (_req, res) => {
+  res.json({ cards: tarotCards });
+});
+
+router.get('/spreads', (_req, res) => {
+  res.json({ spreads: defaultSpreads });
+});
+
+router.post('/draw', (req, res) => {
+  const { spreadId, customSpread } = req.body;
+  
+  let spread: Spread | undefined;
+  
+  if (customSpread) {
+    spread = customSpread;
+  } else {
+    spread = defaultSpreads.find(s => s.id === spreadId);
+  }
+  
+  if (!spread) {
+    return res.status(400).json({ error: '牌阵不存在' });
+  }
+  
+  const cards = drawCards(spread);
+  res.json({ cards, spread });
+});
+
+router.post('/interpret', (req, res) => {
+  const { cards, spread, question, category } = req.body;
+  
+  if (!cards || !spread || !question) {
+    return res.status(400).json({ error: '缺少必要参数' });
+  }
+  
+  const result = generateInterpretation(
+    cards,
+    spread,
+    question,
+    category as QuestionCategory
+  );
+  
+  res.json(result);
+});
+
+router.post('/analyze', (req, res) => {
+  const { question, category } = req.body;
+  
+  if (!question) {
+    return res.status(400).json({ error: '缺少问题' });
+  }
+  
+  const result = analyzeQuestion(question, category);
+  res.json(result);
+});
+
+router.post('/interpret/stream', (req, res) => {
+  const { cards, spread, question, category } = req.body;
+  
+  if (!cards || !spread || !question) {
+    return res.status(400).json({ error: '缺少必要参数' });
+  }
+  
+  const result = generateInterpretation(
+    cards,
+    spread,
+    question,
+    category as QuestionCategory
+  );
+  
+  res.setHeader('Content-Type', 'text/event-stream');
+  res.setHeader('Cache-Control', 'no-cache');
+  res.setHeader('Connection', 'keep-alive');
+  
+  let sectionIndex = 0;
+  
+  const sendSection = () => {
+    if (sectionIndex >= result.sections.length) {
+      res.write('event: done\n');
+      res.write('data: [DONE]\n\n');
+      res.end();
+      return;
+    }
+    
+    const section = result.sections[sectionIndex];
+    const chars = section.content.split('');
+    let charIndex = 0;
+    
+    const typeChar = () => {
+      if (charIndex >= chars.length) {
+        sectionIndex++;
+        setTimeout(sendSection, 300);
+        return;
+      }
+      
+      res.write(`data: ${JSON.stringify({
+        type: 'char',
+        sectionIndex,
+        sectionType: section.type,
+        sectionTitle: section.title,
+        char: chars[charIndex],
+        isFirst: charIndex === 0,
+      })}\n\n`);
+      
+      charIndex++;
+      setTimeout(typeChar, 20 + Math.random() * 30);
+    };
+    
+    typeChar();
+  };
+  
+  res.write(`data: ${JSON.stringify({
+    type: 'start',
+    totalSections: result.sections.length,
+    semantic: result.semantic,
+  })}\n\n`);
+  
+  setTimeout(sendSection, 500);
+});
+
+export default router;

package/server/src/routes/users.ts

@@ -0,0 +1,140 @@
+// 用户/档案/记录 API（本地 JSON 文件存储，供前后端联调）
+import { Router } from 'express';
+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');
+
+interface DbUser {
+  username: string;
+  passHash: string;
+  createdAt: number;
+  profile: Record<string, unknown>;
+  samples: { id: string; name: string; profile: Record<string, unknown> }[];
+  records: Record<string, unknown>[];
+}
+
+interface Db { users: DbUser[] }
+
+function loadDb(): Db {
+  try { return JSON.parse(fs.readFileSync(DB_FILE, 'utf-8')); }
+  catch { return { users: [] }; }
+}
+
+function saveDb(db: Db): void {
+  fs.mkdirSync(path.dirname(DB_FILE), { recursive: true });
+  fs.writeFileSync(DB_FILE, JSON.stringify(db, null, 2));
+}
+
+function hash(pw: string): string {
+  let h = 5381;
+  const s = 'guanwei::' + pw;
+  for (let i = 0; i < s.length; i++) h = ((h << 5) + h + s.charCodeAt(i)) >>> 0;
+  return 'h' + h.toString(16);
+}
+
+const router = Router();
+
+// 注册
+// 云同步 upsert：本地账号（无密语）不存在时自动建档，避免因数据清理导致 404
+function upsertUser(username: string): DbUser {
+  const db = loadDb();
+  let user = db.users.find((x: any) => x.username === username);
+  if (!user) {
+    user = { username, passHash: '', createdAt: Date.now(), profile: {}, samples: [], records: [] };
+    db.users.push(user);
+    saveDb(db);
+    console.log(`[users] 自动建档: ${username}`);
+  }
+  return user;
+}
+
+router.post('/register', (req, res) => {
+  const { username, password, profile } = req.body;
+  const name = String(username || '').trim();
+  if (name.length < 2) return res.status(400).json({ error: '名号至少二字' });
+  if (!password || String(password).length < 4) return res.status(400).json({ error: '密语至少四位' });
+  const db = loadDb();
+  const existing = db.users.find(u => u.username === name);
+  if (existing) {
+    // 云同步自动建档的占位账号（无密语）可被正式注册升级
+    if (!existing.passHash) {
+      existing.passHash = hash(String(password));
+      if (profile) existing.profile = { ...existing.profile, ...profile };
+      saveDb(db);
+      return res.json({ ok: true, upgraded: true, user: { username: existing.username, profile: existing.profile, samples: existing.samples } });
+    }
+    return res.status(400).json({ error: '此名号已有人用' });
+  }
+  const user: DbUser = { username: name, passHash: hash(String(password)), createdAt: Date.now(), profile: profile || {}, samples: [], records: [] };
+  db.users.push(user);
+  saveDb(db);
+  res.json({ ok: true, user: { username: user.username, profile: user.profile, samples: user.samples } });
+});
+
+// 登录
+router.post('/login', (req, res) => {
+  const { username, password } = req.body;
+  const db = loadDb();
+  const user = db.users.find(u => u.username === String(username || '').trim());
+  if (!user || user.passHash !== hash(String(password || ''))) return res.status(401).json({ error: '名号或密语未合' });
+  res.json({ ok: true, user: { username: user.username, profile: user.profile, samples: user.samples } });
+});
+
+// 档案读取/更新
+router.get('/:username/profile', (req, res) => {
+  const db = loadDb();
+  const user = db.users.find(u => u.username === req.params.username);
+  if (!user) return res.status(404).json({ error: '馆中无此人' });
+  res.json({ profile: user.profile, samples: user.samples });
+});
+
+router.put('/:username/profile', (req, res) => {
+  const db = loadDb();
+  const user = db.users.find(u => u.username === req.params.username);
+  if (!user) return res.status(404).json({ error: '馆中无此人' });
+  user.profile = req.body.profile || user.profile;
+  saveDb(db);
+  res.json({ ok: true, profile: user.profile });
+});
+
+// 示例档案增删/提升
+router.post('/:username/samples', (req, res) => {
+  const db = loadDb();
+  const user = db.users.find(u => u.username === req.params.username);
+  if (!user) return res.status(404).json({ error: '馆中无此人' });
+  const sample = { id: 's' + Date.now(), name: String(req.body.name || '未名档案'), profile: req.body.profile || {} };
+  user.samples.push(sample);
+  saveDb(db);
+  res.json({ ok: true, samples: user.samples });
+});
+
+router.delete('/:username/samples/:id', (req, res) => {
+  const db = loadDb();
+  const user = db.users.find(u => u.username === req.params.username);
+  if (!user) return res.status(404).json({ error: '馆中无此人' });
+  user.samples = user.samples.filter(s => s.id !== req.params.id);
+  saveDb(db);
+  res.json({ ok: true, samples: user.samples });
+});
+
+// 记录同步（按用户整表覆盖）
+router.put('/:username/records', (req, res) => {
+  const db = loadDb();
+  const user = db.users.find(u => u.username === req.params.username);
+  if (!user) return res.status(404).json({ error: '馆中无此人' });
+  user.records = Array.isArray(req.body.records) ? req.body.records : [];
+  saveDb(db);
+  res.json({ ok: true, count: user.records.length });
+});
+
+router.get('/:username/records', (req, res) => {
+  const db = loadDb();
+  const user = db.users.find(u => u.username === req.params.username);
+  if (!user) return res.status(404).json({ error: '馆中无此人' });
+  res.json({ records: user.records });
+});
+
+export default router;

package/server/src/services/chartBrief.ts

@@ -0,0 +1,131 @@
+// 盘面摘要生成：九术排盘结果 → 结构化中文事实（AI 注入用）
+// 目的：① 比全量 JSON 更利于模型逐字引用 ② 减少输入 token ③ 事实边界清晰（摘要是「可引用域」）
+import type { BaziResult, ZiweiResult, AstrologyResult, QimenResult, MeihuaResult, LiuyaoResult, LiurenResult, XiaoliurenResult } from '../../../shared/core/types';
+
+const DIZHI = ['寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥', '子', '丑'];
+
+export function chartBrief(artId: string, resultRaw: unknown): string {
+  try {
+    switch (artId) {
+      case 'bazi': return baziBrief(resultRaw as BaziResult);
+      case 'ziwei': return ziweiBrief(resultRaw as ZiweiResult);
+      case 'astrology': return astroBrief(resultRaw as AstrologyResult);
+      case 'qimen': return qimenBrief(resultRaw as QimenResult);
+      case 'meihua': return meihuaBrief(resultRaw as MeihuaResult);
+      case 'liuyao': return liuyaoBrief(resultRaw as LiuyaoResult);
+      case 'liuren': return liurenBrief(resultRaw as LiurenResult);
+      case 'xiaoliuren': return xiaoliurenBrief(resultRaw as XiaoliurenResult);
+      case 'tarot': return tarotBrief(resultRaw as any);
+      default: return JSON.stringify(resultRaw, null, 1);
+    }
+  } catch {
+    return JSON.stringify(resultRaw, null, 1);
+  }
+}
+
+function baziBrief(r: BaziResult): string {
+  const L: string[] = ['【四柱】' + r.yearGZ + ' 年 / ' + r.monthGZ + ' 月 / ' + r.dayGZ + ' 日（日主' + r.dayGan + r.dayGanWx + '）/ ' + r.hourGZ + ' 时。年命纳音' + r.nayin + '。'];
+  L.push('【天干十神】' + r.shishen.map((s, i) => ['年干', '月干', '日干', '时干'][i] + s.gan + s.name).join('、') + '。');
+  L.push('【地支藏干】' + r.canggan.map(c => c.zhi + '藏' + c.gans.map(g => g.gan + g.shishen + '(' + g.qi + ')').join('、')).join('；') + '。');
+  L.push('【五行分布】' + ['木', '火', '土', '金', '水'].map(k => k + (r.wxWeighted[k] || 0)).join(' ') + '（含藏干加权）。');
+  L.push('【旺衰】日主' + r.strength + '（旺衰分 ' + r.strengthDetail.score + '：' + r.strengthDetail.reasons.join('；') + '）。');
+  L.push('【用神喜忌】主用神' + r.yongshen.wx + '（' + r.yongshen.shishen + '）；喜' + r.yongshen.xi.join('、') + '；忌' + r.yongshen.ji.join('、') + '；调候：' + r.yongshen.tiaohou + '。');
+  if (r.dayun?.length) L.push('【大运】' + r.qiYun.detail + '；' + r.dayun.map(d => d.gz + '（' + d.startAge + '岁，' + d.startYear + '-' + d.endYear + '，' + d.ganShishen + '）').join('、') + '。');
+  L.push('【流年】' + r.liunian.year + '年 ' + r.liunian.gz + '（' + r.liunian.ganShishen + '，支藏' + r.liunian.zhiShishen + '）。');
+  if (r.shensha?.length) L.push('【神煞】' + r.shensha.map(s => s.name + s.zhi + '(' + s.type + ')').join('、') + '。');
+  L.push('【格局】' + r.geju.name + '——' + r.geju.basis + '。');
+  L.push('【胎元命身】胎元' + r.taiyuan + '，命宫' + r.minggong + '，身宫' + r.shengong + '。');
+  return L.join('\n');
+}
+
+function ziweiBrief(r: ZiweiResult): string {
+  const L: string[] = ['【命盘】' + r.juName + '（年命纳音' + r.nayin + '），命宫' + DIZHI[r.ming] + '（' + r.mingGZ + '），身宫' + DIZHI[r.shen] + '，紫微落' + DIZHI[r.zwPos] + '宫，大限' + (r.forward ? '顺行' : '逆行') + '。'];
+  L.push('【生年四化】' + r.sihua.lu + '化禄、' + r.sihua.quan + '化权、' + r.sihua.ke + '化科、' + r.sihua.ji + '化忌。');
+  L.push('【十四主星落宫】' + Object.entries(r.zwStars).map(([s, p]) => s + DIZHI[p] + (r.brightness[s] || '')).join('、') + '。');
+  if (Object.keys(r.fuStars).length) L.push('【辅星】' + Object.entries(r.fuStars).map(([s, p]) => s + DIZHI[p]).join('、') + '。');
+  // ─── 十二宫完整清单（命宫起逆时针）：宫名+地支+主星+辅星+四化 ───
+  // 消除 AI 自行推算宫位的需求（推算即出错源），解读须逐字引用此清单
+  const PALACE_NAMES = ['命宫', '兄弟宫', '夫妻宫', '子女宫', '财帛宫', '疾厄宫', '迁移宫', '交友宫', '官禄宫', '田宅宫', '福德宫', '父母宫'];
+  const SIHUA_KEY: Record<string, string> = { lu: '化禄', quan: '化权', ke: '化科', ji: '化忌' };
+  const palaceLines: string[] = [];
+  for (let i = 0; i < 12; i++) {
+    const zhiIdx = r.palaces?.[i] ?? mod2(r.ming - i, 12);
+    const stars = Object.entries(r.zwStars).filter(([, p]) => p === zhiIdx).map(([s]) => s);
+    const fus = Object.entries(r.fuStars || {}).filter(([, p]) => p === zhiIdx).map(([s]) => s);
+    const sh = Object.entries(r.sihuaPos || {}).filter(([, p]) => p === zhiIdx).map(([k]) => SIHUA_KEY[k]).join('、');
+    const parts: string[] = [];
+    parts.push(DIZHI[zhiIdx]);
+    parts.push(stars.length ? stars.join('、') : '无主星');
+    if (fus.length) parts.push('辅' + fus.join('、'));
+    if (sh) parts.push(sh);
+    palaceLines.push(PALACE_NAMES[i] + parts.join('｜'));
+  }
+  L.push('【十二宫事实（解读六亲/宫位必须逐字引用，不得推算或编造）】' + palaceLines.join('；') + '。');
+  if (r.geju?.length) L.push('【格局】' + r.geju.map(g => g.name + '(' + g.ji + ')').join('、') + '。');
+  if (r.dayun?.length) L.push('【大限】当前第' + ((r.curDayunIdx ?? 0) + 1) + '大限（' + r.dayun[r.curDayunIdx ?? 0].start + '-' + r.dayun[r.curDayunIdx ?? 0].end + '岁，行至' + DIZHI[r.dayun[r.curDayunIdx ?? 0].palaceIdx] + '宫）。');
+  L.push('【流年】' + (r.nominalAge ?? '') + '虚岁流年命宫落' + (r.liunianPalaceName || '') + '（' + DIZHI[r.liunianIdx ?? 0] + '），主星' + (r.liunianStars?.join('、') || '未临') + '。');
+  return L.join('\n');
+}
+
+function astroBrief(r: AstrologyResult): string {
+  const L: string[] = ['【命盘之纲】上升' + r.ascSign + (mod2(r.asc, 30)).toFixed(1) + '°，太阳' + r.sunSign + '，月亮' + r.moonSign + '，中天' + (r.mc !== undefined ? SIGNS[Math.floor(mod2(r.mc, 360) / 30)] : '') + '。宫位制：' + r.houseSystem + '。'];
+  L.push('【行星入宫】' + (r.planetDetails || []).map(p => p.cn + p.sign + p.degree.toFixed(0) + '°落' + p.house + '宫' + (p.retrograde ? '（逆）' : '') + (p.dignity.status ? '[' + p.dignity.status + ']' : '')).join('、') + '。');
+  if (r.houses?.length) L.push('【十二宫】' + r.houses.map(h => h.num + '宫' + h.sign + '（主' + h.ruler + '）').join('、') + '。');
+  if (r.aspects?.length) L.push('【相位】' + r.aspects.map(a => a[0] + a[2] + a[1]).join('、') + '。');
+  return L.join('\n');
+}
+
+function qimenBrief(r: QimenResult): string {
+  const L: string[] = ['【局式】' + (r.yin ? '阴遁' : '阳遁') + r.ju + '局（' + r.jqName + '），日' + r.dayGZ + ' 时' + r.hourGZ + '，旬首' + (r.xunshouName || r.xunShou) + '。'];
+  L.push('【值符值使】值符' + r.zfStar + '落' + r.zfPalace + '宫，值使' + r.zsMen + '门落' + r.zsPalace + '宫。');
+  const keyP = [r.zfPalace, r.zsPalace, 1, 9].filter((v, i, a) => a.indexOf(v) === i);
+  L.push('【关键宫位】' + keyP.map(p => p + '宫：奇仪' + (r.pan[p]?.yi || '') + '、门' + (r.pan[p]?.men || '') + '、星' + (r.pan[p]?.star || '') + (r.shen?.[p] ? '、八神' + r.shen[p] : '') + (r.tianYi?.[p] ? '、暗干' + r.tianYi[p] : '')).join('；') + '。');
+  return L.join('\n');
+}
+
+function meihuaBrief(r: MeihuaResult): string {
+  const L: string[] = ['【起卦】' + r.benGua.name + '（本卦，' + r.benGua.xiang + '），动爻第' + r.move + '爻。'];
+  if (r.huGua) L.push('【互卦】' + r.huGua.name + '（事之中）。');
+  L.push('【变卦】' + r.bianGua.name + '（事之归）。');
+  L.push('【体用】体卦' + r.tiWx + '、用卦' + r.yongWx + '，' + r.shengke + '。');
+  if (r.monthWx) L.push('【旺衰时令】起卦月令属' + r.monthWx + '，体卦' + r.tiWx + r.tiWangShuai + '、用卦' + r.yongWx + r.yongWangShuai + '。' + (r.wangShuaiNote || ''));
+  return L.join('\n');
+}
+
+function liuyaoBrief(r: LiuyaoResult): string {
+  const L: string[] = ['【卦象】' + r.benGua.name + '（' + r.benGua.xiang + '）' + (r.dongYao.length ? '，' + r.dongYao.length + '爻发动（' + r.dongYao.map(i => ['初', '二', '三', '四', '五', '上'][i - 1] + '爻').join('、') + '）变' + r.bianGua.name : '，六爻安静') + '。'];
+  if (r.najia) {
+    L.push('【纳甲装卦】' + r.najia.gong + '宫，' + r.najia.dayGZ + '日（' + r.najia.monthZhi + '月建），世爻在第' + r.najia.shiPos + '爻（' + r.najia.shiLiQin + '），应爻第' + r.najia.yingPos + '爻。');
+    L.push('【六亲六神】' + r.najia.lines.map((l, i) => ['初', '二', '三', '四', '五', '上'][i] + '爻' + l.gz + l.liuqin + '（' + l.shen + '）' + (l.isShi ? '世' : '') + (l.isYing ? '应' : '') + (l.kong ? '旬空' : '')).join('、') + '。');
+    L.push('【月破】' + r.najia.yuePo.join('、') + '；【旬空】' + r.najia.xunKong.join('、') + '。');
+  }
+  return L.join('\n');
+}
+
+function liurenBrief(r: LiurenResult): string {
+  const L: string[] = ['【课式】' + r.dayGZ + '日 ' + r.hourGZ + '时，' + r.jiang + '将加时（' + r.jqName + '），' + (r.isDay ? '昼占' : '夜占') + '贵人' + r.guiRen + '。'];
+  L.push('【四课】干上' + r.ke1 + '、干阴' + r.ke2 + '、支上' + r.ke3 + '、支阴' + r.ke4 + '。');
+  L.push('【三传】初传' + r.chuan1 + '（乘' + (r.chuanJiang?.[0]?.jiang || '') + '）、中传' + r.chuan2 + '（乘' + (r.chuanJiang?.[1]?.jiang || '') + '）、末传' + r.chuan3 + '（乘' + (r.chuanJiang?.[2]?.jiang || '') + '）。');
+  if (r.tianJiang) {
+    const ZHI2 = ['子', '丑', '寅', '卯', '辰', '巳', '午', '未', '申', '酉', '戌', '亥'];
+    L.push('【十二天将布宫】' + Object.entries(r.tianJiang).map(([k, v]) => v + ZHI2[+k]).join('、') + '。');
+  L.push('【课体】' + (r.keti || '常课') + '——' + (r.ketiNote || '') );
+  }
+  return L.join('\n');
+}
+
+function xiaoliurenBrief(r: XiaoliurenResult): string {
+  return '【掌诀】' + r.name + '（' + r.detail.ji + '，五行属' + r.detail.wx + '，主数' + r.detail.num + '，方位' + r.detail.dir + '）。' + r.detail.text;
+}
+
+function tarotBrief(r: any): string {
+  const cards = Array.isArray(r.cards) ? r.cards : Array.isArray(r) ? r : [];
+  const L: string[] = ['【牌阵】共' + cards.length + '张。'];
+  cards.forEach((c: any, i: number) => {
+    L.push('第' + (i + 1) + '张：' + (c.name || '') + (c.reversed ? '（逆位）' : '（正位）') + (c.position ? '，位' + c.position : '') + (c.up ? '，正位义：' + c.up : '') + (c.rev ? '；逆位义：' + c.rev : ''));
+  });
+  return L.join('\n');
+}
+
+const SIGNS = ['白羊', '金牛', '双子', '巨蟹', '狮子', '处女', '天秤', '天蝎', '射手', '摩羯', '水瓶', '双鱼'];
+function mod2(a: number, n: number) { return ((a % n) + n) % n; }

package/server/src/services/divineStore.ts

@@ -0,0 +1,188 @@
+// 占卜数据存储（SQLite）：起占记录 / AI 报告 / 失败留档 / 占卜历史
+// 依赖：node:sqlite（Node 22 内置，零依赖）
+import { DatabaseSync } from 'node:sqlite';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const DB_FILE = process.env.GUANWEI_DB_FILE || path.join(__dirname, '..', 'data', 'guanwei.db');
+
+let db: DatabaseSync | null = null;
+
+export function getDb(): DatabaseSync {
+  if (db) return db;
+  fs.mkdirSync(path.dirname(DB_FILE), { recursive: true });
+  db = new DatabaseSync(DB_FILE);
+  db.exec(`
+    CREATE TABLE IF NOT EXISTS divinations (
+      id            TEXT PRIMARY KEY,
+      username      TEXT NOT NULL,
+      art_id        TEXT NOT NULL,
+      kind          TEXT NOT NULL,
+      question      TEXT,
+      profile_id    TEXT NOT NULL DEFAULT 'main',
+      profile_json  TEXT,
+      params_json   TEXT,
+      result_raw_json TEXT NOT NULL,
+      display_json  TEXT NOT NULL,
+      report_json   TEXT,
+      report_quality TEXT,
+      status        TEXT NOT NULL DEFAULT 'divined',
+      created_at    INTEGER NOT NULL,
+      updated_at    INTEGER NOT NULL,
+      plan_tier     TEXT NOT NULL DEFAULT 'free',
+      quota_key     TEXT,
+      quota_consumed INTEGER NOT NULL DEFAULT 1,
+      billing_meta  TEXT
+    );
+    CREATE INDEX IF NOT EXISTS idx_div_user_time ON divinations(username, created_at DESC);
+
+    CREATE TABLE IF NOT EXISTS ai_fail_logs (
+      id          INTEGER PRIMARY KEY AUTOINCREMENT,
+      art_id      TEXT NOT NULL,
+      kind        TEXT NOT NULL,
+      divine_id   TEXT,
+      raw_output  TEXT,
+      fail_reason TEXT,
+      created_at  INTEGER NOT NULL
+    );
+  `);
+  // 老库迁移：补 profile_id 列（2026-08-20 档案隔离）——必须在引用该列的索引之前
+  try {
+    db.exec("ALTER TABLE divinations ADD COLUMN profile_id TEXT NOT NULL DEFAULT 'main'");
+  } catch (e: any) {
+    if (!/duplicate column/i.test(e.message || '')) console.error('[divineStore] 迁移 profile_id 失败:', e.message);
+  }
+  db.exec('CREATE INDEX IF NOT EXISTS idx_div_user_profile ON divinations(username, profile_id, created_at DESC)');
+  return db;
+}
+
+export interface DivineRecord {
+  id: string;
+  username: string;
+  artId: string;
+  kind: string;
+  question?: string;
+  profile?: unknown;
+  params?: unknown;
+  resultRaw: unknown;
+  display: unknown;
+  report?: unknown | null;
+  reportQuality?: string | null;
+  status: string;
+  createdAt: number;
+}
+
+export interface CreateDivinationArgs {
+  username: string;
+  artId: string;
+  kind: 'mingpan' | 'zhanwen';
+  question?: string;
+  profileId?: string;   // 档案标识：'main' 主档案 / 示例档案 id
+  profile?: unknown;
+  params?: unknown;
+  resultRaw: unknown;
+  display?: unknown;
+}
+
+function toRecord(row: any): DivineRecord {
+  return {
+    id: row.id,
+    username: row.username,
+    artId: row.art_id,
+    kind: row.kind,
+    question: row.question || undefined,
+    profile: row.profile_json ? JSON.parse(row.profile_json) : undefined,
+    params: row.params_json ? JSON.parse(row.params_json) : undefined,
+    resultRaw: JSON.parse(row.result_raw_json),
+    display: JSON.parse(row.display_json),
+    report: row.report_json ? JSON.parse(row.report_json) : null,
+    reportQuality: row.report_quality || null,
+    status: row.status,
+    createdAt: row.created_at,
+  };
+}
+
+// 起占入库（status='divined'），返回记录
+export function createDivination(args: CreateDivinationArgs): DivineRecord {
+  const d = getDb();
+  const now = Date.now();
+  const id = 'd_' + now + '_' + Math.random().toString(36).slice(2, 7);
+  const display = args.display !== undefined ? args.display : args.resultRaw;
+  d.prepare(`INSERT INTO divinations
+    (id, username, art_id, kind, question, profile_id, profile_json, params_json, result_raw_json, display_json, status, created_at, updated_at)
+    VALUES (?, ?, ?, ?, ?, ?, ?, ?, ?, ?, 'divined', ?, ?)`).run(
+    id, args.username, args.artId, args.kind,
+    args.question || null,
+    args.profileId || 'main',
+    args.profile ? JSON.stringify(args.profile) : null,
+    args.params ? JSON.stringify(args.params) : null,
+    JSON.stringify(args.resultRaw),
+    JSON.stringify(display),
+    now, now,
+  );
+  return {
+    id, username: args.username, artId: args.artId, kind: args.kind,
+    question: args.question, profile: args.profile, params: args.params,
+    resultRaw: args.resultRaw, display, report: null, reportQuality: null,
+    status: 'divined', createdAt: now,
+  };
+}
+
+// AI 链路读取（调用方需校验归属）
+export function getDivination(id: string): DivineRecord | null {
+  const d = getDb();
+  const row = d.prepare('SELECT * FROM divinations WHERE id = ?').get(id);
+  return row ? toRecord(row as any) : null;
+}
+
+// quality=ok 才调用：写报告 + status='ai_done'
+export function attachReport(id: string, report: unknown, quality: 'ok' | 'poor' = 'ok'): boolean {
+  const d = getDb();
+  const r = d.prepare('UPDATE divinations SET report_json = ?, report_quality = ?, status = ?, updated_at = ? WHERE id = ?')
+    .run(JSON.stringify(report), quality, 'ai_done', Date.now(), id);
+  return r.changes > 0;
+}
+
+// poor 时：记录 fail 日志 + status='ai_poor'（不入 report）
+export function markAiFailed(id: string | null, artId: string, kind: string, reason: string, rawOutput?: string): void {
+  const d = getDb();
+  d.prepare('INSERT INTO ai_fail_logs (art_id, kind, divine_id, raw_output, fail_reason, created_at) VALUES (?, ?, ?, ?, ?, ?)')
+    .run(artId, kind, id || null, rawOutput || null, reason, Date.now());
+  if (id) {
+    d.prepare('UPDATE divinations SET status = ?, report_quality = ?, updated_at = ? WHERE id = ?')
+      .run('ai_poor', 'poor', Date.now(), id);
+  }
+}
+
+// 占卜历史分页（时间倒序，摘要字段）
+export function listDivinations(username: string, page = 1, pageSize = 20, profileId?: string): { list: { divineId: string; artId: string; question: string | null; createdAt: number; hasReport: boolean; status: string; profileId: string }[]; total: number } {
+  const d = getDb();
+  const pageN = Math.max(1, page);
+  const size = Math.min(50, Math.max(1, pageSize));
+  const where = profileId ? 'WHERE username = ? AND profile_id = ?' : 'WHERE username = ?';
+  const params = profileId ? [username, profileId] : [username];
+  const totalRow = d.prepare('SELECT COUNT(*) AS c FROM divinations ' + where).get(...params) as any;
+  const rows = d.prepare('SELECT id, art_id, question, created_at, report_json, status, profile_id FROM divinations ' + where + ' ORDER BY created_at DESC LIMIT ? OFFSET ?')
+    .all(...params, size, (pageN - 1) * size) as any[];
+  return {
+    list: rows.map(r => ({
+      divineId: r.id,
+      artId: r.art_id,
+      question: r.question || null,
+      createdAt: r.created_at,
+      hasReport: !!r.report_json,
+      status: r.status,
+      profileId: r.profile_id || 'main',
+    })),
+    total: totalRow.c,
+  };
+}
+
+// 删除（校验归属由路由层做）
+export function deleteDivination(id: string, username: string): boolean {
+  const d = getDb();
+  const r = d.prepare('DELETE FROM divinations WHERE id = ? AND username = ?').run(id, username);
+  return r.changes > 0;
+}