WebUI
WebUI 是浏览器里的对话客户端。Gateway 在自己的源上静态托管它——不需要单独 部署前端服务。
打开方式
Gateway 运行中,在另一个终端执行:
bash
qwenaudio webui命令会打印页面地址(默认 http://127.0.0.1:3101)并用默认浏览器打开。 首次使用时浏览器会请求麦克风权限,允许后才能语音对话。
界面默认跟随浏览器首选语言(中文或英文);如需临时指定,可在地址中添加 ?lang=zh 或 ?lang=en。
选项:
| 选项 | 含义 |
|---|---|
--url URL | 连接其他地址的 Gateway(默认 http://127.0.0.1:3101) |
--session ID | 复用指定的语音会话 |
--no-open | 只打印地址,不打开浏览器 |
能做什么
- 全双工语音——自然说话、随时打断,实时转写同步显示。
- 文本与附件——输入文字、添加图片或文件;普通附件可交后台处理,不要求语音模型直接看图。
- 任务视图——跟随派发给后台 Agent 的后台任务,包括进度与最终结果。
支持视频输入时,顶部会增加“开启视频”按钮,点击打开摄像头小窗;麦克风仍由原来的按钮独立控制。关闭视频不影响语音。步骤见视觉输入。普通附件的处理方式见对话与附件。 顶部“资料库”入口用于导入本机文档,不是聊天附件上传。
与其他客户端的关系
TUI、WebUI、桌面悬浮球都使用同一套 Gateway Client Protocol。一个 Gateway 对每个用户只接受一个活动 Client 连接;另一客户端可在确认后接管,旧连接会断开。 桌面版也可以运行自己的 Gateway 进程,并与 CLI 共享用户配置。桌面版的对话窗口 复用同一套 WebUI 页面,因此各端的展示行为保持一致。
从远程浏览器访问
使用远程连接生成的完整链接,可通过 Tailnet 或自有 HTTPS 入口访问。远程收音要求可信 HTTPS;不要直接公开本机端口,也不要仅为收音问题关闭浏览器安全设置。