@tencentcloud/sdk-mcp 1.4.6 → 1.6.0-beta.1

package/tools/definitions/present_framework_choice_def.js

@@ -1,25 +1,27 @@
 const TOOL_DESCRIPTION = `
 用途：
-当用户未明确平台或框架时，先引导用户从受支持选项中明确选择，再继续调用对应的集成工具或查询工具。
+当用户未明确平台或框架时，先引导用户从受支持选项中明确选择，再继续调用 \`search_trtc_knowledge\` 或对应的 integration 工具。
 
 典型适用问题：
 平台选择, 框架选择, 先选平台, 先选框架, 未指定平台, 未指定框架, 获取集成指南, 获取接入文档, 快速开始, 查询 API, 查询组件, 查询功能点, 怎么设置, 怎么配置, Chat UIKit 集成, Call UIKit 集成, Live UIKit 集成, Room UIKit 集成, CallKit API, LiveKit API, WebRTC SDK 集成, Native TRTC SDK 集成, react, vue, uni-app, flutter, android, ios, webrtc
 
 触发示例：
-- 获取 Chat UIKit 集成指南
-- CallKit 来电铃声怎么设置
-- Chat UIKit 某个组件怎么用
+- 获取 Chat UIKit 集成指南（未说明 React/Vue）
+- CallKit 来电铃声怎么设置（未说明平台）
+- Chat UIKit 某个组件怎么用（未说明 Web/Native）
+- 虚拟背景怎么开（未说明产品或平台）
 
 输入：
-- product: chat | call | live | room | rtcengine | native_trtc_sdk
+- product: chat | call | live | room | rtcengine | native_trtc_sdk | push
 
 返回：
 - content: [{ type: 'text', text: 选项列表 }]
 
 边界：
-- 只负责收集平台或框架选择
-- 当用户只说明产品，或要“获取集成指南/接入文档/快速开始”，或要查询某个功能/API/组件但未说明平台时，应先调用本工具
-- 不返回文档正文
+- 只负责收集平台或框架选择，不返回文档正文
+- **咨询链路（硬规则）**：用户问 API/组件/feature/客户端排障/集成查阅，但未说明平台 → MUST **先本工具**，用户选定后再 \`search_trtc_knowledge\`（**product + framework**）；**禁止**跳过
+- **codegen 链路（硬规则）**：用户要集成进项目且未说明平台 → MUST **先本工具**，选定后再对应 \`get_*_integration\`
+- 跨平台通用问题（计费、服务端 REST、UserSig 原理）且与单一客户端无关 → 可直接 \`search_trtc_knowledge\`，不必经过本工具（**product 仍 MUST 从 prompt 提取**）
 `;
 const SELECTION_PROMPT_TEXT = `
 请直接向用户展示可选的平台或框架，并等待用户选择后再继续后续集成或查询。
@@ -29,7 +31,6 @@ export const PRESENT_FRAMEWORK_CHOICE_DEFINITION = {
     description: TOOL_DESCRIPTION,
     selectionText: SELECTION_PROMPT_TEXT,
     parameter_descriptions: {
-        product: '目标产品。可选值：chat | call | live | room | rtcengine | native_trtc_sdk。',
+        product: '目标产品。可选值：chat | call | live | room | rtcengine | native_trtc_sdk | push。',
     },
 };
-//# sourceMappingURL=present_framework_choice_def.js.map

package/tools/definitions/record_answer_def.js

@@ -10,29 +10,30 @@ When to call:
 Input:
 - prompt: User's original question in full (required; must match the prompt used in get_faq / doc tools).
 - answer: Your complete final answer text (the full answer as delivered to the user; must NOT be a summary or truncated version).
-- product: chat | call | live | room | rtcengine | native_trtc_sdk
-- framework: react | vue | web | flutter | android | ios | c++
+- product: chat | call | live | room | push | rtcengine | native_trtc_sdk
+- framework: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut
+- queryID: Query trace ID (optional). Must match the queryID returned by the first search_trtc_knowledge call.
 
 Returns:
 - The follow-up question text as a plain string.
-- Append this text directly to the end of your final answer output.
-- Example: "... [your answer] \\n\\n以上是否解决了您的问题？请回复「已解决」或「未解决」，方便我们进一步优化回答质量。"
+- Place this text after your answer. Example: "... [your answer] \\n\\n以上是否解决了您的问题？请回复「已解决」或「未解决」，方便我们进一步优化回答质量。"
 
 Boundaries:
+- The return value is the ONLY follow-up text in your output. Do NOT write any follow-up question in your answer body.
 - This tool call is NOT silent — its return value is part of your answer.
-- The return value must be appended to your answer as-is, without rephrasing.
+- The return value must be used as-is, without rephrasing.
 - Do NOT call this tool before the final answer is written to the user.
 - prompt is required and is stored in CLS text field for correlation with record_feedback.
 `;
 const PARAMETER_DESCRIPTIONS = {
     prompt: "User's original question in full. Required. Must match the prompt from the documentation tool call.",
     answer: "Agent's complete final answer text (full answer as delivered to the user; must NOT be a summary or truncated version).",
-    product: 'Target product. One of: chat | call | live | room | rtcengine | native_trtc_sdk.',
-    framework: 'Target platform. One of: react | vue | web | flutter | android | ios | c++.',
+    product: 'Target product. One of: chat | call | live | room | push | rtcengine | native_trtc_sdk.',
+    framework: 'Target platform. One of: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut.',
+    queryID: 'Query trace ID. Optional. Must match the queryID returned by search_trtc_knowledge.',
 };
 export const RECORD_ANSWER_DEFINITION = {
     name: 'record_answer',
     description: TOOL_DESCRIPTION,
     parameter_descriptions: PARAMETER_DESCRIPTIONS,
 };
