@tencent-rtc/mcp 1.7.3 → 1.7.5

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # CHANGELOG
 
+## Version 1.7.5 @2026.09.04
+
+### Changed
+- Refactored the `preflight-route` decision model to an **agent-first, minimal-correction** strategy: prioritize agent-provided `product/frameworks`, and use prompt signals only for high-confidence corrections and narrowing to avoid unsupported expansion.
+- Optimized framework-axis conflict handling: added/enhanced strong-lock strategies for `react-native` and `miniprogram`, and in strong-lock scenarios, separated host environment (`android/ios`) from the actual framework to reduce over-narrowing.
+- Optimized native TRTC correction: when the prompt matches native TRTC classes/methods and no WebRTC hard signal is present, narrow `rtcengine` to `native_trtc_sdk` to reduce web/native cross-routing risk.
+
+### Fixed
+- Fixed over-overriding of agent results when strong framework terms are only passively mentioned, reducing false corrections triggered by doc-enumeration terms.
+
+## Version 1.7.4 @2026.08.31
+
+### Added
+- Added 4 CallKit Flutter best-practice docs: Android background call keep-alive, iOS background audio keep-alive, iOS startup crash troubleshooting, background incoming call notification troubleshooting.
+- Added CallKit Android video chat dating scenario (VideoChat Demo) best-practice doc, covering Demo setup and component quick integration.
+- Added CallKit HarmonyOS platform support: UIKit integration guide and API reference.
+- Added CallKit Mini Program & uni-app docs: UIKit integration guide, API reference, uni-app packaging guide.
+- Added CallKit uni-app (Android/iOS) standalone integration docs and API reference.
+- Added Chat Vue3/React H5 mobile integration docs.
+
+### Changed
+- Optimized Chat UIKit search tags: vue/react framework changed from single tag to dual tags (`['vue','web']` / `['react','web']`), allowing `frameworks=['web']` to match Chat Web docs.
+
 ## Version 1.7.3 @2026.08.17
 
 ### Added

package/README.md

@@ -57,39 +57,38 @@ npx -y @tencent-rtc/mcp
 
 > Only recent updates are listed here. For full history, see `CHANGELOG.md`.
 
-## Version 1.7.3 @2026.08.17
-
-### Added
-- Added knowledge base resources for RoomKit multi-platform integration, recording, whiteboard, network proxy, AI noise reduction, and subtitle translation, expanding coverage of the Room product domain.
-- Added best-practice docs covering error codes, log levels, automatic screen-share stop, and WeChat Mini Program error troubleshooting.
-- Added a generic additive rerank module with anchor selection and phrase extraction, integrated into the search reranking logic to improve recall ranking accuracy.
+## Version 1.7.5 @2026.09.04
 
 ### Changed
-- Optimized the BM25 index to use prototype-less objects, improving the isolation and stability of the index structure.
+- Refactored the `preflight-route` decision model to an **agent-first, minimal-correction** strategy: prioritize agent-provided `product/frameworks`, and use prompt signals only for high-confidence corrections and narrowing to avoid unsupported expansion.
+- Optimized framework-axis conflict handling: added/enhanced strong-lock strategies for `react-native` and `miniprogram`, and in strong-lock scenarios, separated host environment (`android/ios`) from the actual framework to reduce over-narrowing.
+- Optimized native TRTC correction: when the prompt matches native TRTC classes/methods and no WebRTC hard signal is present, narrow `rtcengine` to `native_trtc_sdk` to reduce web/native cross-routing risk.
 
 ### Fixed
-- Fixed BM25 scoring anomalies caused by prototype-key pollution by adding prototype-key guards, preventing score pollution and NaN issues.
+- Fixed over-overriding of agent results when strong framework terms are only passively mentioned, reducing false corrections triggered by doc-enumeration terms.
 
-## Version 1.7.1 @2026.08.11
+## Version 1.7.4 @2026.08.31
 
 ### Added
-- Added pre-search normalization: normalizes `product` / `frameworks` based on prompt truth, fixing retrieval bias caused by wrong agent inference.
+- Added 4 CallKit Flutter best-practice docs: Android background call keep-alive, iOS background audio keep-alive, iOS startup crash troubleshooting, background incoming call notification troubleshooting.
+- Added CallKit Android video chat dating scenario (VideoChat Demo) best-practice doc, covering Demo setup and component quick integration.
+- Added CallKit HarmonyOS platform support: UIKit integration guide and API reference.
+- Added CallKit Mini Program & uni-app docs: UIKit integration guide, API reference, uni-app packaging guide.
+- Added CallKit uni-app (Android/iOS) standalone integration docs and API reference.
+- Added Chat Vue3/React H5 mobile integration docs.
 
 ### Changed
