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.sendchat.inject를 사용합니다.
  • chat.inject는 어시스턴트 메모를 트랜스크립트에 직접 추가하고 UI에 브로드캐스트합니다 (agent 실행 없음).
  • 히스토리는 항상 Gateway에서 가져옵니다 (로컬 파일 감시 없음).
  • Gateway에 연결할 수 없으면 WebChat은 읽기 전용입니다.

원격 사용

  • 원격 모드는 SSH/Tailscale을 통해 Gateway WebSocket을 터널링합니다.
  • 별도의 WebChat 서버를 실행할 필요가 없습니다.

구성 참조 (WebChat)

전체 구성: Configuration

채널 옵션:

  • 전용 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.*: 세션 저장소 및 메인 키 기본값.