햄이 (Hami) | Changmin.dev

기술 스택

투명하고 프레임 없는 펫 창을 만들었습니다. 드래그로 옮길 수 있고, 다시 켜도 마지막 위치가 복원되며, 투명 영역은 클릭이 뒤쪽 프로그램으로 통과합니다. 시스템 트레이도 구현했습니다.
7가지 감정 상태 머신과 픽셀아트 애니메이션, 타자기 효과 말풍선을 구현했습니다.
Gemini API로 자연어 일정 등록, 수정, 삭제 대화를 구현했습니다. 정보 수집, 확인, 실행 단계를 거쳐 사용자가 승인한 뒤에만 등록하고, "다음 주 월요일" 같은 상대 날짜는 KST 기준으로 계산합니다.
월간 달력 다이어리, 할 일, 뽀모도로 타이머, AI 감성 일기, 리마인더 알림, 공휴일 표시 기능을 만들었습니다.
contextBridge와 IPC 입력 검증으로 Renderer와 Main 사이의 보안 경계를 설계하고, 단일 인스턴스를 보장했습니다.
electron-builder로 Windows x64 portable 패키징을 했습니다.

증상: 일정 등록 대화 중 AI가 필요한 정보를 확인하려고 함수를 반복 호출해서 Rate Limit에 걸리고 응답이 느려졌습니다.
원인: 같은 요청이 중복 실행되고, 대화가 끝나기 전에 여러 함수 호출이 동시에 일어났습니다.
해결: 한 번의 요청에서 실행할 수 있는 함수 호출 범위를 제한하고, 요청 큐로 Gemini 호출을 하나씩 직렬화했습니다. Rate Limit 응답에는 최대 3회 재시도하고, 타임아웃과 예외 처리를 추가했습니다.

증상: "금요일쯤 약속", "다음 주에 병원" 같은 표현에서 날짜나 시간이 빠지거나 파싱에 실패했습니다.
원인: AI 응답 형식이 일정하지 않아, 임의로 해석하면 잘못된 일정 데이터가 만들어졌습니다.
해결: 필수 필드와 대화 단계를 담은 응답 스키마를 정의해 검증하고, 정보가 모호하면 추가 질문을 하게 했습니다. 저장 전에는 내용을 요약해 보여 주고, 사용자가 명확히 승인한 경우에만 등록합니다.

선택지: 앱에 키를 내장 vs 사용자가 자신의 Gemini 키를 입력(BYOK)
결정: BYOK 방식을 택했습니다.
근거와 한계: 배포 앱에 비밀값이 들어가지 않습니다. 다만 입력받은 키를 아직 암호화하지 않고 저장하고 있어, 배포 전에 개선해야 합니다.