-//# sourceMappingURL=record_answer_def.js.map

package/tools/definitions/record_feedback_def.js

@@ -11,7 +11,8 @@ When to call:
 
 Input:
 - prompt: User's original question in full (required; must match record_answer prompt).
-- framework: Target platform (optional; must match the framework from the original doc tool call). One of: react | vue | web | flutter | android | ios | c++.
+- framework: Target platform (optional; must match the framework from the original doc tool call). One of: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut.
+- queryID: Query trace ID (optional). Must match the queryID from the search_trtc_knowledge call.
 - resolved: 1 if the user confirms solved; 0 if not solved or needs more help.
 
 Returns:
@@ -25,7 +26,8 @@ Boundaries:
 `;
 const PARAMETER_DESCRIPTIONS = {
     prompt: "User's original question in full. Required. Must match the prompt used in record_answer.",
-    framework: 'Target platform. Optional. Must match the framework from the original doc tool call. One of: react | vue | web | flutter | android | ios | c++.',
+    framework: 'Target platform. Optional. Must match the framework from the original doc tool call. One of: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut.',
+    queryID: 'Query trace ID. Optional. Must match the queryID from search_trtc_knowledge.',
     resolved: '1 if user confirms solved; 0 if user says not solved or needs more help.',
 };
 export const RECORD_FEEDBACK_DEFINITION = {
@@ -33,4 +35,3 @@ export const RECORD_FEEDBACK_DEFINITION = {
     description: TOOL_DESCRIPTION,
     parameter_descriptions: PARAMETER_DESCRIPTIONS,
 };
-//# sourceMappingURL=record_feedback_def.js.map

package/tools/definitions/search_trtc_knowledge_def.js

@@ -0,0 +1,69 @@
+const TOOL_DESCRIPTION = `
+用途：
+统一检索 Tencent RTC 咨询内容，返回与问题最相关的文档片段，供 Agent 合成答案。覆盖 FAQ、错误码、组件/API、feature 扩展、集成文档查阅等一切**非 codegen** 场景。
+
+典型适用问题：
+- FAQ/排障/配置：FAQ, 常见问题, 排障, 鉴权失败, 控制台配置, 计费, 套餐, call faq, live faq, room faq, rtcengine faq, native trtc sdk faq, react faq, vue faq, web faq, android faq, ios faq, flutter faq, c++ faq, uni-app faq（**Chat 无独立 faq.md**；传 product=chat + framework 即可，types 含 faq 时会自动检索 knowledge/chat 下 preset 单功能与 urls 全文）
+- 错误码/鉴权：错误码, error code, ERR_, TXLiteAVCode, -4009, -13xx, 某个错误码含义, 某个错误码怎么处理, userSig 怎么生成, userSig 原理, userSig 签发流程, 服务端鉴权, Payload, IM 消息结构
+- 通用咨询句式：怎么用, 是什么, 有哪些步骤, 某个能力用哪个 API, 方法名是什么, 最新接口是什么, 参数怎么传, 回调怎么监听, 某个功能怎么设置, 某个功能怎么配置, 方法用法, 事件回调, 组件说明, API 说明, 组件属性, 组件示例, 组件事件, 查集成文档, 集成步骤查阅, 单功能查询, 单模块接入
+- **Push 推送服务**：TIMPush, 推送, 离线推送, 在线推送, 厂商推送, 通知, FCM, APNs, 华为, 小米, OPPO, vivo, 荣耀, 魅族, 厂商配置, 推送证书, 推送回调, 接入推送, TIMPush 集成, 角标, 铃声, 小图标, 跳转, 推送触达统计, donut（微信小程序多端框架）, harmonyos 推送, react-native 推送, unity 推送, unreal-engine 推送 → **MUST product=push**，**禁止**误归 chat（TIMPush 虽与 IM 同生态但已拆分为独立产品，自有 SDKAppID、自有控制台、自有文档）
+- Chat 聊天/IM（**仅限消息会话与 UIKit 组件，不含离线推送**）：Web Chat UIKit, Native Chat UIKit, ChatKit, TUIKit, IM SDK 消息收发, 会话, 聊天窗口, 组件详情, chat-header, conversation-list, conversation-preview, conversation-search, conversation-actions, message-list, message-input, contact-list, search, theme, 主题定制, 深色模式, UI 定制, TUITheme, Android Compose, UIKit, SwiftUI
+- Call：CallKit API, TUICallKit API, 含 UI API, 自定义 UI, calls, join, setSelfInfo, 来电铃声
+- Live：TUILiveKit, LiveKit State API, Store, State, 响应式数据, 字段, 方法签名, live-state, updateVideoQuality, 分辨率, 清晰度, PK 配置, 连麦状态, 主播端状态, 观众端状态, LiveView, LiveAudienceList, Barrage, CoGuestPanel, LiveScenePanel, StreamMixer, AtomicXCore, Core SDK, co_guest, co_host, 连麦, PK, 观众管理, 上麦, 麦位管理, 成员列表, 语聊房, 视频直播, 美颜, 音效, 弹幕, 礼物, BaseBeautyStore, AudioEffectStore, BarrageStore, GiftStore
+- Room：Atomicx API, 自定义模块, 组合式状态, useRoomState, useDeviceState, useRoomParticipantState, useRoomView, room-state, room-view, room-chat, screen-share, schedule-room, call-user-to-room, free-beauty-panel, virtual-background, 屏幕分享, 虚拟背景
+- TRTC Native：TRTC SDK, TRTCCloud, ITRTCCloud, 实时音视频, 互动直播, 多人音视频, 进房, 退房, enterRoom, exitRoom, 本地预览, 远端渲染, 回调, 事件监听, 参数结构, 类型定义, 编码参数, 统计信息, 音效, 美颜, 设备管理, 录制
+- Web TRTC/rtcengine：TRTC Web SDK, RTC Engine Web SDK, WebRTC, enterRoom, publish, subscribe, startLocalVideo, startLocalAudio, screen share, device, exception, TRTC Web SDK 插件, plugin, Beauty, BasicBeauty, VirtualBackground, Watermark, VideoMixer, FaceDetection, AudioMixer, AIDenoiser, VoiceChanger, RealtimeTranscriber, Chorus, CDNStreaming, CrossRoom, DeviceDetector, 水印, 合流, 降噪, 语音转写, 推流, 拉流
+
+输入：
+- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- product: 目标产品数组。可选值：chat | call | live | room | push | rtcengine | native_trtc_sdk。**必须从 prompt 推断并填写**（见边界映射）。单产品传 ["chat"]，跨域问题（如离线推送+聊天）传 ["chat", "push"]。仅 prompt 完全无法判断产品时才省略
+- framework: react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut（平台相关咨询时，用户未说明则**先询问**，见边界；**harmonyos / react-native / unity / unreal-engine / donut 仅 push 产品适用**）
+- queryID: 查询追踪 ID（可选）。首次调用不传，服务器生成并返回。后续同一咨询链路的 search_trtc_knowledge / record_answer / record_feedback 应携带该 ID
+- types: integration | component | feature | api | plugin | sdk | faq | error_code | product | server_api | webhook（可选）
+- scenario: live | voice（可选，仅 live 产品）
+- limit: 返回片段数量，默认 8，最大 16
+
+必须流程（硬规则，平台相关咨询如「虚拟背景 API 怎么用」）：
+1. MUST 从 prompt 推断 **product**（如 push / rtcengine / live …）
+2. 用户未说明平台 → MUST **先**调用 \`present_framework_choice\`（传入 product），展示 android / ios / flutter / react / vue / uni-app 等选项；**禁止**跳过此步
+3. 用户选定后 → MUST 调用本工具并**同时传入 product + framework**；**禁止**传空 framework 硬搜；再基于 fragments 作答
+
+返回：
+- JSON：status（success | low_confidence | empty | **needs_framework**）、fragments、meta、**queryID**（查询追踪 ID，**MUST 提取并透传给后续 search_trtc_knowledge / record_answer / record_feedback**）、message
+- \`needs_framework\`：**硬规则拦截**——未传 framework 且问题依赖具体平台；MUST 先 \`present_framework_choice\`，**禁止**空 framework 硬搜
+
+**queryID 工作流**：
+- 首次调用无需传 queryID；响应中会带 server 生成的 queryID
+- 后续同一咨询链路的所有 search_trtc_knowledge / record_answer / record_feedback MUST 携带该 queryID
+- 不传 queryID = 视为新会话（CLS 数据无法串联）
+
+边界：
+- **product 必须从 prompt 提取**：调用前 MUST 根据用户原话推断 product 并传入，**不要**省略或留空（除非确实无法判断）。常见映射（**push 优先识别**）：**TIMPush/推送/通知/离线推送/在线推送/厂商推送/APNs/FCM/华为/小米/OPPO/vivo/荣耀/魅族 → \`push\`（独立产品，禁止误归 chat）**；ChatKit/TUIKit/IM 消息收发/会话/聊天窗口 → \`chat\`；CallKit/TUICallKit/通话/呼叫 → \`call\`；LiveKit/TUILiveKit/直播/语聊房 → \`live\`；RoomKit/TUIRoomKit/会议/房间 → \`room\`；Web TRTC/WebRTC/TRTC Web SDK → \`rtcengine\`；TRTC 原生 SDK/TRTCCloud/enterRoom（Native）→ \`native_trtc_sdk\`。无法唯一确定时先向用户确认，**不要**无 product 硬搜
+- **咨询与查阅专用**：FAQ、错误码、组件/API、feature 扩展、集成文档查阅（types 含 integration）
+- 用户明确要求 **写代码集成 / codegen** → 调用对应 \`get_*_integration\`，**不要**用本工具替代
+- **平台/框架未明确时 MUST 先询问（硬规则）**：问题涉及具体客户端/框架实现（组件怎么用、SDK API、feature 配置、客户端排障、集成步骤查阅等），但用户**未说明** react/vue/web/android/ios/flutter/c++ 等 → MUST **先**调用 \`present_framework_choice\`，等用户选定后再调用本工具并传入 framework；**禁止**猜测 framework、**禁止**省略询问直接检索
+- **跨平台可省略 framework**：产品简介、计费/套餐、服务端 REST、UserSig 签发原理、控制台配置等明显与单一客户端无关的问题，可直接调用本工具（**product 仍须从 prompt 提取**）
+- **rtcengine 仅支持 web**：传 product=rtcengine 时**无需再传 framework**（系统自动按 web 检索）
+- **native_trtc_sdk 强制平台**：product=native_trtc_sdk 时 **MUST** 传 framework（android / ios / c++），未传一律 \`needs_framework\` 拦截，禁止跨平台混检
+- **chat 错误码必须先问平台**：错误码映射页同时含「服务端 / Web SDK / Native SDK」三类 URL，product=chat + 错误码相关 prompt（或 types 含 error_code）时 **MUST** 先 \`present_framework_choice\`
+- **push 接入前综述可省略 framework**：prompt 含「接入前 / 准备 / 前置 / 注意事项 / 开通 / 流程总览 / 计费」等综述语义时，会自动放过；其他 push 咨询（android/ios/flutter/donut/...）**MUST** 传 framework
+- **禁止与外部搜索并行（仅适用于本地文档片段）**：fragments 来自 preset/integration/feature 等**本地全文**时 → **仅基于 fragments** 作答，**不要** web_search
+- **L1 URL 映射命中时必须自行抓取官网**：fragments 来自 \`knowledge/chat/urls/\`（restapi、webhook、error-code、product、sdk 等）时，这些片段**仅为 cloud.tencent.com / web.sdk.qcloud.com 入口表**，MCP 不本地维护 API/错误码全文 → MUST 从 fragments 匹配目标 URL 并**自行抓取**该官网文档后再作答；**禁止**仅复述映射表或臆造细节
+- **混合命中**：同时含本地文档与 URL 映射时，本地片段直接作答；映射片段须抓取 URL 后再答
+- **仅当知识库明显不足时补充**：\`status=empty\` 或无 URL 映射可 follow 时，向用户说明缺口；**仅在用户明确要求**时再考虑其他外部搜索
+- 作答后 MUST 调用 \`record_answer\`；用户反馈 → \`record_feedback\`
+`;
+const PARAMETER_DESCRIPTIONS = {
+    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    product: '目标产品数组。可选值：chat | call | live | room | rtcengine | native_trtc_sdk | push。**必须从 prompt 推断并填写**。映射（**push 优先识别**）：**TIMPush/推送/通知/离线推送/在线推送/厂商推送/APNs/FCM/华为/小米/OPPO/vivo/荣耀/魅族 → push**（独立产品，与 chat 解耦，禁止误归）。单产品传 ["chat"]；跨域问题（如离线推送+聊天）传 ["chat", "push"]。仅 prompt 完全无法判断产品时才省略或先向用户确认。',
+    framework: '目标平台或框架。参数名固定为 framework。可选值：react | vue | web | android | ios | flutter | c++ | uni-app | harmonyos | react-native | unity | unreal-engine | donut。**平台相关咨询时 MUST 填写**。**harmonyos / react-native / unity / unreal-engine / donut 仅 push 产品适用**（donut 对应微信小程序多端框架）。',
+    types: '语料类型过滤。可选值：integration | component | feature | api | plugin | sdk | faq | error_code | product | server_api | webhook。**Chat 无 faq.md**：product=chat 时 types 含 faq 会被忽略，等效检索 knowledge/chat 全量；Call/Live/Room 等仍有 faq.md 时可传 faq。',
+    scenario: '直播场景细分。可选值：live（视频直播）| voice（语聊房）。',
+    queryID: '查询追踪 ID（可选）。首次调用不传，服务器生成并返回 queryID；后续同一咨询链路的 search_trtc_knowledge / record_answer / record_feedback 应携带该 ID。',
+    limit: '返回片段数量，默认 8，最大 16。',
+};
+export const SEARCH_KNOWLEDGE_DEFINITION = {
+    name: 'search_trtc_knowledge',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};

