@tencent-rtc/mcp 1.4.7 → 1.6.0

package/knowledge/path-meta.js

@@ -0,0 +1,184 @@
+function uniq(arr) {
+    return [...new Set(arr)];
+}
+function inferTypesFromFilename(fileName, baseTypes) {
+    const types = [...baseTypes];
+    const lower = fileName.toLowerCase();
+    if (/error.?code|txliteavcode/.test(lower))
+        types.push('error_code');
+    if (lower === 'client-api.md' || lower === 'api.md' || lower === 'index.md')
+        types.push('api');
+    if (lower === 'faq.md')
+        types.push('faq');
+    if (lower === 'integration.md' || lower.endsWith('-integration.md'))
+        types.push('integration');
+    if (/live-.*-interaction|voice-/.test(lower))
+        types.push('feature');
+    if (lower.includes('plugin') || /^\d+-advanced-/.test(lower))
+        types.push('plugin');
+    return uniq(types);
+}
+/** 目录名 → 标准 framework 值：消除 android-view / ios-uikit 这类内部目录命名泄漏到元数据标签 */
+const DIR_TO_FRAMEWORK = {
+    'android-view': 'android',
+    'ios-uikit': 'ios',
+};
+function normalizeFrameworkDir(dir) {
+    return DIR_TO_FRAMEWORK[dir] ?? dir;
+}
+export function inferPathMeta(relativeSource) {
+    const normalized = relativeSource.replace(/\\/g, '/');
+    const parts = normalized.split('/');
+    const corpus = parts[0] === 'integration' ? 'integration' : 'knowledge';
+    const fileName = parts[parts.length - 1] ?? '';
+    let product = '*';
+    let framework = ['*'];
+    let types = corpus === 'integration' ? ['integration'] : [];
+    let scenario = null;
+    if (normalized.startsWith('knowledge/chat/') || normalized.startsWith('integration/chat/')) {
+        product = 'chat';
+        if (parts.includes('preset') && parts.length >= 4) {
+            framework = [normalizeFrameworkDir(parts[parts.indexOf('preset') + 1])];
+        }
+        if (parts.includes('features')) {
+            types.push('feature');
+            if (parts.includes('preset')) {
+                const fw = normalizeFrameworkDir(parts[parts.indexOf('preset') + 1]);
+                if (fw === 'vue' || fw === 'react') {
+                    types.push('component');
+                }
+            }
+        }
+        if (parts.includes('urls')) {
+            if (fileName === 'product.md')
+                types.push('product');
+            else if (fileName === 'restapi.md')
+                types.push('server_api');
+            else if (fileName === 'webhook.md')
+                types.push('webhook');
+            else if (fileName === 'error-code.md')
+                types.push('error_code');
+            const urlsSdkIdx = parts.indexOf('sdk');
+            if (urlsSdkIdx >= 0 && parts[urlsSdkIdx - 1] === 'urls') {
+                const sdkFile = parts[urlsSdkIdx + 1];
+                if (sdkFile?.endsWith('.md')) {
+                    framework = [sdkFile.replace(/\.md$/, '')];
+                    types.push('sdk', 'api');
+                }
+            }
+        }
+        if (fileName === 'faq.md')
+            types.push('faq');
+    }
+    else if (normalized.includes('/callkit/')) {
+        product = 'call';
+        const presetIdx = parts.indexOf('preset');
+        const coreIdx = parts.indexOf('core-sdk');
+        if (presetIdx >= 0 && parts[presetIdx + 1])
+            framework = [normalizeFrameworkDir(parts[presetIdx + 1])];
+        if (coreIdx >= 0 && parts[coreIdx + 1])
+            framework = [normalizeFrameworkDir(parts[coreIdx + 1])];
+        if (parts.includes('faq'))
+            types.push('faq', 'error_code');
+        if (fileName === 'api.md')
+            types.push('api');
+        if (coreIdx >= 0)
+            types.push('api', 'feature');
+    }
+    else if (normalized.includes('/livekit/')) {
+        product = 'live';
+        if (parts.includes('voice'))
+            scenario = 'voice';
+        if (parts.includes('/live/'))
+            scenario = 'live';
+        if (parts.includes('preset') && parts.includes('vue'))
+            framework = ['vue'];
+        if (parts.includes('core-sdk') && parts.length >= 4) {
+            const fwIdx = parts.indexOf('core-sdk') + 2;
+            if (parts[fwIdx] && !['live', 'voice'].includes(parts[fwIdx])) {
+                framework = [normalizeFrameworkDir(parts[fwIdx])];
+            }
+        }
+        if (parts.includes('components') || (parts.includes('features') && parts.includes('preset')))
+            types.push('component');
+        if (parts.includes('api-reference'))
+            types.push('api');
+        if (parts.includes('core-sdk'))
+            types.push('feature', 'api');
+        if (parts.includes('faq'))
+            types.push('faq', 'error_code');
+        if (fileName === 'faq.md')
+            types.push('faq');
+    }
+    else if (normalized.includes('/roomkit/')) {
+        product = 'room';
+        const presetIdx = parts.indexOf('preset');
+        const coreIdx = parts.indexOf('core-sdk');
+        if (presetIdx >= 0 && parts[presetIdx + 1]) {
+            framework = [normalizeFrameworkDir(parts[presetIdx + 1])];
+        }
+        if (coreIdx >= 0 && parts[coreIdx + 1]) {
+            framework = [normalizeFrameworkDir(parts[coreIdx + 1])];
+        }
+        if (parts.includes('features') || parts.includes('core-sdk'))
+            types.push('feature');
+        if (parts.includes('faq'))
+            types.push('faq', 'error_code');
+    }
+    else if (normalized.startsWith('knowledge/trtc/')) {
+        product = 'native_trtc_sdk';
+        framework = [parts[2] ?? '*'];
+        types.push('api', 'error_code');
+    }
+    else if (normalized.startsWith('knowledge/rtcengine/')) {
+        product = 'rtcengine';
+        framework = ['web'];
+        if (parts.includes('plugin'))
+            types.push('plugin');
+        types.push('api', 'faq');
+    }
+    else if (normalized.startsWith('knowledge/push/')) {
+        // push 结构：
+        //   knowledge/push/overview/{topic}.md                  → 跨平台综述（接入前准备/流程/选型/计费等），framework=*，types=[product]
+        //   knowledge/push/integration/{platform}.md            → framework=平台 slug，types=[integration]
+        //   knowledge/push/config/{platform}.md                 → 与写写平台级配置页保持一致，framework=平台 slug，types=[integration]
+        product = 'push';
+        const category = parts[2]; // overview | integration | config
+        if (category === 'overview') {
+            framework = ['*'];
+            types.push('product');
+        }
+        else if (category === 'integration') {
+            const fwSlug = fileName.replace(/\.mdx?$/, ''); // android / ios / donut / ...
+            if (fwSlug) {
+                framework = [fwSlug];
+            }
+            types.push('integration');
+        }
+        else if (category === 'config') {
+            // config/{platform}.md：与写写平台级配置页 1:1 对齐（Android 厂商信息收敛在 android.md 正文内）
+            const platform = (parts[3] ?? fileName).replace(/\.mdx?$/, '');
+            framework = [platform];
+            types.push('integration', 'config');
+        }
+        else {
+            types.push('integration');
+        }
+    }
+    if (corpus === 'integration') {
+        types = ['integration'];
+    }
+    else if (types.length === 0) {
+        types = ['faq'];
+    }
+    types = inferTypesFromFilename(fileName, types);
+    if (types.length === 0)
+        types = ['faq'];
+    return {
+        product,
+        framework,
+        types: uniq(types),
+        scenario,
+        corpus,
+    };
+}

