@tencentcloud/sdk-mcp 1.6.8 → 1.7.0

package/knowledge/search/url-row-scorer.js

@@ -0,0 +1,258 @@
+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 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];
+}
+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 scoreEnglishStyle(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 scoreChineseClauseStyle(query, title) {
+    const clauses = splitPromptIntoClauses(query.toLowerCase());
+    const titleNorm = title.toLowerCase().replace(/\s+/g, '');
+    if (!titleNorm)
+        return 0;
+    let bestScore = 0;
+    const allParts = [...clauses, query.toLowerCase().replace(/\s+/g, '')];
+    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;
+        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))) {
+            s = 600;
+        }
+        if (s > bestScore)
+            bestScore = s;
+    }
+    if (bestScore <= 0 && clauses.length > 0) {
+        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;
+            }
+        }
+    }
+    return Math.max(bestScore, 0);
+}
+export function normalizeUrlRowQuery(query) {
+    return normalizeE7Text(query);
+}
+export function scoreUrlRow(query, title) {
+    const enScore = scoreEnglishStyle(query, title);
+    const zhScore = scoreChineseClauseStyle(query, title);
+    if (enScore <= 0 && zhScore <= 0) {
+        return {
+            score: 0,
+            matchedBy: 'none',
+            debug: { enScore, zhScore },
+        };
+    }
+    if (zhScore > enScore) {
+        return {
+            score: zhScore,
+            matchedBy: 'zh',
+            debug: { enScore, zhScore },
+        };
+    }
+    return {
+        score: enScore,
+        matchedBy: 'en',
+        debug: { enScore, zhScore },
+    };
+}

package/package.json

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