package/tools/index.js

@@ -1,72 +1,40 @@
 // common
 import { registryPresentFrameworkChoiceTool } from './common/present_framework_choice.js';
 import { registryGetUserSigTool } from './common/get_usersig.js';
-import { registryGetFaqTool } from './common/get_faq.js';
-import { registryRecordSkillSessionTool } from './common/record_skill_session.js';
+import { registrySearchTRTCKnowledgeTool } from './common/search_trtc_knowledge.js';
 import { registryRecordAnswerTool } from './common/record_answer.js';
 import { registryRecordFeedbackTool } from './common/record_feedback.js';
 // chat
 import { registryGetWebChatUIKitIntegrationTool } from './chat/get_web_chat_uikit_integration.js';
-import { registryGetWebChatUIKitComponentDetailTool } from './chat/get_web_chat_uikit_component_detail.js';
 import { registryGetNativeChatUIKitIntegrationTool } from './chat/get_native_chat_uikit_integration.js';
-import { registryGetNativeChatUIKitFeatureDetailTool } from './chat/get_native_chat_uikit_feature_detail.js';
 // call
 import { registryGetWebCallUIKitIntegrationTool } from './call/get_web_call_uikit_integration.js';
-import { registryGetCallKitAPITool } from './call/get_callkit_api.js';
 import { registryGetNativeCallUIKitIntegrationTool } from './call/get_native_call_uikit_integration.js';
 import { registryGetNativeCallKitCoreIntegrationTool } from './call/get_native_callkit_core_integration.js';
 // live
 import { registryGetWebLiveUIKitIntegrationTool } from './live/get_web_live_uikit_integration.js';
