WebChat (Gateway WebSocket UI)

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

简介

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

快速开始

1. 启动网关。
2. 打开 WebChat UI(macOS/iOS 应用)或控制 UI 的聊天标签页。
3. 确保已配置网关身份验证(默认情况下必需,即使在回环上)。

工作原理(行为)

• UI 连接到 Gateway WebSocket 并使用 chat.history、chat.send 和 chat.inject。
• chat.inject 直接将助手注释追加到转录文本并广播到 UI(无代理运行)。
• 历史记录始终从网关获取(无本地文件监视)。
• 如果网关不可达,WebChat 为只读模式。

远程使用

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

配置参考(WebChat)

完整配置:配置

渠道选项:

• 无专用的 webchat.* 块。WebChat 使用下面的网关端点 + 身份验证设置。

相关全局选项:

• gateway.port、gateway.bind:WebSocket 主机/端口。
• gateway.auth.mode、gateway.auth.token、gateway.auth.password:WebSocket 身份验证。
• gateway.remote.url、gateway.remote.token、gateway.remote.password:远程网关目标。
• session.*:会话存储和主密钥默认值。