@tencentcloud/sdk-mcp 1.3.4 → 1.3.5

package/resource/doc/rtcengine/web/plugin/42-advanced-realtime-transcriber.md

@@ -0,0 +1,314 @@
+## 功能描述
+
+本文主要介绍如何使用实时传译插件来启动实时语音转文字（ASR）和翻译能力。该插件可以将房间内用户的语音实时转换为文字，并支持翻译成多种语言。
+
+## 前提条件
+
+- TRTC Web SDK 版本 >= 5.15.0
+
+## 实现流程
+
+### 引入并注册插件
+
+```javascript
+import TRTC from 'trtc-sdk-v5';
+import RealtimeTranscriber from 'trtc-sdk-v5/plugins/realtime-transcriber';
+
+const trtc = TRTC.create({ plugins: [RealtimeTranscriber] });
+```
+
+### 启动插件
+
+启动插件后会返回一个 `transcriberRobotId`，用于后续停止该转录任务。
+
+```javascript
+const transcriberRobotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh',
+  translationLanguages: ['en', 'ja'],
+  userIdsToTranscribe: 'all',
+});
+```
+
+### 监听转录消息
+
+通过监听 `REALTIME_TRANSCRIBER_MESSAGE` 事件来获取转录结果。
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  console.log(`${event.speakerUserId}: ${event.sourceText}`);
+  if (event.translationTexts) {
+    Object.entries(event.translationTexts).forEach(([lang, text]) => {
+      console.log(`  ${lang}: ${text}`);
+    });
+  }
+});
+```
+
+### 监听状态变化
+
+通过监听 `REALTIME_TRANSCRIBER_STATE_CHANGED` 事件来获取转录任务的状态变化。
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
+  console.log(`转录任务状态: ${event.state}, robotId: ${event.transcriberRobotId}`);
+});
+```
+
+### 停止插件
+
+```javascript
+await trtc.stopPlugin('RealtimeTranscriber', { transcriberRobotId });
+```
+
+## 使用示例
+
+### ASR 场景：转录房间内的音频为文字
+
+```javascript
+// 启动转录任务
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh'
+});
+
+// 监听转录消息
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
+  console.log(data.speakerUserId + ' says: ' + data.sourceText);
+});
+```
+
+### 翻译场景：将指定用户的语音翻译成多种语言
+
+```javascript
+// 启动转录任务，转录 userA 的语音并翻译成法语和英语
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh',
+  translationLanguages: ['fr', 'en'],
+  userIdsToTranscribe: 'userA'
+});
+
+// 监听转录消息
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (data) => {
+  console.log(`👤 ${data.speakerUserId}:`);
+  console.log(`  原文: ${data.sourceText}`);
+  
+  if (data.translationTexts) {
+    Object.entries(data.translationTexts).forEach(([lang, text]) => {
+      console.log(`  ${lang.toUpperCase()}: ${text}`);
+    });
+  }
+});
+```
+
+### 转录多个指定用户
+
+```javascript
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'en',
+  translationLanguages: ['zh', 'ja'],
+  userIdsToTranscribe: ['userA', 'userB', 'userC']
+});
+```
+
+## API 说明
+
+### trtc.startPlugin('RealtimeTranscriber', options)
+
+用于启动实时转录任务。
+
+**options: RealtimeTranscriberStartOptions**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| sourceLanguage | `string` | 必填 | 源语言代码，目前仅支持 `'zh'`、`'en'` |
+| translationLanguages | `string` \| `string[]` | 选填 | 翻译目标语言，支持单个语言或语言数组，如 `'en'` 或 `['en', 'ja']` |
+| userIdsToTranscribe | `string` \| `string[]` | 选填 | 要转录的用户 ID，默认为 `'all'` 转录所有用户，也可指定单个或多个用户 ID |
+| transcriberRobotId | `string` | 选填 | 自定义转录机器人 ID，不传则自动生成 |
+
+**Returns: Promise\<string\>**
+
+返回转录任务的 `transcriberRobotId`，用于后续停止任务。
+
+**Example:**
+
+```javascript
+const robotId = await trtc.startPlugin('RealtimeTranscriber', {
+  sourceLanguage: 'zh',
+  translationLanguages: ['en', 'ja'],
+  userIdsToTranscribe: 'all',
+});
+```
+
+### trtc.stopPlugin('RealtimeTranscriber', options)
+
+用于停止实时转录任务。
+
+**options**
+
+| Name | Type | Required | Description |
+|------|------|----------|-------------|
+| transcriberRobotId | `string` | 必填 | 启动时返回的转录机器人 ID |
+
+**Example:**
+
+```javascript
+await trtc.stopPlugin('RealtimeTranscriber', { transcriberRobotId: robotId });
+```
+
+## 事件说明
+
+### TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED
+
+转录任务状态变化事件。
+
+**RealtimeTranscriberStateEvent**
+
+| Name | Type | Description |
+|------|------|-------------|
+| state | `'started'` \| `'stopped'` | 转录任务状态 |
+| roomId | `string` \| `number` | 房间 ID |
+| transcriberRobotId | `string` | 转录机器人 ID |
+| sourceLanguage | `string` | 源语言（可选） |
+| error | `number` | 错误码（可选） |
+| errorMessage | `string` | 错误信息（可选） |
+
+**Example:**
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_STATE_CHANGED, (event) => {
+  if (event.state === 'started') {
+    console.log('转录任务已启动');
+  } else if (event.state === 'stopped') {
+    console.log('转录任务已停止');
+  }
+});
+```
+
+### TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE
+
+转录消息事件，当有新的转录结果时触发。
+
+**RealtimeTranscriberMessageEvent**
+
+| Name | Type | Description |
+|------|------|-------------|
+| segmentId | `string` | 语音片段 ID，用于标识一段连续的语音 |
+| speakerUserId | `string` | 说话人的用户 ID |
+| sourceText | `string` | 转录的原文文本 |
+| translationTexts | `Array<{ language: string, text: string }>` | 翻译文本数组，如 `[{ language: 'en', text: 'hello' }, { language: 'ja', text: 'こんにちは' }]` |
+| timestamp | `number` | 时间戳 |
+| isCompleted | `boolean` | 该语音片段是否已完成。`false` 表示中间结果（实时更新），`true` 表示最终结果 |
+| robotId | `string` | 转录机器人 ID |
+
+**Example:**
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  const { speakerUserId, sourceText, translationTexts, isCompleted } = event;
+  
+  // 显示实时转录结果
+  console.log(`[${isCompleted ? '完成' : '进行中'}] ${speakerUserId}: ${sourceText}`);
+  
+  // 显示翻译结果
+  if (translationTexts) {
+    translationTexts.forEach(({ language, text }) => {
+      console.log(`  ${language}: ${text}`);
+    });
+  }
+});
+
+// 取消监听
+trtc.off(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, handler);
+```
+
+## 支持的语言
+
+### ASR 源语言
+
+| 语言 | 代码 |
+|------|------|
+| 中文 | `zh` |
+| 英语 | `en` |
+
+<!--
+| 中文繁体 | `zh-tw` |
+| 中国方言 | `zh-dialect` |
+| 中国粤语 | `zh-yue` |
+| 越南语 | `vi` |
+| 日语 | `ja` |
+| 韩语 | `ko` |
+| 印度尼西亚语 | `id` |
+| 泰语 | `th` |
+| 葡萄牙语 | `pt` |
+| 土耳其语 | `tr` |
+| 阿拉伯语 | `ar` |
+| 西班牙语 | `es` |
+| 印地语 | `hi` |
+| 法语 | `fr` |
+| 马来语 | `ms` |
+| 菲律宾语 | `fil` |
+| 德语 | `de` |
+| 意大利语 | `it` |
+| 俄语 | `ru` |
+| 瑞典语 | `sv` |
+| 丹麦语 | `da` |
+| 挪威语 | `no` |
+-->
+
+### 翻译目标语言
+
+| 语言 | 代码 |
+|------|------|
+| 中文 | `zh` |
+| 英语 | `en` |
+| 越南语 | `vi` |
+| 日语 | `ja` |
+| 韩语 | `ko` |
+| 印度尼西亚语 | `id` |
+| 泰语 | `th` |
+| 葡萄牙语 | `pt` |
+| 阿拉伯语 | `ar` |
+| 西班牙语 | `es` |
+| 法语 | `fr` |
+| 马来语 | `ms` |
+| 德语 | `de` |
+| 意大利语 | `it` |
+| 俄语 | `ru` |
+
+## 常见问题
+
+**1. 如何区分中间结果和最终结果？**
+
+通过 `REALTIME_TRANSCRIBER_MESSAGE` 事件中的 `isCompleted` 字段判断。当 `isCompleted` 为 `false` 时，表示当前是实时更新的中间结果；当 `isCompleted` 为 `true` 时，表示该语音片段已完成，返回最终结果。
+
+```javascript
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  if (event.isCompleted) {
+    // 最终结果，可以存储或展示
+    saveSubtitle(event);
+  } else {
+    // 中间结果，可以实时更新 UI
+    updateLiveCaption(event);
+  }
+});
+```
+
+**2. 如何根据 segmentId 合并字幕？**
+
+每个连续的语音片段会有相同的 `segmentId`，可以根据此 ID 进行字幕的更新和合并：
+
+```javascript
+const subtitleMap = new Map();
+
+trtc.on(TRTC.EVENT.REALTIME_TRANSCRIBER_MESSAGE, (event) => {
+  subtitleMap.set(event.segmentId, event);
+  
+  if (event.isCompleted) {
+    // 语音片段完成，可以归档
+    archiveSubtitle(subtitleMap.get(event.segmentId));
+  }
+});
+```
+
+**3. 如何节省带宽？**
+
+当不需要接收转录消息时，移除 `REALTIME_TRANSCRIBER_MESSAGE` 事件的所有监听器，插件会自动暂停接收消息以节省带宽。当重新添加监听器时，会自动恢复接收消息。