package/knowledge/search/exact-lookup.js

@@ -0,0 +1,497 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+const SCHEMA_ROOT = path.resolve(__dirname, '../../resource/_schema');
+export const DOC_PATH_MAP = {
+    android: {
+        core_api: 'TRTCCloud',
+        type_def: 'TRTCCloudDef',
+        callback: 'TRTCCloudListener',
+        statistics: 'TRTCStatistics',
+        audio_effect: 'TXAudioEffectManager',
+        beauty: 'TXBeautyManager',
+        device: 'TXDeviceManager',
+        error_code: 'TXLiteAVCode',
+    },
+    ios: {
+        core_api: 'TRTCCloud',
+        type_def: 'TXLiveSDKTypeDef',
+        callback: 'TRTCCloudDelegate',
+        statistics: 'TRTCStatistics',
+        audio_effect: 'TXAudioEffectManager',
+        beauty: 'TXBeautyManager',
+        device: 'TXDeviceManager',
+        error_code: 'TXLiteAVCode',
+    },
+    'c++': {
+        core_api: 'ITRTCCloud',
+        type_def: 'TRTCTypeDef',
+        callback: 'TRTCCloudCallback',
+        statistics: 'ITRTCStatistics',
+        audio_effect: 'ITXAudioEffectManager',
+        beauty: null,
+        device: 'ITXDeviceManager',
+        error_code: 'TXLiteAVCode',
+    },
+};
+export function inferNativeTRTCIntents(prompt) {
+    const normalizedPrompt = prompt.toLowerCase();
+    if (/enterroom|exitroom|startlocalpreview|mutelocalaudio|trtccloud\.|setlocal|setremote/.test(normalizedPrompt)) {
+        return ['core_api'];
+    }
+    if (/错误|报错|error|warning|code|排查/.test(normalizedPrompt)) {
+        return ['error_code'];
+    }
+    if (/回调|事件|监听|delegate|listener|callback|on[A-Z]/.test(prompt)) {
+        return ['callback'];
+    }
+    if (/参数|结构体|枚举|typedef|type ?def|trtcparams|编码|配置/.test(normalizedPrompt)) {
+        return ['type_def'];
+    }
+    if (/统计|网络质量|码率|帧率|statistics/.test(normalizedPrompt)) {
+        return ['statistics'];
+    }
+    if (/音效|bgm|混响|耳返|audio/.test(normalizedPrompt)) {
+        return ['audio_effect'];
+    }
+    if (/美颜|滤镜|beauty/.test(normalizedPrompt)) {
+        return ['beauty'];
+    }
+    if (/设备|摄像头|麦克风|扬声器|device/.test(normalizedPrompt)) {
+        return ['device'];
+    }
+    return ['core_api', 'error_code'];
+}
+function loadJson(fileName, fallback) {
+    const filePath = path.join(SCHEMA_ROOT, fileName);
+    if (!fs.existsSync(filePath))
+        return fallback;
+    return JSON.parse(fs.readFileSync(filePath, 'utf-8'));
+}
+const E7_EN_STOPWORDS = new Set([
+    'the', 'and', 'for', 'with', 'from', 'into', 'about', 'using', 'via',
+    'how', 'what', 'where', 'when', 'which', 'please', 'docs', 'documentation',
+    'tencent', 'im', 'rest', 'server', 'webhook', 'webhooks',
+]);
+/** Generic terms — excluded from API-token hits to avoid false positives */
+const E7_GENERIC_TERMS = new Set([
+    'message', 'messages', 'group', 'groups', 'user', 'users', 'account', 'accounts',
+    'send', 'get', 'set', 'delete', 'create', 'update', 'query', 'before', 'after',
+    'webhook', 'friend', 'single', 'multiple', 'history', 'chat', 'sdk', 'api',
+    'profile', 'conversation', 'import', 'recall', 'modify', 'pull', 'mark', 'data',
+    'list', 'online', 'status', 'custom', 'attributes', 'counter', 'member', 'members',
+    'management', 'overview', 'integration', 'initialization', 'billing', 'topic',
+    'topics', 'community', 'robot', 'chatbot', 'streaming', 'broadcast', 'official',
+    'extension', 'receipt', 'receipts', 'global', 'mute', 'ban', 'unban', 'forbid',
+    'ordinary', 'specified', 'historical', 'unread', 'read', 'configure', 'configuration', 'invalidate',
+    'invalidating', 'disband', 'change', 'search', 'cloud', 'local', 'robot', 'bots',
+]);
+const E7_QUERY_NOISE = /\b(rest\s*ful?\s*api|rest\s*api|server\s*api|webhook|webhooks|how\s+to|how\s+do\s+i|what\s+is|where\s+is|please|documentation|docs?)\b/gi;
+const E7_QUERY_NOISE_CN = /怎么|如何|什么|用哪个|查询|服务端/g;
+const E7_PHRASES = [
+    'before send one-to-one message',
+    'after send one-to-one message',
+    'one-to-one message',
+    'group message',
+    'recall group message',
+    'recall one-to-one message',
+    'send one-to-one message',
+    'send single chat message',
+    'getmessagelist',
+    'message history',
+    'add friend',
+    'import single account',
+    'import a single account',
+    'multi-device login',
+    'multi device login',
+    'login policy',
+    'login strategy',
+    'message storage duration',
+    'roaming message storage',
+];
+function extractRestEndpoints(text) {
+    return [...text.matchAll(/v4\/[\w/]+/gi)].map((m) => m[0].toLowerCase());
+}
+function extractE7ApiTokens(text) {
+    const tokens = new Set();
+    for (const match of text.matchAll(/\b([a-z][a-z0-9_]{2,})\b/gi)) {
+        const token = match[1].toLowerCase();
+        if (!E7_GENERIC_TERMS.has(token) && !E7_EN_STOPWORDS.has(token))
+            tokens.add(token);
+    }
+    for (const match of text.matchAll(/\b([A-Z][A-Za-z0-9]*(?:\.[A-Za-z]\w*)?)\b/g)) {
+        const token = match[1].toLowerCase();
+        if (!E7_GENERIC_TERMS.has(token))
+            tokens.add(token);
+    }
+    for (const match of text.matchAll(/([a-z]+[A-Z][A-Za-z0-9]*)/g)) {
+        tokens.add(match[1].toLowerCase());
+    }
+    return [...tokens];
+}
+function normalizeE7Text(text) {
+    return text
+        .toLowerCase()
+        .replace(E7_QUERY_NOISE, ' ')
+        .replace(E7_QUERY_NOISE_CN, '')
+        .replace(/[^\w\u4e00-\u9fff/]+/g, ' ')
+        .replace(/\s+/g, ' ')
+        .trim();
+}
+function phraseBonus(query, title) {
+    const q = query.toLowerCase().replace(/\s+/g, ' ');
+    const t = title.toLowerCase();
+    let bonus = 0;
+    for (const phrase of E7_PHRASES) {
+        if (q.includes(phrase) && t.includes(phrase))
+            bonus += 180;
+    }
+    if (/send single chat message/.test(q) && /send one-to-one message/.test(t))
+        bonus += 200;
+    if (/recall group message/.test(q) && /recall group message/.test(t))
+        bonus += 200;
+    if (/before send one-to-one message/.test(q) && /before send one-to-one message/.test(t))
+        bonus += 220;
+    if (/\bbefore\b/.test(q) && t.startsWith('before '))
+        bonus += 120;
+    if (/\bafter\b/.test(q) && t.startsWith('after '))
+        bonus += 120;
+    if (/多端登录/.test(query) && /多端登录|multi[\s-]?device/i.test(title))
+        bonus += 220;
+    if (/登录策略|login\s*(policy|strategy)/i.test(query) && /登录策略|login\s*(policy|strategy)/i.test(title))
+        bonus += 200;
+    return bonus;
+}
+function scoreE7UrlRow(query, title) {
+    const queryEndpoints = extractRestEndpoints(query);
+    const titleEndpoints = extractRestEndpoints(title);
+    for (const qe of queryEndpoints) {
+        if (titleEndpoints.some((te) => te === qe || te.endsWith(qe) || qe.endsWith(te))) {
+            return 1000;
+        }
+    }
+    let score = phraseBonus(query, title);
+    const titleLower = title.toLowerCase();
+    const queryApis = extractE7ApiTokens(query);
+    let apiHits = 0;
+    let longApiHit = false;
+    for (const api of queryApis) {
+        if (!titleLower.includes(api))
+            continue;
+        apiHits += 1;
+        if (api.length >= 8)
+            longApiHit = true;
+    }
+    if (longApiHit)
+        score = Math.max(score, 940);
+    else if (apiHits >= 2)
+        score = Math.max(score, 900);
+    else if (apiHits === 1)
+        score = Math.max(score, 860);
+    const qNorm = normalizeE7Text(query);
+    const tNorm = normalizeE7Text(title);
+    const qTokens = qNorm.split(' ').filter((t) => t.length >= 3 && !E7_GENERIC_TERMS.has(t));
+    const tTokens = tNorm.split(' ').filter((t) => t.length >= 3 && !E7_GENERIC_TERMS.has(t));
+    let overlap = 0;
+    for (const qt of qTokens) {
+        if (tTokens.some((tt) => tt.includes(qt) || qt.includes(tt)))
+            overlap += 1;
+    }
+    if (overlap >= 3)
+        score = Math.max(score, 720 + overlap * 15);
+    else if (overlap >= 2)
+        score = Math.max(score, 650);
+    else if (overlap >= 1)
+        score = Math.max(score, 520);
+    const qCompact = qNorm.replace(/\s+/g, '');
+    const tCompact = tNorm.replace(/\s+/g, '');
+    if (qCompact.length >= 5 && tCompact.includes(qCompact)) {
+        score = Math.max(score, 560 - Math.min(tCompact.length - qCompact.length, 80));
+    }
+    else if (tCompact.length >= 5 && qCompact.includes(tCompact)) {
+        score = Math.max(score, 500 + Math.min(tCompact.length, 30));
+    }
+    const qCjk = query.replace(/[^\u4e00-\u9fff]/g, '');
+    const tCjk = title.replace(/[^\u4e00-\u9fff]/g, '');
+    if (qCjk.length >= 2 && tCjk.includes(qCjk)) {
+        let cjkScore = 500;
+        if (/批量|群组|群流|广播|导入|公众号|已读|回执/.test(tCjk) && !/批量|群组|群|已读|回执/.test(qCjk)) {
+            cjkScore -= 250;
+        }
+        if (/^单发/.test(tCjk) && /发送|单聊/.test(qCjk))
+            cjkScore += 120;
+        score = Math.max(score, cjkScore);
+    }
+    if (score <= 0)
+        return 0;
+    const queryL = query.toLowerCase();
+    const titleL = title.toLowerCase();
+    if (/group/.test(queryL) && /one-to-one|c2c/.test(titleL) && !/group/.test(titleL))
+        score -= 400;
+    if (/one-to-one|c2c|single chat/.test(queryL) && /import.*account|add friend/.test(titleL))
+        score -= 400;
+    if (/send.*message|one-to-one message/.test(queryL) && /add friend|import.*account/.test(titleL))
+        score -= 400;
+    if (/getmessagelist|message history/.test(qCompact) && /integration|initialization/.test(titleL) && !/getmessagelist|history/.test(tCompact))
+        score -= 400;
+    if (/extension/.test(titleL) && !/extension/.test(queryL))
+        score -= 350;
+    if (/\bbefore\b/.test(queryL) && !/^before\b/.test(titleL.trim()))
+        score -= 250;
+    if (/\bafter\b/.test(queryL) && !/^after\b/.test(titleL.trim()))
+        score -= 250;
+    if (/batch|multiple/.test(titleL) && !/batch|multiple/.test(queryL))
+        score -= 200;
+    if (/group/.test(titleL) && !/group|channel/.test(queryL) && /one-to-one|c2c|single chat/.test(queryL))
+        score -= 200;
+    return Math.max(score, 0);
+}
+function loadFeatureAliases() {
+    const filePath = path.join(SCHEMA_ROOT, 'feature-aliases.yaml');
+    if (!fs.existsSync(filePath))
+        return {};
+    const text = fs.readFileSync(filePath, 'utf-8');
+    const result = {};
+    let currentProduct = '';
+    for (const line of text.split('\n')) {
+        const productMatch = line.match(/^(\w+):$/);
+        if (productMatch) {
+            currentProduct = productMatch[1];
+            result[currentProduct] = {};
+            continue;
+        }
+        const aliasMatch = line.match(/^\s+([\w.-]+\.md):\s*\[(.+)\]/);
+        if (aliasMatch && currentProduct) {
+            const aliases = aliasMatch[2]
+                .split(',')
+                .map((s) => s.trim().replace(/^["']|["']$/g, ''))
+                .filter(Boolean);
+            result[currentProduct][aliasMatch[1]] = aliases;
+        }
+    }
+    return result;
+}
+export function runExactLookup(prompt, pool, norm) {
+    const boosts = {};
+    const exactHits = [];
+    const lowerPrompt = prompt.toLowerCase();
+    const addBoost = (chunk, amount, label) => {
+        boosts[chunk.id] = (boosts[chunk.id] ?? 0) + amount;
+        if (!exactHits.includes(label))
+            exactHits.push(label);
+    };
+    // E1: error codes
+    const errorMatches = [
+        ...prompt.matchAll(/\b(\d{5,7})\b/g),
+        ...prompt.matchAll(/\b(ERR_[A-Z0-9_]+)\b/g),
+    ];
+    for (const match of errorMatches) {
+        const code = match[1];
+        for (const chunk of pool) {
+            if (chunk.error_codes.includes(code) || chunk.title.includes(code)) {
+                addBoost(chunk, 200, `E1:${code}`);
+            }
+        }
+    }
+    // P1-3：跟踪 E2 已 boost 的文件，避免 E4 在同文件重复满额放大（双重 boost 会压垮 BM25 文件内排序）
+    const e2BoostedFiles = new Set();
+    // E2: native TRTC intents（只在传了 framework 时 boost；未传 framework 由 requires-framework 拦截）
+    // 衰减策略：同文件首 chunk +100，第 2 个 +50，第 3 个 +25 ...（下限 +5），
+    // 让 BM25 原始打分主导文件内方法级排序，避免「createSubCloud 顶掉 enterRoom」。
+    if (norm.product?.includes('native_trtc_sdk') && norm.frameworks?.length) {
+        const intents = inferNativeTRTCIntents(prompt);
+        for (const fw of norm.frameworks) {
+            const platformMap = DOC_PATH_MAP[fw];
+            if (!platformMap)
+                continue;
+            for (const intent of intents) {
+                const docName = platformMap[intent];
+                if (!docName)
+                    continue;
+                const target = `knowledge/trtc/${fw}/${docName}.md`;
+                // 收集同文件 chunks 按 char_start 排序（即文件内顺序）
+                const fileChunks = pool
+                    .filter((c) => c.source === target || c.source.endsWith(`/${docName}.md`))
+                    .sort((a, b) => a.char_start - b.char_start);
+                for (let i = 0; i < fileChunks.length; i += 1) {
+                    const decay = Math.max(5, Math.floor(100 / Math.pow(2, i)));
+                    addBoost(fileChunks[i], decay, `E2:${docName}`);
+                    e2BoostedFiles.add(fileChunks[i].source);
+                }
+            }
+        }
+    }
+    // E3: component slugs
+    const componentSlugs = loadJson('../index/component-slugs.json', {});
+    const indexPath = path.resolve(__dirname, '../../resource/index/component-slugs.json');
+    const slugs = fs.existsSync(indexPath)
+        ? JSON.parse(fs.readFileSync(indexPath, 'utf-8'))
+        : componentSlugs;
+    for (const [slug, aliases] of Object.entries(slugs)) {
+        const hit = [slug, ...aliases].some((alias) => lowerPrompt.includes(alias.toLowerCase()));
+        if (!hit)
+            continue;
+        for (const chunk of pool) {
+            if (chunk.source.includes(`components/${slug}.md`) ||
+                chunk.source.includes(`features/${slug}.md`)) {
+                addBoost(chunk, 100, `E3:${slug}`);
+            }
+        }
+    }
+    // E4: symbols / Class.method
+    // P1-3：若 chunk 所在文件已被 E2 boost，则 E4 减半（避免双重放大压制 BM25 内序）
+    const symbolMatches = [
+        ...prompt.matchAll(/\b([A-Z][A-Za-z0-9_]*\.[A-Za-z_]\w*)\b/g),
+        ...prompt.matchAll(/\b(use[A-Z]\w*)\b/g),
+        ...prompt.matchAll(/\b(TRTC[A-Za-z0-9_]+|TX[A-Za-z0-9_]+)\b/g),
+    ];
+    for (const match of symbolMatches) {
+        const symbol = match[1];
+        for (const chunk of pool) {
+            if (chunk.symbols.includes(symbol)) {
+                const amount = e2BoostedFiles.has(chunk.source) ? 50 : 100;
+                addBoost(chunk, amount, `E4:${symbol}`);
+            }
+        }
+    }
+    // E5: feature aliases
+    const featureAliases = loadFeatureAliases();
+    const productKey = norm.product?.includes('room') ? 'room'
+        : norm.product?.includes('chat') ? 'chat'
+            : norm.product?.includes('live') || !norm.product?.length ? 'live'
+                : '';
+    if (productKey && featureAliases[productKey]) {
+        for (const [fileName, aliases] of Object.entries(featureAliases[productKey])) {
+            const hit = aliases.some((alias) => lowerPrompt.includes(alias.toLowerCase()) || lowerPrompt.includes(fileName.replace('.md', '')));
+            if (!hit)
+                continue;
+            for (const chunk of pool) {
+                if (chunk.source.endsWith(fileName)) {
+                    addBoost(chunk, 100, `E5:${fileName}`);
+                }
+            }
+        }
+    }
+    if (norm.scenario === 'voice') {
+        for (const chunk of pool) {
+            if (chunk.source.includes('/voice/') && /co-guest|上麦/.test(lowerPrompt)) {
+                if (chunk.source.includes('voice-co-guest-interaction')) {
+                    addBoost(chunk, 120, 'E5:voice-co-guest');
+                }
+            }
+        }
+    }
+    // E5.5: push overview boost——当用户问 push 综述类问题时把 overview/prepare.md 顶到前列。
+    // 关键词分两类：
+    //   (1) prepare.md 标题语义：开通服务 / 接入流程 / 厂商配置 / SDK 接入 / 高级功能
+    //   (2) 自然入口问法：准备工作 / 前置 / 前提 / 注意事项 / 是什么 / 计费
+    // 否则 BM25 会把各平台 integration.md 顶上来（"步骤/集成"等词在多平台文档高频）。
+    if (norm.product?.includes('push')) {
+        const isOverviewIntent = /开通|创建\s*Push|创建应用|SDKAppID|控制台|数据中心|接入流程|接入推送|厂商配置|SDK\s*接入|高级功能|准备工作|准备|前置|前提|注意事项|是什么|介绍|计费/i.test(prompt)
+            || /\b(push\s+)?(overview|getting\s+started|prerequisites|billing|what\s+is\s+push)\b/i.test(prompt);
+        if (isOverviewIntent) {
+            for (const chunk of pool) {
+                if (chunk.source.includes('knowledge/push/overview/')) {
+                    addBoost(chunk, 150, 'E5.5:push-overview');
+                }
+            }
+        }
+        // E5.6: push 厂商精确命中——英文 push config 改为与写写一致的平台级页面：
+        // Android 厂商配置集中在 config/android.md，iOS/APNs 集中在 config/ios.md。
+        // 当 prompt 提到具体厂商时，把对应平台配置页顶到前列，避免被跨平台 integration 文档稀释。
+        const ANDROID_VENDOR_PROMPT = /华为|huawei|hms|harmonyconnect|小米|xiaomi|miui|mipush|\boppo\b|colorpush|\bvivo\b|vpush|荣耀|honor|魅族|meizu|flymepush|\bfcm\b|google\s*推送|firebase/i;
+        const IOS_VENDOR_PROMPT = /\bapns\b|apple\s*push|ios\s*certificate|p8\s*certificate|p12\s*certificate/i;
+        if (ANDROID_VENDOR_PROMPT.test(prompt)) {
+            for (const chunk of pool) {
+                if (chunk.source === 'knowledge/push/config/android.md') {
+                    addBoost(chunk, 260, 'E5.6:push-vendor:android');
+                }
+                if (chunk.source === 'knowledge/push/integration/android.md') {
+                    addBoost(chunk, 60, 'E5.6:push-vendor:android-fallback');
+                }
+            }
+        }
+        if (IOS_VENDOR_PROMPT.test(prompt)) {
+            for (const chunk of pool) {
+                if (chunk.source === 'knowledge/push/config/ios.md') {
+                    addBoost(chunk, 120, 'E5.6:push-vendor:ios');
+                }
+            }
+        }
+    }
+    // E6: chat urls boost（L1 URL 映射；错误码单独指向 urls/error-code.md）
+    if (!norm.product?.length || norm.product.includes('chat')) {
+        if (/payload|usersig|authentication|auth|login|signature|登录|鉴权/i.test(prompt)) {
+            for (const chunk of pool) {
+                if (chunk.source.includes('knowledge/chat/urls/')) {
+                    addBoost(chunk, 100, 'E6:chat-urls');
+                }
+            }
+        }
+        const errorCodeIntent = /错误码|\berror\s*code\b/i.test(prompt) || errorMatches.length > 0 || norm.searchIntent?.includes('error_code');
+        if (errorCodeIntent) {
+            for (const chunk of pool) {
+                if (chunk.source.includes('knowledge/chat/urls/error-code.md')) {
+                    addBoost(chunk, 180, 'E6:chat-error-code-url');
+                }
+            }
+        }
+        // E7: URL map row match (chunk.title = Query column; boost best row only)
+        if (normalizeE7Text(prompt).replace(/\s+/g, '').length >= 2) {
+            const candidates = [];
+            for (const chunk of pool) {
+                if (!chunk.source.includes('knowledge/chat/urls/'))
+                    continue;
+                if (!chunk.title.trim())
+                    continue;
+                const score = scoreE7UrlRow(prompt, chunk.title);
+                if (score > 0) {
+                    candidates.push({ chunk, score });
+                }
+            }
+            candidates.sort((a, b) => b.score - a.score);
+            const top = candidates[0];
+            if (top) {
+                addBoost(top.chunk, 200 + Math.min(top.score, 100), `E7:url-row:${top.chunk.title}`);
+                const runnerUp = candidates[1];
+                if (runnerUp && top.score - runnerUp.score <= 20) {
+                    addBoost(runnerUp.chunk, 150 + Math.min(runnerUp.score, 80), `E7:url-row:${runnerUp.chunk.title}`);
+                }
+            }
+        }
+    }
+    // E8: 集成查阅意图 boost——prompt 含集成/接入/快速开始/接入文档等意图词时，
+    // 把 {integration|knowledge}/{product}/preset/{fw}/integration.md 系列文件顶到前列。
+    // 解决问题：集成文档内容长、词密度低，BM25 原始分常被短小的 features/ 文档压过。
+    // 注：android-view / ios-uikit 已迁到 knowledge corpus，但同样是集成指引，需要一并 boost。
+    const isIntegrationIntent = /集成|接入|快速开始|快速接入|集成文档|接入文档|集成指南|接入指南|接入流程|集成步骤|如何接入|如何集成|怎么接入|怎么集成/i.test(prompt)
+        || /\b(integrat(e|ion|ing)|getting\s+started|quick\s+start|setup\s+guide|how\s+to\s+(integrate|set\s+up)|install(?:ation)?\s+guide)\b/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}`);
+        }
+    }
+    // E9: chat faq — types=faq 时优先 knowledge/ 语料，避免 integration 文档内 FAQ 章节抢首位
+    if (norm.searchIntent?.includes('faq') && norm.product?.includes('chat')) {
+        const authPrompt = /auth|login|signature|usersig|鉴权|登录/i.test(prompt);
+        for (const chunk of pool) {
+            if (chunk.source.startsWith('knowledge/chat/')) {
+                const urlBoost = authPrompt && chunk.source.includes('/urls/') ? 180 : 100;
+                addBoost(chunk, urlBoost, 'E9:chat-faq:knowledge');
+            }
+            if (chunk.source.startsWith('integration/chat/')) {
+                addBoost(chunk, -120, 'E9:chat-faq:penalize-integration');
+            }
+        }
+    }
+    return { boosts, exactHits };
+}