@tencentcloud/sdk-mcp 1.6.8 → 1.7.0

package/knowledge/path-meta.js

@@ -110,7 +110,9 @@ export function inferPathMeta(relativeSource) {
         // 两者都统一标记为 types=['faq']，便于通过 types=faq 命中“经验类问答”。
         if (parts[1] === 'chat' && parts[2] === 'best-practice' && parts.length >= 5) {
             const fwSlug = normalizeFrameworkDir(parts[3]);
-            framework = [fwSlug];
+            // chat best-practice 的 common 目录表示平台通用（Web + 小程序），
+            // 不能按 framework=common 打标，否则会被 framework 硬过滤误排除。
+            framework = fwSlug === 'common' ? ['web', 'miniprogram'] : [fwSlug];
             types.push('faq');
         }
         if (parts[1] === 'chat' && parts[2] === 'faq' && parts.length >= 4) {
@@ -137,13 +139,13 @@ export function inferPathMeta(relativeSource) {
         }
         // callkit 最佳实践目录：knowledge/callkit/best-practice/{platform}/{topic}.md
         // 统一按 FAQ/经验类知识处理，支持 types=faq + frameworks={platform} 的精确检索。
+        // 与 chat best-practice 对齐：common 目录表示多平台通用，按最全集覆盖。
         if (parts[1] === 'callkit' && parts[2] === 'best-practice' && parts.length >= 5) {
-            framework = [normalizeFrameworkDir(parts[3])];
+            const fwSlug = normalizeFrameworkDir(parts[3]);
+            framework = fwSlug === 'common'
+                ? ['react', 'vue', 'miniprogram', 'web', 'android', 'ios', 'flutter', 'uni-app']
+                : [fwSlug];
             types.push('faq');
-            // calls 相关最佳实践既是 FAQ 也是 API 语义，避免 types=api 时被误过滤。
-            if (/(callengine-invitation|callkit-call-vs-calls)\.md$/i.test(fileName)) {
-                types.push('api');
-            }
         }
         if (parts.includes('faq'))
             types.push('faq', 'error_code');
@@ -226,6 +228,15 @@ export function inferPathMeta(relativeSource) {
             types.push('component');
         if (fileName === 'faq.md')
             types.push('faq');
+        // livekit 最佳实践目录：knowledge/livekit/best-practice/{platform}/{topic}.md
+        // 与 chat/callkit 对齐：common 目录表示多平台通用，按最全集覆盖。
+        if (parts[1] === 'livekit' && parts[2] === 'best-practice' && parts.length >= 5) {
+            const fwSlug = normalizeFrameworkDir(parts[3]);
+            framework = fwSlug === 'common'
+                ? ['react', 'vue', 'web', 'android', 'ios', 'flutter']
+                : [fwSlug];
+            types.push('faq');
+        }
         // 与 roomkit 对齐：core-sdk 下 capability-matrix.md / unsupported-features.md
         //   视为能力边界文档（doc_kind + capability_status），方便检索层按 doc_kind 过滤
         const docMeta = inferDocMeta(fileName);
@@ -255,6 +266,15 @@ export function inferPathMeta(relativeSource) {
             types.push('feature');
         if (parts.includes('faq'))
             types.push('faq', 'error_code');
+        // roomkit 最佳实践目录：knowledge/roomkit/best-practice/{platform}/{topic}.md
+        // 与 chat/callkit 对齐：common 目录表示多平台通用，按最全集覆盖。
+        if (parts[1] === 'roomkit' && parts[2] === 'best-practice' && parts.length >= 5) {
+            const fwSlug = normalizeFrameworkDir(parts[3]);
+            framework = fwSlug === 'common'
+                ? ['react', 'vue', 'web', 'android', 'ios', 'flutter']
+                : [fwSlug];
+            types.push('faq');
+        }
         const docMeta = inferDocMeta(fileName);
         doc_kind = docMeta.doc_kind;
         capability_status = docMeta.capability_status ?? capability_status;
@@ -333,5 +353,7 @@ export function inferPathMeta(relativeSource) {
         doc_kind,
         capability_status,
         retrievable_scope,
+        meta_source: 'path',
+        meta_override_fields: [],
     };
 }

package/knowledge/search/exact-lookup.js

@@ -1,6 +1,7 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { normalizeUrlRowQuery, scoreUrlRow } from './url-row-scorer.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const SCHEMA_ROOT = path.resolve(__dirname, '../../resource/_schema');
 export const DOC_PATH_MAP = {
@@ -94,19 +95,6 @@ function loadFeatureAliases() {
     }
     return result;
 }
-/**
- * 将 prompt 按分隔符拆成子句列表，用于 url 行匹配。
- * 分隔符：、 ， , ； ; 空格
- * 保留每个子句的原文（去首尾空白），不引入新词。
- */
-function splitPromptIntoClauses(prompt) {
-    const raw = prompt
-        .replace(/rest\s*api|服务端|server\s*api|api|怎么|如何|什么|用哪个|查询/g, '')
-        .replace(/\s+/g, ' ')
-        .trim();
-    const parts = raw.split(/[、，,；;、\s]+/).filter((p) => p.length >= 2);
-    return parts.length > 0 ? parts : [raw];
-}
 const ROOM_CORE_SIGNAL = /atomicx\s*core|atomicxcore|atomicx|core\s*sdk|无\s*ui|自定义\s*ui|自实现|roomstore|store|useRoomState|useDeviceState|useLoginState/i;
 const ROOM_PRESET_SIGNAL = /预制|preset|roommainview|roommainwidget|默认\s*ui|主页面|房间主页面/i;
 const ROOM_FEATURE_SPECS = [
@@ -149,8 +137,6 @@ const ROOM_FEATURE_SPECS = [
 function detectRoomFeatureHits(prompt) {
     return ROOM_FEATURE_SPECS.filter((spec) => spec.promptPattern.test(prompt));
 }
-const LIVE_LIFECYCLE_PROMPT = /开播|创建直播|结束直播|停播|观看直播|退出直播|进房|离房|createLive|endLive|joinLive|leaveLive|host_streaming|audience_streaming/i;
-const LIVE_LIFECYCLE_APIS = ['createLive', 'endLive', 'joinLive', 'leaveLive'];
 export function runExactLookup(prompt, pool, norm) {
     const boosts = {};
     const exactHits = [];
@@ -318,95 +304,34 @@ export function runExactLookup(prompt, pool, norm) {
             }
         }
         // E7: URL 映射表行级匹配（chunk.title = 子问题列）
-        // 策略：保留整句匹配，同时补充子句拆分 + 逐行匹配，同一 chunk 取最高分。
-        // 子句拆分使 "创建群组、加入群组、发送群组自定义消息" 能命中多行。
-        const clauses = splitPromptIntoClauses(prompt.toLowerCase());
-        const candidates = [];
-        for (const chunk of pool) {
-            if (!chunk.source.includes('knowledge/chat/urls/'))
-                continue;
-            const titleNorm = chunk.title.toLowerCase().replace(/\s+/g, '');
-            if (!titleNorm)
-                continue;
-            // 对每个子句和整句分别打分，取最高分
-            let bestScore = 0;
-            const allParts = [...clauses, prompt.toLowerCase().replace(/\s+/g, '')];
-            // 也按常见分隔符拆分 title 得到 tokens，用于不连续匹配
-            const titleTokens = titleNorm.split(/[\/（(（、,，\s]+/).filter(Boolean);
-            const seen = new Set();
-            for (const part of allParts) {
-                const pn = part.replace(/\s+/g, '');
-                if (pn.length < 2 || seen.has(pn))
+        // 共享 scorer 并行计算 EN token/phrase 与 ZH 子句匹配，取最高分。
+        if (normalizeUrlRowQuery(prompt).replace(/\s+/g, '').length >= 2) {
+            const candidates = [];
+            for (const chunk of pool) {
+                if (!chunk.source.includes('knowledge/chat/urls/'))
                     continue;
-                seen.add(pn);
-                let s = 0;
-                if (pn === titleNorm) {
-                    s = 1000;
-                }
-                else if (titleNorm.includes(pn)) {
-                    const trailing = titleNorm.slice(titleNorm.indexOf(pn) + pn.length);
-                    s = 800 - trailing.length * 80;
-                }
-                else if (pn.includes(titleNorm)) {
-                    s = 700 + titleNorm.length;
-                }
-                else if (titleTokens.some((token) => pn.includes(token) || token.includes(pn))) {
-                    // 子句匹配 title 的 token（如 "创建群组" 匹配 "创建/解散群组（普通群管理）" 中的 "创建" token）
-                    s = 600;
-                }
-                if (s > bestScore)
-                    bestScore = s;
-            }
-            if (bestScore <= 0) {
-                // 退化：子句无匹配时，试 loose（去噪声字 + 单字容错）
-                const qn = clauses[0].replace(/发送/g, '发');
-                if (qn.length >= 3 && titleNorm.includes(qn)) {
-                    bestScore = 500;
-                    if (/批量|群组|群流|广播|导入|公众号|已读|回执/.test(titleNorm)
-                        && !/批量|群组|群|已读|回执/.test(clauses[0])) {
-                        bestScore -= 250;
-                    }
-                    if (/^单发/.test(titleNorm) && /发送|单聊/.test(clauses[0])) {
-                        bestScore += 120;
-                    }
+                if (!chunk.title.trim())
+                    continue;
+                const scoreResult = scoreUrlRow(prompt, chunk.title);
+                if (scoreResult.score > 0) {
+                    candidates.push({ chunk, score: scoreResult.score });
                 }
             }
-            if (bestScore > 0) {
-                candidates.push({ chunk, score: bestScore });
-            }
-        }
-        candidates.sort((a, b) => b.score - a.score);
-        const strongCandidates = candidates
-            .filter(({ score }) => score >= 500)
-            .slice(0, 12);
-        strongCandidates.forEach(({ chunk, score }, idx) => {
-            // 递减 boost：前两条更高，其余保持可召回但不过度压制 BM25
-            // token 匹配（600 分）至少给 150，确保子句拆分的行不被 BM25 原始分压掉
-            const amount = idx === 0
-                ? 200 + Math.min(score, 100)
-                : idx === 1
-                    ? 170 + Math.min(score, 90)
-                    : Math.max(score >= 600 ? 150 : 90, 140 - idx * 8);
-            addBoost(chunk, amount, `E7:url-row:${chunk.title}`);
-            urlRowHitChunkIds.add(chunk.id);
-        });
-    }
-    // E8: 集成查阅意图 boost——prompt 含集成/接入/快速开始/接入文档等意图词时，
-    // 把 {integration|knowledge}/{product}/preset/{fw}/integration.md 系列文件顶到前列。
-    // 解决问题：集成文档内容长、词密度低，BM25 原始分常被短小的 features/ 文档压过。
-    // 注：android-view / ios-uikit 已迁到 knowledge corpus，但同样是集成指引，需要一并 boost。
-    const isIntegrationIntent = /集成|接入|快速开始|快速接入|集成文档|接入文档|集成指南|接入指南|接入流程|集成步骤|如何接入|如何集成|怎么接入|怎么集成/i.test(prompt);
-    if (isIntegrationIntent && norm.product?.length && norm.frameworks?.length) {
-        for (const chunk of pool) {
-            if (!norm.product.includes(chunk.product))
-                continue;
-            const fwMatch = norm.frameworks.some((fw) => chunk.framework.includes(fw));
-            if (!fwMatch)
-                continue;
-            // 命中 preset/{fw}/integration.md 系列（含 integration/ 和 knowledge/ 两种 corpus）
-            if (!chunk.source.includes('/preset/') || (!chunk.source.endsWith('integration.md') && !chunk.source.endsWith('-integration.md')))
-                continue;
-            addBoost(chunk, 120, `E8:integration-doc:${chunk.source}`);
+            candidates.sort((a, b) => b.score - a.score);
+            const strongCandidates = candidates
+                .filter(({ score }) => score >= 500)
+                .slice(0, 12);
+            strongCandidates.forEach(({ chunk, score }, idx) => {
+                // 递减 boost：前两条更高，其余保持可召回但不过度压制 BM25
+                // token 匹配（600 分）至少给 150，确保子句拆分的行不被 BM25 原始分压掉
+                const amount = idx === 0
+                    ? 200 + Math.min(score, 100)
+                    : idx === 1
+                        ? 170 + Math.min(score, 90)
+                        : Math.max(score >= 600 ? 150 : 90, 140 - idx * 8);
+                addBoost(chunk, amount, `E7:url-row:${chunk.title}`);
+                urlRowHitChunkIds.add(chunk.id);
+            });
         }
     }
     // E9: chat faq——types=faq 时优先 knowledge 语料，避免 integration 文档内 FAQ 章节抢首位
@@ -422,28 +347,6 @@ export function runExactLookup(prompt, pool, norm) {
             }
         }
     }
-    // E11: LiveKit 生命周期意图强召回（开播/停播/观看/退出）
-    if (norm.product?.includes('live') && LIVE_LIFECYCLE_PROMPT.test(prompt)) {
-        const queryApiHits = LIVE_LIFECYCLE_APIS.filter((api) => new RegExp(api, 'i').test(prompt));
-        for (const chunk of pool) {
-            const isLiveCoreIntegration = chunk.source.startsWith('knowledge/livekit/core-sdk/live/')
-                && chunk.source.endsWith('/integration.md');
-            const isVoiceCoreIntegration = chunk.source.startsWith('knowledge/livekit/core-sdk/voice/')
-                && chunk.source.endsWith('/integration.md');
-            if (!isLiveCoreIntegration && !isVoiceCoreIntegration)
-                continue;
-            if (norm.scenario === 'live' && !isLiveCoreIntegration)
-                continue;
-            if (norm.scenario === 'voice' && !isVoiceCoreIntegration)
-                continue;
-            addBoost(chunk, 140, 'E11:live-lifecycle-core-integration');
-            for (const api of queryApiHits) {
-                if (chunk.api_names?.some((name) => name.toLowerCase() === api.toLowerCase())) {
-                    addBoost(chunk, 160, `E11:live-lifecycle-api:${api}`);
-                }
-            }
-        }
-    }
     // E10: roomkit Core/Preset 消歧 + unsupported feature 强召回
     if (norm.product?.includes('room') && norm.frameworks?.length) {
         const platform = norm.frameworks.find((fw) => ['android', 'ios', 'flutter', 'vue'].includes(fw));

package/knowledge/search/filter-pool.js

@@ -1,5 +1,6 @@
 import { downgradeToProductType } from './product-scope-intent.js';
 import { normalizeQueryPrompt } from './query-normalizer.js';
+import { hasExplicitFrameworkMatch, hasFrameworkFallbackMatch } from './framework-fallback.js';
 /**
  * MCP framework enum → index 中对应的 framework 值列表。
  * path-meta.ts 已通过 normalizeFrameworkDir 把目录名归一到标准 framework，
@@ -42,14 +43,6 @@ function resolveTypes(products, types, prompt, frameworks) {
         return undefined;
     const downgraded = downgradeToProductType(products, types, prompt, frameworks);
     const expanded = expandTypeAliases(downgraded);
-    // Live 生命周期兼容：用户常传 types=['api']，但核心生命周期方法来自 core-sdk/live|voice/*/integration.md。
-    // 这里补充 core/integration，避免被类型硬过滤提前排除。
-    if (products?.includes('live') && expanded.includes('api') && LIVE_LIFECYCLE_PROMPT.test(prompt)) {
-        if (!expanded.includes('core'))
-            expanded.push('core');
-        if (!expanded.includes('integration'))
-            expanded.push('integration');
-    }
     return expanded;
 }
 /** 单平台产品的隐式 framework 推断：避免对显然唯一的平台再发起询问 */
@@ -133,33 +126,23 @@ export function filterPool(chunks, norm) {
             // 收紧：framework=['*'] 仅在该 chunk 明确是跨平台 type（product/server_api/webhook）时放行；
             // 否则要求 chunk.framework 与请求 framework 有交集。
             const wildcardAllowed = isWildcardChunk && chunkIsCrossPlatform(chunk.types);
-            const explicitMatch = norm.frameworks.some((fw) => chunk.framework.includes(fw));
-            // CallKit 特例：core-sdk 仍维持 web 单套（纯 JS），允许 react/vue 查询命中 core-sdk/web。
-            const callCoreWebFallback = Boolean(norm.product?.includes('call')
-                && (norm.framework === 'react' || norm.framework === 'vue')
-                && chunk.variant === 'core-sdk'
-                && chunk.framework.includes('web'));
-            // Live 特例：写写侧把 'Web' 平台归到 livekit/core-sdk/api-reference/{vue,web} 目录（写写节点名是 'Web'），
-            // 本地目录重命名为 'vue' 后 framework 标签变为 'vue'。'web' 查询仍应能命中这些 chunk。
-            const liveWebVueFallback = Boolean(norm.product?.includes('live')
-                && norm.framework === 'web'
-                && chunk.variant === 'core-sdk'
-                && chunk.framework.includes('vue')
-                && chunk.source.includes('/api-reference/'));
-            // Room 特例：Conference Web 实际语料在 roomkit/core-sdk/vue，web 查询应可命中。
-            const roomWebVueFallback = Boolean(norm.product?.includes('room')
-                && norm.framework === 'web'
-                && chunk.variant === 'core-sdk'
-                && chunk.framework.includes('vue')
-                && chunk.source.includes('knowledge/roomkit/core-sdk/vue/'));
-            if (!explicitMatch && !wildcardAllowed && !callCoreWebFallback && !liveWebVueFallback && !roomWebVueFallback)
+            const explicitMatch = hasExplicitFrameworkMatch(chunk.framework, norm.frameworks);
+            const fallbackMatch = hasFrameworkFallbackMatch(chunk, {
+                product: norm.product,
+                framework: norm.framework,
+                frameworks: norm.frameworks,
+            });
+            if (!explicitMatch && !wildcardAllowed && !fallbackMatch)
                 return false;
         }
         if (norm.scenario && chunk.scenario && chunk.scenario !== norm.scenario) {
             return false;
         }
+        // best-practice 文档对 types 过滤免疫：内容不依赖 types 分类，应始终进 pool 靠 BM25 自然排名。
+        // 典型场景：Agent 传 types=['api'] 时，types=['faq'] 的 best-practice 不应被过滤掉。
         if (norm.types?.length && !norm.types.some((t) => chunk.types.includes(t))) {
-            return false;
+            if (!chunk.source.includes('/best-practice/'))
+                return false;
         }
         return true;
     });

package/knowledge/search/framework-fallback.js

@@ -0,0 +1,22 @@
+export function hasExplicitFrameworkMatch(chunkFrameworks, requestFrameworks) {
+    if (!requestFrameworks?.length)
+        return false;
+    return requestFrameworks.some((fw) => chunkFrameworks.includes(fw));
+}
+export function hasFrameworkFallbackMatch(chunk, opts) {
+    const callCoreWebFallback = Boolean(opts.product?.includes('call')
+        && (opts.framework === 'react' || opts.framework === 'vue')
+        && chunk.variant === 'core-sdk'
+        && chunk.framework.includes('web'));
+    const liveWebVueFallback = Boolean(opts.product?.includes('live')
+        && opts.framework === 'web'
+        && chunk.variant === 'core-sdk'
+        && chunk.framework.includes('vue')
+        && chunk.source.includes('/api-reference/'));
+    const roomWebVueFallback = Boolean(opts.product?.includes('room')
+        && opts.framework === 'web'
+        && chunk.variant === 'core-sdk'
+        && chunk.framework.includes('vue')
+        && chunk.source.includes('knowledge/roomkit/core-sdk/vue/'));
+    return callCoreWebFallback || liveWebVueFallback || roomWebVueFallback;
+}

package/knowledge/search/intent-router.js

@@ -0,0 +1,13 @@
+/** 枚举/目录浏览意图 */
+const DISCOVERY_INTENT_RE = /有哪些|支持哪些|列一下|清单|目录|可用|全部|全量|对比|怎么选|选哪个|which\s+one|compare|comparison|what\s+(is|are)\s+available|what\s+.*\b(components?|features?|apis?)\b|available\s+(components?|features?|apis?)|supported\s+(components?|features?|apis?)|list\s+(all|available)|catalog/i;
+/** 显式完整文档意图（用户明确说"完整/从零/step by step"） */
+const NARRATIVE_INTENT_RE = /从头到尾|一步一步|完整指南|完整教程|完整流程|完整接入|完整集成|完整的\s*(接入|集成|教程|指南|流程)|从零|全流程|接入指南|集成指南|step\s*by(?:\s*step)?|end[-\s]?to[-\s]?end|full\s+(guide|tutorial|flow|integration)|complete\s+(guide|tutorial|integration)|quick\s*start|getting\s*started/i;
+/** 强 point 信号：提到具体 API/错误码/参数 → 即使同时命中 narrative 关键词也优先走 point */
+const POINT_STRONG_SIGNAL_RE = /\b\d{5,7}\b|\bERR_[A-Z0-9_]+\b|\buse[A-Z]\w*\b|\b[A-Z][A-Za-z0-9_]*\.[A-Za-z_][A-Za-z0-9_]*\b|\b(TRTC|TX)[A-Za-z0-9_]+\b|\bprops?\b|\b参数\b|\b事件\b|\b回调\b|\berror\s*code\b|错误码|怎么用|如何用|参数是什么/i;
+export function classifyRetrievalMode(prompt) {
+    if (NARRATIVE_INTENT_RE.test(prompt) && !POINT_STRONG_SIGNAL_RE.test(prompt))
+        return 'narrative';
+    if (DISCOVERY_INTENT_RE.test(prompt))
+        return 'discovery';
+    return 'point';
+}

package/knowledge/search/query-normalizer.js

@@ -5,6 +5,46 @@ const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const SCHEMA_ROOT = path.resolve(__dirname, '../../resource/_schema');
 const QUERY_NORMALIZATION_FILE = path.join(SCHEMA_ROOT, 'query-normalization.yaml');
 const MAX_APPEND_TOKENS = 6;
+const BASE_QUERY_NORMALIZATION = {
+    literal: {
+        登录: ['login', 'signin', 'authentication', 'auth'],
+        鉴权: ['authentication', 'auth', 'usersig'],
+        错误码: ['error', 'error code', 'code'],
+        重复登录: ['repeat login', 'multi-device login', 'login policy'],
+        单聊: ['one-to-one', 'c2c', 'single chat'],
+        群聊: ['group chat', 'group message'],
+        直播群: ['avchatroom'],
+        直播间: ['avchatroom', 'live room'],
+        丢消息: ['message loss', 'reliability', 'priority'],
+        消息丢失: ['message loss', 'reliability', 'priority'],
+        重要消息: ['priority', 'high priority', 'critical message'],
+        用户: ['user', 'account'],
+        消息: ['message', 'messages'],
+        userSig: ['usersig', 'auth', 'authentication'],
+        AVChatRoom: ['直播群'],
+        'error code': ['错误码', '错误', 'code'],
+        'repeat login': ['重复登录', '多端登录', 'login policy'],
+        'one-to-one': ['单聊', 'c2c', 'single chat'],
+    },
+    word: {
+        login: ['登录', '鉴权', 'authentication', 'auth'],
+        auth: ['鉴权', '登录', 'authentication'],
+        authentication: ['鉴权', '登录', 'auth'],
+        usersig: ['userSig', '鉴权', '登录'],
+        error: ['错误', '错误码', 'error code'],
+        code: ['错误码', 'error code'],
+        message: ['消息', 'chat', 'conversation'],
+        messages: ['消息', 'chat', 'conversation'],
+        group: ['群组', '群聊', 'group chat'],
+        c2c: ['单聊', 'one-to-one', 'single chat'],
+        webhook: ['回调', 'webhook', 'callbacks'],
+        avchatroom: ['直播群'],
+        priority: ['重要消息', '优先级'],
+        reliability: ['消息可靠性'],
+        'message loss': ['丢消息', '消息丢失'],
+        'rate limit': ['限频', '刷屏'],
+    },
+};
 let cachedConfig = null;
 function unquote(input) {
     return input.trim().replace(/^['"]|['"]$/g, '');
@@ -12,7 +52,10 @@ function unquote(input) {
 function loadQueryNormalizationConfig() {
     if (cachedConfig)
         return cachedConfig;
-    const config = { literal: {}, word: {} };
+    const config = {
+        literal: { ...BASE_QUERY_NORMALIZATION.literal },
+        word: { ...BASE_QUERY_NORMALIZATION.word },
+    };
     if (!fs.existsSync(QUERY_NORMALIZATION_FILE)) {
         cachedConfig = config;
         return config;
@@ -46,6 +89,17 @@ function loadQueryNormalizationConfig() {
 function escapeRegExp(value) {
     return value.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
+function hasCjk(text) {
+    return /[\u4e00-\u9fff]/.test(text);
+}
+function hasWordMatch(prompt, promptLower, needle) {
+    const normalizedNeedle = needle.toLowerCase();
+    if (hasCjk(normalizedNeedle)) {
+        return prompt.includes(needle);
+    }
+    const pattern = new RegExp(`\\b${escapeRegExp(normalizedNeedle)}\\b`, 'i');
+    return pattern.test(promptLower);
+}
 export function normalizeQueryPrompt(prompt) {
     const config = loadQueryNormalizationConfig();
     const terms = new Set(prompt.split(/\s+/).filter(Boolean));
@@ -67,8 +121,7 @@ export function normalizeQueryPrompt(prompt) {
         tryAppend(expansion);
     }
     for (const [needle, expansion] of Object.entries(config.word)) {
-        const pattern = new RegExp(`\\b${escapeRegExp(needle.toLowerCase())}\\b`, 'i');
-        if (!pattern.test(promptLower))
+        if (!hasWordMatch(prompt, promptLower, needle))
             continue;
         tryAppend(expansion);
     }