体验四个 Demo
一键启动即时聊天、流式回复、在线客服和 Agent，选择场景开始体验。
1. 一键启动
准备 Go 1.25+、Node.js 22.12+（或 20.19+）和 npm。在当前仓库根目录运行：
node demo/start.mjs启动器会准备一个 256 hash slots 的单节点集群和所需业务服务，自动打开首页。首次需要下载依赖；默认模拟模型无需 Key。
首页默认是 http://127.0.0.1:5174/demos/，占用时使用空闲端口。以终端输出和自动打开的地址为准；各 Demo 已自动连接本次集群。按 Ctrl+C 关闭本次全部进程。
从首页选一个场景；每个 Demo 顶部都有“返回首页”。截图来自本地 main，发布镜像中的入口取决于其版本。
2. 选一个场景
| Demo | 先做什么 | 可以体验 |
|---|---|---|
| 即时聊天 | 登录 Alice 与 Bob | 单聊、群聊、消息编辑、历史恢复 |
| 流式回复 | 创建演示账号并连接，发送一个问题 | 逐段回复、取消、失败与恢复 |
| 在线客服 | 开始演示，访客提问后转人工，客服接入 | AI 接待、人工接管、多访客会话 |
| Agent | 开始演示，发起任务并查看工具卡片 | 工具调用、待办确认、暂停与取消 |
这四个 Demo 来自当前源码；只启动 Docker 容器不会启动客服或 Agent 的 Node 业务后端。完整体验使用上面的一键启动。源码及独立运行方式见 demo/README.md。
仅用于本机测试
启动器只监听本机。聊天 Demo 的“创建或更新演示凭据”会写入测试 UID 的 Token；已有账号与迁移验收保持不勾选。生产身份与权限应由受信任的业务后端管理。
已有 Linux / Docker 集群：访问 Chat Demo
访问方式
| 环境 | Chat Demo 地址 | API 基地址 |
|---|---|---|
| Linux / Docker 单节点集群 | http://127.0.0.1:5001/demo/ | 页面同源 |
| 仓库三节点 Compose | http://127.0.0.1:15001/demo/ | 页面同源 |
需要连接另一个 API 地址时，可以使用：
http://127.0.0.1:5001/demo/?apiurl=http://host:portDemo 先调用 /route 获取客户端 WebSocket 地址，再使用 JavaScript SDK 建立长连接。
排查连接地址
在浏览器开发者工具的 Network 中检查 /route 响应。默认 Docker 端口映射下，未填写 api.external_ws_addr 时，ws_addr 应使用本次 API 请求的主机名及 Gateway 端口 5200。Linux 初始化默认监听 127.0.0.1:5200，通过 SSH 同时转发 5001 和 5200 即可体验，无需填写对外地址。
如果响应仍包含 ws://0.0.0.0:5200，确认使用包含自动补全修复的版本，并检查是否显式配置了通配对外地址。旧版本可在已有 [api] 中设置 external_ws_addr = "ws://127.0.0.1:5200" 后重启；直接远程访问时使用客户端可达的服务器地址和外部端口。环境变量 WK_EXTERNAL_WSADDR 优先于 TOML。
页面可打开但 WebSocket 连接失败时，检查 Docker 映射或 SSH 转发是否包含 5200。非默认映射端口、独立域名或 HTTPS/WSS 代理需要显式对外地址及实际可用的 TLS/WebSocket 入口，详见 Docker 部署。
登录字段
- API 基地址：WuKongIM HTTP API 地址。
- 登录账号：业务系统中的唯一用户 UID。
- 登录 Token：已有用户的 Web 设备 Token。默认直接连接，不调用
/user/token，不修改服务端凭据。 - 创建或更新演示凭据：仅为专用测试账号显式勾选；此模式会调用
/user/token写入 Web 从设备凭据。
凭据仅保存在当前标签页的 sessionStorage，不放进 URL。刷新页面或点击“重新同步”
会重建 SDK 的消息、会话和游标状态，再向服务器同步；退出时删除本 Demo 的凭据。
重新同步前应先处理未发送草稿，Demo 会在输入框还有内容时阻止该操作。
迁移验收请使用默认的已有 Token 模式。此行为仅覆盖 Demo 自己的内存缓存，不会 清理其他业务 App 的消息数据库，也不代表其他客户端已完成迁移适配。
相同 UID 和相同设备标记的主设备连接可能互相替换。并行测试时请使用不同 UID，或使用独立浏览器会话。