Skip to content

WebChat (Gateway WebSocket界面)

状态:macOS/iOS SwiftUI聊天界面直接与Gateway WebSocket通信。

这是什么

  • 一个原生的gateway聊天界面(无嵌入式浏览器,无本地静态服务器)。
  • 使用与其他通道相同的会话和路由规则。
  • 确定性路由:回复始终返回WebChat。

快速开始

  1. 启动gateway。
  2. 打开WebChat界面(macOS/iOS应用)或控制界面的聊天标签页。
  3. 确保gateway认证已配置(默认需要,即使在环回上)。

工作原理(行为)

  • UI连接到Gateway WebSocket并使用 chat.historychat.sendchat.inject
  • chat.inject 直接将助手备注附加到转录中并广播到UI(无代理运行)。
  • 历史记录始终从gateway获取(无本地文件监视)。
  • 如果gateway无法访问,WebChat为只读模式。

远程使用

  • 远程模式通过SSH/Tailscale隧道传输gateway WebSocket。
  • 您不需要运行单独的WebChat服务器。

配置参考(WebChat)

完整配置:Configuration

通道选项:

  • 无专用的 webchat.* 块。WebChat使用gateway端点 + 下面的认证设置。

相关全局选项:

  • gateway.port, gateway.bind: WebSocket主机/端口。
  • gateway.auth.mode, gateway.auth.token, gateway.auth.password: WebSocket认证。
  • gateway.remote.url, gateway.remote.token, gateway.remote.password: 远程gateway目标。
  • session.*: 会话存储和主键默认值。