Files
javis_bot/docs/v2/desktop-app.md
javis-bot e23a962923 feat(app): side menu in groups that open, settings split into tidy screens
The side menu keeps 대시보드 and 대화 on top and puts the rest in groups that
open when their name is pressed (디스코드, 대화 방식, 음성·모델, 기능, PC, 관리);
the shown screen's group opens and open groups are kept. 채널·호출 is split
into 음성 채널, 호출 and 여럿이 말할 때, and 모델 into 받아 적기·말하기 and 대화
모델; the chat wake words join 호출, the recording switch 음성 채널 and the
default location 기능 켜기·MCP.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-11-19 14:01:16 +09:00

7.6 KiB

Windows 관리 앱 (exe)

첫 실행 마법사

  1. 데이터 저장 위치 선택: 폴더를 고르면 남은 용량을 확인하고(권장 200GB), 모델과 데이터가 전부 그 안에 저장된다고 안내합니다.
  2. PC 점검: GPU, NVIDIA 드라이버 버전(CUDA 13용 580 이상), RAM, 디스크를 확인합니다. 드라이버가 오래됐으면 업데이트 링크를 보여 줍니다.
  3. 모델 안내: 받을 모델(Qwen3.6-35B-A3B, 약 23GB)의 크기와 예상 시간을 보여 줍니다. 고를 것은 없습니다. 설치가 끝나면 자가 점검으로 이 PC에 맞는 기본 설정을 정합니다(pc-features.md).
  4. 자동 설치: 다음을 데이터 폴더에 받습니다. 이어받기와 해시 검증을 지원합니다.
    • Python 런타임과 가상환경
    • CUDA 라이브러리
    • Strata
    • STT·TTS 모델
    • 크로미움
    • ffmpeg
  5. 디스코드 봇 연결: 아래 순서로 진행합니다.
    1. 봇 토큰 입력(숨김 표시)
    2. 연결 확인
    3. Message Content Intent 켜짐 확인
    4. 초대 링크 생성(채팅 채널 이름·주제 반영에 쓰는 채널 관리 권한 포함)
    5. 서버와 음성 채널 선택
    6. AI 채팅 채널 선택(건너뛰기 가능)
    7. 호출어 입력
    8. 슬래시 명령 등록
  6. 테스트: 마이크 없이도 "테스트 문장 읽기", "LLM 응답 확인" 버튼으로 각 부분을 확인합니다.

데이터 폴더 구조

<사용자가 고른 폴더>\
  config\     settings.json, secrets.dat (봇 토큰 등, Windows DPAPI로 암호화)
  runtime\    python\, venv\, strata\, ffmpeg\, chromium\
  models\     llm\ (Strata --data-dir), stt\, tts\, vad\
  memory\     대화 기록 저장소, 메모리, 식단 기록 DB (SQLite)
  browser\    앱 전용 크로미움 프로필
  collect\    백그라운드 수집 결과 (기본은 비어 있음)
  cache\      HF_HOME, pip/uv 캐시, 임시 파일(TEMP 재지정)
  logs\       서비스별 로그 (기간 지나면 자동 정리)

폴더 밖에 남는 것은 피할 수 없는 최소한입니다.

  1. 앱 실행 파일 자체. 설치 경로도 같은 폴더로 고를 수 있습니다.
  2. 데이터 폴더 위치를 기억하는 파일 1개(%APPDATA%\JarvisBot\location.json).
  3. NVIDIA 드라이버. 시스템 구성 요소라 앱이 설치하지 않습니다.

그 외 다운로드, 캐시, 임시 파일은 모두 데이터 폴더로 보냅니다. 위치를 옮기는 "데이터 이동" 기능도 넣습니다.

설정 화면

왼쪽 메뉴는 대시보드와 대화를 위에 두고, 나머지는 묶음으로 접어 둡니다(사용자 요청, 2026-11-19). 묶음 이름을 누르면 펼쳐집니다: 디스코드(봇, 음성 채널, 채팅 채널), 대화 방식(호출, 여럿이 말할 때, 대화 기억, 사람별 지침), 음성·모델(받아 적기·말하기, 대화 모델), 기능(기능 켜기·MCP, 예약, 백그라운드 수집), PC(PC 제어·화면 보기, 게임 모드), 관리(로그, 앱). 아래 표의 "채널·호출"은 음성 채널, 호출, 여럿이 말할 때 세 화면으로, "모델"은 받아 적기·말하기와 대화 모델로 나눴습니다. 화면마다 정확히 어떤 항목이 있는지는 admin.spec.md "Screens"에 있습니다.

