​

WebChat (Giao diện WebSocket Gateway)

​

WebChat là gì

• Giao diện chat native cho gateway (không nhúng trình duyệt và không có máy chủ tĩnh cục bộ).
• Sử dụng cùng các phiên và quy tắc định tuyến như các kênh khác.
• Định tuyến xác định: phản hồi luôn quay lại WebChat.

​

Khởi động nhanh

1. Khởi động gateway.
2. Mở giao diện WebChat (ứng dụng macOS/iOS) hoặc tab chat của Control UI.
3. Đảm bảo xác thực gateway đã được cấu hình (mặc định là bắt buộc, kể cả trên local loopback).

​

Cách hoạt động (hành vi)

• UI kết nối tới Gateway WebSocket và sử dụng chat.history, chat.send và chat.inject.
• chat.inject thêm một ghi chú của trợ lý trực tiếp vào bản ghi hội thoại và phát tới UI (không chạy agent).
• Lịch sử luôn được lấy từ gateway (không theo dõi tệp cục bộ).
• Nếu gateway không truy cập được, WebChat ở chế độ chỉ đọc.

​

Sử dụng từ xa

• Chế độ từ xa tạo đường hầm Gateway WebSocket qua SSH/Tailscale.
• Bạn không cần chạy một máy chủ WebChat riêng.

​

Tham chiếu cấu hình (WebChat)

• Không có khối webchat.* riêng biệt. WebChat sử dụng endpoint của gateway + các thiết lập xác thực bên dưới.

• gateway.port, gateway.bind: máy chủ/cổng WebSocket.
• gateway.auth.mode, gateway.auth.token, gateway.auth.password: xác thực WebSocket.
• gateway.remote.url, gateway.remote.token, gateway.remote.password: đích gateway từ xa.
• session.*: lưu trữ phiên và các giá trị mặc định của khóa chính.
• session.*: lưu trữ phiên và các giá trị mặc định của khóa chính.