@tencent-rtc/mcp 1.4.7 → 1.6.0

package/knowledge/search/filter-pool.js

@@ -0,0 +1,104 @@
+import { downgradeToProductType } from './product-scope-intent.js';
+/**
+ * MCP framework enum → index 中对应的 framework 值列表。
+ * path-meta.ts 已通过 normalizeFrameworkDir 把目录名归一到标准 framework，
+ * 所有产品的 framework 均已对齐枚举值，无需额外别名扩展。
+ * web 匹配 react/vue/web（Chat/Call/Live Web 端覆盖）。
+ */
+const FRAMEWORK_SEARCH_ALIASES = {};
+function expandFrameworks(framework) {
+    if (!framework)
+        return undefined;
+    if (framework === 'web')
+        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, prompt, framework) {
+    if (!types?.length)
+        return undefined;
+    if (products?.includes('chat') && types.includes('faq')) {
+        return undefined;
+    }
+    const downgraded = downgradeToProductType(products, types, prompt, framework);
+    return expandTypeAliases(downgraded);
+}
+/** 单平台产品的隐式 framework 推断：避免对显然唯一的平台再发起询问 */
+function inferImplicitFramework(products, framework) {
+    if (framework)
+        return framework;
+    if (products?.length === 1 && products[0] === 'rtcengine')
+        return 'web';
+    return undefined;
+}
+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, params.prompt, effectiveFramework);
+    return {
+        prompt: params.prompt,
+        product: params.product,
+        framework: effectiveFramework,
+        frameworks,
+        searchIntent: params.types,
+        types,
+        scenario: params.scenario,
+        limit,
+    };
+}
+/**
+ * 跨平台类型集合：framework=['*'] 的 chunk 仅在 type 命中这些时才视为合理。
+ * - server_api / webhook / product：天然跨平台
+ * - faq / error_code：URL 映射页（chat/urls/error-code.md）与 callkit/faq/ 等按平台分 faq 文件，
+ *   都标记为 framework=['*']，按 framework 检索时不应被武断排除
+ */
+const CROSS_PLATFORM_CHUNK_TYPES = new Set([
+    'server_api',
+    'webhook',
+    'product',
+    'faq',
+    'error_code',
+]);
+function chunkIsCrossPlatform(chunkTypes) {
+    return chunkTypes.some((t) => CROSS_PLATFORM_CHUNK_TYPES.has(t));
+}
+export function filterPool(chunks, norm) {
+    return chunks.filter((chunk) => {
+        if (norm.product && !norm.product.includes(chunk.product) && chunk.product !== '*') {
+            return false;
+        }
+        if (norm.frameworks?.length) {
+            const isWildcardChunk = chunk.framework.includes('*');
+            // 收紧：framework=['*'] 仅在该 chunk 明确是跨平台 type（product/server_api/webhook）时放行；
+            // 否则要求 chunk.framework 与请求 framework 有交集。
+            const wildcardAllowed = isWildcardChunk && chunkIsCrossPlatform(chunk.types);
+            const explicitMatch = norm.frameworks.some((fw) => chunk.framework.includes(fw));
+            if (!explicitMatch && !wildcardAllowed)
+                return false;
+        }
+        if (norm.scenario && chunk.scenario && chunk.scenario !== norm.scenario) {
+            return false;
+        }
+        if (norm.types?.length && !norm.types.some((t) => chunk.types.includes(t))) {
+            return false;
+        }
+        return true;
+    });
+}

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