package/resource/doc/rtcengine/web/plugin/43-advanced-face-detection.md

@@ -0,0 +1,180 @@
+## 功能描述
+
+本文档详细介绍了如何使用 TRTC Web SDK 的人脸检测插件，实时检测摄像头视频流中的人脸状态变化。该插件采用智能防抖逻辑，仅在人脸出现/消失状态真正变化时触发回调，避免因光线变化或短暂遮挡导致的误报。
+
+## 前提条件
+
+- TRTC Web SDK 版本 >= 5.15.0
+- 需要先开启摄像头视频流
+
+### 平台兼容性
+
+| 平台 | 操作系统 | 浏览器版本 | 备注 |
+|------|----------|------------|------|
+| Web | Windows | Chrome 90+、Firefox 90+、Edge 97+ | 建议使用最新版 Chrome 浏览器（开启浏览器硬件加速） |
+| Web | Mac | Chrome 98+、Firefox 96+、Safari 15+ | 2019年及以上 MacBook |
+| Web | Android | 微信内嵌浏览器、Chrome、Firefox、小米浏览器| 建议使用微信内嵌、Chrome 或火狐浏览器等主流浏览器 |
+| Web | iOS | 微信内嵌浏览器、Chrome、Safari、Firefox | 建议使用 Chrome 或 Safari 浏览器 |
+
+## 实现流程
+
+### 部署静态资源
+
+该插件依赖一些静态资源文件，为保证浏览器可以正常加载和运行这些文件，你需要完成以下步骤：
+
+1. 将 `node_modules/trtc-sdk-v5/assets` 目录发布至 CDN 或者静态资源服务器中。
+2. 在创建 trtc 实例时传入您的 CDN 地址给 assetsPath 参数，例如： `TRTC.create({ assetsPath: 'https://xxxx/assets' })`，SDK 会按需加载相关资源文件。
+
+> - 若您的版本低于 `v5.10.0`，您需要下载解压 https://web.sdk.qcloud.com/trtc/webrtc/v5/assets/assets.zip 后，发布至 CDN 或者静态资源服务器中。
+> - 如果目录下文件的 Host URL 与网页应用的 Host URL 不一致，则需要开启访问文件域名的 CORS 策略。
+> - 不能把目录文件放在 HTTP 服务下，因为在 HTTPS 域名下加载 HTTP 资源会被浏览器安全策略禁止。
+
+### 引入并注册插件
+
+```javascript
+import { FaceDetection } from 'trtc-sdk-v5/plugins/video-effect/face-detection';
+
+const trtc = TRTC.create({ 
+  plugins: [FaceDetection], 
+  assetsPath: 'https://xxxx/assets'  // 替换为您的静态资源地址
+});
+```
+
+### 开启本地摄像头
+
+```javascript
+await trtc.startLocalVideo();
+```
+
+### 开启人脸检测插件
+
+```javascript
+await trtc.startPlugin('FaceDetection', {
+  onFaceDetectionStateChanged: (hasFace) => {
+    if (hasFace) {
+      console.log('检测到人脸出现');
+      // 执行人脸出现时的业务逻辑
+    } else {
+      console.log('检测到人脸消失');
+      // 执行人脸消失时的业务逻辑
+    }
+  },
+  detectionInterval: 300,    // 检测间隔，单位ms (可选，默认300)
+  minConfidence: 0.8,        // 最小置信度阈值 (可选，默认0.8)
+  missingTimeout: 1000       // 人脸消失确认时间，单位ms (可选，默认1000)
+});
+```
+
+### 按需更新参数
+
+```javascript
+// 更新检测参数 - 提高检测灵敏度
+await trtc.updatePlugin('FaceDetection', {
+  onFaceDetectionStateChanged: (hasFace) => {
+    console.log('更新后的检测状态:', hasFace);
+  },
+  detectionInterval: 200,    // 缩短检测间隔，提高实时性
+  minConfidence: 0.7,        // 降低置信度阈值，提高检测灵敏度
+  missingTimeout: 1500       // 延长消失确认时间，减少误报
+});
+```
+
+### 关闭人脸检测
+
+```javascript
+await trtc.stopPlugin('FaceDetection');
+```
+
+## 核心特性
+
+### 智能防抖逻辑
+
+插件采用**非对称防抖机制**，确保状态变化的准确性：
+
+- **人脸出现（true）**：立即触发，实时响应
+- **人脸消失（false）**：延迟触发，需满足 `missingTimeout` 条件才确认
+
+该设计有效避免了因以下情况导致的误报：
+- 人脸短暂转头或低头
+- 光线瞬间变化
+- 物体短暂遮挡
+
+### 视频流状态同步
+
+当本地视频流状态变化时，插件会自动处理：
+
+| 场景 | 插件行为 | 回调触发 |
+|------|----------|----------|
+| 视频静音（Mute） | 暂停检测 | 触发一次 `hasFace: false` |
+| 视频恢复（Unmute） | 恢复检测 | 根据实际状态触发相应回调 |
+
+## API 说明
+
+### trtc.startPlugin('FaceDetection', options)
+
+用于开启人脸检测插件。
+
+#### options
+
+| Name | Type | Attributes | Description |
+|------|------|------------|-------------|
+| onFaceDetectionStateChanged | `(hasFace: boolean) => void` | 必填 | 人脸状态变化回调函数（仅在状态真正变化时触发） |
+| detectionInterval | number | 选填 | 检测间隔时间(ms)，范围 100-5000，默认 300 |
+| minConfidence | number | 选填 | 最小人脸置信度阈值，范围 0-1，默认 0.8 |
+| missingTimeout | number | 选填 | 人脸消失确认时间(ms)，范围 0-5000，默认 1000 |
+
+**Example:**
+
+```javascript
+await trtc.startPlugin('FaceDetection', {
+  onFaceDetectionStateChanged: (hasFace) => {
+    if (hasFace) {
+      console.log('人脸出现');
+    } else {
+      console.log('人脸消失');
+    }
+  },
+  detectionInterval: 300,
+  minConfidence: 0.8,
+  missingTimeout: 1000
+});
+```
+
+### trtc.updatePlugin('FaceDetection', options)
+
+可修改人脸检测参数。
+
+#### options
+
+| Name | Type | Attributes | Description |
+|------|------|------------|-------------|
+| onFaceDetectionStateChanged | `(hasFace: boolean) => void` | 选填 | 人脸状态变化回调函数 |
+| detectionInterval | number | 选填 | 检测间隔时间(ms)，范围 100-5000 |
+| minConfidence | number | 选填 | 最小人脸置信度阈值，范围 0-1 |
+| missingTimeout | number | 选填 | 人脸消失确认时间(ms)，范围 0-5000 |
+
+**Example:**
+
+```javascript
+await trtc.updatePlugin('FaceDetection', {
+  detectionInterval: 200,
+  minConfidence: 0.7,
+  missingTimeout: 1500
+});
+```
+
+### trtc.stopPlugin('FaceDetection')
+
+关闭人脸检测。
+
+## 常见问题
+
+**1. 如何调整检测的灵敏度？**
+
+可以通过以下参数组合调整：
+- **提高灵敏度**：降低 `minConfidence`，缩短 `detectionInterval`
+- **降低灵敏度**：提高 `minConfidence`，延长 `missingTimeout`
+
+**2. 视频流恢复后需要重新开启检测吗？**
+
+不需要。插件会自动处理视频流状态变化，恢复后会继续检测。

