Some checks failed
ci / 정본·보안·린트·타입·테스트 (push) Failing after 22s
ci / 워크스페이스 빌드 검증 (push) Has been skipped
ci / 모바일 린트·타입·Jest (push) Successful in 39s
ci / Supabase Edge Functions + Cloudflare Worker (push) Successful in 20s
ci / .NET API 서버 테스트 (push) Successful in 8s
deploy-site / deploy (push) Successful in 27s
82 lines
5.8 KiB
Markdown
82 lines
5.8 KiB
Markdown
# Session Handoff — 2026-11-04 (Windows v1.16.1 패치 배포)
|
|
|
|
> Environment: Windows (ALPACA-HOME)
|
|
> Released commits: `21a684d` (fix), `77e6796` (release tag `v1.16.1`).
|
|
|
|
## 배포 결과
|
|
|
|
- 빠른 한영 자판 교정의 다음 키·백스페이스 경합 수정을 정식 `npm run release -- patch` 경로로 Windows v1.16.1에 배포했다.
|
|
- 데스크톱 전체 192 files / 2,773 tests, typecheck, 변경 범위 lint, production build를 통과했다.
|
|
- 설치본(95,987,835 bytes), blockmap, 서명된 `latest.yml`·`.sig`를 Forgejo에 게시하고 canonical 및 GitLab mirror에 main과 annotated tag를 푸시했다.
|
|
- 공개 `latest`와 불변 `1.16.1` 매니페스트가 모두 1.16.1이며 설치 파일은 HTTP 200이다. 기존 설치본은 다음 자동 업데이트 확인에서 받는다.
|
|
|
|
## 남은 작업
|
|
|
|
1. 사용자 설치본을 1.16.1로 업데이트한 뒤 같은 Latin layout 대조군을 다시 실행한다.
|
|
2. 물리 키보드와 Chromium/terminal에서 교정 경합을 확인한다. 이 검증 전까지 GAP-INPUT-11은 `[~]`다.
|
|
3. 모바일 운영 배포와 인증 Android file-to-minutes는 외부 자격 증명·기기 게이트가 남아 있다.
|
|
|
|
---
|
|
|
|
# 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` 동기 블로킹 절대 금지.
|