@tencentcloud/sdk-mcp 1.3.8 → 1.3.9

package/resource/doc/tuicallkit/android/workflow.md

@@ -0,0 +1,432 @@
+# Android TUICallKit 音视频通话应用代码生成工作流指令
+
+## 📋 指令目的
+
+为 Agent 提供实现 Android TUICallKit **音视频通话核心功能的代码生成蓝图**,并指导 Agent **优先使用工具实时获取的最新文档内容**,专门针对 Android 音视频通话应用场景。
+
+---
+
+## 🛑 Agent 执行硬性限制 (Guardrails)
+
+Agent 在生成代码时必须严格遵守以下指令:
+
+### 0. 🚨 核心原则(最高优先级)
+
+- ✅ 严格按照集成文档中的示例代码生成,不擅自修改
+- ✅ 完整实现登录、单人通话、多人通话功能
+- ✅ 使用 `get_usersig` 工具生成测试账号的 UserSig
+- ✅ 使用源码方式导入组件(从 GitHub 克隆 `tuicallkit-kt` 和 `atomic_x`)
+
+### 1. 文档驱动集成
+- 严格按照工具返回的 `llm_code_generation_instructions_md` 步骤执行
+- 遵循集成文档的最佳实践和示例代码
+
+### 2. 组件导入方式
+- **源码导入方式**: 从 GitHub 克隆代码,将 `tuicallkit-kt` 和 `atomic_x` 目录复制到项目中
+  ```bash
+  # 克隆 TUIKit_Android 仓库
+  git clone https://github.com/Tencent-RTC/TUIKit_Android.git
+  # 将 atomic_x 和 call/tuicallkit-kt 目录复制到项目 app 同级目录
+  ```
+- **settings.gradle.kts 配置**:
+  ```kotlin
+  include(":tuicallkit-kt")
+  include(":atomic_x")
+  ```
+- **settings.gradle 配置**:
+  ```groovy
+  include ':tuicallkit-kt'
+  include ':atomic_x'
+  ```
+- **app/build.gradle.kts 依赖配置**:
+  ```kotlin
+  dependencies {
+      api(project(":tuicallkit-kt"))
+  }
+  ```
+- **app/build.gradle 依赖配置**:
+  ```groovy
+  dependencies {
+      api project(':tuicallkit-kt')
+  }
+  ```
+
+### 3. 静默执行集成
+- 所有代码编写完成后,在最后一步自动同步 Gradle 并构建项目
+- **Gradle 命令执行策略(多级降级,确保成功)**:
+  1. **第一优先级**: 尝试直接执行 `./gradlew build`
+  2. **第二优先级**: 如果失败,尝试 `./gradlew assembleDebug`
+  3. **第三优先级**: 如果仍失败,**引导用户手动在 Android Studio 中同步**(见下方指引)
+- 构建成功后提示用户在模拟器或真机中运行应用
+
+#### 📋 手动执行降级指引
+
+**当自动执行失败时,引导用户手动执行**:
+
+1. 在 Android Studio 中点击 **File → Sync Project with Gradle Files**
+2. 等待 Gradle 同步完成
+3. 点击 **Run** 按钮运行应用
+
+**常见问题**: Gradle 同步失败 → 检查 JDK 版本(需要 JDK 17+); 编译失败 → 检查 Android SDK 版本
+
+### 4. 鉴权凭据配置(重要)
+- 调用 `get_usersig` 工具获取 SDKAppID、UserID、UserSig
+- 为 4 个测试账号(user001/002/003/004)生成 UserSig
+- 测试阶段可硬编码鉴权信息,但需注释标注仅用于测试
+- ⚠️ 安全警告: 告知用户生产环境必须在服务端生成 UserSig
+
+### 5. LoginActivity 实现约束 🔴
+
+**⚠️ 优先检查项目中是否已存在登录页**:
+- 在实现登录页面前,**必须先检查项目中是否已存在登录页面**
+- 如果已存在登录页面,**必须询问用户是否要执行默认行为**:
+  - **选项 1**: 使用默认行为(创建新的 LoginActivity,包含下拉框、4 个测试账号等)
+  - **选项 2**: 在现有登录页基础上修改(保留用户的 UI 和交互逻辑,仅添加必要的 TUILogin 登录逻辑)
+- 如果用户选择选项 2,应该:
+  - 保留用户现有的登录页面 UI 和交互逻辑
+  - 仅在登录成功后调用 `TUILogin.login` 进行二次登录
+  - 不强制使用下拉框和 4 个测试账号
+- 如果项目中不存在登录页面,或用户选择选项 1,则按照以下默认行为实现
+
+**默认登录页面实现要求**:
+- **必须实现登录页面**,包含以下功能:
+  1. **下拉框选择 UserID**: 提供 user001、user002、user003、user004 四个选项
+  2. **显示 SDKAppID**: 从 `get_usersig` 获取并显示(只读,不可编辑)
+  3. **自动生成 UserSig**: 根据选择的 UserID 自动从预生成的 UserSig 中匹配
+  4. **登录按钮**: 调用 `TUILogin.login` 登录
+- **登录接口必须调用 `TUILogin.login`**,传入从 `get_usersig` 获取的完整凭证
+- 登录成功后自动跳转到主页面(MainActivity/HomePage)
+
+**LoginActivity 核心实现要点(Kotlin)**:
+
+```kotlin
+// 1. 导入必要的类
+import com.tencent.qcloud.tuicore.TUILogin
+import com.tencent.qcloud.tuicore.interfaces.TUICallback
+
+// 2. 定义测试账号映射表(从 get_usersig 获取)
+val userSigMap = mapOf(
+    "user001" to "xxx",
+    "user002" to "xxx",
+    "user003" to "xxx",
+    "user004" to "xxx"
+)
+
+// 3. UI 组件
+// - SDKAppID 显示(只读 TextView)
+// - UserID 下拉框(Spinner,选项从 userSigMap.keys 生成)
+// - 登录按钮
+
+// 4. 登录逻辑
+TUILogin.login(context, sdkAppId, userId, userSig, object : TUICallback() {
+    override fun onSuccess() {
+        // 跳转到 MainActivity
+    }
+    override fun onError(errorCode: Int, errorMessage: String) {
+        // 显示错误信息
+    }
+})
+```
+
+### 6. MainActivity/HomePage 实现约束 🔴
+
+**必须实现主页面**,包含以下功能:
+
+1. **显示当前登录的 UserID**
+2. **音视频通话功能**(统一用户选择):
+   - **用户列表(多选)**:显示可选用户(user002、user003、user004,排除当前登录用户)
+   - **智能判断通话类型**:
+     - 选择 **1 个用户** → 自动发起**单人通话**
+     - 选择 **多个用户** → 自动发起**多人通话**
+   - **语音通话按钮**:调用 `TUICallKit.createInstance(context).calls` 发起语音通话
+   - **视频通话按钮**:调用 `TUICallKit.createInstance(context).calls` 发起视频通话
+   - **实现方式**:使用 CheckBox 列表,支持单选和多选
+3. **退出登录按钮**:调用 `TUILogin.logout` 退出登录
+
+**MainActivity 核心实现要点(Kotlin)**:
+
+```kotlin
+// 1. 导入必要的类
+import com.tencent.qcloud.tuikit.tuicallkit.TUICallKit
+import io.trtc.tuikit.atomicxcore.api.call.CallMediaType
+import io.trtc.tuikit.atomicxcore.api.call.CallParams
+
+// 2. 显示当前登录用户(TextView)
+
+// 3. 用户选择区域(统一单人/多人通话)
+// - 用户列表: val availableUsers = listOf("user002", "user003", "user004").filter { it != currentUserId }
+// - 多选框: CheckBox(支持选择 1 个或多个用户)
+// - 选中用户: val selectedUsers = mutableListOf<String>()
+
+// 4. 通话按钮区域
+// - 语音通话按钮: Button
+// - 视频通话按钮: Button
+
+// 5. 发起通话逻辑
+val params = CallParams()
+TUICallKit.createInstance(context).calls(selectedUsers, CallMediaType.Audio, params, object : CompletionHandler {
+    override fun onSuccess() {
+        // 成功回调
+    }
+    override fun onFailure(code: Int, desc: String) {
+        // 失败回调
+    }
+})
+
+// 6. 退出登录逻辑
+TUILogin.logout(object : TUICallback() {
+    override fun onSuccess() {
+        // 跳转回 LoginActivity
+    }
+    override fun onError(errorCode: Int, errorMessage: String) {
+        // 显示错误信息
+    }
+})
+```
+
+### 7. 工程配置约束 🔴
+
+**必须完成以下工程配置**:
+
+1. **混淆规则配置**: 在 `app/proguard-rules.pro` 文件末尾添加:
+   ```proguard
+   -keep class com.tencent.** { *; }
+   ```
+
+2. **AndroidManifest.xml 配置**: 在 application 节点中添加 `tools:replace="android:allowBackup"`:
+   ```xml
+   <application
+       android:name=".BaseApplication"
+       android:allowBackup="false"
+       android:icon="@drawable/app_ic_launcher"
+       android:label="@string/app_name"
+       android:largeHeap="true"
+       android:theme="@style/AppTheme"
+       tools:replace="android:allowBackup">
+   ```
+
+3. **Gradle JDK 版本**: AGP 8.0+ 要求 Gradle 运行时使用 Java 17 或更高版本
+
+### 8. 构建脚本语法检查(重要) 🔴
+
+**⚠️ 在配置构建脚本前,必须先检查项目使用的构建脚本类型**,根据实际情况选择正确的语法:
+
+| 构建脚本文件 | 语法类型 | 示例 |
+|-------------|---------|------|
+| `settings.gradle` | Groovy DSL | `include ':tuicallkit-kt'` |
+| `settings.gradle.kts` | Kotlin DSL | `include(":tuicallkit-kt")` |
+| `build.gradle` | Groovy DSL | `api project(':tuicallkit-kt')` |
+| `build.gradle.kts` | Kotlin DSL | `api(project(":tuicallkit-kt"))` |
+
+**检查步骤**:
+1. 查看项目根目录和 `app/` 目录下的构建脚本文件名
+2. 如果是 `.gradle` 结尾 → 使用 Groovy 语法
+3. 如果是 `.gradle.kts` 结尾 → 使用 Kotlin DSL 语法
+
+### 9. Android 项目规范
+- Android 版本要求: Android 5.0 (SDK API Level 21) 及以上
+- Gradle 版本要求: Gradle 4.2.1 及以上
+- 使用 Kotlin 语言编写(推荐),也支持 Java
+
+### 10. 环境依赖准备
+- 确保用户已安装 Android Studio
+- 确保用户已配置 Android SDK
+- JDK 17+ 版本(AGP 8.0+ 要求)
+- **如果自动构建失败,必须引导用户手动在 Android Studio 中同步 Gradle**
+
+---
+
+## 📦 核心版本要求
+
+| 工具/平台 | 最低版本要求 |
+|----------|-------------|
+| **Android** | >= 5.0 (API Level 21) |
+| **Gradle** | >= 4.2.1 |
+| **JDK** | >= 17 (AGP 8.0+) |
+
+**详细的工具版本要求请参考集成文档"准备工作-环境要求"部分**
+
+---
+
+## 📦 自动化执行命令
+
+Agent 代码生成完成后,按顺序自动执行:
+
+```bash
+# 1. 克隆 TUIKit_Android 仓库(如果尚未克隆)
+git clone https://github.com/Tencent-RTC/TUIKit_Android.git
+
+# 2. 复制组件到项目目录
+cp -r TUIKit_Android/atomic_x ./
+cp -r TUIKit_Android/call/tuicallkit-kt ./
+
+# 3. 构建项目
+./gradlew assembleDebug
+```
+
+**降级策略**: `./gradlew` 失败 → 引导用户手动在 Android Studio 中同步 Gradle
+
+---
+
+## 📱 真机调试引导(用户指引)
+
+### Android 真机调试
+1. USB 连接设备
+2. 开启开发者模式(连点版本号 7 次) + USB 调试
+3. 设备授权 USB 调试(允许)
+4. 执行 `adb devices` 验证连接
+5. 在 Android Studio 中点击 Run 按钮,选择目标设备
+
+### Android 模拟器调试
+1. 打开 Android Studio → Device Manager
+2. 创建或启动模拟器
+3. 点击 Run 按钮运行应用
+
+---
+
+## 🔄 完整自动化流程
+
+```mermaid
+graph TD
+    A[接收用户需求] --> B[检查 Android 开发环境]
+    B --> C[克隆 TUIKit_Android 仓库]
+    C --> D[复制 tuicallkit-kt 和 atomic_x 到项目]
+    D --> E[配置 settings.gradle: 添加 include]
+    E --> F[配置 app/build.gradle: 添加依赖]
+    F --> G[配置混淆规则: proguard-rules.pro]
+    G --> H[配置 AndroidManifest.xml]
+    H --> I[调用 get_usersig 工具生成 4 个账号的 UserSig]
+    I --> J[实现 LoginActivity: 下拉框选择 UserID]
+    J --> K[实现 MainActivity: 单人通话和多人通话]
+    K --> L[调用 record_result 记录集成结果]
+    L --> M[执行 Gradle 构建]
+    M --> N{构建成功?}
+    N -->|是| O[引导用户连接设备运行]
+    N -->|否| P[引导用户手动在 Android Studio 中同步]
+    O --> Q[项目启动成功]
+    P --> Q
+```
+
+---
+
+## 📝 关键要点总结
+
+| 类别 | 要求 |
+|------|------|
+| **Android 版本** | Android 5.0 (API Level 21) 及以上 |
+| **接入方式** | 源码方式(从 GitHub 克隆 `tuicallkit-kt` 和 `atomic_x`) |
+| **文档优先** | ⚠️ 严格遵循集成文档中的示例代码,不得擅自修改 |
+| **静默集成** | 代码编写完成后自动构建项目 |
+| **凭证获取** | ⚠️ 必须使用 `get_usersig` 工具为 4 个测试账号(user001/002/003/004)生成 UserSig |
+| **登录页面** | ⚠️ 必须实现下拉框选择 UserID,自动匹配 UserSig,禁止手动输入 |
+| **主页面** | ⚠️ 必须支持统一用户列表,选择 1 个用户自动发起单人通话,选择多个用户自动发起多人通话 |
+| **安全提示** | ⚠️ 必须告知用户:客户端生成 UserSig 仅适合测试,生产环境必须在服务端生成 |
+| **结果记录** | ⚠️ 集成完成后必须调用 `record_result` 工具记录结果 |
+| **工程配置** | ⚠️ 必须配置混淆规则和 AndroidManifest.xml |
+
+---
+
+## 🎯 Agent 执行检查清单
+
+在完成代码生成后,Agent 必须确认以下所有项目:
+
+### 组件导入
+- [ ] 已克隆 TUIKit_Android 仓库
+- [ ] 已复制 `tuicallkit-kt` 和 `atomic_x` 到项目 app 同级目录
+- [ ] 已配置 `settings.gradle(.kts)` 添加 include
+- [ ] 已配置 `app/build.gradle(.kts)` 添加依赖
+
+### 工程配置
+- [ ] 已配置 `proguard-rules.pro` 混淆规则
+- [ ] 已配置 `AndroidManifest.xml` 添加 `tools:replace`
+
+### 代码生成
+- [ ] 调用 `get_usersig` 工具生成 4 个账号的 UserSig
+- [ ] 实现 LoginActivity(下拉框选择 UserID,不包含手动输入框)
+- [ ] 实现 MainActivity(统一用户列表,选 1 个为单人通话,选多个为多人通话)
+
+### 最终检查
+- [ ] 调用 `record_result` 工具记录集成结果
+- [ ] 执行 Gradle 构建或引导用户手动同步
+- [ ] 提示用户选择设备运行应用
+- [ ] 告知用户: 生产环境必须在服务端生成 UserSig
+
+---
+
+## ❓ 遇到问题？AI 可以帮你快速解决
+
+**当同步依赖或编译出现错误时,请将完整的错误信息提供给 AI,可以帮你快速定位和解决问题。**
+
+### 📋 常见错误场景
+
+| 错误类型 | 描述 | AI 可以帮你 |
+|---------|------|-----------|
+| **Gradle 同步失败** | 依赖下载失败、版本冲突、仓库连接超时等 | 分析依赖冲突、推荐镜像源、修复版本兼容性 |
+| **编译错误** | 类找不到、方法签名不匹配、API 版本不兼容等 | 定位缺失的依赖、修复导入语句、适配 API 变更 |
+| **运行时崩溃** | 空指针、权限缺失、初始化顺序错误等 | 分析堆栈信息、检查权限配置、修复初始化逻辑 |
+| **混淆问题** | Release 包功能异常、类被错误混淆等 | 补充混淆规则、定位被混淆的类 |
+
+### 💡 如何高效反馈错误
+
+为了让 AI 更快速准确地帮你解决问题,请提供以下信息:
+
+1. **完整的错误日志**: 复制 Android Studio 的 Build Output 或 Logcat 中的完整错误信息
+2. **错误发生时机**: 说明是在 Gradle 同步、编译、还是运行时发生的
+3. **操作步骤**: 简述你执行了哪些操作后出现的错误
+
+**示例反馈格式**:
+```
+错误时机: Gradle 同步时
+错误信息:
+> Could not resolve com.tencent.liteav:LiteAVSDK_TRTC:xxx
+> Repository connection failed: xxx
+
+已尝试的操作: 重新同步、清理缓存
+```
+
+### 🔧 常见问题快速自查
+
+在向 AI 反馈前,可以先尝试以下操作:
+
+1. **Gradle 同步失败**:
+   - File → Invalidate Caches / Restart
+   - 检查网络连接,尝试使用 VPN 或配置国内镜像源
+   - 检查 JDK 版本是否为 17+
+
+2. **找不到类/方法**:
+   - 确认 `tuicallkit-kt` 和 `atomic_x` 目录已正确复制到项目根目录
+   - 确认 `settings.gradle(.kts)` 中已添加 include 配置
+   - 点击 File → Sync Project with Gradle Files 重新同步
+
+3. **版本兼容问题**:
+   - 检查 `compileSdk` 和 `targetSdk` 版本(推荐 34+)
+   - 检查 Gradle Plugin 版本和 Gradle 版本匹配关系
+
+---
+
+## 🔗 必须使用的工具
+
+### `get_usersig` - 获取测试鉴权信息
+获取 SDKAppID、UserID(user001/002/003/004)、UserSig。
+- LoginActivity: 下拉框选择 UserID
+- MainActivity: 显示可选用户列表(排除当前登录用户)
+- 禁止手动输入 SDKAppID/SecretKey/UserSig
+
+### `record_result` - 记录集成结果
+完成所有集成步骤并成功构建项目后调用
+
+---
+
+## 📚 相关资源链接
+
+- **TUICallKit Android GitHub**:https://github.com/Tencent-RTC/TUIKit_Android
+- **腾讯云实时音视频 TRTC 控制台**:https://console.cloud.tencent.com/trtc
+- **服务端生成 UserSig**:https://cloud.tencent.com/document/product/647/17275
+- **开通 TRTC 服务**:https://cloud.tencent.com/document/product/647/16788
+- **Android 开发者官方文档**:https://developer.android.com/docs
+
+---
+
+**适用平台**: Android  
+**TUICallKit 版本**: tuicallkit-kt (最新版本)  
+**最低要求**: Android 5.0 (API Level 21)、Gradle 4.2.1、JDK 17+

