diff --git a/ideas/rb10508_to_rb8001_migration_guide.md b/ideas/rb10508_to_rb8001_migration_guide.md new file mode 100644 index 0000000..444b341 --- /dev/null +++ b/ideas/rb10508_to_rb8001_migration_guide.md @@ -0,0 +1,106 @@ +# rb10508 → rb8001 이식 가이드 + +## 작성일: 2025-08-28 +## 작성자: 서버 관리자 +## 목적: rb10508의 검증된 기능을 rb8001에 선택적 이식 + +--- + +## 현재 상태 비교 + +### 메모리 사용량 +- **rb8001**: 145MB (이미 경량화, skill-embedding 사용) +- **rb10508**: 136MB (동일하게 skill-embedding 사용) +- **결론**: 둘 다 이미 최적화됨, 메모리는 이식 대상 아님 + +### ChromaDB 버전 +- **rb8001**: v0.5.20 (구버전, 984KB) +- **rb10508**: v1.0.16 (최신) +- **이식 필요**: ✅ 업그레이드 권장 + +--- + +## 핵심 이식 대상 (우선순위) + +### 1. 🔥 메모리 알고리즘 개선 (즉시 가능) +```python +# rb10508의 고급 알고리즘 +- add_composite_scores(): 복합 점수 계산 +- maximal_marginal_relevance(): 다양성 확보 + 중복 제거 + +# rb8001 현재 +- 단순 유사도 검색만 사용 +``` +**이식 방법**: `/app/memory/scoring.py` 함수만 복사 + +### 2. 📁 다중 컬렉션 구조 (중요) +```python +# rb10508: 메모리 타입별 분류 +- episodic_memory # 대화 이벤트 +- semantic_memory # 개념/지식 +- procedural_memory # 작업 방법 + +# rb8001: 단일 컬렉션만 사용 +``` +**이식 방법**: ChromaDB 마이그레이션 필요 + +### 3. 🎮 Gmail 아이템 권한 체크 (높음) +```python +# rb10508: growth.py 시스템 +async def check_item_equipped(user_id, "gmail"): + # 스킬 호출 전 권한 확인 + if not is_equipped: + return "Gmail을 먼저 연결해주세요!" + +# rb8001: 체크 없이 바로 호출 → 에러 발생 +``` +**이식 방법**: `/app/core/growth.py` 추가 + +### 4. 👤 사용자별 메모리 격리 (필수) +```python +# rb10508: 사용자별 독립 컬렉션 +f"{robeing_id}_{user_id}_episodic" + +# rb8001: 기본 컬렉션 공유 문제 +``` +**이식 방법**: 컬렉션 명명 규칙 변경 + +--- + +## 구현 상태 vs 설계 + +| 모듈 | rb8001 | rb10508 | 실제 구현 여부 | 이식 가치 | +|------|--------|---------|--------------|-----------| +| **MMR 알고리즘** | ❌ | ✅ | 구현 완료 | ⭐⭐⭐⭐⭐ | +| **다중 컬렉션** | ❌ | ✅ | 구현 완료 | ⭐⭐⭐⭐ | +| **아이템 체크** | ❌ | ✅ | 구현 완료 | ⭐⭐⭐⭐ | +| **베이지안 메모리** | ❌ | 부분 | 부분 구현 | ⭐⭐⭐ | +| **Langchain** | ❌ | ✅ | 구현 완료 | ⭐⭐⭐ | +| **감정 시스템** | ❌ | 임시 | 미구현 | ⭐ | +| **윤리 필터** | ❌ | 빈 파일 | 미구현 | ⭐ | + +--- + +## 단계별 이식 계획 + +### Phase 1 (즉시) +1. MMR 알고리즘 함수 복사 +2. composite_scores 추가 +3. 테스트 및 검증 + +### Phase 2 (1주) +1. ChromaDB 1.0 업그레이드 +2. 다중 컬렉션 마이그레이션 +3. 사용자별 격리 구현 + +### Phase 3 (2주) +1. growth.py 아이템 시스템 +2. Gmail 권한 체크 미들웨어 +3. 스킬 호출 전 검증 로직 + +--- + +## 주의사항 +- 감정/윤리 모듈은 설계만 존재, 실제 구현 없음 +- Stats 시스템은 rb8001이 더 완성도 높음 (유지) +- 이미 둘 다 skill-embedding 사용 중 (메모리 최적화 완료) \ No newline at end of file