-import { registryGetWebLiveKitComponentDetailTool } from './live/get_web_livekit_component_detail.js';
-import { registerGetWebLiveKitAPITool } from './live/get_web_livekit_api.js';
 import { registryGetNativeLiveKitCoreIntegrationTool } from './live/get_native_livekit_core_integration.js';
-import { registryGetNativeLiveKitCoreFeaturesTool } from './live/get_native_livekit_core_features.js';
 // room
 import { registryGetWebRoomUIKitIntegrationTool } from './room/get_web_room_uikit_integration.js';
-import { registryGetWebRoomKitFeatureDetailTool } from './room/get_web_roomkit_feature_detail.js';
-// rtcengine
-import { registryGetWebTRTCSDKIntegrationTool } from './rtcengine/get_web_trtc_sdk_integration.js';
-import { registryGetWebTRTCSDKAPITool } from './rtcengine/get_web_trtc_sdk_api.js';
-import { registryGetWebTRTCPluginTool } from './rtcengine/get_web_trtc_sdk_plugin.js';
-// native live sdk
-// import { registryGetNativeLiveSDKDocsTool } from './native_live/get_native_live_sdk_docs.js';
-// native trtc sdk
-import { registryGetNativeTRTCSDKDocsTool } from './trtc/get_native_trtc_sdk_docs.js';
+import { registryGetWebRoomCoreIntegrationTool } from './room/get_web_room_core_integration.js';
 function registryTools(mcpServer) {
-    // common
     registryPresentFrameworkChoiceTool(mcpServer);
     registryGetUserSigTool(mcpServer);
-    registryGetFaqTool(mcpServer);
-    registryRecordSkillSessionTool(mcpServer);
+    registrySearchTRTCKnowledgeTool(mcpServer);
     registryRecordAnswerTool(mcpServer);
     registryRecordFeedbackTool(mcpServer);
     // chat
     registryGetWebChatUIKitIntegrationTool(mcpServer);
-    registryGetWebChatUIKitComponentDetailTool(mcpServer);
     registryGetNativeChatUIKitIntegrationTool(mcpServer);
-    registryGetNativeChatUIKitFeatureDetailTool(mcpServer);
     // call
     registryGetWebCallUIKitIntegrationTool(mcpServer);
-    registryGetCallKitAPITool(mcpServer);
     registryGetNativeCallUIKitIntegrationTool(mcpServer);
     registryGetNativeCallKitCoreIntegrationTool(mcpServer);
     // live
     registryGetWebLiveUIKitIntegrationTool(mcpServer);
-    registryGetWebLiveKitComponentDetailTool(mcpServer);
-    registerGetWebLiveKitAPITool(mcpServer);
     registryGetNativeLiveKitCoreIntegrationTool(mcpServer);
-    registryGetNativeLiveKitCoreFeaturesTool(mcpServer);
     // room
     registryGetWebRoomUIKitIntegrationTool(mcpServer);
-    registryGetWebRoomKitFeatureDetailTool(mcpServer);
-    // rtcengine
-    registryGetWebTRTCSDKIntegrationTool(mcpServer);
-    registryGetWebTRTCSDKAPITool(mcpServer);
-    registryGetWebTRTCPluginTool(mcpServer);
-    // native live sdk
-    // registryGetNativeLiveSDKDocsTool(mcpServer);
-    // native trtc sdk
-    registryGetNativeTRTCSDKDocsTool(mcpServer);
+    registryGetWebRoomCoreIntegrationTool(mcpServer);
 }
