Skip to content

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;不要直接公开本机端口,也不要仅为收音问题关闭浏览器安全设置。