프로젝트 소개

더우인 라이브 방송을 위한 세로형 AI 해구탕(상황 추리 수수께끼) 인터랙티브 게임입니다. 시스템이 기묘한 수수께끼를 자동 생성하고, 시청자는 '#질문' 탄막을 보내 추가 질문을 합니다. AI는 모든 질문에 '예/아니오/무관/접근/정답 공개' 등의 판정을 즉시 내려줍니다. 누군가 핵심 진실을 맞히거나 설정된 시간에 도달하면 자동으로 정답을 공개하고 다음 문제로 넘어가므로, 장시간 무인 운영에 적합합니다. 프로젝트는 오프라인 시뮬레이션, 상태 머신 테스트, 실제 라이브 방송 연결, 수동 탄막 입력 등 다양한 실행 방식을 제공하며, 1080×1920 세로형 웹 인터페이스가 내장되어 있어 라이브 방송 도우미의 창 캡처 또는 브라우저 소스와 함께 사용할 수 있습니다. 인터페이스에는 문제 표시, 스크롤형 질문-답변 흐름, 판정 배지 색상, 무관 메시지 접기, 카운트다운 안내, 누적 해구탕 랭킹이 포함됩니다. 기술적으로 하위 계층은 더우인 탄막을 읽기 전용으로 수집하며, 메시지를 보내거나 라이브 방송을 제어하지 않습니다. 핵심 발견은 강제 도구 호출(tool_choice)을 사용하여 모델이 스키마 검증을 거친 구조화된 판정을 반환하게 함으로써 파싱 실패율을 크게 낮추고 정답 판정을 안정적으로 트리거하는 것입니다. 동시에 관대한 파서를 폴백으로 유지합니다. 프로젝트는 여러 LLM 인터페이스와 다중 모델 별칭 라우팅을 지원하며, 각 단계(출제, 문제 검토, 질문-답변, 심판, 힌트, 정답 공개)별로 모델을 개별 설정할 수 있습니다. 데이터는 JSONL로 디스크에 저장되고, 랭킹은 라이브 방송 간에 영구 유지되며, 구버전 랭킹 마이그레이션 도구도 제공합니다.