ltcai 0.1.29 → 0.1.31

package/docs/CHANGELOG.md

@@ -1,5 +1,57 @@
 # Changelog
 
+## [0.1.31] - 2026-05-25
+
+### 모델 추천 보정 — 하드웨어 대비 과도한 모델 방지
+
+- **Apple Silicon 32GB 추천 모델 하향 조정**
+  - 32GB Mac: `Qwen3-VL-30B-A3B` (18GB) → `Qwen3-VL-8B` (q5_K_M, 5GB) 로 변경
+  - 30B-A3B 모델은 48GB 이상에서만 추천 (OS 오버헤드 + KV 캐시 여유 확보)
+  - 32GB 시스템에서 메모리 압박으로 인한 성능 저하 방지
+
+- **`auto_setup.py` `_MODEL_CATALOG` 보수적 임계값 적용**
+  - 30B-A3B: 최소 RAM 32GB → 48GB
+  - 24GB VRAM 임계값 조정 (12GB로 완화하여 중급 GPU 커버)
+  - 각 티어 간 여유분을 확보하여 실사용 시 안정적 추론 보장
+
+- **`setup.py` 추천 로직 보정**
+  - Apple Silicon 기본 추천 30B 임계값: `ram >= 32` → `ram >= 48`
+  - MLX 모델 카탈로그 min_ram 상향: Qwen3-VL 30B (32→48), Gemma 3 27B (32→48), Gemma 4 26B (24→32), Mistral Small 24B (24→32), Qwen2.5 Coder 32B (32→36)
+  - 크로스 플랫폼(vLLM/LM Studio) 30B 모델: 전용 GPU 시스템은 min_ram=32 유지 (VRAM에 로드되므로 RAM 부담 적음)
+
+### Release
+- 배포 버전을 `0.1.31`로 상향
+- 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`
+
+---
+
+## [0.1.30] - 2026-05-25
+
+### 코드 품질 및 리팩토링
+
+- **`server.py` 모듈 분리** — 7,568줄 → 6,798줄
+  - MCP 레지스트리 상수 + 원격 레지스트리 페치 + 스킬 마켓플레이스 + 플러그인 디렉터리 로직을 `mcp_registry.py`(791줄)로 분리
+  - `server.py`의 가독성과 유지보수성 대폭 향상
+
+- **버그 수정 6건**
+  - `requirements.txt`에 누락된 `pymupdf` 추가 (Docker 빌드 실패 방지)
+  - 비밀번호 해싱 로그 메시지 "bcrypt" → 실제 알고리즘 "scrypt"로 수정
+  - HuggingFace 모델 캐시 경로 `~/.latticeai/` → `~/.ltcai/`로 통일 (DATA_DIR과 일치)
+  - OpenRouter 모델 카탈로그: Claude 3.5 → Claude 4.x, Gemini 2.0 → 2.5 업데이트
+  - `.gitignore`에 임시 파일, 로그, 세션 파일 패턴 8개 추가
+  - 고아 파일 정리 (구버전 GIF, 캡처 스크립트 삭제)
+
+- **README 개선**
+  - v0.1.29 실제 UI에서 새로 찍은 스크린샷 3장 + 애니메이션 데모 GIF 추가
+  - GitHub Actions CI 배지 추가
+  - 스크린샷에 이모지 레이블 + 설명 캡션 추가
+
+### Release
+- 배포 버전을 `0.1.30`으로 상향
+- 대상 채널: `npm` · `PyPI` · `VS Code Marketplace` · `Open VSX`
+
+---
+
 ## [0.1.29] - 2026-05-25
 
 ### 관리자 UX 및 거버넌스 개선