From b9d530180168df864e39d4b79f65c5cb9c030143 Mon Sep 17 00:00:00 2001
From: moyin <244344649@qq.com>
Date: Fri, 9 Jan 2026 18:45:45 +0800
Subject: [PATCH] =?UTF-8?q?feat=EF=BC=9A=E4=BF=AE=E6=94=B9websocket?=
 =?UTF-8?q?=E8=B7=B3=E8=BD=AC=E6=95=88=E6=9E=9C?=
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

---
 .../zulip/websocket_test.controller.ts        | 27 ++++++++++++++++---
 src/main.ts                                   | 13 +++++++++
 2 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/src/business/zulip/websocket_test.controller.ts b/src/business/zulip/websocket_test.controller.ts
index 94aa7f5..ead6a69 100644
--- a/src/business/zulip/websocket_test.controller.ts
+++ b/src/business/zulip/websocket_test.controller.ts
@@ -18,8 +18,25 @@ export class WebSocketTestController {
 
   @Get()
   @ApiOperation({
-    summary: 'WebSocket 测试页面',
-    description: '提供一个简单的WebSocket测试界面，可以直接在浏览器中测试连接和消息发送'
+    summary: '🔌 WebSocket 测试页面 - 一键测试工具',
+    description: `
+**🚀 功能强大的WebSocket测试工具**
+
+提供完整的WebSocket测试功能：
+- ✅ 自动获取JWT Token
+- ✅ 一键建立WebSocket连接  
+- ✅ 用户认证和登录
+- ✅ 聊天消息发送测试
+- ✅ 位置更新测试
+- ✅ 实时消息日志
+
+**使用方法**：
+1. 点击下方"Execute"按钮
+2. 在响应中会返回完整的测试页面HTML
+3. 或直接访问: /websocket-test
+
+**推荐**：直接在新标签页中打开 [/websocket-test](/websocket-test)
+    `
   })
   @ApiResponse({
     status: 200,
@@ -165,8 +182,10 @@ export class WebSocketTestController {
         <p><strong>4. 发送消息:</strong> 认证成功后可以发送聊天消息和位置更新</p>
         <p><strong>WebSocket地址:</strong> <code>wss://whaletownend.xinghangee.icu/game</code></p>
         
-        <div style="margin-top: 15px;">
-            <a href="/api-docs" target="_blank" style="margin-right: 15px; color: #1976d2; text-decoration: none;">📚 返回 API 文档</a>
+        <div style="margin-top: 15px; padding: 10px; background-color: #e3f2fd; border-radius: 4px;">
+            <strong>🔗 相关链接：</strong>
+            <a href="/api-docs" target="_blank" style="margin-right: 15px; color: #1976d2; text-decoration: none; font-weight: bold;">📚 返回 API 文档</a>
+            <a href="/websocket/docs" target="_blank" style="margin-right: 15px; color: #1976d2; text-decoration: none;">📖 WebSocket API 文档</a>
             <a href="/websocket-api/connection-info" target="_blank" style="color: #1976d2; text-decoration: none;">🔧 连接配置信息</a>
         </div>
     </div>
diff --git a/src/main.ts b/src/main.ts
index 57db37c..932be78 100644
--- a/src/main.ts
+++ b/src/main.ts
@@ -75,6 +75,19 @@ async function bootstrap() {
     .setDescription(`
 像素游戏服务器API文档 - 包含用户认证、聊天系统、Zulip集成等功能
 
+## 🚀 快速测试工具
+
+### 🔌 WebSocket 测试页面
+**[点击这里打开 WebSocket 测试工具 →](/websocket-test)**
+
+一键测试WebSocket连接、用户认证、消息发送等功能，无需额外工具！
+
+### 📚 其他测试工具
+- **[WebSocket API 文档](/websocket/docs)** - 详细的消息格式和示例
+- **[WebSocket 连接信息](/chat/websocket/info)** - 连接配置和参数
+
+---
+
 ## 主要功能模块
 
 ### 🔐 用户认证 (auth)