Meerkat 패치 노트

📌 v1.4.1 (2026-04-13)

✨ **보이스 분석 명령 내부 최적화**
`!participation-balance` 명령어가 동일 기간의 유저별 보이스 집계를 한 번만 계산하고, 요약/상위 기여자 데이터를 재사용하도록 개선했습니다.
`!onboarding-health` 명령어가 신규 유저 활동 기반 데이터를 한 번만 조회한 뒤, 핵심 지표와 `--list` 대상 목록을 함께 계산하도록 개선했습니다.
`!stats`, `!participation-balance`, `!onboarding-health`에 짧은 TTL 캐시를 추가하여 버튼으로 기간을 다시 눌렀을 때 불필요한 반복 조회를 줄였습니다.
이번 변경은 내부 로직 최적화 중심이며, 기존 명령 결과 형식과 외부 DTO 계약은 유지됩니다.

✨ **문서 사이트 커맨드 가이드 최신화**
현재 `meerkat-bot`에서 실제 사용할 수 있는 명령 기준으로 docs의 기능 문서를 다시 정리했습니다.
`!onboarding-health`, `!participation-balance`, `!rank dm`, `anon`, `--list` 등 최근 운영 분석/조회 옵션을 문서에 반영했습니다.
`!voicetime`, `!mysummary`, `!stats`, `!rank`, `!rank-medal`, `!welcome`, `!filter`, `!settings`, `!locale`, `!prune-members`, `!점메추 / !저메추` 설명을 현재 동작에 맞게 업데이트했습니다.
✨ **카테고리 구조 정비**
`utility`, `fun` 카테고리를 탐색에 추가해 실제 공개 명령을 더 쉽게 찾을 수 있게 했습니다.
`role-management`, `custom-commands` 카테고리는 유지하되, 아직 문서화되지 않은 영역임을 명시하는 준비중 상태로 정리했습니다.

✨ **보이스 통계·랭킹 기능 고도화**
`!voicetime` / `!mysummary` 명령어를 추가하여, 개인 보이스 누적 시간과 요약을 기간별로 확인할 수 있습니다.
`!rank-medal` 명령어를 통해 보이스 랭킹 TOP3에게 자동으로 메달(🥇🥈🥉) 이모지를 닉네임 앞에 부여합니다.
보이스 관련 명령어(`!rank`, `!stats`, `!voicetime`, `!mysummary`) 문구를 모두 다국어(locale) 시스템으로 이관했습니다.
✨ **개인정보 및 데이터 관리 기능**
`!forgetme` 명령어로 본인의 보이스 기록을 한 번에 삭제할 수 있습니다.
`!prune-members` 명령어로 이미 서버를 떠난 유저의 보이스 기록을 정리할 수 있습니다. `--dry-run` 옵션으로 삭제 전 결과를 미리 확인할 수 있습니다.
`!settings voicetime-default` 옵션으로 `!voicetime` / `!mysummary` 기본 조회 기간을 설정할 수 있습니다.
✨ **웹 대시보드 연동 강화**
`!help` 임베드 하단과 버튼에 Docs / Dashboard 링크를 추가했습니다.
`!rank`, `!stats` 결과에 "웹 대시보드에서 자세히 보기" 버튼과 안내 문구를 추가하여 GUI로 자연스럽게 이동할 수 있습니다.