@tencentcloud/sdk-mcp 1.7.5 → 1.7.6

package/tools/definitions/get_native_chat_uikit_integration_def.js

@@ -1,28 +1,37 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回 Native Chat UIKit 集成文档，供 AI 完成移动端 IM 应用接入或聊天窗口接入。
+Purpose:
+Return Native Chat UIKit integration docs for explicit codegen implementation.
 
-典型适用问题：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Native Chat UIKit integration documentation for mobile IM app integration or chat-window embedding.
+
+Common trigger lexicon:
 Native Chat UIKit, TUIKit, IM, 聊天, 会话列表, 聊天窗口, Flutter, Android, iOS, full-featured, chat-only, 客服, 问诊
 
-输入：
+Inputs:
 - framework: flutter | android | ios
 - goals: [full-featured] | [chat-only]
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
-- 面向 Native Chat UIKit 整体集成，不负责平台选择或单功能深挖
+Boundaries:
+- If platform/framework is not specified, call 'present_framework_choice' first.
+- Targets end-to-end Native Chat UIKit integration, not platform selection or deep single-feature exploration.
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：flutter | android | ios。android/ios 为 codegen 主路径（Compose / SwiftUI）；View/UIKit 集成查阅请用 search_trtc_knowledge。',
-    goals: '功能目标数组。仅允许传一个值，可选值：full-featured（完整应用）| chat-only（单聊天窗口）。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    framework: 'Target platform. Parameter name must be framework (not platform). Allowed values: flutter | android | ios. Android/iOS are primary codegen paths (Compose/SwiftUI). For View/UIKit integration reference, use search_trtc_knowledge.',
+    goals: 'Goal list. Exactly one value is allowed: full-featured | chat-only.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_NATIVE_CHAT_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_native_chat_uikit_integration',

package/tools/definitions/get_native_live_uikit_integration_def.js

@@ -1,35 +1,44 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回基于 TUILiveKit 预制 UI 组件的 Native 视频直播集成文档，供 AI 完成移动端（Android / iOS）视频直播的开箱即用界面接入与代码生成。覆盖直播列表页（观众入口）、主播开播页、观众观看页，均为含完整交互 UI 与业务逻辑的预制组件（如 AnchorPrepareView、直播列表瀑布流视图等）。
+Purpose:
+Return Native TUILiveKit preset integration docs for explicit codegen implementation.
 
-典型适用问题（共用触发词，可能同时命中 'get_native_livekit_core_integration' Core 工具）：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Native video-live integration documentation based on TUILiveKit preset UI components, for mobile (Android/iOS) runnable code generation and integration. Coverage includes live list (audience entry), host streaming page, and audience viewing page with complete preset UI interactions and business flow.
+
+Common trigger lexicon (may overlap with 'get_native_livekit_core_integration' Core tool):
 集成 LiveKit, 接入 TUILiveKit, 视频直播, 直播开播, 主播开播, 观众观看, 直播列表, 开播页, 观看页, 直播间列表, Android, iOS
-命中以上共用触发词时，请**先主动追问用户**："您希望使用默认直播界面快速集成（TUILiveKit preset），还是基于 Core SDK / AtomicXCore 自定义直播界面？" 用户选择"默认/preset"后再调用本工具；选择"自定义/Core"则调用 'get_native_livekit_core_integration'。
+When only common triggers are hit, ask a clarification first: "Do you prefer preset default live UI (TUILiveKit) or custom live UI based on Core SDK/AtomicXCore?" Call this tool only after user chooses preset/default; if user chooses custom/Core, call 'get_native_livekit_core_integration'.
 
-典型适用问题（preset 专属触发词，仅命中本工具，无需追问，直接调用）：
+Preset-only trigger lexicon (direct call, no clarification needed):
 TUILiveKit, Native TUILiveKit, Native Live UIKit, preset, preset 集成, 预制 UI, 预制开播页, 预制观看页, 预制直播列表, 默认直播界面, 开箱即用直播界面, 现成的开播页面, 直播界面已经有了, TUILiveKit Android, TUILiveKit iOS, AnchorPrepareView
 
