Skip to main content

WebChat(Gateway WebSocket UI)

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

它是什么

  • 网关的原生聊天 UI(无嵌入浏览器且无本地静态服务器)
  • 使用与其他渠道相同的会话和路由规则
  • 确定性路由:回复总是返回到 WebChat

快速开始

  1. 启动网关
  2. 打开 WebChat UI(macOS/iOS 应用)或 Control UI 的聊天标签页
  3. 确保配置了网关认证

工作原理

  • UI 连接到 Gateway WebSocket,使用 chat.historychat.sendchat.inject
  • chat.history 有界:网关可能截断长文本字段
  • chat.inject 直接将助手备注追加到聊天记录中
  • 中止的执行可以保留部分助手输出在 UI 中可见
  • 聊天历史总是从网关获取

Control UI 代理工具面板

  • Control UI 的 /agents 工具面板通过 tools.catalog 获取运行时目录
  • 如果 tools.catalog 不可用,面板会回退到内置静态列表

远程使用

  • 远程模式通过 SSH/Tailscale 隧道传输网关 WebSocket
  • 无需运行独立的 WebChat 服务器

配置参考 (WebChat)

相关全局选项:
  • gateway.portgateway.bind:WebSocket 主机/端口
  • gateway.auth.modegateway.auth.tokengateway.auth.password:WebSocket 认证
  • gateway.remote.urlgateway.remote.token:远程网关目标
  • session.*:会话存储和主键默认设置

相关文档