package/tools/chat/get-native-chat-feature-detail.js

@@ -0,0 +1,30 @@
+import { z } from 'zod';
+import { GET_NATIVE_CHAT_FEATURE_DETAIL_DEFINITION } from '../definitions/get_native_chat_feature_detail_def.js';
+import { getDocContent } from '../../utils/get-doc-content.js';
+import { reportCLSClient } from '../../utils/report-cls-client.js';
+import { handleFramework } from '../../utils/handle-framework.js';
+function getResultText(params) {
+    const { framework, featureName = '' } = params;
+    reportCLSClient({
+        method: 'get_native_chat_feature_detail',
+        info: featureName,
+        framework: framework,
+    });
+    return getDocContent(['chatuikit', `${handleFramework(framework)}`, 'features', `${featureName}.md`]);
+}
+const registryGetNativeChatFeatureDetailTool = (mcpServer) => {
+    const { name, description, parameter_descriptions } = GET_NATIVE_CHAT_FEATURE_DETAIL_DEFINITION;
+    mcpServer.tool(name, description, {
+        framework: z.enum(['andriod', 'ios', 'flutter']).describe(parameter_descriptions.framework),
+        featureName: z.string().describe(parameter_descriptions.featureName),
+    }, (params) => ({
+        content: [
+            {
+                type: 'text',
+                text: getResultText(params),
+            }
+        ]
+    }));
+};
+export { registryGetNativeChatFeatureDetailTool };
+//# sourceMappingURL=get-native-chat-feature-detail.js.map