-输入：
+Inputs:
 - framework: android | ios
-- goals: 功能模块列表（可多选，返回时按 直播列表→开播→观看 顺序组织）
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
-
-返回：
-- content: [{ type: 'text', text: 文档正文（含各平台通用的环境准备/依赖接入 + 所选功能页的集成步骤与代码）}]
-
-边界：
-- 仅面向**视频直播（live）**场景。语聊房（voice / 语聊 / 音频房 / 麦位）**不在本工具范围**，如遇该需求请改用 'get_native_livekit_core_integration' 或告知用户暂不支持预制 UI
-- framework 仅支持 android | ios（TUILiveKit 视频直播预制 UI 暂无 flutter / uni-app 端文档，如遇该需求请改用 'get_native_livekit_core_integration' 或告知用户暂不支持）
-- 当用户未明确平台时，应先调用 'present_framework_choice'
-- 当用户已明示「自定义 UI」「Core SDK」「AtomicXCore」「LiveCoreView」「自己画直播页面」等 Core 专属触发词时，直接调用 'get_native_livekit_core_integration'，不要走本工具
-- 面向主播开播 / 观众观看 / 直播列表整体页面集成，不负责连麦、PK、礼物、弹幕、美颜、音效等单功能扩展（这些请使用 'search_trtc_knowledge'）
+- goals: Feature module list (multi-select allowed; output is organized in order: live list -> host streaming -> audience viewing).
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
+
+Outputs:
+- content: [{ type: 'text', text: Documentation body (including platform-common setup/dependency steps plus integration steps and code for selected pages) }]
+
+Boundaries:
+- This tool is only for **video live (live)** scenario. Voice-room needs are out of scope; use 'get_native_livekit_core_integration' instead.
+- framework supports android | ios only. There is no preset TUILiveKit doc for flutter/uni-app; for those needs, use 'get_native_livekit_core_integration'.
+- If platform is missing, call 'present_framework_choice' first.
+- If user explicitly indicates Core intent (e.g. custom UI / Core SDK / AtomicXCore / LiveCoreView / self-built live page), call 'get_native_livekit_core_integration' directly.
+- Targets end-to-end pages (host streaming / audience viewing / live list), not single-feature extensions such as co-host, PK, gifts, danmaku, beauty, or audio effects (use 'search_trtc_knowledge' for those).
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios。',
-    goals: '功能列表（可多选）。可选值：live_list（直播列表页，观众入口）| host_streaming（主播开播页）| audience_streaming（观众观看页）。做完整移动端直播 App 通常需要 live_list + host_streaming + audience_streaming。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    framework: 'Target platform. Parameter name must be framework (not platform). Allowed values: android | ios.',
+    goals: 'Goal list (multi-select). Allowed values: live_list | host_streaming | audience_streaming. A complete mobile live app usually includes all three goals.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_NATIVE_LIVE_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_native_live_uikit_integration',

package/tools/definitions/get_native_livekit_core_integration_def.js

@@ -1,31 +1,40 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回基于 AtomicXCore SDK 的 Native LiveKit Core 基础集成文档，适合实现视频直播或语聊房的开播、观看和房间列表。视频直播场景重点覆盖主播开播、观众观看、直播列表；语聊房场景重点覆盖房主开房、听众进房、语聊房列表。
+Purpose:
+Return Native LiveKit Core integration docs for explicit codegen implementation.
 
-典型适用问题：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Native LiveKit Core integration documentation based on AtomicXCore SDK, for implementing host start, audience viewing, and room list in video live or voice-room scenarios.
+
+Common trigger lexicon:
 Native LiveKit Core, AtomicXCore, 无 UI SDK, Core SDK, 视频直播, 语聊房, 开播, 观看, 房间列表, Android, iOS, Flutter, uni-app, live, voice
 
-输入：
+Inputs:
 - scenario: live | voice
 - framework: android | ios | flutter | uni-app
