d3ro-voice/memory/handoff-latest.md

62 lines
4.6 KiB
Markdown

# Session Handoff — 2026-11-02 (Windows 실GUI 검증 & 한영 교정 경합 수정)
> Environment: Windows (ALPACA-HOME)
> Starting point: `main` at `5ec063c`, clean tree. No commit or release was created in this session.
## 완료한 작업
- 설치본 Windows 1.16.0의 실제 Electron GUI에서 회의 **녹음 파일 가져오기 → 타임스탬프 전사 → 로컬 요약·할 일 생성**을 통과시켰다. 데스크톱 MTG-13은 `[x]`, Android file-to-minutes는 미검증으로 남는다.
- 네이티브 한글 IME는 bounded 100% CPU에서 7/7, `gemma4:e4b` direct cold load(9.389초)와 겹친 시험에서도 7/7 정확히 통과했다. Ollama는 시험 전후 `models:[]`로 복원했다.
- 한영 자판 교정 대조군은 1/7만 통과하며 `d안녕하세요`와 다음 키 `r`이 백스페이스에 섞이는 결함을 재현했다.
- 소스 수정: `InputTelemetryService` 경계 스냅샷 40→140ms, `TypoCorrectionService`는 짧은 유휴의 연속 꼬리 부분 교정을 미루고 650ms 유휴 시 현재 교정 영역(최대 core 120자)을 한 번에 교정한다.
- 검증: 표적 48/48, 데스크톱 전체 192 files / 2,773 tests, typecheck, touched lint, production build 모두 PASS.
## 남은 작업
1. 수정본을 패키징·설치한 Electron에서 동일한 Latin layout 대조군을 다시 실행한다. 현재 사용자 설치본은 아직 1.16.0이며 수정본은 커밋·배포되지 않았다.
2. 물리 키보드와 Chromium/terminal에서도 교정 경합을 확인한다. 이번 통과는 WinForms synthetic scan-code 증거이므로 GAP-INPUT-11은 `[~]`다.
3. 모바일 운영 배포와 인증 Android file-to-minutes는 외부 자격 증명·기기 게이트가 남아 있다.
상세 증거: `docs/evidence/2026-11-02-verification.md`, 무시된 런타임 파일은 `test-results/recovery-2026-11-02/`. 회의 GUI 검증에서 만든 `local-speech` 회의는 삭제하지 않고 남겼다.
---
# Session Handoff — 2026-08-19 (Ollama 온보딩 & 데스크톱 윈도우 실행 아키텍처 완료)
> Environment: Windows (ALPACA-HOME)
> Target: `@d3ro/desktop`, `@d3ro/core`, `@d3ro/ui`, `@d3ro/i18n`
---
## 1. 이번 세션에서 해결한 핵심 작업 내역
### 1) Ollama 가이드 모달 & 1-클릭 모델 매니저 전면 개편 (`OllamaGuideModal.tsx`)
- Ollama 서버 헬스체크 및 실시간 버전 파싱 (`GET /api/version` -> `v0.32.13`).
- 서버 미실행 시 🔴 오프라인 정확 표기 및 1-클릭 백그라운드 자동 기동 (`electronAPI.llm.startServer`).
- 최신 4종 모델 (`gemma2:2b`, `llama3.2:3b`, `qwen2.5:3b`, `gemma2:9b`) 1-클릭 다운로드(Pull) 및 실시간 프로그레스 바.
- 즉시 텍스트 정제 동작 시험 프롬프트 러너 탑재.
### 2) 로컬 AI 온보딩 모달 & 대시보드 상태 표기 개선
- `OnboardingModal.tsx`: 로컬 AI 독립 모드(100% 무료/오프라인) vs 온라인 클라우드 모드 선택 분기.
- `DashboardPage.tsx`: 무조건 "로컬 연결됨" 표기 버그 수정 ➔ 실시간 헬스체크 기반 🟢 연결됨 / 🔴 오프라인 표기.
### 3) 오디오 장치 탐색 비동기화 (`AudioCaptureService.ts`)
- Windows PowerShell 마이크 디바이스 탐색에서 `execSync` 동기 블로킹 제거 ➔ 완전 비동기 `exec` 논블로킹으로 변경 (기동 시 5초 `ETIMEDOUT` 프리징 완전 제거).
### 4) Windows 데스크톱 실행 및 윈도우 스테이션 격리 해결
- `src/main/index.ts`: `app.setName('d3ro-voice')`, `app.setAppUserModelId('kr.twentyoz.d3ro-voice')` 명시.
- GPU 하드웨어 가속 충돌 방지 (`app.disableHardwareAcceleration()`, `--disable-gpu`).
- `run-desktop.bat`: 잔여 프로세스 및 stale `lockfile` 선제 정리 후 `electron-vite dev` 기동.
- `.agents/rules/desktop-app-execution-and-windows.md`: 영구 지침 파일 생성 및 `CLAUDE.md` 규칙 반영.
---
## 2. 향후 에이전트 필수 준수 지침 (Rules)
1. **AI 에이전트 서브쉘(가상 데스크톱 `exebox`)에서 GUI 백그라운드 구동을 반복하지 말 것**:
- 에이전트의 서브쉘 도구(`run_command`)는 보안 가상 데스크톱(`WinSta0\exebox-...`)에서 프로세스를 띄우므로 사용자의 실제 모니터 화면(`WinSta0\Default`)에는 창이 보이지 않는다.
- GUI 실행은 사용자가 `run-desktop.bat` 또는 외부 터미널에서 실행하도록 안내한다.
2. **Single Instance Lock & 사일런트 종료 방지**:
- `app.setName('d3ro-voice')`와 `app.setAppUserModelId`를 최상단에 항상 유지하고, dev 모드에서 락 파일 충돌로 인한 사일런트 종료를 방지한다.
3. **오디오 장치 탐색**:
- `execSync` 동기 블로킹 절대 금지.