WebChat（Gateway WebSocket UI�?

状态：macOS/iOS SwiftUI 聊天 UI 直接连接�?Gateway WebSocket�?

是什�?

• 一个用�?gateway 的原生聊�?UI（无嵌入式浏览器和本地静态服务器）�?
• 使用与其他频道相同的会话和路由规则�?
• 确定性路由：回复始终回到 WebChat�?

快速开�?

1. 启动 gateway�?
2. 打开 WebChat UI（macOS/iOS 应用）或 Control UI 聊天标签�?
3. 确保 gateway 认证已配置（默认需要，即使�?loopback 上）�?

工作原理（行为）

• UI 连接�?Gateway WebSocket 并使�?chat.history、chat.send �?chat.inject�?
• chat.history 有界限以保持稳定性：Gateway 可能会截断长文本字段、省略重元数据，并用 [chat.history omitted: message too large] 替换过大的条目�?
• chat.inject 直接将助手笔记追加到记录中并广播�?UI（无代理运行）�?
• 中止的运行可以让部分助手输出�?UI 中保持可见�?
• 当存在缓冲输出时，Gateway 将中止的部分助手文本持久化到记录历史中，并用中止元数据标记这些条目�?
• 历史始终�?gateway 获取（无本地文件监视）�?
• 如果 gateway 不可达，WebChat 是只读的�?

Control UI 代理工具面板

• Control UI /agents 工具面板通过 tools.catalog 获取运行时目录，并将每个工具标记�?core �?plugin:<id>（加上可选插件工具的 optional）�?
• 如果 tools.catalog 不可用，面板回退到内置静态列表�?
• 面板编辑配置文件和覆盖配置，但有效运行时访问仍遵循策略优先级（allow/deny、每代理�?provider/频道覆盖）�?

远程使用

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

配置参考（WebChat�?

完整配置：配置

频道选项�?

• 没有专用�?webchat.* 块。WebChat 使用下面�?gateway 端点 + 认证设置�?

相关全局选项�?

• gateway.port、gateway.bind：WebSocket 主机/端口�?
• gateway.auth.mode、gateway.auth.token、gateway.auth.password：WebSocket 认证（token/密码）�?
• gateway.auth.mode: "trusted-proxy"：反向代理认证用于浏览器客户端（参见可信代理认证）�?
• gateway.remote.url、gateway.remote.token、gateway.remote.password：远�?gateway 目标�?
• session.*：会话存储和主键默认值�?