@tencent-rtc/mcp 1.4.6 → 1.6.0-beta.1

package/knowledge/doc-url-resolver.js

@@ -0,0 +1,143 @@
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+/** 控制台/购买页等不适合作为「参考文档」的链接 */
+const NOISE_URL_RE = /console\.cloud\.tencent|buy\.cloud\.tencent|account\.renewal|edu\/learning/i;
+const PREFERRED_DOC_HOST_RE = /trtc\.io|cloud\.tencent\.com|web\.sdk\.qcloud\.com|github\.com\/Tencent(?:Cloud|RTC)/i;
+const LOCALHOST_URL_RE = /^https?:\/\/(?:localhost|127\.0\.0\.1)(?::|\b)/i;
+let cachedSourceUrlMap = null;
+function loadSourceUrlMap() {
+    if (cachedSourceUrlMap)
+        return cachedSourceUrlMap;
+    const mapPath = path.resolve(__dirname, '../resource/index/doc-source-urls.json');
+    if (!fs.existsSync(mapPath)) {
+        cachedSourceUrlMap = {};
+        return cachedSourceUrlMap;
+    }
+    cachedSourceUrlMap = JSON.parse(fs.readFileSync(mapPath, 'utf-8'));
+    return cachedSourceUrlMap;
+}
+function normalizeUrl(raw) {
+    return raw.replace(/[.,;)\]]+$/, '').trim();
+}
+function isUsefulDocUrl(url) {
+    if (!/^https?:\/\//i.test(url))
+        return false;
+    if (NOISE_URL_RE.test(url))
+        return false;
+    if (LOCALHOST_URL_RE.test(url))
+        return false;
+    return true;
+}
+/** 从 markdown 正文中提取可参考的官网链接（优先 cloud.tencent / web.sdk.qcloud） */
+export function extractUrlsFromContent(content, max = 3) {
+    const found = [];
+    const preferred = [];
+    for (const match of content.matchAll(/https?:\/\/[^\s`|)\]"'>]+/g)) {
+        const url = normalizeUrl(match[0]);
+        if (!isUsefulDocUrl(url))
+            continue;
+        if (PREFERRED_DOC_HOST_RE.test(url)) {
+            if (!preferred.includes(url))
+                preferred.push(url);
+        }
+        else if (!found.includes(url)) {
+            found.push(url);
+        }
+    }
+    const merged = [...preferred, ...found];
+    return merged.slice(0, max);
+}
+/** L1 URL 映射 chunk：表格行中的目标文档 URL */
+export function extractUrlMappingPrimaryUrl(content) {
+    const row = content.match(/\|\s*[^|]+\s*\|\s*`?(https?:\/\/[^|`\s]+)`?\s*\|/);
+    return row?.[1] ? normalizeUrl(row[1]) : null;
+}
+function isUrlMappingSource(source) {
+    return /knowledge\/chat\/urls\/.+\.md$/i.test(source.replace(/\\/g, '/'));
+}
+/**
+ * 为检索 fragment 解析可参考的官网 URL（去重、按优先级）。
+ * 1. sync-manifest 落盘的 localPath → 官网 URL（rtcengine 等）
+ * 2. L1 URL 映射行内目标 URL
+ * 3. 本地文档正文中的官网链接
+ */
+export function resolveFragmentDocUrls(source, content, fullSourceContent) {
+    const normalized = source.replace(/\\/g, '/');
+    const urls = [];
+    const canonical = loadSourceUrlMap()[normalized];
+    if (canonical)
+        urls.push(canonical);
+    if (isUrlMappingSource(normalized)) {
+        const primary = extractUrlMappingPrimaryUrl(content);
+        if (primary && !urls.includes(primary))
+            urls.push(primary);
+        return urls;
+    }
+    const collect = (text) => {
+        for (const url of extractUrlsFromContent(text)) {
+            if (!urls.includes(url))
+                urls.push(url);
+        }
+    };
+    collect(content);
+    if (urls.length === 0 && fullSourceContent && fullSourceContent !== content) {
+        collect(fullSourceContent);
+    }
+    return urls.slice(0, 3);
+}
+/** 从 fragments 汇总去重后的参考链接列表（按 fragment 相关度排序） */
+export function buildReferences(fragments) {
+    const refs = [];
+    const seen = new Set();
+    for (const fragment of fragments) {
+        for (const url of fragment.doc_urls) {
+            if (seen.has(url))
+                continue;
+            seen.add(url);
+            refs.push({
+                rank: refs.length + 1,
+                title: fragment.title,
+                url,
+                source: fragment.source,
+            });
+        }
+    }
+    return refs;
+}
+function coerceHttpUrl(value) {
+    if (typeof value !== 'string')
+        return null;
+    const normalized = value.replace(/\\/g, '/').trim();
+    if (!normalized.startsWith('http'))
+        return null;
+    return normalized;
+}
+function resolveManifestDocUrl(entry) {
+    return coerceHttpUrl(entry.ref) ?? coerceHttpUrl(entry.nodeId);
+}
+/** build 时从 sync-manifest 生成 localPath → 官网 URL 映射 */
+export function buildDocSourceUrlMap(syncManifestPath) {
+    if (!fs.existsSync(syncManifestPath))
+        return {};
+    const manifest = JSON.parse(fs.readFileSync(syncManifestPath, 'utf-8'));
+    const map = {};
+    const entries = manifest.entries ?? {};
+    for (const entry of Object.values(entries)) {
+        const url = resolveManifestDocUrl(entry);
+        if (url && entry.localPath) {
+            map[entry.localPath.replace(/\\/g, '/')] = url;
+        }
+    }
+    for (const [localPath, nodeId] of Object.entries(manifest.byLocalPath ?? {})) {
+        const normalized = localPath.replace(/\\/g, '/');
+        if (map[normalized])
+            continue;
+        const url = resolveManifestDocUrl(entries[nodeId] ?? { nodeId });
+        if (url)
+            map[normalized] = url;
+    }
+    return map;
+}
+//# sourceMappingURL=doc-url-resolver.js.map

package/knowledge/doc-url-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"doc-url-resolver.js","sourceRoot":"","sources":["../../src/knowledge/doc-url-resolver.ts"],"names":[],"mappings":"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"}

package/knowledge/extractors.js

@@ -0,0 +1,26 @@
+export function extractSymbols(content) {
+    const symbols = new Set();
+    for (const match of content.matchAll(/`([A-Za-z_][\w.]*)`/g)) {
+        symbols.add(match[1]);
+    }
+    for (const match of content.matchAll(/\b(use[A-Z]\w*)\b/g)) {
+        symbols.add(match[1]);
+    }
+    for (const match of content.matchAll(/\b([A-Z][A-Za-z0-9_]{2,})\b/g)) {
+        if (/^(TRTC|TX|ITX|ITRTC|V2TX|Login|Device|Room|Live|Call|CoGuest|CoHost|Battle|Gift|Barrage|Like|Seat|Audience|Beauty|Audio)/.test(match[1])) {
+            symbols.add(match[1]);
+        }
+    }
+    return [...symbols].slice(0, 50);
+}
+export function extractErrorCodes(content) {
+    const codes = new Set();
+    for (const match of content.matchAll(/\b(\d{5,7})\b/g)) {
+        codes.add(match[1]);
+    }
+    for (const match of content.matchAll(/\b(ERR_[A-Z0-9_]+)\b/g)) {
+        codes.add(match[1]);
+    }
+    return [...codes];
+}
+//# sourceMappingURL=extractors.js.map

package/knowledge/extractors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"extractors.js","sourceRoot":"","sources":["../../src/knowledge/extractors.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAAC,OAAe;IAC5C,MAAM,OAAO,GAAG,IAAI,GAAG,EAAU,CAAC;IAClC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,sBAAsB,CAAC,EAAE,CAAC;QAC7D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EAAE,CAAC;QAC3D,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,8BAA8B,CAAC,EAAE,CAAC;QACrE,IAAI,0HAA0H,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YAC9I,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;QACxB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;AACnC,CAAC;AAED,MAAM,UAAU,iBAAiB,CAAC,OAAe;IAC/C,MAAM,KAAK,GAAG,IAAI,GAAG,EAAU,CAAC;IAChC,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACvD,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,KAAK,MAAM,KAAK,IAAI,OAAO,CAAC,QAAQ,CAAC,uBAAuB,CAAC,EAAE,CAAC;QAC9D,KAAK,CAAC,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IACtB,CAAC;IACD,OAAO,CAAC,GAAG,KAAK,CAAC,CAAC;AACpB,CAAC"}

package/knowledge/path-meta.js

@@ -0,0 +1,185 @@
+function uniq(arr) {
+    return [...new Set(arr)];
+}
+function inferTypesFromFilename(fileName, baseTypes) {
+    const types = [...baseTypes];
+    const lower = fileName.toLowerCase();
+    if (/error.?code|txliteavcode/.test(lower))
+        types.push('error_code');
+    if (lower === 'client-api.md' || lower === 'api.md' || lower === 'index.md')
+        types.push('api');
+    if (lower === 'faq.md')
+        types.push('faq');
+    if (lower === 'integration.md' || lower.endsWith('-integration.md'))
+        types.push('integration');
+    if (/live-.*-interaction|voice-/.test(lower))
+        types.push('feature');
+    if (lower.includes('plugin') || /^\d+-advanced-/.test(lower))
+        types.push('plugin');
+    return uniq(types);
+}
+/** 目录名 → 标准 framework 值：消除 android-view / ios-uikit 这类内部目录命名泄漏到元数据标签 */
+const DIR_TO_FRAMEWORK = {
+    'android-view': 'android',
+    'ios-uikit': 'ios',
+};
+function normalizeFrameworkDir(dir) {
+    return DIR_TO_FRAMEWORK[dir] ?? dir;
+}
+export function inferPathMeta(relativeSource) {
+    const normalized = relativeSource.replace(/\\/g, '/');
+    const parts = normalized.split('/');
+    const corpus = parts[0] === 'integration' ? 'integration' : 'knowledge';
+    const fileName = parts[parts.length - 1] ?? '';
+    let product = '*';
+    let framework = ['*'];
+    let types = corpus === 'integration' ? ['integration'] : [];
+    let scenario = null;
+    if (normalized.startsWith('knowledge/chat/') || normalized.startsWith('integration/chat/')) {
+        product = 'chat';
+        if (parts.includes('preset') && parts.length >= 4) {
+            framework = [normalizeFrameworkDir(parts[parts.indexOf('preset') + 1])];
+        }
+        if (parts.includes('features')) {
+            types.push('feature');
+            if (parts.includes('preset')) {
+                const fw = normalizeFrameworkDir(parts[parts.indexOf('preset') + 1]);
+                if (fw === 'vue' || fw === 'react') {
+                    types.push('component');
+                }
+            }
+        }
+        if (parts.includes('urls')) {
+            if (fileName === 'product.md')
+                types.push('product');
+            else if (fileName === 'restapi.md')
+                types.push('server_api');
+            else if (fileName === 'webhook.md')
+                types.push('webhook');
+            else if (fileName === 'error-code.md')
+                types.push('error_code');
+            const urlsSdkIdx = parts.indexOf('sdk');
+            if (urlsSdkIdx >= 0 && parts[urlsSdkIdx - 1] === 'urls') {
+                const sdkFile = parts[urlsSdkIdx + 1];
+                if (sdkFile?.endsWith('.md')) {
+                    framework = [sdkFile.replace(/\.md$/, '')];
+                    types.push('sdk', 'api');
+                }
+            }
+        }
+        if (fileName === 'faq.md')
+            types.push('faq');
+    }
+    else if (normalized.includes('/callkit/')) {
+        product = 'call';
+        const presetIdx = parts.indexOf('preset');
+        const coreIdx = parts.indexOf('core-sdk');
+        if (presetIdx >= 0 && parts[presetIdx + 1])
+            framework = [normalizeFrameworkDir(parts[presetIdx + 1])];
+        if (coreIdx >= 0 && parts[coreIdx + 1])
+            framework = [normalizeFrameworkDir(parts[coreIdx + 1])];
+        if (parts.includes('faq'))
+            types.push('faq', 'error_code');
+        if (fileName === 'api.md')
+            types.push('api');
+        if (coreIdx >= 0)
+            types.push('api', 'feature');
+    }
+    else if (normalized.includes('/livekit/')) {
+        product = 'live';
+        if (parts.includes('voice'))
+            scenario = 'voice';
+        if (parts.includes('/live/'))
+            scenario = 'live';
+        if (parts.includes('preset') && parts.includes('vue'))
+            framework = ['vue'];
+        if (parts.includes('core-sdk') && parts.length >= 4) {
+            const fwIdx = parts.indexOf('core-sdk') + 2;
+            if (parts[fwIdx] && !['live', 'voice'].includes(parts[fwIdx])) {
+                framework = [normalizeFrameworkDir(parts[fwIdx])];
+            }
+        }
+        if (parts.includes('components') || (parts.includes('features') && parts.includes('preset')))
+            types.push('component');
+        if (parts.includes('api-reference'))
+            types.push('api');
+        if (parts.includes('core-sdk'))
+            types.push('feature', 'api');
+        if (parts.includes('faq'))
+            types.push('faq', 'error_code');
+        if (fileName === 'faq.md')
+            types.push('faq');
+    }
+    else if (normalized.includes('/roomkit/')) {
+        product = 'room';
+        const presetIdx = parts.indexOf('preset');
+        const coreIdx = parts.indexOf('core-sdk');
+        if (presetIdx >= 0 && parts[presetIdx + 1]) {
+            framework = [normalizeFrameworkDir(parts[presetIdx + 1])];
+        }
+        if (coreIdx >= 0 && parts[coreIdx + 1]) {
+            framework = [normalizeFrameworkDir(parts[coreIdx + 1])];
+        }
+        if (parts.includes('features') || parts.includes('core-sdk'))
+            types.push('feature');
+        if (parts.includes('faq'))
+            types.push('faq', 'error_code');
+    }
+    else if (normalized.startsWith('knowledge/trtc/')) {
+        product = 'native_trtc_sdk';
+        framework = [parts[2] ?? '*'];
+        types.push('api', 'error_code');
+    }
+    else if (normalized.startsWith('knowledge/rtcengine/')) {
+        product = 'rtcengine';
+        framework = ['web'];
+        if (parts.includes('plugin'))
+            types.push('plugin');
+        types.push('api', 'faq');
+    }
+    else if (normalized.startsWith('knowledge/push/')) {
+        // push 结构：
+        //   knowledge/push/overview/{topic}.md                  → 跨平台综述（接入前准备/流程/选型/计费等），framework=*，types=[product]
+        //   knowledge/push/integration/{platform}.md            → framework=平台 slug，types=[integration]
+        //   knowledge/push/config/{platform}.md                 → 与写写平台级配置页保持一致，framework=平台 slug，types=[integration]
+        product = 'push';
+        const category = parts[2]; // overview | integration | config
+        if (category === 'overview') {
+            framework = ['*'];
+            types.push('product');
+        }
+        else if (category === 'integration') {
+            const fwSlug = fileName.replace(/\.mdx?$/, ''); // android / ios / donut / ...
+            if (fwSlug) {
+                framework = [fwSlug];
+            }
+            types.push('integration');
+        }
+        else if (category === 'config') {
+            // config/{platform}.md：与写写平台级配置页 1:1 对齐（Android 厂商信息收敛在 android.md 正文内）
+            const platform = (parts[3] ?? fileName).replace(/\.mdx?$/, '');
+            framework = [platform];
+            types.push('integration', 'config');
+        }
+        else {
+            types.push('integration');
+        }
+    }
+    if (corpus === 'integration') {
+        types = ['integration'];
+    }
+    else if (types.length === 0) {
+        types = ['faq'];
+    }
+    types = inferTypesFromFilename(fileName, types);
+    if (types.length === 0)
+        types = ['faq'];
+    return {
+        product,
+        framework,
+        types: uniq(types),
+        scenario,
+        corpus,
+    };
+}
+//# sourceMappingURL=path-meta.js.map

package/knowledge/path-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"path-meta.js","sourceRoot":"","sources":["../../src/knowledge/path-meta.ts"],"names":[],"mappings":"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"}