@tencentcloud/sdk-mcp 1.6.5 → 1.6.7

package/knowledge/search/exact-lookup.js

@@ -94,6 +94,19 @@ 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 = [
@@ -141,6 +154,7 @@ const LIVE_LIFECYCLE_APIS = ['createLive', 'endLive', 'joinLive', 'leaveLive'];
 export function runExactLookup(prompt, pool, norm) {
     const boosts = {};
     const exactHits = [];
+    const urlRowHitChunkIds = new Set();
     const lowerPrompt = prompt.toLowerCase();
     const addBoost = (chunk, amount, label) => {
         boosts[chunk.id] = (boosts[chunk.id] ?? 0) + amount;
@@ -303,57 +317,79 @@ export function runExactLookup(prompt, pool, norm) {
                 }
             }
         }
-        // E7: URL 映射表行级匹配（chunk.title = 子问题列；仅 boost 最佳行）
-        const queryNorm = prompt
-            .toLowerCase()
-            .replace(/rest\s*api|服务端|server\s*api|api|怎么|如何|什么|用哪个|查询/g, '')
-            .replace(/\s+/g, '');
-        if (queryNorm.length >= 2) {
-            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)
+        // 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))
                     continue;
-                let score = 0;
-                if (queryNorm === titleNorm) {
-                    score = 1000;
+                seen.add(pn);
+                let s = 0;
+                if (pn === titleNorm) {
+                    s = 1000;
                 }
-                else if (titleNorm.includes(queryNorm)) {
-                    const trailing = titleNorm.slice(titleNorm.indexOf(queryNorm) + queryNorm.length);
-                    score = 800 - trailing.length * 80;
+                else if (titleNorm.includes(pn)) {
+                    const trailing = titleNorm.slice(titleNorm.indexOf(pn) + pn.length);
+                    s = 800 - trailing.length * 80;
                 }
-                else if (queryNorm.includes(titleNorm)) {
-                    score = 700 + titleNorm.length;
+                else if (pn.includes(titleNorm)) {
+                    s = 700 + titleNorm.length;
                 }
-                else {
-                    const queryLoose = queryNorm.replace(/发送/g, '发');
-                    if (queryLoose.length >= 3 && titleNorm.includes(queryLoose)) {
-                        score = 500;
-                        if (/批量|群组|群流|广播|导入|公众号|已读|回执/.test(titleNorm)
-                            && !/批量|群组|群|已读|回执/.test(queryNorm)) {
-                            score -= 250;
-                        }
-                        if (/^单发/.test(titleNorm) && /发送|单聊/.test(queryNorm)) {
-                            score += 120;
-                        }
-                    }
-                }
-                if (score > 0) {
-                    candidates.push({ chunk, score });
+                else if (titleTokens.some((token) => pn.includes(token) || token.includes(pn))) {
+                    // 子句匹配 title 的 token（如 "创建群组" 匹配 "创建/解散群组（普通群管理）" 中的 "创建" token）
+                    s = 600;
                 }
+                if (s > bestScore)
+                    bestScore = s;
             }
-            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}`);
+            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 (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 系列文件顶到前列。
@@ -492,5 +528,5 @@ export function runExactLookup(prompt, pool, norm) {
             }
         }
     }
-    return { boosts, exactHits };
+    return { boosts, exactHits, urlRowHitChunkIds: [...urlRowHitChunkIds] };
 }

package/knowledge/search/search-knowledge.js

@@ -23,7 +23,7 @@ function loadManifest() {
     cachedManifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
     return cachedManifest;
 }
-function postProcess(ranked, chunksById, limit) {
+function postProcess(ranked, chunksById, limit, opts) {
     const sourceCount = {};
     const urlMappingSourceCount = {};
     /** 已入选的 push config/android/{vendor} 文件，用于抑制其他厂商噪声 */
@@ -34,9 +34,10 @@ function postProcess(ranked, chunksById, limit) {
         if (!chunk)
             continue;
         const isUrlMapping = Boolean(isUrlMappingSource(chunk.source));
+        const isPinnedUrlRow = isUrlMapping && (opts?.pinnedUrlRowChunkIds?.has(chunk.id) ?? false);
         if (isUrlMapping) {
             const urlCount = urlMappingSourceCount[chunk.source] ?? 0;
-            if (urlCount >= 1)
+            if (!isPinnedUrlRow && urlCount >= 1)
                 continue;
             urlMappingSourceCount[chunk.source] = urlCount + 1;
         }
@@ -68,8 +69,9 @@ function postProcess(ranked, chunksById, limit) {
         if (firstPush) {
             // 首条不设分数截止，至少保证 1 条返回
         }
-        else {
+        else if (!isPinnedUrlRow) {
             // 分数衰减到 top 的 5% 以下时停止，不硬填到 limit
+            // chat/urls 的行级精确命中（E7）不受该规则截断，保证多子主题可并行返回
             const topScore = fragments[0].score;
             if (topScore > 0 && item.score < topScore * 0.05)
                 break;
@@ -311,7 +313,7 @@ export function searchKnowledge(params) {
         if (pool.length === 0 && passNorm.types?.length) {
             pool = filterPool(allChunks, { ...passNorm, types: undefined });
         }
-        const { boosts, exactHits } = runExactLookup(passNorm.prompt, pool, passNorm);
+        const { boosts, exactHits, urlRowHitChunkIds } = runExactLookup(passNorm.prompt, pool, passNorm);
         // A2 补充正向路由：UserSig 问法下允许 share 命中且优先于无关 urls 噪声
         if (/usersig|sdkappid|secretkey|鉴权|签名|gentestusersig/i.test(passNorm.prompt)) {
             for (const chunk of pool) {
@@ -337,7 +339,10 @@ export function searchKnowledge(params) {
             framework: passNorm.framework,
             frameworks: passNorm.frameworks,
         });
-        const fragments = postProcess(rankedWithMultipliers, chunksById, passNorm.limit);
+        const pinnedUrlRowChunkIds = new Set(urlRowHitChunkIds);
+        const fragments = postProcess(rankedWithMultipliers, chunksById, passNorm.limit, {
+            pinnedUrlRowChunkIds,
+        });
         const urlMappingSources = [...new Set(fragments.map((f) => f.source).filter((source) => isUrlMappingSource(source)))];
         const references = buildReferences(fragments);
         const apiNameCoverage = computeApiNameCoverage(queryApiTokens, poolWithContent);
@@ -350,6 +355,8 @@ export function searchKnowledge(params) {
             references,
             apiNameCoverage,
             missingApiTokens,
+            urlMapRelaxed: pinnedUrlRowChunkIds.size > 0,
+            urlMapExactHitCount: pinnedUrlRowChunkIds.size,
         };
     };
     let pass = runSearchPass(norm);
@@ -389,6 +396,8 @@ export function searchKnowledge(params) {
             filtered_size: pass.pool.length,
             exact_hits: pass.exactHits,
             ...(pass.urlMappingSources.length ? { url_mapping_sources: pass.urlMappingSources } : {}),
+            ...(pass.urlMapRelaxed ? { url_map_relaxed: pass.urlMapRelaxed } : {}),
+            ...(pass.urlMapExactHitCount > 0 ? { url_map_exact_hit_count: pass.urlMapExactHitCount } : {}),
             ...(pass.references.length ? { references: pass.references } : {}),
             ...(topScore !== undefined ? { top_score: Number(topScore.toFixed(2)) } : {}),
             ...(secondScore !== undefined ? { second_score: Number(secondScore.toFixed(2)) } : {}),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencentcloud/sdk-mcp",
-  "version": "1.6.5",
+  "version": "1.6.7",
   "description": "Tencent Cloud MCP Server for SDK",
   "type": "module",
   "main": "index.js",

package/resource/index/component-slugs.json

@@ -0,0 +1 @@
+{"chat-setting":["chat-setting","chatsetting","chat_setting"],"contact-list":["contact-list","contactlist","contact_list"],"conversation-actions":["conversation-actions","conversationactions","conversation_actions"],"conversation-list":["conversation-list","conversationlist","conversation_list"],"conversation-preview":["conversation-preview","conversationpreview","conversation_preview"],"conversation-search":["conversation-search","conversationsearch","conversation_search"],"message-input":["message-input","messageinput","message_input"],"message-list":["message-list","messagelist","message_list"],"search":["search","search","search"],"theme":["theme","theme","theme"],"chat-header":["chat-header","chatheader","chat_header"]}

package/resource/index/doc-source-urls.json

@@ -0,0 +1 @@
+{"knowledge/rtcengine/web/how_to_run_web_sdk_demo.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-10-basic-get-started-with-demo.md","knowledge/rtcengine/web/plugin/20-advanced-customized-capture-rendering.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-20-advanced-customized-capture-rendering.md","knowledge/rtcengine/web/plugin/21-advanced-auto-play-policy.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-21-advanced-auto-play-policy.md","knowledge/rtcengine/web/plugin/22-advanced-audio-mixer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-22-advanced-audio-mixer.md","knowledge/rtcengine/web/plugin/23-advanced-support-detection.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-23-advanced-support-detection.md","knowledge/rtcengine/web/plugin/24-advanced-network-quality.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-24-advanced-network-quality.md","knowledge/rtcengine/web/plugin/25-advanced-device-change.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-25-advanced-device-change.md","knowledge/rtcengine/web/plugin/26-advanced-publish-cdn-stream.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-26-advanced-publish-cdn-stream.md","knowledge/rtcengine/web/plugin/27-advanced-small-stream.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-27-advanced-small-stream.md","knowledge/rtcengine/web/plugin/28-advanced-beauty.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-28-advanced-beauty.md","knowledge/rtcengine/web/plugin/29-advanced-water-mark.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-29-advanced-water-mark.md","knowledge/rtcengine/web/plugin/30-advanced-cross-room-link.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-30-advanced-cross-room-link.md","knowledge/rtcengine/web/plugin/31-advanced-plugins-overview.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-31-advanced-plugins-overview.md","knowledge/rtcengine/web/plugin/34-advanced-proxy.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-34-advanced-proxy.md","knowledge/rtcengine/web/plugin/35-advanced-ai-denoiser.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-35-advanced-ai-denoiser.md","knowledge/rtcengine/web/plugin/36-advanced-virtual-background.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-36-advanced-virtual-background.md","knowledge/rtcengine/web/plugin/37-advanced-voice-changer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-37-advanced-voice-changer.md","knowledge/rtcengine/web/plugin/38-advanced-basic-beauty.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-38-advanced-basic-beauty.md","knowledge/rtcengine/web/plugin/39-advanced-video-decoder.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-39-advanced-video-decoder.md","knowledge/rtcengine/web/plugin/40-advanced-video-mixer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-40-advanced-video-mixer.md","knowledge/rtcengine/web/plugin/41-advanced-small-stream-auto-switcher.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-41-advanced-small-stream-auto-switcher.md","knowledge/rtcengine/web/plugin/42-advanced-realtime-transcriber.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-42-advanced-realtime-transcriber.md","knowledge/rtcengine/web/plugin/43-advanced-face-detection.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/zh-cn/tutorial-43-advanced-face-detection.md"}