-- Optimized the `search_trtc_knowledge` output contract: removed brevity wording such as "1-2 sentence per subsection", replaced with complete synthesized answers.
-
-### Fixed
-- Fixed the case where mis-passed dual product / dual frameworks (e.g., "安卓 Web TRTC") were not corrected according to the prompt truth.
+- Optimized Chat UIKit search tags: vue/react framework changed from single tag to dual tags (`['vue','web']` / `['react','web']`), allowing `frameworks=['web']` to match Chat Web docs.
 
-### Version 1.7.0 @2026.08.02
+## Version 1.7.3 @2026.08.17
 
-#### Added
-- Added and synchronized best-practice docs across product domains including Chat / Call / Live / Room to improve knowledge coverage.
+### Added
+- Added knowledge base resources for RoomKit multi-platform integration, recording, whiteboard, network proxy, AI noise reduction, and subtitle translation, expanding coverage of the Room product domain.
+- Added best-practice docs covering error codes, log levels, automatic screen-share stop, and WeChat Mini Program error troubleshooting.
+- Added a generic additive rerank module with anchor selection and phrase extraction, integrated into the search reranking logic to improve recall ranking accuracy.
 
-#### Changed
-- Continued refactoring of the bilingual retrieval pipeline, including query normalization, intent routing, candidate filtering, and exact-match strategies.
-- Improved recall and ranking for best-practice and URL-based documents to increase answer usability and stability.
-- Improved `search_trtc_knowledge` definitions and answer constraints for better readability and executability.
+### Changed
+- Optimized the BM25 index to use prototype-less objects, improving the isolation and stability of the index structure.
 
-#### Fixed
-- Fixed off-topic retrieval in some complex queries, reducing high-score false-positive hits.
+### Fixed
+- Fixed BM25 scoring anomalies caused by prototype-key pollution by adding prototype-key guards, preventing score pollution and NaN issues.

package/knowledge/path-meta.js

@@ -8,6 +8,9 @@ function inferTypesFromFilename(fileName, baseTypes) {
         types.push('error_code');
     if (lower === 'client-api.md' || lower === 'api.md' || lower === 'index.md')
         types.push('api');
+    // api-<变体>.md（如 api-uniapp.md：微信小程序 uni-app 打包 API）同样是 API 文档
+    if (/^api-[\w-]+\.mdx?$/.test(lower))
+        types.push('api');
     if (lower === 'faq.md')
         types.push('faq');
     // 文件名 = integration.md 不再默认 push integration（由上游 framework 分支显式声明 type）
@@ -75,7 +78,14 @@ export function inferPathMeta(relativeSource) {
     else 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])];
+            const fw = normalizeFrameworkDir(parts[parts.indexOf('preset') + 1]);
+            // vue/react 运行在 Web/H5 端，追加 web 标签，使 frameworks=['web'] 也能命中
+            framework = (fw === 'vue' || fw === 'react') ? [fw, 'web'] : [fw];
+            variant = 'preset';
+            // preset 下的 integration.md 显式标记 integration type
+            if (fileName.toLowerCase() === 'integration.md') {
+                types.push('integration');
+            }
         }
         if (parts.includes('features')) {
             types.push('feature');
@@ -137,6 +147,13 @@ export function inferPathMeta(relativeSource) {
             framework = [normalizeFrameworkDir(parts[coreIdx + 1])];
             variant = 'core-sdk';
         }
+        // 微信小程序 uni-app 打包版：目录归入 miniprogram（运行平台=微信小程序），
+        // 但技术栈是 uni-app，通过文件名 *-uniapp.md / uniapp-*.md 触发双标签，
+        // 使「微信小程序」与「uni-app」两种 framework 检索都能召回同一篇文档。
+        // 原生小程序（api.md/integration.md 等无 uniapp 标记）保持单 miniprogram 标签。
+        if (framework[0] === 'miniprogram' && /(^uniapp[-.]|-uniapp\.mdx?$)/.test(fileName.toLowerCase())) {
+            framework = ['miniprogram', 'uni-app'];
+        }
         // callkit 最佳实践目录：knowledge/callkit/best-practice/{platform}/{topic}.md
         // 统一按 FAQ/经验类知识处理，支持 types=faq + frameworks={platform} 的精确检索。
         // 与 chat best-practice 对齐：common 目录表示多平台通用，按最全集覆盖。
@@ -147,6 +164,11 @@ export function inferPathMeta(relativeSource) {
                 : [fwSlug];
             types.push('faq');
         }
+        // preset 下的 integration.md（纯文件名，无连字符前缀）需显式标记 integration type，
+        // 否则 inferTypesFromFilename 只匹配 *-integration.md，导致兜底为 faq。
+        if (variant === 'preset' && fileName.toLowerCase() === 'integration.md') {
+            types.push('integration');
+        }
         if (parts.includes('faq'))
             types.push('faq', 'error_code');
         if (fileName === 'api.md')

package/package.json

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