package/tools/chat/get-native-chat-feature-detail.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-native-chat-feature-detail.js","sourceRoot":"","sources":["../../../src/tools/chat/get-native-chat-feature-detail.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,yCAAyC,EAAE,MAAM,sDAAsD,CAAC;AACjH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,eAAe,EAAE,MAAM,iCAAiC,CAAC;AAGlE,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,EAAE,WAAW,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAC/C,eAAe,CAAC;QACd,MAAM,EAAE,gCAAgC;QACxC,IAAI,EAAE,WAAW;QACjB,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,eAAe,CAAC,SAAS,CAAC,EAAE,EAAE,UAAU,EAAE,GAAG,WAAW,KAAK,CAAC,CAAC,CAAC;AACxG,CAAC;AAED,MAAM,sCAAsC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACtE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,yCAAyC,CAAC;IAChG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,KAAK,EAAE,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QAC3F,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,WAAW,CAAC;KACrE,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,sCAAsC,EAAE,CAAC"}

package/tools/chat/get-native-chat-integration.js

@@ -2,26 +2,44 @@ import { z } from 'zod';
 import { GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION } from '../definitions/get_native_chat_uikit_integration_def.js';
 import { getDocContent } from '../../utils/get-doc-content.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
-function getResultText(params) {
-    const { framework = '' } = params;
+import { generateStructuredResult } from '../../utils/generate-structured-result.js';
+async function getResultText(params) {
+    const { framework = '', goals = [] } = params;
     reportCLSClient({
         method: 'get_native_chat_uikit_integration',
-        framework: framework,
+        info: goals.join(','),
+        framework,
     });
-    return getDocContent(['chatuikit', `${framework}`]);
+    // 获取工作流指令
+    const baseInstructions = getDocContent(['chatuikit', framework, 'workflow.md']);
+    // 批量读取目标文档并生成结构化结果
+    const result = await generateStructuredResult({
+        baseInstructions,
+        goals,
+        framework,
+        pathMap: {
+            [goals[0]]: ['chatuikit', framework, 'integration.md'],
+        },
+    });
+    return result;
 }
 const registryGetNativeChatIntegrationTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION;
     mcpServer.tool(name, description, {
         framework: z.enum(['flutter', 'android', 'ios']).describe(parameter_descriptions.framework),
-    }, (params) => ({
-        content: [
-            {
-                type: 'text',
-                text: getResultText(params),
-            }
-        ]
-    }));
+        goals: z.array(z.enum(['full-featured', 'chat-only'])).describe(parameter_descriptions.goals)
+    }, async (params) => {
+        const result = await getResultText(params);
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: result.llm_code_generation_instructions_md,
+                }
+            ],
+            result: result,
+        };
+    });
 };
 export { registryGetNativeChatIntegrationTool };
 //# sourceMappingURL=get-native-chat-integration.js.map

