diff --git a/app/shell/installer.nsi b/app/shell/installer.nsi new file mode 100644 index 0000000..ae74dfc --- /dev/null +++ b/app/shell/installer.nsi @@ -0,0 +1,212 @@ +; The Jarvis installer (admin.spec.md, "Installer"). Built on Linux by installer.sh with makensis: +; makensis -DVERSION=0.1.0 -DSRC= -DOUT= -DICON= -DWEBVIEW2= installer.nsi +; Program Files, one administrator prompt; the data folder is chosen by the app's first-run wizard +; and never touched here. /S installs silently (the app's updates: /S /RUN starts the app afterwards). + +Unicode true +SetCompressor /SOLID lzma +!include "MUI2.nsh" +!include "x64.nsh" +!include "LogicLib.nsh" +!include "FileFunc.nsh" + +!define UNINST_KEY "Software\Microsoft\Windows\CurrentVersion\Uninstall\JarvisBot" +!define WEBVIEW2_KEY "SOFTWARE\WOW6432Node\Microsoft\EdgeUpdate\Clients\{F3017226-FE2A-4295-8BDF-00C3A9A7E4C5}" + +Name "Jarvis" +OutFile "${OUT}" +InstallDir "$PROGRAMFILES64\Jarvis" +InstallDirRegKey HKLM "Software\JarvisBot" "InstallDir" +RequestExecutionLevel admin +BrandingText "Jarvis ${VERSION}" +VIProductVersion "${VERSION}.0" +VIAddVersionKey /LANG=0 "ProductName" "Jarvis" +VIAddVersionKey /LANG=0 "FileVersion" "${VERSION}" +VIAddVersionKey /LANG=0 "FileDescription" "Jarvis 설치" +VIAddVersionKey /LANG=0 "LegalCopyright" "MIT" + +!define MUI_ICON "${ICON}" +!define MUI_UNICON "${ICON}" +!define MUI_ABORTWARNING +!define MUI_FINISHPAGE_RUN +!define MUI_FINISHPAGE_RUN_TEXT "Jarvis 실행" +!define MUI_FINISHPAGE_RUN_FUNCTION RunAsUser +!insertmacro MUI_PAGE_DIRECTORY +!insertmacro MUI_PAGE_COMPONENTS +!insertmacro MUI_PAGE_INSTFILES +!insertmacro MUI_PAGE_FINISH +!insertmacro MUI_UNPAGE_CONFIRM +!insertmacro MUI_UNPAGE_INSTFILES +!insertmacro MUI_LANGUAGE "Korean" + +; Whether jarvis.exe runs (any user's), from tasklist's answer: OUT = 1 or 0. +!macro JarvisRuns PREFIX OUT + nsExec::ExecToStack 'tasklist /FI "IMAGENAME eq jarvis.exe" /NH' + Pop $0 + Call ${PREFIX}StrHasJarvis + Pop ${OUT} +!macroend + +!macro StrHasJarvisFn PREFIX +Function ${PREFIX}StrHasJarvis + Exch $R0 + Push $R1 + Push $R2 + Push $R3 + StrCpy $R1 0 + StrCpy $R2 0 + loop: + StrCpy $R3 $R0 10 $R1 + StrCmp $R3 "" done + StrCmp $R3 "jarvis.exe" found + IntOp $R1 $R1 + 1 + Goto loop + found: + StrCpy $R2 1 + done: + StrCpy $R0 $R2 + Pop $R3 + Pop $R2 + Pop $R1 + Exch $R0 +FunctionEnd +!macroend +!insertmacro StrHasJarvisFn "" +!insertmacro StrHasJarvisFn "un." + +; Wait until Jarvis has closed: silently up to 60 s (an update closes it itself), else ask. +!macro WaitClosed PREFIX + StrCpy $5 0 + ${Do} + !insertmacro JarvisRuns "${PREFIX}" $4 + ${If} $4 == 0 + ${Break} + ${EndIf} + ${If} ${Silent} + ${If} $5 >= 60 + Abort + ${EndIf} + Sleep 1000 + IntOp $5 $5 + 1 + ${Else} + MessageBox MB_RETRYCANCEL|MB_ICONEXCLAMATION "Jarvis가 실행 중입니다. Jarvis 창을 닫은 뒤 다시 시도를 눌러 주세요." IDRETRY +2 + Abort + ${EndIf} + ${Loop} +!macroend + +Function .onInit + ${IfNot} ${RunningX64} + MessageBox MB_ICONSTOP "Jarvis는 64비트 Windows 10/11에서만 실행됩니다." + Abort + ${EndIf} + SetRegView 64 + ; Shortcuts for every user of the PC, like the Program Files install itself. + SetShellVarContext all + !insertmacro WaitClosed "" +FunctionEnd + +Function un.onInit + SetRegView 64 + SetShellVarContext all + !insertmacro WaitClosed "un." +FunctionEnd + +; Started from this elevated installer the app would run as administrator; Explorer starts it as +; the signed-in user. +Function RunAsUser + Exec '"$WINDIR\explorer.exe" "$INSTDIR\jarvis.exe"' +FunctionEnd + +Section "Jarvis (필수)" SecMain + SectionIn RO + SetOutPath "$INSTDIR" + File "${SRC}/jarvis.exe" + File "${SRC}/WebView2Loader.dll" + File /r "${SRC}/python-src" + File /r "${SRC}/display-driver" + WriteUninstaller "$INSTDIR\uninstall.exe" + WriteRegStr HKLM "Software\JarvisBot" "InstallDir" "$INSTDIR" + WriteRegStr HKLM "${UNINST_KEY}" "DisplayName" "Jarvis" + WriteRegStr HKLM "${UNINST_KEY}" "DisplayVersion" "${VERSION}" + WriteRegStr HKLM "${UNINST_KEY}" "Publisher" "Jarvis" + WriteRegStr HKLM "${UNINST_KEY}" "DisplayIcon" "$INSTDIR\jarvis.exe" + WriteRegStr HKLM "${UNINST_KEY}" "InstallLocation" "$INSTDIR" + WriteRegStr HKLM "${UNINST_KEY}" "UninstallString" '"$INSTDIR\uninstall.exe"' + WriteRegStr HKLM "${UNINST_KEY}" "QuietUninstallString" '"$INSTDIR\uninstall.exe" /S' + WriteRegDWORD HKLM "${UNINST_KEY}" "NoModify" 1 + WriteRegDWORD HKLM "${UNINST_KEY}" "NoRepair" 1 + ${GetSize} "$INSTDIR" "/S=0K" $0 $1 $2 + WriteRegDWORD HKLM "${UNINST_KEY}" "EstimatedSize" $0 + ; The window needs the WebView2 runtime (Windows 11 has it; an older Windows 10 may not). + ReadRegStr $0 HKLM "${WEBVIEW2_KEY}" "pv" + ReadRegStr $1 HKCU "${WEBVIEW2_KEY}" "pv" + ${If} $0 == "" + ${OrIf} $0 == "0.0.0.0" + ${If} $1 == "" + ${OrIf} $1 == "0.0.0.0" + DetailPrint "WebView2 런타임 설치" + SetOutPath "$PLUGINSDIR" + File "/oname=webview2.exe" "${WEBVIEW2}" + ExecWait '"$PLUGINSDIR\webview2.exe" /silent /install' $0 + DetailPrint "WebView2 설치 결과: $0" + SetOutPath "$INSTDIR" + ${EndIf} + ${EndIf} + ; Silent updates (/S /RUN) start the app again when done. + ${GetParameters} $0 + ClearErrors + ${GetOptions} $0 "/RUN" $1 + ${IfNot} ${Errors} + Call RunAsUser + ${EndIf} +SectionEnd + +Section "시작 메뉴 바로 가기" SecStart + CreateShortCut "$SMPROGRAMS\Jarvis.lnk" "$INSTDIR\jarvis.exe" +SectionEnd + +Section /o "바탕 화면 바로 가기" SecDesktop + CreateShortCut "$DESKTOP\Jarvis.lnk" "$INSTDIR\jarvis.exe" +SectionEnd + +Section /o "가상 모니터 드라이버" SecDriver + ; The app's own elevated half (admin.spec.md, "Virtual monitor"); Windows asks once whether to + ; trust the SignPath Foundation. It can also be installed later from the features screen. + ExecWait '"$INSTDIR\jarvis.exe" --display-driver install --result "$PLUGINSDIR\vdd.txt"' $0 + ${If} $0 != 0 + FileOpen $1 "$PLUGINSDIR\vdd.txt" r + FileRead $1 $2 + FileClose $1 + DetailPrint "가상 모니터 드라이버를 설치하지 못했습니다: $2" + ${IfNot} ${Silent} + MessageBox MB_ICONEXCLAMATION "가상 모니터 드라이버를 설치하지 못했습니다. 나중에 기능 화면에서 다시 설치할 수 있습니다.$\r$\n$2" + ${EndIf} + ${EndIf} +SectionEnd + +LangString DESC_Main ${LANG_KOREAN} "관리 앱과 음성 워커·두뇌 소스입니다. 모델과 런타임은 첫 실행 때 고른 데이터 폴더에 받습니다." +LangString DESC_Driver ${LANG_KOREAN} "봇용 크롬창을 실제 모니터에 보이지 않는 가상 모니터에 두어 디스코드 화면 공유에서 고를 수 있게 합니다. Windows가 장치 소프트웨어 설치를 한 번 묻습니다." +!insertmacro MUI_FUNCTION_DESCRIPTION_BEGIN + !insertmacro MUI_DESCRIPTION_TEXT ${SecMain} $(DESC_Main) + !insertmacro MUI_DESCRIPTION_TEXT ${SecDriver} $(DESC_Driver) +!insertmacro MUI_FUNCTION_DESCRIPTION_END + +Section "Uninstall" + ; The virtual monitor's driver goes with the app when this app installed it (the elevated half + ; refuses another program's copy and does nothing when there is none). + ExecWait '"$INSTDIR\jarvis.exe" --display-driver uninstall --result "$TEMP\jarvis-vdd-uninstall.txt"' + Delete "$TEMP\jarvis-vdd-uninstall.txt" + ; Only what the installer put there: a folder the person chose may hold other things. + Delete "$INSTDIR\jarvis.exe" + Delete "$INSTDIR\WebView2Loader.dll" + RMDir /r "$INSTDIR\python-src" + RMDir /r "$INSTDIR\display-driver" + Delete "$INSTDIR\uninstall.exe" + RMDir "$INSTDIR" + Delete "$SMPROGRAMS\Jarvis.lnk" + Delete "$DESKTOP\Jarvis.lnk" + DeleteRegKey HKLM "${UNINST_KEY}" + DeleteRegKey HKLM "Software\JarvisBot" + DetailPrint "데이터 폴더(모델, 대화 기록, 설정)는 지우지 않았습니다." +SectionEnd diff --git a/app/shell/installer.sh b/app/shell/installer.sh new file mode 100755 index 0000000..c58c4f6 --- /dev/null +++ b/app/shell/installer.sh @@ -0,0 +1,18 @@ +#!/bin/sh +# The Jarvis installer (admin.spec.md, "Installer"): package.sh's Jarvis/ folder into one NSIS setup. +# app/shell/installer.sh -> /Jarvis-Setup-.exe (+ .sha256) +# Needs makensis 3 (NSISDIR set when it is not installed system-wide) and curl. +set -eu +here=$(cd "$(dirname "$0")" && pwd) +out=$(mkdir -p "${1:?output folder}" && cd "$1" && pwd) +version=$(sed -n 's/^version = "\(.*\)"/\1/p' "$here/Cargo.toml" | head -1) +target=${CARGO_TARGET_DIR:-$here/target} +sh "$here/package.sh" "$out" >/dev/null +# The WebView2 runtime's bootstrapper (Microsoft, about 2 MB), run only on a PC without the runtime. +wv2="$target/MicrosoftEdgeWebview2Setup.exe" +[ -s "$wv2" ] || curl -fsSL -o "$wv2" "https://go.microsoft.com/fwlink/p/?LinkId=2124703" +setup="$out/Jarvis-Setup-$version.exe" +makensis -V2 -DVERSION="$version" -DSRC="$out/Jarvis" -DOUT="$setup" -DICON="$here/icons/icon.ico" \ + -DWEBVIEW2="$wv2" "$here/installer.nsi" +(cd "$out" && sha256sum "Jarvis-Setup-$version.exe" > "Jarvis-Setup-$version.exe.sha256") +echo "$setup" diff --git a/app/src/admin.spec.md b/app/src/admin.spec.md index 77fe25c..2a93b20 100644 --- a/app/src/admin.spec.md +++ b/app/src/admin.spec.md @@ -559,7 +559,31 @@ URL), so other local programs cannot drive it. out `Jarvis/`: `jarvis.exe`, `WebView2Loader.dll`, `python-src/` (the `voice_worker` and `jarvis` packages, no caches or specs) and `display-driver/` (the virtual monitor's driver). The worker's default sources are `python-src` next to the executable when it is there, else the repository's `src/`; the install reads its requirement - files from the same place. The installer (NSIS) comes later; the folder runs as it is. + files from the same place. The folder also runs as it is. + +## Installer (`app/shell/installer.nsi`, `app/shell/installer.sh`) + +`docs/v2/architecture.md` ("설치 파일: NSIS"). `installer.sh ` runs `package.sh` and makensis +3 (on Linux; `NSISDIR` when it is not installed system-wide) and writes +`Jarvis-Setup-.exe` with its `.sha256`. The installer is about 10 MB; models and runtimes +come with the first-run wizard into the data folder, which the installer never touches. + +- Program Files (`Jarvis`), one administrator prompt, 64-bit Windows 10/11 only; Korean pages: + folder, components, progress, finish ("Jarvis 실행", started through Explorer so the app runs as + the signed-in user, not as administrator). +- Components: Jarvis (always), start menu shortcut (on), desktop shortcut (off), the virtual + monitor's driver (off; the app's elevated half, `jarvis.exe --display-driver install`, so Windows + asks the SignPath question once; a failure says it can be installed later from the features + screen). Shortcuts are for every user of the PC. +- The WebView2 runtime is installed with Microsoft's bootstrapper (inside the installer) only when + the PC has none. +- Before installing or removing, the installer waits for `jarvis.exe` to close: it asks with a + retry, or silently waits up to 60 s (an update closes the app itself), then gives up. +- `/S` installs silently with the default components; `/S /RUN` starts the app again afterwards + (the app's updates). The uninstall entry has the version, size and a quiet uninstall string. +- Uninstall: the driver goes too when this app installed it (the elevated half refuses another + program's copy), then only what the installer put there (a folder the person chose may hold + other things), the shortcuts and the registry keys. The data folder stays. ## Tests diff --git a/docs/v2/roadmap.md b/docs/v2/roadmap.md index 41ed731..438a758 100644 --- a/docs/v2/roadmap.md +++ b/docs/v2/roadmap.md @@ -12,7 +12,7 @@ | M5 | 관리 앱 기본 | 첫 실행 마법사, 데이터 폴더, 런타임·모델 자동 설치, 대시보드, 봇/채널·호출/채팅 채널(디스코드 채널 이름·주제 반영 포함)/대화 기억/모델 설정, 로그 화면(보기·복사·다운로드). 단계: 1 관리 기능(화면 없음), 2 서비스 제어와 대시보드 자료, 3 Tauri 화면, 4 런타임·모델 자동 설치, 5 Windows 빌드와 확인. 1단계 완료(2026-11-12): `app/src/datadir.rs`(데이터 폴더와 위치 기억 파일, 남은 용량), `settings_edit.rs`(화면 5개의 항목 36개, 기본값과 다른 값만 저장, 모르는 키 보존, 앱 검사를 통과해야만 저장), `secrets.rs`(봇 토큰, Windows는 사용자 계정 DPAPI 암호화), `logs.rs`(서비스별 탭, 날짜별 파일 14일 보관, 최근 오류 복사, 10MB 이하 zip, 비밀값·토큰 모양 가림), 앱 설정에 대화 기억(`memory`) 칸을 넣어 워커에 넘김. 스펙 [admin.spec.md](../../app/src/admin.spec.md). Windows용 코드는 Windows 대상으로 컴파일만 확인(실행 확인은 5단계). 2단계 완료(2026-11-12): `control.rs`(서비스 시작·정지·재시작 규칙, 실패는 비밀값을 가린 오류로 남기고 아무것도 켜 두지 않음, 앱 실행 파일도 같은 제어기를 씀), `dashboard.rs`(디스코드 이벤트만으로 만드는 대시보드 자료: 연결 상태, 음성 채널과 참가자, 실시간 자막 30줄(화면에만, 기록하지 않음, 나가거나 정지하면 지움), 답 20개의 단계별 지연(말 끝→최종 전사, 두뇌, 목소리, 전체)과 중앙값, 놓친 요청 20개(글 없이)), `system.rs`(RAM, `nvidia-smi`로 GPU 사용률·VRAM). 성능 단계(평소/게임 중/일시정지)는 게임 감지와 함께 M7. 3단계 완료(2026-11-12): 화면 `app/ui/`(빌드 도구 없는 HTML/CSS/JS, 어두운 테마, 한국어)와 화면이 부르는 명령 `admin_api.rs`(설정, 대시보드, 시작·정지, 로그 조회·복사·zip, PC 점검, 디스코드 토큰 확인·초대 링크·서버/채널 목록 `discord_setup.rs`). 첫 실행 마법사(데이터 폴더, PC 점검, 모델 안내, 봇 연결, 서버·음성 채널, 호출어, 시작), 대시보드, 설정 5개, 로그. 개발용 서버 `jarvis-admin-dev`로 이 서버의 브라우저에서 실제 테스트 봇과 음성 워커를 켜고 확인: 마법사 각 단계, 시작 뒤 "실행 중 · 테스트봇#9029 · 워커 연결됨", 다시 시작·정지, 설정 저장(바뀐 값만, 모르는 키 보존), 채팅 채널 추가, 로그 실시간 보기와 zip 내보내기. Tauri 창(셸)은 이 서버에서 빌드할 수 없어(webkit2gtk 없음) Windows 빌드 단계에서 붙임. 디스코드 채널 이름·주제 반영은 아직. 4단계 첫 부분 완료(2026-11-12): 설치 `install.rs`·`download.rs`(이어받기, SHA-256 확인), M0 키트와 같은 방식으로 uv 0.11.20 → 워커·두뇌 Python 3.12 환경(v2 전용 패키지 목록 `requirements-brain.txt`) → MeloTTS Python 3.11 환경 → Whisper large-v3-turbo → MeloTTS 한국어 음성 → Strata를 모두 데이터 폴더 안에 설치하고, 끝나면 다운로드 캐시를 비우고 워커 설정을 설치된 Python으로 바꿈. 마법사 "모델" 단계에서 진행·취소·다시 시도. 이 서버(Linux)에서 빈 폴더부터 전부 설치해 보고 그 런타임으로 서비스를 켜 워커 연결, 받아 적기·음성 준비까지 확인했고, 설치 중 데이터 폴더 밖에는 아무것도 쓰지 않음. 대화 모델(약 23GB)은 앱이 Strata를 직접 띄우는 다음 부분에서 받음. 4단계 뒷부분 완료(2026-11-12): 서비스를 켜면 앱이 먼저 데이터 폴더의 Strata를 띄움(`app/src/strata.rs`, M0와 같은 모델과 평소 배치, 처음 켤 때 대화 모델 약 23GB를 받음, 대시보드에 진행률과 Strata의 마지막 줄, 켜는 중에도 정지 가능, 서비스를 끄면 Strata도 끔). 동시 요청은 1개(모든 메시지에 답하는 채팅 채널이 있으면 2개), 그림 읽기는 v2에서 아직 쓰지 않아 끔. 시작할 때마다 두뇌 설정 `config/brain.json`(Strata 주소, Strata가 알려 준 모델 이름, 데이터 폴더 안의 기억 DB)을 써서 워커에 넘김. 이미 떠 있는 서버를 쓰려면 설정 파일의 `llm.url`. 확인: 가짜 Strata로 진행률·준비·정지·다운로드 중 취소·실패를 단위 시험, 게임PC의 Strata 0.1.59가 앱의 실행 옵션을 그대로 받아들임(`--plan`), 앱 서비스를 `llm.url`로 게임PC Strata에 붙여 실제 디스코드 왕복 10개 모두 소리로 답함. 앱이 Strata를 직접 띄워 모델을 받는 실제 확인은 이 서버에서 할 수 없어(메모리) Windows 빌드 단계에서 게임PC로 함. 5단계 완료(2026-11-12): Tauri 2 창 `app/shell`(`jarvis.exe`, 화면의 명령을 같은 `AdminApi`로 넘김, 창을 닫으면 서비스와 Strata를 끄고 끝날 때까지 기다림, 창의 브라우저 자료는 위치 기억 파일 옆)과 Windows 빌드 `app/shell/package.sh`(이 서버에서 `x86_64-pc-windows-gnu`로 빌드, `Jarvis/` 폴더에 실행 파일·WebView2Loader.dll·Python 소스 `python-src`, zip 11MB). 시험용 Windows VM에서: 창과 마법사, PC 점검, uv·워커 환경 설치, 설치 취소 뒤 남은 프로세스 없음, 봇 토큰 DPAPI 암호화 저장, 시작 실패 이유 표시, 로그 화면·오류 복사·zip, 창 닫기로 종료, %APPDATA%·%LOCALAPPDATA%에 아무것도 안 남김, 앱 핵심 단위 테스트(Windows 빌드) 통과. 게임PC(RTX 5070 Ti, C:\JarvisM0 안에서만)에서 같은 관리 명령으로: 전체 설치 7단계 6분 40초, 앱이 직접 띄운 Strata가 엔진과 대화 모델 22.9GB를 약 6분에 받고 준비, 워커(GPU 받아 적기·음성) 연결, 디스코드 음성 채널 입장, 시험 봇이 말한 질문 5개에 모두 소리로 답함(앱이 잰 전체 중앙값 3.36초, 처음 질문 6.4초, 날씨 11.6초), 정지 8초에 GPU 메모리 반환. 같은 시험에서 찾아 고친 것: Windows는 닫힌 로컬 포트의 연결 거부가 약 2초 늦어 정지 확인이 실패로 나오던 것, Strata가 모델 크기(`X of Y GB`)로만 진행을 알려 진행률이 앞 단계의 80%에 멈춰 있던 것, Strata와 NVIDIA 셰이더 캐시가 %APPDATA%에 쓰던 것(데이터 폴더로). 마무리(2026-11-12): 채팅 채널 이름·주제 반영 `app/src/channel_sync.rs`(채널마다 "디스코드에도 반영", 기본 켜짐; 등록하면 디스코드의 이름·주제로 채움, 저장하면 바뀐 채널만 디스코드에 반영하고 디스코드가 바꾼 이름(공백은 `-`)을 화면에 다시 보여 줌, 주제 1,024자 초과는 저장 전에 거절, 10분에 2번 제한에 걸리면 "잠시 뒤 반영" 후 디스코드가 알려 준 시간 뒤 마지막 저장값으로 저절로 다시 시도, 권한이 없으면 이유를 보여 주고 앱에만 저장). 실제 디스코드 시험 채널에서 채움·반영·제한(587초 대기)·자동 재시도까지 확인 후 채널 삭제. 모델 화면에 TTS 말하기 속도(MeloTTS, 0.5~2.0, 기본 1.5; 한국어 모델은 목소리가 KR 하나뿐이라 목소리 선택은 없음). 창을 닫을 때 설치 중이면 취소하고 끝날 때까지 기다림, 정리를 확인하지 못하면 창을 닫지 않고 이유를 보여 줌(한 번 더 닫으면 종료), 실패한 실행이 남긴 Strata도 정리. 창의 WebView 자료는 데이터 폴더(`cache/webview`), 폴더를 고르기 전에는 임시 폴더에 두었다가 다음 시작 때 지움(`%APPDATA%\JarvisBot`에는 위치 파일 하나만). Windows의 UTF-8 옵션이 꺼진 PC의 CP949 출력도 끝까지 읽음. VM에서 다시 확인: 설치 중 창 닫기 뒤 남은 프로세스 없음, `--location` 없이 실행 시 위치 파일 하나만, Windows용 단위 테스트 168개 통과. 게임PC에서 UTF-8 옵션을 끈 상태(코드 페이지 949)로 다시 확인: 전체 설치 7단계, Strata의 대화 모델 22.9GB 다운로드(진행률 10.9%→90%로 표시)와 준비, 워커·디스코드 연결, 시험 봇 질문 5개 모두 소리로 답함(앱이 잰 전체 중앙값 4.0초), 정지 7초에 GPU 메모리 반환, 로그 485줄에 깨진 글자 없음. 남은 것: 설치 파일(NSIS), Strata가 VRAM을 거의 다 써서(15.8/16.3GB) 받아 적기와 GPU를 나누는 문제(M0의 STT 자리 남기기 배치, M7 성능 단계와 함께) | | M6 | 기능 화면과 브라우저 | 기능 켜기/끄기, MCP 관리, 봇용 크롬(가상 모니터에 둠, Virtual Display Driver 포함), 예약 수집 틀(대상은 비움). 디스코드 "화면" 탭 공유, 커서, 모니터 해제 때 창 위치 확인. 1단계 완료(2026-11-13): 관리 앱 "기능" 화면(`app/src/features.rs`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "Features and MCP servers"). 날씨·웹 검색·식단 기록 켜기/끄기(끄면 그 도구는 두뇌가 제안하지도 실행하지도 않음, 모델이 이름을 대도, 도구 찾기 도구로도 안 나옴), MCP 서버 추가·삭제·켜기/끄기(이름, 명령, 인자, 환경 변수 이름). API 키 같은 환경 변수 값은 암호화 저장소에만 두고 화면에는 저장 여부만, 로그에서는 가림, 서버를 지우면 값도 지움. 앱이 켤 때 값을 워커 환경으로만 넘기고 두뇌는 그 변수를 자기 환경에서 빼서 각 서버에 자기 값만 줌. 서버마다 연결 결과(도구 수, 실패 이유)는 디버그 없이도 LLM 로그 탭에 남음. 같은 작업에서 v2 두뇌가 v1의 PC 파일 도구(홈 폴더 읽기·쓰기·지우기)와 화면 캡처 도구를 쓰던 것을 뺌(음성·채팅 채널의 누구든 요청할 수 있었음, 화면 보기는 M7에서 권한과 함께). 이 서버에서 확인: 개발용 서버의 브라우저로 날씨를 끄고 MCP 서버(시험용 서버)와 키를 저장, 실제 서비스를 켜니 `brain.json`에 끈 도구와 서버만 있고 키는 없음, 워커가 "MCP server fake: 1 tool(s)"를 남기고 MCP 서버 프로세스만 키를 받음, 로그·설정 파일에 키 없음, 정지 때 MCP 서버도 꺼짐. 2단계 완료(2026-11-13): 예약 수집 틀(`app/src/collect.rs`, 워커 `src/voice_worker/collect.py`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "Background collection"). 관리 앱 "백그라운드 수집" 화면에서 대상(사이트·검색어·RSS, 주기 15분~7일, 켜기/끄기)과 보관 기간(기본 30일)을 정하고 결과를 봄. 기본 대상은 없음. 기능 화면의 "백그라운드 수집" 스위치를 끄거나 켠 대상이 없으면 수집은 하지 않고 보관 기간이 지난 결과만 지움. 대소문자만 다른 대상 이름은 Windows에서 같은 폴더라 거절. 워커가 음성·두뇌와 따로 돌며, 사이트는 바뀌었을 때만, RSS·검색은 새 항목만 남김. 모든 요청은 공개 주소만 허용하고 검사한 그 주소로만 연결(DNS를 다시 물어 내부망으로 새는 것 막음, 리디렉트마다 다시 검사, 1MB, 전체 15초, 주소는 로그에 남기지 않음)하고, 모은 내용은 데이터 폴더 `collect/`에만 쓰며 두뇌나 로그로 가지 않음(로그에는 대상 이름과 개수만). 덕덕고가 봇 확인 화면을 주면 "결과 없음"이 아니라 실패로 남김. 이 서버에서 확인: 실제 인터넷의 RSS(hnrss 20개), Atom(cpython 10개), 검색어(10개), 사이트(1개) 수집, 내부 주소는 거절, 개발용 서버 화면에서 대상 저장·잘못된 이름 거절·결과 보기, 실제 서비스 시작으로 켠 대상만 워커에 넘어가 수집되고 정지 때 워커도 꺼짐. 3단계 첫 부분 완료(2026-11-13): 봇용 크롬(`app/src/browser.rs`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "Bot browser"). 설치 단계 `browser`가 Chrome for Testing 157(약 200MB, SHA-256 고정)을 데이터 폴더 `runtime/chrome`에 받고, 기능 화면의 "브라우저 제어(봇용 크롬)"가 켜져 있으면 서비스가 화면 없이(headless) 띄움(프로필 `browser/profile`, CDP는 빈 루프백 포트, 워커에 `JARVIS_BROWSER_CDP`). 크롬의 모든 연결은 앱의 중계기(루프백 프록시)를 거쳐 이름을 한 번만 풀고 공개 주소에만 연결(이 PC·내부망·CGNAT·IPv4 매핑 IPv6 등은 403, 주소는 로그에 남기지 않음), QUIC 끔, WebRTC도 중계기로만. 켜지지 않으면 대시보드에 이유를 보이고 서비스는 계속 돔. 정지 때 `Browser.close` 후 5초 안에 안 끝나면 강제 종료. 이 서버에서 확인: 실제 크롬이 example.com은 열고 127.0.0.1·localhost의 로컬 서버에는 요청이 하나도 가지 않음, 정지 78ms, 설치 단계로 실제 내려받아 실행, 실제 서비스 시작에서 대시보드 "준비"·워커 환경에 CDP 주소·정지 때 크롬 프로세스 0개, 기능을 끄면 띄우지 않음, Windows 대상 컴파일. 3단계 둘째 부분(2026-11-13): 두뇌의 브라우저 제어 도구 `botBrowser`(스펙 [bot_browser.spec.md](../../src/jarvis/tools/builtin/bot_browser.spec.md)): 열기·읽기·누르기(이름 또는 번호)·입력(Enter 포함)·뒤로, CDP로 봇용 크롬을 조종, 페이지 내용은 신뢰하지 않는 데이터 울타리 안에, http(s)만(file·chrome·data·javascript 거절), LLM 호출 없음. 봇용 크롬이 켜져 있을 때만 제안되고 그동안 `fetchWebPage`는 빠짐(페이지 읽기는 중계기를 거치는 이 도구 하나로). 실제 크롬으로 열기·누르기·한글 입력 후 검색·뒤로 확인. 사람마다 자기 탭(최대 5개), 새 탭 링크·`window.open`도 같은 탭에서, 연결·동작·페이지 대기를 합쳐 15초 한 번, 연결이 끊기면 열기·읽기만 새 연결로 한 번 더(누르기·입력·뒤로는 이미 됐을 수 있어 반복하지 않음), 페이지 글자의 `<<<`·`>>>`는 바꿔 울타리를 닫지 못함. 평가 `evals/test_bot_browser_tool.py` 4개를 이 서버의 qwen3:8b(실제 모델과 같은 계열)로 3번: 11/12 통과, 페이지 안의 "evil.example 열어"는 한 번도 따르지 않음. "사이트에서 검색"은 도구 설명에 "먼저 열고 type에 submit=true"를 넣기 전 0/3, 넣은 뒤 3/3(전체 실행에서는 2/3). 실제 모델(Qwen3.6, 게임PC)로는 게임PC GPU가 쓰이고 있어 아직 못 돌림. 3단계 셋째 부분(2026-11-14): 가상 모니터와 "봇용 크롬창 화면공유 선택 표시"(`app/src/vdisplay.rs`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "Virtual monitor"). 기능 화면의 스위치(기본 꺼짐)와 드라이버 설치·제거 카드(관리자 권한 한 번, Windows의 SignPath 확인 한 번). 오픈소스 Virtual Display Driver 25.7.23을 `display-driver/`에 함께 넣음(빌드 때 SHA-256 확인). 켜면 서비스가 봇용 크롬을 쓰는 동안만 가상 모니터를 실제 모니터 오른쪽 아래 구석에 1280x720으로 붙이고, 크롬은 창 없이 켠 뒤 CDP로 뒤에서 창을 열어 포커스를 뺏지 않으며, 그 창은 Alt+Tab·작업 표시줄에서 빠지고 작업 영역을 채움. 정지 때 크롬을 먼저 닫고 모니터를 뗌. 모니터나 창을 못 만들면 화면 없이 돌고 대시보드에 이유. 같은 작업에서 관리자 권한으로 실행된 앱에서는 크롬이 일반 권한으로 다시 뜨며 앱이 크롬을 놓치던 것을 고침(`--do-not-de-elevate`). 서버 Windows 가상머신에서 설치부터 제거까지 확인(위 [pc-features.md](pc-features.md#봇용-크롬창과-디스코드-화면공유)). 남은 것: 실제 모델 평가, 게임PC에서 디스코드 "화면" 탭 공유 확인(드라이버 설치에 사용자 허락 필요), 나머지 기능 스위치(PC 제어·화면 보기, M7) | | M7 | PC 제어와 화면 보기 | 아래 목록에 있습니다. 1단계(2026-11-14): 게임 감지(`app/src/game.rs`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "Game detection"). 서비스가 도는 동안 2초마다 앞 창을 보고 M0 기준(전체화면, 모니터를 덮는 테두리 없는 창 + GPU 3D 10% 이상, Steam·Epic·Riot 게임 폴더와 Windows 설치 정보로 찾은 Battle.net 게임 폴더, 직접 등록한 게임, "게임 아님" 목록 우선, 브라우저·영상 플레이어·디스코드·런처 창 제외)으로 판단, 게임이 끝날 때까지 유지. 관리 앱 "게임 모드" 화면(감지 켜기/끄기, 두 목록)과 대시보드 "게임 모드: 켜짐 (이름, 이유)". 서버 Windows 가상머신에서 Steam 게임 폴더의 프로그램을 켜면 1.4초 뒤 켜짐, 끄면 2.0초 뒤 꺼짐. 한글 등이 섞인 경로의 Steam 게임과 Battle.net 게임(시험용 제거 항목)도 같은 시험으로 확인. GPU 사용률 기준(테두리 없는 창)은 GPU가 있는 게임PC에서 확인할 것. 2단계 첫 부분(2026-11-14): 평소 배치(`app/src/placement.rs`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "LLM"). NVIDIA 카드가 있으면 M0 키트의 식대로 `--expert-vram`을 정해 STT 몫(2740MiB)·엔진 여유(768MiB)·다른 프로그램 여유(기본 1GB)를 남김(Strata 자동 배치가 STT 자리를 남기지 않던 M5의 문제). 전문가 없는 모델 VRAM은 맥락·동시 요청 수·카드(UUID)마다 처음 한 번 재서(`config/llm-probe.json`) 다시 씀. 측정이 실패하면 저장하지 않고 전문가 0으로 켜며, 이전 실행에서 남은 서버는 응답 상태와 상관없이 늘 먼저 끄고 포트가 닫힌 것을 확인한 뒤 잼(확인이 안 되면 재지 않고 전문가 0). 게임PC M0 측정값으로 계산하면 M0와 같은 1.5GB. 게임 중 배치 계산(게임 몫 8GB를 못 비우면 최소 전문가 2GB와 남는 게임 몫, 그것도 안 되면 전문가 0GB, 그것도 안 되면 일시정지)도 넣음. 실제 게임PC 확인은 아직. 2단계 둘째 부분(2026-11-14): 성능 단계 전환(`app/src/perf.rs`, `services.rs`, 워커 "LLM switches"). 게임이 감지되면 워커에 전환을 알리고, 하던 답이 끝나면 맥락 16K·동시 1개·CPU 작업자 절반·게임 배치로 LLM을 다시 켬. 그동안 들어온 요청은 기다리고, 처음 음성 요청에 "잠깐만요, 게임 모드로 바꾸는 중이에요"를 한 번 말함. 게임이 끝나고 30초 뒤(설정) 평소 배치로 되돌림. 게임 몫을 비울 수 없거나 "게임 중 일시정지"를 켜면 LLM을 멈추고 답하지 않음. 대시보드에 "성능 단계: 게임 중 · 게임에 X GB". 설정: 게임용 VRAM(8GB), 되돌리기 대기(30초), 게임 중 일시정지(끔). 실제 게임PC 확인은 아직. 같은 단계에서 실패 경로도 다룸: 재시작 실패 시 이전 배치로 되돌리고 60초 뒤 최대 3번 다시 시도, 워커 재연결 시 마지막 LLM 상태 다시 보냄, 전환 번호로 늦은 신호 무시, 다른 프로그램 VRAM은 게임이 없을 때 잰 값만 기준으로 저장(시작 시 뒤에 있는 게임 폴더·등록 게임 프로세스도 확인; 그 밖의 숨은 게임은 못 찾음). 2단계 셋째 부분(2026-11-14): 게임 중 답하는 동안 부분 전사 멈추기(워커 `game` 표시, 최종 전사는 그대로, 답이 끝나면 밀린 부분 전사 이어서; M0 `gamemode_tune` 결정). 실제 게임PC 확인은 아직. 다음: 화면 보기·PC 제어(누가 시킬 수 있는지 사용자 결정 필요). | -| M8 | 배포 | 설치 파일, 자동 업데이트, 깨끗한 Windows에서 설치부터 첫 대화까지 확인 | +| M8 | 배포 | 설치 파일, 자동 업데이트, 깨끗한 Windows에서 설치부터 첫 대화까지 확인. 1단계(2026-11-14): 설치 파일(`app/shell/installer.nsi`, `installer.sh`, 스펙 [admin.spec.md](../../app/src/admin.spec.md) "Installer"). NSIS로 약 10MB, Program Files에 관리자 권한 한 번, 한국어 화면, 구성 요소(시작 메뉴·바탕 화면 바로 가기, 가상 모니터 드라이버 기본 꺼짐), WebView2가 없으면 함께 설치, 실행 중이면 닫힐 때까지 기다림, `/S`·`/S /RUN`(업데이트용), 제거 때 이 앱이 설치한 드라이버도 지우고 데이터 폴더는 남김. 서버 Windows 가상머신에서 조용한 설치(4초)·실행·실행 중 업데이트 뒤 다시 실행·제거, 화면으로 드라이버까지 설치하고 제거하면 장치·패키지·레지스트리가 모두 지워짐 확인. 다음: 자동 업데이트(Gitea 릴리스). | M0에서 확인할 항목: