@tencent-rtc/mcp 1.6.8 → 1.7.1

package/knowledge/frontmatter-meta.js

@@ -0,0 +1,167 @@
+import * as yaml from 'js-yaml';
+const FRONTMATTER_RE = /^\uFEFF?---\r?\n([\s\S]*?)\r?\n---\r?\n?/;
+function uniq(arr) {
+    return [...new Set(arr)];
+}
+function normalizeString(value) {
+    if (typeof value !== 'string')
+        return undefined;
+    const normalized = value.trim();
+    return normalized ? normalized : undefined;
+}
+function normalizeStringArray(value) {
+    if (Array.isArray(value)) {
+        const normalized = value
+            .map((item) => (typeof item === 'string' ? item.trim() : ''))
+            .filter(Boolean);
+        return normalized.length ? uniq(normalized) : undefined;
+    }
+    if (typeof value === 'string') {
+        const normalized = value
+            .split(',')
+            .map((item) => item.trim())
+            .filter(Boolean);
+        return normalized.length ? uniq(normalized) : undefined;
+    }
+    return undefined;
+}
+function normalizeScenario(value) {
+    if (value === 'live' || value === 'voice')
+        return value;
+    return undefined;
+}
+function normalizeVariant(value) {
+    if (value === 'core-sdk' || value === 'preset')
+        return value;
+    return undefined;
+}
+function normalizeDocKind(value) {
+    if (value === 'capability_matrix' || value === 'unsupported_summary' || value === 'negative_faq') {
+        return value;
+    }
+    return undefined;
+}
+function normalizeCapabilityStatus(value) {
+    if (value === 'supported' || value === 'unsupported' || value === 'partial' || value === 'version_gated') {
+        return value;
+    }
+    return undefined;
+}
+function normalizeRetrievableScope(value) {
+    if (value === 'always')
+        return 'always';
+    return normalizeStringArray(value);
+}
+function parseFrontmatterObject(input) {
+    if (!input || typeof input !== 'object' || Array.isArray(input)) {
+        return {};
+    }
+    return input;
+}
+export function resolveFrontmatterMeta(rawMarkdown) {
+    const match = rawMarkdown.match(FRONTMATTER_RE);
+    if (!match) {
+        return {
+            content: rawMarkdown,
+            contentOffset: 0,
+            hasFrontmatter: false,
+            frontmatterMeta: {},
+            overrideFields: [],
+        };
+    }
+    const rawBlock = match[1] ?? '';
+    const contentOffset = match[0].length;
+    const content = rawMarkdown.slice(contentOffset);
+    let parsed;
+    try {
+        parsed = yaml.load(rawBlock);
+    }
+    catch (error) {
+        const parseError = error instanceof Error ? error.message : String(error);
+        return {
+            content,
+            contentOffset,
+            hasFrontmatter: true,
+            parseError,
+            frontmatterMeta: {},
+            overrideFields: [],
+        };
+    }
+    const fm = parseFrontmatterObject(parsed);
+    const frontmatterMeta = {};
+    const overrideFields = [];
+    const product = normalizeString(fm.product);
+    if (product) {
+        frontmatterMeta.product = product;
+        overrideFields.push('product');
+    }
+    const framework = normalizeStringArray(fm.frameworks) ?? normalizeStringArray(fm.framework);
+    if (framework?.length) {
+        frontmatterMeta.framework = framework;
+        overrideFields.push('framework');
+    }
+    const types = normalizeStringArray(fm.types);
+    if (types?.length) {
+        frontmatterMeta.types = types;
+        overrideFields.push('types');
+    }
+    const scenario = normalizeScenario(fm.scenario);
+    if (scenario !== undefined) {
+        frontmatterMeta.scenario = scenario;
+        overrideFields.push('scenario');
+    }
+    const variant = normalizeVariant(fm.variant);
+    if (variant) {
+        frontmatterMeta.variant = variant;
+        overrideFields.push('variant');
+    }
+    const scope = normalizeString(fm.scope);
+    if (scope) {
+        frontmatterMeta.scope = scope;
+        overrideFields.push('scope');
+    }
+    const docKind = normalizeDocKind(fm.doc_kind);
+    if (docKind) {
+        frontmatterMeta.doc_kind = docKind;
+        overrideFields.push('doc_kind');
+    }
+    const capabilityStatus = normalizeCapabilityStatus(fm.capability_status);
+    if (capabilityStatus) {
+        frontmatterMeta.capability_status = capabilityStatus;
+        overrideFields.push('capability_status');
+    }
+    const retrievableScope = normalizeRetrievableScope(fm.retrievable_scope);
+    if (retrievableScope) {
+        frontmatterMeta.retrievable_scope = retrievableScope;
+        overrideFields.push('retrievable_scope');
+    }
+    return {
+        content,
+        contentOffset,
+        hasFrontmatter: true,
+        frontmatterMeta,
+        overrideFields: uniq(overrideFields),
+    };
+}
+export function mergePathMetaWithFrontmatter(pathMeta, frontmatterMeta, overrideFields) {
+    if (!overrideFields.length) {
+        return {
+            ...pathMeta,
+            meta_source: 'path',
+            meta_override_fields: [],
+        };
+    }
+    const merged = {
+        ...pathMeta,
+        meta_source: 'merged',
+        meta_override_fields: uniq(overrideFields),
+    };
+    for (const field of overrideFields) {
+        const value = frontmatterMeta[field];
+        if (value === undefined)
+            continue;
+        // PathMeta 字段由 frontmatter 显式声明时优先；未声明字段保留路径推断兜底。
+        merged[field] = value;
+    }
+    return merged;
+}

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,8 +1,16 @@
 import fs from 'fs';
 import path from 'path';
 import { fileURLToPath } from 'url';