-- goals: 功能模块列表
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- goals: Feature module list
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
-- 面向基于 AtomicXCore SDK 的视频直播或语聊房基础集成主路径，不负责连麦、PK、成员列表、美颜、音效、弹幕、礼物等功能扩展
-- 返回的是 Core/Store 级基础集成文档，不是完整预制 UIKit 页面模板
+Boundaries:
+- If platform/framework is not specified, call 'present_framework_choice' first.
+- Targets baseline integration path for video live or voice room on AtomicXCore SDK, not feature extensions such as co-host, PK, member list, beauty, audio effects, danmaku, or gifts.
+- Returns Core/Store-level baseline integration docs, not complete preset UIKit page templates.
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    scenario: '场景类型。可选值：live（视频直播）| voice（语聊房）。当需求是开播、观看、房间列表时使用 integration；当需求是连麦、PK、成员列表、美颜、音效、弹幕、礼物时请改用 search_trtc_knowledge 检索。',
-    framework: '目标平台。参数名固定为 framework，禁止传 platform。可选值：android | ios | flutter | uni-app。',
-    goals: '功能列表。可选值：host_streaming（主播/房主开播）| audience_streaming（观众/听众观看）| live_list（房间列表）。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    scenario: 'Scenario type. Allowed values: live | voice. Use this integration tool for host start / audience viewing / room list; for feature extensions (co-host, PK, member list, beauty, audio effects, danmaku, gifts), use search_trtc_knowledge.',
+    framework: 'Target platform. Parameter name must be framework (not platform). Allowed values: android | ios | flutter | uni-app.',
+    goals: 'Goals list. Allowed values: host_streaming | audience_streaming | live_list.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_NATIVE_LIVEKIT_CORE_INTEGRATION_DEFINITION = {
     name: 'get_native_livekit_core_integration',

package/tools/definitions/get_usersig_def.js

@@ -1,26 +1,33 @@
 const TOOL_DESCRIPTION = `
-用途：
-使用 MCP 环境变量中的 SDKAppID 和 secretKey 生成测试用 userSig，供 IM 或 TRTC 本地联调使用。
+Purpose:
+Generate a test userSig using SDKAppID and secretKey from MCP environment variables, for IM/TRTC local debugging.
 
-典型适用问题：
-为指定 userID 生成 userSig, 生成测试凭证, 本地联调凭证, userID 对应的 userSig, SDKAppID, secretKey, IM, TRTC, 登录凭证
+When to call (MUST):
+- User explicitly asks to generate userSig for a specific userID.
+- User needs a test credential for IM/TRTC local integration debugging.
 
-输入：
+When NOT to call:
+- User asks about userSig principles, production signing architecture, or security design.
+- User does not provide a concrete userID yet.
+
+Common trigger lexicon:
+- 生成 userSig, 测试凭证, 本地联调凭证, userID 对应 userSig, IM 登录凭证, TRTC 登录凭证
+
+Inputs:
 - userID
 
-返回：
-- content: [{ type: 'text', text: userSig 结果或错误说明 }]
+Outputs:
+- content: [{ type: 'text', text: userSig result or error details }]
 
-边界：
-- 面向已明确 userID 的测试凭证生成，不负责解释 userSig 原理、签发流程或生产鉴权方案
-- 仅用于开发测试
-- 生产环境应改为服务端签发
-- 如果环境变量缺失，需先补齐配置
+Boundaries:
+- This tool is for test credential generation only.
+- Production should use server-side signing.
+- If required environment variables are missing, return configuration guidance.
 `;
 export const GET_USERSIG_DEFINITION = {
     name: 'get_usersig',
     description: TOOL_DESCRIPTION,
     parameter_descriptions: {
-        userID: '登录腾讯云应用的 userID',
+        userID: 'Target userID for Tencent Cloud app login.',
     },
 };

package/tools/definitions/get_web_call_uikit_integration_def.js

@@ -1,26 +1,35 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回 Web TUICallKit preset 集成文档，适合实现 PC/H5 音视频通话应用。
+Purpose:
+Return Web TUICallKit preset integration docs for explicit codegen implementation.
 
-典型适用问题：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Web TUICallKit preset integration documentation for PC/H5 audio-video calling applications.
+
+Common trigger lexicon:
 Web Call UIKit, Web TUICallKit, TUICallKit, preset 集成, React, Vue, PC, H5, 音视频通话, 视频通话, 语音通话, 集成, 呼叫, 接听
 