@@ -0,0 +1,81 @@
+import { isProductScopePrompt } from './product-scope-intent.js';
+const PLATFORM_TYPES = new Set([
+    'api',
+    'component',
+    'feature',
+    'plugin',
+    'sdk',
+    'integration',
+]);
+const CROSS_PLATFORM_TYPES = new Set(['server_api', 'webhook', 'product']);
+const CROSS_PLATFORM_PROMPT = /计费|套餐|价格|UserSig\s*原理|签发流程|控制台|服务端\s*REST|云\s*API|Webhook|回调/i;
+const PLATFORM_PROMPT = /API|组件|怎么用|怎么开|怎么设置|怎么配置|虚拟背景|屏幕分享|enterRoom|SDK|插件|集成步骤|客户端|Feature|主题定制|连麦|上麦/i;
+/**
+ * push 必须问平台的强信号：仅当 prompt 明确提到具体「平台」（android/ios/flutter/...）时才拦询问。
+ * 厂商（小米/OPPO/华为/FCM 等）不算平台——它们会命中写写对齐后的平台级配置页（如 knowledge/push/config/android.md），
+ * 问厂商问题不需要再让用户选平台。
+ */
+const PUSH_PLATFORM_SPECIFIC_PROMPT = /\b(android|ios|flutter|harmonyos|react[\s-]?native|unity|unreal|donut|uni[\s-]?app)\b/i;
+/**
+ * push 综述关键词：直接对应 knowledge/push/overview/prepare.md 的两个二级标题
+ *   - "## 开通 Push 服务"      → 开通 / 创建应用 / SDKAppID / 控制台 / 数据中心
+ *   - "## 接入流程说明"         → 接入流程 / 厂商配置 / SDK 接入 / 高级功能设置
+ * 命中即跨平台综述，无需问平台。
+ */
+const PUSH_OVERVIEW_PROMPT = /开通|创建\s*Push|创建应用|SDKAppID|控制台|数据中心|接入流程|接入推送|厂商配置|SDK\s*接入|高级功能|离线推送(?!\s*怎么)/i;
+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'))
+        return false;
+    if (norm.framework)
+        return false;
+    if (norm.searchIntent?.includes('error_code'))
+        return true;
+    return /错误码|error\s*code|ERR_/i.test(norm.prompt);
+}
+/** 未传 framework 时，是否应先 present_framework_choice 再检索 */
+export function requiresFramework(norm) {
+    if (norm.framework)
+        return false;
+    // 硬规则：chat 错误码场景必须问平台（服务端 / Web / Native 三个 URL）
+    if (isChatErrorCodeAmbiguous(norm))
+        return true;
+    // push：判定逻辑（自上而下）
+    if (hasProduct(norm, 'push')) {
+        if (norm.searchIntent?.length && norm.searchIntent.every((t) => CROSS_PLATFORM_TYPES.has(t))) {
+            return false;
+        }
+        if (PUSH_PLATFORM_SPECIFIC_PROMPT.test(norm.prompt))
+            return true;
+        if (PUSH_OVERVIEW_PROMPT.test(norm.prompt))
+            return false;
+        return false;
+    }
+    // native_trtc_sdk：所有平台相关咨询都依赖具体客户端（android/ios/c++），必须先问
+    if (hasProduct(norm, 'native_trtc_sdk'))
+        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;
+        if (norm.searchIntent.every((t) => CROSS_PLATFORM_TYPES.has(t)))
+            return false;
+        // faq / error_code 等默认可跨平台检索
+        if (norm.searchIntent.every((t) => t === 'faq' || t === 'error_code' || CROSS_PLATFORM_TYPES.has(t))) {
+            return false;
+        }
+    }
+    return PLATFORM_PROMPT.test(norm.prompt);
+}

package/knowledge/search/search-knowledge.js