+import { getSourceFileContent } from '../content-loader.js';
+import { computeCommonSectionTokens, isUrlMappingSource, normalizeUrlRowQuery, queryMatchesSection, scoreUrlRow } from './url-row-scorer.js';
 const __dirname = path.dirname(fileURLToPath(import.meta.url));
 const SCHEMA_ROOT = path.resolve(__dirname, '../../resource/_schema');
+/**
+ * 分组语义命中的基础分：当 scoreUrlRow=0 但该 url 行「分组被 query 命中 + types 匹配」时给予。
+ * 取值需满足 E7 strongCandidates 门槛（typeMatch ×1.2 后 ≥500 → base ≥417）。
+ * 只在「分组命中」时给（区别于旧的「所有 types 匹配行给 500」），避免无关行涌入。
+ */
+const SECTION_MATCH_BASE_SCORE = 450;
 export const DOC_PATH_MAP = {
     android: {
         core_api: 'TRTCCloud',
@@ -69,184 +77,6 @@ function loadJson(fileName, fallback) {
         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))
@@ -314,8 +144,6 @@ const ROOM_FEATURE_SPECS = [
 function detectRoomFeatureHits(prompt) {
     return ROOM_FEATURE_SPECS.filter((spec) => spec.promptPattern.test(prompt));
 }
-const LIVE_LIFECYCLE_PROMPT = /create\s*live|end\s*live|join\s*live|leave\s*live|start\s*live|stop\s*live|watch\s*live|host_streaming|audience_streaming|开播|创建直播|结束直播|停播|观看直播|退出直播|进房|离房|createLive|endLive|joinLive|leaveLive/i;
-const LIVE_LIFECYCLE_APIS = ['createLive', 'endLive', 'joinLive', 'leaveLive'];
 export function runExactLookup(prompt, pool, norm) {
     const boosts = {};
     const exactHits = [];
@@ -468,70 +296,145 @@ export function runExactLookup(prompt, pool, norm) {
             }
         }
     }
-    // E6: chat urls boost（L1 URL 映射；错误码单独指向 urls/error-code.md）
-    if (!norm.product?.length || norm.product.includes('chat')) {
+    // E6: URL 映射文件 boost（L1；产品无关：任意 product 的 urls 均适用）
+    const hasUrlChunks = pool.some((c) => isUrlMappingSource(c.source));
+    if (hasUrlChunks) {
         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');
+                if (isUrlMappingSource(chunk.source)) {
+                    addBoost(chunk, 100, 'E6: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');
+                if (/\/error-code\.md$/i.test(chunk.source)) {
+                    addBoost(chunk, 180, 'E6:error-code-url');
                 }
             }
         }
-        // E7: URL map row match (chunk.title = Query column); boost multiple strong hits with pinned relaxation
-        if (normalizeE7Text(prompt).replace(/\s+/g, '').length >= 2) {
+        // E7: URL 映射表行级匹配（chunk.title = 子问题列）
+        // 共享 scorer 按「REST 端点 > API token > 语义词对齐(IDF 加权)」打分。
+        // 支持 types 领域限定：上游推断出 types 时，优先 types 匹配的子文件行，
+        // 不匹配的行降权（避免跨域误命中，如 SDK 问题命中 restapi）。
+        if (normalizeUrlRowQuery(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())
+            const hasTypeFilter = Boolean(norm.searchIntent?.length);
+            // 预收集 urls 行的分组结构：按 source 读整个 md 源文件，解析 `##` 分组与每行归属。
+            // 分组粗筛对所有 urls 资源生效（产品无关），不针对 webhook.md 打补丁。
+            const urlChunks = pool.filter((c) => isUrlMappingSource(c.source) && c.title.trim());
+            const sectionByChunk = new Map(); // chunk.id -> 分组标题
+            const sectionsBySource = new Map(); // source -> 分组标题集合
+            const mdRowsBySource = new Map(); // source -> {行title -> 分组标题}
+            for (const source of new Set(urlChunks.map((c) => c.source))) {
+                let full = '';
+                try {
+                    full = getSourceFileContent(source);
+                }
+                catch {
+                    full = '';
+                }
+                let cur = '';
+                const rows = new Map();
+                const sections = new Set();
+                for (const line of full.split('\n')) {
+                    const h = line.match(/^#{2,3}\s+(.+)$/);
+                    if (h) {
+                        cur = h[1].trim();
+                        sections.add(cur);
+                        continue;
+                    }
+                    const row = line.match(/^\|\s*([^|]+?)\s*\|\s*`(https?:[^`]+)`/);
+                    if (row)
+                        rows.set(row[1].trim(), cur);
+                }
+                mdRowsBySource.set(source, rows);
+                sectionsBySource.set(source, sections);
+            }
+            for (const chunk of urlChunks) {
+                const section = mdRowsBySource.get(chunk.source)?.get(chunk.title);
+                if (section)
+                    sectionByChunk.set(chunk.id, section);
+            }
+            // 计算每个 source 的共有词（该文件所有分组都出现的词）
+            const commonTokensBySource = new Map();
+            for (const [source, sections] of sectionsBySource) {
+                commonTokensBySource.set(source, computeCommonSectionTokens([...sections]));
+            }
+            for (const chunk of urlChunks) {
+                const scoreResult = scoreUrlRow(prompt, chunk.title);
+                // types 领域限定：query types 与 chunk types 是否有交集
+                const typeMatch = hasTypeFilter
+                    ? (norm.searchIntent ?? []).some((t) => chunk.types.includes(t))
+                    : true;
+                // 分组粗筛：query 是否命中该 chunk 所在的分组。
+                // 命中分组 → 正常；未命中分组 → 降权（不排除，避免 query 与分组名匹配不准时误杀）。
+                const section = sectionByChunk.get(chunk.id);
+                const commonTokens = commonTokensBySource.get(chunk.source);
+                const sectionMatch = section && commonTokens
+                    ? queryMatchesSection(prompt, section, commonTokens)
+                    : true; // 无分组信息时不做粗筛（保持原行为）
+                // 高 scoreUrlRow 兜底：scoreUrlRow ≥ 700 是极强语义信号（query 2-gram 全覆盖），
+                // 此时不应被 sectionMatch 软降权压制。常见场景：短 query 如「群消息发送异常」
+                // 跟 section 标题「群组系统回调」共享字符少（仅「群」），sectionMatch 失败，
+                // 但 row title 本身完美匹配 user 意图，强行降权会让单聊 row 顶上。
+                const highConfidence = scoreResult.score >= 700;
+                // 分组语义命中基础分：scoreUrlRow 可能因「同义词/长句」对精确行打 0 分
+                // （如「群消息发送前回调」vs「群内发言之前回调」），但分组已语义命中，
+                // 给予基础分进入候选，避免该领域行被 score<=0 排除。
+                // 区别于旧的「所有 types 匹配行给 500」——只在分组命中时才给，避免无关行涌入。
+                if (scoreResult.score <= 0) {
+                    if (sectionMatch && typeMatch) {
+                        candidates.push({ chunk, score: SECTION_MATCH_BASE_SCORE, typeMatch, sectionMatch });
+                    }
                     continue;
-                const score = scoreE7UrlRow(prompt, chunk.title);
-                if (score > 0) {
-                    candidates.push({ chunk, score });
                 }
+                // finalScore 排序用：sectionMatch 失败且非高置信时，×0.7 软降权。
+                // 高置信（scoreUrlRow ≥ 700）跳过降权，避免短 query + 长 section 标题时的误杀。
+                const finalScore = (sectionMatch || highConfidence) ? scoreResult.score : scoreResult.score * 0.7;
+                candidates.push({ chunk, score: finalScore, typeMatch, sectionMatch });
             }
             candidates.sort((a, b) => b.score - a.score);
-            const strongCandidates = candidates
-                .filter(({ score }) => score >= 150)
+            // types 匹配的行加分（更优先）；不匹配的行轻度降权但仍可兜底召回。
+            // 避免上游 types 推断不准确时误杀正确文档（如「多端登录配置」被推断为 feature 而非 product）。
+            const typeScored = candidates
+                .map((c) => (c.typeMatch ? { ...c, score: c.score * 1.2 } : { ...c, score: c.score * 0.6 }))
+                .filter(({ score }) => score >= 500);
+            // 同分 row（典型：query「群消息撤回回调」时「撤回群消息」跟「单聊消息撤回」都 scoreUrlRow=660），
+            // 按「query 字符集被 row title 覆盖比例」再排，覆盖更高的 row 排前。
+            // 修 E7 boost idx=0 多 40 分的副作用：让字符集更精准的 row 拿 idx=0 → 300 分而不是 260 分。
+            const queryChars = new Set(prompt.match(/[\u4e00-\u9fff]/g) ?? []);
+            const charCoverage = (title) => {
+                if (queryChars.size === 0)
+                    return 0;
+                const titleChars = new Set(title.match(/[\u4e00-\u9fff]/g) ?? []);
+                let hit = 0;
+                for (const ch of queryChars)
+                    if (titleChars.has(ch))
+                        hit += 1;
+                return hit / queryChars.size;
+            };
+            const strongCandidates = typeScored
+                .sort((a, b) => {
+                // 优先按 typeScored score 降序；同分时按字符集覆盖率降序
+                if (b.score !== a.score)
+                    return b.score - a.score;
+                return charCoverage(b.chunk.title) - charCoverage(a.chunk.title);
+            })
                 .slice(0, 12);
             strongCandidates.forEach(({ chunk, score }, idx) => {
+                // 递减 boost：前两条更高，其余保持可召回但不过度压制 BM25
                 const amount = idx === 0
                     ? 200 + Math.min(score, 100)
                     : idx === 1
                         ? 170 + Math.min(score, 90)
-                        : Math.max(score >= 300 ? 100 : 70, 100 - idx * 5);
+                        : 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)
-        || /\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);
@@ -545,28 +448,6 @@ export function runExactLookup(prompt, pool, norm) {
             }
         }
     }
-    // E11: LiveKit lifecycle strong recall
-    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 disambiguation + unsupported feature routing
     if (norm.product?.includes('room') && norm.frameworks?.length) {
         const platform = norm.frameworks.find((fw) => ['android', 'ios', 'flutter', 'vue'].includes(fw));