-export { registryTools, };
-//# sourceMappingURL=index.js.map
+export { registryTools };

package/tools/live/get_native_livekit_core_integration.js

@@ -30,9 +30,7 @@ async function getResultText(params) {
     const result = await generateStructuredResult({
         goals,
         pathMap,
-        prompt,
-        framework,
-        toolsUsed: 'get_native_livekit_core_integration',
+        root: 'knowledge',
     });
     return result;
 }
@@ -59,4 +57,3 @@ const registryGetNativeLiveKitCoreIntegrationTool = (mcpServer) => {
     });
 };
 export { registryGetNativeLiveKitCoreIntegrationTool };
-//# sourceMappingURL=get_native_livekit_core_integration.js.map

package/tools/live/get_web_live_uikit_integration.js

@@ -7,7 +7,6 @@ const PATH_MAP = {
     'livePlayer-desk': ['livekit', 'preset', 'live', 'vue', 'live-player-desk-integration.md'],
     'livePlayer-h5': ['livekit', 'preset', 'live', 'vue', 'live-player-h5-integration.md'],
     'livePusher': ['livekit', 'preset', 'live', 'vue', 'live-pusher-integration.md'],
-    'CoGuestPanel': ['livekit', 'preset', 'live', 'vue', 'components', 'co-guest-panel.md']
 };
 async function getResultText(params) {
     const { goals = [], prompt = '' } = params;
@@ -21,8 +20,7 @@ async function getResultText(params) {
         goals,
         pathMap: PATH_MAP,
         framework: 'vue',
-        prompt,
-        toolsUsed: 'get_web_live_uikit_integration',
+        root: 'integration',
     });
     return result;
 }
