kiku-agent 1.2.0 → 1.3.0

package/server/agent/appPaths.js

@@ -22,3 +22,5 @@ export const EXPORT_DIR = path.join(KIKU_DATA_DIR, 'exports');
 export const PROVIDER_KEYS_FILE = path.join(KIKU_DATA_DIR, 'provider_keys.json');
 export const SETTINGS_FILE = path.join(KIKU_DATA_DIR, 'settings.json');
 export const PROFILES_FILE = path.join(KIKU_DATA_DIR, 'profiles.json');
+export const HIERARCHICAL_MEMORY_DIR = path.join(KIKU_DATA_DIR, 'memory_nodes');
+export const ARTIFACTS_STORE_DIR = path.join(KIKU_DATA_DIR, 'artifacts_store');

package/server/agent/catalogEntityResolver.js

@@ -0,0 +1,629 @@
+import { brandsData } from '../../src/data/brandsData.js';
+import { worksData } from '../../src/data/worksData.js';
+import { discographyData } from '../../src/data/discographyData.js';
+import { musicVideoData } from '../../src/data/musicVideoData.js';
+import { awardsData } from '../../src/data/awardsData.js';
+import { timelineData } from '../../src/data/timelineData.js';
+import { profileData } from '../../src/data/profileData.js';
+import { RUMORED_OR_EXTERNAL_PROJECTS } from './rumoredProjects.js';
+
+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: 'weibo', regex: /(?:weibo|微博|เวยปั๋ว|เว่ยป๋อ)/i, cnName: '微博' },
+  { key: 'douyin', regex: /(?:douyin|tiktok|抖音|โต่วอิน)/i, cnName: '抖音' },
+  { key: 'qqmusic', regex: /(?:qqmusic|qq\s*音乐|qq\s*music|คิวคิว)/i, cnName: 'QQ音乐' },
+  { key: 'youku', regex: /(?:youku|优酷|โยวคู่)/i, cnName: '优酷' },
+  { key: 'iqiyi', regex: /(?:iqiyi|爱奇艺|อ้ายฉีอี้)/i, cnName: '爱奇艺' },
+  { key: 'tencent', regex: /(?:tencent|wetv|腾讯视频|วีทีวี)/i, cnName: '腾讯视频' }
+];
+
+const PROMOTION_INTENT_TERMS = [
+  'โปรโมท', 'โปรโมต', 'การโปรโมท', 'การโปรโมต', 'พรีเซนเตอร์', 'พรีเซ็นเตอร์', 'โฆษณา', 'แคมเปญ',
+  'commercial', 'cf', 'promo', 'promotion', 'promoted', 'campaign', 'sponsor', 'partnership',
+  'endorsement', 'endorser', 'ambassador', 'fashion', 'photoshoot',
+  '推广', '商务', '代言', '地广', '物料', '广告', '品牌', '大使'
+];
+
+export function detectPlatforms(query = '') {
+  const text = String(query || '').toLowerCase();
+  const matched = [];
+  for (const p of PLATFORM_PATTERNS) {
+    if (p.regex.test(text)) {
+      matched.push(p.key);
+    }
+  }
+  return matched;
+}
+
+export function detectPromotionIntent(query = '') {
+  const text = String(query || '').toLowerCase();
+  return PROMOTION_INTENT_TERMS.some(term => {
+    const t = term.toLowerCase();
+    if (!/^[a-z0-9 -]+$/.test(t)) return text.includes(t);
+    const escaped = t.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
+    return new RegExp(`(?:^|[^a-z0-9])${escaped}(?:s|es)?(?:$|[^a-z0-9])`).test(text);
+  });
+}
+
+const STOPWORDS = new Set([
+  'the', 'a', 'an', 'in', 'on', 'at', 'to', 'of', 'for', 'by', 'with', 'from',
+  'as', 'into', 'like', 'through', 'after', 'over', 'between', 'out', 'against',
+  'during', 'without', 'before', 'under', 'around', 'among', 'and', 'or', 'but',
+  'is', 'are', 'was', 'were', 'be', 'been', 'being', 'it', 'its', 'this', 'that',
+  'these', 'those', 'who', 'whom', 'whose', 'which', 'what', 'where', 'when', 'why', 'how',
+  'tell', 'me', 'about', 'her', 'she', 'he', 'him', 'his', 'they', 'them', 'their', 'we', 'us',
+  'you', 'your', 'my', 'does', 'do', 'did', 'done', 'doing', 'have', 'has', 'had',
+  'will', 'would', 'shall', 'should', 'can', 'could', 'look', 'looks', 'see', 'song', 'songs', 'concert'
+]);
+
+function cleanAlias(text) {
+  if (!text) return '';
+  return String(text)
+    .trim()
+    .replace(/[()[\]{}"'“”‘’]/g, ' ')
+    .replace(/\s+/g, ' ')
+    .toLowerCase();
+}
+
+function extractAliases(...values) {
+  const aliases = new Set();
+  for (const v of values) {
+    if (!v || typeof v !== 'string') continue;
+    const clean = cleanAlias(v);
+    if (clean.length >= 2 && !STOPWORDS.has(clean)) aliases.add(clean);
+    const withSpaces = clean.replace(/[-_]/g, ' ').replace(/\s+/g, ' ').trim();
+    if (withSpaces.length >= 2 && !STOPWORDS.has(withSpaces)) aliases.add(withSpaces);
+    const parts = v.split(/[/\\|–—,]/).map(p => cleanAlias(p)).filter(p => p.length >= 2 && !STOPWORDS.has(p));
+    for (const p of parts) aliases.add(p);
+  }
+  return Array.from(aliases);
+}
+
+export const CATEGORY_ALIASES = {
+  'jewelry': ['jewelry', 'jewellery', 'high jewelry', 'เครื่องประดับ', 'อัญมณี', 'french high jewelry', 'fine jewelry', '珠宝', '首饰', 'force 10', 'lvmh'],
+  'eyewear': ['eyewear', 'glasses', 'sunglasses', 'แว่นตา', 'แว่นกันแดด', '眼镜', '太阳镜'],
+  'beauty': ['beauty', 'cosmetics', 'skincare', 'บิวตี้', 'เครื่องสำอาง', 'สกินแคร์', '美妆', '护肤'],
+  'fashion': ['fashion', 'apparel', 'clothing', 'เสื้อผ้า', 'แฟชั่น', '服饰', '时装'],
+  'fragrance': ['fragrance', 'perfume', 'น้ำหอม', '香氛', '香水'],
+  'haircare': ['haircare', 'hair care', 'shampoo', 'ดูแลเส้นผม', 'แชมพู', '洗护', '美发'],
+  'personal_care': ['personal care', 'sanitary', 'ผ้าอนามัย', 'สุขอนามัย', '卫生巾', '个人护理']
+};
+
+export function buildCatalogIndex() {
+  if (cachedIndex) return cachedIndex;
+
+  const entities = [];
+
+  const brandList = Array.isArray(brandsData) ? brandsData : (brandsData.brandList || brandsData.brands || []);
+  for (const b of brandList) {
+    const enName = b.brandNameEn || b.brand || b.name || '';
+    const cnName = b.brandNameCn || '';
+    const aliases = extractAliases(
+      b.id,
+      enName,
+      cnName,
+      b.title,
+      b.tier
+    );
+
+    if (Array.isArray(b.aliases)) aliases.push(...b.aliases);
+    if (Array.isArray(b.keywords)) aliases.push(...b.keywords);
+
+    if (b.id === 'prsr' || enName.toLowerCase().includes('prsr') || enName.toLowerCase().includes('pasha')) {
+      aliases.push('prsr', 'pasha', '帕莎', '帕莎眼镜', 'แว่นตา prsr', 'แว่นตา pasha');
+    }
+    if (b.id === 'versace' || enName.toLowerCase().includes('versace')) {
+      aliases.push('versace', '范思哲', '范思哲香氛', 'เวอร์ซาเช่');
+    }
+    if (b.id === 'fred' || enName.toLowerCase().includes('fred')) {
+      aliases.push('fred', 'fred jewelry', 'fred珠宝', 'french high jewelry', 'เฟรด', 'เครื่องประดับฝรั่งเศส', 'french jewelry', 'เครื่องประดับระดับสูงสัญชาติฝรั่งเศส', 'เครื่องประดับชั้นสูงจากฝรั่งเศส', 'เครื่องประดับชั้นสูง', 'french high jewelry brand', 'lvmh', 'force 10');
+    }
+    if (b.id === 'tutucare' || enName.toLowerCase().includes('tutu') || cnName.includes('凸凸棉')) {
+      aliases.push('tutucare', 'ทูทูแคร์', 'tutu care', 'ตูตูแคร์', '凸凸棉', 'กล่องของขวัญ tutucare', 'กล่องของขวัญ', 'สถิติยอดขายกล่องของขวัญ');
+    }
+    if (b.id === 'lafang' || enName.toLowerCase().includes('lafang') || cnName.includes('拉芳')) {
+      aliases.push('lafang', 'ลาฟาง', '拉芳', 'ดูแลเส้นผม');
+    }
+
+    entities.push({
+      type: 'BRAND',
+      id: b.id || enName.toLowerCase().replace(/\s+/g, '-'),
+      canonicalName: `${enName} (${cnName})`.trim(),
+      nameEn: enName,
+      nameCn: cnName,
+      nameTh: '',
+      category: b.category || 'Brand Endorsement',
+      year: b.year,
+      aliases: Array.from(new Set(aliases)),
+      recommendedTools: ['get_brand_endorsements', 'global_search'],
+      raw: b
+    });
+  }
+
+ 
+  const works = Array.isArray(worksData) ? worksData : [];
+  for (const w of works) {
+    const enName = w.titleEn || '';
+    const cnName = w.titleCn || '';
+    const thName = w.titleTh || '';
+    const aliases = extractAliases(w.id, enName, cnName, thName, w.role, w.roleCn);
+
+    if (cnName.includes('花间令') || enName.toLowerCase().includes('in blossom')) {
+      aliases.push('in blossom', '花间令', '花间', 'ฮวาเจียนลิ่ง', 'ฮวาเจียนหลิง', 'หยางไฉ่เวย', 'ซ่างกวนจื่อ', 'yang caiwei');
+    }
+    if (cnName.includes('芸汐传') || enName.toLowerCase().includes('yunxi')) {
+      aliases.push('legend of yunxi', '芸汐传', 'หยุนซี', 'ตำนานหยุนซี', 'หานหยุนซี', 'han yunxi');
+    }
+    if (cnName.includes('新白娘子传奇') || enName.toLowerCase().includes('white snake')) {
+      aliases.push('the legend of white snake', '新白娘子传奇', 'นางพญางูขาว', 'ตำนานนางพญางูขาว', 'ไป๋ซู่เจิน', 'bai suzhen');
+    }
+    if (cnName.includes('仙剑四') || enName.toLowerCase().includes('sword and fairy 4')) {
+      aliases.push('sword and fairy 4', '仙剑四', 'เซียนกระบี่ 4', 'เซียนกระบี่พิชิตมาร 4', 'หานหลิงซา', 'han lingsha');
+    }
+    if (cnName.includes('千香') || enName.toLowerCase().includes('eternal fragrance')) {
+      aliases.push('the eternal fragrance', '千香', 'พันกลิ่นบุปผา', 'เจียงหลีเฟย', 'เสี่ยวปั้งฉุย', 'jiang lifei');
+    }
+    if (cnName.includes('月鳞绮纪') || enName.toLowerCase().includes('veil of shadows')) {
+      aliases.push('veil of shadows', '月鳞绮纪', 'ลู่หวู่อี้', 'lu wuyi');
+    }
+
+    entities.push({
+      type: 'WORK',
+      id: w.id || enName.toLowerCase().replace(/\s+/g, '-'),
+      canonicalName: `${thName || enName} (${cnName})`.trim(),
+      nameEn: enName,
+      nameCn: cnName,
+      nameTh: thName,
+      category: w.category || 'Drama / Series',
+      year: w.year,
+      aliases: Array.from(new Set(aliases)),
+      recommendedTools: ['search_works', 'get_work_detail', 'get_character_roles', 'global_search'],
+      raw: w
+    });
+  }
+
+ 
+  for (const r of RUMORED_OR_EXTERNAL_PROJECTS) {
+    const aliases = new Set((r.keywords || []).map(k => String(k).toLowerCase()));
+    if (r.titleCn) aliases.add(r.titleCn.toLowerCase());
+    if (r.titleEn) aliases.add(r.titleEn.toLowerCase());
+
+    entities.push({
+      type: 'WORK',
+      id: r.id || String(r.titleCn || r.titleEn || 'rumored-project').toLowerCase().replace(/\s+/g, '-'),
+      canonicalName: `${r.titleCn} (${r.titleEn})`.trim(),
+      nameEn: r.titleEn,
+      nameCn: r.titleCn,
+      nameTh: '',
+      category: 'Rumored Casting Project',
+      year: r.year || null,
+      aliases: Array.from(aliases),
+      recommendedTools: ['search_works', 'global_search'],
+      raw: {
+        status: r.status,
+        producer: r.producer,
+        disambiguation: r.disambiguation
+      }
+    });
+  }
+
+
+  const songs = Array.isArray(discographyData) ? discographyData : (discographyData?.songs || []);
+  for (const s of songs) {
+    const enName = s.titleEn || '';
+    const cnName = s.titleCn || '';
+    const thName = s.titleTh || '';
+    const aliases = extractAliases(s.id, enName, cnName, thName, s.work);
+
+    if (Array.isArray(s.aliases)) aliases.push(...s.aliases);
+    if (Array.isArray(s.keywords)) aliases.push(...s.keywords);
+
+    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');
+    }
+
+    entities.push({
+      type: 'SONG',
+      id: s.id || (enName || cnName).toLowerCase().replace(/\s+/g, '-'),
+      canonicalName: `${thName || enName} (${cnName})`.trim(),
+      nameEn: enName,
+      nameCn: cnName,
+      nameTh: thName,
+      category: s.work || 'Song / Single',
+      year: s.year,
+      aliases: Array.from(new Set(aliases)),
+      recommendedTools: ['search_discography', 'get_music_videos', 'get_media_links'],
+      raw: s
+    });
+  }
+
+
+  const awards = Array.isArray(awardsData) ? awardsData : (awardsData?.awards || []);
+  for (const a of awards) {
+    const title = a.award || a.title || '';
+    const ceremony = a.ceremony || '';
+    const aliases = extractAliases(title, ceremony, a.category);
+
+    entities.push({
+      type: 'AWARD',
+      id: `award-${a.year || ''}-${title.slice(0, 15).toLowerCase().replace(/\s+/g, '-')}`,
+      canonicalName: `${title} (${ceremony})`.trim(),
+      nameEn: title,
+      nameCn: ceremony,
+      category: 'Award',
+      year: a.year,
+      aliases: Array.from(new Set(aliases)),
+      recommendedTools: ['get_awards', 'get_career_timeline'],
+      raw: a
+    });
+  }
+
+ 
+  const eras = Array.isArray(timelineData) ? timelineData : (timelineData?.eras || []);
+  for (const e of eras) {
+    const title = e.title || '';
+    const era = e.era || '';
+    const aliases = extractAliases(title, era, e.titleCn);
+    if (Array.isArray(e.highlights)) {
+      for (const h of e.highlights) {
+        if (h.includes("Princess's Cloak")) aliases.push("Princess's Cloak", "公主披风", "เซ็นเตอร์เพลง");
+        if (h.includes("Mike") || h.includes("Mr. Swimmer") || h.includes("ไมค์")) aliases.push("Mr. Swimmer", "游泳先生", "Mike", "ไมค์ พิรัชต์", "ไมค์");
+        if (h.includes("4 พฤษภาคม") || h.includes("May 4th")) aliases.push("เหรียญเยาวชน 4 พฤษภาคม", "May 4th Medal", "五四青年奖章");
+        if (h.includes("Forbes") || h.includes("30 Under 30")) aliases.push("Forbes 30 Under 30", "30 Under 30", "福布斯");
+      }
+    }
+    if (e.summary) {
+      if (e.summary.includes("Princess's Cloak")) aliases.push("Princess's Cloak", "公主披风");
+      if (e.summary.includes("230,000")) aliases.push("230,000", "230000");
+    }
+
+    entities.push({
+      type: 'TIMELINE',
+      id: `era-${(e.id || era || String(e.year || '')).toLowerCase().replace(/\s+/g, '-')}`,
+      canonicalName: `${title} (${era})`.trim(),
+      nameEn: title,
+      nameCn: e.titleCn || '',
+      category: 'Career Milestone',
+      year: e.year,
+      aliases: Array.from(new Set(aliases)),
+      recommendedTools: ['get_career_timeline', 'get_profile_and_fandom'],
+      raw: e
+    });
+  }
+
+  const mvs = Array.isArray(musicVideoData) ? musicVideoData : [];
+  for (const m of mvs) {
+    const enName = m.titleCn || '';
+    const thName = m.titleTh || '';
+    const aliases = extractAliases(m.id, enName, thName, m.titlePinyin, m.dramaName);
+    if (Array.isArray(m.aliases)) aliases.push(...m.aliases);
+    if (Array.isArray(m.keywords)) aliases.push(...m.keywords);
+
+    if (String(m.titleCn || '').toLowerCase().includes('be my poi') || String(m.id || '').includes('be-my-poi')) {
+      aliases.push('be my poi', 'บีมายพอย', 'by my poi', 'be-my-poi');
+    }
+    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');
+    }
+
+    entities.push({
+      type: 'MEDIA',
+      id: m.id,
+      canonicalName: `${thName || enName}`.trim(),
+      nameEn: enName,
+      nameCn: m.titleCn,
+      nameTh: thName,
+      category: m.category || 'Music Video',
+      year: m.releaseYear || m.year,
+      aliases: Array.from(new Set(aliases)),
+      recommendedTools: ['get_music_videos', 'search_discography', 'get_media_links'],
+      raw: m
+    });
+  }
+
+  
+  for (const entity of entities) {
+    entity._compiledAliases = [];
+    for (const alias of entity.aliases) {
+      if (!alias) continue;
+      const minAliasLength = /[\u0E00-\u0E7F]/.test(alias) ? 4 : 2;
+      if (alias.length < minAliasLength) continue;
+
+      const isLatin = /^[a-z0-9\s_-]+$/i.test(alias);
+      if (isLatin) {
+        entity._compiledAliases.push({
+          isLatin: true,
+          alias,
+          regex: new RegExp(`(?:^|[^a-z0-9])${alias.replace(/[-[\]{}()*+?.,\\^$|#\s]/g, '\\$&')}(?:$|[^a-z0-9])`, 'i')
+        });
+      } else {
+        entity._compiledAliases.push({
+          isLatin: false,
+          alias,
+          aliasLower: alias.toLowerCase()
+        });
+      }
+    }
+  }
+
+  cachedIndex = entities;
+  return entities;
+}
+
+export function levenshteinDistance(s1 = '', s2 = '') {
+  if (s1 === s2) return 0;
+  if (!s1) return s2 ? s2.length : 0;
+  if (!s2) return s1 ? s1.length : 0;
+
+  const a = String(s1).toLowerCase().trim();
+  const b = String(s2).toLowerCase().trim();
+  if (a === b) return 0;
+
+  const m = a.length;
+  const n = b.length;
+  if (m === 0) return n;
+  if (n === 0) return m;
+
+
+  let prev = new Array(n + 1);
+  let curr = new Array(n + 1);
+
+  for (let j = 0; j <= n; j++) prev[j] = j;
+
+  for (let i = 1; i <= m; i++) {
+    curr[0] = i;
+    const aChar = a[i - 1];
+    for (let j = 1; j <= n; j++) {
+      const cost = aChar === b[j - 1] ? 0 : 1;
+      curr[j] = Math.min(
+        prev[j] + 1,
+        curr[j - 1] + 1,
+        prev[j - 1] + cost
+      );
+    }
+    const temp = prev;
+    prev = curr;
+    curr = temp;
+  }
+  return prev[n];
+}
+
+export function levenshteinSimilarity(s1 = '', s2 = '', precomputedDist = null) {
+  if (!s1 || !s2) return 0;
+  const maxLen = Math.max(s1.length, s2.length);
+  if (maxLen === 0) return 1.0;
+  const dist = precomputedDist !== null ? precomputedDist : levenshteinDistance(s1, s2);
+  return Number((1.0 - (dist / maxLen)).toFixed(3));
+}
+
+export function levenshteinScore(s1 = '', s2 = '') {
+  const dist = levenshteinDistance(s1, s2);
+  const maxLen = Math.max(s1 ? s1.length : 0, s2 ? s2.length : 0);
+  const sim = maxLen === 0 ? 1.0 : Number((1.0 - (dist / maxLen)).toFixed(3));
+  return { dist, sim };
+}
+
+const RESOLUTION_CACHE = new Map();
+const MAX_RESOLUTION_CACHE = 250;
+
+export function resolveQueryEntities(query = '') {
+  const text = String(query || '').trim();
+  if (!text) {
+    return {
+      matchedEntities: [],
+      hasBrand: false,
+      hasWork: false,
+      hasSong: false,
+      hasMedia: false,
+      hasAward: false,
+      hasTimeline: false,
+      isTimelineIntent: false,
+      isBrandIntent: false,
+      recommendedTools: [],
+      platforms: [],
+      isPromotion: false,
+      primaryBrand: null,
+      primaryWork: null,
+      primarySong: null,
+      contextualChineseKeywords: ['鞠婧祎']
+    };
+  }
+
+  const cacheKey = text.toLowerCase();
+  const cachedResult = RESOLUTION_CACHE.get(cacheKey);
+  if (cachedResult) {
+    return {
+      ...cachedResult,
+      matchedEntities: [...cachedResult.matchedEntities],
+      contextualChineseKeywords: [...cachedResult.contextualChineseKeywords]
+    };
+  }
+
+  const index = buildCatalogIndex();
+  const lowerText = text.toLowerCase();
+  const matchedEntities = [];
+  const seenEntityIds = new Set();
+
+  for (const entity of index) {
+    const matchers = entity._compiledAliases || [];
+    for (const matcher of matchers) {
+      const isMatch = matcher.isLatin
+        ? matcher.regex.test(lowerText)
+        : lowerText.includes(matcher.aliasLower);
+
+      if (isMatch && !seenEntityIds.has(entity.id)) {
+        seenEntityIds.add(entity.id);
+        matchedEntities.push(entity);
+        break;
+      }
+    }
+  }
+
+ 
+  if (matchedEntities.length === 0 && lowerText.length >= 4) {
+    const rawTokens = lowerText
+      .replace(/[^\p{L}\p{N}\s]+/gu, ' ')
+      .trim()
+      .split(/\s+/)
+      .filter(w => w.length >= 2);
+
+    for (const entity of index) {
+      if (seenEntityIds.has(entity.id)) continue;
+      for (const alias of entity.aliases) {
+        if (!alias || alias.length < 5 || STOPWORDS.has(alias.toLowerCase())) continue;
+        const aliasLower = alias.toLowerCase();
+        const aliasWords = aliasLower.split(/\s+/);
+        const aliasWordCount = aliasWords.length;
+
+      
+        if (aliasWordCount >= 2) {
+          for (let i = 0; i <= rawTokens.length - aliasWordCount; i++) {
+            const subPhrase = rawTokens.slice(i, i + aliasWordCount).join(' ');
+            if (subPhrase.length >= 5 && Math.abs(subPhrase.length - aliasLower.length) <= Math.max(2, 0.2 * Math.max(subPhrase.length, aliasLower.length))) {
+              const { dist, sim } = levenshteinScore(subPhrase, aliasLower);
+              if (sim >= 0.80 || (dist <= 2 && subPhrase.length >= 8)) {
+                seenEntityIds.add(entity.id);
+                matchedEntities.push({ ...entity, fuzzyMatched: true, matchedAlias: alias });
+                break;
+              }
+            }
+          }
+        } else {
+          if (aliasLower.length >= 5) {
+            for (const token of rawTokens) {
+              if (STOPWORDS.has(token) || token.length < 5) continue;
+              if (Math.abs(token.length - aliasLower.length) <= 1) {
+                const { dist, sim } = levenshteinScore(token, aliasLower);
+                if (dist <= 1 && sim >= 0.82) {
+                  seenEntityIds.add(entity.id);
+                  matchedEntities.push({ ...entity, fuzzyMatched: true, matchedAlias: alias });
+                  break;
+                }
+              }
+            }
+          }
+        }
+        if (seenEntityIds.has(entity.id)) break;
+      }
+    }
+  }
+
+  const platforms = detectPlatforms(text);
+  const isPromotion = detectPromotionIntent(text);
+
+  const brands = matchedEntities.filter(e => e.type === 'BRAND');
+  const works = matchedEntities.filter(e => e.type === 'WORK');
+  const songs = matchedEntities.filter(e => e.type === 'SONG' || e.type === 'MEDIA');
+  const awards = matchedEntities.filter(e => e.type === 'AWARD');
+  const timelines = matchedEntities.filter(e => e.type === 'TIMELINE');
+  const medias = matchedEntities.filter(e => e.type === 'MEDIA');
+
+  const cnTerms = new Set(['鞠婧祎']);
+  for (const e of matchedEntities) {
+    if (e.nameCn) {
+      const cleanCn = e.nameCn.replace(/\s*\([^)]*\)/g, '').trim();
+      if (cleanCn) cnTerms.add(cleanCn);
+    }
+  }
+
+  const isTimelineIntent = Boolean(
+    /ไทม์ไลน์|timeline|chronology|chronological|时间线|时间轴|按时间线|从时间线|จากไทม์ไลน์|ตามไทม์ไลน์|ในปี\s*\d{4}|in\s*(?:the\s*year\s*)?(?:19\d\d|20\d\d)|(ปี|พ\.ศ\.)\s*\d{4}|(milestone|ประวัติการทำงาน|เส้นทางอาชีพ|เส้นทางในวงการ)/i.test(text) ||
+    timelines.length > 0
+  );
+  const isBrandIntent = Boolean(
+    isPromotion ||
+    /แบรนด์|พรีเซนเตอร์|แอมบาสเดอร์|ambassador|endorsement|tutucare|dafuyan|lafang|fred|prsr|กล่องของขวัญ|สถิติยอดขาย|ยอดขาย/i.test(text) ||
+    brands.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');
+
+  const result = {
+    matchedEntities,
+    hasBrand: brands.length > 0 || isBrandIntent,
+    hasWork: works.length > 0,
+    hasSong: songs.length > 0,
+    hasMedia: medias.length > 0,
+    hasAward: awards.length > 0,
+    hasTimeline: timelines.length > 0 || isTimelineIntent,
+    isTimelineIntent,
+    isBrandIntent,
+    recommendedTools: Array.from(recommendedTools),
+    platforms,
+    isPromotion,
+    primaryBrand: brands[0] || null,
+    primaryWork: works[0] || null,
+    primarySong: songs[0] || null,
+    contextualChineseKeywords: Array.from(cnTerms)
+  };
+
+  if (RESOLUTION_CACHE.size >= MAX_RESOLUTION_CACHE) {
+    RESOLUTION_CACHE.delete(RESOLUTION_CACHE.keys().next().value);
+  }
+  RESOLUTION_CACHE.set(cacheKey, result);
+
+  return result;
+}
+
+export function getContextualizedSearchQuery(keyword = '', platform = 'bilibili') {
+  const raw = String(keyword || '').trim();
+  if (!raw) return '鞠婧祎';
+
+  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);
+      }
+    } else if (resolution.primaryWork) {
+      const cleanCn = resolution.primaryWork.nameCn.replace(/\s*\([^)]*\)/g, '').trim();
+      if (cleanCn && !parts.includes(cleanCn)) parts.push(cleanCn);
+    } else if (resolution.primarySong) {
+      const cleanCn = resolution.primarySong.nameCn.replace(/\s*\([^)]*\)/g, '').trim();
+      if (cleanCn && !parts.includes(cleanCn)) parts.push(cleanCn);
+    } else {
+     
+      const cleanTokens = raw
+        .replace(/^(?:ค้นหา|หา|ดู|เปิด|คลิป|การโปรโมท|โปรโมท|บน|ใน|ที่|bilibili|b站)\s*/gi, '')
+        .trim();
+      if (cleanTokens && !cleanTokens.includes('鞠婧祎')) {
+        parts.push(cleanTokens);
+      }
+    }
+
+    if (resolution.isPromotion && !parts.some(p => p.includes('代言') || p.includes('广告') || p.includes('活动'))) {
+      parts.push('代言');
+    }
+
+    return parts.join(' ').trim();
+  }
+
+
+  if (!raw.toLowerCase().includes('ju jingyi') && !raw.includes('鞠婧祎')) {
+    return `Ju Jingyi 鞠婧祎 ${raw}`;
+  }
+  return raw;
+}