下一步
根据接入、配置、部署和运维目标选择后续阅读路径。
如果就绪检查成功、两个测试 UID 都已连接，并且能够双向收发消息，你已经完成本地开发闭环。
选择阅读路径
核心概念
理解频道顺序、消息提交、用户、设备、会话、节点和 Slot。
集成指南
划分业务职责，设计认证、消息收发和 Webhook。
场景教程
继续实现单聊、群聊和十万成员群路径。
部署
从拓扑和运行介质开始，完成配置、验证与生产门禁。
选择 SDK
从平台和接入方式出发，进入安装、能力、API 与升级学习路径。
API 与协议
查阅已发布接口、客户端协议核心和公共字典。
服务端参考
按需查阅配置、运维、工具和架构。
常见问题
单节点集群是不是独立模式？
不是。它是只有一个节点的集群，仍使用 Controller、Slot、Channel、路由和持久化路径。
可以把示例配置直接用于生产吗？
不可以。至少需要替换固定凭据，规划 TLS 和访问控制，把数据放在受管理的持久化存储上，并按真实负载验证容量、故障恢复和尾延迟。
为什么重启后还能看到数据？
示例配置把节点数据保存在 ./data/wukongim-single-node-data。停止进程不会删除这个目录。
如何修改端口？
复制 wukongim.toml.example 后，修改本地 wukongim.toml 中的 API、Manager、Gateway 和集群监听地址，再重启节点。不要改动示例模板来保存本机差异。
为什么生产客户端不能调用 /user/token？
这是演示身份接口。生产 Token 必须由受信任的业务后端在完成真实身份和权限校验后签发或更新。
三节点环境在哪里？
仓库根目录的 docker-compose.yml 提供三节点开发环境。它会暴露开发凭据和 Benchmark 能力，同样不能作为生产模板。
文档状态
本页列出的中英文路径已经发布，并会进入搜索、Sitemap 和 LLM 输出。能被检索只代表正文通过发布校验，不代表目标客户端、设备或生产集群已经完成运行验收。