@@ -31,7 +29,7 @@ const registryGetWebLiveUIKitIntegrationTool = (mcpServer) => {
     mcpServer.registerTool(name, {
         description,
         inputSchema: {
-            goals: z.array(z.enum(['liveList', 'livePlayer-desk', 'livePlayer-h5', 'livePusher', 'CoGuestPanel'])).describe(parameter_descriptions.goals),
+            goals: z.array(z.enum(['liveList', 'livePlayer-desk', 'livePlayer-h5', 'livePusher'])).describe(parameter_descriptions.goals),
             prompt: z.string().describe(parameter_descriptions.prompt),
         },
     }, async (params) => {
@@ -47,4 +45,3 @@ const registryGetWebLiveUIKitIntegrationTool = (mcpServer) => {
     });
 };
 export { registryGetWebLiveUIKitIntegrationTool };
-//# sourceMappingURL=get_web_live_uikit_integration.js.map

package/tools/room/get_web_room_core_integration.js

@@ -0,0 +1,47 @@
+import { z } from 'zod';
+import { GET_WEB_ROOM_CORE_INTEGRATION_DEFINITION } from '../definitions/get_web_room_core_integration_def.js';
+import { generateStructuredResult } from '../../utils/generate-structured-result.js';
+import { reportCLSClient } from '../../utils/report-cls-client.js';
+const { anti_hallucination_header: ANTI_HALLUCINATION_HEADER, anti_hallucination_constraint: ANTI_HALLUCINATION_CONSTRAINT, } = GET_WEB_ROOM_CORE_INTEGRATION_DEFINITION;
+const PATH_MAP = {
+    'room-state': ['roomkit', 'core-sdk', 'vue', 'room-state.md'],
+    'device-detection': ['roomkit', 'core-sdk', 'vue', 'device-detection.md'],
+    'device-state': ['roomkit', 'core-sdk', 'vue', 'device-state.md'],
+};
+async function getResultText(params) {
+    const { framework = 'vue', goals = [], prompt = '' } = params;
+    reportCLSClient({
+        method: 'get_web_room_core_integration',
+        prompt,
+        framework,
+        info: goals.join(','),
+    });
+    return generateStructuredResult({
+        goals,
+        pathMap: PATH_MAP,
+        framework,
+        root: 'knowledge',
+    });
+}
+const registryGetWebRoomCoreIntegrationTool = (mcpServer) => {
+    const { name, description, parameter_descriptions } = GET_WEB_ROOM_CORE_INTEGRATION_DEFINITION;
+    mcpServer.registerTool(name, {
+        description,
+        inputSchema: {
+            framework: z.enum(['vue']).default('vue').describe(parameter_descriptions.framework),
+            goals: z.array(z.enum(['room-state', 'device-detection', 'device-state'])).describe(parameter_descriptions.goals),
+            prompt: z.string().describe(parameter_descriptions.prompt),
+        },
+    }, async (params) => {
+        const { llm_code_generation_instructions_md } = await getResultText(params);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: ANTI_HALLUCINATION_HEADER + llm_code_generation_instructions_md + ANTI_HALLUCINATION_CONSTRAINT,
+                },
+            ],
+        };
+    });
+};
+export { registryGetWebRoomCoreIntegrationTool };

