kiku-agent 1.3.2 → 1.3.3

package/server/agent/catalogEntityResolver.js

@@ -11,7 +11,7 @@ let cachedIndex = null;
 
 const PLATFORM_PATTERNS = [
   { key: 'bilibili', regex: /(?:bilibili|b站|b-site|บิลิบิลิ|บิลิ)/i, cnName: 'B站' },
-  { key: 'youtube', regex: /(?:youtube|yt|ยูทูป|ยูทูบ)/i, cnName: 'YouTube' },
+  { key: 'youtube', regex: /(?:youtube|\byt\b|ยูทูป|ยูทูบ)/i, cnName: 'YouTube' },
   { key: 'weibo', regex: /(?:weibo|微博|เวยปั๋ว|เว่ยป๋อ)/i, cnName: '微博' },
   { key: 'douyin', regex: /(?:douyin|tiktok|抖音|โต่วอิน)/i, cnName: '抖音' },
   { key: 'qqmusic', regex: /(?:qqmusic|qq\s*音乐|qq\s*music|คิวคิว)/i, cnName: 'QQ音乐' },
@@ -211,7 +211,14 @@ export function buildCatalogIndex() {
   }
 
 
-  const songs = Array.isArray(discographyData) ? discographyData : (discographyData?.songs || []);
+  const songs = Array.isArray(discographyData)
+    ? discographyData
+    : ([
+      ...(discographyData?.songs || []),
+      ...(discographyData?.latestReleases || []),
+      ...(discographyData?.singles || []),
+      ...(discographyData?.ostList || []),
+    ]);
   for (const s of songs) {
     const enName = s.titleEn || '';
     const cnName = s.titleCn || '';
@@ -224,8 +231,8 @@ export function buildCatalogIndex() {
     if (s.id?.includes('0-2s') || s.id === '0.2s' || s.id?.includes('02s') || enName.toLowerCase().includes('0.2s') || cnName.includes('0.2秒')) {
       aliases.push('0.2s', '0.2秒', '0.2 s', '0.2 seconds', 'point two seconds', '0.2 วินาที');
     }
-    if (s.id?.includes('dewdrop') || s.id?.includes('dew-before-dawn') || enName.toLowerCase().includes('dew') || cnName.includes('露珠')) {
-      aliases.push('dewdrops', 'dewdrops dissipate before dawn', 'dew before dawn', 'morning dew', '露珠在晨曦前消散', 'หยาดน้ำค้างสลายก่อนรุ่งอรุณ', 'หยาดน้ำค้าง', 'd-vepdasblo');
+    if (s.id?.includes('dewdrop') || s.id?.includes('dew-before-dawn') || enName.toLowerCase().includes('dew') || cnName.includes('露珠') || cnName.includes('露水')) {
+      aliases.push('dewdrops', 'dewdrops dissipate before dawn', 'dew before dawn', 'morning dew', '露珠在晨曦前消散', '露水', 'หยาดน้ำค้างสลายก่อนรุ่งอรุณ', 'หยาดน้ำค้าง', 'd-vepdasblo');
     }
 
     entities.push({
@@ -246,13 +253,13 @@ export function buildCatalogIndex() {
 
   const awards = Array.isArray(awardsData) ? awardsData : (awardsData?.awards || []);
   for (const a of awards) {
-    const title = a.award || a.title || '';
+    const title = a.award || a.title || a.titleEn || a.titleTh || a.titleCn || a.ceremony || '';
     const ceremony = a.ceremony || '';
-    const aliases = extractAliases(title, ceremony, a.category);
+    const aliases = extractAliases(a.id, title, ceremony, a.category, a.titleTh, a.titleCn, a.work);
 
     entities.push({
       type: 'AWARD',
-      id: `award-${a.year || ''}-${title.slice(0, 15).toLowerCase().replace(/\s+/g, '-')}`,
+      id: a.id || `award-${a.year || ''}-${title.slice(0, 15).toLowerCase().replace(/\s+/g, '-')}`,
       canonicalName: `${title} (${ceremony})`.trim(),
       nameEn: title,
       nameCn: ceremony,
@@ -299,9 +306,10 @@ export function buildCatalogIndex() {
 
   const mvs = Array.isArray(musicVideoData) ? musicVideoData : [];
   for (const m of mvs) {
-    const enName = m.titleCn || '';
+    const enName = m.titleEn || m.titlePinyin || m.titleCn || '';
+    const cnName = m.titleCn || '';
     const thName = m.titleTh || '';
-    const aliases = extractAliases(m.id, enName, thName, m.titlePinyin, m.dramaName);
+    const aliases = extractAliases(m.id, enName, cnName, thName, m.titlePinyin, m.dramaName);
     if (Array.isArray(m.aliases)) aliases.push(...m.aliases);
     if (Array.isArray(m.keywords)) aliases.push(...m.keywords);
 
@@ -311,8 +319,8 @@ export function buildCatalogIndex() {
     if (m.id?.includes('0-2s') || m.id?.includes('02s') || String(m.titleCn || '').includes('0.2s') || String(m.titleTh || '').includes('0.2')) {
       aliases.push('0.2s', '0.2秒', '0.2 s', '0.2 seconds', 'point two seconds', '0.2 วินาที', 'n0yv3dge_z4');
     }
-    if (m.id?.includes('dewdrop') || String(m.titleCn || '').includes('露珠') || String(m.titleTh || '').includes('หยาดน้ำค้าง') || String(m.dramaName || '').includes('Veil of Shadows')) {
-      aliases.push('dewdrops', 'dewdrops dissipate before dawn', 'dew before dawn', 'morning dew', '露珠在晨曦前消散', 'หยาดน้ำค้างสลายก่อนรุ่งอรุณ', 'หยาดน้ำค้าง', 'd-vepdasblo');
+    if (m.id?.includes('dewdrop') || String(m.titleCn || '').includes('露珠') || String(m.titleCn || '').includes('露水') || String(m.titleTh || '').includes('หยาดน้ำค้าง')) {
+      aliases.push('dewdrops', 'dewdrops dissipate before dawn', 'dew before dawn', 'morning dew', '露水', '露珠在晨曦前消散', 'หยาดน้ำค้างสลายก่อนรุ่งอรุณ', 'หยาดน้ำค้าง', 'd-vepdasblo');
     }
 
     entities.push({
@@ -320,7 +328,7 @@ export function buildCatalogIndex() {
       id: m.id,
       canonicalName: `${thName || enName}`.trim(),
       nameEn: enName,
-      nameCn: m.titleCn,
+      nameCn: cnName,
       nameTh: thName,
       category: m.category || 'Music Video',
       year: m.releaseYear || m.year,
@@ -545,13 +553,18 @@ export function resolveQueryEntities(query = '') {
     brands.length > 0
   );
 
+  const isAwardIntent = Boolean(
+    /รางวัล|เกียรติยศ|awards?|honou?rs?|奖项|荣誉|weibo\s+night|微博之夜/i.test(text) ||
+    awards.length > 0
+  );
+
   const recommendedTools = new Set();
   if (timelines.length > 0 || isTimelineIntent) recommendedTools.add('get_career_timeline');
   if (brands.length > 0 || isBrandIntent) recommendedTools.add('get_brand_endorsements');
   if (works.length > 0) recommendedTools.add('search_works');
   if (songs.length > 0) recommendedTools.add('search_discography');
   if (medias.length > 0) recommendedTools.add('get_music_videos');
-  if (awards.length > 0) recommendedTools.add('get_awards');
+  if (awards.length > 0 || isAwardIntent) recommendedTools.add('get_awards');
 
   const result = {
     matchedEntities,
@@ -559,10 +572,11 @@ export function resolveQueryEntities(query = '') {
     hasWork: works.length > 0,
     hasSong: songs.length > 0,
     hasMedia: medias.length > 0,
-    hasAward: awards.length > 0,
+    hasAward: awards.length > 0 || isAwardIntent,
     hasTimeline: timelines.length > 0 || isTimelineIntent,
     isTimelineIntent,
     isBrandIntent,
+    isAwardIntent,
     recommendedTools: Array.from(recommendedTools),
     platforms,
     isPromotion,
@@ -580,29 +594,132 @@ export function resolveQueryEntities(query = '') {
   return result;
 }
 
+export const THAI_INTENT_MAP = [
+  [/(?:เต้น|dance|dancing|เต้นเพลง)/i, '舞蹈 舞台'],
+  [/(?:ร้องสด|live|เปิดไมค์|ไลฟ์|全开麦)/i, '现场 全开麦'],
+  [/(?:เวที|stage|สเตจ)/i, '舞台'],
+  [/(?:คอนเสิร์ต|concert)/i, '演唱会'],
+  [/(?:สัมภาษณ์|interview)/i, '采访'],
+  [/(?:เบื้องหลัง|bts|behind)/i, '花絮'],
+  [/(?:แฟนแคม|fancam|แคม|直拍)/i, '直拍'],
+  [/(?:วาไรตี้|variety|รายการ|综艺)/i, '综艺'],
+  [/(?:พรมแดง|แฟชั่น|fashion|red\s*carpet|红毯)/i, '红毯 造型'],
+  [/(?:เพลงประกอบ|ost|原声带)/i, 'OST 原声带'],
+  [/(?:เอ็มวี|\bmv\b|มิวสิควิดีโอ)/i, 'MV 官方'],
+  [/(?:ซีรีส์|ละคร|drama|电视剧)/i, '电视剧'],
+  [/(?:ภาพยนตร์|หนัง|movie|电影)/i, '电影'],
+  [/(?:โฆษณา|แคมเปญ|commercial|cf|广告)/i, '广告 代言'],
+  [/(?:ข่าวล่าสุด|ข่าวใหม่|ข่าวสาร|ข่าว|news|update|ความเคลื่อนไหว|อัปเดต|近况|最新)/i, '最新消息 动态'],
+  [/(?:เว่ยป๋อ|เว่ยโป๋|weibo|微博|超话)/i, '微博 超话'],
+  [/(?:งาน|อีเวนต์|ออกงาน|งานอีเวนต์|กิจกรรม|event)/i, '活动 现场'],
+  [/(?:ถ่ายทำ|กองถ่าย|เปิดกล้อง|ปิดกล้อง|路透|开机)/i, '剧组 路透 开机'],
+  [/(?:สไตล์|การแต่งตัว|ชุด|เสื้อผ้า|ลุค)/i, '穿搭 造型 美图'],
+];
+
+export const ARTIST_DIRECT_PATTERN = /(ju\s?jing\s?yi|jujingyi|จวีจิ้งอี|จิ้งอี|เสี่ยวจวี|เสี่ยว|鞠婧祎|小鞠|\bkiku\b|kikuuu?|蜜橘)/i;
+
+const EXPLICIT_OPEN_DOMAIN_PATTERNS = [
+ 
+  /(?:คณิตศาสตร์|คณิต|แก้โจทย์|โจทย์เลข|คิดเลข|คำนวณ|สมการ|อสมการ|แคลคูลัส|อินทิกรัล|อินทิเกรต|อนุพันธ์|ดิฟ|เมทริกซ์|เวกเตอร์|พีชคณิต|เรขาคณิต|ตรีโกณมิติ|สถิติ|ความน่าจะเป็น|ทฤษฎีบท|พิสูจน์|จำนวนจริง|จำนวนเต็ม|ตรรกศาสตร์|\bmath(?:ematics)?\b|\bcalculus\b|\balgebra\b|\bintegral\b|\bderivative\b|\bmatrix(?:es)?\b|\bvectors?\b|\bgeometry\b|\btrigonometry\b|\bprobability\b|\bstatistics\b|\bequations?\b|\bdifferential\b|\barithmetic\b|\bdiscrete math\b|\blinear algebra\b)/i,
+
+ 
+  /(?:วิทยาศาสตร์|ฟิสิกส์|เคมี|ชีววิทยา|ดาราศาสตร์|กลศาสตร์|เทอร์โมไดนามิกส์|พันธุศาสตร์|เซลล์|อะตอม|โมเลกุล|ตารางธาตุ|ปฏิกิริยาเคมี|กรดเบส|ไฟฟ้าสถิต|วงจรไฟฟ้า|แม่เหล็กไฟฟ้า|คลื่นแม่เหล็ก|โฟตอน|สัมพัทธภาพ|ควอนตัม|หลุมดำ|ระบบสุริยะ|ดวงอาทิตย์|แรงโน้มถ่วง|ไอน์สไตน์|นิวตัน|\bscience\b|\bphysics\b|\bchemistry\b|\bbiology\b|\bastronomy\b|\bthermodynamics\b|\bgenetics\b|\bperiodic table\b|\bquantum\b|\brelativity\b|\bnewton\b|\beinstein\b|\belectromagnetism\b|\bcellular\b)/i,
+
+ 
+  /(?:เขียนโค้ด|เขียนโปรแกรม|แก้บั๊ก|แก้โค้ด|สอนเขียนโค้ด|ตัวอย่างโค้ด|อัลกอริทึม|โครงสร้างข้อมูล|สคริปต์|ฟังก์ชัน|ภาษา\s*(?:python|javascript|typescript|c\+\+|java|golang|rust|php|swift|kotlin|c#|sql|ruby)|html|css|react|vue|node|api|fastapi|express|docker|kubernetes|linux|windows|database|sql|nosql|github|git|backend|frontend|fullstack|\bcoding\b|\bprogramming\b|\bwrite code\b|\bdebug(?:ging)?\b|\brefactor(?:ing)?\b|\balgorithms?\b|\bdata structures?\b|\bpython\b|\bjavascript\b|\btypescript\b|\bgolang\b|\brustlang\b|\bc\+\+\b|\bjava\b)/i,
+
+
+  /(?:วิธีทำ|สูตรทำ|สูตรอาหาร|ต้มยำ|ผัดกะเพรา|แกง|ขนม|ทำอาหาร|cooking|recipe|food|ingredients|ส่วนผสม)/i,
+
+  
+  /(?:สภาพอากาศ|พยากรณ์อากาศ|อุณหภูมิ|ฝนตกไหม|weather|forecast|temperature|rain)/i,
+  /(?:ท่องเที่ยว|สถานที่ท่องเที่ยว|ที่เที่ยวใน|โรงแรม|การเดินทาง|attractions|places\s*to\s*visit|travel\s*to)/i,
+
+ 
+  /(?:bitcoin|บิตคอยน์|crypto|คริปโต|หุ้น|ตลาดหุ้น|ราคาทอง|ดอลลาร์|อัตราแลกเปลี่ยน|exchange\s*rate|inflation|เงินเฟ้อ)/i,
+  /(?:ประธานาธิบดี|นายกรัฐมนตรี|รัฐบาล|การเลือกตั้ง|president|prime\s*minister|parliament|election)/i,
+  /(?:ฟุตบอล|พรีเมียร์ลีก|ลิเวอร์พูล|แมนยู|อาร์เซนอล|เชลซี|เรอัลมาดริด|บาร์เซโลนา|football|premier\s*league|liverpool|manchester|world\s*cup)/i,
+
+ 
+  /(?:taylor\s*swift|เทย์เลอร์|blackpink|แบล็กพิงก์|bts|บีทีเอส|lisa|ลิซ่า|rose|jennie|jisoo|jackson\s*wang|แจ็คสัน|bai\s*lu|ไป๋ลู่|yang\s*zi|หยางจื่อ|zhao\s*lusi|จ้าวลู่ซือ|dilraba|ตี๋ลี่เร่อปา|wang\s*yibo|หวังอี้ป๋อ|xiao\s*zhan|เซียวจ้าน|chen\s*zheyuan|เฉินเจ๋อย่วน)/i,
+  /(?:harry\s*potter|แฮร์รี่\s*พอตเตอร์|star\s*wars|สตาร์วอร์ส|marvel|avengers|อเวนเจอร์ส|batman|superman|spiderman|game\s*of\s*thrones|lord\s*of\s*the\s*rings|crash\s*landing|queen\s*of\s*tears)/i,
+];
+
+export const QUERY_DOMAINS = Object.freeze({
+  IN_DOMAIN: 'IN_DOMAIN',
+  OPEN_DOMAIN: 'OPEN_DOMAIN'
+});
+
+export function classifyQuerySpectrum(query = '') {
+  const text = String(query || '').trim();
+  if (!text) {
+    return { bias: 1.0, inScore: 1, openScore: 0, verdict: 'IN_DOMAIN' };
+  }
+
+  let inScore = 0;
+  let openScore = 0;
+
+  if (ARTIST_DIRECT_PATTERN.test(text)) inScore += 6;
+  if (/^(?:สวัสดี(?:ครับ|ค่ะ|จ้า|นะ)?|hello|hi|hey|หวัดดี(?:ครับ|ค่ะ)?|ดีครับ|ดีค่ะ|good\s*(?:morning|afternoon|evening))[\s!.]*$/i.test(text)) inScore += 5;
+  if (/(?:เล่นเพลง|หยุดเพลง|พักเพลง|เล่นต่อ|ข้ามเพลง|เพลงถัดไป|เพลงก่อนหน้า|ปิดเพลง|ปรับเสียง|เพิ่มเสียง|ลดเสียง|ปิดเสียง|เปิดเสียง|\bmute\b|\bunmute\b|\bvolume\b|\bpause\b|\bresume\b|\bnext\b|\bprev\b|\bseek\b|\bshuffle\b|\brepeat\b|\bloop\b|วนซ้ำ|สุ่มเพลง|กรอเพลง|toggle_video)/i.test(text)) inScore += 5;
+  if (/(?:4000[\s-]*(?:ปี|year)|ไอดอล\s*4000|snh48|塞纳河|kikufan|เสี่ยวจวี)/i.test(text)) inScore += 4;
+  if (/(ตาม|ใน|จาก)?(แค็ตตาล็อก|catalog|ฐานข้อมูล|database|ข้อมูลทางการ|บันทึกทางการ)/i.test(text)) inScore += 4;
+
+  const resolution = resolveQueryEntities(text);
+  if (resolution.matchedEntities.length > 0) inScore += 4 * resolution.matchedEntities.length;
+  if (resolution.hasBrand) inScore += 4;
+  if (resolution.hasWork) inScore += 4;
+  if (resolution.hasSong) inScore += 4;
+  if (resolution.isPromotion) inScore += 3;
+
+  for (const pat of EXPLICIT_OPEN_DOMAIN_PATTERNS) {
+    if (pat.test(text)) openScore += 5;
+  }
+
+  if (/(?:เธอ|เขา|ศิลปิน|she|her)\b/i.test(text) && /(?:ผลงาน|เพลง|ละคร|ซีรีส์|วันเกิด|ประวัติ|ดนตรี|แฟนคลับ|แบรนด์|รางวัล|song|drama|music|album|award|birthday|concert|profile|fandom)/i.test(text)) {
+    inScore += 3;
+  }
+
+  if (/(?:ผลงานล่าสุด|ผลงานใหม่|เพลงล่าสุด|เพลงใหม่|ละครล่าสุด|ซีรีส์ล่าสุด|รูปสวยๆ|ภาพถ่ายล่าสุด|แฟชั่นล่าสุด|ข่าวล่าสุด|ตารางงาน|งานแฟนมีต)/i.test(text)) {
+    inScore += 3;
+  }
+
+  if (inScore === 0 && openScore === 0) {
+    openScore = 1;
+  }
+
+  const bias = inScore / (inScore + openScore);
+  const verdict = inScore > openScore ? 'IN_DOMAIN' : 'OPEN_DOMAIN';
+
+  return { bias, inScore, openScore, verdict };
+}
+
+export function classifyQueryDomain(query = '') {
+  return classifyQuerySpectrum(query).verdict;
+}
+
+export function isQueryInDomain(query = '') {
+  return classifyQueryDomain(query) === 'IN_DOMAIN';
+}
+
 export function getContextualizedSearchQuery(keyword = '', platform = 'bilibili') {
   const raw = String(keyword || '').trim();
   if (!raw) return '鞠婧祎';
 
-  const resolution = resolveQueryEntities(raw);
-
-  const ARTIST_RE = /(ju\s?jing\s?yi|jujingyi|จวีจิ้งอี|จิ้งอี|鞠婧祎|小鞠|kikuuu?|蜜橘)/i;
-  const mentionsArtist = ARTIST_RE.test(raw);
-  const hasCatalogMatch = resolution.matchedEntities.length > 0;
-
-  if (!mentionsArtist && !hasCatalogMatch) {
+  const domain = classifyQueryDomain(raw);
+  if (domain === 'OPEN_DOMAIN') {
     return raw;
   }
 
+  const resolution = resolveQueryEntities(raw);
+
   if (platform === 'bilibili' || platform === 'chinese_web') {
     const parts = ['鞠婧祎'];
 
-   
     if (resolution.primaryBrand) {
       const cleanCn = resolution.primaryBrand.nameCn.replace(/\s*\([^)]*\)/g, '').trim();
       if (cleanCn && !parts.includes(cleanCn)) parts.push(cleanCn);
       if (resolution.primaryBrand.nameEn && !parts.includes(resolution.primaryBrand.nameEn)) {
-      
         const acronym = resolution.primaryBrand.nameEn.split('/')[0].trim();
         if (acronym && !parts.includes(acronym)) parts.push(acronym);
       }
@@ -612,13 +729,39 @@ export function getContextualizedSearchQuery(keyword = '', platform = 'bilibili'
     } else if (resolution.primarySong) {
       const cleanCn = resolution.primarySong.nameCn.replace(/\s*\([^)]*\)/g, '').trim();
       if (cleanCn && !parts.includes(cleanCn)) parts.push(cleanCn);
+      if (resolution.primarySong.titleEn && !parts.includes(resolution.primarySong.titleEn)) {
+        parts.push(resolution.primarySong.titleEn);
+      }
     } else {
-     
-      const cleanTokens = raw
+      let cleanTokens = raw
         .replace(/^(?:ค้นหา|หา|ดู|เปิด|คลิป|การโปรโมท|โปรโมท|บน|ใน|ที่|bilibili|b站)\s*/gi, '')
         .trim();
+      for (const [re, cnTerm] of THAI_INTENT_MAP) {
+        if (re.test(cleanTokens)) {
+          if (!parts.includes(cnTerm)) parts.push(cnTerm);
+          cleanTokens = cleanTokens.replace(re, ' ');
+        }
+      }
+      cleanTokens = cleanTokens
+        .replace(/(?:จวีจิ้งอี|จิ้งอี|鞠婧祎|小鞠|ju\s*jing\s*yi|kiku)/gi, ' ')
+        .replace(/(?:มีไหม|อะไร|บ้าง|ของ|หน่อย|ล่าสุด|ไหม|ข่าวล่าสุด|ข่าวใหม่|ข่าวสาร|ข่าว|หรือมี|ช่วงนี้|ตอนนี้|ที่ไหน|อย่างไร|เป็นไง|ใหม่ๆ|มี|ใน)/gi, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
       if (cleanTokens && !cleanTokens.includes('鞠婧祎')) {
-        parts.push(cleanTokens);
+        if (platform === 'chinese_web' || platform === 'bilibili') {
+          const nonThaiWords = cleanTokens.split(/\s+/).filter(w => !/^[\u0E00-\u0E7F]+$/.test(w));
+          if (nonThaiWords.length > 0) {
+            parts.push(nonThaiWords.join(' '));
+          }
+        } else {
+          parts.push(cleanTokens);
+        }
+      }
+    }
+
+    for (const [re, cnTerm] of THAI_INTENT_MAP) {
+      if (re.test(raw) && !parts.some(p => p.includes(cnTerm.split(' ')[0]))) {
+        parts.push(cnTerm);
       }
     }
 
@@ -626,10 +769,9 @@ export function getContextualizedSearchQuery(keyword = '', platform = 'bilibili'
       parts.push('代言');
     }
 
-    return parts.join(' ').trim();
+    return parts.join(' ').replace(/\s+/g, ' ').trim();
   }
 
-
   if (!raw.toLowerCase().includes('ju jingyi') && !raw.includes('鞠婧祎')) {
     return `Ju Jingyi 鞠婧祎 ${raw}`;
   }

package/server/agent/clarifyingQuestions.js

@@ -53,7 +53,7 @@ const AMBIGUITY_PATTERNS = [
   {
     category: 'scope',
     weight: 0.6,
-    detection: /\b(all|every|list|show|tell me about|what about|how about|comprehensive|complete)\b|(ทั้งหมด|ทุกอย่าง|ภาพรวม|全部|一覧|まとめ|모든|전체|목록)/i,
+    detection: /\b(all|every|list|show|tell me about|what about|how about|comprehensive|complete|explain)\b|(ทั้งหมด|ทุกอย่าง|ภาพรวม|เล่าเรื่อง|ช่วยเล่า|เรื่องย่อ|เป็นยังไง|สนุกไหม|全部|一覧|まとめ|모든|전체|목록)/i,
     questions: {
       en: 'Would you like a comprehensive overview or a focused summary on a specific aspect?',
       th: 'ต้องการภาพรวมที่ครอบคลุม หรือต้องการเน้นเฉพาะด้านใดด้านหนึ่ง?',
@@ -253,7 +253,7 @@ function localizePattern(pattern, lang) {
   };
 }
 
-const KNOWN_WORKS_OR_CHARACTERS_REGEX = /(花间令|花間令|In Blossom|ฮวาเจียนลิ่ง|芸汐传|芸汐伝|Yunxi|หยุนซี|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|The Blooms at Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|杨采薇|上官芷|หยางไฉ่เวย|ซ่างกวนจื่อ|韩芸汐|หานหยุนซี|白素贞|ไป๋ซู่เจิน|傅容|ฟู่หรง|姜保宁|เจียงเป่าหนิง|韩菱纱|หานหลิงซา)/i;
+export const KNOWN_WORKS_OR_CHARACTERS_REGEX = /(花间令|花間令|In Blossom|ฮวาเจียนลิ่ง|ฮวาเจียนหลิง|อินบลอสซัม|芸汐传|芸汐伝|Yunxi|หยุนซี|ตำนานหยุนซี|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|The Blooms at Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|กำเนิดใหม่เพื่อเธอ|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|千香|千香引|The Eternal Fragrance|พันกลิ่นบุปผา|花戎|Beauty of Resilience|ฮวาหรง|ตำนานเลือดฟีนิกซ์|月鳞绮纪|Veil of Shadows|เยว่หลินฉีจี้|ม่านเงาจันทรา|杨采薇|上官芷|หยางไฉ่เวย|ซ่างกวนจื่อ|韩芸汐|หานหยุนซี|白素贞|ไป๋ซู่เจิน|傅容|ฟู่หรง|姜保宁|เจียงเป่าหนิง|韩菱纱|หานหลิงซา|魏枝|เว่ยจือ|雷修远|เหลยซิวหย่วน|陆吾一|ลู่หวู่อี้)/i;
 
 const SPECIFICITY_PATTERNS = [
   /\b(exactly|specifically|precisely|particular)\b/i,
@@ -278,13 +278,17 @@ export function calculateConfidence(query, detectedAmbiguities = []) {
   else if (wordCount < 5) score -= 0.1;
   else if (wordCount > 15) score += 0.1;
 
-  if (KNOWN_WORKS_OR_CHARACTERS_REGEX.test(trimmed)) {
-    return {
-      score: 0.95,
-      level: 'high',
-      shouldAsk: false,
-      reasoning: 'High confidence: specific work or character explicitly identified in query.'
-    };
+  const hasKnownWork = KNOWN_WORKS_OR_CHARACTERS_REGEX.test(trimmed);
+  if (hasKnownWork) {
+    if (detectedAmbiguities.length === 0) {
+      return {
+        score: 0.95,
+        level: 'high',
+        shouldAsk: false,
+        reasoning: 'High confidence: specific work or character explicitly identified in query without ambiguities.'
+      };
+    }
+    score += 0.2;
   }
 
   for (const pattern of SPECIFICITY_PATTERNS) {
@@ -342,7 +346,19 @@ export function detectAmbiguities(query, detectedLang = 'en') {
 const KNOWN_ENTITY_PATTERNS = [
   {
     key: 'in_blossom',
-    labels: { en: 'In Blossom (花间令)', th: 'อินบลอสซัม/ฮวาเจียนหลิง (In Blossom)', zh: '《花间令》', ja: '『花間令』(In Blossom)', ko: 'In Blossom (화간령)' },
+    labels: { en: 'In Blossom (花间令)', th: 'ฮวาเจียนลิ่ง/ฮวาเจียนหลิง (In Blossom)', zh: '《花间令》', ja: '『花間令』(In Blossom)', ko: 'In Blossom (화간령)' },
+  },
+  {
+    key: 'the_eternal_fragrance',
+    labels: { en: 'The Eternal Fragrance (千香)', th: 'พันกลิ่นบุปผา (The Eternal Fragrance)', zh: '《千香》', ja: '『千香』(The Eternal Fragrance)', ko: 'The Eternal Fragrance (천향)' },
+  },
+  {
+    key: 'beauty_of_resilience',
+    labels: { en: 'Beauty of Resilience (花戎)', th: 'ตำนานเลือดฟีนิกซ์/ฮวาหรง (Beauty of Resilience)', zh: '《花戎》', ja: '『花戎』(Beauty of Resilience)', ko: 'Beauty of Resilience (화융)' },
+  },
+  {
+    key: 'veil_of_shadows',
+    labels: { en: 'Veil of Shadows (月鳞绮纪)', th: 'เยว่หลินฉีจี้/ม่านเงาจันทรา (Veil of Shadows)', zh: '《月鳞绮纪》', ja: '『月鱗綺紀』(Veil of Shadows)', ko: 'Veil of Shadows (월린기기)' },
   },
   {
     key: 'legend_of_yunxi',
@@ -381,15 +397,18 @@ export function stripSystemDirectives(text) {
     .trim();
 }
 
-const KNOWN_ENTITY_REGEX = /(花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง|芸汐传|芸汐伝|Yunxi|ตำนานหยุนซี|หยุนซี|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|SNH48)/i;
+const KNOWN_ENTITY_REGEX = /(花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง|ฮวาเจียนลิ่ง|千香|千香引|The Eternal Fragrance|พันกลิ่นบุปผา|花戎|Beauty of Resilience|ฮวาหรง|ตำนานเลือดฟีนิกซ์|月鳞绮纪|Veil of Shadows|เยว่หลินฉีจี้|ม่านเงาจันทรา|ลู่หวู่อี้|芸汐传|芸汐伝|Yunxi|ตำนานหยุนซี|หยุนซี|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่|新白娘子传奇|White Snake|นางพญางูขาว|如意芳霏|Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|กำเนิดใหม่เพื่อเธอ|SNH48)/i;
 
 const ENTITY_REGEX_MAP = {
-  in_blossom: /(?:in_blossom|花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง)/i,
+  in_blossom: /(?:in_blossom|花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง|ฮวาเจียนลิ่ง)/i,
+  the_eternal_fragrance: /(?:the_eternal_fragrance|千香|千香引|The Eternal Fragrance|พันกลิ่นบุปผา)/i,
+  beauty_of_resilience: /(?:beauty_of_resilience|花戎|Beauty of Resilience|ฮวาหรง|ตำนานเลือดฟีนิกซ์)/i,
+  veil_of_shadows: /(?:veil_of_shadows|月鳞绮纪|Veil of Shadows|เยว่หลินฉีจี้|ม่านเงาจันทรา|ลู่หวู่อี้)/i,
   legend_of_yunxi: /(?:legend_of_yunxi|芸汐传|芸汐伝|Yunxi|ตำนานหยุนซี|หยุนซี)/i,
   sword_fairy_4: /(?:sword_fairy_4|仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่)/i,
   white_snake: /(?:white_snake|新白娘子传奇|White Snake|นางพญางูขาว)/i,
   ruyi_pavilion: /(?:ruyi_pavilion|如意芳霏|Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา)/i,
-  rebirth_for_you: /(?:rebirth_for_you|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ)/i,
+  rebirth_for_you: /(?:rebirth_for_you|嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|กำเนิดใหม่เพื่อเธอ)/i,
   snh48: /(?:snh48|SNH48)/i,
 };
 
@@ -408,12 +427,15 @@ function extractQueryTopic(query, lang) {
 
 function entityRegexFor(key) {
   const map = {
-    in_blossom: '花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง',
+    in_blossom: '花间令|花間令|In Blossom|อินบลอสซัม|ฮวาเจียนหลิง|ฮวาเจียนลิ่ง',
+    the_eternal_fragrance: '千香|千香引|The Eternal Fragrance|พันกลิ่นบุปผา',
+    beauty_of_resilience: '花戎|Beauty of Resilience|ฮวาหรง|ตำนานเลือดฟีนิกซ์',
+    veil_of_shadows: '月鳞绮纪|Veil of Shadows|เยว่หลินฉีจี้|ม่านเงาจันทรา|ลู่หวู่อี้',
     legend_of_yunxi: '芸汐传|芸汐伝|Yunxi|ตำนานหยุนซี|หยุนซี',
     sword_fairy_4: '仙剑四|仙劍四|Sword and Fairy|เซียนกระบี่',
     white_snake: '新白娘子传奇|White Snake|นางพญางูขาว',
     ruyi_pavilion: '如意芳霏|Ruyi Pavilion|กรุ่นรักกลิ่นบุปผา',
-    rebirth_for_you: '嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ',
+    rebirth_for_you: '嘉南传|嘉南傳|Rebirth For You|มู่หนานจือ|กำเนิดใหม่เพื่อเธอ',
     snh48: 'SNH48',
   };
   return map[key] || '';
@@ -829,10 +851,42 @@ const FALLBACK_OPTIONS = {
   ko: ['네', '아니요', '전체'],
 };
 
+const clarificationCache = new Map();
+const CLARIFY_CACHE_TTL_MS = 10 * 60 * 1000;
+const MAX_CLARIFY_CACHE_ENTRIES = 100;
+
+function getCachedClarification(key) {
+  const item = clarificationCache.get(key);
+  if (!item) return null;
+  if (Date.now() > item.expiresAt) {
+    clarificationCache.delete(key);
+    return null;
+  }
+  return item.data;
+}
+
+function setCachedClarification(key, data) {
+  if (clarificationCache.size >= MAX_CLARIFY_CACHE_ENTRIES) {
+    const oldestKey = clarificationCache.keys().next().value;
+    clarificationCache.delete(oldestKey);
+  }
+  clarificationCache.set(key, { data, expiresAt: Date.now() + CLARIFY_CACHE_TTL_MS });
+}
+
+export function clearClarificationCache() {
+  clarificationCache.clear();
+}
+
 export async function generateClarifyingQuestions(query, lang = 'en', options = {}) {
   const { conversationHistory = [], client = null, maxQuestions = 4, detectedAmbiguities = [] } = options;
   const cleanQuery = stripSystemDirectives(query) || (typeof query === 'string' ? query.trim() : '');
   const normalizedLang = normalizeLang(lang);
+  const cacheKey = `${normalizedLang}:${cleanQuery.toLowerCase()}`;
+
+  if (!client) {
+    const cached = getCachedClarification(cacheKey);
+    if (cached) return cached;
+  }
 
   if (client && typeof client.chat === 'function') {
     const recentHistory = conversationHistory
@@ -876,14 +930,18 @@ export async function generateClarifyingQuestions(query, lang = 'en', options =
           }));
 
         if (validated.length >= 2) {
-          return validated.slice(0, maxQuestions);
+          const res = validated.slice(0, maxQuestions);
+          setCachedClarification(cacheKey, res);
+          return res;
         }
       }
     } catch {
     }
   }
 
-  return synthesizeDynamicQuestions(cleanQuery, normalizedLang, detectedAmbiguities, maxQuestions);
+  const synthesized = synthesizeDynamicQuestions(cleanQuery, normalizedLang, detectedAmbiguities, maxQuestions);
+  setCachedClarification(cacheKey, synthesized);
+  return synthesized;
 }
 
 export function isQueryTooVague(query) {
@@ -972,30 +1030,61 @@ export function parseClarifyingAnswers(answersText, questions) {
     return { answers: {}, summary: 'User chose to skip clarifying questions.' };
   }
 
+  let extraNote = '';
+  let cleanAnswersText = answersText;
+  const extraMatch = answersText.match(/(?:เพิ่มเติม|additional|extra|note):\s*(.+)$/i);
+  if (extraMatch) {
+    extraNote = extraMatch[1].trim();
+    cleanAnswersText = answersText.replace(/(?:เพิ่มเติม|additional|extra|note):\s*(.+)$/i, '').trim().replace(/;\s*$/, '');
+  }
+
   const answers = {};
   const summaryParts = [];
 
-  const isStructured = /^[\da-d\s,;]+$/.test(trimmed) && trimmed.length <= 20;
-
-  if (isStructured) {
-    const structuredPattern = /(\d+)?([a-d])/g;
-    let match;
-    while ((match = structuredPattern.exec(trimmed)) !== null) {
-      const questionIndex = match[1] ? parseInt(match[1], 10) - 1 : 0;
-      const optionIndex = match[2].charCodeAt(0) - 97;
+  // 1. Try structured colon-delimited key-values (e.g. "drama_aspect: บทบาท; timeframe: 2024-2026")
+  if (cleanAnswersText.includes(':')) {
+    const pairs = cleanAnswersText.split(';').map(p => p.trim()).filter(Boolean);
+    for (const pair of pairs) {
+      const idx = pair.indexOf(':');
+      if (idx !== -1) {
+        const catKey = pair.slice(0, idx).trim();
+        const val = pair.slice(idx + 1).trim();
+        if (catKey && val) {
+          const matchedQ = questions.find(q => q.category === catKey || q.category?.toLowerCase() === catKey.toLowerCase());
+          const actualKey = matchedQ ? matchedQ.category : catKey;
+          answers[actualKey] = val;
+          summaryParts.push(`${actualKey}: ${val}`);
+        }
+      }
+    }
+  }
 
-      if (questionIndex >= 0 && questionIndex < questions.length) {
-        const q = questions[questionIndex];
-        if (optionIndex >= 0 && optionIndex < (q.options?.length || 0)) {
-          answers[q.category] = q.options[optionIndex];
-          summaryParts.push(`${q.category}: ${q.options[optionIndex]}`);
+  // 2. Try structured shorthand pattern (e.g. "1a 2c" or "a")
+  if (Object.keys(answers).length === 0) {
+    const cleanLower = cleanAnswersText.toLowerCase().trim();
+    const isStructured = /^[\da-d\s,;]+$/.test(cleanLower) && cleanLower.length <= 20;
+
+    if (isStructured) {
+      const structuredPattern = /(\d+)?([a-d])/g;
+      let match;
+      while ((match = structuredPattern.exec(cleanLower)) !== null) {
+        const questionIndex = match[1] ? parseInt(match[1], 10) - 1 : 0;
+        const optionIndex = match[2].charCodeAt(0) - 97;
+
+        if (questionIndex >= 0 && questionIndex < questions.length) {
+          const q = questions[questionIndex];
+          if (optionIndex >= 0 && optionIndex < (q.options?.length || 0)) {
+            answers[q.category] = q.options[optionIndex];
+            summaryParts.push(`${q.category}: ${q.options[optionIndex]}`);
+          }
         }
       }
     }
   }
 
-  if (Object.keys(answers).length === 0 && trimmed.length > 0) {
-    const interpretedAnswers = interpretFreeTextAnswers(answersText, questions);
+  // 3. Fallback to free text interpretation against questions options
+  if (Object.keys(answers).length === 0 && cleanAnswersText.trim().length > 0) {
+    const interpretedAnswers = interpretFreeTextAnswers(cleanAnswersText, questions);
 
     if (Object.keys(interpretedAnswers).length > 0) {
       Object.assign(answers, interpretedAnswers);
@@ -1004,12 +1093,18 @@ export function parseClarifyingAnswers(answersText, questions) {
       }
     } else {
       if (questions.length > 0) {
-        answers[questions[0].category] = answersText.trim();
-        summaryParts.push(`${questions[0].category}: ${answersText.trim()}`);
+        answers[questions[0].category] = cleanAnswersText.trim();
+        summaryParts.push(`${questions[0].category}: ${cleanAnswersText.trim()}`);
       }
     }
   }
 
+  // 4. Attach extra note if present
+  if (extraNote) {
+    answers._additional = extraNote;
+    summaryParts.push(`Additional note: ${extraNote}`);
+  }
+
   return {
     answers,
     summary: summaryParts.length > 0
@@ -1111,7 +1206,7 @@ export function buildClarificationContext(clarifyingResult, originalQuery) {
 
   const { answers, summary } = clarifyingResult;
 
-  const isDramaQuery = /(ซีรีส์|ละคร|drama|series|in blossom|ฮวาเจียนลิ่ง|花间令|花間令|หยุนซี|yunxi|นางพญางูขาว|드라마|ドラマ)/i.test(originalQuery);
+  const isDramaQuery = /(ซีรีส์|ละคร|drama|series|in blossom|ฮวาเจียนลิ่ง|ฮวาเจียนหลิง|花间令|花間令|หยุนซี|yunxi|นางพญางูขาว|드라마|ドラマ)/i.test(originalQuery);
   const isMusicQuery = /(เพลง|song|music|ost|album|single|find the way|曲|歌|음악|노래)/i.test(originalQuery);
 
   const parts = [];
@@ -1120,6 +1215,9 @@ export function buildClarificationContext(clarifyingResult, originalQuery) {
   parts.push(`Clarifications provided:`);
 
   for (const [category, value] of Object.entries(answers)) {
+    if (category.startsWith('_')) {
+      continue;
+    }
     if (category === 'media_type' && isDramaQuery && !isMusicQuery && String(value).toLowerCase().includes('music')) {
       continue;
     }
@@ -1129,6 +1227,10 @@ export function buildClarificationContext(clarifyingResult, originalQuery) {
     parts.push(`- ${category}: ${value}`);
   }
 
+  if (answers._additional) {
+    parts.push(`- additional_user_note: ${answers._additional}`);
+  }
+
   if (summary) {
     parts.push(`Summary: ${summary}`);
   }