package/tools/chat/get-native-chat-integration.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-native-chat-integration.js","sourceRoot":"","sources":["../../../src/tools/chat/get-native-chat-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4CAA4C,EAAE,MAAM,yDAAyD,CAAC;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,SAAS,aAAa,CAAC,MAA2B;IAChD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAClC,eAAe,CAAC;QACd,MAAM,EAAE,mCAAmC;QAC3C,SAAS,EAAE,SAAS;KACrB,CAAC,CAAC;IACH,OAAO,aAAa,CAAC,CAAC,WAAW,EAAE,GAAG,SAAS,EAAE,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,oCAAoC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACpE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,4CAA4C,CAAC;IACnG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;KAC5F,EAAE,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC;QACd,OAAO,EAAE;YACP;gBACE,IAAI,EAAE,MAAM;gBACZ,IAAI,EAAE,aAAa,CAAC,MAAM,CAAC;aAC5B;SACF;KACF,CAAC,CAAC,CAAC;AACR,CAAC,CAAC;AACF,OAAO,EAAE,oCAAoC,EAAE,CAAC"}
+{"version":3,"file":"get-native-chat-integration.js","sourceRoot":"","sources":["../../../src/tools/chat/get-native-chat-integration.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,4CAA4C,EAAE,MAAM,yDAAyD,CAAC;AACvH,OAAO,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AAC/D,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,wBAAwB,EAAE,MAAM,2CAA2C,CAAC;AAErF,KAAK,UAAU,aAAa,CAAC,MAA2B;IACtD,MAAM,EAAE,SAAS,GAAG,EAAE,EAAE,KAAK,GAAG,EAAE,EAAE,GAAG,MAAM,CAAC;IAC9C,eAAe,CAAC;QACd,MAAM,EAAE,mCAAmC;QAC3C,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QACrB,SAAS;KACV,CAAC,CAAC;IACH,UAAU;IACV,MAAM,gBAAgB,GAAG,aAAa,CAAC,CAAC,WAAW,EAAE,SAAS,EAAE,aAAa,CAAC,CAAC,CAAC;IAChF,mBAAmB;IACnB,MAAM,MAAM,GAAG,MAAM,wBAAwB,CAAC;QAC5C,gBAAgB;QAChB,KAAK;QACL,SAAS;QACT,OAAO,EAAE;YACP,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,WAAW,EAAE,SAAS,EAAE,gBAAgB,CAAC;SACvD;KACF,CAAC,CAAA;IACF,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,oCAAoC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACpE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,4CAA4C,CAAC;IACnG,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QAC3F,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,eAAe,EAAE,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC;KAC9F,EACD,KAAK,EAAE,MAAW,EAAE,EAAE;QACpB,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,MAAM,CAAC,CAAA;QAC1C,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,MAAM,CAAC,mCAAmC;iBACjD;aACF;YACD,MAAM,EAAE,MAAM;SACf,CAAA;IACL,CAAC,CAAC,CAAC;AACL,CAAC,CAAC;AAEF,OAAO,EAAE,oCAAoC,EAAE,CAAC"}

package/tools/common/get-faq.js

@@ -11,8 +11,6 @@ const PRODUCT_DOC_MAP = {
 };
 const WEB_FRAMEWORKS = ['react', 'vue', 'web'];
 const NATIVE_FRAMEWORKS = ['android', 'ios', 'flutter'];
-const WEB_SDK_DIR = 'web_sdk';
-const NATIVE_SDK_DIR = 'native_sdk';
 function getResultText(params) {
     const { query = '', product = '', framework = '' } = params;
     const basePath = PRODUCT_DOC_MAP[product];
@@ -32,10 +30,10 @@ function getResultText(params) {
     // Step 2: SDK FAQ Search (SDK Path)
     let sdkDir = '';
     if (WEB_FRAMEWORKS.includes(framework)) {
-        sdkDir = WEB_SDK_DIR;
+        sdkDir = 'web_sdk';
     }
     else if (NATIVE_FRAMEWORKS.includes(framework)) {
-        sdkDir = NATIVE_SDK_DIR;
+        sdkDir = `${framework}_sdk`;
     }
     const sdkSearchContent = getDocContent([basePath, 'faq', sdkDir]);
     // Step 3: General Knowledge Search (Server Error Codes, Billing, Console, REST API, etc.) (Common Path)

package/tools/common/get-faq.js.map

@@ -1 +1 @@
-{"version":3,"file":"get-faq.js","sourceRoot":"","sources":["../../../src/tools/common/get-faq.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"get-faq.js","sourceRoot":"","sources":["../../../src/tools/common/get-faq.ts"],"names":[],"mappings":"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"}

package/tools/definitions/get_native_chat_feature_detail_def.js

@@ -0,0 +1,32 @@
+const TOOL_DESCRIPTION = `
+【核心用途】：这是一个 Native 聊天应用 UIKit 功能详情工具，专门用于提供 Native Chat TUIKit 中各项功能的详细说明、用法和示例代码。
+
+【功能范围】：
+检索任一功能的详细文档，包括功能实现方法、API 调用、代码示例等
+
+【核心功能模块】：本工具涵盖 Native Chat TUIKit 的全部核心功能，包括：
+
+**📋 核心功能列表：**
+1. **主题定制** (theme)：主题样式定制功能，支持自定义颜色、字体、圆角、间距等视觉样式，适用于实现品牌化 UI、深色模式、个性化外观等场景
+
+【关键词】：'功能详情', 'TUIKit', 'Native', 'Android', 'iOS', 'Flutter', '主题', 'theme', 'TUITheme', '主题定制', '样式定制', '深色模式', 'dark mode', '品牌化', '颜色', '字体', 'UI 定制'。
+
+【支持平台】：Android、iOS 和 Flutter。
+
+【强制约束】：
+1. 平台选择约束：如果用户在提示词中**没有明确指定** Android、iOS 或 Flutter 平台，必须优先调用 'present_framework_choice' 工具，引导用户进行选择。
+
+2. **功能名称必须精确匹配**：featureName 参数必须从以下列表中选择，不支持模糊匹配：
+   - 'theme'：主题定制（颜色、字体、圆角、间距等视觉样式定制）
+`;
+const PARAMETER_DESCRIPTIONS = {
+    framework: 'Native Chat UIKit 功能详情支持的平台/框架类型。可选值：android, ios, flutter。',
+    featureName: `Native Chat UIKit 功能的具体名称，可选值：
+- 'theme': 主题定制（颜色、字体、圆角、间距等视觉样式定制）`
+};
+export const GET_NATIVE_CHAT_FEATURE_DETAIL_DEFINITION = {
+    name: 'get_native_chat_feature_detail',
+    description: TOOL_DESCRIPTION,
+    parameter_descriptions: PARAMETER_DESCRIPTIONS,
+};
+//# sourceMappingURL=get_native_chat_feature_detail_def.js.map

package/tools/definitions/get_native_chat_feature_detail_def.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_native_chat_feature_detail_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_feature_detail_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;CAoBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,6DAA6D;IACxE,WAAW,EAAE;oCACqB;CACnC,CAAC;AAGF,MAAM,CAAC,MAAM,yCAAyC,GAAG;IACvD,IAAI,EAAE,gCAAgC;IACtC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}