@tencentcloud/sdk-mcp 1.7.3 → 1.7.5

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # CHANGELOG
 
+## Version 1.7.5 @2026.09.04
+
+### 变更
+- 重构 `preflight-route` 决策模型为 **agent-first 最小纠偏**：以 agent 传入的 `product/frameworks` 为主，prompt 仅用于高置信纠错与收窄，避免无证扩张。
+- 优化框架轴冲突处理：新增/强化 `react-native`、`miniprogram` 强锁策略，并在强锁场景下区分 host-env（`android/ios`）与真实 framework，减少误收窄。
+- 优化 native TRTC 纠偏：当 prompt 命中 native TRTC 类/方法且无 WebRTC 硬信号时，将 `rtcengine` 收窄为 `native_trtc_sdk`，降低 web/native 串场景风险。
+
+### 修复
+- 修复强框架词以“被动提及”出现时对 agent 结果过度覆盖的问题，降低文档枚举词触发误纠偏的概率。
+
+## Version 1.7.4 @2026.08.31
+
+### 新增
+- 新增 CallKit Flutter 最佳实践文档 4 篇：Android 后台通话保活、iOS 后台音频保活、iOS 启动崩溃排查、后台来电无通知排查。
+- 新增 CallKit Android 视频交友场景（VideoChat Demo）最佳实践文档，覆盖 Demo 跑通与组件快速集成。
+- 新增 CallKit HarmonyOS 平台支持：含 UI 集成指南与 API 参考文档。
+- 新增 CallKit 小程序 & uni-app 集成文档：含 UI 集成指南、API 参考、uni-app 打包指南。
+- 新增 CallKit uni-app（Android/iOS）独立集成文档与 API 参考。
+- 新增 Chat Vue3/React H5 移动端集成文档。
+
+### 变更
+- 优化 Chat 含 UI 检索标签：vue/react 的 framework 从单标签改为双标签（`['vue','web']` / `['react','web']`），使 `frameworks=['web']` 也能命中 Chat Web 端文档。
+
 ## Version 1.7.3 @2026.08.17
 
 ### 新增

package/README.md

@@ -59,39 +59,38 @@ npx -y @tencentcloud/sdk-mcp
 
 > 仅展示最近更新，完整历史请查看 `CHANGELOG.md`。
 
-## Version 1.7.3 @2026.08.17
-
-### 新增
-- 新增 RoomKit 多端集成、录制、白板、网络代理、AI 降噪与字幕翻译等知识库资源，扩充 Room 产品域知识覆盖。
-- 新增错误码、日志级别、屏幕分享自动停止及微信小程序报错排查等最佳实践文档。
-- 新增通用加性 rerank 模块，实现锚点选择与短语提取，并集成到搜索重排逻辑，提升召回排序准确率。
+## Version 1.7.5 @2026.09.04
 
 ### 变更
-- 优化 BM25 索引为无原型对象，提升索引结构的隔离性与稳定性。
+- 重构 `preflight-route` 决策模型为 **agent-first 最小纠偏**：以 agent 传入的 `product/frameworks` 为主，prompt 仅用于高置信纠错与收窄，避免无证扩张。
+- 优化框架轴冲突处理：新增/强化 `react-native`、`miniprogram` 强锁策略，并在强锁场景下区分 host-env（`android/ios`）与真实 framework，减少误收窄。
+- 优化 native TRTC 纠偏：当 prompt 命中 native TRTC 类/方法且无 WebRTC 硬信号时，将 `rtcengine` 收窄为 `native_trtc_sdk`，降低 web/native 串场景风险。
 
 ### 修复
-- 修复 BM25 打分受原型键污染导致的异常，增加原型键守卫，避免打分污染与 NaN 问题。
+- 修复强框架词以“被动提及”出现时对 agent 结果过度覆盖的问题，降低文档枚举词触发误纠偏的概率。
 
-## Version 1.7.1 @2026.08.11
+## Version 1.7.4 @2026.08.31
 
 ### 新增
-- 新增检索前置归一化：基于 prompt 真值对 `product` / `frameworks` 做归一化，解决 agent 推理错误导致的检索偏差。
+- 新增 CallKit Flutter 最佳实践文档 4 篇：Android 后台通话保活、iOS 后台音频保活、iOS 启动崩溃排查、后台来电无通知排查。
+- 新增 CallKit Android 视频交友场景（VideoChat Demo）最佳实践文档，覆盖 Demo 跑通与组件快速集成。
+- 新增 CallKit HarmonyOS 平台支持：含 UI 集成指南与 API 参考文档。
+- 新增 CallKit 小程序 & uni-app 集成文档：含 UI 集成指南、API 参考、uni-app 打包指南。
+- 新增 CallKit uni-app（Android/iOS）独立集成文档与 API 参考。
+- 新增 Chat Vue3/React H5 移动端集成文档。
 
 ### 变更
-- 优化 `search_trtc_knowledge` 输出契约：移除 "1-2 sentence per subsection" 等压缩性措辞，改为输出完整合成答案。
-
-### 修复
-- 修复 "安卓 Web TRTC" 等 prompt 下 agent 误传双 product / 双 frameworks 时未按 prompt 真值校正的问题。
+- 优化 Chat 含 UI 检索标签：vue/react 的 framework 从单标签改为双标签（`['vue','web']` / `['react','web']`），使 `frameworks=['web']` 也能命中 Chat Web 端文档。
 
-### Version 1.7.0 @2026.08.02
+## Version 1.7.3 @2026.08.17
 
-#### 新增
-- 补充并同步 Chat / Call / Live / Room 等产品域最佳实践文档，增强知识覆盖范围。
+### 新增
+- 新增 RoomKit 多端集成、录制、白板、网络代理、AI 降噪与字幕翻译等知识库资源，扩充 Room 产品域知识覆盖。
+- 新增错误码、日志级别、屏幕分享自动停止及微信小程序报错排查等最佳实践文档。
+- 新增通用加性 rerank 模块，实现锚点选择与短语提取，并集成到搜索重排逻辑，提升召回排序准确率。
 
-#### 变更
-- 持续重构双语检索链路，优化 query 归一化、意图路由、候选过滤与精确命中策略。
-- 优化最佳实践与 URL 类文档的召回与排序，提升问答结果可用性与稳定性。
-- 优化 `search_trtc_knowledge` 相关定义与答复约束，提升回答可读性与可执行性。
+### 变更
+- 优化 BM25 索引为无原型对象，提升索引结构的隔离性与稳定性。
 
-#### 修复
-- 修复复杂问法下部分检索结果偏题的问题，降低高分误召回概率。
+### 修复
+- 修复 BM25 打分受原型键污染导致的异常，增加原型键守卫，避免打分污染与 NaN 问题。

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": "@tencentcloud/sdk-mcp",
-  "version": "1.7.3",
+  "version": "1.7.5",
   "description": "Tencent Cloud MCP Server for SDK",
   "type": "module",
   "main": "index.js",