@tencentcloud/sdk-mcp 1.6.0 → 1.6.1

package/knowledge/search/filter-pool.js

@@ -1,3 +1,4 @@
+import { downgradeToProductType } from './product-scope-intent.js';
 /**
  * MCP framework enum → index 中对应的 framework 值列表。
  * path-meta.ts 已通过 normalizeFrameworkDir 把目录名归一到标准 framework，
@@ -12,14 +13,31 @@ function expandFrameworks(framework) {
         return ['react', 'vue', 'web'];
     return FRAMEWORK_SEARCH_ALIASES[framework] ?? [framework];
 }
+/**
+ * 类型别名：UIKit「组件(component)」与「feature」是同一批文档的两种叫法
+ * （chat preset 双标签，roomkit/live/call 仅打 feature），互相放行避免 types 硬过滤误杀。
+ */
+const TYPE_ALIASES = {
+    component: ['component', 'feature'],
+    feature: ['feature', 'component'],
+};
+function expandTypeAliases(types) {
+    const expanded = new Set();
+    for (const t of types) {
+        for (const alias of TYPE_ALIASES[t] ?? [t])
+            expanded.add(alias);
+    }
+    return [...expanded];
+}
 /** Chat 无独立 faq.md；types 含 faq 时退化到全语料检索（feature/component/urls 等均命中） */
-function resolveTypes(products, types) {
+function resolveTypes(products, types, prompt, framework) {
     if (!types?.length)
         return undefined;
     if (products?.includes('chat') && types.includes('faq')) {
         return undefined;
     }
-    return types;
+    const downgraded = downgradeToProductType(products, types, prompt, framework);
+    return expandTypeAliases(downgraded);
 }
 /** 单平台产品的隐式 framework 推断：避免对显然唯一的平台再发起询问 */
 function inferImplicitFramework(products, framework) {
@@ -33,7 +51,7 @@ export function normalizeParams(params) {
     const limit = Math.min(Math.max(params.limit ?? 8, 1), 16);
     const effectiveFramework = inferImplicitFramework(params.product, params.framework);
     const frameworks = expandFrameworks(effectiveFramework);
-    const types = resolveTypes(params.product, params.types);
+    const types = resolveTypes(params.product, params.types, params.prompt, effectiveFramework);
     return {
         prompt: params.prompt,
         product: params.product,

package/knowledge/search/product-scope-intent.js

@@ -0,0 +1,40 @@
+/**
+ * Product-scope intent (routes to chat/urls/product.md, type=product).
+ *
+ * These questions are about the PRODUCT / account scope — billing, packages, console settings,
+ * account & data capabilities configured in the console, storage/retention, usage limits.
+ * They are cross-platform and must NOT require a framework.
+ *
+ * Detection keys on *intent* words (console / billing / limit / product-setting), NOT on
+ * capability nouns alone (e.g. "relationship chain", "group management"): those nouns are
+ * ambiguous and can also be client-SDK feature questions on a specific platform.
+ * A platform / SDK / "how to implement" signal disqualifies the product-scope interpretation.
+ */
+const PRODUCT_SCOPE_INTENT = /控制台|计费|套餐|价格|退费|续费|配额|使用限制|数量限制|存储时长|漫游.{0,4}时长|多端登录|登录策略|console|dashboard|billing|pricing|package\s*(plan|feature|difference)|quota|usage\s*limit|multi[\s-]?device\s*login|login\s*(policy|strategy)|(message\s*)?storage\s*(duration|period)|retention/i;
+const CLIENT_IMPL_SIGNAL = /\b(android|ios|flutter|harmonyos|react[\s-]?native|unity|unreal(\s*engine)?|donut|uni[\s-]?app)\b|\bSDK\b|\bAPI\b|怎么(实现|调用|集成|接入|写)|如何(实现|调用|集成|接入|写)|\b(implement|integrate)\b/i;
+export function isProductScopePrompt(prompt) {
+    if (!PRODUCT_SCOPE_INTENT.test(prompt))
+        return false;
+    if (CLIENT_IMPL_SIGNAL.test(prompt))
+        return false;
+    return true;
+}
+/**
+ * When the Agent mislabels a product-scope question as `feature` (no framework given),
+ * rewrite the type to `product` so filterPool can hit chat/urls/product.md.
+ * If a framework is present, the Agent genuinely wants a client feature — do not downgrade.
+ */
+export function downgradeToProductType(products, types, prompt, framework) {
+    if (framework)
+        return types;
+    if (!types.includes('feature'))
+        return types;
+    if (!products?.includes('chat'))
+        return types;
+    if (!isProductScopePrompt(prompt))
+        return types;
+    const downgraded = types.filter((t) => t !== 'feature');
+    if (!downgraded.includes('product'))
+        downgraded.push('product');
+    return downgraded;
+}

package/knowledge/search/requires-framework.js

@@ -1,3 +1,4 @@
+import { isProductScopePrompt } from './product-scope-intent.js';
 const PLATFORM_TYPES = new Set([
     'api',
     'component',
@@ -25,6 +26,12 @@ const PUSH_OVERVIEW_PROMPT = /开通|创建\s*Push|创建应用|SDKAppID|控制
 function hasProduct(norm, p) {
     return !!(norm.product?.includes(p));
 }
+/** chat/urls/product.md：产品/账号级配置，非客户端 SDK feature */
+function isChatProductScopeQuery(norm) {
+    if (!hasProduct(norm, 'chat'))
+        return false;
+    return isProductScopePrompt(norm.prompt);
+}
 /** chat error-code URL 同时列了「服务端 / Web / Native」三类入口，必须先问平台才能定位 */
 function isChatErrorCodeAmbiguous(norm) {
     if (!hasProduct(norm, 'chat'))
@@ -58,6 +65,8 @@ export function requiresFramework(norm) {
         return true;
     if (CROSS_PLATFORM_PROMPT.test(norm.prompt))
         return false;
+    if (isChatProductScopeQuery(norm))
+        return false;
     if (norm.searchIntent?.length) {
         if (norm.searchIntent.some((t) => PLATFORM_TYPES.has(t)))
             return true;

package/knowledge/search/search-knowledge.js

@@ -188,7 +188,11 @@ export function searchKnowledge(params) {
     }
     const manifest = loadManifest();
     const allChunks = manifest.chunks;
-    const pool = filterPool(allChunks, norm);
+    let pool = filterPool(allChunks, norm);
+    // 自愈：types 过滤导致 0 命中时，丢掉 types 再过滤一次，避免误传类型标签直接返回 empty
+    if (pool.length === 0 && norm.types?.length) {
+        pool = filterPool(allChunks, { ...norm, types: undefined });
+    }
     const { boosts, exactHits } = runExactLookup(norm.prompt, pool, norm);
     // P0-4：用 product 级缓存的 BM25 索引对子集打分（首次构建，后续命中缓存）
     // 索引基于该 product 全量 chunks（含 integration corpus）；

package/package.json

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

package/resource/index/component-slugs.json

@@ -1 +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"]}
+{}