WebChat (Gateway WebSocket UI)

状态：macOS/iOS SwiftUI 聊天界面直接连接到 Gateway WebSocket。

它是什么

• Gateway 的原生聊天界面（无需内嵌浏览器，也不需要本地静态服务器）。
• 使用与其他 Channel 相同的 Session 和 Routing 规则。
• 确定性路由：回复始终返回到 WebChat。

快速开始

1. 启动 Gateway。
2. 打开 WebChat UI（macOS/iOS 应用）或 Control UI 的聊天标签页。
3. 确保 Gateway 认证已配置（默认必需，即使在 loopback 上也是如此）。

工作原理（行为）

• UI 连接到 Gateway WebSocket 并使用 chat.history、chat.send 和 chat.inject。
• chat.inject 直接将助手备注追加到对话记录中，并广播到 UI（不运行 Agent）。
• 历史记录始终从 Gateway 获取（不监听本地文件）。
• 如果 Gateway 无法访问，WebChat 为只读模式。

远程使用

• 远程模式通过 SSH/Tailscale 隧道连接 Gateway WebSocket。
• 你不需要运行单独的 WebChat 服务器。

配置参考（WebChat）

完整配置：配置

Channel 选项：

• 没有专用的 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.*：Session 存储和主密钥默认值。