package/tools/common/present-scenario-choice.js

@@ -0,0 +1,16 @@
+import { PRESENT_SCENARIO_CHOICE_DEFINITION } from '../definitions/present_scenario_choice_def.js';
+const registryPresentScenarioChoiceTool = (mcpServer) => {
+    const { name, description, selectionText } = PRESENT_SCENARIO_CHOICE_DEFINITION;
+    mcpServer.tool(name, description, {}, () => {
+        return {
+            content: [
+                {
+                    type: 'text',
+                    text: selectionText,
+                }
+            ]
+        };
+    });
+};
+export { registryPresentScenarioChoiceTool };
+//# sourceMappingURL=present-scenario-choice.js.map

package/tools/common/present-scenario-choice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"present-scenario-choice.js","sourceRoot":"","sources":["../../../src/tools/common/present-scenario-choice.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kCAAkC,EAAE,MAAM,+CAA+C,CAAC;AAEnG,MAAM,iCAAiC,GAAG,CAAC,SAAoB,EAAE,EAAE;IACjE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,aAAa,EAAE,GAAG,kCAAkC,CAAC;IAChF,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX,EAAE,EACF,GAAG,EAAE;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,aAAa;iBACpB;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,iCAAiC,EAAE,CAAC"}

package/tools/definitions/get_native_call_uikit_integration_def.js

