diff --git a/src/main.ts b/src/main.ts index 2816502..57db37c 100644 --- a/src/main.ts +++ b/src/main.ts @@ -89,6 +89,12 @@ async function bootstrap() { - 系统状态监控 - Zulip 集成状态 +### 🔌 WebSocket 接口 (websocket) +- 实时消息传输 +- 位置同步 +- 地图房间管理 +- 连接状态监控 + ### 👑 管理员后台 (admin) - 用户管理 - 系统监控 @@ -98,12 +104,16 @@ async function bootstrap() { 游戏聊天功能主要通过 WebSocket 实现: -**连接地址**: \`ws://localhost:3000/game\` +**连接地址**: \`wss://whaletownend.xinghangee.icu/game\` (原生WebSocket) + +**重要变更**: 已从Socket.IO迁移到原生WebSocket,提升性能和稳定性 + +**连接路径**: \`/game\` - 统一的WebSocket入口 **支持的事件**: - \`login\`: 用户登录(需要 JWT Token) - \`chat\`: 发送聊天消息 -- \`position_update\`: 位置更新 +- \`position\`: 位置更新 **JWT Token 要求**: - issuer: \`whale-town\` @@ -119,10 +129,30 @@ async function bootstrap() { - Whale Port (鲸鱼港) - Pumpkin Valley (南瓜谷) - Novice Village (新手村) + +## 最近更新 (v2.1.0) + +### 🚀 WebSocket 架构升级 +- ✅ 移除Socket.IO依赖,使用原生WebSocket +- ✅ 实现地图房间分组管理 +- ✅ 支持本地和全局消息广播 +- ✅ 新增实时连接监控 + +### 📚 文档完善 +- ✅ 新增WebSocket专用API文档 +- ✅ 提供交互式消息格式展示 +- ✅ 包含测试工具和示例代码 +- ✅ 完整的开发者指南 + +### 🔧 性能优化 +- ✅ 更高效的消息路由机制 +- ✅ 优化连接池管理 +- ✅ 增强错误处理和日志记录 `) - .setVersion('2.0.0') + .setVersion('2.1.0') .addTag('auth', '🔐 用户认证相关接口') .addTag('chat', '💬 聊天系统相关接口') + .addTag('websocket', '🔌 WebSocket接口文档和测试') .addTag('admin', '👑 管理员后台相关接口') .addBearerAuth( { @@ -135,8 +165,10 @@ async function bootstrap() { }, 'JWT-auth', ) - .addServer('http://localhost:3000', '开发环境') - .addServer('https://whaletownend.xinghangee.icu', '生产环境') + .addServer('http://localhost:3000', '开发环境 - REST API') + .addServer('https://whaletownend.xinghangee.icu', '生产环境 - REST API') + .addServer('wss://whaletownend.xinghangee.icu/game', '生产环境 - WebSocket') + .addServer('ws://localhost:3001/game', '开发环境 - WebSocket') .build(); const document = SwaggerModule.createDocument(app, config);