npm install
cp .env.example .env    # 填写你的 API 密钥
npm run dev             # http://localhost:3000

MISTRAL_API_KEY=            # 必需 — 案件生成、审讯、评估、STT
ELEVENLABS_API_KEY=         # 必需 — 嫌疑人语音的 TTS
ELEVENLABS_VOICE_ID=        # 可选 — 特定的 ElevenLabs 语音 ID
NEXT_PUBLIC_SUPABASE_URL=   # 必需 — Supabase 项目 URL
NEXT_PUBLIC_SUPABASE_ANON_KEY=  # 必需 — Supabase 匿名密钥（RLS 保护）
SUPABASE_SERVICE_ROLE_KEY=  # 可选 — 管理员导出端点
EXPORT_SECRET=              # 可选 — 管理员导出认证

npm run dev       # 开发服务器
npm run build     # 生产构建
npm run start     # 生产服务器
npm run lint      # ESLint

分数 = 时间分数 x 难度系数 x 效率奖励 x 提示惩罚 x 指控惩罚

时间分数       = 1000 x sqrt(max(0, 1 - 已用时间 / (标准时间 x 2)))
难度系数      = 简单 1.0x, 中等 1.5x, 困难 2.0x, 专家 2.5x
效率奖励      = 1.0-1.5x（问题数少于标准 = 奖励）
提示惩罚      = 0.85^已用提示数
指控惩罚      = max(0, 1 - 错误指控次数 x 0.1)

app/
├── page.tsx                     # 标题画面
├── cases/                       # 案件选择 — 地点 + 难度
├── game/
│   ├── page.tsx                 # 主游戏编排器
│   ├── hooks/                   # useVoiceRecorder, useTTS, useGameTimer, useSfx, useSettings
│   ├── components/              # Dock, TopBar, CaseFile, SuspectZone, BriefingScreen, dialogs
│   ├── win/                     # 获胜画面 + 首字母输入
│   └── lose/                    # 失败画面
├── leaderboard/                 # 前 20 名，新条目动画
├── settings/                    # API 密钥配置、导出、偏好设置
├── help/                        # 如何游玩、计分、关于
├── about/                       # 构建者信息
└── api/
    ├── generate-case/           # GET — Mistral 案件生成
    ├── interrogate/             # POST — 玩家问题 → 嫌疑人回应
    ├── accuse/                  # POST — 指控评估（独立评判）
    ├── evaluate/                # POST — 胜/负分析
    ├── hint/                    # POST — 混淆的压力触发提示
    ├── tts/                     # POST — ElevenLabs TTS
    ├── transcribe/              # POST — Voxtral STT
    ├── leaderboard/             # GET/POST — Supabase 排行榜
    ├── patterns/                # GET/POST — 跨会话学习模式
    └── export/                  # GET — 管理员 JSONL 导出

src/lib/
├── mistral/                     # Mistral 客户端、审讯、评估、案件生成、嵌入
├── game-session.ts              # 服务端会话存储、获胜令牌、导出
├── game-state.ts                # 类型定义
├── scoring.ts                   # 分数计算 + 侦探评级
├── sanitize.ts                  # 输入验证、注入检测
├── db.ts                        # Supabase 客户端
└── rate-limit.ts                # 每 IP 速率限制

CREATE TABLE leaderboard (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  player_name text NOT NULL,
  case_number text,
  case_setting text,
  suspect_name text,
  time_remaining int,
  stress_level int,
  clues_found int,
  hints_used int,
  accusations_used int,
  detective_rating text,
  score int NOT NULL,
  created_at timestamptz DEFAULT now()
);

ALTER TABLE leaderboard ENABLE ROW LEVEL SECURITY;
CREATE POLICY "Public read" ON leaderboard FOR SELECT USING (true);
CREATE POLICY "Public insert" ON leaderboard FOR INSERT WITH CHECK (true);

CREATE TABLE game_exports (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  session_id text UNIQUE NOT NULL,
  case_data jsonb NOT NULL,
  conversation jsonb NOT NULL,
  outcome text NOT NULL,
  difficulty text NOT NULL,
  setting text,
  stats jsonb NOT NULL,
  accusation_text text,
  accusation_correct boolean,
  created_at timestamptz DEFAULT now()
);

ALTER TABLE game_exports ENABLE ROW LEVEL SECURITY;
CREATE POLICY "anon_insert" ON game_exports FOR INSERT TO anon WITH CHECK (true);
CREATE POLICY "no_public_read" ON game_exports FOR SELECT TO anon USING (false);

CREATE TABLE interrogation_patterns (
  id uuid DEFAULT gen_random_uuid() PRIMARY KEY,
  session_id text UNIQUE NOT NULL,
  setting text,
  difficulty text NOT NULL,
  outcome text NOT NULL,
  questions jsonb,
  effective_questions jsonb,
  max_stress int,
  clues_found int,
  time_elapsed int,
  embedding vector(1024),
  created_at timestamptz DEFAULT now()
);

ALTER TABLE interrogation_patterns ENABLE ROW LEVEL SECURITY;
CREATE POLICY "anon_insert" ON interrogation_patterns FOR INSERT TO anon WITH CHECK (true);
CREATE POLICY "anon_read" ON interrogation_patterns FOR SELECT TO anon USING (true);