快速开始

1. 准备环境

• Go 1.25+
• MySQL 或 PostgreSQL、Redis
• （集群部署时）RabbitMQ 或 NATS JetStream

2. 构建

make build-basic        # 基础版
# 或 make build-full    # 旗舰版（含 AI 与企业能力）

产物在 bin/basic/websocket（其他版本在对应目录）。

3. 配置

cp config/app.yaml.example config/app.yaml

最少修改两处：数据库连接、Redis 地址。单机体验无需配置 RabbitMQ / NATS。

默认端口：HTTP 8080（WebSocket 内嵌在同端口，路径 /acc）、gRPC 9001。如在配置中开启 standalone_websocket_enabled，WebSocket 将独立监听 8089。

4. 初始化数据库

按 migrations/README.md 的说明依次应用 SQL 迁移文件。

5. 启动与验证

./bin/basic/websocket

另开一个终端，用 JWT 连一条 WebSocket：

npx wscat -c "ws://localhost:8080/acc?token=<JWT>"

连接成功后，按《客户端接入指南》发送登录与消息命令即可开始收发消息。生产环境建议经 Nginx 把 /acc 反代到 WebSocket 端口。