Drop the recommended model (Qwen3.8-Flash-Next) and the experimental one: Qwen3.6-35B-A3B passed every tool call and answers first. Replace game-mode actions (a)(b)(c) with automatic tuning: a normal and a game placement of the same model, computed per PC from VRAM, a first-run self-check that lowers defaults on slow PCs, and latency watching that lowers restart-free settings first. Record the agent-desktop results and choose the per-call CLI. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
85 lines
6.6 KiB
Markdown
85 lines
6.6 KiB
Markdown
# Windows 관리 앱 (exe)
|
|
|
|
## 첫 실행 마법사
|
|
|
|
1. **데이터 저장 위치 선택**: 폴더를 고르면 남은 용량을 확인하고(권장 200GB), 모델과 데이터가 전부 그 안에 저장된다고 안내합니다.
|
|
2. **PC 점검**: GPU, NVIDIA 드라이버 버전(CUDA 13용 580 이상), RAM, 디스크를 확인합니다. 드라이버가 오래됐으면 업데이트 링크를 보여 줍니다.
|
|
3. **모델 안내**: 받을 모델(Qwen3.6-35B-A3B, 약 23GB)의 크기와 예상 시간을 보여 줍니다. 고를 것은 없습니다. 설치가 끝나면 자가 점검으로 이 PC에 맞는 기본 설정을 정합니다([pc-features.md](pc-features.md#pc마다-값을-계산)).
|
|
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 드라이버. 시스템 구성 요소라 앱이 설치하지 않습니다.
|
|
|
|
그 외 다운로드, 캐시, 임시 파일은 모두 데이터 폴더로 보냅니다. 위치를 옮기는 "데이터 이동" 기능도 넣습니다.
|
|
|
|
## 설정 화면
|
|
|
|
| 화면 | 내용 |
|
|
|---|---|
|
|
| 대시보드 | 서비스 상태(디스코드, 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](conversation.md), [memory.md](memory.md), [pc-features.md](pc-features.md)에 있습니다.
|
|
|
|
## 로그 화면
|
|
|
|
오류가 나면 로그를 바로 복사하거나 파일로 받아서 디스코드로 보낼 수 있게 만듭니다.
|
|
|
|
- **보기**:
|
|
- 실시간으로 흘러가는 로그를 봅니다.
|
|
- 서비스별 탭: 앱, 디스코드, 채팅 채널, STT, LLM, TTS, 브라우저, 화면 캡처, 게임 감지
|
|
- 수준 필터(오류/경고/정보/디버그), 검색, 일시정지를 지원합니다.
|
|
- **복사**:
|
|
- 원하는 줄을 골라 복사합니다.
|
|
- "최근 오류 복사" 버튼은 마지막 오류 앞뒤 로그와 앱 버전, PC 사양 요약을 한 번에 복사합니다.
|
|
- 디스코드 메시지 길이(2,000자)를 넘으면 파일로 받으라고 안내합니다.
|
|
- **다운로드**: 기간을 골라 zip으로 저장합니다. 디스코드 첨부 한도(10MB) 안에 들어가게 압축합니다.
|
|
- **오류 알림**: 오류가 나면 대시보드에 알림이 뜨고, 알림에서 바로 "로그 복사"를 누를 수 있습니다.
|
|
- **비밀값 보호**: 복사·다운로드할 때 봇 토큰 같은 비밀값은 자동으로 지웁니다. 대화 내용을 가릴지는 내보낼 때 고릅니다(기본: 가림).
|
|
- **디버그 로그**: 평소에는 꺼 두고, 문제를 재현할 때만 켭니다.
|