-输入：
+Inputs:
 - framework: react | vue
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
-- 面向 Web CallKit preset 整体集成，不负责 API 细节或交互式框架选择
+Boundaries:
+- If platform/framework is not specified, call 'present_framework_choice' first.
+- Targets end-to-end Web CallKit preset integration, not API-level details or interactive framework selection.
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '目标框架。参数名固定为 framework，禁止传 platform。可选值：react | vue。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    framework: 'Target framework. Parameter name must be framework (not platform). Allowed values: react | vue.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_WEB_CALL_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_web_call_uikit_integration',

package/tools/definitions/get_web_chat_uikit_integration_def.js

@@ -1,28 +1,37 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回 Web Chat UIKit 集成文档，适合实现完整聊天应用或单聊天窗口接入。
+Purpose:
+Return Web Chat UIKit integration docs for explicit codegen implementation.
 
-典型适用问题：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Web Chat UIKit integration documentation for full-featured chat app or chat-only widget embedding.
+
+Common trigger lexicon:
 Web Chat UIKit, TUIKit, IM, 聊天, 会话列表, 聊天窗口, React, Vue, full-featured, chat-only, 客服, 问诊, 消息入口
 
-输入：
+Inputs:
 - framework: react | vue
 - goals: [full-featured] | [chat-only]
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
-- 面向 Web Chat UIKit 整体集成，不负责组件级细节或交互式框架选择
+Boundaries:
+- If platform/framework is not specified, call 'present_framework_choice' first.
+- Targets end-to-end Web Chat UIKit integration, not component-level details or interactive framework selection.
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '目标框架。参数名固定为 framework，禁止传 platform。可选值：react | vue。',
-    goals: '功能目标数组。仅允许传一个值，可选值：full-featured（完整应用）| chat-only（单聊天窗口）。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    framework: 'Target framework. Parameter name must be framework (not platform). Allowed values: react | vue.',
+    goals: 'Goal list. Exactly one value is allowed: full-featured | chat-only.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_WEB_CHAT_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_web_chat_uikit_integration',

package/tools/definitions/get_web_live_uikit_integration_def.js

@@ -1,25 +1,34 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回 Web Live UIKit 页面级集成文档，适合接入直播列表页、观看页、开播页和连麦入口页。
+Purpose:
+Return Web Live UIKit integration docs for explicit codegen implementation.
 
-典型适用问题：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Web Live UIKit page-level integration documentation for live list, player, pusher, and co-guest entry pages.
+
+Common trigger lexicon:
 Web Live UIKit, TUILiveUIKit, Vue, 页面级集成, 页面接入, 列表页, 观看页, 开播页, liveList, livePlayer-desk, livePlayer-h5, livePusher
 
-输入：
-- goals: 功能列表
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+Inputs:
+- goals: Feature list
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 当前主要面向 Web Vue 页面级接入，不负责 State API 字段方法或单组件详解
+Boundaries:
+- Primarily targets Web Vue page-level integration, not State API field/method deep dives or single-component details.
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    goals: '功能列表。可选值：liveList | livePlayer-desk | livePlayer-h5 | livePusher。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    goals: 'Goals list. Allowed values: liveList | livePlayer-desk | livePlayer-h5 | livePusher。',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_WEB_LIVE_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_web_live_uikit_integration',

package/tools/definitions/get_web_room_core_integration_def.js

@@ -1,40 +1,49 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回 Web RoomKit Atomicx Core 基础集成文档，适合基于 Atomicx API 自实现会议室（无预制 UI），完成登录、房间状态与设备能力接入。
+Purpose:
+Return Web RoomKit Atomicx Core integration docs for explicit codegen implementation.
 
-典型适用问题（共用触发词，可能同时命中 'get_web_room_uikit_integration' preset 工具）：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Web RoomKit Atomicx Core integration documentation for custom meeting-room implementation (no preset UI), including login, room state, and device capabilities.
+
+Common trigger lexicon (may overlap with 'get_web_room_uikit_integration' preset tool):
 Web RoomKit, TUIRoomKit, Atomicx, Vue, 集成 RoomKit, 接入会议, 会议室, meeting, room
