@tencentcloud/sdk-mcp 1.1.3 → 1.1.5

package/index.js

@@ -1,8 +1,10 @@
 #!/usr/bin/env node
 import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
 import { createServer } from './server.js';
+import { ServerConfig } from './server-config.js';
 // 启动服务器
 async function main() {
+    ServerConfig.getInstance();
     const server = createServer();
     const transport = new StdioServerTransport();
     await server.connect(transport);

package/index.js.map

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

package/libs/TLSSigAPIv2.d.ts

@@ -0,0 +1,134 @@
+/**
+ * TLSSigAPIv2 TypeScript 声明文件
+ * 用于腾讯云实时音视频(TRTC)和即时通信(IM)服务的签名生成
+ */
+
+/**
+ * TLS签名API类
+ */
+export declare class Api {
+    /**
+     * 构造函数
+     * @param sdkappid - 应用的SDKAppID
+     * @param key - 应用的密钥
+     */
+    constructor(sdkappid: number, key: string);
+
+    /**
+     * SDKAppID
+     */
+    readonly sdkappid: number;
+
+    /**
+     * 应用密钥
+     */
+    readonly key: string;
+
+    /**
+     * 生成UserSig签名
+     * 用于签发 TRTC 和 IM 服务中必须要使用的 UserSig 鉴权票据
+     * 
+     * @param userid - 用户id，限制长度为32字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符
+     * @param expire - UserSig 票据的过期时间，单位是秒，比如 86400 代表生成的 UserSig 票据在一天后就无法再使用了
+     * @returns 返回生成的UserSig字符串
+     */
+    genUserSig(userid: string, expire: number): string;
+
+    /**
+     * 生成PrivateMapKey权限票据（数字房间号）
+     * 用于签发 TRTC 进房参数中可选的 PrivateMapKey 权限票据
+     * 
+     * @param userid - 用户id，限制长度为32字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符
+     * @param expire - PrivateMapKey 票据的过期时间，单位是秒
+     * @param roomid - 房间号，用于指定该 userid 可以进入的房间号
+     * @param privilegeMap - 权限位，使用了一个字节中的 8 个比特位，分别代表八个具体的功能权限开关
+     * @returns 返回生成的PrivateMapKey字符串
+     */
+    genPrivateMapKey(userid: string, expire: number, roomid: number, privilegeMap: number): string;
+
+    /**
+     * 生成PrivateMapKey权限票据（字符串房间号）
+     * 用于签发 TRTC 进房参数中可选的 PrivateMapKey 权限票据
+     * 
+     * @param userid - 用户id，限制长度为32字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符
+     * @param expire - PrivateMapKey 票据的过期时间，单位是秒
+     * @param roomstr - 字符串房间号，用于指定该 userid 可以进入的房间号
+     * @param privilegeMap - 权限位，使用了一个字节中的 8 个比特位，分别代表八个具体的功能权限开关
+     * @returns 返回生成的PrivateMapKey字符串
+     */
+    genPrivateMapKeyWithStringRoomID(userid: string, expire: number, roomstr: string, privilegeMap: number): string;
+
+    /**
+     * 通用签名生成方法
+     * @param userid - 用户ID
+     * @param expire - 过期时间（秒）
+     * @param userBuf - 用户缓冲区数据，可选
+     * @returns 返回生成的签名字符串
+     */
+    genSig(userid: string, expire: number, userBuf?: Buffer | null): string;
+
+    /**
+     * 生成HMAC-SHA256签名（私有方法）
+     * @private
+     */
+    private _hmacsha256(identifier: string, currTime: number, expire: number, base64UserBuf?: string | null): string;
+
+    /**
+     * 生成用户缓冲区数据（私有方法）
+     * @private
+     */
+    private _genUserbuf(
+      account: string,
+      dwAuthID: number,
+      dwExpTime: number,
+      dwPrivilegeMap: number,
+      dwAccountType: number,
+      roomstr?: string | null
+    ): Buffer;
+  }
+
+/**
+ * 权限位常量定义
+ * 使用了一个字节中的 8 个比特位，分别代表八个具体的功能权限开关
+ */
+export declare namespace PrivilegeMap {
+  /** 创建房间的权限 */
+  const CREATE_ROOM = 1;
+  /** 加入房间的权限 */
+  const JOIN_ROOM = 2;
+  /** 发送语音的权限 */
+  const SEND_AUDIO = 4;
+  /** 接收语音的权限 */
+  const RECEIVE_AUDIO = 8;
+  /** 发送视频的权限 */
+  const SEND_VIDEO = 16;
+  /** 接收视频的权限 */
+  const RECEIVE_VIDEO = 32;
+  /** 发送辅路（屏幕分享）视频的权限 */
+  const SEND_SUB_VIDEO = 64;
+  /** 接收辅路（屏幕分享）视频的权限 */
+  const RECEIVE_SUB_VIDEO = 128;
+  /** 所有权限 */
+  const ALL_PRIVILEGES = 255;
+}
+
+/**
+ * 使用示例：
+ * 
+ * ```typescript
+ * import { Api } from './TLSSigAPIv2';
+ * // 或者使用 CommonJS 方式：
+ * // const { Api } = require('./TLSSigAPIv2');
+ * 
+ * const api = new Api(1400000000, 'your-secret-key');
+ * 
+ * // 生成UserSig
+ * const userSig = api.genUserSig('user123', 86400);
+ * 
+ * // 生成PrivateMapKey（数字房间号）
+ * const privateMapKey = api.genPrivateMapKey('user123', 86400, 12345, 255);
+ * 
+ * // 生成PrivateMapKey（字符串房间号）
+ * const privateMapKeyStr = api.genPrivateMapKeyWithStringRoomID('user123', 86400, 'room_abc', 255);
+ * ```
+ */

package/libs/TLSSigAPIv2.js

@@ -0,0 +1,243 @@
+import crypto from 'crypto';
+import zlib from 'zlib';
+
+var base64url = {};
+
+var newBuffer = function (fill, encoding) {
+    return Buffer.from ? Buffer.from(fill, encoding) : new Buffer(fill, encoding)
+};
+
+base64url.unescape = function unescape(str) {
+    return (str + Array(5 - str.length % 4))
+        .replace(/_/g, '=')
+        .replace(/\-/g, '/')
+        .replace(/\*/g, '+');
+};
+
+base64url.escape = function escape(str) {
+    return str.replace(/\+/g, '*')
+        .replace(/\//g, '-')
+        .replace(/=/g, '_');
+};
+
+base64url.encode = function encode(str) {
+    return this.escape(newBuffer(str).toString('base64'));
+};
+
+base64url.decode = function decode(str) {
+    return newBuffer(this.unescape(str), 'base64').toString();
+};
+
+function base64encode(str) {
+    return newBuffer(str).toString('base64')
+}
+
+function base64decode(str) {
+    return newBuffer(str, 'base64').toString()
+}
+
+var Api = function (sdkappid, key) {
+    this.sdkappid = sdkappid;
+    this.key = key;
+};
+/**
+ * 通过传入参数生成 base64 的 hmac 值
+ * @param identifier
+ * @param currTime
+ * @param expire
+ * @returns {string}
+ * @private
+ */
+Api.prototype._hmacsha256 = function (identifier, currTime, expire, base64UserBuf) {
+    var contentToBeSigned = "TLS.identifier:" + identifier + "\n";
+    contentToBeSigned += "TLS.sdkappid:" + this.sdkappid + "\n";
+    contentToBeSigned += "TLS.time:" + currTime + "\n";
+    contentToBeSigned += "TLS.expire:" + expire + "\n";
+    if (null != base64UserBuf) {
+        contentToBeSigned += "TLS.userbuf:" + base64UserBuf + "\n";
+    }
+    const hmac = crypto.createHmac("sha256", this.key);
+    return hmac.update(contentToBeSigned).digest('base64');
+};
+/**
+ * TRTC业务进房权限加密串需使用用户定义的userbuf
+ * @brief 生成 userbuf
+ * @param account 用户名
+ * @param dwSdkappid sdkappid
+ * @param dwAuthID  数字房间号
+ * @param dwExpTime 过期时间：该权限加密串的过期时间，建议300秒，实际过期时间:now+dwExpTime
+ * @param dwPrivilegeMap 用户权限，255表示所有权限
+ * @param dwAccountType 用户类型,默认为0
+ * @param roomstr 字符串房间号
+ * @return userbuf  {string}  返回的userbuf
+ */
+Api.prototype._genUserbuf = function (account, dwAuthID, dwExpTime,
+    dwPrivilegeMap, dwAccountType, roomstr) {
+
+    let accountLength = account.length;
+    let roomstrlength = 0;
+    let length = 1 + 2 + accountLength + 20 ;
+    if (null != roomstr)
+    {
+        roomstrlength = roomstr.length;
+        length = length + 2 + roomstrlength;
+    }
+    let offset = 0;
+    let userBuf = new Buffer.alloc(length);
+
+    //cVer
+    if (null != roomstr)
+        userBuf[offset++] = 1;
+    else
+        userBuf[offset++] = 0;
+
+    //wAccountLen
+    userBuf[offset++] = (accountLength & 0xFF00) >> 8;
+    userBuf[offset++] = accountLength & 0x00FF;
+
+    //buffAccount
+    for (; offset < 3 + accountLength; ++offset) {
+        userBuf[offset] = account.charCodeAt(offset - 3);
+    }
+
+    //dwSdkAppid
+    userBuf[offset++] = (this.sdkappid & 0xFF000000) >> 24;
+    userBuf[offset++] = (this.sdkappid & 0x00FF0000) >> 16;
+    userBuf[offset++] = (this.sdkappid & 0x0000FF00) >> 8;
+    userBuf[offset++] = this.sdkappid & 0x000000FF;
+
+    //dwAuthId
+    userBuf[offset++] = (dwAuthID & 0xFF000000) >> 24;
+    userBuf[offset++] = (dwAuthID & 0x00FF0000) >> 16;
+    userBuf[offset++] = (dwAuthID & 0x0000FF00) >> 8;
+    userBuf[offset++] = dwAuthID & 0x000000FF;
+
+    //过期时间：dwExpTime+now
+    let expire = Date.now() / 1000 + dwExpTime;
+    userBuf[offset++] = (expire & 0xFF000000) >> 24;
+    userBuf[offset++] = (expire & 0x00FF0000) >> 16;
+    userBuf[offset++] = (expire & 0x0000FF00) >> 8;
+    userBuf[offset++] = expire & 0x000000FF;
+
+    //dwPrivilegeMap
+    userBuf[offset++] = (dwPrivilegeMap & 0xFF000000) >> 24;
+    userBuf[offset++] = (dwPrivilegeMap & 0x00FF0000) >> 16;
+    userBuf[offset++] = (dwPrivilegeMap & 0x0000FF00) >> 8;
+    userBuf[offset++] = dwPrivilegeMap & 0x000000FF;
+
+    //dwAccountType
+    userBuf[offset++] = (dwAccountType & 0xFF000000) >> 24;
+    userBuf[offset++] = (dwAccountType & 0x00FF0000) >> 16;
+    userBuf[offset++] = (dwAccountType & 0x0000FF00) >> 8;
+    userBuf[offset++] = dwAccountType & 0x000000FF;
+
+    if (null != roomstr) {
+        //roomstrlength
+        userBuf[offset++] = (roomstr.length & 0xFF00) >> 8;
+        userBuf[offset++] = roomstr.length & 0x00FF;
+
+        //roomstr
+        for (; offset < length; ++offset) {
+            userBuf[offset] = roomstr.charCodeAt(offset - (length - roomstr.length));
+        }
+    }
+
+    return userBuf;
+}
+Api.prototype.genSig = function (userid, expire, userBuf) {
+    var currTime = Math.floor(Date.now() / 1000);
+
+    var sigDoc = {
+        'TLS.ver': "2.0",
+        'TLS.identifier': "" + userid,
+        'TLS.sdkappid': Number(this.sdkappid),
+        'TLS.time': Number(currTime),
+        'TLS.expire': Number(expire)
+    };
+
+    var sig = '';
+    if (null != userBuf) {
+        var base64UserBuf = base64encode(userBuf);
+        sigDoc['TLS.userbuf'] = base64UserBuf;
+        sig = this._hmacsha256(userid, currTime, expire, base64UserBuf);
+    } else {
+        sig = this._hmacsha256(userid, currTime, expire, null);
+    }
+    sigDoc['TLS.sig'] = sig;
+
+    var compressed = zlib.deflateSync(newBuffer(JSON.stringify(sigDoc))).toString('base64');
+    return base64url.escape(compressed);
+}
+/**
+ *【功能说明】用于签发 TRTC 和 IM 服务中必须要使用的 UserSig 鉴权票据
+ *
+ *【参数说明】
+ * @param userid - 用户id，限制长度为32字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符。
+ * @param expire - UserSig 票据的过期时间，单位是秒，比如 86400 代表生成的 UserSig 票据在一天后就无法再使用了。
+ */
+Api.prototype.genUserSig = function (userid, expire) {
+    return this.genSig(userid, expire, null);
+};
+
+/**
+ *【功能说明】
+ * 用于签发 TRTC 进房参数中可选的 PrivateMapKey 权限票据。
+ * PrivateMapKey 需要跟 UserSig 一起使用，但 PrivateMapKey 比 UserSig 有更强的权限控制能力：
+ *  - UserSig 只能控制某个 UserID 有无使用 TRTC 服务的权限，只要 UserSig 正确，其对应的 UserID 可以进出任意房间。
+ *  - PrivateMapKey 则是将 UserID 的权限控制的更加严格，包括能不能进入某个房间，能不能在该房间里上行音视频等等。
+ * 如果要开启 PrivateMapKey 严格权限位校验，需要在【实时音视频控制台】=>【应用管理】=>【应用信息】中打开“启动权限密钥”开关。
+ *
+ *【参数说明】
+ * @param userid - 用户id，限制长度为32字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符。
+ * @param expire - PrivateMapKey 票据的过期时间，单位是秒，比如 86400 生成的 PrivateMapKey 票据在一天后就无法再使用了。
+ * @param roomid - 房间号，用于指定该 userid 可以进入的房间号
+ * @param privilegeMap - 权限位，使用了一个字节中的 8 个比特位，分别代表八个具体的功能权限开关：
+ *  - 第 1 位：0000 0001 = 1，创建房间的权限
+ *  - 第 2 位：0000 0010 = 2，加入房间的权限
+ *  - 第 3 位：0000 0100 = 4，发送语音的权限
+ *  - 第 4 位：0000 1000 = 8，接收语音的权限
+ *  - 第 5 位：0001 0000 = 16，发送视频的权限  
+ *  - 第 6 位：0010 0000 = 32，接收视频的权限  
+ *  - 第 7 位：0100 0000 = 64，发送辅路（也就是屏幕分享）视频的权限
+ *  - 第 8 位：1000 0000 = 200，接收辅路（也就是屏幕分享）视频的权限  
+ *  - privilegeMap == 1111 1111 == 255 代表该 userid 在该 roomid 房间内的所有功能权限。
+ *  - privilegeMap == 0010 1010 == 42  代表该 userid 拥有加入房间和接收音视频数据的权限，但不具备其他权限。
+ */
+Api.prototype.genPrivateMapKey = function (userid, expire, roomid, privilegeMap) {
+    var userBuf = this._genUserbuf(userid, roomid, expire, privilegeMap, 0, null);
+    return this.genSig(userid, expire, userBuf);
+
+};
+/**
+ *【功能说明】
+ * 用于签发 TRTC 进房参数中可选的 PrivateMapKey 权限票据。
+ * PrivateMapKey 需要跟 UserSig 一起使用，但 PrivateMapKey 比 UserSig 有更强的权限控制能力：
+ *  - UserSig 只能控制某个 UserID 有无使用 TRTC 服务的权限，只要 UserSig 正确，其对应的 UserID 可以进出任意房间。
+ *  - PrivateMapKey 则是将 UserID 的权限控制的更加严格，包括能不能进入某个房间，能不能在该房间里上行音视频等等。
+ * 如果要开启 PrivateMapKey 严格权限位校验，需要在【实时音视频控制台】=>【应用管理】=>【应用信息】中打开“启动权限密钥”开关。
+ *
+ *【参数说明】
+ * @param userid - 用户id，限制长度为32字节，只允许包含大小写英文字母（a-zA-Z）、数字（0-9）及下划线和连词符。
+ * @param expire - PrivateMapKey 票据的过期时间，单位是秒，比如 86400 生成的 PrivateMapKey 票据在一天后就无法再使用了。
+ * @param roomstr - 房间号，用于指定该 userid 可以进入的房间号
+ * @param privilegeMap - 权限位，使用了一个字节中的 8 个比特位，分别代表八个具体的功能权限开关：
+ *  - 第 1 位：0000 0001 = 1，创建房间的权限
+ *  - 第 2 位：0000 0010 = 2，加入房间的权限
+ *  - 第 3 位：0000 0100 = 4，发送语音的权限
+ *  - 第 4 位：0000 1000 = 8，接收语音的权限
+ *  - 第 5 位：0001 0000 = 16，发送视频的权限  
+ *  - 第 6 位：0010 0000 = 32，接收视频的权限  
+ *  - 第 7 位：0100 0000 = 64，发送辅路（也就是屏幕分享）视频的权限
+ *  - 第 8 位：1000 0000 = 200，接收辅路（也就是屏幕分享）视频的权限  
+ *  - privilegeMap == 1111 1111 == 255 代表该 userid 在该房间内的所有功能权限。
+ *  - privilegeMap == 0010 1010 == 42  代表该 userid 拥有加入房间和接收音视频数据的权限，但不具备其他权限。
+ */
+Api.prototype.genPrivateMapKeyWithStringRoomID = function (userid, expire, roomstr, privilegeMap) {
+    var userBuf = this._genUserbuf(userid, 0, expire, privilegeMap, 0, roomstr);
+    return this.genSig(userid, expire, userBuf);
+
+};
+
+export {
+  Api
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tencentcloud/sdk-mcp",
-  "version": "1.1.3",
+  "version": "1.1.5",
   "description": "Tencent Cloud MCP Server for SDK",
   "type": "module",
   "main": "index.js",

package/resource/doc/chatuikit/react/chat_window_integration.md

@@ -0,0 +1,78 @@
+AI 模型必须遵守以下**硬性限制**。
+
+* **React 版本限制：** 创建项目时 react 和 react-dom 的版本必须选用 `18.2.0`,禁止选用 react 19。
+* **必须严格按照文档步骤和说明集成：** 在集成组件时必须按照文档步骤和说明进行。
+* **必须严格使用文档中的示例代码：** 创建文件时必须严格使用文档中的示例代码填充文件，Chat 组件的 PlaceholderEmpty 属性不需要填写。
+* **必须打开默认会话：** 必须使用 `setActiveConversation` 打开 `C2Cadministrator` 会话。 
+* **必须调用工具获取 userSig：** TUIKit 集成完成后，必须引导用户调用工具 `get_usersig` 获取 userSig。
+* **禁止创建用户信息配置文件：** 不得自动创建填写 SDKAppID、userID、userSig 的 config 目录或文件。
+
+# chat-uikit-react Integration
+
+## step1：create react project
+
+requirement: react: 18.2.0, react-dom: 18.2.0.
+
+you can use vite or rsbuild to create a react project.
+
+## step2: install chat-uikit-react
+
+use npm or pnpm to install @tencentcloud/chat-uikit-react
+
+## step3: add chat-uikit-react to your project
+
+example code
+
+```tsx
+import {
+  UIKitProvider,
+  useLoginState,
+  LoginStatus,
+  Chat,
+  ChatHeader,
+  MessageList,
+  MessageInput,
+  useConversationListState,
+} from "@tencentcloud/chat-uikit-react";
+
+function App() {
+  const userID = '';        // TODO: Replace with your userID
+  const SDKAppID = 0;        // TODO: Replace with your SDKAppID (Notice: SDKAppID is of type number）
+  const userSig = '';   // TODO: Replace with your userSig
+  
+  const { status } = useLoginState({
+    SDKAppID,
+    userID,
+    userSig,
+  })
+
+  if (status !== LoginStatus.SUCCESS) {
+    return <div>Loading...</div>
+  }
+
+  // 打开默认会话
+  const { setActiveConversation } = useConversationListState();
+  setActiveConversation('C2Cadministrator');
+  
+  // Language support zh-CN(default) / en-US / ja-JP / ko-KR / zh-TW
+  // Theme support light(default) / dark
+  return (
+    <UIKitProvider language='zh-CN' theme='light'>
+      <div style={{
+        height: '100vh',
+        width: '100vw',
+        display: 'flex',
+        flexDirection: 'row',
+        }}>
+        <Chat PlaceholderEmpty=''>
+          <ChatHeader />
+          <MessageList />
+          <MessageInput />
+        </Chat>
+      </div>
+    </UIKitProvider>
+  );
+}
+
+export default App;
+```

package/resource/doc/chatuikit/react/integration.md

@@ -1,15 +1,17 @@
 AI 模型必须遵守以下**硬性限制**。
 
+* **React 版本限制：** 创建项目时 react 和 react-dom 的版本必须选用 `18.2.0`，禁止选用 react 19。
 * **必须严格按照文档步骤和说明集成：** 在集成组件时必须按照文档步骤和说明进行。
 * **必须严格使用文档中的示例代码：** 创建文件时必须严格使用文档中的示例代码填充文件，Chat 组件的 PlaceholderEmpty 属性不需要填写。
+* **必须打开默认会话：** 必须使用 `setActiveConversation` 打开 `C2Cadministrator` 会话。 
+* **必须调用工具获取 userSig：** TUIKit 集成完成后，必须引导用户调用工具 `get_usersig` 获取 userSig。
 * **禁止创建用户信息配置文件：** 不得自动创建填写 SDKAppID、userID、userSig 的 config 目录或文件。
-* **禁止创建获取 userSig 逻辑：** 不得自动创建获取 userSig 相关代码，必须明确引导用户输入 SDKAppID、 userID、 userSig 信息并帮忙回填到相应的文件。
 
 # chat-uikit-react Integration
 
 ## step1：create react project
 
-requirement: react: ^18.2.0, react-dom: ^18.2.0.
+requirement: react: 18.2.0, react-dom: 18.2.0.
 
 you can use vite or rsbuild to create a react project.
 
@@ -31,6 +33,7 @@ import {
   ChatHeader,
   MessageList,
   MessageInput,
+  useConversationListState,
 } from "@tencentcloud/chat-uikit-react";
 
 function App() {
@@ -47,6 +50,10 @@ function App() {
   if (status !== LoginStatus.SUCCESS) {
     return <div>Loading...</div>
   }
+
+  // 打开默认会话
+  const { setActiveConversation } = useConversationListState();
+  setActiveConversation('C2Cadministrator');
   
   // Language support zh-CN(default) / en-US / ja-JP / ko-KR / zh-TW
   // Theme support light(default) / dark

package/resource/doc/chatuikit/vue/chat_window_integration.md

@@ -0,0 +1,130 @@
+AI 模型必须遵守以下**硬性限制**。
+* **必须严格文档步骤集成：** 在集成组件时必须按照文档步骤和说明进行，且在 1.1 中不需要执行 `npm run dev` or `pnpm run dev`, 集成完成后按照 1.4 启动项目。
+* **必须严格使用文档中的示例代码：** 创建文件时必须严格使用文档中的示例代码填充文件， style 标签优先推荐不使用 scoped 属性。
+* **必须打开默认会话：** 必须使用 `setActiveConversation` 打开 `C2Cadministrator` 会话。 
+* **必须调用工具获取 userSig：** TUIKit 集成完成后，必须引导用户调用工具 `get_usersig` 获取 userSig。
+* **禁止创建用户信息配置文件：** 不得自动创建填写 SDKAppID、userID、userSig 的 config 目录或文件。
+
+# chat-uikit-vue3 Integration
+
+用户的集成需求一般有两种，你必须理性分析需求到底属于哪一种：
+1. 集成聊天窗口：指仅集成 Chat、ChatHeader、MessageList、MessageInput 组件。
+2. 集成通话功能：仅集成聊天基础上，集成通话功能，具体信息必须阅读第 2.1 节 “最佳实践-集成通话功能”。
+
+
+## 1 集成聊天窗口
+
+### 1.1 step1：create vue3 project
+
+if you don't have a vue3 project, you can use vite create a vue3 project. otherwise, you can skip this step.
+
+requirement: vue3: ^3.0.0, nodejs: ^22.0.0.
+
+if it is a new project, guide the user to use vite to create a vue3 project manually, and then continue with step 1.2. if it is an existing project, skip this step and continue with step 1.2.
+
+```bash
+pnpm create vite@latest
+# skip some settings
+cd ${your-vue-project-name}
+pnpm install
+```
+
+### 1.2 step2: install chat-uikit-vue3
+
+use npm or pnpm to install @tencentcloud/chat-uikit-vue3@latest @tencentcloud/call-uikit-vue@latest
+
+### 1.3 step3: add main content to your project
+```vue
+<template>
+<UIKitProvider>
+  <Chat style="flex: 1;">
+    <ChatHeader />
+    <MessageList />
+    <MessageInput />
+  </Chat>
+</UIKitProvider>
+</template>
+<script setup lang="ts">
+import { useLoginState, useConversationListState } from '@tencentcloud/chat-uikit-vue3';
+
+const userID = '';        // TODO: Replace with your userID
+const SDKAppID = 0;        // TODO: Replace with your SDKAppID (Notice: SDKAppID is of type number)
+const userSig = '';   // TODO: Replace with your userSig
+const conversationID = ref('C2Cadministrator'); // define by yourself
+
+const { login } = useLoginState();
+const { setActiveConversation } = useConversationListState();
+
+login({
+  sdkAppId : SDKAppID,
+  userId: userID,
+  userSig: userSig,
+})
+.then(() => {
+  setActiveConversation(conversationID.value);
+})
+.catch(() => {});
+</script>
+```
+
+### 1.4 step4: start your project
+```bash
+pnpm run dev
+```
+
+## 2. 最佳实践
+
+以下提到的组件通过 MCP Tools get_component_detail ${componenetname.tolowercase()} 获取。
+以下提到的 state 通过 MCP Tools get_state_detail ${statename.tolowercase()} 获取。
+
+重点：
+1. 如果需要集成 ChatSetting 组件，请阅读 ChatHeader 的 ChatHeaderRight 插槽说明。
+2. 由于仅集成聊天不使用 ConversationList，你需要使用 ConversationListState 的 useConversationListState 获取 activeConversation，然后调用 setActiveConversation 设置 activeConversation。
+
+### 2.1 最佳实践-集成通话功能
+
+集成通话功能需要仅集成聊天基础上，添加通话功能的代码。
+
+引入 TUICallKit 组件：
+```vue
+<script setup lang="ts">
+import { TUICallKit } from '@tencentcloud/call-uikit-vue';
+</script>
+```
+
+在合适的位置添加 TUICallKit 组件：
+```vue
+<Teleport to="body">
+  <TUICallKit style="position: fixed; z-index: 1000;"/>
+</Teleport>
+```
+
+重点：
+1. 需要在 ChatHeader 组件的 ChatHeaderRight 插槽中添加通话按钮。
+2. 点击通话按钮调用以下方法：
+  2.1 阅读 ConversationListState 文档，通过 activeConversation 判断当前是单聊还是群聊。
+  2.2 如果是单聊，通过 `import { TUICallKitServer, TUICallType } from '@tencentcloud/call-uikit-vue';` 引入 TUICallKitService 服务。通过 TUICallKitService 的 `calls` 方法发起通话。
+    ```ts
+    try {
+      await TUICallKitServer.calls({ 
+        userIDList: [activeConversation.value.userProfile.userID],
+        type: TUICallType.VIDEO_CALL, // or TUICallType.AUDIO_CALL
+      });
+    } catch (error: any) {
+      console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);
+    }
+    ```
+  2.3 如果是群聊，需要阅读 UserPicker 组件文档，建议结合 Dialog 组件，弹出 UserPicker 组件。
+    阅读 GroupSettingState 文档，结合 GroupSettingState 的 `getGroupMemberList`、`allMembers` 等属性，获取群成员列表。
+    ```ts
+    try {
+      await TUICallKitServer.calls({ 
+        userIDList: selectedItems.map((item: any) => item.key),
+        type: TUICallType.VIDEO_CALL, // or TUICallType.AUDIO_CALL
+      });
+    } catch (error: any) {
+      console.error(`[TUICallKit] Failed to call the groupCall API. Reason:${error}`);
+    }
+    ```
+
+    建议：结合 UserPicker 的 reachEnd 事件分页拉取群成员，并使用节流函数控制 `getGroupMemberList` 的调用频率。