e24bb8378c
- CLAUDE.md: 프로젝트 규칙, 기술 스택, 코딩 규칙, 페이즈 로드맵 - .claude/settings.json: 권한, 강제 훅 (매 프롬프트 설계서 규칙 주입) - .claude/skills/: implement-phase, review-phase, scaffold, test-commit, debug - .claude/agents/: electron-architect, voice-pipeline-expert, ui-specialist - docs/design/00-09: 마스터 아키텍처, 서비스 명세(16개), IPC(113채널), DB스키마, UI컴포넌트, 검증리포트, 외부엔진연동, 갭분석, VoiceMode패턴, 디자인시스템, 히스토리팝업 - docs/phases/1-7+3.5: 전체 구현 페이즈 문서 - docs/re-findings/: Speakly RE 노하우 5개 문서
29 lines
858 B
Markdown
29 lines
858 B
Markdown
---
|
|
name: debug-electron
|
|
description: Electron 앱 디버깅. IPC 문제, 메모리 누수, 렌더러 크래시 등 진단.
|
|
allowed-tools: Read Grep Glob Bash
|
|
---
|
|
|
|
# Electron Debug
|
|
|
|
## 일반 디버깅
|
|
1. 로그 확인 (`electron-log` 출력)
|
|
2. IPC 채널 매칭 검증 (`shared/ipc-channels.ts` vs 실제 핸들러)
|
|
3. 프리로드 스크립트 노출 API 확인
|
|
|
|
## IPC 문제
|
|
- `shared/ipc-channels.ts`에 채널 정의 확인
|
|
- `src/main/ipc/`에 핸들러 등록 확인
|
|
- `src/preload/index.ts`에 브릿지 노출 확인
|
|
- 렌더러에서 `window.electronAPI.*` 호출 확인
|
|
|
|
## 오디오 문제
|
|
- Web Audio API 초기화 상태
|
|
- 마이크 권한 확인
|
|
- AudioContext sampleRate (24000Hz)
|
|
- noiseSuppression: false 확인
|
|
|
|
## 메모리 누수
|
|
- useEffect cleanup 함수 확인
|
|
- IPC 이벤트 리스너 제거 확인
|
|
- BrowserWindow destroy 확인
|