@@ -1,6 +1,11 @@
 const TOOL_DESCRIPTION = `
 【核心用途】：作为一个专业的 Native 音视频通话 TUICallKit 集成助手，本工具专用于为 Agent 提供工作流行动指令和实时聚合的最新文档内容，以指导 LLM 帮用户实现移动端音视频通话功能。
 
+【⚠️ 重要参数提醒】：
+本工具的平台参数名是 "framework"，不是 "platform"！
+- ✅ 正确调用：{"framework": "android"}
+- ❌ 错误调用：{"platform": "android"}
+
 【功能目标 (Goals)】：
 集成完整的音视频通话功能。包含单人通话、多人通话、呼叫接听、通话界面等。**适用于构建类似微信/企微风格的音视频通话应用，支持一对一和多人通话场景。**
 
@@ -14,14 +19,25 @@ Agent 在处理用户需求时，应使用本工具返回的 llm_code_generation
 
 LLM 必须优先且唯一使用本工具返回的实时内容生成代码，避免自行访问外部 URL。
 
+【参数说明】：
+- **framework** (必需): 目标开发平台。注意参数名是 "framework" 不是 "platform"
+  - "flutter": Flutter 跨平台开发
+  - "android": Android 原生开发  
+  - "ios": iOS 原生开发
+
+【调用示例】：
+- Android 集成：{"framework": "android"}
+- iOS 集成：{"framework": "ios"}
+- Flutter 集成：{"framework": "flutter"}
+
 【强制约束】：
-1. 平台选择约束：如果用户未明确指定平台，或意图不清晰，必须优先调用 'present_framework_choice' 工具，引导用户在 flutter, android, ios 中进行选择。
+1. 平台选择约束：参数名必须使用 "framework"（不是 platform）。如果用户未明确指定平台，或意图不清晰，必须优先调用 'present_framework_choice' 工具，引导用户在 flutter, android, ios 中进行选择。
 2. 结果记录约束：在 TUICallKit 组件集成完成且项目启动成功后，必须调用 'record_result' 工具记录集成结果。
 
 【支持平台】：flutter, android, ios。
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: 'Native 音视频通话 TUICallKit 平台类型。可选值：flutter (Flutter 跨平台), android (Android 原生), ios (iOS 原生)。',
+    framework: '【重要】Native 音视频通话 TUICallKit 平台类型。注意：参数名是 "framework" 不是 "platform"！可选值：flutter (Flutter 跨平台), android (Android 原生), ios (iOS 原生)。',
 };
 export const GET_NATIVE_CALL_UIKIT_DEFINITION = {
     name: 'get_native_call_uikit_integration',

package/tools/definitions/get_native_call_uikit_integration_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_native_call_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_call_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;CAqBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,6FAA6F;CACzG,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}
+{"version":3,"file":"get_native_call_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_call_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqCxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,mIAAmI;CAC/I,CAAC;AAEF,MAAM,CAAC,MAAM,gCAAgC,GAAG;IAC9C,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}

package/tools/definitions/get_native_chat_uikit_integration_def.js

@@ -1,12 +1,34 @@
 const TOOL_DESCRIPTION = `
