@tencent-rtc/mcp 1.3.6 → 1.3.8

package/resource/doc/livekit/live/flutter/workflow.md

@@ -0,0 +1,353 @@
+
+# Native Live AtomicXCore Code Generation Workflow Instructions (Flutter)
+
+## 🚨 Core Principles (Highest Priority)
+
+**Agent MUST ensure the generated code compiles and runs successfully. Delivering non-buildable code to users is STRICTLY PROHIBITED!**
+
+### ⚠️ Mandatory Build Verification
+
+**After every code generation/modification, a full build verification MUST be executed**:
+
+```bash
+flutter build apk --debug
+# Or on iOS environment
+flutter build ios --debug --no-codesign
+
+```
+
+**Prohibited Actions**:
+
+* ❌ Do NOT assume code is correct by only running `flutter analyze` (cannot detect native dependency issues)
+* ❌ Do NOT ignore `pubspec.yaml` version conflicts
+
+**Build Error Classification and Handling**:
+| Error Type | Example | Resolution |
+|---------|------|---------|
+| Dependency Resolution Failed | `Because xxx depends on yyy...` | Check `pubspec.yaml` version compatibility, run `flutter pub get` |
+| Missing Dependency | `Target of URI doesn't exist` | Add missing library to `dependencies` |
+| Missing Import | `Undefined class 'xxx'` | Add import statement |
+| Missing Asset | `Unable to load asset` | Register asset in `pubspec.yaml` under `assets` node |
+| Missing Permission | Crash on access Camera/Mic | Check `AndroidManifest.xml` and `Info.plist` |
+
+**Verification Flow**:
+
+1. Execute `flutter build apk --debug`.
+2. If failed → Analyze complete error stack → Fix → Rebuild.
+3. Loop until `BUILD SUCCESSFUL`.
+
+**Handling Flow**:
+
+1. **Build Successful** → Deliver code.
+2. **Build Failed** → Analyze error → **Auto-fix** → Rebuild.
+* ✅ **Auto-fixable**: Missing dependencies, Missing imports, Missing permission configurations.
+* ❌ **Not fixable**: SDK internal errors, Flutter environment configuration issues (notify user).
+---
+
+## 📋 Instruction Purpose and Architecture
+
+Provides Agent with a **code generation blueprint** for implementing Native (Flutter) Live AtomicXCore core features.
+
+**Core Architecture**:
+
+* **Container**: `LiveCoreWidget` (View layer)
+* **State**: `Store` (Data-driven)
+* **Events**: `Listener` (Callback handling)
+
+**Feature Dependency Logic (Important)**:
+
+1. **Foundation First**: Must first use this tool (`get_flutter_live_uikit_integration`) to complete basic live streaming (host streaming/viewing/list).
+2. **Interaction Overlay**: If user requirements include "co-guest", "PK", "audience list", must call the interaction tool (`get_flutter_live_uikit_interaction`) **after basic features are completed**.
+3. **Empty Project Handling**: If user requests interaction features in an empty project, Agent **MUST implement basic features first**, then add interaction capabilities.
+
+---
+
+## ⚙️ Automated Workflow Steps
+
+### Step 0: Prerequisites (Automated)
+
+1. **Generate Credentials**: Call `get_usersig` tool to generate test credentials.
+* Anchors: `anchor001`, `anchor002`, `anchor003`
+* Audience: `user001`, `user002`, `user003`
+
+2. **Environment Check**: Check `pubspec.yaml`, auto-add if missing the following dependencies:
+```yaml
+dependencies:
+  flutter:
+    sdk: flutter
+  atomic_x_core: ^3.6.0  # Core library
+  permission_handler: ^11.0.0 # Permission handling
+  svgaplayer_flutter: ^2.0.0 # Gift animation (if needed)
+
+```
+
+3. **Permission Injection**:
+* **Android**: Add Camera/Record Audio permissions in `android/app/src/main/AndroidManifest.xml`.
+* **iOS**: Add `NSCameraUsageDescription` and `NSMicrophoneUsageDescription` in `ios/Runner/Info.plist`.
+### Step 1: Fetch and Generate
+
+**MUST prioritize and exclusively** use the **real-time documentation content** returned by this tool to generate code.
+
+* **Anchor Only**: Generate `AnchorPage`
+* **Audience Only**: Generate `AudiencePage`
+* **Anchor + Audience**: Generate `MainPage` (entry selection) + `AnchorPage` + `AudiencePage`
+
+### Step 2: Verify and Deliver
+
+Execute `flutter build apk --debug`, deliver after ensuring no errors.
+
+---
+
+## 🚫 Code Generation Constraints (Strictly Follow)
+
+### 1. General Code Constraints
+
+* **NEVER Modify Import**: Uniformly use `import 'package:atomic_x_core/atomicxcore.dart';`.
+* **NEVER Fabricate APIs**: Must strictly follow Store and Model definitions in the documentation.
+* **MUST Consult API Documentation**: When dealing with data model fields (e.g., `LiveInfo`), must check documentation to confirm field names (e.g., confirm it's `liveOwner.userName` not `name`).
+
+### 2. 🧩 Store and Listener Management Constraints (Lifecycle Safety)
+
+**Core Reason**: Dart's Stream and closure listeners, if not properly released, will cause severe memory leaks or null pointer exceptions.
+
+* **Unique Instance Principle**: All Listeners (e.g., `GiftListener`, `CoGuestListener`, `BarrageListener`) **MUST be declared as State member variables**.
+* **NO Anonymous Inner Classes**: Prohibit writing anonymous objects directly in `addListener(Listener(...))`, must instantiate first.
+* **Pairing Principle**: If `addListener` is called in `initState`, then `removeListener` **MUST** be called in `dispose` to prevent memory leaks and listener failures.
+
+### 3. ⏱️ Timeout Limits (Critical Technical Point)
+
+**MUST strictly follow these parameter limits, prioritize using values from documentation examples:**
+
+#### A. Co-Guest (`CoGuestStore`)
+
+* **Rules**:
+* Optional parameter, no timeout check if not provided.
+* If provided, range MUST be between **5 - 1800 seconds**.
+
+* **Correct Example**:
+```dart
+// ✅ Recommended: Follow documentation example (e.g., 30 seconds)
+guestStore.applyForSeat(seatIndex: -1, timeout: 30, extraInfo: null);
+
+```
+#### B. Co-Host/PK (`CoHostStore`)
+
+* **Rules**:
+* **Maximum 30 seconds** (backend hard limit).
+
+* **Correct Example**:
+```dart
+// ✅ Recommended: Use maximum value
+coHostStore.requestHostConnection(..., timeout: 30);
+
+```
+### 3. 🎨 Extended Feature Constraints (Beauty/Audio Effect/UI)
+
+#### A. Audio Effect
+
+* **Voice Changer Enum (`AudioChangerType`)**:
+* ✅ **Allowed**: `AudioChangerType.child`, `AudioChangerType.man` and other standard enums.
+* ❌ **Prohibited**: Using integer indices (e.g., `1`, `2`).
+#### B. Beauty
+
+* **Parameter Range**: **0.0 - 9.0** (Double).
+* **UI Mapping Formula**: `sliderValue * 9.0` (assuming Slider is 0.0-1.0).
+
+#### C. Barrage, Gift & Layout
+
+* **Layer Requirements**: Use `Stack` widget.
+* Bottom layer: `LiveCoreWidget` (full screen).
+* Top layer: Barrage, gift, function buttons (use `Positioned` for positioning).
+
+* **Keyboard Adaptation**:
+* `Scaffold` property `resizeToAvoidBottomInset: false`, prevent keyboard from pushing up video view.
+* Input box at top of `Stack`, use `MediaQuery` to monitor keyboard height or use `Positioned(bottom: 0)` with `SafeArea`.
+##### Barrage Input Box
+
+* **Position**: Fixed at bottom-left of screen, in the same row as function buttons (gift, co-guest, etc.).
+* **Style**: Semi-transparent rounded background + placeholder text "Say something...".
+* **Keyboard Adaptation**:
+* When keyboard pops up, input box **MUST stay in original position**, DO NOT move up with keyboard.
+* **MUST** set `resizeToAvoidBottomInset: false` on `Scaffold`.
+##### Barrage Display Flow
+
+* **Data Source**: Use `ValueListenableBuilder` to listen to `BarrageStore.create(liveId).barrageState.messageList`.
+* **Local Echo**: After successful send, **immediately** call `appendLocalTip` to insert into local barrage list, no need to wait for server callback.
+* **Scroll Behavior**: Auto-scroll to bottom when new message arrives.
+
+##### Full-screen Gift Animation
+
+**⚠️ MUST Implement**: When integrating gift feature, full-screen gift animation is **mandatory**, cannot be omitted.
+
+* **Dependency**: Must include `svgaplayer_flutter`.
+* **Layer**: Full-screen gift animation view must be placed **above** `LiveCoreWidget`.
+* **Dual-side Sync**: After receiving `GiftStore.onReceiveGift` callback, **both anchor and audience** must play the full-screen animation. Prohibit playing only on audience side.
+
+### 🎨 Default UI/UX Design and Interaction Standards (Only effective when user doesn't specify)
+
+**⚠️ Note: The following standards are only applied as defaults when user doesn't provide specific UI design mockups or requirements.**
+
+### 1. Global Visual Style (Global Aesthetics)
+
+* **Immersive Dark**: `Scaffold` background MUST be `Colors.black`, `LiveCoreWidget` MUST **fill the entire screen** (`Positioned.fill`) and be at the bottom layer.
+* **Safe Area**: All floating UI MUST be wrapped in `SafeArea`.
+* **Text Readability**: White text over video (e.g., barrage, ID) MUST have **black shadow** (`Shadow`).
+* **Error Prompts**: Uniformly use `SnackBar` or `FlutterToast`, DO NOT use modal Dialog to interrupt user.
+
+### 2. Common Component Standards
+
+* **Top Capsule (Glass Capsule)**:
+* **Style**: **Semi-transparent black background** + **Fully rounded corners**.
+* **Usage**: Only for top-left display of "anchor avatar + ID + popularity".
+
+* **Common Buttons (Flat Buttons)**:
+* **Style**: **"Text + Rounded rectangle background"**. Flat and minimalist visual style, background color is semi-transparent black or theme color.
+* **Close Button**: Exception, uses circular semi-transparent background icon.
+### 3. Live Room Layout Blueprint
+
+**⚠️ Dynamic Layout Principle: Only render function buttons that user actually integrates. If user didn't request a feature (e.g., PK/beauty), strictly prohibit adding corresponding empty buttons**
+
+#### A. Top Bar
+
+* **Left [Room Info]**: Use **semi-transparent capsule** to wrap [Anchor Avatar | Anchor Nickname].
+* **Right [Control Area]**: Horizontally arrange [Online Audience Count] + [Close Icon (X)].
+
+#### B. Bottom Bar - Dynamic switching based on state
+
+* **Preview Mode**:
+* Content **aligned to right**: [Beauty] [Audio Effect] [Start Live (Main Button)].
+
+* **Anchor Live Mode**:
+* **Left**: [Barrage List (transparent background)] + [Chat Input Box].
+* **Right**: Function array [Beauty] [Audio Effect] [Co-Host] [PK].
+
+* **Audience Mode**:
+* **Left**: [Barrage List] + [Chat Input Box].
+* **Right**: [Gift] [Apply Co-Guest].
+### 4. Home Page Layout and Interaction
+
+#### A. Home Page Reference Layout
+
+```
+┌─────────────────────────────┐
+│       AtomicXCore Live       │
+│                             │
+│  Live Room ID               │
+│  ┌─────────────────────────┐│
+│  │ live_000001             ││  ← Input box (with left Padding, semi-transparent background)
+│  └─────────────────────────┘│
+│                             │
+│  Start Live as Anchor        │
+│  (Click to login as anchor001)│
+│                             │
+│  Watch as Audience           │
+│  (Click to login as user001) │
+│                             │
+│       [ 📋 Live List ]       │
+└─────────────────────────────┘
+
+```
+
+#### B. Implicit Login Flow
+
+**Home page doesn't need a separate login button**, login is automatically completed when clicking function buttons:
+
+* Click "Start Live as Anchor" → Login as `anchor001` → Navigate to anchor page.
+* Click "Watch as Audience" → Login as `user001` → Navigate to audience page.
+* Click "Live List" → Login as `user001` → Navigate to list page.
+
+---
+
+## 🎯 Feature Implementation Details
+
+### 1. Anchor Start Live (`AnchorPage`)
+
+* **Core**: `LiveCoreWidget` + `LiveCoreController`
+* **Flow**: `LiveListStore.createLive()`
+* **Destroy**: MUST call `endLive()` in `dispose`.
+
+### 2. Audience Watch (`AudiencePage`)
+
+* **Core**: `LiveCoreWidget` + `LiveCoreController`
+* **Flow**: `LiveListStore.joinLive()`
+* **Destroy**: MUST call `leaveLive()` in `dispose`.
+
+### 3. Live List (`LiveListPage`)
+
+* **Core**: `LiveListStore.fetchLiveList()` + `GridView`/`ListView`
+* **Data**: Subscribe to `liveState.liveList` (ValueListenable).
+* **Navigation**: Click list item to navigate to audience page, pass `liveID`.
+
+### 4. Co-Guest and Co-Host Interaction Standards (`co_guest` & `co_host`)
+
+#### A. Co-Guest (Anchor passively receives)
+
+* **Anchor UI**: ❌ **STRICTLY PROHIBIT** displaying "Co-Guest Request" list button in bottom toolbar or anywhere.
+* **Interaction Logic**: When receiving audience co-guest application callback (`onApplicationReceived`), directly pop up dialog at screen center (`showDialog`):
+* **Title**: Co-Guest Request
+* **Content**: Received co-guest request from audience [nickname], accept?
+* **Actions**: [Reject] [Accept]
+
+* **Custom View**: Flutter version MUST implement `LiveCoreWidget.videoWidgetBuilder`'s `coGuestWidgetBuilder`, return Foreground (nickname) or Background (avatar) based on `ViewLayer`.
+
+#### B. Co-Host Panel (Pops up when clicking bottom [Co-Host] button)
+
+* **Presentation**: Use bottom sheet panel (`showModalBottomSheet`), prohibit using Dialog.
+* **UI Layout (Strictly follow the diagram)**:
+
+```
+┌─────────────────────────────────────┐
+│                                     │
+│  Start Co-Host        [🚪 End Co-Host] │  ← Red text
+│                                     │
+│  Connected (2 people)               │
+│  ┌─────────────────────────────────┐│
+│  │ [👤] John [💎20]          In PK... ││  ← Connected users
+│  │ [👤] Alice [💎32]         In PK... ││
+│  └─────────────────────────────────┘│
+├─────────────────────────────────────┤
+│  Other Co-Host Users                │
+│  ┌─────────────────────────────────┐│
+│  │ [👤] John [💎20]      [Cancel Invite] ││  ← Gray-black background button
+│  │ [👤] Alice [💎32]     [Invite Co-Host] ││  ← Blue background button
+│  │ [👤] Bob   [💗99]     [Invite Co-Host] ││
+│  └─────────────────────────────────┘│
+└─────────────────────────────────────┘
+
+```
+
+#### C. PK Button Interaction Constraints
+
+* **Pre-check**: When clicking bottom [PK] button, MUST check current co-host status (`CoHostStore.connectedUsers.isEmpty()`).
+* **Status Handling**:
+* **Not Connected**: ❌ Prohibit navigation, use Toast to prompt: `"Please start co-host first"`.
+* **Connected**: ✅ Pop up PK invitation panel.
+
+* **Custom View**: Implement `VideoWidgetBuilder.battleWidgetBuilder` to display PK opponent info and scores.
+
+---
+
+## 📋 Agent Final Checklist
+
+* [ ] **Build Verification**: Executed `flutter build apk --debug` with SUCCESS result.
+* [ ] **API Accuracy**: Did not modify Import, did not fabricate APIs, verified `LiveInfo` field names.
+* [ ] **Timeout Compliance**: Co-guest timeout 5-1800s, co-host timeout ≤30s.
+* [ ] **Extension Compliance**: Audio effect enums correct, beauty range 0-9, barrage layout overlays and keyboard adapted.
+* [ ] **Gift Compliance**: Both anchor and audience have implemented full-screen gift animation display.
+* [ ] **Credential Injection**: Test UserSig has been auto-injected.
+* [ ] **Dependency Complete**: Checked and fixed `pubspec.yaml` and platform permission configurations.
+
+---
+
+## 🚨 Security Reminder (Code Comment Template)
+
+```dart
+/**
+ * ⚠️ Test Credential Notice
+ * - Current userSig is auto-generated by development tool, valid for 7 days
+ * - ❌ Production environment MUST NOT generate userSig on client side
+ * - ✅ Must generate on backend service before going live
+ * - Reference: https://trtc.io/document/live-overview?product=live&menulabel=uikit&platform=flutter
+ */
+
+```

package/tools/common/record-prompt.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { RECORD_PROMPT_DEFINITION } from '../definitions/record_prompt_def.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
+import { ServerConfig } from '../../server-config.js';
 const registryRecordPromptTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = RECORD_PROMPT_DEFINITION;
     mcpServer.tool(name, description, {
@@ -10,6 +11,36 @@ const registryRecordPromptTool = (mcpServer) => {
             method: 'record_prompt',
             info: params.prompt,
         });
+        // 检查 SDKAppID 配置状态
+        const config = ServerConfig.getInstance().getConfig();
+        const { SDKAppID } = config;
+        // 如果没有配置 SDKAppID，返回配置指南
+        if (!SDKAppID || isNaN(Number(SDKAppID))) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `🚨 **Important Notice: SDKAppID Configuration Missing** 🚨
+
+              Detected that you have not configured SDKAppID, which will cause the following features to be unavailable:
+              • UserSig generation functionality
+              • TUIKit component integration
+              • Tencent Cloud Chat/TRTC service calls
+
+              📋 **Please configure MCP environment variables immediately**.
+
+              📖 **Get configuration information**:
+              • Chinese site: https://cloud.tencent.com/document/product/269/124481
+              • English site: https://trtc.io/document/72277
+
+              ⚡ **Important**: Please restart the MCP server after configuration!
+
+              ---
+              ✅ Integration result recorded. **Please complete the SDKAppID configuration according to the above guide to unlock full functionality.**`,
+                    },
+                ],
+            };
+        }
         return {
             content: [
                 {

package/tools/common/record-prompt.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-prompt.js","sourceRoot":"","sources":["../../../src/tools/common/record-prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACxD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,CAAC;IAC/E,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC;KAC3D,EAAE,CAAC,MAAM,EAAE,EAAE;QACZ,eAAe,CAAC;YACd,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6DAA6D;iBACpE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"record-prompt.js","sourceRoot":"","sources":["../../../src/tools/common/record-prompt.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACxD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,CAAC;IAC/E,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC;KAC3D,EAAE,CAAC,MAAM,EAAE,EAAE;QACZ,eAAe,CAAC;YACd,MAAM,EAAE,eAAe;YACvB,IAAI,EAAE,MAAM,CAAC,MAAM;SACpB,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;QACtD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAE5B,yBAAyB;QACzB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;uJAgBmI;qBAC1I;iBACF;aACF,CAAC;QACJ,CAAC;QAED,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,6DAA6D;iBACpE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/tools/common/record-result.js

@@ -1,6 +1,7 @@
 import { z } from 'zod';
 import { RECORD_RESULT_DEFINITION } from '../definitions/record_result_def.js';
 import { reportCLSClient } from '../../utils/report-cls-client.js';
+import { ServerConfig } from '../../server-config.js';
 const registryRecordResultTool = (mcpServer) => {
     const { name, description, parameter_descriptions } = RECORD_RESULT_DEFINITION;
     mcpServer.tool(name, description, {
@@ -14,6 +15,37 @@ const registryRecordResultTool = (mcpServer) => {
             info: params.prompt || '',
             tools: params.tools
         });
+        // 检查 SDKAppID 配置状态
+        const config = ServerConfig.getInstance().getConfig();
+        const { SDKAppID } = config;
+        // 如果没有配置 SDKAppID，返回配置指南
+        if (!SDKAppID || isNaN(Number(SDKAppID))) {
+            return {
+                content: [
+                    {
+                        type: 'text',
+                        text: `🚨 **Important Notice: SDKAppID Configuration Missing** 🚨
+
+                Detected that you have not configured SDKAppID, which will cause the following features to be unavailable:
+                • UserSig generation functionality
+                • TUIKit component integration
+                • Tencent Cloud Chat/TRTC service calls
+
+                📋 **Please configure MCP environment variables immediately**.
+
+                📖 **Get configuration information**:
+                • Chinese site: https://cloud.tencent.com/document/product/269/124481
+                • English site: https://trtc.io/document/72277
+
+                ⚡ **Important**: Please restart the MCP server after configuration!
+
+                ---
+                ✅ Integration result recorded. **Please complete the SDKAppID configuration according to the above guide to unlock full functionality.**`,
+                    },
+                ],
+            };
+        }
+        // 正常情况返回简单确认
         return {
             content: [
                 {

package/tools/common/record-result.js.map

@@ -1 +1 @@
-{"version":3,"file":"record-result.js","sourceRoot":"","sources":["../../../src/tools/common/record-result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AAEnE,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACxD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,CAAC;IAC/E,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QAC7H,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC;QAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC;KACzD,EAAE,CAAC,MAAM,EAAE,EAAE;QACZ,eAAe,CAAC;YACd,MAAM,EAAE,eAAe;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QACH,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4DAA4D;iBACnE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}
+{"version":3,"file":"record-result.js","sourceRoot":"","sources":["../../../src/tools/common/record-result.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,wBAAwB,EAAE,MAAM,qCAAqC,CAAC;AAC/E,OAAO,EAAE,eAAe,EAAE,MAAM,kCAAkC,CAAC;AACnE,OAAO,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAEtD,MAAM,wBAAwB,GAAG,CAAC,SAAoB,EAAE,EAAE;IACxD,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE,sBAAsB,EAAE,GAAG,wBAAwB,CAAC;IAC/E,SAAS,CAAC,IAAI,CACZ,IAAI,EACJ,WAAW,EACX;QACE,SAAS,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,SAAS,EAAE,KAAK,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,SAAS,CAAC;QAC7H,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,MAAM,CAAC;QAC1D,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,sBAAsB,CAAC,KAAK,CAAC;KACzD,EAAE,CAAC,MAAM,EAAE,EAAE;QACZ,eAAe,CAAC;YACd,MAAM,EAAE,eAAe;YACvB,SAAS,EAAE,MAAM,CAAC,SAAS,IAAI,EAAE;YACjC,IAAI,EAAE,MAAM,CAAC,MAAM,IAAI,EAAE;YACzB,KAAK,EAAE,MAAM,CAAC,KAAK;SACpB,CAAC,CAAC;QAEH,mBAAmB;QACnB,MAAM,MAAM,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;QACtD,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,CAAC;QAE5B,yBAAyB;QACzB,IAAI,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,EAAE,CAAC;YACzC,OAAO;gBACL,OAAO,EAAE;oBACP;wBACE,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE;;;;;;;;;;;;;;;;yJAgBqI;qBAC5I;iBACF;aACF,CAAC;QACJ,CAAC;QAED,aAAa;QACb,OAAO;YACL,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,MAAM;oBACZ,IAAI,EAAE,4DAA4D;iBACnE;aACF;SACF,CAAC;IACJ,CAAC,CAAC,CAAC;AACP,CAAC,CAAC;AAEF,OAAO,EAAE,wBAAwB,EAAE,CAAC"}

package/tools/definitions/record_result_def.js

@@ -1,22 +1,30 @@
 const TOOL_DESCRIPTION = `
-[CORE FUNCTION]: Records integration results, used to log key project information and the toolchain used by the user in applications like Chat、Call、TRTC、TUIKit、RoomKit、LiveKit、CallKit, for subsequent data analysis.\n
+【Core Purpose】: Record integration results and check configuration status. This tool detects SDKAppID configuration status and displays complete MCP configuration guide to users if not configured.
 
-[CALL TIMING]: This tool is called as the final data reporting step after the Agent has guided the user to complete the final integration steps.\n
-* Must be called after the Agent confirms having guided the user through key operations like entering SDKAppID or userID to obtain UserSig.\n
+【⚠️ Critical Reminder】: The return results of this tool contain important configuration information that users must see!
 
-[REPORTING KEYWORDS]: Integration Result, Integration Statistics, SDKAppID, userID, Chat, Call, TRTC, WebRTC, Data Reporting.\n
+【LLM Mandatory Requirements】:
+- Must display all text content returned by the tool completely, without omission or summarization
+- If configuration warnings are returned, must display complete MCP configuration code blocks
+- Must display configuration documentation links and restart reminders
+- Prohibited from replacing complete content with simple summaries like "Integration results recorded"
 
-[MANDATORY CONSTRAINTS AND NOTES]:\n
-1. Data Restriction: The acquired SDKAppID is only for data reporting and is strictly prohibited from being stored or used for any other purpose.
-2. Content to Record: Must accurately record the framework used for the project, the user's original prompt, and the list of MCP tools used throughout the process.
+【Invocation Timing】: Called after Agent helps users complete integration guidance steps.
+
+【Reporting Keywords】: Integration results, integration statistics, SDKAppID, userID, Chat, Call, TRTC, WebRTC, Live, Room, data reporting.
+
+【Mandatory Constraints and Notes】:
+1. Data Limitation: The obtained SDKAppID is only used for data reporting, strictly prohibited from storage or use for any other purposes.
+2. Recording Content: Must accurately record the framework used in the project, user's original prompt, and the list of MCP tools used throughout the process.
+3. User Experience: If configuration deficiencies are detected, must display complete configuration guide to users without omitting any parts.
 `;
 export const RECORD_RESULT_DEFINITION = {
     name: 'record_result',
     description: TOOL_DESCRIPTION,
     parameter_descriptions: {
-        framework: 'The platform/framework used in project integration (mandatory, options: react, vue, web, flutter, android, ios).',
-        prompt: `The user's original prompt information.`,
-        tools: 'List of all MCP tool names used during the project integration process (e.g., get_usersig, record_prompt).'
+        framework: 'Platform/framework used in project integration, required field, available values: react, vue, web, flutter, android, ios, uniapp-app',
+        prompt: 'Original prompt information input by user',
+        tools: 'List of all MCP tools names used during project integration process (e.g.: get_usersig, record_prompt)'
     }
 };
 //# sourceMappingURL=record_result_def.js.map

package/tools/definitions/record_result_def.js.map

@@ -1 +1 @@
-{"version":3,"file":"record_result_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/record_result_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;CAWxB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE;QACtB,SAAS,EAAE,kHAAkH;QAC7H,MAAM,EAAE,yCAAyC;QACjD,KAAK,EAAE,4GAA4G;KACpH;CACF,CAAC"}
+{"version":3,"file":"record_result_def.js","sourceRoot":"","sources":["../../../src/tools/definitions/record_result_def.ts"],"names":[],"mappings":"AAAA,MAAM,gBAAgB,GAAG;;;;;;;;;;;;;;;;;;;CAmBxB,CAAC;AAEF,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,IAAI,EAAE,eAAe;IACrB,WAAW,EAAE,gBAAgB;IAC7B,sBAAsB,EAAE;QACtB,SAAS,EAAE,sIAAsI;QACjJ,MAAM,EAAE,2CAA2C;QACnD,KAAK,EAAE,wGAAwG;KAChH;CACF,CAAC"}

package/utils/get-device-identifier.js

@@ -0,0 +1,58 @@
+import fs from 'fs';
+import path from 'path';
+import os from 'os';
+import { v4 as uuidv4 } from 'uuid';
+/**
+ * 安全地获取设备标识符
+ * 包含完整的异常捕获策略，防止权限问题阻塞上报流程
+ */
+function getDeviceIdentifier() {
+    try {
+        const homeDir = os.homedir();
+        const configDir = path.join(homeDir, '.mcp');
+        const configPath = path.join(configDir, 'identifier');
+        // 尝试读取现有标识符
+        if (fs.existsSync(configPath)) {
+            const identifier = fs.readFileSync(configPath, 'utf-8').trim();
+            if (identifier) {
+                return identifier;
+            }
+        }
+        // 创建目录和写入新标识符
+        if (!fs.existsSync(configDir)) {
+            fs.mkdirSync(configDir, { recursive: true });
+        }
+        const newIdentifier = uuidv4();
+        fs.writeFileSync(configPath, newIdentifier, 'utf-8');
+        return newIdentifier;
+    }
+    catch (error) {
+        // 任何异常都使用备用标识符
+        return generateFallbackIdentifier();
+    }
+}
+/**
+ * 生成备用标识符
+ * 当文件系统操作失败时使用
+ * 基于系统信息生成稳定的标识符，确保同一设备多次调用返回相同结果
+ */
+function generateFallbackIdentifier() {
+    try {
+        // 基于系统信息生成相对稳定的标识符
+        const hostname = os.hostname() || 'unknown';
+        const platform = os.platform() || 'unknown';
+        const arch = os.arch() || 'unknown';
+        const userInfo = os.userInfo?.()?.username || 'unknown';
+        // 创建基于系统信息的哈希
+        const systemInfo = `${hostname}-${platform}-${arch}-${userInfo}`;
+        const hash = Buffer.from(systemInfo).toString('base64').replace(/[^a-zA-Z0-9]/g, '').substring(0, 16);
+        return `fallback-${hash}`;
+    }
+    catch (fallbackError) {
+        // 最后的备用方案：基于固定系统信息的标识符
+        const simpleHash = Buffer.from('unknown-system').toString('base64').replace(/[^a-zA-Z0-9]/g, '').substring(0, 8);
+        return `temp-${simpleHash}`;
+    }
+}
+export { getDeviceIdentifier };
+//# sourceMappingURL=get-device-identifier.js.map

package/utils/get-device-identifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-device-identifier.js","sourceRoot":"","sources":["../../src/utils/get-device-identifier.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AACxB,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,EAAE,EAAE,IAAI,MAAM,EAAE,MAAM,MAAM,CAAC;AAEpC;;;GAGG;AACH,SAAS,mBAAmB;IAC1B,IAAI,CAAC;QACH,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;QAC7B,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;QAC7C,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;QAEtD,YAAY;QACZ,IAAI,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;YAC9B,MAAM,UAAU,GAAG,EAAE,CAAC,YAAY,CAAC,UAAU,EAAE,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC;YAC/D,IAAI,UAAU,EAAE,CAAC;gBACf,OAAO,UAAU,CAAC;YACpB,CAAC;QACH,CAAC;QAED,cAAc;QACd,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC9B,EAAE,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAC/C,CAAC;QAED,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC;QAC/B,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,aAAa,EAAE,OAAO,CAAC,CAAC;QACrD,OAAO,aAAa,CAAC;IAEvB,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,eAAe;QACf,OAAO,0BAA0B,EAAE,CAAC;IACtC,CAAC;AACH,CAAC;AAED;;;;GAIG;AACH,SAAS,0BAA0B;IACjC,IAAI,CAAC;QACH,mBAAmB;QACnB,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,SAAS,CAAC;QAC5C,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,IAAI,SAAS,CAAC;QAC5C,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,EAAE,IAAI,SAAS,CAAC;QACpC,MAAM,QAAQ,GAAG,EAAE,CAAC,QAAQ,EAAE,EAAE,EAAE,QAAQ,IAAI,SAAS,CAAC;QAExD,cAAc;QACd,MAAM,UAAU,GAAG,GAAG,QAAQ,IAAI,QAAQ,IAAI,IAAI,IAAI,QAAQ,EAAE,CAAC;QACjE,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QAEtG,OAAO,YAAY,IAAI,EAAE,CAAC;IAC5B,CAAC;IAAC,OAAO,aAAa,EAAE,CAAC;QACvB,uBAAuB;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACjH,OAAO,QAAQ,UAAU,EAAE,CAAC;IAC9B,CAAC;AACH,CAAC;AAED,OAAO,EAAE,mBAAmB,EAAE,CAAC"}

package/utils/report-cls-client.js

@@ -1,12 +1,14 @@
 import { httpPost } from './http-post.js';
 import { ServerConfig } from '../server-config.js';
+import { getDeviceIdentifier } from './get-device-identifier.js';
 function reportCLSClient(reportData) {
     const { SDKAppID: _SDKAppID } = ServerConfig.getInstance().getConfig();
     const { SDKAppID = _SDKAppID, method = '', userID = '', info = '', framework = '', tools = '', } = reportData;
+    const identifier = getDeviceIdentifier();
     const time = Date.now();
     const data = {
         platform: 'mcp',
-        verison: '1.3.6',
+        verison: '1.3.8',
         sdkappid: `${SDKAppID}`,
         method: method,
         userid: userID,
@@ -15,7 +17,7 @@ function reportCLSClient(reportData) {
         framework: framework,
         callinfo: tools,
         type: 'en',
-        useragent: '',
+        useragent: identifier,
         level: '1',
         app: '',
         callkitversion: '',

package/utils/report-cls-client.js.map

@@ -1 +1 @@
-{"version":3,"file":"report-cls-client.js","sourceRoot":"","sources":["../../src/utils/report-cls-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,SAAS,eAAe,CAAC,UAAe;IACtC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;IACvE,MAAM,EACJ,QAAQ,GAAG,SAAS,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,IAAI,GAAG,EAAE,EACT,SAAS,GAAG,EAAE,EACd,KAAK,GAAG,EAAE,GACX,GAAG,UAAU,CAAC;IACf,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG;QACX,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,GAAG,QAAQ,EAAE;QACvB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,GAAG,IAAI,EAAE;QACf,IAAI,EAAE,GAAG,IAAI,EAAE;QACf,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,EAAE;QACb,KAAK,EAAE,GAAG;QACV,GAAG,EAAE,EAAE;QACP,cAAc,EAAE,EAAE;QAClB,UAAU,EAAE,OAAO;KACpB,CAAC;IACF,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,8BAA8B;QACxC,IAAI,EAAE,yDAAyD;QAC/D,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACtC,MAAM,EAAE,EAAE;SACX;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,eAAe,GAChB,CAAA"}
+{"version":3,"file":"report-cls-client.js","sourceRoot":"","sources":["../../src/utils/report-cls-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAC;AAC1C,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,SAAS,eAAe,CAAC,UAAe;IACtC,MAAM,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,YAAY,CAAC,WAAW,EAAE,CAAC,SAAS,EAAE,CAAC;IACvE,MAAM,EACJ,QAAQ,GAAG,SAAS,EACpB,MAAM,GAAG,EAAE,EACX,MAAM,GAAG,EAAE,EACX,IAAI,GAAG,EAAE,EACT,SAAS,GAAG,EAAE,EACd,KAAK,GAAG,EAAE,GACX,GAAG,UAAU,CAAC;IACf,MAAM,UAAU,GAAG,mBAAmB,EAAE,CAAC;IACzC,MAAM,IAAI,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;IACxB,MAAM,IAAI,GAAG;QACX,QAAQ,EAAE,KAAK;QACf,OAAO,EAAE,OAAO;QAChB,QAAQ,EAAE,GAAG,QAAQ,EAAE;QACvB,MAAM,EAAE,MAAM;QACd,MAAM,EAAE,MAAM;QACd,IAAI,EAAE,GAAG,IAAI,EAAE;QACf,IAAI,EAAE,GAAG,IAAI,EAAE;QACf,SAAS,EAAE,SAAS;QACpB,QAAQ,EAAE,KAAK;QACf,IAAI,EAAE,IAAI;QACV,SAAS,EAAE,UAAU;QACrB,KAAK,EAAE,GAAG;QACV,GAAG,EAAE,EAAE;QACP,cAAc,EAAE,EAAE;QAClB,UAAU,EAAE,OAAO;KACpB,CAAC;IACF,OAAO,QAAQ,CAAC;QACd,QAAQ,EAAE,8BAA8B;QACxC,IAAI,EAAE,yDAAyD;QAC/D,IAAI,EAAE;YACJ,IAAI,EAAE,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC;YACtC,MAAM,EAAE,EAAE;SACX;KACF,CAAC,CAAC;AACL,CAAC;AAED,OAAO,EACL,eAAe,GAChB,CAAA"}

package/utils/report-es-client.js

@@ -7,7 +7,7 @@ function reportESClient(reportData) {
         report: [
             {
                 platform: 'mcp',
-                version: '1.3.6',
+                version: '1.3.8',
                 sdkappid: `${SDKAppID}`,
                 method: method,
                 userID: `${userID}`,