@@ -0,0 +1,229 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+import { attachPoolContent, getSourceFileContent } from '../content-loader.js';
+import { buildReferences, resolveFragmentDocUrls } from '../doc-url-resolver.js';
+import { rankSubsetWithIndex } from '../bm25.js';
+import { getProductsBM25Index } from '../bm25-cache.js';
+import { filterPool, normalizeParams } from './filter-pool.js';
+import { runExactLookup } from './exact-lookup.js';
+import { requiresFramework } from './requires-framework.js';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+let cachedManifest = null;
+function resolveResourcePath(...segments) {
+    return path.resolve(__dirname, '../../resource', ...segments);
+}
+function loadManifest() {
+    if (cachedManifest)
+        return cachedManifest;
+    const manifestPath = resolveResourcePath('index', 'manifest.json');
+    if (!fs.existsSync(manifestPath)) {
+        throw new Error('manifest.json not found. Run `npm run build` in zh/ first.');
+    }
+    cachedManifest = JSON.parse(fs.readFileSync(manifestPath, 'utf-8'));
+    return cachedManifest;
+}
+function postProcess(ranked, chunksById, limit) {
+    const sourceCount = {};
+    const urlMappingSourceCount = {};
+    /** 已入选的 push config/android/{vendor} 文件，用于抑制其他厂商噪声 */
+    let selectedVendorFile = null;
+    const fragments = [];
+    for (const item of ranked) {
+        const chunk = chunksById.get(item.id);
+        if (!chunk)
+            continue;
+        const isUrlMapping = Boolean(isUrlMappingSource(chunk.source));
+        if (isUrlMapping) {
+            const urlCount = urlMappingSourceCount[chunk.source] ?? 0;
+            if (urlCount >= 1)
+                continue;
+            urlMappingSourceCount[chunk.source] = urlCount + 1;
+        }
+        else {
+            const count = sourceCount[chunk.source] ?? 0;
+            if (count >= 3)
+                continue;
+            sourceCount[chunk.source] = count + 1;
+        }
+        // 当用户明确问某厂商时，抑制同目录下其他厂商文档的噪声
+        // 规则：如果已有 config/android/{vendor}.md 入选，
+        // 后续其他 config/android/{other}.md 跳过
+        const isVendorDoc = chunk.source.match(/^knowledge\/push\/config\/android\/[a-z]+\.md$/);
+        if (isVendorDoc) {
+            if (!selectedVendorFile) {
+                selectedVendorFile = chunk.source;
+            }
+            else if (chunk.source !== selectedVendorFile) {
+                continue; // 跳过其他厂商
+            }
+        }
+        // 当已明确命中了厂商配置页后，后续的 push 通用文件（integration/、其他 config/）不再有意义
+        // 只保留同厂商文件（已由 vendor dedup 处理）和 overview 综述，其他 push 通用文档视为噪声
+        if (selectedVendorFile && chunk.source.startsWith('knowledge/push/') && !chunk.source.includes('/overview/')) {
+            if (chunk.source !== selectedVendorFile)
+                continue;
+        }
+        const firstPush = fragments.length === 0;
+        if (firstPush) {
+            // 首条不设分数截止，至少保证 1 条返回
+        }
+        else {
+            // 分数衰减到 top 的 5% 以下时停止，不硬填到 limit
+            const topScore = fragments[0].score;
+            if (topScore > 0 && item.score < topScore * 0.05)
+                break;
+        }
+        fragments.push({
+            rank: fragments.length + 1,
+            score: item.score,
+            title: chunk.title,
+            content: chunk.content,
+            source: chunk.source,
+            doc_urls: resolveFragmentDocUrls(chunk.source, chunk.content, getSourceFileContent(chunk.source)),
+            product: chunk.product,
+            framework: chunk.framework,
+            types: chunk.types,
+            chunk_id: chunk.id,
+        });
+        if (fragments.length >= limit)
+            break;
+    }
+    return fragments;
+}
+function isUrlMappingSource(source) {
+    const normalized = source.replace(/\\/g, '/');
+    const match = normalized.match(/knowledge\/chat\/urls\/(.+\.md)$/);
+    if (!match)
+        return null;
+    return match[1].replace(/\.md$/, '').replace(/\/index$/, '');
+}
+function partitionFragments(fragments) {
+    const urlMapping = [];
+    const localDoc = [];
+    for (const fragment of fragments) {
+        if (isUrlMappingSource(fragment.source)) {
+            urlMapping.push(fragment);
+        }
+        else {
+            localDoc.push(fragment);
+        }
+    }
+    const urlMappingKinds = [...new Set(urlMapping.map((f) => isUrlMappingSource(f.source)).filter(Boolean))];
+    return { urlMapping, localDoc, urlMappingKinds };
+}
+/**
+ * P0-3：相对阈值的置信度评估。
+ * - high：top ≥ 50 或有精确命中（exactHits 非空）
+ * - medium：top ≥ 10 且 top / second ≥ 1.3（区分度足够）
+ * - low：top 较低或与 second 接近（同水位竞争，agent 应谨慎）
+ * - none：fragments 为空
+ */
+function assessConfidence(fragments, exactHits) {
+    if (fragments.length === 0) {
+        return { confidence: 'none', status: 'empty' };
+    }
+    const top = fragments[0].score;
+    const second = fragments[1]?.score ?? 0;
+    if (exactHits.length > 0 || top >= 50) {
+        return { confidence: 'high', status: 'success' };
+    }
+    const ratio = second > 0 ? top / second : Infinity;
+    if (top >= 10 && ratio >= 1.3) {
+        return { confidence: 'medium', status: 'success' };
+    }
+    if (top >= 5 && ratio >= 1.15) {
+        return { confidence: 'medium', status: 'success' };
+    }
+    return { confidence: 'low', status: 'low_confidence' };
+}
+function buildAgentMessage(status, fragments, confidence, references) {
+    const citeTail = references?.length
+        ? 'When answering, MUST append a **References** section listing only **https** URLs from `meta.references` (or each fragment\'s `doc_urls`). Do not invent links. Do **not** list local repo paths such as `knowledge/...` or `integration/...` — users cannot open those.'
+        : 'If fragments include `doc_urls`, append a **References** section with those **https** URLs only. Do **not** cite `fragment.source` local paths. If no online URLs are available, omit the References section rather than listing local file paths.';
+    const tail = `${citeTail} After synthesizing the answer, MUST call \`record_answer\` (same prompt + queryID from this response) BEFORE replying to the user; append the returned follow-up text. On user feedback MUST call \`record_feedback\`.`;
+    if (status === 'needs_framework') {
+        return '[Hard rule] This question depends on a specific platform but no framework was provided; cross-platform search is low-signal and disallowed. MUST call `present_framework_choice` (with product), wait for the user to pick android/ios/flutter/react/vue/uni-app, then call this tool again with **product + framework**. Do not search with an empty framework.';
+    }
+    const { urlMapping, localDoc, urlMappingKinds } = partitionFragments(fragments);
+    const hasUrlMapping = urlMapping.length > 0;
+    const hasLocalDoc = localDoc.length > 0;
+    const urlKindLabel = urlMappingKinds.join(' / ') || 'urls';
+    if (status === 'success' && fragments.length > 0) {
+        const confidenceHint = confidence === 'high' ? '(confidence=high)'
+            : confidence === 'medium' ? '(confidence=medium; top vs runner-up separation is moderate—confirm with the user if unsure)'
+                : '';
+        if (hasUrlMapping && !hasLocalDoc) {
+            return `Knowledge base hit **L1 URL map**${confidenceHint} (${urlKindLabel}, ${urlMapping.length} fragment(s)). These fragments are **documentation entry URLs only** (cloud.tencent.com / web.sdk.qcloud.com, etc.), not full REST API / error-code / webhook text. MUST: ① match the user's question to the **target URL** in fragments; ② **fetch** that official doc before answering; ③ do not restate the map table or invent API/error details.${tail}`;
+        }
+        if (hasUrlMapping && hasLocalDoc) {
+            return `Knowledge base returned ${fragments.length} fragment(s)${confidenceHint}: ${localDoc.length} local doc + ${urlMapping.length} URL map (${urlKindLabel}). Answer directly from **local doc** fragments (preset/integration, etc.); for **URL map** fragments MUST extract the target URL and **fetch** the official doc—do not restate the map table.${tail}`;
+        }
+        return `Knowledge base returned ${fragments.length} valid fragment(s)${confidenceHint}. Synthesize the answer **only from fragments**; do **not** run web_search or fetch docs separately.${tail}`;
+    }
+    if (status === 'low_confidence') {
+        if (hasUrlMapping) {
+            return `Low confidence (confidence=low: top score weak or too close to runner-up) but URL map hit (${urlKindLabel}). Extract target URLs from fragments and **fetch** official docs; tell the user if the map does not cover their question.${tail}`;
+        }
+        return `Low confidence (confidence=low: top score weak or too close to runner-up; may not match the question). Answer from available fragments and **state uncertainty**; ask for a more specific query (component / API / error code) and retry. Do **not** default to web_search.${tail}`;
+    }
+    return `No valid fragments matched. Tell the user and verify product/framework; if the question needs a client platform, call \`present_framework_choice\` first.${tail}`;
+}
+export function searchKnowledge(params) {
+    const norm = normalizeParams(params);
+    if (requiresFramework(norm)) {
+        const manifest = loadManifest();
+        return {
+            status: 'needs_framework',
+            confidence: 'none',
+            message: buildAgentMessage('needs_framework', [], 'none', undefined),
+            query: params,
+            meta: {
+                pool_size: manifest.chunks.length,
+                filtered_size: 0,
+                exact_hits: [],
+            },
+            fragments: [],
+        };
+    }
+    const manifest = loadManifest();
+    const allChunks = manifest.chunks;
+    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）；
+    // 子集 ranking 只对 filteredPool.map(id) 打分，IDF 用更稳的产品级全量统计。
+    // 支持多 product 同时检索（products 数组），跨域问题如 Chat + Push 能同时命中各方知识。
+    const productIndex = getProductsBM25Index(allChunks, norm.product);
+    const poolWithContent = attachPoolContent(pool);
+    const chunksById = new Map(poolWithContent.map((chunk) => [chunk.id, chunk]));
+    const ranked = rankSubsetWithIndex(norm.prompt, pool.map((chunk) => chunk.id), productIndex, boosts);
+    const fragments = postProcess(ranked, chunksById, norm.limit);
+    const urlMappingSources = [...new Set(fragments.map((f) => f.source).filter((source) => isUrlMappingSource(source)))];
+    const references = buildReferences(fragments);
+    // P0-3：相对阈值评估置信度（替代原硬编码 0.5 死阈值）
+    const { confidence, status } = assessConfidence(fragments, exactHits);
+    const topScore = fragments[0]?.score;
+    const secondScore = fragments[1]?.score;
+    return {
+        status,
+        confidence,
+        message: buildAgentMessage(status, fragments, confidence, references),
+        query: params,
+        meta: {
+            pool_size: allChunks.length,
+            filtered_size: pool.length,
+            exact_hits: exactHits,
+            ...(urlMappingSources.length ? { url_mapping_sources: urlMappingSources } : {}),
+            ...(references.length ? { references } : {}),
+            ...(topScore !== undefined ? { top_score: Number(topScore.toFixed(2)) } : {}),
+            ...(secondScore !== undefined ? { second_score: Number(secondScore.toFixed(2)) } : {}),
+        },
+        fragments,
+    };
+}
+export { normalizeParams, filterPool };