-【核心用途】：作为一个专业的 Native 聊天 TUIKit 集成助手，本工具专用于为 Agent 提供工作流行动指令和实时聚合的最新文档内容，以指导 LLM 帮用户实现移动端即时通信（IM）功能。\n
+【核心用途】：作为一个专业的 Native 聊天 TUIKit 集成助手，本工具专用于为 Agent 提供工作流行动指令和实时聚合的最新文档内容，以指导 LLM 帮用户实现移动端即时通信（IM）功能。
 
-【功能目标 (Goals)】：\n
+【⚠️ 重要参数提醒】：
+本工具的平台参数名是 "framework"，不是 "platform"！
+- ✅ 正确调用：{"framework": "android", "goals": ["full-featured"]}
+- ❌ 错误调用：{"platform": "android", "goals": ["full-featured"]}
+\n
+
+【功能目标 (Goals)】：
 1. full-featured: 集成全量功能。包含会话列表、聊天窗口、群组管理、个人中心等。**适用于构建微信/企微风格的完整移动应用，或作为 App 的核心 Tab 模块。**
 2. chat-only: 仅集成聊天窗口。**适用于客服咨询、医疗在线问诊、订单详情页私聊等轻量级对话场景。**
 
-【关键词】：\n
-'Native', '移动端', 'Chat', 'TUIKit', '聊天', '即时通信', '微信', '企微', 'Flutter', 'Android', 'iOS', '集成', '客服', '医疗问诊', 'TabBar', '消息入口', '会话列表', '对话框'。
+【参数说明】：
+- **framework** (必需): 目标开发平台。注意参数名是 "framework" 不是 "platform"
+  - "flutter": Flutter 跨平台开发
+  - "android": Android 原生开发  
+  - "ios": iOS 原生开发
+- **goals** (必需): 功能目标列表
+  - ["full-featured"]: 完整应用功能
+  - ["chat-only"]: 仅聊天窗口
+
+【调用示例】：
+- Android 全功能集成：{"framework": "android", "goals": ["full-featured"]}
+- iOS 聊天窗口：{"framework": "ios", "goals": ["chat-only"]}
+- Flutter 全功能：{"framework": "flutter", "goals": ["full-featured"]}
+
+【关键词】：
+'Native', '移动端', 'Chat', 'TUIKit', '聊天', '即时通信', '微信', '企微', 
+'framework=flutter', 'framework=android', 'framework=ios', 
+'集成', '客服', '医疗问诊', 'TabBar', '消息入口', '会话列表', '对话框'。
 
 【行动指令与工作流引导】：\n
 Agent 在处理用户需求时，应使用本工具返回的 llm_code_generation_instructions_md 字段。这个字段包含了：