-命中以上共用触发词时，请**先主动追问用户**："您希望使用预制 UI 快速集成（TUIRoomUIKit preset），还是基于 Atomicx API 自实现会议室？" 用户选择"自实现/Atomicx/Core"后再调用本工具；选择"预制/preset/默认 UI"则调用 'get_web_room_uikit_integration'。
+When only common triggers are hit, ask a clarification first: "Do you prefer preset UI (TUIRoomUIKit) or custom room implementation with Atomicx API?" Call this tool only after user chooses custom/Atomicx/Core; otherwise call 'get_web_room_uikit_integration'.
 
-典型适用问题（Core 专属触发词，仅命中本工具，无需追问，直接调用）：
+Core-only trigger lexicon (direct call, no clarification needed):
 Atomicx API, 自实现会议室, 自定义会议 UI, 不用预制 UI, useRoomState, useDeviceState, useLoginState, room-state, device-state, device-detection
 
-输入：
+Inputs:
 - framework: vue
 - goals: room-state | device-detection | device-state
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 当用户未明确平台或框架时，应先调用 'present_framework_choice'
-- 面向 Atomicx Core 基础接入（登录 + room-state / device 模块），不负责预制 UI 页面模板
-- 屏幕分享、虚拟背景、预约会议等扩展模块 → 调用 \`search_trtc_knowledge(types=[feature])\`
-- **登录约束**：必须调用 \`get_usersig\` 获取 UserSig，再使用 \`useLoginState.login\` 登录；**禁止**在项目内实现 UserSig 生成（如 GenerateTestUserSig）
+Boundaries:
+- If platform/framework is not specified, call 'present_framework_choice' first.
+- Targets Atomicx Core baseline integration (login + room-state/device modules), not preset UI page templates.
+- For extended modules such as screen sharing, virtual background, or scheduled meeting, call \`search_trtc_knowledge(types=[feature])\`.
+- **Login constraint**: MUST call \`get_usersig\` to obtain UserSig, then use \`useLoginState.login\`; DO NOT implement local UserSig generation in project (e.g. GenerateTestUserSig).
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '目标框架。参数名固定为 framework，禁止传 platform。固定值：vue。',
-    goals: '功能列表。可选值：room-state（房间状态）| device-detection（设备检测）| device-state（设备状态）。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    framework: 'Target framework. Parameter name must be framework (not platform). Fixed value: vue.',
+    goals: 'Goals list. Allowed values: room-state | device-detection | device-state.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
-const ANTI_HALLUCINATION_HEADER = `本文档基于 Atomicx Core API 自实现方案，严禁照搬 TUIRoomUIKit 预制 UI 组件。\n\n`;
+const ANTI_HALLUCINATION_HEADER = `This document is based on Atomicx Core API custom implementation. DO NOT copy preset TUIRoomUIKit UI components as-is.\n\n`;
 const ANTI_HALLUCINATION_CONSTRAINT = `
 ---
-【AI 代码生成约束 - Atomicx Core 方案】
-请严格基于文档内容生成代码。登录流程 MUST 调用 get_usersig 工具获取 UserSig，再使用 useLoginState.login；禁止在项目中实现 GenerateTestUserSig 或本地 UserSig 签发逻辑。
+[AI Code Generation Constraints - Atomicx Core]
+Generate code strictly based on documented content. Login flow MUST call get_usersig to obtain UserSig, then use useLoginState.login. DO NOT implement GenerateTestUserSig or local UserSig signing logic in project.
 ---
 `;
 export const GET_WEB_ROOM_CORE_INTEGRATION_DEFINITION = {

package/tools/definitions/get_web_room_uikit_integration_def.js

@@ -1,26 +1,35 @@
 import { INTEGRATION_BOUNDARY_SUFFIX } from './integration-boundary.js';
 const TOOL_DESCRIPTION = `
-用途：
-返回 Web Room UIKit 预制 UI 集成文档，适合接入会议入口页、会议室页面和默认会议应用方案。
+Purpose:
+Return Web Room UIKit preset integration docs for explicit codegen implementation.
 
