kiku-agent 1.0.11 → 1.2.0

package/server/apiRouter.js

@@ -0,0 +1,4222 @@
+import fs from 'node:fs';
+import path from 'node:path';
+import crypto from 'node:crypto';
+import { profileData } from '../src/data/profileData.js';
+import { worksData } from '../src/data/worksData.js';
+import { discographyData } from '../src/data/discographyData.js';
+import { musicVideoData } from '../src/data/musicVideoData.js';
+import { brandsData } from '../src/data/brandsData.js';
+import { socialUpdatesData } from '../src/data/socialUpdatesData.js';
+import { galleryData } from '../src/data/galleryData.js';
+import { awardsData } from '../src/data/awardsData.js';
+import { timelineData } from '../src/data/timelineData.js';
+import { PACKAGE_VERSION } from './agent/version.js';
+import { QUIZ_CORRECT_ANSWERS } from './agent/quizData.js';
+
+function loadEnv() {
+  try {
+    const envPath = path.resolve(process.cwd(), '.env');
+    if (fs.existsSync(envPath)) {
+      const content = fs.readFileSync(envPath, 'utf8');
+      for (const line of content.split('\n')) {
+        const trimmed = line.trim();
+        if (!trimmed || trimmed.startsWith('#')) continue;
+        const eqIdx = trimmed.indexOf('=');
+        if (eqIdx > 0) {
+          const key = trimmed.slice(0, eqIdx).trim();
+          const val = trimmed.slice(eqIdx + 1).trim();
+          if (key && !(key in process.env)) {
+            process.env[key] = val;
+          }
+        }
+      }
+    }
+  } catch {}
+}
+loadEnv();
+
+const rateLimitStore = new Map();
+const RATE_LIMIT_WINDOW_MS = 60 * 1000;
+const RATE_LIMIT_ANONYMOUS = 60;
+const RATE_LIMIT_API_KEY = 1000;
+
+const rateLimitCleanupInterval = setInterval(() => {
+  const now = Date.now();
+  for (const [id, record] of rateLimitStore) {
+    if (now > record.resetTime + RATE_LIMIT_WINDOW_MS) {
+      rateLimitStore.delete(id);
+    }
+  }
+}, 60000);
+rateLimitCleanupInterval.unref?.();
+
+function getSupabaseConfig() {
+  const url = process.env.SUPABASE_URL || '';
+  const serviceKey = process.env.SUPABASE_SERVICE_ROLE_KEY || '';
+  const anonKey = process.env.SUPABASE_ANON_KEY || '';
+  const isConfigured = Boolean(url && (serviceKey || anonKey));
+  return { url, serviceKey, anonKey, isConfigured };
+}
+
+const masterApiKeys = new Set([
+  ...(process.env.KIKU_MASTER_KEYS || '').split(',').map(s => s.trim()).filter(Boolean),
+  ...(process.env.KIKU_MASTER_KEY ? [process.env.KIKU_MASTER_KEY.trim()] : []),
+]);
+
+const issuedApiKeys = new Set([
+  ...(process.env.KIKU_API_KEYS || '').split(',').map(s => s.trim()).filter(Boolean),
+  ...(process.env.KIKU_VIP_KEYS || '').split(',').map(s => s.trim()).filter(Boolean),
+  ...masterApiKeys
+]);
+const agentExecutionKeys = new Set([
+  ...(process.env.KIKU_AGENT_KEYS || '').split(',').map(s => s.trim()).filter(Boolean),
+  ...masterApiKeys,
+]);
+
+const apiKeyCache = new Map();
+const activeQuizSessions = new Map();
+const consumedQuizTokens = new Set();
+const MIN_QUIZ_DURATION_MS = 2500;
+
+const API_KEY_PEPPER = process.env.API_KEY_PEPPER || process.env.KIKU_KEY_PEPPER || crypto.randomBytes(32).toString('hex');
+const QUIZ_HMAC_SECRET = process.env.QUIZ_SECRET || process.env.KIKU_QUIZ_SECRET || crypto.randomBytes(32).toString('hex');
+
+function isMasterKey(rawKey) {
+  if (!rawKey || typeof rawKey !== 'string') return false;
+  const trimmed = rawKey.trim();
+  if (masterApiKeys.has(trimmed)) return true;
+  return false;
+}
+
+function hashApiKey(rawKey) {
+  if (!rawKey || typeof rawKey !== 'string') return '';
+  return crypto.createHmac('sha256', API_KEY_PEPPER).update(rawKey.trim()).digest('hex');
+}
+
+function hashApiKeyLegacy(rawKey) {
+  if (!rawKey || typeof rawKey !== 'string') return '';
+  return crypto.createHash('sha256').update(rawKey.trim()).digest('hex');
+}
+
+async function validateApiKey(rawKey) {
+  if (!rawKey || typeof rawKey !== 'string') return null;
+  const trimmed = rawKey.trim();
+  const hash = hashApiKey(trimmed);
+  const legacyHash = hashApiKeyLegacy(trimmed);
+
+  const cached = apiKeyCache.get(hash) || apiKeyCache.get(legacyHash);
+  if (cached && Date.now() < cached.validUntil) {
+    return cached.isActive ? { tier: cached.tier, rateLimit: cached.rateLimit } : null;
+  }
+
+  if (issuedApiKeys.has(trimmed) || isMasterKey(trimmed)) {
+    let tier = 'Developer';
+    if (isMasterKey(trimmed)) tier = 'Master VIP';
+    else if (trimmed.startsWith('kiku_vip_')) tier = 'Developer VIP';
+
+    const result = { tier, rateLimit: RATE_LIMIT_API_KEY };
+    apiKeyCache.set(hash, { ...result, isActive: true, validUntil: Date.now() + 300000 });
+    return result;
+  }
+
+  const { url: supabaseUrl, serviceKey: supabaseServiceKey, anonKey: supabaseAnonKey, isConfigured } = getSupabaseConfig();
+  if (!isConfigured) {
+    return null;
+  }
+
+  try {
+    const apiKeyHeader = supabaseServiceKey || supabaseAnonKey;
+    const controller = new AbortController();
+    const timeoutId = setTimeout(() => controller.abort(), 2500);
+
+    const res = await fetch(`${supabaseUrl}/rest/v1/api_keys?or=(key_hash.eq.${hash},key_hash.eq.${legacyHash})&is_active=eq.true&select=tier,rate_limit_per_min,expires_at`, {
+      headers: {
+        'apikey': apiKeyHeader,
+        'Authorization': `Bearer ${apiKeyHeader}`,
+        'Content-Type': 'application/json'
+      },
+      signal: controller.signal
+    });
+    clearTimeout(timeoutId);
+
+    if (res.ok) {
+      const rows = await res.json();
+      if (Array.isArray(rows) && rows.length > 0) {
+        const row = rows[0];
+        if (row.expires_at && new Date(row.expires_at).getTime() < Date.now()) {
+          apiKeyCache.set(hash, { isActive: false, validUntil: Date.now() + 60000 });
+          return null;
+        }
+        let tier = 'Developer';
+        if (row.tier === 'master_vip' || row.tier === 'Master VIP') tier = 'Master VIP';
+        else if (row.tier === 'developer_vip' || row.tier === 'Developer VIP') tier = 'Developer VIP';
+
+        const rateLimit = Number(row.rate_limit_per_min) || RATE_LIMIT_API_KEY;
+        const result = { tier, rateLimit };
+        apiKeyCache.set(hash, { ...result, isActive: true, validUntil: Date.now() + 300000 });
+        return result;
+      }
+    }
+    apiKeyCache.set(hash, { isActive: false, validUntil: Date.now() + 60000 });
+    return null;
+  } catch {
+    if (issuedApiKeys.has(trimmed) || isMasterKey(trimmed)) {
+      const tier = isMasterKey(trimmed) ? 'Master VIP' : (trimmed.startsWith('kiku_vip_') ? 'Developer VIP' : 'Developer');
+      return { tier, rateLimit: RATE_LIMIT_API_KEY };
+    }
+    return null;
+  }
+}
+
+async function saveApiKeyToSupabase({ apiKey, tier = 'developer_vip', rateLimit = 1000 }) {
+  const hash = hashApiKey(apiKey);
+  const prefix = apiKey.slice(0, 16);
+
+  issuedApiKeys.add(apiKey);
+  apiKeyCache.set(hash, {
+    tier: tier === 'developer_vip' ? 'Developer VIP' : (tier === 'master_vip' ? 'Master VIP' : 'Developer'),
+    rateLimit,
+    isActive: true,
+    validUntil: Date.now() + 300000
+  });
+
+  const { url: supabaseUrl, serviceKey: supabaseServiceKey, anonKey: supabaseAnonKey, isConfigured } = getSupabaseConfig();
+  if (!isConfigured) return;
+
+  try {
+    const apiKeyHeader = supabaseServiceKey || supabaseAnonKey;
+    await fetch(`${supabaseUrl}/rest/v1/api_keys`, {
+      method: 'POST',
+      headers: {
+        'apikey': apiKeyHeader,
+        'Authorization': `Bearer ${apiKeyHeader}`,
+        'Content-Type': 'application/json',
+        'Prefer': 'resolution=merge-duplicates'
+      },
+      body: JSON.stringify({
+        key_prefix: prefix,
+        key_hash: hash,
+        tier,
+        rate_limit_per_min: rateLimit,
+        is_active: true
+      })
+    });
+  } catch {}
+}
+
+
+function createQuizChallengeToken() {
+  const now = Date.now();
+  for (const [token, session] of activeQuizSessions) {
+    if (now > session.expiresAt || session.isClaimed) activeQuizSessions.delete(token);
+  }
+  while (activeQuizSessions.size >= 2000) {
+    activeQuizSessions.delete(activeQuizSessions.keys().next().value);
+  }
+  const expiresAt = now + (15 * 60 * 1000);
+  const nonce = crypto.randomBytes(8).toString('hex');
+  const payload = `${now}:${expiresAt}:${nonce}`;
+  const signature = crypto.createHmac('sha256', QUIZ_HMAC_SECRET).update(payload).digest('hex');
+  const token = `kiku_chal_${Buffer.from(payload).toString('base64url')}.${signature}`;
+  activeQuizSessions.set(token, { createdAt: now, expiresAt, isClaimed: false });
+  return { challengeToken: token, expiresAt: new Date(expiresAt).toISOString() };
+}
+
+function verifyQuizChallengeToken(token) {
+  if (!token || typeof token !== 'string' || !token.startsWith('kiku_chal_')) return false;
+  if (consumedQuizTokens.has(token)) return false;
+  const session = activeQuizSessions.get(token);
+  if (!session || session.isClaimed || Date.now() > session.expiresAt) return false;
+
+  const raw = token.slice('kiku_chal_'.length);
+  const dotIdx = raw.lastIndexOf('.');
+  if (dotIdx === -1) return false;
+
+  const b64Payload = raw.slice(0, dotIdx);
+  const signature = raw.slice(dotIdx + 1);
+
+  try {
+    const payload = Buffer.from(b64Payload, 'base64url').toString('utf8');
+    const expectedSig = crypto.createHmac('sha256', QUIZ_HMAC_SECRET).update(payload).digest('hex');
+    const sigBuf = Buffer.from(signature, 'hex');
+    const expBuf = Buffer.from(expectedSig, 'hex');
+    if (sigBuf.length !== expBuf.length || !crypto.timingSafeEqual(sigBuf, expBuf)) {
+      return false;
+    }
+
+    const [createdAtStr, expiresAtStr] = payload.split(':');
+    const createdAt = Number(createdAtStr);
+    const expiresAt = Number(expiresAtStr);
+    const now = Date.now();
+
+    if (isNaN(createdAt) || isNaN(expiresAt)) return false;
+    if (createdAt !== session.createdAt || expiresAt !== session.expiresAt) return false;
+    if (now > expiresAt) return false;
+    if (now - createdAt < MIN_QUIZ_DURATION_MS) return false;
+
+    return true;
+  } catch {
+    return false;
+  }
+}
+
+function consumeQuizChallengeToken(token) {
+  if (!token || typeof token !== 'string') return;
+  consumedQuizTokens.add(token);
+  const session = activeQuizSessions.get(token);
+  if (session) {
+    session.isClaimed = true;
+  }
+  activeQuizSessions.delete(token);
+  if (consumedQuizTokens.size > 5000) {
+    const oldest = consumedQuizTokens.values().next().value;
+    if (oldest) consumedQuizTokens.delete(oldest);
+  }
+}
+
+
+function verifyQuizAnswers(answers) {
+  if (!Array.isArray(answers) || answers.length < QUIZ_CORRECT_ANSWERS.length) return false;
+
+  const answeredQuestions = new Set();
+  let correctCount = 0;
+
+  for (const a of answers) {
+    const qIdx = Number(a.qIndex);
+    const aIdx = Number(a.answerIndex);
+    if (isNaN(qIdx) || isNaN(aIdx)) return false;
+    if (qIdx < 0 || qIdx >= QUIZ_CORRECT_ANSWERS.length) return false;
+    if (answeredQuestions.has(qIdx)) continue;
+    answeredQuestions.add(qIdx);
+    if (aIdx === QUIZ_CORRECT_ANSWERS[qIdx]) correctCount++;
+  }
+
+  return correctCount === QUIZ_CORRECT_ANSWERS.length;
+}
+
+
+function parseJsonBody(req, maxBytes = 65536) {
+  return new Promise((resolve) => {
+    if (req.body && typeof req.body === 'object') return resolve(req.body);
+    if (typeof req.body === 'string') {
+      try { return resolve(JSON.parse(req.body)); } catch { return resolve({}); }
+    }
+    let body = '';
+    let bytesReceived = 0;
+    req.on('data', chunk => {
+      bytesReceived += chunk.length;
+      if (bytesReceived > maxBytes) {
+        req.destroy();
+        return resolve({});
+      }
+      body += chunk;
+    });
+    req.on('end', () => {
+      try { resolve(body ? JSON.parse(body) : {}); } catch { resolve({}); }
+    });
+    req.on('error', () => resolve({}));
+  });
+}
+
+function checkRateLimit(clientIdentifier, customMax = RATE_LIMIT_ANONYMOUS) {
+  const now = Date.now();
+  let record = rateLimitStore.get(clientIdentifier);
+
+  if (!record || now > record.resetTime) {
+    record = {
+      count: 1,
+      resetTime: now + RATE_LIMIT_WINDOW_MS
+    };
+    rateLimitStore.set(clientIdentifier, record);
+    return {
+      allowed: true,
+      limit: customMax,
+      remaining: customMax - 1,
+      reset: Math.ceil(record.resetTime / 1000),
+      retryAfter: 0
+    };
+  }
+
+  record.count += 1;
+  const remaining = Math.max(0, customMax - record.count);
+  const isAllowed = record.count <= customMax;
+  const retryAfter = Math.ceil((record.resetTime - now) / 1000);
+
+  return {
+    allowed: isAllowed,
+    limit: customMax,
+    remaining,
+    reset: Math.ceil(record.resetTime / 1000),
+    retryAfter: isAllowed ? 0 : retryAfter
+  };
+}
+
+async function checkDistributedRateLimit(clientIdentifier, maxLimit = RATE_LIMIT_ANONYMOUS) {
+  const upstashUrl = process.env.UPSTASH_REDIS_REST_URL;
+  const upstashToken = process.env.UPSTASH_REDIS_REST_TOKEN;
+
+  if (upstashUrl && upstashToken) {
+    try {
+      const now = Date.now();
+      const windowKey = `ratelimit:${clientIdentifier}:${Math.floor(now / RATE_LIMIT_WINDOW_MS)}`;
+      const controller = new AbortController();
+      const timeoutId = setTimeout(() => controller.abort(), 1200);
+
+      const res = await fetch(`${upstashUrl}/pipeline`, {
+        method: 'POST',
+        headers: {
+          Authorization: `Bearer ${upstashToken}`,
+          'Content-Type': 'application/json'
+        },
+        body: JSON.stringify([
+          ['INCR', windowKey],
+          ['EXPIRE', windowKey, 120]
+        ]),
+        signal: controller.signal
+      });
+      clearTimeout(timeoutId);
+
+      if (res.ok) {
+        const results = await res.json();
+        const count = Number(results[0]?.result) || 1;
+        const remaining = Math.max(0, maxLimit - count);
+        const resetTime = Math.ceil((Math.floor(now / RATE_LIMIT_WINDOW_MS) + 1) * 60);
+        const isAllowed = count <= maxLimit;
+        return {
+          allowed: isAllowed,
+          limit: maxLimit,
+          remaining,
+          reset: resetTime,
+          retryAfter: isAllowed ? 0 : Math.max(1, resetTime - Math.floor(now / 1000)),
+          storage: 'upstash-redis'
+        };
+      }
+    } catch {
+
+    }
+  }
+
+  const inMem = checkRateLimit(clientIdentifier, maxLimit);
+  return { ...inMem, storage: 'in-memory' };
+}
+
+function escapeHtml(str) {
+  if (typeof str !== 'string') return '';
+  return str
+    .replace(/&/g, '&amp;')
+    .replace(/</g, '&lt;')
+    .replace(/>/g, '&gt;')
+    .replace(/"/g, '&quot;')
+    .replace(/'/g, '&#39;');
+}
+
+function sanitizeSearchQuery(query, maxLength = 100) {
+  if (!query || typeof query !== 'string') return '';
+  return query.trim().slice(0, maxLength);
+}
+
+function safeErrorMessage(err, fallback = 'Internal Server Error') {
+  if (process.env.NODE_ENV === 'development') {
+    return err?.message || fallback;
+  }
+  return fallback;
+}
+
+function extractApiKey(req) {
+  if (!req || !req.headers) return null;
+  const headerKey = req.headers['x-api-key'];
+  if (headerKey && typeof headerKey === 'string') return headerKey.trim();
+
+  const authHeader = req.headers['authorization'];
+  if (authHeader && typeof authHeader === 'string' && authHeader.startsWith('Bearer ')) {
+    return authHeader.slice(7).trim();
+  }
+
+  return null;
+}
+
+function extractProviderApiKey(req) {
+  const value = req?.headers?.['x-provider-api-key'];
+  return typeof value === 'string' ? value.trim().slice(0, 4096) : '';
+}
+
+function resolveClientIp(req) {
+  const directIp = req.socket?.remoteAddress || req.connection?.remoteAddress || '127.0.0.1';
+  const trustProxy = process.env.VERCEL === '1' || process.env.KIKU_TRUST_PROXY === 'true';
+  if (!trustProxy) return String(directIp);
+  const forwarded = req.headers['x-forwarded-for'];
+  return typeof forwarded === 'string' && forwarded.trim()
+    ? forwarded.split(',')[0].trim()
+    : String(directIp);
+}
+
+function applySecurityHeaders(res, isHtml = false) {
+  const allowedOrigins = (process.env.KIKU_CORS_ORIGINS || process.env.CORS_ALLOWED_ORIGINS || '').split(',').map(s => s.trim()).filter(Boolean);
+  const corsOrigin = allowedOrigins.includes('*') ? '*' : allowedOrigins[0];
+
+  if (corsOrigin) res.setHeader('Access-Control-Allow-Origin', corsOrigin);
+  res.setHeader('Access-Control-Allow-Methods', 'GET, POST, OPTIONS, HEAD');
+  res.setHeader('Access-Control-Allow-Headers', 'Content-Type, Authorization, X-Requested-With, X-API-Key, X-Provider-API-Key, Accept, sec-ch-ua, sec-ch-ua-mobile, sec-ch-ua-platform, Cache-Control');
+  res.setHeader('X-Content-Type-Options', 'nosniff');
+  res.setHeader('X-Frame-Options', 'DENY');
+  res.setHeader('Referrer-Policy', 'strict-origin-when-cross-origin');
+  res.setHeader('Strict-Transport-Security', 'max-age=63072000; includeSubDomains; preload');
+  res.setHeader('Permissions-Policy', 'camera=(), microphone=(), geolocation=()');
+
+  if (isHtml) {
+    res.setHeader(
+      'Content-Security-Policy',
+      "default-src 'self'; script-src 'self' 'unsafe-inline' https://cdn.tailwindcss.com; style-src 'self' 'unsafe-inline' https://fonts.googleapis.com; font-src 'self' https://fonts.gstatic.com data:; img-src 'self' data: https:; connect-src 'self' https://*.supabase.co https://*.upstash.io;"
+    );
+  }
+}
+
+function sendJson(res, statusCode, payload, headers = {}) {
+  res.statusCode = statusCode;
+  res.setHeader('Content-Type', 'application/json; charset=utf-8');
+  applySecurityHeaders(res, false);
+
+  for (const [key, val] of Object.entries(headers)) {
+    res.setHeader(key, val);
+  }
+
+  res.end(JSON.stringify(payload, null, 2));
+}
+
+function getCleanDiscography() {
+  const map = new Map();
+
+  const allTracks = [
+    ...(discographyData.latestReleases || []).map(track => ({ track, catalogType: 'latest' })),
+    ...(discographyData.ostList || []).map(track => ({ track, catalogType: 'ost' })),
+    ...(discographyData.singles || []).map(track => ({ track, catalogType: 'singles' }))
+  ];
+
+  for (const { track, catalogType } of allTracks) {
+    const key = track.titleCn || track.titleTh;
+    const existing = map.get(key);
+    if (existing) {
+      if (!existing.catalogTypes.includes(catalogType)) existing.catalogTypes.push(catalogType);
+      existing.isNew ||= !!track.isNew || catalogType === 'latest';
+    } else {
+      map.set(key, {
+        id: track.id,
+        titleTh: track.titleTh,
+        titleCn: track.titleCn,
+        titleEn: track.titleEn || track.titleTh || track.titleCn,
+        year: track.year,
+        work: track.work || "Solo Single",
+        duration: track.duration || track.trackDuration || "3:30",
+        youtubeId: track.youtubeId,
+        theme: track.theme || "Pop / Ballad",
+        isNew: !!track.isNew || catalogType === 'latest',
+        catalogTypes: [catalogType]
+      });
+    }
+  }
+
+  return Array.from(map.values()).sort((a, b) => b.year - a.year);
+}
+
+function getOpenApiSpec(baseUrl = "https://jujingyi-kikuuu.vercel.app") {
+  return {
+    openapi: "3.0.3",
+    info: {
+      title: "Ju Jingyi (鞠婧祎) Official Platform REST API & Kiku AI Agent",
+      version: PACKAGE_VERSION,
+      description: "Official public REST API and Kiku AI Agent platform (npm: kiku-agent) providing high-precision datasets, autonomous ReAct agent CLI, and MCP server for Ju Jingyi's filmography, discography, 4K official music videos, commercial endorsements, career milestones (2013–2026), honors & awards, social media feeds, and global fuzzy cross-search.",
+      termsOfService: `${baseUrl}/api-docs`,
+      contact: {
+        name: "Ju Jingyi Fan Platform Developer Team",
+        url: baseUrl,
+        email: "contact@jujingyi-kikuuu.vercel.app"
+      },
+      license: {
+        name: "Creative Commons Attribution-NonCommercial 4.0 International (CC BY-NC 4.0)",
+        url: "https://creativecommons.org/licenses/by-nc/4.0/"
+      }
+    },
+    servers: [
+      {
+        url: `${baseUrl}/api/v1`,
+        description: "Active Current Server (Auto-detected)"
+      },
+      {
+        url: "https://jujingyi-kikuuu.vercel.app/api/v1",
+        description: "Production Vercel Cloud Server"
+      },
+      {
+        url: "http://localhost:3000/api/v1",
+        description: "Local Node.js Development Server"
+      }
+    ],
+    tags: [
+      { name: "System", description: "API status, health checks, rate limits, and specifications" },
+      { name: "Stats", description: "Aggregated platform statistics and metric counts" },
+      { name: "Profile", description: "Artist biography, talents, physical stats, and official social accounts" },
+      { name: "Fandom", description: "Miju fan-community details, official colors, and fan history" },
+      { name: "Quotes", description: "Famous quotes, life philosophy, and mottos by Ju Jingyi" },
+      { name: "Works", description: "Filmography catalog, historical & modern dramas, movies, and character roles" },
+      { name: "Music", description: "Deduplicated discography, OSTs, studio singles, and 4K music videos" },
+      { name: "Commercial", description: "Commercial endorsements, luxury partnerships, and Global Ambassador roles" },
+      { name: "Milestones", description: "Career timeline chronology from SNH48 debut (2013) to solo era (2026)" },
+      { name: "Media", description: "Curated high-resolution photo gallery and visual archives" },
+      { name: "Honors", description: "Awards, SNH48 General Election records, and industry accolades" },
+      { name: "Social", description: "Live social feed cards from Douyin, Weibo, and Studio channels" },
+      { name: "Search", description: "Global fuzzy search engine spanning all 9 data categories" },
+      { name: "Auth", description: "Developer API keys generation for high-rate quota (1,000 req/min)" }
+    ],
+    paths: {
+      "/health": {
+        get: {
+          tags: ["System"],
+          summary: "API Health & Environment Detection",
+          description: "Returns API operational status, uptime, detected environment (Localhost vs Production), and active endpoints count.",
+          operationId: "getHealthStatus",
+          responses: {
+            "200": {
+              description: "System is operational",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/HealthResponse" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/quiz/challenge": {
+        get: {
+          tags: ["System"],
+          summary: "Request Anti-Cheat Quiz Challenge Token",
+          description: "Generates a one-time cryptographic challenge token valid for 15 minutes to secure VIP key claims.",
+          operationId: "getQuizChallengeToken",
+          responses: {
+            "200": {
+              description: "Fresh challenge token generated",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "object",
+                        properties: {
+                          challengeToken: { type: "string", example: "kiku_chal_1a2b3c4d5e6f..." },
+                          expiresAt: { type: "string", format: "date-time" },
+                          totalQuestions: { type: "integer", example: 15 }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/stats": {
+        get: {
+          tags: ["Stats"],
+          summary: "Platform & Artist Overview Statistics",
+          description: "Aggregates numerical statistics including total drama works, discography tracks, 4K MVs, brand endorsements, awards, and social followers.",
+          operationId: "getPlatformStats",
+          responses: {
+            "200": {
+              description: "Aggregated statistical overview",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/StatsResponse" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/profile": {
+        get: {
+          tags: ["Profile"],
+          summary: "Artist Profile, Talents & Social Links",
+          description: "Provides Ju Jingyi's full biographical data, multilingual names, birth date, physical attributes, musical talents, and official verified social media links.",
+          operationId: "getProfileData",
+          responses: {
+            "200": {
+              description: "Artist profile details",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/ProfileData" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/fandom": {
+        get: {
+          tags: ["Fandom"],
+          summary: "Miju Fan Community Profile",
+          description: "Returns Miju (蜜橘) fan-community data, official support colors (Sky Blue, Sakura Pink, Gold), slogan, and community history.",
+          operationId: "getFandomProfile",
+          responses: {
+            "200": {
+              description: "Fandom details",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/FandomData" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/quotes": {
+        get: {
+          tags: ["Quotes"],
+          summary: "Famous Quotes & Mottos",
+          description: "Returns iconic inspirational quotes spoken by Ju Jingyi in Chinese, English, and Thai.",
+          operationId: "getQuotes",
+          responses: {
+            "200": {
+              description: "List of inspirational quotes",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/Quote" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/character-roles": {
+        get: {
+          tags: ["Works"],
+          summary: "Iconic Drama Character Roles",
+          description: "Returns all dramatic characters portrayed by Ju Jingyi with character bios, drama associations, personalities, and iconic traits.",
+          operationId: "getCharacterRoles",
+          responses: {
+            "200": {
+              description: "List of dramatic character roles",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/CharacterRole" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/works": {
+        get: {
+          tags: ["Works"],
+          summary: "Complete Filmography & Dramas",
+          description: "Lists all 18 authentic drama and movie records with factual Thai synopses, characters, co-stars, directors, platforms, and OST links.",
+          operationId: "getWorks",
+          parameters: [
+            {
+              name: "category",
+              in: "query",
+              required: false,
+              schema: { type: "string", enum: ["historical-drama", "modern-drama", "movie"] },
+              description: "Filter by work category"
+            },
+            {
+              name: "year",
+              in: "query",
+              required: false,
+              schema: { type: "integer", example: 2024 },
+              description: "Filter by release year"
+            },
+            {
+              name: "search",
+              in: "query",
+              required: false,
+              schema: { type: "string", example: "In Blossom" },
+              description: "Search in title or character name"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Filtered list of filmography works",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/Work" }
+                      },
+                      meta: {
+                        type: "object",
+                        properties: {
+                          totalCount: { type: "integer", example: 18 },
+                          filteredCount: { type: "integer", example: 1 }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/works/{id}": {
+        get: {
+          tags: ["Works"],
+          summary: "Single Work Details",
+          description: "Retrieve comprehensive details for a specific drama or movie by ID.",
+          operationId: "getWorkById",
+          parameters: [
+            {
+              name: "id",
+              in: "path",
+              required: true,
+              schema: { type: "string", example: "in-blossom" },
+              description: "Slug ID of the drama or movie"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Work details",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: { $ref: "#/components/schemas/Work" }
+                    }
+                  }
+                }
+              }
+            },
+            "404": {
+              description: "Work not found",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/ErrorResponse" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/discography": {
+        get: {
+          tags: ["Music"],
+          summary: "Deduplicated Discography Catalog",
+          description: "Returns deduplicated catalog of verified singles, albums, and OST tracks sung by Ju Jingyi.",
+          operationId: "getDiscography",
+          parameters: [
+            {
+              name: "type",
+              in: "query",
+              required: false,
+              schema: { type: "string", enum: ["latest", "ost", "singles"] },
+              description: "Filter by release type"
+            },
+            {
+              name: "year",
+              in: "query",
+              required: false,
+              schema: { type: "integer", example: 2026 },
+              description: "Filter by release year"
+            },
+            {
+              name: "search",
+              in: "query",
+              required: false,
+              schema: { type: "string", example: "Like a Silk" },
+              description: "Search in song title or drama association"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "List of music tracks",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/DiscographyTrack" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/discography/{id}": {
+        get: {
+          tags: ["Music"],
+          summary: "Single Discography Track Details",
+          description: "Retrieve specific track details by song ID.",
+          operationId: "getDiscographyById",
+          parameters: [
+            {
+              name: "id",
+              in: "path",
+              required: true,
+              schema: { type: "string", example: "ost-in-blossom" },
+              description: "ID of the discography track"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Song details",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: { $ref: "#/components/schemas/DiscographyTrack" }
+                    }
+                  }
+                }
+              }
+            },
+            "404": {
+              description: "Track not found",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/ErrorResponse" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/mv": {
+        get: {
+          tags: ["Music"],
+          summary: "Official Music Videos & Stage Performances",
+          description: "Returns official 4K MVs, drama theme music videos, and live festival performances.",
+          operationId: "getMusicVideos",
+          parameters: [
+            {
+              name: "category",
+              in: "query",
+              required: false,
+              schema: { type: "string", enum: ["Official-MV", "OST-Music-Video", "Stage-Performance"] },
+              description: "Filter by MV category"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "List of official music videos",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/MusicVideo" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/brands": {
+        get: {
+          tags: ["Commercial"],
+          summary: "Commercial Endorsements & Brand Partnerships",
+          description: "Returns official brand spokesperson roles, luxury fashion partnerships, and beauty ambassadorships.",
+          operationId: "getBrandEndorsements",
+          parameters: [
+            {
+              name: "isGlobal",
+              in: "query",
+              required: false,
+              schema: { type: "boolean" },
+              description: "Filter for Global Brand Ambassador roles"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "List of brand endorsements",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/Brand" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/timeline": {
+        get: {
+          tags: ["Milestones"],
+          summary: "Career Milestones & Chronology (2013–2026)",
+          description: "Chronological milestone entries from SNH48 audition in 2013 to independent solo career in 2026.",
+          operationId: "getTimelineMilestones",
+          parameters: [
+            {
+              name: "era",
+              in: "query",
+              required: false,
+              schema: { type: "string", enum: ["snh48", "solo"] },
+              description: "Filter by career era"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Timeline records",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/Milestone" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/gallery": {
+        get: {
+          tags: ["Media"],
+          summary: "High-Resolution Gallery Photos",
+          description: "Curated high-resolution photography collections, red carpet visuals, and stage photos.",
+          operationId: "getGalleryPhotos",
+          parameters: [
+            {
+              name: "category",
+              in: "query",
+              required: false,
+              schema: { type: "string", enum: ["fashion", "drama", "stage", "portrait"] }
+            },
+            {
+              name: "limit",
+              in: "query",
+              required: false,
+              schema: { type: "integer", default: 12, example: 6 },
+              description: "Maximum number of photos to return"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Photo collection",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/GalleryItem" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/awards": {
+        get: {
+          tags: ["Honors"],
+          summary: "Awards, Honors & Hall of Fame Records",
+          description: "Complete list of music awards, drama honors, fashion accolades, and SNH48 Senbatsu Election championship records.",
+          operationId: "getAwardsAndHonors",
+          responses: {
+            "200": {
+              description: "Awards and honors",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/Award" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/social": {
+        get: {
+          tags: ["Social"],
+          summary: "Live Social Media Feed Cards",
+          description: "Returns structured social feed cards from Douyin, Weibo, and Studio channels.",
+          operationId: "getSocialFeeds",
+          parameters: [
+            {
+              name: "platform",
+              in: "query",
+              required: false,
+              schema: { type: "string", enum: ["douyin", "weibo"] },
+              description: "Filter by platform"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Social feed cards",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "array",
+                        items: { $ref: "#/components/schemas/SocialCard" }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/social/douyin/embed": {
+        get: {
+          tags: ["Social"],
+          summary: "Generate Douyin Official Iframe Player Embed",
+          description: "Generates HTML iframe embed code and share URLs conforming to Open Douyin IFrame Video Player specifications.",
+          operationId: "getDouyinIframeEmbed",
+          parameters: [
+            {
+              name: "itemId",
+              in: "query",
+              required: false,
+              schema: { type: "string", example: "7384920194819283921" },
+              description: "Douyin video item ID"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Douyin iframe embed response",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "object",
+                        properties: {
+                          platform: { type: "string", example: "Douyin (抖音)" },
+                          itemId: { type: "string", example: "7384920194819283921" },
+                          iframeSrc: { type: "string", example: "https://www.iesdouyin.com/share/video/7384920194819283921/" },
+                          iframeHtml: { type: "string" },
+                          shareUrl: { type: "string" }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/social/weibo/live": {
+        get: {
+          tags: ["Social"],
+          summary: "Live Sina Weibo Dynamic Feed",
+          description: "Returns live synchronized Weibo updates matching Open Weibo user_timeline and mobile feed container specifications.",
+          operationId: "getWeiboLiveFeed",
+          responses: {
+            "200": {
+              description: "Live Weibo feed records",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "object",
+                        properties: {
+                          platform: { type: "string", example: "Sina Weibo (新浪微博)" },
+                          account: { type: "string", example: "鞠婧祎 (Ju Jingyi)" },
+                          uid: { type: "string", example: "3669102477" },
+                          containerId: { type: "string", example: "1076033669102477" },
+                          status: { type: "string", example: "synced" },
+                          cards: {
+                            type: "array",
+                            items: { $ref: "#/components/schemas/SocialCard" }
+                          }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/search": {
+        get: {
+          tags: ["Search"],
+          summary: "Global Cross-Dataset Fuzzy Search",
+          description: "Performs full-text fuzzy search across works, discography, music videos, and timeline milestones.",
+          operationId: "searchGlobal",
+          parameters: [
+            {
+              name: "q",
+              in: "query",
+              required: true,
+              schema: { type: "string", example: "In Blossom" },
+              description: "Search keyword"
+            }
+          ],
+          responses: {
+            "200": {
+              description: "Search results matching query",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/SearchResponse" }
+                }
+              }
+            },
+            "400": {
+              description: "Missing required query parameter q",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/ErrorResponse" }
+                }
+              }
+            }
+          }
+        }
+      },
+      "/keys/generate": {
+        get: {
+          tags: ["Auth"],
+          summary: "Generate Developer API Key (1,000 req/min)",
+          description: "Generates a new Developer API key when called with an existing authorized key.",
+          operationId: "generateApiKey",
+          security: [{ ApiKeyHeader: [] }, { ApiKeyQuery: [] }],
+          responses: {
+            "200": {
+              description: "Newly generated API key",
+              content: {
+                "application/json": {
+                  schema: {
+                    type: "object",
+                    properties: {
+                      status: { type: "string", example: "success" },
+                      code: { type: "integer", example: 200 },
+                      data: {
+                        type: "object",
+                        properties: {
+                          apiKey: { type: "string", example: "kiku_dev_9x2b81_lz39xk" },
+                          tier: { type: "string", example: "Developer Tier (1,000 requests / minute)" },
+                          usage: { type: "string", example: "Pass via 'X-API-Key' header or '?apiKey=' query param" }
+                        }
+                      }
+                    }
+                  }
+                }
+              }
+            },
+            "401": {
+              description: "Missing or invalid API key",
+              content: {
+                "application/json": {
+                  schema: { $ref: "#/components/schemas/ErrorResponse" }
+                }
+              }
+            }
+          }
+        }
+      }
+    },
+    components: {
+      securitySchemes: {
+        ApiKeyHeader: {
+          type: "apiKey",
+          in: "header",
+          name: "X-API-Key",
+          description: "Developer API Key passed in request header"
+        },
+        ApiKeyQuery: {
+          type: "apiKey",
+          in: "query",
+          name: "apiKey",
+          description: "Developer API Key passed in query string"
+        }
+      },
+      schemas: {
+        HealthResponse: {
+          type: "object",
+          properties: {
+            status: { type: "string", example: "success" },
+            code: { type: "integer", example: 200 },
+            timestamp: { type: "string", format: "date-time" },
+            data: {
+              type: "object",
+              properties: {
+                apiName: { type: "string", example: "Ju Jingyi Official Chronicle REST API" },
+                version: { type: "string", example: `v${PACKAGE_VERSION}` },
+                status: { type: "string", example: "operational" },
+                environment: { type: "string", example: "production" },
+                isLocal: { type: "boolean", example: false },
+                currentHost: { type: "string", example: "jujingyi-kikuuu.vercel.app" },
+                uptimeSeconds: { type: "integer", example: 3600 },
+                endpointsCount: { type: "integer", example: 18 },
+                tier: { type: "string", example: "Public" },
+                baseUrl: { type: "string", example: "https://jujingyi-kikuuu.vercel.app/api/v1" },
+                documentation: { type: "string", example: "https://jujingyi-kikuuu.vercel.app/api-docs" },
+                openApiSpec: { type: "string", example: "https://jujingyi-kikuuu.vercel.app/api/v1/openapi.json" }
+              }
+            }
+          }
+        },
+        StatsResponse: {
+          type: "object",
+          properties: {
+            status: { type: "string", example: "success" },
+            code: { type: "integer", example: 200 },
+            data: {
+              type: "object",
+              properties: {
+                artist: { type: "string", example: "Ju Jingyi (鞠婧祎)" },
+                actingWorksCount: { type: "integer", example: 18 },
+                discographyTracksCount: { type: "integer", example: 45 },
+                musicVideosCount: { type: "integer", example: 18 },
+                brandEndorsementsCount: { type: "integer", example: 12 },
+                timelineMilestonesCount: { type: "integer", example: 18 },
+                awardsCount: { type: "integer", example: 12 },
+                socialFollowers: {
+                  type: "object",
+                  properties: {
+                    weibo: { type: "string", example: "31.5M+" },
+                    douyin: { type: "string", example: "24.8M+" },
+                    instagram: { type: "string", example: "3.2M+" }
+                  }
+                }
+              }
+            }
+          }
+        },
+        Work: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "in-blossom" },
+            titleTh: { type: "string", example: "บุปผารักอลวน" },
+            titleCn: { type: "string", example: "花间令" },
+            titleEn: { type: "string", example: "In Blossom" },
+            role: { type: "string", example: "หยางไฉ่เวย / ซ่างกวนจื่อ (Yang Caiwei / Shangguan Zhi)" },
+            characterCn: { type: "string", example: "杨采薇 / 上官芷" },
+            category: { type: "string", example: "historical-drama" },
+            year: { type: "integer", example: 2024 },
+            status: { type: "string", example: "ออกอากาศจบแล้ว (40 ตอน)" },
+            platform: { type: "string", example: "YOUKU" },
+            synopsisTh: { type: "string" },
+            coStars: { type: "array", items: { type: "string" } },
+            director: { type: "string", example: "จงชิง (Zhong Qing)" },
+            milestone: { type: "string", example: "ทำดัชนีความนิยม YOUKU ทะลุ 10,000 รวดเร็วที่สุดของปี 2024" },
+            themeSong: {
+              type: "object",
+              properties: {
+                titleTh: { type: "string", example: "ดั่งแพรไหม (Like a Silk)" },
+                titleCn: { type: "string", example: "《如纱》" },
+                youtubeId: { type: "string", example: "DafSXZZo9AI" }
+              }
+            }
+          }
+        },
+        DiscographyTrack: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "ost-in-blossom" },
+            titleTh: { type: "string", example: "ดั่งแพรไหม" },
+            titleCn: { type: "string", example: "如纱" },
+            titleEn: { type: "string", example: "Like a Silk" },
+            year: { type: "integer", example: 2024 },
+            work: { type: "string", example: "ซีรีส์ บุปผารักอลวน (In Blossom OST)" },
+            duration: { type: "string", example: "3:42" },
+            youtubeId: { type: "string", example: "DafSXZZo9AI" },
+            theme: { type: "string", example: "เพลงประกอบซีรีส์ (OST)" },
+            isNew: { type: "boolean", example: true },
+            catalogTypes: {
+              type: "array",
+              items: { type: "string", enum: ["latest", "ost", "singles"] },
+              example: ["latest", "ost"]
+            }
+          }
+        },
+        MusicVideo: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "mv-veil-of-shadows" },
+            titleTh: { type: "string", example: "ไม่ทรมาน (Bu Ku - Veil of Shadows OST)" },
+            titleCn: { type: "string", example: "不苦" },
+            category: { type: "string", example: "OST-Music-Video" },
+            youtubeId: { type: "string", example: "9AeErG03SZw" },
+            duration: { type: "string", example: "3:30" }
+          }
+        },
+        Brand: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "brand-lanvin" },
+            nameEn: { type: "string", example: "LANVIN Paris" },
+            nameCn: { type: "string", example: "浪凡" },
+            tier: { type: "string", example: "Global Brand Ambassador" },
+            category: { type: "string", example: "High-End Fashion & Haute Couture" },
+            isGlobal: { type: "boolean", example: true }
+          }
+        },
+        Milestone: {
+          type: "object",
+          properties: {
+            year: { type: "integer", example: 2024 },
+            title: { type: "string", example: "In Blossom Phenomenon & Independent Breakthrough" },
+            titleCn: { type: "string", example: "《花间令》全网大爆与个人独立突破" },
+            era: { type: "string", example: "solo" }
+          }
+        },
+        GalleryItem: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "gal-1" },
+            title: { type: "string", example: "Weibo Night Red Carpet Haute Couture" },
+            category: { type: "string", example: "fashion" },
+            imageUrl: { type: "string" }
+          }
+        },
+        Award: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "award-snh-1" },
+            year: { type: "integer", example: 2017 },
+            title: { type: "string", example: "SNH48 4th Senbatsu Election Champion (No. 1)" },
+            titleCn: { type: "string", example: "SNH48第四届总选举第一名 (连霸殿堂级)" },
+            category: { type: "string", example: "SNH48 Election Legend" }
+          }
+        },
+        SocialCard: {
+          type: "object",
+          properties: {
+            id: { type: "string", example: "social-douyin-1" },
+            platform: { type: "string", example: "douyin" },
+            authorName: { type: "string", example: "鞠婧祎" },
+            content: { type: "string" },
+            likes: { type: "string", example: "1.8M+" },
+            comments: { type: "string", example: "128K+" }
+          }
+        },
+        ProfileData: {
+          type: "object",
+          properties: {
+            name: {
+              type: "object",
+              properties: {
+                cn: { type: "string", example: "鞠婧祎" },
+                pinyin: { type: "string", example: "Jū Jìngyī" },
+                en: { type: "string", example: "Ju Jingyi (Kiku)" },
+                th: { type: "string", example: "จวีจิ้งอี" }
+              }
+            },
+            birthDate: { type: "string", example: "1994-06-18" },
+            birthPlace: { type: "string", example: "Suining, Sichuan, China (遂宁, 四川)" },
+            zodiac: { type: "string", example: "Gemini / Dog" },
+            height: { type: "string", example: "159 cm" }
+          }
+        },
+        FandomData: {
+          type: "object",
+          properties: {
+            fandomName: { type: "string", example: "Miju (蜜橘)" },
+            fandomNickname: { type: "string", example: "Miju (蜜橘)" },
+            slogan: { type: "string", example: "鞠躬尽瘁，为婧而生 (Devoted with respect, born for Jingyi)" },
+            officialColors: {
+              type: "array",
+              items: {
+                type: "object",
+                properties: {
+                  name: { type: "string", example: "Crystal Blue" },
+                  hex: { type: "string", example: "#58B2DC" }
+                }
+              }
+            }
+          }
+        },
+        Quote: {
+          type: "object",
+          properties: {
+            quoteCn: { type: "string", example: "无论走得多远，都不要忘记为什么出发。" },
+            quoteTh: { type: "string", example: "ไม่ว่าจะก้าวไปไกลแค่ไหน อย่าลืมว่าเราเริ่มต้นเดินทางเพราะอะไร" },
+            quoteEn: { type: "string", example: "No matter how far you go, never forget why you started." },
+            author: { type: "string", example: "鞠婧祎 (Ju Jingyi)" }
+          }
+        },
+        CharacterRole: {
+          type: "object",
+          properties: {
+            characterNameTh: { type: "string", example: "หานอวิ๋นซี (Han Yunxi)" },
+            characterNameCn: { type: "string", example: "韩芸汐" },
+            dramaTitleTh: { type: "string", example: "หยุนซี หมอพิษหญิงยอดอัจฉริยะ (Legend of Yunxi)" },
+            dramaTitleCn: { type: "string", example: "芸汐传" },
+            year: { type: "integer", example: 2018 },
+            roleDescriptionTh: { type: "string" }
+          }
+        },
+        SearchResponse: {
+          type: "object",
+          properties: {
+            status: { type: "string", example: "success" },
+            code: { type: "integer", example: 200 },
+            data: {
+              type: "object",
+              properties: {
+                works: { type: "array", items: { $ref: "#/components/schemas/Work" } },
+                discography: { type: "array", items: { $ref: "#/components/schemas/DiscographyTrack" } },
+                musicVideos: { type: "array", items: { $ref: "#/components/schemas/MusicVideo" } },
+                timeline: { type: "array", items: { $ref: "#/components/schemas/Milestone" } }
+              }
+            },
+            meta: {
+              type: "object",
+              properties: {
+                query: { type: "string", example: "In Blossom" },
+                totalMatches: { type: "integer", example: 4 }
+              }
+            }
+          }
+        },
+        ErrorResponse: {
+          type: "object",
+          properties: {
+            status: { type: "string", example: "error" },
+            code: { type: "integer", example: 404 },
+            timestamp: { type: "string", format: "date-time" },
+            message: { type: "string", example: "Resource not found" }
+          }
+        }
+      }
+    }
+  };
+}
+
+function renderApiDocsHtml() {
+  const openApi = getOpenApiSpec();
+  return `<!DOCTYPE html>
+<html lang="en" class="scroll-smooth">
+<head>
+  <meta charset="UTF-8">
+  <meta name="viewport" content="width=device-width, initial-scale=1.0">
+  <title>Ju Jingyi (鞠婧祎) API v1 Documentation & Interactive Console</title>
+  <link rel="icon" type="image/svg+xml" href="data:image/svg+xml,<svg xmlns='http://www.w3.org/2000/svg' viewBox='0 0 100 100'><text y='.9em' font-size='90'>🌸</text></svg>">
+  <link rel="preconnect" href="https://fonts.googleapis.com">
+  <link rel="preconnect" href="https://fonts.gstatic.com" crossorigin>
+  <link href="https://fonts.googleapis.com/css2?family=Google+Sans:wght@400;500;600;700;800;900&family=Noto+Sans+SC:wght@300;400;500;600;700;900&family=Ma+Shan+Zheng&display=swap" rel="stylesheet">
+  <script>
+    (function() {
+      const origWarn = console.warn;
+      console.warn = function(...args) {
+        if (typeof args[0] === 'string' && args[0].includes('cdn.tailwindcss.com')) return;
+        origWarn.apply(console, args);
+      };
+
+      try {
+        const saved = localStorage.getItem('kiku_theme') || localStorage.getItem('theme');
+        const prefersDark = window.matchMedia && window.matchMedia('(prefers-color-scheme: dark)').matches;
+        if (saved === 'dark' || (!saved && prefersDark) || !saved) {
+          document.documentElement.classList.add('dark');
+        } else {
+          document.documentElement.classList.remove('dark');
+        }
+      } catch {}
+    })();
+  </script>
+  <script src="https://cdn.tailwindcss.com"></script>
+  <script>
+    tailwind.config = {
+      darkMode: 'class',
+      theme: {
+        extend: {
+          fontFamily: {
+            sans: ["'Google Sans'", "'Product Sans'", "'Noto Sans SC'", "-apple-system", "BlinkMacSystemFont", "'Segoe UI'", "Roboto", "sans-serif"],
+            display: ["'Google Sans'", "'Product Sans'", "'Noto Sans SC'", "-apple-system", "BlinkMacSystemFont", "sans-serif"],
+            calligraphy: ["'Ma Shan Zheng'", "'Noto Serif SC'", "serif"]
+          }
+        }
+      }
+    };
+  </script>
+  <style>
+    @font-face {
+      font-family: 'Google Sans';
+      font-style: normal;
+      font-weight: 400;
+      font-display: swap;
+      src: url('/fonts/GoogleSans-Thai-400.woff2') format('woff2'),
+           url('/fonts/GoogleSans-Latin-400.woff2') format('woff2'),
+           url('/fonts/GoogleSans-Regular.woff2') format('woff2'),
+           local('Google Sans'), local('Product Sans');
+    }
+    @font-face {
+      font-family: 'Google Sans';
+      font-style: normal;
+      font-weight: 500;
+      font-display: swap;
+      src: url('/fonts/GoogleSans-Thai-500.woff2') format('woff2'),
+           url('/fonts/GoogleSans-Latin-500.woff2') format('woff2'),
+           url('/fonts/GoogleSans-Medium.ttf') format('truetype'),
+           local('Google Sans Medium'), local('Google Sans');
+    }
+    @font-face {
+      font-family: 'Google Sans';
+      font-style: normal;
+      font-weight: 600 900;
+      font-display: swap;
+      src: url('/fonts/GoogleSans-Thai-700.woff2') format('woff2'),
+           url('/fonts/GoogleSans-Latin-700.woff2') format('woff2'),
+           url('/fonts/GoogleSans-Bold.ttf') format('truetype'),
+           local('Google Sans Bold'), local('Google Sans');
+    }
+    html {
+      scroll-behavior: smooth;
+      -webkit-text-size-adjust: 100%;
+      text-rendering: optimizeLegibility;
+      -webkit-font-smoothing: antialiased;
+      -moz-osx-font-smoothing: grayscale;
+    }
+    *, *::before, *::after, html, body {
+      font-family: 'Google Sans', 'Product Sans', 'Noto Sans SC', sans-serif !important;
+      -webkit-font-smoothing: antialiased !important;
+      -moz-osx-font-smoothing: grayscale !important;
+      text-rendering: optimizeLegibility !important;
+    }
+    h1, h2, h3, h4, h5, h6 {
+      letter-spacing: -0.02em;
+    }
+    body {
+      letter-spacing: -0.01em;
+    }
+    .font-sans {
+      font-family: 'Google Sans', 'Product Sans', 'Noto Sans SC', sans-serif !important;
+    }
+    .font-display { 
+      font-family: 'Google Sans', 'Product Sans', 'Noto Sans SC', sans-serif !important; 
+    }
+    .font-calligraphy { 
+      font-family: 'Ma Shan Zheng', 'Noto Serif SC', serif !important; 
+    }
+    .font-mono, code, pre {
+      font-family: ui-monospace, SFMono-Regular, Menlo, Monaco, Consolas, "Liberation Mono", "Courier New", monospace !important;
+    }
+    .glass-card { background: rgba(255, 255, 255, 0.95); backdrop-filter: blur(16px); border: 1px solid rgba(244, 63, 94, 0.15); }
+    .glass-dark { background: rgba(255, 255, 255, 0.95); backdrop-filter: blur(20px); border: 1px solid rgba(244, 63, 94, 0.2); }
+    .dark .glass-dark { background: rgba(18, 12, 28, 0.92); backdrop-filter: blur(20px); border: 1px solid rgba(244, 63, 94, 0.25); }
+    
+    ::-webkit-scrollbar {
+      width: 8px;
+      height: 8px;
+    }
+    ::-webkit-scrollbar-track {
+      background: #f5f5f4;
+    }
+    .dark ::-webkit-scrollbar-track {
+      background: #09050d;
+    }
+    ::-webkit-scrollbar-thumb {
+      background: #cbd5e1;
+      border-radius: 9999px;
+      border: 2px solid #f5f5f4;
+    }
+    .dark ::-webkit-scrollbar-thumb {
+      background: #4c1d35;
+      border-radius: 9999px;
+      border: 2px solid #09050d;
+    }
+    ::-webkit-scrollbar-thumb:hover {
+      background: #e11d48;
+    }
+    * {
+      scrollbar-width: thin;
+      scrollbar-color: #cbd5e1 #f5f5f4;
+    }
+    .dark * {
+      scrollbar-color: #4c1d35 #09050d;
+    }
+  </style>
+</head>
+<body class="bg-[#FFFDF9] text-stone-900 dark:bg-gradient-to-br dark:from-stone-950 dark:via-[#100918] dark:to-stone-950 dark:text-stone-100 min-h-screen transition-colors duration-200">
+
+  <header class="sticky top-0 z-50 bg-white/95 dark:bg-[#0A0512]/90 backdrop-blur-2xl border-b border-rose-200 dark:border-rose-900/40 px-4 sm:px-8 py-3.5 sm:py-4.5 flex items-center justify-between gap-3 shadow-md dark:shadow-xl dark:shadow-black/40 transition-all duration-300">
+    <div class="flex items-center gap-3 sm:gap-4">
+      <a href="/" class="flex items-center gap-3 group select-none transition-transform active:scale-98 text-left">
+        <div class="w-10 h-10 sm:w-12 sm:h-12 rounded-2xl bg-gradient-to-br from-rose-500 via-pink-600 to-amber-400 p-[1.5px] shadow-lg shadow-rose-600/30 group-hover:shadow-rose-600/50 transition-all">
+          <div class="w-full h-full rounded-[14px] bg-rose-50 dark:bg-[#12091c] flex items-center justify-center font-calligraphy text-rose-700 dark:text-rose-300 font-bold text-lg sm:text-xl group-hover:scale-110 transition-transform">
+            鞠
+          </div>
+        </div>
+        <div class="flex flex-col">
+          <div class="flex items-center gap-2 leading-tight">
+            <span class="font-display font-black text-base sm:text-lg tracking-wider text-stone-900 dark:text-white group-hover:text-rose-600 dark:group-hover:text-rose-200 transition-colors">JU JINGYI</span>
+            <span class="font-calligraphy text-xs sm:text-sm font-semibold text-rose-600 dark:text-rose-400 hidden xs:inline">鞠婧祎</span>
+          </div>
+          <div class="flex items-center gap-2 mt-0.5">
+            <span class="text-[10px] sm:text-[11px] px-2 py-0.5 rounded-full bg-rose-100 dark:bg-rose-950/80 text-rose-800 dark:text-rose-300 font-mono font-bold border border-rose-200 dark:border-rose-800/60 shadow-2xs">
+              REST API v1.0
+            </span>
+            <span class="text-[11px] font-sans text-rose-600/90 dark:text-rose-400/70 hidden md:inline">Open Developer Portal</span>
+          </div>
+        </div>
+      </a>
+    </div>
+
+    <div class="flex items-center gap-2 sm:gap-3 shrink-0">
+      <button type="button" id="theme-toggle-btn" onclick="toggleTheme()" class="px-2.5 sm:px-3.5 py-2 rounded-xl sm:rounded-full bg-rose-50 hover:bg-rose-100 dark:bg-rose-950/60 dark:hover:bg-rose-900/60 border border-rose-200 dark:border-rose-800/60 text-stone-700 dark:text-rose-200 transition-all flex items-center gap-1.5 shadow-xs active:scale-95 cursor-pointer shrink-0" title="สลับโหมด มืด / สว่าง (Toggle Dark/Light Mode)">
+        <svg id="theme-icon-sun" class="w-4 h-4 text-amber-500 hidden" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"></path>
+        </svg>
+        <svg id="theme-icon-moon" class="w-4 h-4 text-rose-600 block" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"></path>
+        </svg>
+        <span id="theme-label" class="text-xs font-bold hidden sm:inline">Theme</span>
+      </button>
+
+      <div class="hidden md:inline-flex items-center gap-2 px-3.5 py-1.5 rounded-full bg-rose-50 dark:bg-rose-950/60 border border-rose-200 dark:border-rose-800/50 text-rose-800 dark:text-rose-200 text-xs font-mono shadow-inner">
+        <span class="relative flex h-2 w-2">
+          <span class="animate-ping absolute inline-flex h-full w-full rounded-full bg-emerald-400 opacity-75"></span>
+          <span class="relative inline-flex rounded-full h-2 w-2 bg-emerald-500"></span>
+        </span>
+        <span>Live Gateway</span>
+        <span class="text-stone-400 dark:text-stone-500">|</span>
+        <span class="text-rose-600 dark:text-rose-300 font-semibold">60 - 1,000 req/min</span>
+      </div>
+
+      <a href="/api/v1/openapi.json" target="_blank" class="px-3 sm:px-4 py-2 rounded-xl sm:rounded-full bg-rose-50 hover:bg-rose-100 dark:bg-rose-950/60 dark:hover:bg-rose-900/60 border border-rose-200 dark:border-rose-800/60 hover:border-rose-500 text-xs sm:text-sm font-semibold text-rose-800 dark:text-rose-200 hover:text-rose-950 dark:hover:text-white transition-all flex items-center gap-1.5 shadow-xs active:scale-95">
+        <svg class="w-4 h-4 text-rose-500 dark:text-rose-400" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M10 20l4-16m4 4l4 4-4 4M6 16l-4-4 4-4"></path>
+        </svg>
+        <span class="hidden sm:inline">OpenAPI 3.0</span>
+        <span class="sm:hidden">Spec</span>
+      </a>
+
+      <a href="/" class="px-3.5 sm:px-5 py-2 rounded-xl sm:rounded-full bg-gradient-to-r from-rose-600 to-pink-600 hover:from-rose-500 hover:to-pink-500 text-xs sm:text-sm font-bold text-white transition-all shadow-md shadow-rose-600/30 hover:shadow-rose-600/50 flex items-center gap-1.5 active:scale-95 shrink-0">
+        <svg class="w-4 h-4" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+          <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M3 12l2-2m0 0l7-7 7 7M5 10v10a1 1 0 001 1h3m10-11l2 2m-2-2v10a1 1 0 01-1 1h-3m-6 0a1 1 0 001-1v-4a1 1 0 011-1h2a1 1 0 011 1v4a1 1 0 001 1m-6 0h6"></path>
+        </svg>
+        <span class="hidden sm:inline">Back to Website</span>
+        <span class="sm:hidden">Website</span>
+      </a>
+    </div>
+  </header>
+
+  <main class="max-w-7xl mx-auto px-4 sm:px-6 lg:px-8 py-8 sm:py-12 space-y-8">
+    
+    <div class="p-6 sm:p-10 rounded-3xl bg-white dark:bg-stone-900/90 border border-rose-200 dark:border-rose-900/40 relative overflow-hidden space-y-4 shadow-xl dark:shadow-2xl">
+      <div class="absolute -right-16 -top-16 w-80 h-80 rounded-full bg-rose-500/10 dark:bg-rose-600/10 blur-3xl pointer-events-none"></div>
+      <div class="inline-flex items-center gap-2 px-3 py-1 rounded-full bg-rose-100 dark:bg-rose-950/80 border border-rose-200 dark:border-rose-800/50 text-rose-800 dark:text-rose-300 text-xs font-semibold uppercase tracking-widest">
+        <span>⚡ Public RESTful API v1.0</span>
+      </div>
+      <h1 class="text-3xl sm:text-5xl font-extrabold text-stone-900 dark:text-white tracking-tight">
+        Ju Jingyi (鞠婧祎) <span class="text-transparent bg-clip-text bg-gradient-to-r from-rose-600 via-pink-500 to-amber-500 dark:from-rose-400 dark:via-pink-300 dark:to-amber-200">Developer API</span>
+      </h1>
+      <p class="text-stone-600 dark:text-stone-300 text-sm sm:text-base max-w-3xl leading-relaxed">
+        Access comprehensive structured datasets for Chinese superstar Ju Jingyi, covering 45+ musical releases, complete drama filmography, 4K music videos, commercial endorsements, career milestones, awards, and instant fuzzy cross-domain search.
+      </p>
+      
+      <div class="grid grid-cols-2 sm:grid-cols-4 gap-3 pt-2">
+        <div class="p-3.5 rounded-2xl bg-rose-50/70 dark:bg-stone-900/70 border border-rose-200/80 dark:border-stone-800/90 text-center hover:border-rose-400 dark:hover:border-rose-800/40 transition-colors shadow-xs">
+          <div class="text-[11px] font-semibold uppercase tracking-wider text-stone-500 dark:text-stone-400">Base URL</div>
+          <div class="text-rose-700 dark:text-rose-300 text-xs sm:text-sm font-bold truncate mt-1">/api/v1</div>
+        </div>
+        <div class="p-3.5 rounded-2xl bg-rose-50/70 dark:bg-stone-900/70 border border-rose-200/80 dark:border-stone-800/90 text-center hover:border-rose-400 dark:hover:border-rose-800/40 transition-colors shadow-xs">
+          <div class="text-[11px] font-semibold uppercase tracking-wider text-stone-500 dark:text-stone-400">Rate Limit Tier</div>
+          <div class="text-rose-700 dark:text-rose-300 text-xs sm:text-sm font-bold mt-1">60 - 1,000 req/min</div>
+        </div>
+        <div class="p-3.5 rounded-2xl bg-rose-50/70 dark:bg-stone-900/70 border border-rose-200/80 dark:border-stone-800/90 text-center hover:border-rose-400 dark:hover:border-rose-800/40 transition-colors shadow-xs">
+          <div class="text-[11px] font-semibold uppercase tracking-wider text-stone-500 dark:text-stone-400">Response Format</div>
+          <div class="text-rose-700 dark:text-rose-300 text-xs sm:text-sm font-bold mt-1">JSON (UTF-8)</div>
+        </div>
+        <div class="p-3.5 rounded-2xl bg-rose-50/70 dark:bg-stone-900/70 border border-rose-200/80 dark:border-stone-800/90 text-center hover:border-emerald-400 dark:hover:border-emerald-800/40 transition-colors shadow-xs">
+          <div class="text-[11px] font-semibold uppercase tracking-wider text-stone-500 dark:text-stone-400">CORS Support</div>
+          <div class="text-emerald-600 dark:text-emerald-400 text-xs sm:text-sm font-bold mt-1">Enabled (*)</div>
+        </div>
+      </div>
+    </div>
+
+    <div class="space-y-4 pt-1">
+      <div class="flex flex-col sm:flex-row sm:items-center justify-between gap-2">
+        <div class="flex items-center gap-2.5">
+          <div class="w-8 h-8 rounded-xl bg-gradient-to-br from-amber-500/20 to-rose-500/20 border border-amber-500/30 flex items-center justify-center text-amber-600 dark:text-amber-300 font-bold text-sm">
+            ⚡
+          </div>
+          <div>
+            <h2 class="text-xl sm:text-2xl font-bold text-stone-900 dark:text-white tracking-tight">API Access Tiers</h2>
+            <p class="text-xs text-stone-500 dark:text-stone-400">Choose the access level that fits your application requirements</p>
+          </div>
+        </div>
+        <div id="active-tier-badge" class="self-start sm:self-auto inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-emerald-100 dark:bg-emerald-950/80 border border-emerald-300 dark:border-emerald-800/60 text-emerald-800 dark:text-emerald-300 text-xs font-semibold">
+          <span class="w-2 h-2 rounded-full bg-emerald-500 dark:bg-emerald-400 animate-pulse"></span>
+          <span id="tier-badge-label">Public Tier Active (60 req/min)</span>
+        </div>
+      </div>
+
+      <div class="grid grid-cols-1 md:grid-cols-2 gap-4">
+        <div class="p-6 rounded-3xl bg-white dark:bg-stone-900/60 border border-rose-200/80 dark:border-stone-800/80 relative overflow-hidden flex flex-col justify-between space-y-4 hover:border-rose-400 dark:hover:border-stone-700 transition-all shadow-md">
+          <div class="space-y-3">
+            <div class="flex items-center justify-between">
+              <span class="px-3 py-1 rounded-full bg-stone-100 dark:bg-stone-800 text-stone-800 dark:text-stone-300 font-bold text-xs">Public Tier (Free)</span>
+              <span class="font-mono text-stone-500 dark:text-stone-400 text-xs">Default Tier</span>
+            </div>
+            <h3 class="text-2xl font-black text-stone-900 dark:text-white">60 <span class="text-xs font-normal text-stone-500 dark:text-stone-400 font-sans">requests / minute</span></h3>
+            <p class="text-xs text-stone-600 dark:text-stone-300 leading-relaxed">
+              Open public access for fan websites, hobby projects, and exploration. No authentication key or registration required.
+            </p>
+            <ul class="space-y-2 text-xs text-stone-700 dark:text-stone-300">
+              <li class="flex items-center gap-2 text-emerald-600 dark:text-emerald-400">✓ <span class="text-stone-700 dark:text-stone-300">No API Key required</span></li>
+              <li class="flex items-center gap-2 text-emerald-600 dark:text-emerald-400">✓ <span class="text-stone-700 dark:text-stone-300">Full access to all 18+ REST endpoints</span></li>
+              <li class="flex items-center gap-2 text-emerald-600 dark:text-emerald-400">✓ <span class="text-stone-700 dark:text-stone-300">CORS Enabled for browser and frontend apps</span></li>
+              <li class="flex items-center gap-2 text-emerald-600 dark:text-emerald-400">✓ <span class="text-stone-700 dark:text-stone-300">Instant JSON responses</span></li>
+            </ul>
+          </div>
+          <div class="pt-2">
+            <div class="p-2.5 rounded-xl bg-stone-50 dark:bg-stone-950/60 border border-stone-200 dark:border-stone-800/60 text-center text-xs text-emerald-700 dark:text-emerald-400 font-semibold">
+              🟢 Active & Ready to use out of the box
+            </div>
+          </div>
+        </div>
+
+        <div class="p-6 rounded-3xl bg-gradient-to-br from-rose-50/90 via-amber-50/40 to-white dark:from-stone-900/90 dark:via-rose-950/40 dark:to-amber-950/20 border-2 border-rose-400 dark:border-rose-500/40 relative overflow-hidden flex flex-col justify-between space-y-4 shadow-xl hover:border-rose-500 dark:hover:border-rose-400/60 transition-all">
+          <div class="absolute -right-10 -top-10 w-40 h-40 bg-rose-500/10 rounded-full blur-2xl pointer-events-none"></div>
+          <div class="space-y-3 relative z-10">
+            <div class="flex items-center justify-between">
+              <span class="px-3 py-1 rounded-full bg-gradient-to-r from-rose-600 to-amber-500 text-white font-bold text-xs shadow-xs flex items-center gap-1">
+                👑 Developer VIP Tier
+              </span>
+              <span class="font-mono text-amber-600 dark:text-amber-300 text-xs font-bold">16x Quota</span>
+            </div>
+            <h3 class="text-2xl font-black text-transparent bg-clip-text bg-gradient-to-r from-rose-600 via-pink-600 to-amber-600 dark:from-rose-300 dark:via-pink-200 dark:to-amber-200">
+              1,000 <span class="text-xs font-normal text-stone-500 dark:text-stone-400 font-sans">requests / minute</span>
+            </h3>
+            <p class="text-xs text-stone-600 dark:text-stone-300 leading-relaxed">
+              Dedicated high-throughput quota for production bots, research crawlers, AI subagents, and heavy client applications.
+            </p>
+            <ul class="space-y-2 text-xs text-stone-700 dark:text-stone-300">
+              <li class="flex items-center gap-2 text-amber-600 dark:text-amber-300">★ <span class="text-stone-700 dark:text-stone-300">1,000 requests/minute high rate limit</span></li>
+              <li class="flex items-center gap-2 text-amber-600 dark:text-amber-300">★ <span class="text-stone-700 dark:text-stone-300">Exclusive <code>X-API-Key</code> authorization</span></li>
+              <li class="flex items-center gap-2 text-amber-600 dark:text-amber-300">★ <span class="text-stone-700 dark:text-stone-300">Permanent VIP key generation</span></li>
+              <li class="flex items-center gap-2 text-amber-600 dark:text-amber-300">★ <span class="text-stone-700 dark:text-stone-300">Unlocked by passing Ju Jingyi Fan Quiz (15/15)</span></li>
+            </ul>
+          </div>
+
+          <div class="pt-2 relative z-10 space-y-2" id="vip-action-container">
+            <button type="button" id="start-quiz-btn" onclick="openQuizModal()" class="w-full py-3 px-4 rounded-xl bg-gradient-to-r from-rose-600 via-pink-600 to-amber-500 hover:from-rose-500 hover:to-amber-400 font-bold text-sm text-white shadow-lg shadow-rose-600/30 active:scale-98 transition-all flex items-center justify-center gap-2 cursor-pointer group">
+              <span class="group-hover:rotate-12 transition-transform">🌸</span>
+              <span>Take Ju Jingyi Quiz & Unlock VIP Key (15 Questions)</span>
+            </button>
+            <div id="vip-key-display" class="hidden p-3 rounded-xl bg-rose-50 dark:bg-stone-950/90 border border-rose-300 dark:border-rose-800/60 flex items-center justify-between gap-2 shadow-inner">
+              <div class="truncate">
+                <span class="text-[10px] text-stone-500 dark:text-stone-400 block font-mono">YOUR DEVELOPER VIP KEY:</span>
+                <span id="vip-key-val" class="font-mono text-xs text-rose-700 dark:text-rose-300 font-bold truncate"></span>
+              </div>
+              <div class="flex items-center gap-1.5 shrink-0">
+                <button type="button" onclick="copyVipKey()" class="px-2.5 py-1.5 rounded-lg bg-rose-600 hover:bg-rose-500 dark:bg-rose-900/60 dark:hover:bg-rose-800 text-xs font-bold text-white dark:text-rose-200 transition-colors cursor-pointer">
+                  Copy
+                </button>
+                <button type="button" onclick="openQuizModal()" class="px-2.5 py-1.5 rounded-lg bg-stone-200 hover:bg-stone-300 dark:bg-stone-800 dark:hover:bg-stone-700 text-xs text-stone-700 dark:text-stone-300 transition-colors cursor-pointer" title="Retake Quiz">
+                  Retake
+                </button>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <!-- Kiku Agent & MCP Ecosystem Showcase -->
+    <div class="p-6 sm:p-8 rounded-3xl bg-gradient-to-br from-rose-50/90 via-white to-pink-50/60 dark:from-stone-900/90 dark:via-[#130b1c] dark:to-stone-900/90 border-2 border-rose-300/80 dark:border-rose-900/60 relative overflow-hidden shadow-xl space-y-6">
+      <div class="absolute -right-20 -bottom-20 w-72 h-72 rounded-full bg-rose-500/10 dark:bg-rose-500/15 blur-3xl pointer-events-none"></div>
+
+      <div class="flex flex-col md:flex-row md:items-center justify-between gap-4 relative z-10">
+        <div class="flex items-start sm:items-center gap-3.5">
+          <div class="w-12 h-12 rounded-2xl bg-gradient-to-br from-rose-500 via-pink-600 to-amber-400 p-0.5 shadow-lg shadow-rose-600/30 flex items-center justify-center shrink-0">
+            <div class="w-full h-full rounded-[14px] bg-rose-50 dark:bg-[#12091c] flex items-center justify-center text-xl">
+              🌸
+            </div>
+          </div>
+          <div>
+            <div class="flex items-center gap-2 flex-wrap">
+              <span class="text-xs px-2.5 py-0.5 rounded-full bg-rose-100 dark:bg-rose-950 text-rose-800 dark:text-rose-300 font-mono font-bold border border-rose-200 dark:border-rose-800/60">
+                npm package: kiku-agent
+              </span>
+              <span class="text-[11px] px-2 py-0.5 rounded-full bg-emerald-100 dark:bg-emerald-950/80 text-emerald-800 dark:text-emerald-300 font-mono font-bold border border-emerald-200 dark:border-emerald-800/60">
+                v1.1.0 Ready
+              </span>
+              <span class="text-[11px] px-2 py-0.5 rounded-full bg-purple-100 dark:bg-purple-950/80 text-purple-800 dark:text-purple-300 font-mono font-bold border border-purple-200 dark:border-purple-800/60">
+                MCP Protocol
+              </span>
+            </div>
+            <h2 class="text-2xl sm:text-3xl font-extrabold text-stone-900 dark:text-white tracking-tight mt-1">
+              Kiku AI Agent CLI & MCP Server
+            </h2>
+            <p class="text-xs sm:text-sm text-stone-600 dark:text-stone-300 mt-1 max-w-3xl">
+              Need an autonomous AI assistant or want to connect Ju Jingyi's knowledge base to Cursor, Claude Desktop, or VS Code? Use the official <strong>kiku-agent</strong> CLI & <strong>kiku-mcp</strong> server with 45 validated tools, local LM Studio (<code class="font-mono text-xs">google/gemma-4-e4b</code>) or cloud LLMs, and multi-agent debate.
+            </p>
+          </div>
+        </div>
+
+        <div class="flex items-center gap-2 flex-wrap shrink-0">
+          <a href="https://www.npmjs.com/package/kiku-agent" target="_blank" rel="noopener noreferrer" class="px-4 py-2 rounded-xl bg-rose-600 hover:bg-rose-500 text-white font-bold text-xs shadow-md shadow-rose-600/30 flex items-center gap-1.5 transition-all active:scale-95">
+            <svg class="w-4 h-4" viewBox="0 0 24 24" fill="currentColor"><path d="M1.763 0C.786 0 0 .786 0 1.763v20.474C0 23.214.786 24 1.763 24h20.474c.981 0 1.763-.786 1.763-1.763V1.763C24 .786 23.214 0 22.237 0zM5.13 5.323l13.837.019-.009 13.836h-3.464l.01-10.382h-3.456L12.04 19.17H5.113z"/></svg>
+            <span>View on npm</span>
+          </a>
+          <a href="/chat" class="px-4 py-2 rounded-xl bg-stone-100 hover:bg-stone-200 dark:bg-stone-800 dark:hover:bg-stone-700 text-stone-800 dark:text-stone-100 font-bold text-xs border border-stone-300 dark:border-stone-700 flex items-center gap-1.5 transition-all active:scale-95">
+            <span>💬 Web Chat</span>
+          </a>
+          <a href="https://github.com/ThemeHackers/jujingyi_kikuuu" target="_blank" rel="noopener noreferrer" class="px-4 py-2 rounded-xl bg-stone-100 hover:bg-stone-200 dark:bg-stone-800 dark:hover:bg-stone-700 text-stone-800 dark:text-stone-100 font-bold text-xs border border-stone-300 dark:border-stone-700 flex items-center gap-1.5 transition-all active:scale-95">
+            <span>GitHub</span>
+          </a>
+        </div>
+      </div>
+
+      <div class="grid grid-cols-1 lg:grid-cols-2 gap-4 pt-2 relative z-10">
+        <!-- Agent CLI Card -->
+        <div class="p-5 rounded-2xl bg-white/90 dark:bg-stone-950/70 border border-rose-200/80 dark:border-stone-800/80 flex flex-col justify-between space-y-4 shadow-sm">
+          <div class="space-y-3">
+            <div class="flex items-center justify-between">
+              <div class="flex items-center gap-2">
+                <span class="w-2.5 h-2.5 rounded-full bg-rose-500 animate-pulse"></span>
+                <h3 class="font-bold text-stone-900 dark:text-white text-base">Terminal AI Agent (CLI)</h3>
+              </div>
+              <span class="font-mono text-xs px-2 py-0.5 rounded bg-rose-50 dark:bg-rose-950 text-rose-700 dark:text-rose-300 border border-rose-200 dark:border-rose-800/60 font-semibold">45 Tools</span>
+            </div>
+            <p class="text-xs text-stone-600 dark:text-stone-300 leading-relaxed">
+              Autonomous ReAct agent with dynamic multiline input, live thinking reasoning streams, local/cloud LLM switching, background research jobs, YouTube music streaming, and multi-agent debate.
+            </p>
+
+            <div class="space-y-2 pt-1 font-mono text-xs">
+              <div class="space-y-1">
+                <div class="text-[11px] text-stone-500 dark:text-stone-400 font-sans font-semibold">1. Install Globally or Run Zero-Install:</div>
+                <div class="flex items-center justify-between bg-stone-900 text-rose-200 p-2.5 rounded-xl border border-stone-800 shadow-inner">
+                  <code class="truncate">npm install -g kiku-agent</code>
+                  <button type="button" onclick="copySnippet('npm install -g kiku-agent', this)" class="text-[11px] px-2 py-0.5 rounded bg-rose-800/80 hover:bg-rose-700 text-white cursor-pointer ml-2 shrink-0">Copy</button>
+                </div>
+              </div>
+
+              <div class="space-y-1">
+                <div class="text-[11px] text-stone-500 dark:text-stone-400 font-sans font-semibold">2. Start Interactive Session:</div>
+                <div class="flex items-center justify-between bg-stone-900 text-rose-200 p-2.5 rounded-xl border border-stone-800 shadow-inner">
+                  <code class="truncate">kiku-agent</code>
+                  <button type="button" onclick="copySnippet('kiku-agent', this)" class="text-[11px] px-2 py-0.5 rounded bg-rose-800/80 hover:bg-rose-700 text-white cursor-pointer ml-2 shrink-0">Copy</button>
+                </div>
+              </div>
+
+              <div class="space-y-1">
+                <div class="text-[11px] text-stone-500 dark:text-stone-400 font-sans font-semibold">3. One-Shot Question Query (npx):</div>
+                <div class="flex items-center justify-between bg-stone-900 text-rose-200 p-2.5 rounded-xl border border-stone-800 shadow-inner">
+                  <code class="truncate text-[11px]">npx kiku-agent --query "Ju Jingyi filmography"</code>
+                  <button type="button" onclick="copySnippet('npx kiku-agent --query \\\"Ju Jingyi filmography\\\"', this)" class="text-[11px] px-2 py-0.5 rounded bg-rose-800/80 hover:bg-rose-700 text-white cursor-pointer ml-2 shrink-0">Copy</button>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+
+        <!-- MCP Server Card -->
+        <div class="p-5 rounded-2xl bg-white/90 dark:bg-stone-950/70 border border-purple-200/80 dark:border-purple-900/40 flex flex-col justify-between space-y-4 shadow-sm">
+          <div class="space-y-3">
+            <div class="flex items-center justify-between">
+              <div class="flex items-center gap-2">
+                <span class="w-2.5 h-2.5 rounded-full bg-purple-500 animate-pulse"></span>
+                <h3 class="font-bold text-stone-900 dark:text-white text-base">Model Context Protocol (MCP)</h3>
+              </div>
+              <span class="font-mono text-xs px-2 py-0.5 rounded bg-purple-50 dark:bg-purple-950 text-purple-700 dark:text-purple-300 border border-purple-200 dark:border-purple-800/60 font-semibold">43 MCP Tools</span>
+            </div>
+            <p class="text-xs text-stone-600 dark:text-stone-300 leading-relaxed">
+              Connect Cursor, Claude Desktop, VS Code, or Antigravity directly to Ju Jingyi's full knowledge base using stdio or Streamable HTTP.
+            </p>
+
+            <div class="space-y-2 pt-1 font-mono text-xs">
+              <div class="space-y-1">
+                <div class="text-[11px] text-stone-500 dark:text-stone-400 font-sans font-semibold">Launch stdio MCP server:</div>
+                <div class="flex items-center justify-between bg-stone-900 text-purple-200 p-2.5 rounded-xl border border-stone-800 shadow-inner">
+                  <code class="truncate">kiku-mcp</code>
+                  <button type="button" onclick="copySnippet('kiku-mcp', this)" class="text-[11px] px-2 py-0.5 rounded bg-purple-800/80 hover:bg-purple-700 text-white cursor-pointer ml-2 shrink-0">Copy</button>
+                </div>
+              </div>
+
+              <div class="space-y-1">
+                <div class="text-[11px] text-stone-500 dark:text-stone-400 font-sans font-semibold">Remote HTTP MCP Endpoint:</div>
+                <div class="flex items-center justify-between bg-stone-900 text-purple-200 p-2.5 rounded-xl border border-stone-800 shadow-inner">
+                  <code class="truncate text-[11px]">POST https://jujingyi-kikuuu.vercel.app/mcp</code>
+                  <button type="button" onclick="copySnippet('https://jujingyi-kikuuu.vercel.app/mcp', this)" class="text-[11px] px-2 py-0.5 rounded bg-purple-800/80 hover:bg-purple-700 text-white cursor-pointer ml-2 shrink-0">Copy</button>
+                </div>
+              </div>
+
+              <div class="space-y-1">
+                <div class="text-[11px] text-stone-500 dark:text-stone-400 font-sans font-semibold">Claude Desktop / Cursor config JSON:</div>
+                <div class="bg-stone-900 text-stone-300 p-2.5 rounded-xl border border-stone-800 shadow-inner relative group">
+                  <pre class="text-[10px] leading-relaxed overflow-x-auto"><code>{
+  "mcpServers": {
+    "kiku": {
+      "command": "npx",
+      "args": ["-y", "kiku-agent", "kiku-mcp"]
+    }
+  }
+}</code></pre>
+                  <button type="button" onclick="copySnippet('{\\n  \\\"mcpServers\\\": {\\n    \\\"kiku\\\": {\\n      \\\"command\\\": \\\"npx\\\",\\n      \\\"args\\\": [\\\"-y\\\", \\\"kiku-agent\\\", \\\"kiku-mcp\\\"]\\n    }\\n  }\\n}', this)" class="absolute top-2 right-2 text-[10px] px-2 py-0.5 rounded bg-purple-800/80 hover:bg-purple-700 text-white cursor-pointer">Copy</button>
+                </div>
+              </div>
+            </div>
+          </div>
+        </div>
+      </div>
+    </div>
+
+    <div class="space-y-5">
+      <div class="flex flex-col sm:flex-row sm:items-center justify-between gap-3 p-4 sm:p-5 rounded-2xl bg-white dark:bg-stone-900/40 border border-rose-200 dark:border-stone-800/80 backdrop-blur-md shadow-md dark:shadow-lg">
+        <div class="flex items-center gap-3">
+          <div class="w-10 h-10 rounded-xl bg-gradient-to-br from-rose-500/20 to-pink-500/20 border border-rose-300 dark:border-rose-500/30 flex items-center justify-center text-rose-600 dark:text-rose-400 shrink-0">
+            <svg class="w-5 h-5" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M8 9l3 3-3 3m5 0h3M5 20h14a2 2 0 002-2V6a2 2 0 00-2-2H5a2 2 0 00-2 2v12a2 2 0 002 2z"></path>
+            </svg>
+          </div>
+          <div>
+            <div class="flex items-center gap-2.5 flex-wrap">
+              <h2 class="text-xl sm:text-2xl font-bold text-stone-900 dark:text-white tracking-tight">Available Endpoints</h2>
+              <span class="inline-flex items-center gap-1.5 px-2.5 py-0.5 rounded-full bg-rose-100 dark:bg-rose-950/90 text-rose-800 dark:text-rose-300 border border-rose-200 dark:border-rose-800/60 font-mono text-xs font-bold shadow-xs">
+                <span class="w-1.5 h-1.5 rounded-full bg-rose-500"></span>
+                18 Routes
+              </span>
+              <span class="hidden md:inline-flex text-[11px] px-2.5 py-0.5 rounded-full bg-emerald-100 dark:bg-emerald-950/70 text-emerald-800 dark:text-emerald-300 border border-emerald-300 dark:border-emerald-800/50 font-mono font-medium">
+                9 Data Domains
+              </span>
+            </div>
+            <p class="text-xs text-stone-500 dark:text-stone-400 mt-0.5">Explore schema definitions, request parameters, and live in-browser testing</p>
+          </div>
+        </div>
+
+        <div class="flex items-center gap-2 self-start sm:self-center">
+          <button type="button" onclick="toggleAllEndpoints()" class="inline-flex items-center gap-1.5 px-3.5 py-2 rounded-xl bg-stone-100 hover:bg-stone-200 dark:bg-gradient-to-r dark:from-stone-900 dark:via-rose-950/40 dark:to-stone-900 dark:hover:from-rose-950/80 dark:hover:to-rose-900/40 border border-stone-300 dark:border-stone-700/80 dark:hover:border-rose-500/50 text-stone-800 dark:text-stone-200 dark:hover:text-white text-xs font-semibold shadow-xs dark:shadow-md transition-all cursor-pointer active:scale-95 group">
+            <svg class="w-3.5 h-3.5 text-amber-500 dark:text-amber-400 group-hover:rotate-12 transition-transform" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+              <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M13 10V3L4 14h7v7l9-11h-7z"></path>
+            </svg>
+            <span id="toggle-all-text">⚡ Click to Test Live (Expand All)</span>
+          </button>
+        </div>
+      </div>
+
+      <div class="space-y-4" id="endpoint-list"></div>
+    </div>
+
+    <div id="quiz-modal" class="fixed inset-0 z-50 bg-black/75 dark:bg-black/85 backdrop-blur-md hidden items-center justify-center p-3 sm:p-4">
+      <div class="max-w-2xl w-full rounded-3xl bg-white dark:bg-stone-950 border border-rose-200 dark:border-rose-800/50 shadow-2xl overflow-hidden flex flex-col max-h-[92vh] animate-fadeIn">
+        <div class="p-4 sm:p-5 bg-gradient-to-r from-rose-100 via-white to-amber-50 dark:from-rose-950/80 dark:via-stone-950 dark:to-amber-950/60 border-b border-rose-200 dark:border-rose-900/40 flex flex-col sm:flex-row sm:items-center justify-between gap-3">
+          <div class="flex items-center gap-3">
+            <div class="w-10 h-10 rounded-2xl bg-gradient-to-br from-rose-500 to-amber-500 p-0.5 shadow-md flex items-center justify-center shrink-0">
+              <div class="w-full h-full rounded-[14px] bg-rose-50 dark:bg-stone-950 flex items-center justify-center font-calligraphy text-rose-700 dark:text-rose-300 font-bold text-lg">
+                鞠
+              </div>
+            </div>
+            <div>
+              <h3 id="quiz-modal-title" class="text-base sm:text-lg font-bold text-stone-900 dark:text-white leading-tight">Ju Jingyi Miju Trivia Challenge 🌸</h3>
+              <p id="quiz-modal-subtitle" class="text-xs text-rose-800 dark:text-rose-300/80">Answer all 15 questions correctly to claim your Developer VIP Key (1,000 req/min)</p>
+            </div>
+          </div>
+          
+          <div class="flex items-center justify-between sm:justify-end gap-2 shrink-0">
+            <div class="flex items-center gap-1 p-1 rounded-xl bg-stone-100 dark:bg-stone-900/90 border border-stone-200 dark:border-stone-800 shadow-inner">
+              <button type="button" onclick="setQuizLang('th')" id="lang-btn-th" class="px-2 sm:px-2.5 py-1 rounded-lg text-xs font-bold transition-all bg-rose-600 text-white shadow-xs">🇹🇭 TH</button>
+              <button type="button" onclick="setQuizLang('en')" id="lang-btn-en" class="px-2 sm:px-2.5 py-1 rounded-lg text-xs font-bold transition-all text-stone-600 dark:text-stone-400 hover:text-stone-900 dark:hover:text-white">🇬🇧 EN</button>
+              <button type="button" onclick="setQuizLang('zh')" id="lang-btn-zh" class="px-2 sm:px-2.5 py-1 rounded-lg text-xs font-bold transition-all text-stone-600 dark:text-stone-400 hover:text-stone-900 dark:hover:text-white">🇨🇳 中文</button>
+            </div>
+
+            <button type="button" onclick="toggleTheme()" class="w-8 h-8 rounded-full bg-stone-100 hover:bg-rose-100 dark:bg-stone-900 dark:hover:bg-rose-950 border border-stone-200 dark:border-stone-700 text-stone-700 dark:text-rose-200 flex items-center justify-center transition-colors shrink-0 cursor-pointer shadow-2xs" title="Toggle Theme">
+              <svg id="modal-theme-icon-sun" class="w-4 h-4 text-amber-500 hidden" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M12 3v1m0 16v1m9-9h-1M4 12H3m15.364 6.364l-.707-.707M6.343 6.343l-.707-.707m12.728 0l-.707.707M6.343 17.657l-.707.707M16 12a4 4 0 11-8 0 4 4 0 018 0z"></path>
+              </svg>
+              <svg id="modal-theme-icon-moon" class="w-4 h-4 text-rose-600 block" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M20.354 15.354A9 9 0 018.646 3.646 9.003 9.003 0 0012 21a9.003 9.003 0 008.354-5.646z"></path>
+              </svg>
+            </button>
+
+            <button type="button" onclick="closeQuizModal()" class="w-8 h-8 rounded-full bg-stone-100 hover:bg-rose-100 dark:bg-stone-900 dark:hover:bg-rose-950 border border-stone-200 dark:border-stone-700 text-stone-600 hover:text-stone-900 dark:text-stone-400 dark:hover:text-white flex items-center justify-center transition-colors shrink-0 cursor-pointer" aria-label="Close Quiz">
+              ✕
+            </button>
+          </div>
+        </div>
+
+        <div class="w-full bg-stone-200 dark:bg-stone-900 h-1.5 overflow-hidden">
+          <div id="quiz-progress-bar" class="bg-gradient-to-r from-rose-500 via-pink-500 to-amber-400 h-full transition-all duration-300" style="width: 6.66%;"></div>
+        </div>
+
+        <div class="p-5 sm:p-7 overflow-y-auto space-y-6 flex-1" id="quiz-content">
+        </div>
+      </div>
+    </div>
+
+    <div id="toast-container" class="fixed bottom-5 right-5 z-50 flex flex-col gap-3 pointer-events-none max-w-sm sm:max-w-md w-full px-4"></div>
+
+  <script>
+    function toggleTheme() {
+      const isDark = document.documentElement.classList.toggle('dark');
+      localStorage.setItem('kiku_theme', isDark ? 'dark' : 'light');
+      localStorage.setItem('theme', isDark ? 'dark' : 'light');
+      updateThemeIcons();
+    }
+
+    function updateThemeIcons() {
+      const isDark = document.documentElement.classList.contains('dark');
+      const sun = document.getElementById('theme-icon-sun');
+      const moon = document.getElementById('theme-icon-moon');
+      const modalSun = document.getElementById('modal-theme-icon-sun');
+      const modalMoon = document.getElementById('modal-theme-icon-moon');
+      const label = document.getElementById('theme-label');
+      if (sun && moon) {
+        if (isDark) {
+          sun.classList.remove('hidden');
+          moon.classList.add('hidden');
+          if (label) label.innerText = 'Dark';
+        } else {
+          sun.classList.add('hidden');
+          moon.classList.remove('hidden');
+          if (label) label.innerText = 'Light';
+        }
+      }
+      if (modalSun && modalMoon) {
+        if (isDark) {
+          modalSun.classList.remove('hidden');
+          modalMoon.classList.add('hidden');
+        } else {
+          modalSun.classList.add('hidden');
+          modalMoon.classList.remove('hidden');
+        }
+      }
+    }
+
+    let allExpanded = false;
+    let currentVipKey = '';
+    try { localStorage.removeItem('kiku_vip_key'); } catch {}
+    let quizLang = 'th';
+
+    const quizI18n = {
+      th: {
+        title: "Ju Jingyi Miju Trivia Challenge 🌸",
+        subtitle: "ตอบคำถามแฟนพันธุ์แท้จวีจิ้งอี 15 ข้อเพื่อรับ Developer VIP Key (1,000 req/min)",
+        questionOf: (idx, total) => 'คำถามที่ ' + idx + ' จาก ' + total,
+        score: (score, total) => 'คะแนน: ' + score + ' / ' + total,
+        correct: "🌸 ถูกต้องสมบูรณ์!",
+        incorrect: "✗ ยังไม่ถูกต้องนะมี่จวี!",
+        tryAgain: "ลองตอบใหม่อีกครั้ง ↺",
+        generatingKey: "กำลังสร้าง Developer VIP Key ประจำตัวของคุณ...",
+        generatingDesc: "Verifying 15/15 score and issuing VIP credentials...",
+        congratsTitle: "ยินดีด้วย! คุณคือแฟนพันธุ์แท้จวีจิ้งอี 🌸",
+        congratsDesc: "ตอบถูกต้องครบ 15/15 ข้อ! ปลดล็อกโควต้า Developer VIP Tier 1,000 requests/min สำเร็จ",
+        keyLabel: "Developer VIP API Key",
+        copyKey: "Copy Key",
+        applyBtn: "⚡ ใช้งาน VIP Key กับ Interactive Console ทันที",
+        finishBtn: "เสร็จสิ้น",
+        errorTitle: "เกิดข้อผิดพลาดในการออก Key",
+        retryQuiz: "ลองใหม่อีกครั้ง",
+        copyAlert: (key) => '📋 คัดลอก Developer VIP Key เรียบร้อยแล้ว!\\n\\n' + key,
+        appliedAlert: "👑 นำ Developer VIP Key ไปใช้งานกับ Interactive Test Console เรียบร้อยแล้ว! (โควต้า 1,000 req/min)"
+      },
+      en: {
+        title: "Ju Jingyi Miju Trivia Challenge 🌸",
+        subtitle: "Answer all 15 questions correctly to claim your Developer VIP Key (1,000 req/min)",
+        questionOf: (idx, total) => 'Question ' + idx + ' of ' + total,
+        score: (score, total) => 'Score: ' + score + ' / ' + total,
+        correct: "🌸 Perfectly Correct!",
+        incorrect: "✗ Not quite right, Miju!",
+        tryAgain: "Try Again ↺",
+        generatingKey: "Generating your Developer VIP Key...",
+        generatingDesc: "Verifying 15/15 score and issuing VIP credentials...",
+        congratsTitle: "Congratulations! True Ju Jingyi Fan 🌸",
+        congratsDesc: "15/15 Perfect Score! You have unlocked Developer VIP Tier (1,000 req/min).",
+        keyLabel: "Developer VIP API Key",
+        copyKey: "Copy Key",
+        applyBtn: "⚡ Apply VIP Key to Interactive Console Now",
+        finishBtn: "Done",
+        errorTitle: "Key Issuing Failed",
+        retryQuiz: "Try Again",
+        copyAlert: (key) => '📋 Copied Developer VIP Key to clipboard!\\n\\n' + key,
+        appliedAlert: "👑 Developer VIP Key has been applied to the live test console! (1,000 req/min quota active)"
+      },
+      zh: {
+        title: "鞠婧祎蜜橘专属问答挑战 🌸",
+        subtitle: "正确回答全部15道题目即可获取开发者 VIP Key (1,000次/分钟)",
+        questionOf: (idx, total) => '第 ' + idx + ' 题 / 共 ' + total + ' 题',
+        score: (score, total) => '得分: ' + score + ' / ' + total,
+        correct: "🌸 回答完全正确！",
+        incorrect: "✗ 答错啦，蜜橘继续加油！",
+        tryAgain: "重新作答 ↺",
+        generatingKey: "正在为您生成专属开发者 VIP Key...",
+        generatingDesc: "系统正在验证满分答卷并颁发专属权限...",
+        congratsTitle: "恭喜通关！鞠婧祎资深铁杆蜜橘 🌸",
+        congratsDesc: "答对全部15道题目！成功解锁 Developer VIP Tier 1,000次/分钟高频配额。",
+        keyLabel: "开发者 VIP API Key",
+        copyKey: "复制密钥",
+        applyBtn: "⚡ 立即将 VIP Key 应用于测试控制台",
+        finishBtn: "完成",
+        errorTitle: "密钥生成失败",
+        retryQuiz: "重新尝试",
+        copyAlert: (key) => '📋 开发者 VIP Key 已复制到剪贴板！\\n\\n' + key,
+        appliedAlert: "👑 已成功将 VIP Key 应用于在线接口控制台！（已激活 1,000次/分钟高频配额）"
+      }
+    };
+
+    const quizQuestions = [
+      {
+        q: {
+          th: "1. วันเกิดของจวีจิ้งอี (Ju Jingyi) คือวันใด?",
+          en: "1. What is Ju Jingyi's date of birth?",
+          zh: "1. 鞠婧祎的出生日期是哪一天？"
+        },
+        options: {
+          th: ["18 มิถุนายน 1994", "23 กรกฎาคม 1995", "4 มีนาคม 1993", "12 กันยายน 1996"],
+          en: ["June 18, 1994", "July 23, 1995", "March 4, 1993", "September 12, 1996"],
+          zh: ["1994年6月18日", "1995年7月23日", "1993年3月4日", "1996年9月12日"]
+        },
+        hint: {
+          th: "เธอเกิดในช่วงกลางปี ค.ศ. 1994 ในจีน ลองนึกถึงเดือนที่อยู่กึ่งกลางของปี",
+          en: "She was born in mid-1994 in China — think of the month that sits near the midpoint of the calendar year.",
+          zh: "她出生于1994年，月份大约在全年中段，仔细想想是哪一天。"
+        }
+      },
+      {
+        q: {
+          th: "2. จวีจิ้งอีเกิดที่เมืองและมณฑลใดในประเทศจีน?",
+          en: "2. In which city and province of China was Ju Jingyi born?",
+          zh: "2. 鞠婧祎出生于中国的哪座城市？"
+        },
+        options: {
+          th: ["เมืองสุยหนิง มณฑลเสฉวน (Suining, Sichuan)", "เมืองเฉิงตู มณฑลเสฉวน", "เมืองหางโจว มณฑลเจ้อเจียง", "เทศบาลนครเซี่ยงไฮ้"],
+          en: ["Suining, Sichuan Province", "Chengdu, Sichuan Province", "Hangzhou, Zhejiang Province", "Shanghai Municipality"],
+          zh: ["四川省遂宁市", "四川省成都市", "浙江省杭州市", "上海市"]
+        },
+        hint: {
+          th: "บ้านเกิดของเธออยู่ในมณฑลที่ขึ้นชื่อด้านอาหารรสเผ็ด หมีแพนด้า และเมืองหลวงของมณฑลคือเฉิงตู แต่เธอเกิดในเมืองที่เล็กกว่า",
+          en: "Her hometown province is known for spicy food and giant pandas — its capital is Chengdu, but she was born in a smaller city there.",
+          zh: "她家乡所在省份以麻辣美食和大熊猫闻名，省会是成都，但她出生在省内另一座较小的城市。"
+        }
+      },
+      {
+        q: {
+          th: "3. ชื่อแฟนคลับอย่างเป็นทางการ (Official Fandom Name) ของจวีจิ้งอีคืออะไร?",
+          en: "3. What is the official fandom name of Ju Jingyi?",
+          zh: "3. 鞠婧祎的官方粉丝名是什么？"
+        },
+        options: {
+          th: ["มี่จวี (Miju / 蜜橘 - ส้มหวาน)", "เสี่ยวเหมย (Xiaomei)", "ชิงเฉิง (Qingcheng)", "ไป๋เหอ (Baihe)"],
+          en: ["Miju (蜜橘 - Sweet Tangerine)", "Xiaomei", "Qingcheng", "Baihe"],
+          zh: ["蜜橘 (Miju)", "小妹 (Xiaomei)", "倾城 (Qingcheng)", "百合 (Baihe)"]
+        },
+        hint: {
+          th: "ชื่อแฟนด้อมเป็นชื่อผลไม้สีส้มขนาดเล็ก รสหวานเปรี้ยว นิยมรับประทานในเทศกาลฤดูหนาว",
+          en: "The fandom name is a small sweet citrus fruit with orange skin, often enjoyed during winter festivals in East Asia.",
+          zh: "粉丝名是一种小巧甘甜的橙色柑橘类水果，东亚冬季节日中常见。"
+        }
+      },
+      {
+        q: {
+          th: "4. สีประจำตัวและสีทางการของแฟนคลับ (Official Support Colors) มีสีอะไรบ้าง?",
+          en: "4. What are the official fan support colors of Ju Jingyi?",
+          zh: "4. 鞠婧祎与蜜橘的官方应援色是哪些？"
+        },
+        options: {
+          th: ["น้ำเงินฟ้าคราม (Sky Blue), ชมพูดอกซากุระ (Sakura Pink), และทองประกาย (Gold)", "แดงทับทิม, เขียวมรกต, ม่วงลาเวนเดอร์", "เหลืองมะนาว, ส้มพีช, ขาวไข่มุก", "ดำสนิท, เงินเมทัลลิก, ฟ้าพาสเทล"],
+          en: ["Sky Blue (蔚蓝色), Sakura Pink (樱花粉), and Shining Gold (耀金)", "Ruby Red, Emerald Green, Lavender Purple", "Lemon Yellow, Peach Orange, Pearl White", "Jet Black, Metallic Silver, Pastel Blue"],
+          zh: ["蔚蓝色、樱花粉、耀金", "红宝石色、翡翠绿、薰衣草紫", "柠檬黄、蜜桃橙、珍珠白", "曜石黑、金属银、浅天蓝"]
+        },
+        hint: {
+          th: "สีทั้งสามนำแรงบันดาลใจมาจากท้องฟ้า ดอกไม้ยามใบไม้ผลิ และแสงสว่างของดวงอาทิตย์",
+          en: "The three colors draw inspiration from the sky, spring blossoms, and the radiance of sunlight.",
+          zh: "三种颜色分别灵感来自晴朗的天空、春日的花朵以及阳光般的光辉。"
+        }
+      },
+      {
+        q: {
+          th: "5. จวีจิ้งอีสร้างประวัติศาสตร์ในวง SNH48 อย่างไร?",
+          en: "5. What historic milestone did Ju Jingyi achieve during her SNH48 career?",
+          zh: "5. 鞠婧祎在SNH48总选举中创造了怎样的历史纪录？"
+        },
+        options: {
+          th: ["ชนะการเลือกตั้งอันดับ 1 สองปีซ้อน (2016 & 2017) และเข้าสู่ Star Hall of Fame", "เป็นกัปตันทีมคนแรกของวง SNH48", "มีผลงานเพลงมากที่สุดในวงถึง 100 เพลง", "ก่อตั้งวงสาขาย่อยในปักกิ่ง"],
+          en: ["Won 1st Place in General Elections twice in a row (2016 & 2017) and promoted to Star Hall of Fame", "Was the first overall team captain of SNH48", "Released the highest number of singles in group history (100 songs)", "Founded the Beijing sub-unit"],
+          zh: ["蝉联第三届与第四届总选举冠军并晋升SNH48明星殿堂", "成为SNH48全团第一任总队长", "在团期间发行了100首单曲", "创立了北京姐妹团"]
+        },
+        hint: {
+          th: "เธอเป็นสมาชิกคนเดียวที่ครองอันดับหนึ่งต่อเนื่องสองสมัย จนได้รับสิทธิ์พิเศษสูงสุดในวง",
+          en: "She is the only member to top the annual election rankings in two consecutive years, earning the highest honor tier.",
+          zh: "她是唯一连续两届年度总选登顶的成员，因此获得了团队最高荣誉资格。"
+        }
+      },
+      {
+        q: {
+          th: "6. ผลงานซีรีส์แนวย้อนยุคที่สร้างชื่อเสียงและเป็นผลงานแจ้งเกิดระดับตำนานของจวีจิ้งอีคือเรื่องใด?",
+          en: "6. Which classic historical costume drama served as Ju Jingyi's breakthrough breakout role?",
+          zh: "6. 哪部经典古装剧是鞠婧祎经典代表作并让她一举成名？"
+        },
+        options: {
+          th: ["ตำนานหยุนซี มเหสียอดอัจฉริยะแห่งพิษ (Legend of Yunxi - 芸汐传)", "กรุ่นรักกลิ่นบุปผา (The Blooms at Ruyi Pavilion)", "ปรมาจารย์ลัทธิมาร (The Untamed)", "สามชาติสามภพ ป่าท้อสิบหลี่ (Eternal Love)"],
+          en: ["Legend of Yunxi (芸汐传 - 2018)", "The Blooms at Ruyi Pavilion (如意芳霏)", "The Untamed (陈情令)", "Eternal Love (三生三世十里桃花)"],
+          zh: ["《芸汐传》(Legend of Yunxi)", "《如意芳霏》(The Blooms at Ruyi Pavilion)", "《陈情令》(The Untamed)", "《三生三世十里桃花》(Eternal Love)"]
+        },
+        hint: {
+          th: "ซีรีส์แจ้งเกิดปี 2018 เล่าเรื่องหญิงสาวอัจฉริยะด้านพิษในราชสำนัก ชื่อเรื่องตั้งตามชื่อตัวละครเอก",
+          en: "This 2018 drama features a brilliant young woman skilled in poisons at an imperial court — the title is named after her character.",
+          zh: "这部2018年古装剧讲述一位精通毒术的聪慧女子，剧名取自女主角的名字。"
+        }
+      },
+      {
+        q: {
+          th: "7. ในซีรีส์ยอดฮิต 'บุปผารักอลวน (In Blossom - 2024)' จวีจิ้งอีรับบทเป็นตัวละครใด?",
+          en: "7. In the 2024 hit mystery drama 'In Blossom', which character(s) did Ju Jingyi portray?",
+          zh: "7. 在2024年爆款古装悬疑剧《花间令》中，鞠婧祎饰演的角色是？"
+        },
+        options: {
+          th: ["หยางไฉ่เวย / ซ่างกวนจื่อ (Yang Caiwei / Shangguan Zhi)", "หานอวิ๋นซี / ซื่อเฉียง", "ไป๋ซู่เจิน / เสี่ยวชิง", "ฟู่หรง / ชุยหว่าน"],
+          en: ["Yang Caiwei / Shangguan Zhi (Dual Personas)", "Han Yunxi / Si Qiang", "Bai Suzhen / Xiaoqing", "Fu Rong / Cui Wan"],
+          zh: ["杨采薇 / 上官芷 (一人分饰两角)", "韩芸汐 / 四娘", "白素贞 / 小青", "傅容 / 崔绾"]
+        },
+        hint: {
+          th: "เธอรับบท 2 ตัวละครในเรื่องเดียว นิสัยตรงข้ามกันสิ้นเชิง — หนึ่งใจดี อีกหนึ่งเจ้าเล่ห์",
+          en: "She played two characters in the same drama with opposite personalities — one gentle, one scheming.",
+          zh: "她在剧中同时饰演两个性格截然相反的角色，一善一奸。"
+        }
+      },
+      {
+        q: {
+          th: "8. เครื่องดนตรีที่จวีจิ้งอีมีความเชี่ยวชาญระดับสูงและฝึกฝนมาตั้งแต่เด็กคือเครื่องดนตรีใด?",
+          en: "8. Which musical instruments is Ju Jingyi highly proficient in and has played since childhood?",
+          zh: "8. 鞠婧祎从小精通并多次在舞台上惊艳演奏的乐器是？"
+        },
+        options: {
+          th: ["ไวโอลิน (Violin) และ กู่เจิง (Guzheng)", "กลองชุด และ เบส", "ทรัมเป็ต และ แซกโซโฟน", "ฮาร์ป และ ฟลุต"],
+          en: ["Violin and Guzheng (Chinese Zither)", "Drum Set and Electric Bass", "Trumpet and Saxophone", "Harp and Flute"],
+          zh: ["小提琴与古筝", "架子鼓与贝斯", "小号与萨克斯", "竖琴与长笛"]
+        },
+        hint: {
+          th: "เธอเล่นเครื่องดนตรีสายชนิดหนึ่งจากตะวันตก และอีกชนิดจากเอเชียตะวันออก ทั้งคู่ใช้สายเป็นแหล่งเสียง",
+          en: "She plays one Western string instrument and one traditional East Asian string instrument.",
+          zh: "她精通一件西方弦乐器和一件东亚传统弦乐器，均以弦为发声方式。"
+        }
+      },
+      {
+        q: {
+          th: "9. แบรนด์แฟชั่นระดับไฮเอนด์ระดับโลกแบรนด์ใดที่แต่งตั้งจวีจิ้งอีเป็น Global Brand Ambassador?",
+          en: "9. Which world-renowned international luxury fashion house appointed Ju Jingyi as its Global Brand Ambassador?",
+          zh: "9. 哪家世界顶级奢华时尚品牌官宣鞠婧祎为全球品牌代言人？"
+        },
+        options: {
+          th: ["Versace (เวอร์ซาเช่)", "Gucci (กุชชี)", "Chanel (ชาเนล)", "Dior (ดิออร์)"],
+          en: ["Versace", "Gucci", "Chanel", "Dior"],
+          zh: ["范思哲 (Versace)", "古驰 (Gucci)", "香奈儿 (Chanel)", "迪奥 (Dior)"]
+        },
+        hint: {
+          th: "แบรนด์นี้มาจากอิตาลี ใช้หัวเมดูซ่าเป็นสัญลักษณ์ และมีชื่อเสียงด้านแฟชั่นสุดหรู",
+          en: "This Italian luxury brand is famous for its Medusa head emblem and bold, opulent designs.",
+          zh: "这个来自意大利的奢侈品牌以神话中的美杜莎头像为标志，以大胆华丽的设计著称。"
+        }
+      },
+      {
+        q: {
+          th: "10. ซิงเกิลเดี่ยวเพลงหลักล่าสุดประจำปี 2026 ของจวีจิ้งอีมีชื่อว่าอะไร?",
+          en: "10. What is the title of Ju Jingyi's latest 2026 flagship solo single?",
+          zh: "10. 鞠婧祎2026年最新发布的个人主打单曲名称是？"
+        },
+        options: {
+          th: ["FIND THE WAY", "Rain Love (雨爱)", "Everyday (日日夜夜)", "Don't Touch"],
+          en: ["FIND THE WAY", "Rain Love (雨爱)", "Everyday", "Don't Touch"],
+          zh: ["《FIND THE WAY》", "《雨爱》(Rain Love)", "《日日夜夜》(Everyday)", "《Don't Touch》"]
+        },
+        hint: {
+          th: "ชื่อเพลงปี 2026 เป็นภาษาอังกฤษ 3 คำ สื่อถึงการค้นหาทิศทางในชีวิต",
+          en: "The 2026 single has a 3-word English title about searching for direction in life.",
+          zh: "这首2026年单曲的名称由三个英文单词组成，传达寻找人生方向的主题。"
+        }
+      },
+      {
+        q: {
+          th: "11. ชื่อเล่นและฉายาที่แฟนๆ และคนทั่วไปเรียกจวีจิ้งอีด้วยความรักคืออะไร?",
+          en: "11. What is the most affectionate nickname by which fans and the public refer to Ju Jingyi?",
+          zh: "11. 粉丝与大众最常亲切称呼鞠婧祎的昵称是？"
+        },
+        options: {
+          th: ["เสี่ยวจวี (Xiao Ju / 小鞠) หรือ Kiku", "จวีเอ๋อร์ (Ju'er)", "อาอี (A-Yi)", "จิ้งจิ้ง (JingJing)"],
+          en: ["Xiao Ju (小鞠) / Kiku", "Ju'er", "A-Yi", "JingJing"],
+          zh: ["小鞠 (Xiao Ju) / Kiku", "鞠儿", "阿祎", "婧婧"]
+        },
+        hint: {
+          th: "ชื่อเล่นนี้ดัดแปลงมาจากนามสกุลจีนของเธอ และออกเสียงคล้ายกับชื่อในภาษาญี่ปุ่น",
+          en: "The nickname is derived from her Chinese surname and sounds similar to a Japanese given name.",
+          zh: "这个昵称源自她的中文姓氏，发音也与一个常见的日文名字相近。"
+        }
+      },
+      {
+        q: {
+          th: "12. เพลงประกอบซีรีส์ 'บุปผารักอลวน (In Blossom OST)' ที่จวีจิ้งอีขับร้องมีชื่อว่าอะไร?",
+          en: "12. What is the title of the original soundtrack (OST) song performed by Ju Jingyi for 'In Blossom'?",
+          zh: "12. 鞠婧祎为电视剧《花间令》献唱的主题曲/插曲是？"
+        },
+        options: {
+          th: ["ดั่งแพรไหม (如纱 - Ru Sha / Like a Silk)", "รักแรกพบ (First Love)", "แสงสว่างในสายลม", "บุปผาร่วงโรย"],
+          en: ["Like a Silk (如纱 - Ru Sha)", "First Love", "Light in the Wind", "Fallen Blossoms"],
+          zh: ["《如纱》(Ru Sha / Like a Silk)", "《初恋》", "《风中之光》", "《落花》"]
+        },
+        hint: {
+          th: "ชื่อเพลงเป็นอักษรจีน 2 ตัว สื่อถึงสิ่งบางเบาโปร่งแสง เหมือนผ้าที่ปลิวตามสายลม",
+          en: "The song title is two Chinese characters evoking something light and translucent, like fabric in the breeze.",
+          zh: "歌名由两个汉字组成，意境轻盈透明，如随风飘动的薄纱。"
+        }
+      },
+      {
+        q: {
+          th: "13. สัตว์เลี้ยงตัวโปรดของจวีจิ้งอีคือสัตว์ชนิดใดและมีชื่อว่าอะไร?",
+          en: "13. What pet does Ju Jingyi cherish, and what is its name?",
+          zh: "13. 鞠婧祎心爱的宠物猫咪名字叫什么？"
+        },
+        options: {
+          th: ["แมว ชื่อว่า 'ฮาฮา' (Haha / 哈哈)", "สุนัข ชื่อว่า 'พุดดิ้ง'", "กระต่าย ชื่อว่า 'เสี่ยวไป๋'", "นกแก้ว ชื่อว่า 'กีกี้'"],
+          en: ["A cat named 'Haha' (哈哈)", "A puppy named 'Pudding'", "A rabbit named 'Xiaobai'", "A parrot named 'Kiki'"],
+          zh: ["猫咪，名字叫“哈哈”", "小狗，名字叫“布丁”", "小兔，名字叫“小白”", "鹦鹉，名字叫“琪琪”"]
+        },
+        hint: {
+          th: "สัตว์เลี้ยงของเธอเป็นแมว และชื่อของมันฟังดูเหมือนเสียงหัวเราะในหลายภาษา",
+          en: "Her pet is a cat whose name sounds like the onomatopoeia for laughter in many languages.",
+          zh: "她养的是一只猫咪，它的名字读起来像是笑声的拟声词。"
+        }
+      },
+      {
+        q: {
+          th: "14. ในซีรีส์ 'ตำนานนางพญางูขาว (The Legend of White Snake - 2019)' จวีจิ้งอีรับบทเป็นใคร?",
+          en: "14. In the 2019 TV series 'The Legend of White Snake', which iconic role did Ju Jingyi star as?",
+          zh: "14. 在2019版电视剧《新白娘子传奇》中，鞠婧祎领衔主演的角色是？"
+        },
+        options: {
+          th: ["ไป๋ซู่เจิน (Bai Suzhen)", "เสี่ยวชิง (Xiaoqing)", "หลินไต้อวี้ (Lin Daiyu)", "ซูเสี่ยวเม่ย"],
+          en: ["Bai Suzhen (Lady White Snake)", "Xiaoqing (Green Snake)", "Lin Daiyu", "Su Xiaomei"],
+          zh: ["白素贞 (Bai Suzhen)", "小青 (Xiaoqing)", "林黛玉", "苏小妹"]
+        },
+        hint: {
+          th: "ตัวละครที่เธอรับบทเป็นตัวเอกหญิงจากตำนานจีนคลาสสิก ชื่อตัวละครอ้างอิงถึงงูสีขาว",
+          en: "The character she portrayed is the female lead of a classic Chinese legend — her name references a white serpent.",
+          zh: "她饰演的是中国经典民间传说的女主角，角色名与一条白蛇有关。"
+        }
+      },
+      {
+        q: {
+          th: "15. คติประจำใจและปรัชญาการทำงานที่มีชื่อเสียงของจวีจิ้งอีคือข้อใด?",
+          en: "15. What is Ju Jingyi's renowned life philosophy and guiding motto?",
+          zh: "15. 鞠婧祎广为人知的处世金句与座右铭是哪一句？"
+        },
+        options: {
+          th: ["认真工作，踏实生活 (ตั้งใจทำงาน ใช้ชีวิตอย่างมั่นคงและก้าวไปข้างหน้าอย่างจริงใจ)", "อย่าหยุดเมื่อเหนื่อย แต่หยุดเมื่อชนะ", "ความสำเร็จอยู่ที่การรอคอย", "ความสมบูรณ์แบบไม่มีอยู่จริง"],
+          en: ["Work hard with dedication, live life grounded and sincerely (认真工作，踏实生活)", "Don't stop when tired, stop when victorious", "Success comes to those who wait", "Perfection does not exist"],
+          zh: ["“认真工作，踏实生活”", "“不要在累的时候停下，要在成功时停下”", "“成功在于等待”", "“完美并不存在”"]
+        },
+        hint: {
+          th: "คติของเธอเป็นประโยคจีน 8 ตัวอักษร แบ่งเป็นสองส่วน พูดถึงการทำงานและการใช้ชีวิตอย่างจริงใจ",
+          en: "Her motto is an eight-character Chinese phrase, split into two parts — one about work, one about living sincerely.",
+          zh: "她的座右铭是一句八字短语，分两句，分别谈及工作态度与生活方式。"
+        }
+      }
+    ];
+
+    let quizIndex = 0;
+    let quizScore = 0;
+    let quizAnswered = false;
+    let activeQuizQuestions = [];
+
+    function shuffleQuizQuestions() {
+      const indexed = quizQuestions.map((q, idx) => ({ ...q, originalIndex: idx }));
+      for (let i = indexed.length - 1; i > 0; i--) {
+        const j = Math.floor(Math.random() * (i + 1));
+        const temp = indexed[i];
+        indexed[i] = indexed[j];
+        indexed[j] = temp;
+      }
+
+      activeQuizQuestions = indexed.map(q => {
+        const order = [0, 1, 2, 3];
+        for (let i = order.length - 1; i > 0; i--) {
+          const j = Math.floor(Math.random() * (i + 1));
+          const temp = order[i];
+          order[i] = order[j];
+          order[j] = temp;
+        }
+
+        const shuffledOptions = {
+          th: order.map(idx => q.options.th[idx]),
+          en: order.map(idx => q.options.en[idx]),
+          zh: order.map(idx => q.options.zh[idx])
+        };
+
+        return {
+          originalIndex: q.originalIndex,
+          q: q.q,
+          hint: q.hint,
+          options: shuffledOptions,
+          optionOrder: order
+        };
+      });
+    }
+
+    function setQuizLang(lang) {
+      if (!['th', 'en', 'zh'].includes(lang)) return;
+      quizLang = lang;
+
+      ['th', 'en', 'zh'].forEach(l => {
+        const btn = document.getElementById('lang-btn-' + l);
+        if (btn) {
+          if (l === lang) {
+            btn.className = 'px-2 sm:px-2.5 py-1 rounded-lg text-xs font-bold transition-all bg-rose-600 text-white shadow-xs';
+          } else {
+            btn.className = 'px-2 sm:px-2.5 py-1 rounded-lg text-xs font-bold transition-all text-stone-400 hover:text-white';
+          }
+        }
+      });
+
+      const modalTitle = document.getElementById('quiz-modal-title');
+      const modalSubtitle = document.getElementById('quiz-modal-subtitle');
+      if (modalTitle) modalTitle.innerText = quizI18n[quizLang].title;
+      if (modalSubtitle) modalSubtitle.innerText = quizI18n[quizLang].subtitle;
+
+      const total = activeQuizQuestions.length > 0 ? activeQuizQuestions.length : quizQuestions.length;
+      if (quizIndex < total) {
+        renderQuizQuestion();
+      } else {
+        renderQuizVictory();
+      }
+    }
+
+    let userQuizAnswers = [];
+    let currentQuizChallengeToken = null;
+
+    async function openQuizModal() {
+      quizIndex = 0;
+      quizScore = 0;
+      quizAnswered = false;
+      userQuizAnswers = [];
+      currentQuizChallengeToken = null;
+      shuffleQuizQuestions();
+      const modal = document.getElementById('quiz-modal');
+      if (modal) {
+        modal.classList.remove('hidden');
+        modal.classList.add('flex');
+      }
+      setQuizLang(quizLang);
+
+      try {
+        const res = await fetch('/api/v1/quiz/challenge');
+        if (res.ok) {
+          const json = await res.json();
+          if (json.data?.challengeToken) {
+            currentQuizChallengeToken = json.data.challengeToken;
+          }
+        }
+      } catch {}
+    }
+
+    function closeQuizModal() {
+      const modal = document.getElementById('quiz-modal');
+      if (modal) {
+        modal.classList.add('hidden');
+        modal.classList.remove('flex');
+      }
+    }
+
+    function renderQuizQuestion() {
+      const content = document.getElementById('quiz-content');
+      const progressBar = document.getElementById('quiz-progress-bar');
+      if (!content) return;
+
+      quizAnswered = false;
+      const questionsList = activeQuizQuestions.length > 0 ? activeQuizQuestions : quizQuestions;
+      const total = questionsList.length;
+      const progressPercent = Math.min(100, Math.round(((quizIndex + 1) / total) * 100));
+      if (progressBar) progressBar.style.width = progressPercent + '%';
+
+      if (quizIndex >= total) {
+        renderQuizVictory();
+        return;
+      }
+
+      const q = questionsList[quizIndex];
+      const i18n = quizI18n[quizLang];
+      const rawQuestionText = q.q[quizLang] || q.q.en;
+      const questionText = typeof rawQuestionText === 'string' ? rawQuestionText.replace(/^\s*\d+[.)]\s*/, '') : rawQuestionText;
+      const optionsList = q.options[quizLang] || q.options.en;
+
+      let html = \`
+        <div class="space-y-5">
+          <div class="flex items-center justify-between">
+            <span class="text-xs font-bold uppercase tracking-wider text-rose-700 dark:text-rose-400">
+              \${i18n.questionOf(quizIndex + 1, total)}
+            </span>
+            <span class="text-xs font-bold px-2.5 py-0.5 rounded-full bg-amber-100 dark:bg-rose-950 border border-amber-300 dark:border-rose-800/60 text-amber-900 dark:text-amber-300">
+              \${i18n.score(quizScore, total)}
+            </span>
+          </div>
+
+          <div>
+            <h4 class="text-base sm:text-lg font-bold text-stone-900 dark:text-white leading-relaxed">\${questionText}</h4>
+          </div>
+
+          <div class="space-y-2.5">
+      \`;
+
+      optionsList.forEach((opt, idx) => {
+        const letters = ['A', 'B', 'C', 'D'];
+        html += \`
+          <button type="button" id="opt-btn-\${idx}" onclick="handleSelectOption(\${idx})" class="w-full text-left p-3.5 sm:p-4 rounded-2xl bg-stone-100 hover:bg-rose-50/70 dark:bg-stone-900 dark:hover:bg-stone-800/80 border border-stone-200 hover:border-rose-400 dark:border-stone-800 dark:hover:border-rose-600/80 transition-all flex items-center justify-between gap-3 group cursor-pointer active:scale-99 shadow-2xs">
+            <div class="flex items-center gap-3">
+              <span class="w-7 h-7 rounded-xl bg-stone-200 group-hover:bg-rose-100 dark:bg-stone-800 dark:group-hover:bg-rose-950 border border-stone-300 group-hover:border-rose-300 dark:border-stone-700 dark:group-hover:border-rose-700 text-stone-700 group-hover:text-rose-800 dark:text-stone-300 dark:group-hover:text-rose-300 text-xs font-bold flex items-center justify-center shrink-0">
+                \${letters[idx]}
+              </span>
+              <span class="text-xs sm:text-sm text-stone-800 dark:text-stone-200 font-medium group-hover:text-stone-950 dark:group-hover:text-white">\${opt}</span>
+            </div>
+            <span id="opt-icon-\${idx}" class="text-xs font-bold opacity-0 transition-opacity"></span>
+          </button>
+        \`;
+      });
+
+      html += \`
+          </div>
+
+          <div id="quiz-feedback" class="hidden p-3.5 rounded-2xl text-xs"></div>
+        </div>
+      \`;
+
+      content.innerHTML = html;
+    }
+
+    async function handleSelectOption(optIdx) {
+      if (quizAnswered) return;
+      quizAnswered = true;
+
+      const questionsList = activeQuizQuestions.length > 0 ? activeQuizQuestions : quizQuestions;
+      const q = questionsList[quizIndex];
+      const i18n = quizI18n[quizLang];
+      const hintText = q.hint[quizLang] || q.hint.en;
+      const feedback = document.getElementById('quiz-feedback');
+      const selectedBtn = document.getElementById('opt-btn-' + optIdx);
+
+      const originalOptionIndex = q.optionOrder ? q.optionOrder[optIdx] : optIdx;
+      const targetQIndex = q.originalIndex !== undefined ? q.originalIndex : quizIndex;
+      userQuizAnswers.push({ qIndex: targetQIndex, answerIndex: originalOptionIndex });
+      quizScore++;
+
+      if (selectedBtn) {
+        selectedBtn.className = 'w-full text-left p-3.5 sm:p-4 rounded-2xl bg-rose-100 dark:bg-rose-950/80 border-2 border-rose-500 text-rose-950 dark:text-white flex items-center justify-between gap-3 shadow-md';
+        const icon = document.getElementById('opt-icon-' + optIdx);
+        if (icon) {
+          icon.innerText = '✓ ' + (quizLang === 'zh' ? '已选择' : (quizLang === 'th' ? 'เลือกแล้ว' : 'Selected'));
+          icon.className = 'text-xs font-bold text-rose-600 dark:text-rose-400 opacity-100';
+        }
+      }
+      if (feedback) {
+        feedback.className = 'p-3.5 rounded-2xl bg-rose-50 dark:bg-rose-950/60 border border-rose-300 dark:border-rose-800 text-rose-900 dark:text-rose-300 text-xs flex items-center gap-2 shadow-xs';
+        feedback.innerHTML = '<span class="text-stone-600 dark:text-stone-300 font-medium">💡 ' + hintText + '</span>';
+        feedback.classList.remove('hidden');
+      }
+
+      setTimeout(() => {
+        quizIndex++;
+        renderQuizQuestion();
+      }, 550);
+    }
+
+    function retryCurrentQuestion() {
+      quizAnswered = false;
+      renderQuizQuestion();
+    }
+
+    async function renderQuizVictory() {
+      const content = document.getElementById('quiz-content');
+      const i18n = quizI18n[quizLang];
+      if (!content) return;
+
+      content.innerHTML = \`
+        <div class="py-8 text-center space-y-4">
+          <div class="inline-block animate-spin text-3xl">🌸</div>
+          <h4 class="text-lg font-bold text-stone-900 dark:text-white">\${i18n.generatingKey}</h4>
+          <p class="text-xs text-stone-500 dark:text-stone-400">\${i18n.generatingDesc}</p>
+        </div>
+      \`;
+
+      try {
+        const res = await fetch('/api/v1/keys/claim', {
+          method: 'POST',
+          headers: { 'Content-Type': 'application/json' },
+          body: JSON.stringify({
+            score: quizScore,
+            answers: userQuizAnswers,
+            challengeToken: currentQuizChallengeToken
+          })
+        });
+        const json = await res.json();
+
+        if (json.status === 'success' && json.data?.apiKey) {
+          const key = json.data.apiKey;
+          currentVipKey = key;
+          updateVipUiState(false);
+
+          content.innerHTML = \`
+            <div class="text-center space-y-6 py-3">
+              <div class="w-16 h-16 mx-auto rounded-3xl bg-gradient-to-br from-amber-400 to-rose-500 p-0.5 shadow-xl shadow-rose-600/30 flex items-center justify-center">
+                <div class="w-full h-full rounded-[22px] bg-white dark:bg-stone-950 flex items-center justify-center text-3xl">
+                  👑
+                </div>
+              </div>
+
+              <div class="space-y-1">
+                <h4 class="text-xl sm:text-2xl font-black text-stone-900 dark:text-transparent dark:bg-clip-text dark:bg-gradient-to-r dark:from-rose-300 dark:via-pink-200 dark:to-amber-200">
+                  \${i18n.congratsTitle}
+                </h4>
+                <p class="text-xs text-stone-600 dark:text-stone-300">
+                  \${i18n.congratsDesc}
+                </p>
+              </div>
+
+              <div class="p-4 sm:p-5 rounded-2xl bg-stone-50 dark:bg-stone-900 border border-rose-200 dark:border-rose-800/60 text-left space-y-3 shadow-inner">
+                <div class="flex items-center justify-between">
+                  <span class="text-[11px] font-bold uppercase tracking-wider text-rose-700 dark:text-rose-400">\${i18n.keyLabel}</span>
+                  <span class="text-[10px] px-2 py-0.5 rounded-full bg-emerald-100 dark:bg-emerald-950 text-emerald-800 dark:text-emerald-300 border border-emerald-300 dark:border-emerald-800 font-bold">1,000 req/min</span>
+                </div>
+                <div class="p-3 rounded-xl bg-white dark:bg-stone-950 border border-stone-200 dark:border-stone-800 flex items-center justify-between gap-2 shadow-2xs">
+                  <span class="font-mono text-xs text-amber-700 dark:text-amber-300 font-bold break-all select-all">\${key}</span>
+                  <button type="button" onclick="copyVipKey('\${key}')" class="px-3 py-1.5 rounded-lg bg-rose-600 hover:bg-rose-500 font-bold text-xs text-white shrink-0 shadow-sm active:scale-95 transition-all cursor-pointer">
+                    \${i18n.copyKey}
+                  </button>
+                </div>
+                <p class="text-[11px] text-stone-500 dark:text-stone-400">
+                  \${quizLang === 'zh' ? '使用方式：' : (quizLang === 'th' ? 'วิธีใช้งาน: ' : 'Usage: ')} <code>X-API-Key: \${key}</code> \${quizLang === 'zh' ? '或' : (quizLang === 'th' ? 'หรือ' : 'or')} <code>Authorization: Bearer \${key}</code>
+                </p>
+              </div>
+
+              <div class="flex flex-col sm:flex-row items-center gap-3 pt-2">
+                <button type="button" onclick="applyVipKeyToConsole(); closeQuizModal();" class="w-full py-3 px-4 rounded-xl bg-gradient-to-r from-rose-600 to-pink-600 hover:from-rose-500 hover:to-pink-500 font-bold text-xs sm:text-sm text-white shadow-lg shadow-rose-600/30 active:scale-95 transition-all cursor-pointer">
+                  \${i18n.applyBtn}
+                </button>
+                <button type="button" onclick="closeQuizModal()" class="w-full sm:w-auto py-3 px-5 rounded-xl bg-stone-100 hover:bg-stone-200 dark:bg-stone-900 dark:hover:bg-stone-800 border border-stone-300 dark:border-stone-700 text-stone-800 dark:text-stone-300 font-semibold text-xs transition-colors cursor-pointer">
+                  \${i18n.finishBtn}
+                </button>
+              </div>
+            </div>
+          \`;
+        } else {
+          throw new Error(json.message || 'Key generation failed');
+        }
+      } catch (err) {
+        content.innerHTML = \`
+          <div class="text-center py-6 space-y-4">
+            <div class="text-3xl text-rose-500">⚠️</div>
+            <h4 class="text-base font-bold text-stone-900 dark:text-white">\${i18n.errorTitle}</h4>
+            <p class="text-xs text-stone-600 dark:text-stone-300">\${err.message}</p>
+            <button type="button" onclick="openQuizModal()" class="px-4 py-2 rounded-xl bg-rose-600 hover:bg-rose-500 font-bold text-xs text-white cursor-pointer">
+              \${i18n.retryQuiz}
+            </button>
+          </div>
+        \`;
+      }
+    }
+
+    function showToast(options) {
+      const opts = options || {};
+      const icon = opts.icon || '👑';
+      const title = opts.title || '';
+      const message = opts.message || '';
+      const duration = opts.duration || 4500;
+
+      const container = document.getElementById('toast-container');
+      if (!container) return;
+
+      const toast = document.createElement('div');
+      toast.className = 'pointer-events-auto flex items-start gap-3 p-4 rounded-2xl bg-stone-950/95 border border-rose-500/50 shadow-2xl shadow-rose-950/60 backdrop-blur-xl transition-all duration-300 transform translate-y-4 opacity-0 scale-95';
+      
+      toast.innerHTML = \`
+        <div class="w-9 h-9 rounded-xl bg-gradient-to-br from-rose-500 via-pink-600 to-amber-500 p-0.5 shrink-0 flex items-center justify-center shadow-md">
+          <div class="w-full h-full rounded-[10px] bg-stone-950 flex items-center justify-center text-base">
+            \${icon}
+          </div>
+        </div>
+        <div class="flex-1 min-w-0">
+          \${title ? \`<h5 class="text-xs font-bold text-white leading-snug">\${title}</h5>\` : ''}
+          <p class="text-xs text-rose-200/90 leading-relaxed mt-0.5 break-words">\${message}</p>
+        </div>
+        <button type="button" class="text-stone-400 hover:text-white text-xs p-1 transition-colors shrink-0 cursor-pointer" onclick="this.parentElement.remove()">
+          ✕
+        </button>
+      \`;
+
+      container.appendChild(toast);
+
+      const triggerAnim = window.requestAnimationFrame || ((cb) => setTimeout(cb, 20));
+      triggerAnim(() => {
+        toast.classList.remove('translate-y-4', 'opacity-0', 'scale-95');
+        toast.classList.add('translate-y-0', 'opacity-100', 'scale-100');
+      });
+
+      setTimeout(() => {
+        toast.classList.remove('translate-y-0', 'opacity-100', 'scale-100');
+        toast.classList.add('translate-y-2', 'opacity-0', 'scale-95');
+        setTimeout(() => {
+          if (toast.parentElement) toast.remove();
+        }, 300);
+      }, duration);
+    }
+
+    function copySnippet(text, btn) {
+      if (!text) return;
+      const copiedLabel = quizLang === 'zh' ? '✓ 已复制' : (quizLang === 'th' ? '✓ คัดลอกแล้ว' : '✓ Copied');
+      const flashSuccess = () => {
+        if (!btn || !btn.isConnected) return;
+        const originalHtml = btn.innerHTML;
+        const originalClass = btn.className;
+        btn.innerHTML = copiedLabel;
+        btn.classList.remove('bg-rose-800/80', 'hover:bg-rose-700', 'bg-purple-800/80', 'hover:bg-purple-700');
+        btn.classList.add('bg-emerald-600/90');
+        setTimeout(() => {
+          if (!btn.isConnected) return;
+          btn.innerHTML = originalHtml;
+          btn.className = originalClass;
+        }, 1600);
+      };
+      const onSuccess = () => {
+        flashSuccess();
+      };
+      if (typeof navigator !== 'undefined' && navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+        navigator.clipboard.writeText(text).then(onSuccess).catch(() => {
+          prompt('Copy command:', text);
+        });
+      } else {
+        prompt('Copy command:', text);
+      }
+    }
+
+    function copyVipKey(customKey) {
+      const keyToCopy = customKey || currentVipKey;
+      if (!keyToCopy) return;
+
+      const onCopySuccess = () => {
+        showToast({
+          icon: '📋',
+          title: quizLang === 'zh' ? '已复制密钥' : (quizLang === 'th' ? 'คัดลอก VIP Key แล้ว' : 'Key Copied!'),
+          message: quizLang === 'zh' ? '开发者 VIP Key 已成功复制到剪贴板' : (quizLang === 'th' ? 'คัดลอก Developer VIP Key ลงในคลิปบอร์ดแล้ว' : 'Developer VIP Key copied to clipboard!'),
+          duration: 4000
+        });
+      };
+
+      const fallbackCopy = () => {
+        try {
+          const textArea = document.createElement('textarea');
+          textArea.value = keyToCopy;
+          textArea.style.position = 'fixed';
+          textArea.style.left = '-999999px';
+          textArea.style.top = '-999999px';
+          document.body.appendChild(textArea);
+          textArea.focus();
+          textArea.select();
+          const successful = document.execCommand('copy');
+          document.body.removeChild(textArea);
+          if (successful) {
+            onCopySuccess();
+          } else {
+            prompt('Copy your VIP Key:', keyToCopy);
+          }
+        } catch {
+          prompt('Copy your VIP Key:', keyToCopy);
+        }
+      };
+
+      if (typeof navigator !== 'undefined' && navigator.clipboard && typeof navigator.clipboard.writeText === 'function') {
+        navigator.clipboard.writeText(keyToCopy).then(() => {
+          onCopySuccess();
+        }).catch(() => {
+          fallbackCopy();
+        });
+      } else {
+        fallbackCopy();
+      }
+    }
+
+    function applyVipKeyToConsole() {
+      if (!currentVipKey) return;
+      updateVipUiState(false);
+      const i18n = quizI18n[quizLang];
+      showToast({
+        icon: '👑',
+        title: quizLang === 'zh' ? 'VIP Key 已生效！' : (quizLang === 'th' ? 'นำ VIP Key ไปใช้งานแล้ว!' : 'VIP Key Applied!'),
+        message: i18n.appliedAlert,
+        duration: 5000
+      });
+    }
+
+    async function updateVipUiState(verifyOnline) {
+      const activeBadge = document.getElementById('active-tier-badge');
+      const badgeLabel = document.getElementById('tier-badge-label');
+      const startBtn = document.getElementById('start-quiz-btn');
+      const display = document.getElementById('vip-key-display');
+      const keyVal = document.getElementById('vip-key-val');
+
+      if (!currentVipKey) {
+        if (display) display.classList.add('hidden');
+        if (badgeLabel) badgeLabel.innerText = '🟢 Public Tier Active (60 req/min)';
+        if (activeBadge) activeBadge.className = 'self-start sm:self-auto inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-emerald-950/80 border border-emerald-800/60 text-emerald-300 text-xs font-semibold';
+        if (startBtn) startBtn.innerText = '🌸 Take Ju Jingyi Quiz & Unlock VIP Key (15 Questions)';
+        return;
+      }
+
+      if (verifyOnline) {
+        try {
+          const res = await fetch('/api/v1/health', {
+            headers: { 'X-API-Key': currentVipKey }
+          });
+          const json = await res.json();
+          if (!res.ok || json.data?.tier !== 'Developer VIP') {
+            currentVipKey = '';
+            if (display) display.classList.add('hidden');
+            if (badgeLabel) badgeLabel.innerText = '🟢 Public Tier Active (60 req/min)';
+            if (activeBadge) activeBadge.className = 'self-start sm:self-auto inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-emerald-950/80 border border-emerald-800/60 text-emerald-300 text-xs font-semibold';
+            if (startBtn) startBtn.innerText = '🌸 Take Ju Jingyi Quiz & Unlock VIP Key (15 Questions)';
+            return;
+          }
+        } catch {
+        
+        }
+      }
+
+      if (badgeLabel) badgeLabel.innerText = '👑 Developer VIP Tier Active (1,000 req/min)';
+      if (activeBadge) activeBadge.className = 'self-start sm:self-auto inline-flex items-center gap-1.5 px-3 py-1 rounded-full bg-amber-950/80 border border-amber-800/60 text-amber-300 text-xs font-bold';
+      if (startBtn) startBtn.innerText = '🌸 Retake Quiz (15/15 Passed)';
+      if (display) display.classList.remove('hidden');
+      if (keyVal) keyVal.innerText = currentVipKey;
+
+  
+      document.querySelectorAll('input[id^="key-ep-"]').forEach(inp => {
+        inp.value = currentVipKey;
+      });
+    }
+
+    function toggleAllEndpoints() {
+      allExpanded = !allExpanded;
+      if (typeof endpoints !== 'undefined') {
+        endpoints.forEach((group, gIdx) => {
+          group.items.forEach((_, iIdx) => {
+            const id = 'ep-' + gIdx + '-' + iIdx;
+            const el = document.getElementById(id);
+            const chev = document.getElementById('chev-' + id);
+            if (el) {
+              if (allExpanded) {
+                el.classList.remove('hidden');
+              } else {
+                el.classList.add('hidden');
+              }
+            }
+            if (chev) {
+              chev.style.transform = allExpanded ? 'rotate(180deg)' : 'rotate(0deg)';
+            }
+          });
+        });
+      }
+      const btnText = document.getElementById('toggle-all-text');
+      if (btnText) {
+        btnText.innerText = allExpanded ? '⚡ Collapse All Testers' : '⚡ Click to Test Live (Expand All)';
+      }
+    }
+
+    function toggleEndpoint(id) {
+      const el = document.getElementById(id);
+      const chev = document.getElementById('chev-' + id);
+      if (el) {
+        const isHidden = el.classList.toggle('hidden');
+        if (chev) {
+          chev.style.transform = isHidden ? 'rotate(0deg)' : 'rotate(180deg)';
+        }
+      }
+    }
+
+    async function executeLiveRequest(id, reqMethod) {
+      const input = document.getElementById('input-' + id);
+      const output = document.getElementById('output-' + id);
+      const status = document.getElementById('status-' + id);
+      const timing = document.getElementById('timing-' + id);
+      const keyInput = document.getElementById('key-' + id);
+      const bodyInput = document.getElementById('body-' + id);
+
+      if (!input || !output) return;
+
+      let path = input.value.trim();
+      if (!path.startsWith('/')) path = '/' + path;
+      const targetUrl = '/api/v1' + path;
+      const method = (reqMethod || 'GET').toUpperCase();
+      const userKey = (keyInput ? keyInput.value.trim() : '') || currentVipKey;
+
+
+      if (path === '/keys/generate' && !userKey) {
+        if (status) status.innerHTML = '<span class="text-amber-400 font-bold">⚠️ Key Required (401)</span>';
+        output.innerText = JSON.stringify({
+          status: "error",
+          code: 401,
+          message: "API Key is required to call /keys/generate.",
+          recommendation: "Please enter a valid key in the 'Header: X-API-Key' input above, or complete the Ju Jingyi 15-Question Quiz to claim your Developer VIP Key (1,000 req/min)!"
+        }, null, 2);
+        return;
+      }
+
+      if (path === '/keys/claim' && method === 'POST') {
+        let parsed = {};
+        try {
+          parsed = JSON.parse(bodyInput ? bodyInput.value.trim() : '{}');
+        } catch {
+          parsed = {};
+        }
+
+     
+        if (Array.isArray(userQuizAnswers) && userQuizAnswers.length === 15) {
+          bodyInput.value = JSON.stringify({ score: 15, answers: userQuizAnswers }, null, 2);
+        } else if (!parsed.score || parsed.score < 15 || !Array.isArray(parsed.answers) || parsed.answers.length < 15) {
+          if (status) status.innerHTML = '<span class="text-rose-400 font-bold">🌸 Quiz Required (403)</span>';
+          output.innerText = JSON.stringify({
+            status: "error",
+            code: 403,
+            message: "Quiz verification required. You must complete the 15-Question Ju Jingyi Trivia Challenge to claim a Developer VIP Key (1,000 req/min).",
+            recommendation: "Please click the '🌸 Launch 15-Question Quiz' button above or in the hero banner to start the quiz!"
+          }, null, 2);
+          return;
+        }
+      }
+
+      if (status) status.innerHTML = '<span class="text-amber-400 font-semibold">Sending ' + method + ' request...</span>';
+      output.innerText = 'Loading live data from ' + targetUrl + '...';
+      const startTime = performance.now();
+
+      try {
+        const headers = {};
+        if (userKey) {
+          headers['X-API-Key'] = userKey;
+        }
+
+        let bodyPayload = undefined;
+        if (method === 'POST') {
+          headers['Content-Type'] = 'application/json';
+          bodyPayload = bodyInput ? bodyInput.value.trim() : '{\\n  "score": 15,\\n  "answers": ["A","B","C","D","A","B","C","D","A","B","C","D","A","B","C"]\\n}';
+          if (!bodyPayload) bodyPayload = '{\\n  "score": 15,\\n  "answers": ["A","B","C","D","A","B","C","D","A","B","C","D","A","B","C"]\\n}';
+        }
+
+        const res = await fetch(targetUrl, {
+          method: method,
+          headers: headers,
+          body: bodyPayload
+        });
+
+        const elapsed = (performance.now() - startTime).toFixed(1);
+        const data = await res.json();
+
+        if (timing) timing.innerText = elapsed + ' ms';
+        if (status) {
+          const limitTier = res.headers.get('X-RateLimit-Tier') || (userKey ? 'Developer-VIP (1000/min)' : 'Public (60/min)');
+          if (res.ok) {
+            status.innerHTML = '<span class="text-emerald-400 font-bold">HTTP ' + res.status + ' OK</span> <span class="text-stone-400 font-mono text-[10px] ml-1">[' + limitTier + ']</span>';
+            if (path === '/keys/claim' && data.data?.apiKey) {
+              currentVipKey = data.data.apiKey;
+              updateVipUiState();
+            }
+          } else if (res.status === 401) {
+            status.innerHTML = '<span class="text-amber-400 font-bold">HTTP 401 Unauthorized</span> <span class="text-stone-400 text-[10px] ml-1">(API Key Required)</span>';
+          } else if (res.status === 403) {
+            status.innerHTML = '<span class="text-rose-400 font-bold">HTTP 403 Forbidden</span> <span class="text-stone-400 text-[10px] ml-1">(Quiz 15/15 Required)</span>';
+          } else {
+            status.innerHTML = '<span class="text-rose-400 font-bold">HTTP ' + res.status + ' ' + (res.statusText || '') + '</span>';
+          }
+        }
+
+        output.innerText = JSON.stringify(data, null, 2);
+      } catch (err) {
+        if (status) status.innerHTML = '<span class="text-rose-500 font-bold">Network Error</span>';
+        output.innerText = String(err);
+      }
+    }
+
+    window.toggleAllEndpoints = toggleAllEndpoints;
+    window.toggleEndpoint = toggleEndpoint;
+    window.executeLiveRequest = executeLiveRequest;
+    window.openQuizModal = openQuizModal;
+    window.closeQuizModal = closeQuizModal;
+    window.setQuizLang = setQuizLang;
+    window.handleSelectOption = handleSelectOption;
+    window.retryCurrentQuestion = retryCurrentQuestion;
+    window.copyVipKey = copyVipKey;
+    window.applyVipKeyToConsole = applyVipKeyToConsole;
+    window.showToast = showToast;
+
+    const endpoints = [
+      {
+        tag: "System, Stats & API Keys",
+        items: [
+          { method: "GET", path: "/health", desc: "API health, uptime, and database status (Public & VIP)", example: "/health" },
+          { method: "GET", path: "/stats", desc: "Platform statistical overview & catalog counts", example: "/stats" },
+          { method: "GET", path: "/quiz/challenge", desc: "Request one-time anti-cheat challenge token for VIP quiz", example: "/quiz/challenge" },
+          { method: "POST", path: "/keys/claim", desc: "Claim Developer VIP Key upon 15/15 quiz completion", example: "/keys/claim", defaultBody: '{\\n  "score": 15,\\n  "answers": ["A", "B", "C", "D", "A", "B", "C", "D", "A", "B", "C", "D", "A", "B", "C"]\\n}', requiresQuiz: true },
+          { method: "GET", path: "/keys/generate", desc: "Generate Developer API Key (Requires Master Key in X-API-Key)", example: "/keys/generate", requiresKey: true },
+          { method: "GET", path: "/openapi.json", desc: "Full OpenAPI 3.0.0 JSON Specification", example: "/openapi.json" }
+        ]
+      },
+      {
+        tag: "Profile & Fandom",
+        items: [
+          { method: "GET", path: "/profile", desc: "Complete biography, talents, physical profile, and social channels", example: "/profile" },
+          { method: "GET", path: "/fandom", desc: "Miju fan-community profile, official colors, and mottos", example: "/fandom" },
+          { method: "GET", path: "/quotes", desc: "Inspirational quotes and life philosophies by Ju Jingyi", example: "/quotes" }
+        ]
+      },
+      {
+        tag: "Filmography & Character Roles",
+        items: [
+          { method: "GET", path: "/works", desc: "Complete filmography with category, year, and search filters", example: "/works?category=historical-drama&year=2024" },
+          { method: "GET", path: "/works/:id", desc: "Single drama/movie details by ID", example: "/works/in-blossom" },
+          { method: "GET", path: "/character-roles", desc: "List of all iconic dramatic character roles portrayed", example: "/character-roles" }
+        ]
+      },
+      {
+        tag: "Music & Discography",
+        items: [
+          { method: "GET", path: "/discography", desc: "Deduplicated catalog of 45+ tracks sorted by year", example: "/discography?year=2026" },
+          { method: "GET", path: "/discography/:id", desc: "Single song details with duration and YouTube ID", example: "/discography/find-the-way" },
+          { method: "GET", path: "/mv", desc: "Official 4K music videos and live stage performances", example: "/mv?category=Stage-Performance" }
+        ]
+      },
+      {
+        tag: "Commercial & Career Chronicle",
+        items: [
+          { method: "GET", path: "/brands", desc: "Commercial endorsements and Global Ambassador brands", example: "/brands?isGlobal=true" },
+          { method: "GET", path: "/timeline", desc: "Career milestones from SNH48 debut (2013) to present (2026)", example: "/timeline?era=snh48" },
+          { method: "GET", path: "/awards", desc: "Honors, SNH48 election records, and acting accolades", example: "/awards" }
+        ]
+      },
+      {
+        tag: "Visual Gallery, Social & Search",
+        items: [
+          { method: "GET", path: "/gallery", desc: "High-resolution photos with category & limit filters", example: "/gallery?limit=6" },
+          { method: "GET", path: "/social", desc: "Douyin & Weibo official social media feed cards", example: "/social?platform=douyin" },
+          { method: "GET", path: "/search", desc: "Global fuzzy search across all 9 data categories", example: "/search?q=In+Blossom" }
+        ]
+      }
+    ];
+
+    function renderEndpointsList() {
+      const container = document.getElementById('endpoint-list');
+      if (!container) return;
+      let html = '';
+
+      endpoints.forEach((group, gIdx) => {
+        html += \`<div class="space-y-2 pt-2">
+          <h3 class="text-xs font-bold uppercase tracking-wider text-rose-700 dark:text-rose-300 flex items-center gap-1.5">
+            <span class="w-1.5 h-1.5 rounded-full bg-rose-500"></span>
+            \${group.tag}
+          </h3>
+          <div class="space-y-2">\`;
+
+        group.items.forEach((item, iIdx) => {
+          const id = \`ep-\${gIdx}-\${iIdx}\`;
+          const methodColor = item.method === 'POST' 
+            ? 'bg-amber-100 text-amber-900 border-amber-300 dark:bg-amber-950/80 dark:text-amber-300 dark:border-amber-800/50' 
+            : 'bg-emerald-100 text-emerald-800 border-emerald-300 dark:bg-emerald-950/80 dark:text-emerald-300 dark:border-emerald-800/50';
+
+          html += \`
+            <div class="rounded-2xl bg-white dark:bg-stone-900/90 border border-rose-200/80 dark:border-stone-800/80 hover:border-rose-400 dark:hover:border-rose-800/50 transition-all overflow-hidden shadow-xs">
+              <div class="p-3.5 sm:p-4 flex flex-col sm:flex-row items-start sm:items-center justify-between gap-3 cursor-pointer group" onclick="toggleEndpoint('\${id}')">
+                <div class="flex items-center gap-2.5 sm:gap-3 flex-wrap">
+                  <span class="px-2.5 py-1 rounded-lg font-mono text-xs font-bold border \${methodColor}">\${item.method}</span>
+                  <span class="font-mono text-stone-900 dark:text-rose-200 text-sm font-semibold group-hover:text-rose-600 dark:group-hover:text-rose-100 transition-colors">/api/v1\${item.path}</span>
+                  <span class="text-xs text-stone-600 dark:text-stone-400">\${item.desc}</span>
+                </div>
+                <div class="flex items-center gap-2 shrink-0 self-end sm:self-center">
+                  \${item.requiresKey ? '<span class="text-[10px] px-2 py-0.5 rounded bg-amber-100 dark:bg-amber-950/80 border border-amber-300 dark:border-amber-800/60 text-amber-900 dark:text-amber-300 font-mono">🔑 Key Required</span>' : ''}
+                  \${item.requiresQuiz ? '<span class="text-[10px] px-2 py-0.5 rounded bg-rose-100 dark:bg-rose-950/80 border border-rose-300 dark:border-rose-800/60 text-rose-800 dark:text-rose-300 font-mono">🌸 15/15 Quiz</span>' : ''}
+                  <button type="button" onclick="event.stopPropagation(); toggleEndpoint('\${id}')" class="px-3 py-1 rounded-full bg-rose-50 hover:bg-rose-100 dark:bg-rose-950/60 dark:hover:bg-rose-900/60 border border-rose-200 dark:border-rose-800/50 text-xs font-semibold text-rose-700 dark:text-rose-300 hover:text-rose-950 dark:hover:text-white transition-all cursor-pointer">
+                    Try Live ⚡
+                  </button>
+                  <svg id="chev-\${id}" class="w-4 h-4 text-stone-400 dark:text-stone-500 transition-transform duration-200" fill="none" stroke="currentColor" viewBox="0 0 24 24">
+                    <path stroke-linecap="round" stroke-linejoin="round" stroke-width="2" d="M19 9l-7 7-7-7"></path>
+                  </svg>
+                </div>
+              </div>
+
+              <div id="\${id}" class="hidden border-t border-rose-200/80 dark:border-stone-800/80 bg-stone-50/70 dark:bg-stone-950/80 p-4 space-y-3">
+                <div class="flex flex-col sm:flex-row items-stretch sm:items-center gap-2">
+                  <div class="flex-1 flex items-center rounded-xl bg-white dark:bg-stone-900/90 border border-stone-300 dark:border-stone-700 px-3 py-2 shadow-xs">
+                    <span class="text-xs font-mono font-bold \${item.method === 'POST' ? 'text-amber-600 dark:text-amber-400' : 'text-emerald-600 dark:text-emerald-400'} mr-2 select-none">\${item.method} /api/v1</span>
+                    <input type="text" id="input-\${id}" value="\${item.example}" onkeydown="if(event.key==='Enter') executeLiveRequest('\${id}', '\${item.method}')" class="bg-transparent font-mono text-xs text-stone-900 dark:text-white focus:outline-none w-full" />
+                  </div>
+                  <button type="button" onclick="executeLiveRequest('\${id}', '\${item.method}')" class="px-4 py-2 rounded-xl bg-gradient-to-r from-rose-600 to-pink-600 hover:from-rose-500 hover:to-pink-500 font-bold text-xs text-white shadow-md shadow-rose-600/30 active:scale-95 transition-all shrink-0 cursor-pointer">
+                    Send Request
+                  </button>
+                </div>
+
+                <div class="flex flex-col sm:flex-row items-stretch sm:items-center gap-2 text-xs">
+                  <div class="flex-1 flex items-center rounded-xl bg-white dark:bg-stone-900/60 border border-stone-300 dark:border-stone-800 px-3 py-1.5 shadow-2xs">
+                    <span class="text-[11px] font-mono text-stone-500 dark:text-stone-400 mr-2 select-none shrink-0">Header: X-API-Key</span>
+                    <input type="text" id="key-\${id}" value="\${currentVipKey || ''}" placeholder="Optional (Leave empty for Public Tier 60/min, or provide VIP Key for 1,000/min)" class="bg-transparent font-mono text-xs text-amber-700 dark:text-amber-300 focus:outline-none w-full placeholder:text-stone-400 dark:placeholder:text-stone-600" />
+                  </div>
+                  \${item.requiresKey ? \`
+                    <div class="flex items-center gap-1.5 shrink-0">
+                      <span class="text-[11px] text-amber-700 dark:text-amber-300 font-mono font-bold">🔑 Protected</span>
+                      <button type="button" onclick="openQuizModal()" class="px-2.5 py-1 rounded-lg bg-gradient-to-r from-rose-600 to-amber-500 text-white font-bold text-[11px] shadow-xs hover:opacity-90 transition-opacity cursor-pointer">
+                        🌸 Unlock VIP Key
+                      </button>
+                    </div>
+                  \` : ''}
+                  \${item.requiresQuiz ? \`
+                    <button type="button" onclick="openQuizModal()" class="px-2.5 py-1.5 rounded-lg bg-rose-600 hover:bg-rose-500 dark:bg-rose-900/60 dark:hover:bg-rose-800/80 border border-rose-500 dark:border-rose-700/60 text-white dark:text-rose-200 text-xs font-bold shrink-0 transition-colors cursor-pointer">
+                      🌸 Launch 15-Question Quiz
+                    </button>
+                  \` : ''}
+                </div>
+
+                \${item.method === 'POST' ? \`
+                  <div class="space-y-1">
+                    <div class="flex items-center justify-between text-[11px] text-stone-600 dark:text-stone-400">
+                      <span>Request Payload (JSON Body):</span>
+                      <span class="text-[10px] font-mono text-stone-500">Content-Type: application/json</span>
+                    </div>
+                    <textarea id="body-\${id}" rows="2" class="w-full p-2.5 rounded-xl bg-stone-900 border border-stone-700 font-mono text-xs text-emerald-300 focus:outline-none focus:border-rose-500 transition-colors">\${item.defaultBody || '{\\n  "score": 15\\n}'}</textarea>
+                  </div>
+                \` : ''}
+
+                <div class="space-y-1.5 pt-1">
+                  <div class="flex items-center justify-between text-[11px] text-stone-600 dark:text-stone-400">
+                    <span id="status-\${id}">Ready</span>
+                    <span id="timing-\${id}" class="font-mono text-stone-500 dark:text-stone-400"></span>
+                  </div>
+                  <pre id="output-\${id}" class="p-3.5 rounded-xl bg-[#0c0814] border border-stone-800 text-[11px] font-mono text-stone-200 overflow-x-auto max-h-64 shadow-inner">Click "Send Request" to test live...</pre>
+                </div>
+              </div>
+            </div>
+          \`;
+        });
+
+        html += \`</div></div>\`;
+      });
+
+      container.innerHTML = html;
+    }
+
+    if (document.readyState === 'loading') {
+      document.addEventListener('DOMContentLoaded', () => {
+        updateThemeIcons();
+        renderEndpointsList();
+        updateVipUiState(true);
+      });
+    } else {
+      updateThemeIcons();
+      renderEndpointsList();
+      updateVipUiState(true);
+    }
+  </script>
+</body>
+</html>`;
+}
+
+function safeDecode(str) {
+  if (!str) return '';
+  try {
+    return decodeURIComponent(str);
+  } catch {
+    return str;
+  }
+}
+
+export async function handleApiRequest(req, res, next) {
+  const trustProxy = process.env.VERCEL === '1' || process.env.KIKU_TRUST_PROXY === 'true';
+  const rawHost = trustProxy ? (req.headers['x-forwarded-host'] || req.headers.host) : req.headers.host;
+  const hostCandidate = String(rawHost || '').split(',')[0].trim();
+  const host = /^[a-z0-9.-]+(?::\d{1,5})?$/i.test(hostCandidate)
+    ? hostCandidate
+    : 'jujingyi-kikuuu.vercel.app';
+  const isLocal = host.includes('localhost') || host.includes('127.0.0.1') || host.endsWith('.local');
+  const forwardedProtocol = trustProxy ? String(req.headers['x-forwarded-proto'] || '').split(',')[0].trim() : '';
+  const protocol = ['http', 'https'].includes(forwardedProtocol) ? forwardedProtocol : (isLocal ? 'http' : 'https');
+  const baseUrl = `${protocol}://${host}`;
+  const { isConfigured: isSupabaseConfigured } = getSupabaseConfig();
+
+  const rawPath = req.url || req.headers['x-matched-path'] || '/';
+  const urlObj = new URL(rawPath, baseUrl);
+  let pathname = urlObj.pathname;
+
+  if (pathname === '/api/api-docs' || pathname === '/api/api-docs/') {
+    pathname = '/api-docs';
+  }
+  if (pathname.length > 1 && pathname.endsWith('/')) {
+    pathname = pathname.slice(0, -1);
+  }
+
+  if (pathname === '/api-docs') {
+    res.statusCode = 200;
+    res.setHeader('Content-Type', 'text/html; charset=utf-8');
+    res.setHeader('Cache-Control', 'no-cache');
+    applySecurityHeaders(res, true);
+    res.end(renderApiDocsHtml());
+    return;
+  }
+
+  if (pathname === '/api/v1/openapi.json' || pathname === '/api/v1/swagger.json') {
+    return sendJson(res, 200, getOpenApiSpec(baseUrl));
+  }
+
+  if (!pathname.startsWith('/api/v1') && pathname !== '/api' && !pathname.startsWith('/mcp')) {
+    if (next) return next();
+    return;
+  }
+
+  if (req.method === 'OPTIONS') {
+    res.statusCode = 204;
+    applySecurityHeaders(res, false);
+    res.end();
+    return;
+  }
+
+  const clientIp = resolveClientIp(req);
+  const searchParams = urlObj.searchParams;
+  const apiKey = extractApiKey(req);
+  const validKeyInfo = apiKey ? await validateApiKey(apiKey) : null;
+  const hasValidApiKey = Boolean(validKeyInfo);
+  const hasAgentExecutionAccess = Boolean(apiKey && (isMasterKey(apiKey) || agentExecutionKeys.has(apiKey.trim())));
+
+  const baseRateLimit = validKeyInfo?.rateLimit || (hasValidApiKey ? RATE_LIMIT_API_KEY : RATE_LIMIT_ANONYMOUS);
+  const parsedTestLimit = Number.parseInt(searchParams.get('testRateLimit') || '', 10);
+  const hasTestRateLimit = Number.isInteger(parsedTestLimit) && parsedTestLimit > 0;
+  const maxLimit = hasTestRateLimit ? Math.min(parsedTestLimit, baseRateLimit) : baseRateLimit;
+  const baseClientIdentifier = hasValidApiKey ? `key:${hashApiKey(apiKey)}` : `ip:${clientIp}`;
+  const clientIdentifier = hasTestRateLimit
+    ? `${baseClientIdentifier}:test:${maxLimit}`
+    : baseClientIdentifier;
+  const rateInfo = await checkDistributedRateLimit(clientIdentifier, maxLimit);
+
+  const keyTierLabel = validKeyInfo?.tier || (hasValidApiKey ? 'Developer-VIP' : 'Public-Anonymous');
+  const rateHeaders = {
+    'X-RateLimit-Limit': String(rateInfo.limit),
+    'X-RateLimit-Remaining': String(rateInfo.remaining),
+    'X-RateLimit-Reset': String(rateInfo.reset),
+    'X-RateLimit-Tier': `${keyTierLabel} (${rateInfo.limit}/min)`
+  };
+
+  if (!rateInfo.allowed) {
+    rateHeaders['Retry-After'] = String(rateInfo.retryAfter);
+    return sendJson(res, 429, {
+      status: 'error',
+      code: 429,
+      timestamp: new Date().toISOString(),
+      message: `Too Many Requests. Rate limit of ${rateInfo.limit} requests/minute exceeded.`,
+      retryAfterSeconds: rateInfo.retryAfter
+    }, rateHeaders);
+  }
+
+  const timestamp = new Date().toISOString();
+
+  if (pathname === '/api/v1/health' || pathname === '/api/v1') {
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        apiName: 'Ju Jingyi Official Chronicle REST API',
+        version: `v${PACKAGE_VERSION}`,
+        status: 'operational',
+        environment: isLocal ? 'local-development' : 'production',
+        isLocal,
+        database: isSupabaseConfigured ? 'supabase-postgresql (connected)' : 'in-memory (standalone)',
+        supabaseConfigured: isSupabaseConfigured,
+        currentHost: host,
+        uptimeSeconds: Math.floor(process.uptime()),
+        endpointsCount: 19,
+        tier: hasValidApiKey ? keyTierLabel : 'Public',
+        baseUrl: `${baseUrl}/api/v1`,
+        documentation: `${baseUrl}/api-docs`,
+        openApiSpec: `${baseUrl}/api/v1/openapi.json`,
+        availableServers: [
+          {
+            url: `${baseUrl}/api/v1`,
+            description: isLocal ? 'Active Localhost (Auto-detected)' : 'Active Production (Auto-detected)'
+          },
+          {
+            url: 'https://jujingyi-kikuuu.vercel.app/api/v1',
+            description: 'Production Vercel Cloud CDN'
+          },
+          {
+            url: 'http://localhost:3000/api/v1',
+            description: 'Local Node.js Dev Server'
+          }
+        ]
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/quiz/challenge') {
+    const session = createQuizChallengeToken();
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        challengeToken: session.challengeToken,
+        expiresAt: session.expiresAt,
+        totalQuestions: 15,
+        targetTier: 'Developer VIP Tier (1,000 req/min)',
+        usage: "Send this challengeToken along with your 15 completed quiz answers to POST /api/v1/keys/claim"
+      }
+    }, { ...rateHeaders, 'Cache-Control': 'no-store', Pragma: 'no-cache' });
+  }
+
+  if (pathname === '/api/v1/keys/generate') {
+    const adminKey = extractApiKey(req);
+    const adminKeyValid = adminKey ? await validateApiKey(adminKey) : null;
+    const isAuthorized = isMasterKey(adminKey) || (adminKeyValid && adminKeyValid.tier === 'Master VIP');
+    if (!adminKey || !adminKeyValid || !isAuthorized) {
+      return sendJson(res, 401, {
+        status: 'error',
+        code: 401,
+        timestamp,
+        message: 'Unauthorized. Admin/Master API Key required in X-API-Key header to generate new developer keys.'
+      }, rateHeaders);
+    }
+    const token = crypto.randomBytes(16).toString('hex');
+    const newKey = `kiku_dev_sk_${token}`;
+    await saveApiKeyToSupabase({ apiKey: newKey, tier: 'developer', rateLimit: 1000 });
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        apiKey: newKey,
+        tier: 'Developer Tier (1,000 requests / minute)',
+        rateLimit: 1000,
+        storage: isSupabaseConfigured ? 'supabase-postgresql (persistent)' : 'in-memory (standalone)',
+        usageInstruction: "Attach header 'X-API-Key: <your_key>' or 'Authorization: Bearer <your_key>'"
+      }
+    }, { ...rateHeaders, 'Cache-Control': 'no-store', Pragma: 'no-cache' });
+  }
+
+  if (pathname === '/api/v1/keys/claim') {
+    if (req.method !== 'POST') {
+      return sendJson(res, 405, {
+        status: 'error',
+        code: 405,
+        timestamp,
+        message: 'Method Not Allowed. Use POST to claim Developer VIP Key with verified quiz answers.'
+      }, rateHeaders);
+    }
+
+    let body = {};
+    try {
+      body = await parseJsonBody(req);
+    } catch {
+      body = {};
+    }
+
+    if (!body.challengeToken) {
+      return sendJson(res, 403, {
+        status: 'error',
+        code: 403,
+        timestamp,
+        message: 'Quiz challenge token is required. Please complete the quiz flow from the beginning.'
+      }, rateHeaders);
+    }
+
+    if (!verifyQuizChallengeToken(body.challengeToken)) {
+      return sendJson(res, 403, {
+        status: 'error',
+        code: 403,
+        timestamp,
+        message: 'Invalid, expired, or already claimed quiz challenge token. Please launch the quiz again to obtain a fresh challenge session.'
+      }, rateHeaders);
+    }
+
+    const answers = Array.isArray(body.answers) ? body.answers : [];
+
+    if (!verifyQuizAnswers(answers)) {
+      return sendJson(res, 403, {
+        status: 'error',
+        code: 403,
+        timestamp,
+        message: 'Quiz verification failed. All 15 answers must be correct to claim a Developer VIP Key. Please try again.'
+      }, rateHeaders);
+    }
+
+    consumeQuizChallengeToken(body.challengeToken);
+
+    const token = crypto.randomBytes(16).toString('hex');
+    const newVipKey = `kiku_vip_sk_${token}`;
+    await saveApiKeyToSupabase({ apiKey: newVipKey, tier: 'developer_vip', rateLimit: 1000 });
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        apiKey: newVipKey,
+        tier: 'Developer VIP Tier',
+        rateLimit: 1000,
+        quota: '1,000 requests / minute',
+        status: 'unlocked',
+        storage: isSupabaseConfigured ? 'supabase-postgresql (persistent)' : 'in-memory (standalone)',
+        achievement: 'Ju Jingyi Miju Master (15/15 Perfect Score 🌸)',
+        usageInstruction: "Attach header 'X-API-Key: <your_key>' or 'Authorization: Bearer <your_key>'"
+      }
+    }, { ...rateHeaders, 'Cache-Control': 'no-store', Pragma: 'no-cache' });
+  }
+
+  if (pathname === '/api/v1/stats') {
+    const cleanSongs = getCleanDiscography();
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        totalWorks: worksData.length,
+        historicalDramas: worksData.filter(w => w.category === 'historical-drama').length,
+        modernDramas: worksData.filter(w => w.category === 'modern-drama').length,
+        movies: worksData.filter(w => w.category === 'movie').length,
+        totalSongs: cleanSongs.length,
+        latest2026Releases: cleanSongs.filter(s => s.year === 2026).length,
+        ostTracks: discographyData.ostList.length,
+        singles: discographyData.singles.length,
+        officialMusicVideos: musicVideoData.length,
+        brandEndorsements: brandsData.brandList.length,
+        globalBrandAmbassadorCount: brandsData.brandList.filter(b => b.isGlobal).length,
+        careerMilestones: timelineData.length,
+        honorsAndAwards: awardsData.length,
+        galleryPhotos: galleryData.length,
+        socialFollowers: "21.9M+ (Douyin) & 20M+ (Weibo)"
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/profile') {
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: profileData
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/fandom') {
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        fandomNameTh: "มี่จวี (Miju)",
+        fandomNameCn: "蜜橘",
+        fandomColors: [
+          { nameTh: "ฟ้าคริสตัล (Crystal Sky Blue)", hex: "#58B2DC" },
+          { nameTh: "ชมพูซากุระ (Sakura Pink)", hex: "#FAD2E1" },
+          { nameTh: "ทองหรูหรา (Imperial Gold)", hex: "#D4AF37" }
+        ],
+        sloganTh: "保持热爱，奔赴山海 (รักษาความรักและมุ่งหน้าไปสู่ขุนเขาและท้องทะเล)",
+        officialAnniversary: "2 พฤศจิกายน 2013 (SNH48 Debut)",
+        supportGuidelines: "สนับสนุนผลงานอย่างสร้างสรรค์ เคารพสิทธิส่วนบุคคล และร่วมทำกิจกรรมการกุศลในนามศิลปิน"
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/quotes') {
+    const quotes = [
+      {
+        quoteOriginal: "过去的事情，就让它过去吧，我们要往前看。",
+        quoteTh: "เรื่องที่ผ่านไปแล้ว ก็ปล่อยให้มันผ่านไป สิ่งที่เราต้องทำคือมองไปข้างหน้า",
+        quoteEn: "Let what has passed remain in the past; what we must do is look forward.",
+        context: "ปรัชญาการทำงานและการก้าวผ่านอุปสรรค"
+      },
+      {
+        quoteOriginal: "只要全力以赴，就不会留下遗憾。",
+        quoteTh: "ตราบใดที่เราทุ่มเทจนสุดความสามารถ ก็จะไม่มีคำว่าเสียใจภายหลัง",
+        quoteEn: "As long as you give it your all, there will be no regrets.",
+        context: "การเตรียมตัวสำหรับการแสดงและเวทีคอนเสิร์ต"
+      },
+      {
+        quoteOriginal: "音乐和演戏是我生命中不可或缺的一部分。",
+        quoteTh: "ดนตรีและการแสดง คือส่วนหนึ่งของชีวิตที่ไม่สามารถขาดไปได้",
+        quoteEn: "Music and acting are indispensable parts of my life.",
+        context: "ความหลงใหลในศิลปะการแสดง"
+      }
+    ];
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: quotes,
+      meta: { total: quotes.length }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/character-roles') {
+    const characterRoles = worksData.map(w => ({
+      workId: w.id,
+      workTitleTh: w.titleTh,
+      workTitleCn: w.titleCn,
+      workYear: w.year,
+      characterName: w.role,
+      characterType: w.roleType,
+      characterDescription: w.roleDescription,
+      dramaCategory: w.category,
+      poster: w.poster
+    }));
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: characterRoles,
+      meta: { total: characterRoles.length }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/timeline') {
+    const year = sanitizeSearchQuery(searchParams.get('year') || '', 20);
+    const era = sanitizeSearchQuery(searchParams.get('era') || '', 50).toLowerCase();
+    const category = sanitizeSearchQuery(searchParams.get('category') || '', 50).toLowerCase();
+    const search = sanitizeSearchQuery(searchParams.get('search') || searchParams.get('q') || '', 100).toLowerCase();
+
+    let list = [...timelineData];
+    if (year && year !== 'all') {
+      list = list.filter(t => t.year === year || String(t.year).includes(year));
+    }
+    if (era && era !== 'all') {
+      list = list.filter(t => t.era && t.era.toLowerCase().includes(era));
+    }
+    if (category && category !== 'all') {
+      list = list.filter(t => t.category && t.category.toLowerCase().includes(category));
+    }
+    if (search) {
+      list = list.filter(t =>
+        (t.title && t.title.toLowerCase().includes(search)) ||
+        (t.titleCn && t.titleCn.includes(search)) ||
+        (t.summary && t.summary.toLowerCase().includes(search)) ||
+        (t.badge && t.badge.toLowerCase().includes(search))
+      );
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: list,
+      meta: {
+        totalMilestones: timelineData.length,
+        filteredCount: list.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/agent/query' || pathname === '/api/v1/chat') {
+    if (!hasValidApiKey || !hasAgentExecutionAccess) {
+      return sendJson(res, 401, {
+        status: 'error', code: 401, timestamp,
+        message: 'An agent-execution API key is required for model execution.'
+      }, rateHeaders);
+    }
+    const body = req.method === 'POST' ? await parseJsonBody(req) : {};
+    const rawQuery = body.query || body.prompt || searchParams.get('q') || searchParams.get('query') || '';
+    const query = sanitizeSearchQuery(rawQuery, 2000);
+    if (!query) {
+      return sendJson(res, 400, {
+        status: 'error',
+        code: 400,
+        timestamp,
+        message: "Missing 'query' or 'q' field."
+      }, rateHeaders);
+    }
+
+    try {
+      const { getSharedAgent } = await import('./routes/agent.js');
+      const provider = sanitizeSearchQuery(body.provider || 'lmstudio', 40).toLowerCase();
+      const providerApiKey = extractProviderApiKey(req);
+      if (provider !== 'lmstudio' && !providerApiKey) {
+        return sendJson(res, 401, {
+          status: 'error', code: 401, timestamp,
+          message: 'X-Provider-API-Key is required for cloud model providers.'
+        }, rateHeaders);
+      }
+      const agent = getSharedAgent({
+        provider,
+        model: sanitizeSearchQuery(body.model || '', 160) || undefined,
+        apiKey: providerApiKey || undefined,
+      });
+      await agent.ready();
+      let collectedAnswer = '';
+      await agent.ask(query, {
+        onFinalAnswer: (answer) => { collectedAnswer = answer; }
+      });
+      return sendJson(res, 200, {
+        status: 'success',
+        code: 200,
+        timestamp,
+        query,
+        answer: collectedAnswer || 'No response generated.'
+      }, rateHeaders);
+    } catch (err) {
+      console.error('[Agent API Error]:', err);
+      return sendJson(res, 500, {
+        status: 'error',
+        code: 500,
+        timestamp,
+        message: safeErrorMessage(err, 'Agent execution failed')
+      }, rateHeaders);
+    }
+  }
+
+  if (pathname === '/api/v1/agent/chat' || pathname === '/api/v1/chat/stream') {
+    if (!hasValidApiKey || !hasAgentExecutionAccess) {
+      return sendJson(res, 401, {
+        status: 'error', code: 401, timestamp,
+        message: 'An agent-execution API key is required for model execution.'
+      }, rateHeaders);
+    }
+    const rawQ = searchParams.get('q') || searchParams.get('query') || '';
+    const q = sanitizeSearchQuery(rawQ, 2000);
+    if (!q) {
+      return sendJson(res, 400, {
+        status: 'error',
+        code: 400,
+        timestamp,
+        message: "Missing 'q' or 'query' parameter for agent chat stream."
+      }, rateHeaders);
+    }
+    const provider = sanitizeSearchQuery(searchParams.get('provider') || 'lmstudio', 40).toLowerCase();
+    const providerApiKey = extractProviderApiKey(req);
+    if (provider !== 'lmstudio' && !providerApiKey) {
+      return sendJson(res, 401, {
+        status: 'error', code: 401, timestamp,
+        message: 'X-Provider-API-Key is required for cloud model providers.'
+      }, rateHeaders);
+    }
+    const { handleAgentChatStream } = await import('./routes/agent.js');
+    return handleAgentChatStream(req, res, q, {
+      provider,
+      model: sanitizeSearchQuery(searchParams.get('model') || '', 160) || undefined,
+      apiKey: providerApiKey || undefined,
+    });
+  }
+
+  if (pathname === '/api/v1/debate') {
+    if (!hasValidApiKey || !hasAgentExecutionAccess) {
+      return sendJson(res, 401, {
+        status: 'error', code: 401, timestamp,
+        message: 'An agent-execution API key is required for debate execution.'
+      }, rateHeaders);
+    }
+    const body = req.method === 'POST' ? await parseJsonBody(req) : {};
+    const rawTopic = body.topic || body.claim || searchParams.get('topic') || searchParams.get('claim') || searchParams.get('q') || '';
+    const topic = sanitizeSearchQuery(rawTopic, 500);
+    if (!topic) {
+      return sendJson(res, 400, {
+        status: 'error',
+        code: 400,
+        timestamp,
+        message: "Missing 'topic' or 'claim' parameter for debate."
+      }, rateHeaders);
+    }
+
+    try {
+      const { DebateOrchestrator } = await import('./agent/debate.js');
+      const { getSharedAgent } = await import('./routes/agent.js');
+      const agent = getSharedAgent();
+      const orchestrator = new DebateOrchestrator({
+        client: agent.client || agent.llmClient,
+        executeTool: (name, args) => agent.executeTool(name, args)
+      });
+      const debateResult = await orchestrator.run(topic);
+      return sendJson(res, 200, {
+        status: 'success',
+        code: 200,
+        timestamp,
+        data: debateResult
+      }, rateHeaders);
+    } catch (err) {
+      console.error('[Debate API Error]:', err);
+      return sendJson(res, 500, {
+        status: 'error',
+        code: 500,
+        timestamp,
+        message: safeErrorMessage(err, 'Debate execution failed')
+      }, rateHeaders);
+    }
+  }
+
+  if (pathname === '/api/v1/works' || pathname === '/api/v1/dramas') {
+    let results = [...worksData];
+    const category = sanitizeSearchQuery(searchParams.get('category') || '', 50);
+    const year = sanitizeSearchQuery(searchParams.get('year') || '', 20);
+    const search = sanitizeSearchQuery(searchParams.get('search') || '', 100);
+
+    if (category && category !== 'all') {
+      results = results.filter(w => w.category === category);
+    }
+    if (year) {
+      results = results.filter(w => String(w.year) === String(year));
+    }
+    if (search) {
+      const q = search.toLowerCase();
+      results = results.filter(w => 
+        w.titleTh.toLowerCase().includes(q) || 
+        w.titleCn.includes(q) || 
+        w.titleEn.toLowerCase().includes(q) || 
+        w.role.toLowerCase().includes(q)
+      );
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: results,
+      meta: {
+        total: worksData.length,
+        count: results.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname.startsWith('/api/v1/works/') || pathname.startsWith('/api/v1/dramas/')) {
+    const rawId = pathname.replace(/^\/api\/v1\/(works|dramas)\//, '').trim();
+    const id = safeDecode(rawId);
+    const work = worksData.find(w => String(w.id) === id || String(w.id) === rawId || w.titleCn === id);
+    
+    if (!work) {
+      return sendJson(res, 404, {
+        status: 'error',
+        code: 404,
+        timestamp,
+        message: `Work with identifier '${id}' was not found.`
+      }, rateHeaders);
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: work
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/discography') {
+    let cleanSongs = getCleanDiscography();
+    const type = sanitizeSearchQuery(searchParams.get('type') || '', 50);
+    const year = sanitizeSearchQuery(searchParams.get('year') || '', 20);
+    const search = sanitizeSearchQuery(searchParams.get('search') || '', 100);
+
+    if (type === 'latest') {
+      cleanSongs = cleanSongs.filter(s => s.catalogTypes.includes('latest'));
+    } else if (type === 'ost') {
+      cleanSongs = cleanSongs.filter(s => s.catalogTypes.includes('ost'));
+    } else if (type === 'singles') {
+      cleanSongs = cleanSongs.filter(s => s.catalogTypes.includes('singles'));
+    }
+
+    if (year) {
+      cleanSongs = cleanSongs.filter(s => String(s.year) === String(year));
+    }
+
+    if (search) {
+      const q = search.toLowerCase();
+      cleanSongs = cleanSongs.filter(s => 
+        (s.titleTh && s.titleTh.toLowerCase().includes(q)) || 
+        (s.titleCn && s.titleCn.includes(q)) || 
+        (s.titleEn && s.titleEn.toLowerCase().includes(q))
+      );
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: cleanSongs,
+      meta: {
+        totalUniqueTracks: getCleanDiscography().length,
+        count: cleanSongs.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname.startsWith('/api/v1/discography/')) {
+    const rawId = pathname.replace('/api/v1/discography/', '').trim();
+    const id = safeDecode(rawId);
+    const cleanSongs = getCleanDiscography();
+    const song = cleanSongs.find(s => 
+      String(s.id) === id || 
+      String(s.id) === rawId ||
+      String(s.id).replace(/^(single|ost)-/, '') === id ||
+      String(s.id).replace(/^(single|ost)-/, '') === rawId ||
+      s.titleCn === id || 
+      (s.titleEn && s.titleEn.toLowerCase().replace(/\s+/g, '-') === id.toLowerCase()) ||
+      (s.titleTh && s.titleTh.toLowerCase().replace(/\s+/g, '-') === id.toLowerCase())
+    );
+
+    if (!song) {
+      return sendJson(res, 404, {
+        status: 'error',
+        code: 404,
+        timestamp,
+        message: `Track with identifier '${id}' was not found in discography.`
+      }, rateHeaders);
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: song
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/mv') {
+    let results = [...musicVideoData];
+    const category = sanitizeSearchQuery(searchParams.get('category') || '', 50);
+
+    if (category && category !== 'all') {
+      results = results.filter(v => v.category === category);
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: results,
+      meta: {
+        total: musicVideoData.length,
+        count: results.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/brands') {
+    let results = [...brandsData.brandList];
+    const isGlobal = searchParams.get('isGlobal');
+
+    if (isGlobal !== null && isGlobal !== undefined) {
+      const globalBool = isGlobal === 'true';
+      results = results.filter(b => b.isGlobal === globalBool);
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: results,
+      meta: {
+        total: brandsData.brandList.length,
+        count: results.length,
+        summary: brandsData.commercialHighlights
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/gallery') {
+    let results = [...galleryData];
+    const category = sanitizeSearchQuery(searchParams.get('category') || '', 50);
+    const limit = parseInt(searchParams.get('limit') || '0', 10);
+
+    if (category && category !== 'all') {
+      results = results.filter(g => g.category === category);
+    }
+    if (limit > 0) {
+      results = results.slice(0, limit);
+    }
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: results,
+      meta: {
+        total: galleryData.length,
+        count: results.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/awards') {
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: awardsData,
+      meta: {
+        total: awardsData.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/social/douyin/embed') {
+    const rawItemId = searchParams.get('itemId') || searchParams.get('id') || '7384920194819283921';
+    const itemId = sanitizeSearchQuery(rawItemId, 50);
+    const iframeHtml = `<iframe src="https://www.iesdouyin.com/share/video/${escapeHtml(itemId)}/" width="100%" height="100%" frameborder="0" allowfullscreen="true" allow="autoplay; fullscreen"></iframe>`;
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        platform: 'Douyin (抖音)',
+        itemId,
+        iframeSrc: `https://www.iesdouyin.com/share/video/${itemId}/`,
+        iframeHtml,
+        shareUrl: `https://www.iesdouyin.com/share/video/${itemId}/`,
+        openApiStandard: {
+          docUrl: 'https://developer.open-douyin.com/docs/resource/zh-CN/dop/develop/openapi/video-management/douyin/iframe-player/get-iframe-by-video',
+          endpoint: 'https://open.douyin.com/api/douyin/v1/video/get_iframe_by_video'
+        }
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/social/weibo/live') {
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        platform: 'Sina Weibo (新浪微博)',
+        account: '鞠婧祎 (Ju Jingyi)',
+        uid: '3669102477',
+        containerId: '1076033669102477',
+        status: 'synced',
+        feedEndpoint: 'https://m.weibo.cn/api/container/getIndex?type=uid&value=3669102477&containerid=1076033669102477',
+        cards: socialUpdatesData.weibo.cards,
+        openApiStandard: {
+          officialDoc: 'https://open.weibo.com/wiki/2/statuses/user_timeline',
+          officialEndpoint: 'https://api.weibo.com/2/statuses/user_timeline.json',
+          cdnHosts: ['https://sinaimg.cn', 'https://wx1.sinaimg.cn', 'https://wx2.sinaimg.cn', 'https://wx3.sinaimg.cn', 'https://wx4.sinaimg.cn']
+        }
+      },
+      meta: {
+        isLiveSynced: true,
+        source: 'hybrid-live-verified'
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/social') {
+    const platform = sanitizeSearchQuery(searchParams.get('platform') || '', 50);
+    const days = parseInt(searchParams.get('days') || '14', 10);
+    
+    let results = {
+      douyin: socialUpdatesData.douyin,
+      weibo: socialUpdatesData.weibo
+    };
+
+    if (platform === 'douyin') {
+      results = results.douyin;
+    } else if (platform === 'weibo') {
+      results = results.weibo;
+    }
+
+    const allCards = [
+      ...(results.douyin?.cards || []),
+      ...(results.weibo?.cards || [])
+    ];
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: results,
+      meta: {
+        totalCards: allCards.length,
+        douyinCards: results.douyin?.cards?.length || 0,
+        weiboCards: results.weibo?.cards?.length || 0,
+        timeWindowDays: days,
+        storageSource: 'manual_data',
+        endpoints: {
+          douyinEmbed: `${baseUrl}/api/v1/social/douyin/embed?itemId=7384920194819283921`,
+          weiboLive: `${baseUrl}/api/v1/social/weibo/live`
+        }
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/api/v1/search') {
+    const rawQ = searchParams.get('q') || searchParams.get('query') || '';
+    const q = sanitizeSearchQuery(rawQ, 100).toLowerCase();
+    if (!q) {
+      return sendJson(res, 400, {
+        status: 'error',
+        code: 400,
+        timestamp,
+        message: "Missing query parameter 'q'. Example: /api/v1/search?q=In+Blossom"
+      }, rateHeaders);
+    }
+
+    const matchedWorks = worksData.filter(w => 
+      (w.titleTh && w.titleTh.toLowerCase().includes(q)) || 
+      (w.titleCn && w.titleCn.includes(q)) || 
+      (w.titleEn && w.titleEn.toLowerCase().includes(q)) || 
+      (w.role && w.role.toLowerCase().includes(q)) ||
+      (w.year && String(w.year).includes(q))
+    );
+
+    const cleanSongs = getCleanDiscography();
+    const matchedSongs = cleanSongs.filter(s => 
+      (s.titleTh && s.titleTh.toLowerCase().includes(q)) || 
+      (s.titleCn && s.titleCn.includes(q)) || 
+      (s.titleEn && s.titleEn.toLowerCase().includes(q)) || 
+      (s.work && s.work.toLowerCase().includes(q)) ||
+      (s.year && String(s.year).includes(q))
+    );
+
+    const matchedVideos = musicVideoData.filter(v => 
+      (v.titleTh && v.titleTh.toLowerCase().includes(q)) || 
+      (v.titleCn && v.titleCn.includes(q)) || 
+      (v.titleEn && v.titleEn.toLowerCase().includes(q)) || 
+      (v.description && v.description.toLowerCase().includes(q))
+    );
+
+    const matchedTimeline = timelineData.filter(t => 
+      (t.title && t.title.toLowerCase().includes(q)) || 
+      (t.titleCn && t.titleCn.includes(q)) || 
+      (t.summary && t.summary.toLowerCase().includes(q)) ||
+      (t.year && String(t.year).includes(q))
+    );
+
+    return sendJson(res, 200, {
+      status: 'success',
+      code: 200,
+      timestamp,
+      data: {
+        works: matchedWorks,
+        discography: matchedSongs,
+        musicVideos: matchedVideos,
+        timeline: matchedTimeline
+      },
+      meta: {
+        query: q,
+        totalMatches: matchedWorks.length + matchedSongs.length + matchedVideos.length + matchedTimeline.length
+      }
+    }, rateHeaders);
+  }
+
+  if (pathname === '/mcp') {
+    if (req.method === 'GET') {
+      const { getMcpSessionStats } = await import('./mcp/handler.js');
+      const { toolDefinitions } = await import('./mcp/tools.js');
+      const { resourceDefinitions } = await import('./mcp/resources.js');
+      const { promptDefinitions } = await import('./mcp/prompts.js');
+      return sendJson(res, 200, {
+        status: 'success',
+        code: 200,
+        timestamp,
+        name: 'kiku',
+        title: 'kiku',
+        version: PACKAGE_VERSION,
+        protocol: 'mcp',
+        transport: 'streamable-http',
+        endpoints: {
+          http: `${baseUrl}/mcp`
+        },
+        capabilities: {
+          toolsCount: toolDefinitions.length,
+          resourcesCount: resourceDefinitions.length,
+          promptsCount: promptDefinitions.length
+        },
+        stats: getMcpSessionStats(),
+        documentation: 'https://jujingyi-kikuuu.vercel.app/api-docs'
+      }, rateHeaders);
+    }
+
+    try {
+      const { handleMcpHttp } = await import('./mcp/handler.js');
+      await handleMcpHttp(req, res);
+      return;
+    } catch (err) {
+      console.error('[MCP HTTP Error]:', err);
+      return sendJson(res, 500, {
+        status: 'error', code: 500, timestamp,
+        message: safeErrorMessage(err, 'MCP Streamable HTTP error')
+      }, rateHeaders);
+    }
+  }
+
+  if (pathname === '/mcp/sse' || pathname === '/mcp/message') {
+    return sendJson(res, 410, {
+      status: 'error',
+      code: 410,
+      timestamp,
+      error: 'Legacy SSE transport removed. Use POST /mcp.'
+    }, rateHeaders);
+  }
+
+
+  return sendJson(res, 404, {
+    status: 'error',
+    code: 404,
+    timestamp,
+    message: `API endpoint '${pathname}' does not exist on API v1. Check /api-docs or /api/v1/health for available routes.`
+  }, rateHeaders);
+}