jacemaster/AI
최근 수정 시각: 2026-07-11 00:13:16
1. 무엇을 하나
jacemaster의 AI는 별도 챗봇 화면이 아니라 기록 흐름 안의 특정 작업을 보조한다. 서버에 설정된 Gemini 키를 공통 호출 코어가 사용하고, 화면은 생성 결과를 바로 저장하지 않고 가능한 경우 검토·선택 단계를 둔다.
2. 기능별 사용 위치
| 기능 | 실제 화면 동선 | 결과 |
|---|---|---|
| 식단 사진 분석 | jacemaster/운동·식단 → 식단 → 끼니의 사진·분석 → 사진 업로드 → AI로 음식 분석 | 음식 후보, 영양소 추정, 신뢰도와 메모 |
| 영수증 OCR | jacemaster/가계부 → 영수증 → 사진 업로드 → 바니가 읽기 | 거래 후보와 카테고리 힌트 |
| 월간 가계 리포트 | jacemaster/가계부 → 리포트 → 이번 달 분석/지금 분석 | 요약, 하이라이트, 다음 달 제안 |
| 주간 의식 요약 | jacemaster/의식 → 지난 날들 → 지난주의 결 | 지난주 기록의 세 문장 요약과 감정 빈도 |
| 메모→업무 | jacemaster/업무 → 메모→업무 → 메모 분석 | 태스크 생성·수정·삭제 후보 |
3. 식단 사진 분석
업로드된 식단 사진을 R2에서 읽어 Gemini Vision에 전달한다. 결과에는 여러 음식과 칼로리·탄수화물·단백질·지방 추정치, 전체 신뢰도와 주의 메모가 포함된다. 사용자는 포함할 음식과 수량을 조정한 뒤 선택한 음식 추가로 기록한다.
4. 영수증과 가계 리포트
영수증 OCR은 이미지에서 거래 후보를 추출한다. 원본 이미지와 후보를 나란히 검토한 뒤 선택한 항목만 가계부에 저장한다. 월간 리포트는 먼저 D1 거래를 집계하고, Gemini 키가 있으면 그 숫자를 바탕으로 설명·하이라이트·추천을 더한다. 키가 없어도 숫자 집계는 남는다.
5. 의식 요약과 메모 변환
의식 요약은 가장 최근에 끝난 월~일 한 주를 대상으로 하며, 같은 주 결과는 생성 후 캐시한다. 메모→업무는 자유 문장에서 생성·수정·삭제 액션을 구조화하고, 사용자가 체크한 액션만 적용한다. 적용 기록에는 AI 행위자 정보가 남는다.
6. 키가 없을 때
서버에 GEMINI_API_KEY가 없으면 생성형 버튼은 need_key 안내를 보여 준다. 식단은 음식 직접 추가, 가계부는 거래 직접 입력, 업무는 태스크 직접 생성처럼 각 모듈의 수동 경로를 계속 사용할 수 있다. 사용자가 브라우저 화면에 API 키를 입력하는 구조는 아니다.
7. 검토 원칙
- 사진 속 양·영양소와 영수증 숫자는 추정 또는 OCR 결과다. 원본과 대조한다.
- 메모 변환의 수정·삭제 후보는 반드시 체크 목록을 검토한다.
- 생성형 요약은 기록을 해석한 문장이지 원본 데이터가 아니다.
- 민감한 이미지와 생활 기록이 외부 모델 호출에 사용된다는 점을 감안해 업로드 범위를 결정한다.