-典型适用问题：
+When to call (MUST):
+- User explicitly asks for runnable project integration code or concrete implementation steps.
+
+When NOT to call:
+- Pure feature Q&A, documentation lookup, API/component explanation, troubleshooting.
+
+Scope details:
+Returns Web Room UIKit preset integration documentation for meeting entry page, meeting room page, and default meeting app setup.
+
+Common trigger lexicon:
 Web Room UIKit, TUIRoomUIKit, Atomicx, Vue, 预制 UI, 默认会议方案, meeting app, home.vue, room.vue, 会议入口页, 会议室页面, H5 会议, PC 会议, 集成
 
-输入：
+Inputs:
 - framework: vue
-- prompt: 用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要
+- prompt: Original user question. Keep full context; do not compress into keyword summary.
 
-返回：
-- content: [{ type: 'text', text: 文档正文或说明文本 }]
+Outputs:
+- content: [{ type: 'text', text: Documentation body or explanatory text }]
 
-边界：
-- 面向预制 UI 主接入，不负责 Atomicx API 或单功能模块的自定义实现细节
-- 用户要自实现 Atomicx 会议室 → 调用 'get_web_room_core_integration'
+Boundaries:
+- Targets preset UI primary integration, not Atomicx API-level or single-module custom implementation details.
+- If user wants custom Atomicx meeting-room implementation, call 'get_web_room_core_integration'.
 ${INTEGRATION_BOUNDARY_SUFFIX}
 `;
 const PARAMETER_DESCRIPTIONS = {
-    framework: '目标框架。参数名固定为 framework，禁止传 platform。固定值：vue。',
-    prompt: '用户的原始问题全文，保留完整上下文，不要压缩成关键词摘要。',
+    framework: 'Target framework. Parameter name must be framework (not platform). Fixed value: vue.',
+    prompt: 'Original user question. Keep full context; do not compress into keyword summary.',
 };
 export const GET_WEB_ROOM_UIKIT_INTEGRATION_DEFINITION = {
     name: 'get_web_room_uikit_integration',

package/tools/definitions/integration-boundary.js

@@ -1,6 +1,10 @@
-/** Phase 1 统一追加到 9× integration 工具「边界」段末尾 */
+/** Shared Phase B boundary suffix for all get_* integration tools */
 export const INTEGRATION_BOUNDARY_SUFFIX = `
-- **Codegen 专用**：仅当用户明确要求「集成进项目 / 写接入代码 / 帮我实现接入 / 生成工程代码」时调用本工具
-- **纯咨询或查阅**（怎么用、是什么、有哪些步骤、先看文档、错误排查、API/组件说明）→ 调用 \`search_trtc_knowledge\`，**不要**调用本工具
-- 本工具属 codegen 链路：作答后**不**调用 \`finalize_answer\` / \`submit_feedback\`（这两个仅属 \`search_trtc_knowledge\` 链路）
-- **用户可见输出约束（强制）**：以上链路/工具选择仅用于内部决策，禁止在对用户文本中出现“应调用/先调用/让我先搜索/我将调用某工具/属于咨询类问题/而非 codegen”等流程说明；直接输出结论与可执行内容。`;
+- **Codegen only (MUST)**: Call this tool only when user explicitly asks for runnable integration/code implementation (e.g. “接入到项目”, “写接入代码”, “直接给我可运行代码”).
+- **When NOT to call**: For pure Q&A, documentation lookup, API/component explanation, error troubleshooting, or “先了解方案/步骤” requests, call \`search_trtc_knowledge\` instead.
+- **Workflow split**: This tool belongs to codegen flow. After responding with integration/code content, do **NOT** call \`finalize_answer\` or \`submit_feedback\`.
+- **User-visible output rule (MUST)**: Tool routing decisions are internal. Do not expose process text like “应调用/先调用/让我先搜索/我将调用某工具/属于咨询类问题/而非 codegen”. Output only the final actionable content.
+- **Few-shot boundary**:
+  - Positive: “用 Vue 把 Chat UIKit 接到我现有项目，给可运行代码” -> call corresponding \`get_*_integration\`
+  - Negative: “Chat UIKit 有哪些能力/组件？” -> call \`search_trtc_knowledge\`
+`;

