WebChat

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.history 为保持稳定性而受限：Gateway(网关) 网关 可能会截断长文本字段、省略繁重的元数据，并用 [chat.history omitted: message too large] 替换超大条目。
• chat.inject 将助手备注直接附加到记录并广播到 UI（不运行代理）。
• 中止的运行可以使部分助手输出在 UI 中保持可见。
• 当存在缓冲输出时，Gateway(网关) 网关 会将中止的部分助手文本保存到记录单历史记录中，并用中止元数据标记这些条目。
• 历史记录始终从网关获取（无本地文件监视）。
• 如果无法访问网关，WebChat 将变为只读。

控制 UI 代理工具面板

• 控制 UI /agents 工具面板有两个独立的视图：
  • 当前可用 使用 tools.effective(sessionKey=...) 并显示当前 会话在运行时实际可用的内容，包括核心、插件和渠道拥有的工具。
  • 工具配置 使用 tools.catalog 并专注于配置文件、覆盖和 目录语义。
• 运行时可用性是会话范围的。在同一代理上切换会话可能会更改 当前可用 列表。
• 配置编辑器并不暗示运行时可用性；有效访问仍然遵循策略 优先级 (allow/deny，以及每个代理和提供商/渠道的覆盖)。

远程使用

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

配置参考 (WebChat)

完整配置：配置

WebChat 选项：

• gateway.webchat.chatHistoryMaxChars：chat.history 响应中文本字段的最大字符数。当条目超过此限制时，Gateway(网关)将截断长文本字段，并可能会用占位符替换过大的消息。客户端还可以发送每个请求的 maxChars，以针对单个 chat.history 调用覆盖此默认值。

相关全局选项：

• gateway.port、gateway.bind：WebSocket 主机/端口。
• gateway.auth.mode、gateway.auth.token、gateway.auth.password：WebSocket 认证（令牌/密码）。
• gateway.auth.mode: "trusted-proxy"：针对浏览器客户端的反向代理认证（请参阅可信代理认证）。
• gateway.remote.url、gateway.remote.token、gateway.remote.password：远程网关目标。
• session.*：会话存储和主键默认值。