package/package.json

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

package/resource/_schema/feature-aliases.yaml

@@ -0,0 +1,10 @@
+chat:
+  theme.md: ["theme", "theme customization", "dark mode", "TUITheme", "custom UI"]
+live:
+  live-co-guest-interaction.md: ["co-guest", "audience co-guest", "co_guest", "CoGuest"]
+  live-host-interaction.md: ["PK", "host co-host", "co_host"]
+  live-base-beauty.md: ["beauty", "base_beauty"]
+  voice-co-guest-interaction.md: ["voice room go on mic", "go on mic", "voice co guest", "co guest"]
+room:
+  screen-share.md: ["screen sharing", "screen share", "startScreenShare"]
+  virtual-background.md: ["virtual background"]

package/resource/_schema/goal-tags.yaml

@@ -0,0 +1,72 @@
+get_web_chat_uikit_integration:
+  full-featured:
+    root: integration
+    path: chat/preset/{framework}/integration.md
+  chat-only:
+    root: integration
+    path: chat/preset/{framework}/integration.md
+get_native_chat_uikit_integration:
+  full-featured:
+    root: integration
+    path: chat/preset/{framework}/integration.md
+  chat-only:
+    root: integration
+    path: chat/preset/{framework}/integration.md
+get_web_call_uikit_integration:
+  integration:
+    root: integration
+    path: callkit/preset/{framework}/integration.md
+get_native_call_uikit_integration:
+  integration:
+    root: integration
+    path: callkit/preset/{framework}/integration.md
+get_native_callkit_core_integration:
+  make_call:
+    root: knowledge
+    path: callkit/core-sdk/{framework}/make-call.md
+  answer_call:
+    root: knowledge
+    path: callkit/core-sdk/{framework}/answer-call.md
+  offline_push:
+    root: knowledge
+    path: callkit/core-sdk/{framework}/offline-push.md
+get_web_live_uikit_integration:
+  liveList:
+    root: integration
+    path: livekit/preset/live/vue/live-list-integration.md
+  livePlayer-desk:
+    root: integration
+    path: livekit/preset/live/vue/live-player-desk-integration.md
+  livePlayer-h5:
+    root: integration
+    path: livekit/preset/live/vue/live-player-h5-integration.md
+  livePusher:
+    root: integration
+    path: livekit/preset/live/vue/live-pusher-integration.md
+  CoGuestPanel:
+    root: integration
+    path: livekit/preset/live/vue/components/co-guest-panel.md
+get_native_livekit_core_integration:
+  host_streaming:
+    root: knowledge
+    path: livekit/core-sdk/{scenario}/{framework}/*-integration.md
+  audience_streaming:
+    root: knowledge
+    path: livekit/core-sdk/{scenario}/{framework}/*-integration.md
+  live_list:
+    root: knowledge
+    path: livekit/core-sdk/{scenario}/{framework}/*-list.md
+get_web_room_uikit_integration:
+  integration:
+    root: integration
+    path: roomkit/preset/vue/integration.md
+get_web_room_core_integration:
+  room-state:
+    root: knowledge
+    path: roomkit/core-sdk/vue/room-state.md
+  device-detection:
+    root: knowledge
+    path: roomkit/core-sdk/vue/device-detection.md
+  device-state:
+    root: knowledge
+    path: roomkit/core-sdk/vue/device-state.md

package/resource/_schema/products.yaml

@@ -0,0 +1,19 @@
+chat:
+  knowledge_root: chat
+  integration_root: chat
+call:
+  knowledge_root: callkit
+  integration_root: callkit
+live:
+  knowledge_root: livekit
+  integration_root: livekit
+room:
+  knowledge_root: roomkit
+  integration_root: roomkit
+push:
+  knowledge_root: push
+  integration_root: push
+rtcengine:
+  knowledge_root: rtcengine
+native_trtc_sdk:
+  knowledge_root: trtc

package/resource/_schema/trtc-intents.yaml

@@ -0,0 +1,27 @@
+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

package/resource/_schema/types.yaml

@@ -0,0 +1,43 @@
+integration:
+  globs:
+    - integration/**/*
+component:
+  globs:
+    - knowledge/**/components/*.md
+    - knowledge/chat/preset/vue/features/*.md
+    - knowledge/chat/preset/react/features/*.md
+    - knowledge/chat/preset/react/components/*.md
+    - knowledge/chat/preset/android/features/*.md
+feature:
+  globs:
+    - knowledge/**/features/*.md
+    - knowledge/livekit/core-sdk/**/*.md
+api:
+  globs:
+    - knowledge/**/api.md
+    - knowledge/**/client-api.md
+    - knowledge/**/api-reference/*.md
+plugin:
+  globs:
+    - knowledge/rtcengine/web/plugin/*.md
+sdk:
+  globs:
+    - knowledge/chat/urls/sdk/*.md
+faq:
+  globs:
+    - knowledge/**/faq.md
+    - knowledge/**/faq/**/*.md
+error_code:
+  globs:
+    - knowledge/chat/urls/error-code.md
+    - knowledge/**/error_code*.md
+    - knowledge/**/TXLiteAVCode.md
+product:
+  globs:
+    - knowledge/chat/urls/product.md
+server_api:
+  globs:
+    - knowledge/chat/urls/restapi.md
+webhook:
+  globs:
+    - knowledge/chat/urls/webhook.md

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/en/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/en/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/en/tutorial-21-advanced-auto-play-policy.md","knowledge/rtcengine/web/plugin/22-advanced-audio-mixer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-22-advanced-audio-mixer.md","knowledge/rtcengine/web/plugin/23-advanced-support-detection.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-23-advanced-support-detection.md","knowledge/rtcengine/web/plugin/24-advanced-network-quality.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-24-advanced-network-quality.md","knowledge/rtcengine/web/plugin/25-advanced-device-change.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-25-advanced-device-change.md","knowledge/rtcengine/web/plugin/26-advanced-publish-cdn-stream.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-26-advanced-publish-cdn-stream.md","knowledge/rtcengine/web/plugin/27-advanced-small-stream.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-27-advanced-small-stream.md","knowledge/rtcengine/web/plugin/28-advanced-beauty.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-28-advanced-beauty.md","knowledge/rtcengine/web/plugin/29-advanced-water-mark.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-29-advanced-water-mark.md","knowledge/rtcengine/web/plugin/30-advanced-cross-room-link.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-30-advanced-cross-room-link.md","knowledge/rtcengine/web/plugin/31-advanced-plugins-overview.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-31-advanced-plugins-overview.md","knowledge/rtcengine/web/plugin/34-advanced-proxy.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-34-advanced-proxy.md","knowledge/rtcengine/web/plugin/35-advanced-ai-denoiser.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-35-advanced-ai-denoiser.md","knowledge/rtcengine/web/plugin/36-advanced-virtual-background.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-36-advanced-virtual-background.md","knowledge/rtcengine/web/plugin/37-advanced-voice-changer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-37-advanced-voice-changer.md","knowledge/rtcengine/web/plugin/39-advanced-video-decoder.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-39-advanced-video-decoder.md","knowledge/rtcengine/web/plugin/40-advanced-video-mixer.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/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/en/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/en/tutorial-42-advanced-realtime-transcriber.md","knowledge/rtcengine/web/plugin/43-advanced-face-detection.md":"https://web.sdk.qcloud.com/trtc/webrtc/doc/en/tutorial-43-advanced-face-detection.md"}