diff --git a/src/business/zulip/chat.controller.ts b/src/business/zulip/chat.controller.ts index 433b2ba..d83f8f2 100644 --- a/src/business/zulip/chat.controller.ts +++ b/src/business/zulip/chat.controller.ts @@ -364,6 +364,11 @@ export class ChatController { 'chat_render', // 接收到聊天消息 'error', // 通用错误 ], + quickLinks: { + testPage: '/websocket-test?from=chat-api', + apiDocs: '/api-docs', + connectionInfo: '/websocket-api/connection-info' + }, authRequired: true, tokenType: 'JWT', tokenFormat: { diff --git a/src/business/zulip/websocket_openapi.controller.ts b/src/business/zulip/websocket_openapi.controller.ts index bc5a561..3712856 100644 --- a/src/business/zulip/websocket_openapi.controller.ts +++ b/src/business/zulip/websocket_openapi.controller.ts @@ -197,6 +197,10 @@ export class WebSocketOpenApiController { - ✅ 统一使用 /game 路径 - ✅ 支持地图房间管理 - ✅ 实现消息广播机制 + +**快速测试**: +- 🧪 [WebSocket 测试页面](/websocket-test?from=api-docs) - 交互式测试工具 +- 📚 [完整 API 文档](/api-docs) - 返回 Swagger 文档 ` }) @ApiResponse({ @@ -689,13 +693,12 @@ ws.on('error', function(error) { ` }, testingSteps: [ - '1. 获取有效的JWT Token(通过 /auth/login 接口)', - '2. 使用WebSocket客户端连接到 wss://whaletownend.xinghangee.icu/game', - '3. 发送login消息进行认证', - '4. 验证收到login_success响应', - '5. 发送chat消息测试聊天功能', - '6. 发送position消息测试位置更新', - '7. 观察其他客户端的消息广播' + '1. 访问测试页面: /websocket-test?from=api-docs', + '2. 点击"🚀 一键测试"按钮自动完成所有步骤', + '3. 或手动操作: 获取JWT Token → 连接 → 登录', + '4. 发送chat消息测试聊天功能', + '5. 发送position消息测试位置更新', + '6. 观察其他客户端的消息广播' ], troubleshooting: { connectionFailed: [