@@ -15,14 +37,14 @@ Agent 在处理用户需求时，应使用本工具返回的 llm_code_generation
 
 LLM 必须优先且唯一使用本工具返回的实时内容生成代码，避免自行访问外部 URL。\n
 
-【强制约束】：\n
-1. 平台选择约束：如果用户未明确指定平台，或意图不清晰，必须优先调用 'present_framework_choice' 工具，引导用户在 flutter, android, ios 中进行选择。
+【强制约束】：
+1. 平台选择约束：参数名必须使用 "framework"（不是 platform）。如果用户未明确指定平台，或意图不清晰，必须优先调用 'present_framework_choice' 工具，引导用户在 flutter, android, ios 中进行选择。
 2. 结果记录约束：在 TUIKit 组件集成完成且项目启动成功后，必须调用 'record_result' 工具记录集成结果。
 
 【支持平台】：flutter, android, ios。
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: 'Native 聊天 TUIKit 平台类型。可选值：flutter (Flutter 跨平台), android (Android 原生), ios (iOS 原生)。',
+    framework: '⚠️ 注意参数名是 "framework" 不是 "platform"！Native 聊天 TUIKit 平台类型。可选值：flutter (Flutter 跨平台), android (Android 原生), ios (iOS 原生)。',
     goals: "用户请求实现的功能目标列表。可选值：['full-featured'] (标准应用), ['chat-only'] (客服/问诊/弹窗)。",
 };
 export const GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION = {

package/tools/definitions/get_native_chat_uikit_integration_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"get_native_chat_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;CAsBxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,sFAAsF;IACjG,KAAK,EAAE,uEAAuE;CAC/E,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG;IAC1D,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}
+{"version":3,"file":"get_native_chat_uikit_integration_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/get_native_chat_uikit_integration_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CA4CxB,CAAC;AAEF,MAAM,sBAAsB,GAAG;IAC7B,SAAS,EAAE,0HAA0H;IACrI,KAAK,EAAE,uEAAuE;CAC/E,CAAC;AAEF,MAAM,CAAC,MAAM,4CAA4C,GAAG;IAC1D,IAAI,EAAE,mCAAmC;IACzC,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE,sBAAsB;CAC/C,CAAC"}