화면 내용
대시보드 서비스 상태(디스코드, LLM, STT, TTS), GPU/VRAM/RAM 사용량, 현재 음성 채널과 참가자, 실시간 자막, 단계별 지연 시간, 성능 단계(평소/게임 중/일시정지와 이유), 놓친 요청, 봇 시작/정지
봇 봇 토큰, 애플리케이션 ID, 봇 이름(닉네임), 아바타, 상태 메시지, 성격(시스템 프롬프트), 슬래시 명령 이름, 명령 응답 공개 범위
채널·호출 서버·채널 선택, 자동 입장, 입장/퇴장 버튼, 최대 동시 화자 수(1~10), 호출어 목록, 호출 방식, 지정한 사람 목록과 "지정한 사람만 응답"·"호출어 없이 대답" 켜기/끄기, 동시 대화 응답 정책, 사람별 우선순위, 정지 명령, 입장 시 전사 고지 문구
채팅 채널 채널 목록(ID·이름·설명) 추가·수정·삭제, 디스코드에도 반영 여부, 채널별 AI 권한, 채팅 호출 방식
대화 기억 참고 범위, 최근 대화 원문 양, 과거 기록 가져올 개수, 참고 분량 상한, 등록한 채팅 채널 참고 켜기/끄기, 같은 음성 채널의 다른 사람 말 참고 켜기/끄기, 보관 기간
모델 LLM 모델 상태(다운로드·다시 받기), STT 모델(turbo/medium/small), 말 끝 판정 시간, TTS 엔진·목소리·속도, 각 모델 테스트 버튼
기능 메모리, 날씨, 웹 검색, 식단 기록, 브라우저 제어, PC 제어, 화면 보기, 백그라운드 수집 각각 켜기/끄기와 세부 설정. MCP 서버 추가·삭제·켜기/끄기
게임 모드 게임 감지 켜기/끄기, 게임용으로 비울 VRAM(기본 8GB), 게임 중 일시정지 켜기/끄기(기본 꺼짐), 되돌리기 대기 시간, 게임 목록과 "게임 아님" 목록, 현재 감지 상태
PC 제어 실시간 화면 미리보기, GUI에서 키보드·마우스 조작, 허용 범위(보기만 / 브라우저만 / 전체), 비상 정지 단축키, 안티치트 감지 목록 보기·추가
화면 보기 볼 수 있는 대상(전체 화면, 모니터별, 창별), 캡처 제외 프로그램 목록, 볼 수 있는 조건, 캡처 미리 준비(말하는 중에만/항상/끔), 기본 화질 단계, 화면공유 창 분리 대기 시간, "봇용 크롬창 화면공유 선택 표시" 켜기/끄기
백그라운드 수집 수집 대상(사이트, 검색어, RSS), 주기, 보관 기간, 결과 보기. 기본 수집 대상은 비워 둠
데이터 폴더별 사용량, 캐시 정리, 데이터 이동, 설정 내보내기/가져오기, 메모리 백업
대화 사람이 한 말, 자비스의 답, 자비스가 답을 만든 과정(참고한 기록, 고른 도구, 계획, 도구 호출과 결과, 모델 생각)을 시간순으로 보기. 종류·장소·사람·채널·날짜·글자로 거르기, 실시간 따라가기
로그 실시간 로그 보기·검색·복사·다운로드
업데이트 새 버전 확인과 설치 (Gitea 릴리스 기준)

기능별 세부 동작은 conversation.md, memory.md, pc-features.md에 있습니다.

로그 화면

오류가 나면 로그를 바로 복사하거나 파일로 받아서 디스코드로 보낼 수 있게 만듭니다.

  • 보기:
    • 실시간으로 흘러가는 로그를 봅니다.
    • 서비스별 탭: 앱, 디스코드, 채팅 채널, STT, LLM, TTS, 브라우저, 화면 캡처, 게임 감지
    • 수준 필터(오류/경고/정보/디버그), 검색, 일시정지를 지원합니다.
  • 복사:
    • 원하는 줄을 골라 복사합니다.
    • "최근 오류 복사" 버튼은 마지막 오류 앞뒤 로그와 앱 버전, PC 사양 요약을 한 번에 복사합니다.
    • 디스코드 메시지 길이(2,000자)를 넘으면 파일로 받으라고 안내합니다.
  • 다운로드: 기간을 골라 zip으로 저장합니다. 디스코드 첨부 한도(10MB) 안에 들어가게 압축합니다.
  • 오류 알림: 오류가 나면 대시보드에 알림이 뜨고, 알림에서 바로 "로그 복사"를 누를 수 있습니다.
  • 비밀값 보호: 복사·다운로드할 때 봇 토큰 같은 비밀값은 자동으로 지웁니다. 대화 내용을 가릴지는 내보낼 때 고릅니다(기본: 가림).
  • 디버그 로그: 평소에는 꺼 두고, 문제를 재현할 때만 켭니다.