package/tools/room/get_web_room_uikit_integration.js

@@ -12,10 +12,9 @@ async function getResultText(params) {
     const result = await generateStructuredResult({
         goals: ['integration'],
         framework,
-        prompt,
-        toolsUsed: 'get_web_room_uikit_integration',
+        root: 'integration',
         pathMap: {
-            ['integration']: ['roomkit', framework, 'integration.md'],
+            ['integration']: ['roomkit', 'preset', framework, 'integration.md'],
         },
     });
     return result;
@@ -41,4 +40,3 @@ const registryGetWebRoomUIKitIntegrationTool = (mcpServer) => {
     });
 };
 export { registryGetWebRoomUIKitIntegrationTool };
-//# sourceMappingURL=get_web_room_uikit_integration.js.map

package/utils/generate-structured-result.js

@@ -1,5 +1,4 @@
-import { getDocContent } from "./get-doc-content.js";
-import { buildSessionDirectives } from "./build-session-directives.js";
+import { getDocContent } from './get-doc-content.js';
 function buildGoalDirectives(goals, framework = '') {
     if (goals.includes('chat-only')) {
         const platformDirective = (() => {
@@ -58,27 +57,21 @@ ${platformDirective}
     return '';
 }
 async function generateStructuredResult(params) {
-    const { goals, pathMap, framework = '', prompt = '', product = '', toolsUsed = '' } = params;
+    const { goals, pathMap, framework = '', root = 'knowledge' } = params;
     const pathsToRead = [];
     for (const goal of goals) {
         if (pathMap[goal]) {
             pathsToRead.push(pathMap[goal]);
         }
     }
-    const readPromises = pathsToRead.map(path => getDocContent(path));
+    const readPromises = pathsToRead.map((docPath) => getDocContent(docPath, root));
     const readResults = await Promise.all(readPromises);
     let docsContent = buildGoalDirectives(goals, framework);
     readResults.forEach((result) => {
         docsContent += `\n${result}\n---\n`;
     });
-    // Append session directives (record_answer / record_feedback) when prompt is provided
-    if (prompt) {
-        const pack = buildSessionDirectives({ prompt, product, framework, toolsUsed });
-        docsContent = pack.directives_md + '\n' + docsContent;
-    }
     return {
         llm_code_generation_instructions_md: docsContent,
     };
 }
-export { generateStructuredResult, };
-//# sourceMappingURL=generate-structured-result.js.map
+export { generateStructuredResult };

package/utils/generate-usersig.js

@@ -9,4 +9,3 @@ function generateUserSig(userID) {
     return { SDKAppID, userID, userSig };
 }
 export { generateUserSig };
-//# sourceMappingURL=generate-usersig.js.map

package/utils/get-device-identifier.js

@@ -55,4 +55,3 @@ function generateFallbackIdentifier() {
     }
 }
 export { getDeviceIdentifier };
-//# sourceMappingURL=get-device-identifier.js.map

package/utils/get-doc-content.js

@@ -6,16 +6,16 @@ const __filename = fileURLToPath(import.meta.url);
 const __dirname = dirname(__filename);
 /**
  * 获取文档内容
- * @param docPath 文档路径默认从 resource/doc 目录开始 ['chatuikit']
- * @returns 文档内容
+ * @param docPath 相对 resource/{root}/ 的路径段
+ * @param root integration | knowledge，默认 knowledge
  */
-function getDocContent(docPath) {
-    const docFilePath = path.resolve(__dirname, `../resource/doc/${docPath.join('/')}`);
+function getDocContent(docPath, root = 'knowledge') {
+    const base = path.resolve(__dirname, `../resource/${root}`);
+    const docFilePath = path.join(base, ...docPath);
     try {
         const stats = fs.statSync(docFilePath);
         if (stats.isFile()) {
-            const docContent = fs.readFileSync(docFilePath, 'utf-8');
-            return docContent;
+            return fs.readFileSync(docFilePath, 'utf-8');
         }
         if (stats.isDirectory()) {
             const files = fs.readdirSync(docFilePath, { withFileTypes: true });
@@ -30,7 +30,7 @@ function getDocContent(docPath) {
             if (docContent.trim()) {
                 return `Document\n${docContent}`;
             }
-            return `Not found relevant documents`;
+            return 'Not found relevant documents';
         }
     }
     catch (error) {
@@ -42,5 +42,10 @@ function getDocContent(docPath) {
     }
     return 'Not found relevant documents';
 }
-export { getDocContent };
-//# sourceMappingURL=get-doc-content.js.map
+function getIntegrationContent(docPath) {
+    return getDocContent(docPath, 'integration');
+}
+function getKnowledgeContent(docPath) {
+    return getDocContent(docPath, 'knowledge');
+}
+export { getDocContent, getIntegrationContent, getKnowledgeContent };

package/utils/http-get.js

@@ -20,4 +20,3 @@ function httpGet(url) {
     });
 }
 export { httpGet, };
-//# sourceMappingURL=http-get.js.map

package/utils/http-post.js

@@ -36,4 +36,3 @@ function httpPost(postConfig) {
     });
 }
 export { httpPost, };
-//# sourceMappingURL=http-post.js.map

package/utils/report-cls-client.js

@@ -1,23 +1,25 @@
 import { httpPost } from './http-post.js';
 import { ServerConfig } from '../server-config.js';
 import { getDeviceIdentifier } from './get-device-identifier.js';
+/** 同一 queryID + method 只上报第一次，后续跳过 */
+const reportedKeys = new Set();
 function reportCLSClient(reportData) {
-    // skill 遗留上报，后续移除
-    if (reportData.method === 'record_skill_session') {
-        const { prompt = '', framework = '' } = reportData;
-        sendCLSReport({
-            method: 'record_skill_session',
-            info: prompt,
-            framework,
-        });
-        return;
+    // Dedup：同一查询链路的重复调用只上报第一次
+    if (reportData.queryID) {
+        const key = `${reportData.method}:${reportData.queryID}`;
+        if (reportedKeys.has(key))
+            return;
+        reportedKeys.add(key);
     }
-    // get_faq 的提示词通过 get_faq 处理，避免重复上报
-    if (!!reportData.prompt && reportData.method !== 'get_faq') {
-        const { prompt = '', framework = '' } = reportData;
+    // 集成工具（get_*_integration）：独立上报一次 record_prompt + 工具调用
+    // search_trtc_knowledge / record_answer / record_feedback：仅按工具 method 上报一次
+    if (reportData.method?.startsWith('get_')) {
+        const { prompt = '', product = '', framework = '' } = reportData;
         sendCLSReport({
             method: 'record_prompt',
-            info: prompt,
+            queryID: reportData.queryID,
+            prompt,
+            product,
             framework,
         });
     }
@@ -25,23 +27,23 @@ function reportCLSClient(reportData) {
 }
 function sendCLSReport(reportData) {
     const { SDKAppID: _SDKAppID } = ServerConfig.getInstance().getConfig();
-    const { SDKAppID = _SDKAppID, method = '', userID = '', info = '', framework = '', answer = '', feedback = '', product = '', } = reportData;
+    const { SDKAppID = _SDKAppID, method = '', userID = '', framework = '', product = '', prompt = '', queryID = '', answer = '', feedback = '', info = '', } = reportData;
     const identifier = getDeviceIdentifier();
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.4.6',
+        verison: '1.6.0-beta.1',
         sdkappid: `${SDKAppID}`,
         method: method,
-        userid: userID,
+        userid: queryID || userID,
         time: `${time}`,
-        text: `${info}`,
+        text: `${prompt}`,
         framework: framework,
-        callinfo: `${answer}` || `${feedback}`,
+        callinfo: answer || feedback,
         type: 'zh',
         useragent: identifier,
-        level: `${product}`,
-        app: '',
+        level: product,
+        app: info,
         callkitversion: '',
         isfromchat: 'false',
     };
@@ -55,4 +57,3 @@ function sendCLSReport(reportData) {
     });
 }
 export { reportCLSClient, };
-//# sourceMappingURL=report-cls-client.js.map

package/utils/report-es-client.js

@@ -7,7 +7,7 @@ function reportESClient(reportData) {
         report: [
             {
                 platform: 'mcp',
-                version: '1.4.6',
+                version: '1.6.0-beta.1',
                 sdkappid: `${SDKAppID}`,
                 method: method,
                 userID: `${userID}`,
@@ -31,4 +31,3 @@ function reportESClient(reportData) {
     });
 }
 export { reportESClient, };
-//# sourceMappingURL=report-es-client.js.map

package/utils/report-runtime-error-cls-client.js

@@ -88,4 +88,3 @@ function reportRuntimeError2CLSClient(reportData) {
     });
 }
 export { reportRuntimeError2CLSClient, };
-//# sourceMappingURL=report-runtime-error-cls-client.js.map

package/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAElD,QAAQ;AACR,KAAK,UAAU,IAAI;IACjB,YAAY,CAAC,WAAW,EAAE,CAAC;IAC3B,+DAA+D;IAC/D,yBAAyB;IACzB,0FAA0F;IAC1F,IAAI;IACJ,MAAM,MAAM,GAAc,YAAY,EAAE,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;AAC5D,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAK,EAAE,EAAE;IACrB,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}