Replace the root README with the v2 plan (game PC fully local, Windows management app) and split the plan into docs/v2/*.md: architecture, voice-and-llm, conversation, memory, desktop-app, pc-features, privacy, roadmap, decisions. The v1 README moves to docs/v1/README.md with its relative links fixed; .env.example points to the new location. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.3 KiB
6.3 KiB
Windows 관리 앱 (exe)
첫 실행 마법사
- 데이터 저장 위치 선택: 폴더를 고르면 남은 용량을 확인하고(권장 200GB), 모델과 데이터가 전부 그 안에 저장된다고 안내합니다.
- PC 점검: GPU, NVIDIA 드라이버 버전(CUDA 13용 580 이상), RAM, 디스크를 확인합니다. 드라이버가 오래됐으면 업데이트 링크를 보여 줍니다.
- 모델 프리셋 선택: 빠름 / 권장 중에서 고르면 다운로드 크기와 예상 시간을 보여 줍니다.
- 자동 설치: 다음을 데이터 폴더에 받습니다. 이어받기와 해시 검증을 지원합니다.
- Python 런타임과 가상환경
- CUDA 라이브러리
- Strata
- STT·TTS 모델
- 크로미움
- ffmpeg
- 디스코드 봇 연결: 아래 순서로 진행합니다.
- 봇 토큰 입력(숨김 표시)
- 연결 확인
- Message Content Intent 켜짐 확인
- 초대 링크 생성
- 서버와 음성 채널 선택
- AI 채팅 채널 선택(건너뛰기 가능)
- 호출어 입력
- 슬래시 명령 등록
- 테스트: 마이크 없이도 "테스트 문장 읽기", "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개(
%APPDATA%\JarvisBot\location.json). - NVIDIA 드라이버. 시스템 구성 요소라 앱이 설치하지 않습니다.
그 외 다운로드, 캐시, 임시 파일은 모두 데이터 폴더로 보냅니다. 위치를 옮기는 "데이터 이동" 기능도 넣습니다.
설정 화면
| 화면 | 내용 |
|---|---|
| 대시보드 | 서비스 상태(디스코드, LLM, STT, TTS), GPU/VRAM/RAM 사용량, 현재 음성 채널과 참가자, 실시간 자막, 단계별 지연 시간, 게임 모드 상태, 놓친 요청, 봇 시작/정지 |
| 봇 | 봇 토큰, 애플리케이션 ID, 봇 이름(닉네임), 아바타, 상태 메시지, 성격(시스템 프롬프트), 슬래시 명령 이름, 명령 응답 공개 범위 |
| 채널·호출 | 서버·채널 선택, 자동 입장, 입장/퇴장 버튼, 최대 동시 화자 수(1~10), 호출어 목록, 호출 방식, 지정한 사람 목록과 "지정한 사람만 응답"·"호출어 없이 대답" 켜기/끄기, 동시 대화 응답 정책, 사람별 우선순위, 정지 명령, 입장 시 전사 고지 문구 |
| 채팅 채널 | 채널 목록(ID·이름·설명) 추가·수정·삭제, 디스코드에도 반영 여부, 채널별 AI 권한, 채팅 호출 방식 |
| 대화 기억 | 참고 범위, 최근 대화 원문 양, 과거 기록 가져올 개수, 참고 분량 상한, 참고할 기록 대상, 보관 기간 |
| 모델 | LLM 프리셋(빠름/권장/사용자 지정) 다운로드·전환·삭제, STT 모델(turbo/medium/small), 말 끝 판정 시간, TTS 엔진·목소리·속도, 각 모델 테스트 버튼 |
| 기능 | 메모리, 날씨, 웹 검색, 식단 기록, 브라우저 제어, PC 제어, 화면 보기, 백그라운드 수집 각각 켜기/끄기와 세부 설정. MCP 서버 추가·삭제·켜기/끄기 |
| 게임 모드 | 게임 감지 켜기/끄기, 동작 (a) RAM 위주로 · (b) 빠름 모델로 · (c) 일시정지 각각 켜기/끄기, 게임용으로 비울 VRAM, 되돌리기 대기 시간, 게임 목록과 "게임 아님" 목록, 현재 감지 상태 |
| PC 제어 | 실시간 화면 미리보기, GUI에서 키보드·마우스 조작, 허용 범위(보기만 / 브라우저만 / 전체), 비상 정지 단축키, 안티치트 감지 목록 보기·추가 |
| 화면 보기 | 볼 수 있는 대상(전체 화면, 모니터별, 창별), 캡처 제외 프로그램 목록, 볼 수 있는 조건, 캡처 미리 준비(말하는 중에만/항상/끔), 기본 화질 단계, 화면공유 창 분리 대기 시간, "봇용 크롬창 화면공유 선택 표시" 켜기/끄기 |
| 백그라운드 수집 | 수집 대상(사이트, 검색어, RSS), 주기, 보관 기간, 결과 보기. 기본 수집 대상은 비워 둠 |
| 데이터 | 폴더별 사용량, 캐시 정리, 데이터 이동, 설정 내보내기/가져오기, 메모리 백업 |
| 로그 | 실시간 로그 보기·검색·복사·다운로드 |
| 업데이트 | 새 버전 확인과 설치 (Gitea 릴리스 기준) |
기능별 세부 동작은 conversation.md, memory.md, pc-features.md에 있습니다.
로그 화면
오류가 나면 로그를 바로 복사하거나 파일로 받아서 디스코드로 보낼 수 있게 만듭니다.
- 보기:
- 실시간으로 흘러가는 로그를 봅니다.
- 서비스별 탭: 앱, 디스코드, 채팅 채널, STT, LLM, TTS, 브라우저, 화면 캡처, 게임 감지
- 수준 필터(오류/경고/정보/디버그), 검색, 일시정지를 지원합니다.
- 복사:
- 원하는 줄을 골라 복사합니다.
- "최근 오류 복사" 버튼은 마지막 오류 앞뒤 로그와 앱 버전, PC 사양 요약을 한 번에 복사합니다.
- 디스코드 메시지 길이(2,000자)를 넘으면 파일로 받으라고 안내합니다.
- 다운로드: 기간을 골라 zip으로 저장합니다. 디스코드 첨부 한도(10MB) 안에 들어가게 압축합니다.
- 오류 알림: 오류가 나면 대시보드에 알림이 뜨고, 알림에서 바로 "로그 복사"를 누를 수 있습니다.
- 비밀값 보호: 복사·다운로드할 때 봇 토큰 같은 비밀값은 자동으로 지웁니다. 대화 내용을 가릴지는 내보낼 때 고릅니다(기본: 가림).
- 디버그 로그: 평소에는 꺼 두고, 문제를 재현할 때만 켭니다.