package/tools/definitions/present_framework_choice_def.js

@@ -1,36 +1,36 @@
 const TOOL_DESCRIPTION = `
-用途：
-当用户未明确平台或框架时，先引导用户从受支持选项中明确选择，再继续调用 \`search_trtc_knowledge\` 或对应的 integration 工具。
+Purpose:
+Collect platform/framework choice from user when the question requires client-side platform context.
 
-典型适用问题：
-平台选择, 框架选择, 先选平台, 先选框架, 未指定平台, 未指定框架, 获取集成指南, 获取接入文档, 快速开始, 查询 API, 查询组件, 查询功能点, 怎么设置, 怎么配置, Chat UIKit 集成, Call UIKit 集成, Live UIKit 集成, Room UIKit 集成, CallKit API, LiveKit API, WebRTC SDK 集成, Native TRTC SDK 集成, react, vue, web, miniprogram, 小程序, uni-app, flutter, android, ios, webrtc
+When to call (MUST):
+- User asks API/component/feature/client troubleshooting/integration guidance but does not specify platform.
+- search_trtc_knowledge returns needs_framework.
+- User requests explicit codegen/integration but platform is not specified.
 
-触发示例：
-- 获取 Chat UIKit 集成指南（未说明 React/Vue）
-- CallKit 来电铃声怎么设置（未说明平台）
-- Chat UIKit 某个组件怎么用（未说明 Web/Native）
-- 虚拟背景怎么开（未说明产品或平台）
+When NOT to call:
+- Cross-platform product topics: pricing, product package, console-level product config.
+- Server-side topics: REST API, webhook, UserSig principle.
+- Platform is already explicitly provided by user.
 
-输入：
-- product: chat | call | live | room | rtcengine | native_trtc_sdk | push
+Boundary:
+- This tool only collects platform/framework; it does NOT return documentation content.
+- After user chooses platform:
+  - Q&A / troubleshooting / doc lookup -> call search_trtc_knowledge with product + frameworks.
+  - Explicit codegen request -> call corresponding get_*_integration tool.
 
-返回：
-- content: [{ type: 'text', text: 选项列表 }]
-
-边界：
-- 只负责收集平台或框架选择，不返回文档正文
-- **咨询链路（硬规则）**：用户问 API/组件/feature/客户端排障/集成查阅，但未说明平台 → MUST **先本工具**，用户选定后再 \`search_trtc_knowledge\`（**product + frameworks**）；**禁止**跳过
-- **codegen 链路（硬规则）**：用户要集成进项目且未说明平台 → MUST **先本工具**，选定后再对应 \`get_*_integration\`
-- 跨平台通用问题（计费、服务端 REST、UserSig 原理）且与单一客户端无关 → 可直接 \`search_trtc_knowledge\`，不必经过本工具（**product 仍 MUST 从 prompt 提取**）
+Few-shot:
+- User: "Chat UIKit 怎么集成？" (no React/Vue) -> CALL present_framework_choice
+- User: "CallKit 来电铃声怎么设置？" (no platform) -> CALL present_framework_choice
+- User: "TIMPush 厂商通道怎么在控制台开通？" -> DO NOT call present_framework_choice
 `;
 const SELECTION_PROMPT_TEXT = `
-请直接向用户展示可选的平台或框架，并等待用户选择后再继续后续集成或查询。
+Please show available platform/framework options to user first. Continue with search or integration only after user selects one option.
 `;
 export const PRESENT_FRAMEWORK_CHOICE_DEFINITION = {
     name: 'present_framework_choice',
     description: TOOL_DESCRIPTION,
     selectionText: SELECTION_PROMPT_TEXT,
     parameter_descriptions: {
-        product: '目标产品。可选值：chat | call | live | room | rtcengine | native_trtc_sdk | push。',
+        product: 'Target product. Allowed: chat | call | live | room | rtcengine | native_trtc_sdk | push.',
     },
 };