companionbot 0.14.0 → 0.15.1

package/README.md

@@ -1,327 +1,156 @@
 # CompanionBot
 
-> Claude 기반의 개인화된 페르소나를 가진 AI Companion Bot
+> Claude 기반 개인 AI 친구 - 텔레그램 봇
 
 [![npm version](https://badge.fury.io/js/companionbot.svg)](https://www.npmjs.com/package/companionbot)
 [![Node.js](https://img.shields.io/badge/node-%3E%3D18.0.0-brightgreen)](https://nodejs.org)
 [![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
 
-## 주요 기능
+## ✨ 특징
 
-### 💬 대화
-- **자연스러운 대화** - Claude Sonnet/Opus/Haiku 모델 선택 가능
-- **페르소나 커스터마이징** - 첫 실행 시 온보딩으로 봇의 성격, 말투, 이름 설정
-- **이미지 분석** - 사진을 보내면 분석
-- **링크 요약** - URL을 보내면 내용을 읽고 요약
+- 🧠 **Extended Thinking** - Claude의 사고 과정 활용
+- 🔍 **시맨틱 메모리** - 로컬 임베딩으로 관련 기억 검색
+- ⚡ **빠른 응답** - 사전 로딩, 병렬 처리, 스마트 캐싱
+- 🎭 **페르소나** - 이름, 성격, 말투 커스터마이징
+- 🔧 **20+ 도구** - 파일, 웹, 일정, 메모리 등
 
-### 🔍 정보 검색 (v0.3.0)
-- **웹 검색** - "최신 React 뉴스 검색해줘" (Brave Search API)
-- **웹 페이지 읽기** - URL 내용을 가져와서 분석/요약
-
-### ⏰ 일정 관리
-- **리마인더** - "10분 뒤에 알려줘"
-- **Google Calendar 연동** - 일정 조회/추가/삭제
-- **일일 브리핑** - 매일 아침 날씨와 일정 알림
-- **Heartbeat** - 주기적으로 체크리스트 확인 후 알림
-
-### 🕐 스케줄링 (v0.3.0)
-- **Cron 작업** - "매일 아침 9시에 뉴스 알려줘", "평일 오후 6시에 퇴근 알림"
-- **일회성 예약** - "내일 오전 9시에 알려줘"
-- **반복 작업** - "30분마다 주식 가격 확인해줘"
-
-### 🤖 고급 기능 (v0.3.0+)
-- **서브 에이전트** - 복잡한 작업을 백그라운드에서 처리
-- **백그라운드 실행** - 긴 명령어를 백그라운드에서 실행하고 결과 확인
-- **파일 시스템** - 워크스페이스 내 파일 읽기/쓰기/편집
-- **일일 메모리** - 대화 내용 자동 저장
-
-### 🧠 시맨틱 메모리 (v0.6.0)
-- **벡터 검색** - 임베딩 기반 관련 메모리 검색
-- **자동 인덱싱** - 메모리 파일 자동 청크 분할 및 임베딩
-- **유사도 매칭** - 의미 기반으로 관련 대화 기록 찾기
-
-### 🔧 시스템 (v0.6.0)
-- **헬스 체크** - 봇 상태 모니터링 (uptime, 메시지 수, 오류 수)
-- **업데이트 알림** - 새 버전 출시 시 자동 알림
-
-## 설치
-
-### 사전 준비
-
-- **Node.js 18+** ([다운로드](https://nodejs.org))
-- **Telegram Bot Token** - [@BotFather](https://t.me/BotFather)에서 봇 생성 후 발급
-- **Anthropic API Key** - [console.anthropic.com](https://console.anthropic.com)에서 발급
-
-#### Linux 사용자 (keytar 의존성)
-
-```bash
-# Debian/Ubuntu
-sudo apt-get install libsecret-1-dev
-
-# Fedora
-sudo dnf install libsecret-devel
-
-# Arch
-sudo pacman -S libsecret
-```
-
-### 간편 설치
+## 🚀 빠른 시작
 
 ```bash
 npm install -g companionbot
 companionbot
 ```
 
-### 개발자 설치
-
-```bash
-git clone https://github.com/DinN0000/CompanionBot.git
-cd companionbot
-npm install
-npm run build
-npm start
-```
-
-## 첫 실행
+첫 실행 시 안내에 따라:
+1. Telegram Bot Token 입력 ([@BotFather](https://t.me/BotFather))
+2. Anthropic API Key 입력 ([console.anthropic.com](https://console.anthropic.com))
+3. Telegram에서 봇에게 `/start` 보내기
 
-처음 실행하면 대화형 설정이 시작됩니다:
-
-```
-🤖 CompanionBot 첫 실행입니다!
-
-[1/2] Telegram Bot Token
-      @BotFather에서 봇 생성 후 토큰을 붙여넣으세요.
-      Token: _
-
-[2/2] Anthropic API Key
-      console.anthropic.com에서 발급받으세요.
-      API Key: _
-
-📁 워크스페이스 생성 중...
-   → ~/.companionbot/ 생성 완료
-
-🚀 봇을 시작합니다!
-```
-
-설정 완료 후 **Telegram에서 봇에게 `/start`를 보내면** 온보딩이 시작됩니다:
-- 봇 이름 짓기
-- 성격과 말투 설정
-- 사용자 정보 입력
-
-## 명령어
-
-### 기본 명령어
+## 📱 명령어
 
 | 명령어 | 설명 |
 |--------|------|
-| `/start` | 봇 시작 (첫 실행 시 온보딩) |
+| `/help` | 도움말 보기 |
+| `/model` | AI 모델 변경 (haiku/sonnet/opus) |
 | `/compact` | 대화 정리 (토큰 절약) |
-| `/memory` | 최근 일주일 기억 보기 |
-| `/model [id]` | AI 모델 변경 (sonnet/opus/haiku) |
-| `/reset` | 페르소나 초기화 (온보딩 다시) |
-
-### 기능 설정
-
-| 명령어 | 설명 |
-|--------|------|
-| `/setup` | 전체 기능 설정 메뉴 |
-| `/setup weather` | 날씨 API 설정 |
-| `/setup calendar` | Google Calendar 설정 |
-| `/setup briefing` | 일일 브리핑 설정 |
-| `/setup heartbeat` | Heartbeat 설정 |
-
-### 빠른 명령어
-
-| 명령어 | 설명 |
-|--------|------|
-| `/briefing` | 일일 브리핑 토글 |
-| `/heartbeat` | Heartbeat 토글 |
-| `/reminders` | 알림 목록 보기 |
-| `/calendar` | 오늘 일정 보기 |
-
-### 자연어 명령
+| `/memory` | 최근 기억 보기 |
+| `/health` | 봇 상태 확인 |
+| `/setup` | 전체 기능 설정 |
 
-명령어 대신 자연스럽게 말해도 됩니다:
+### 자연어로도 가능
 
 ```
-모델 변경      "하이쿠로 바꿔줘" / "opus로 변경해줘"
-리마인더       "10분 뒤에 알려줘" / "내일 9시에 회의 알림"
-브리핑         "브리핑 켜줘" / "지금 브리핑 해줘" / "아침 9시에 브리핑"
-Heartbeat     "하트비트 켜줘" / "10분마다 체크해줘"
-날씨          "서울 날씨 어때?" / "도쿄 날씨 알려줘"
-메모리        "이거 기억해둬"
-웹 검색       "React 19 검색해줘" / "최신 뉴스 찾아줘"
-Cron          "매일 아침 9시에 뉴스 알려줘" / "평일 오후 6시에 퇴근 알림"
-서브에이전트   "이 코드 분석해줘" (복잡한 작업은 자동으로 서브에이전트 사용)
+"하이쿠로 바꿔줘"
+"10분 뒤에 알려줘"
+"서울 날씨 어때?"
+"React 19 검색해줘"
+"매일 아침 9시에 뉴스 알려줘"
 ```
 
-## 선택적 기능 설정
+## 🔧 주요 기능
 
-### 🌤️ 날씨 (OpenWeatherMap)
+### AI 엔진
+- **Claude 모델** - Sonnet 4 / Opus 4 / Haiku 3.5
+- **Extended Thinking** - 내부 스트리밍으로 thinking 지원
+- **도구 사용** - 20+ 도구, 병렬 실행
 
-1. [openweathermap.org](https://openweathermap.org) 가입
-2. API Keys에서 무료 키 발급
-3. 봇에게 DM으로: `/weather_setup YOUR_API_KEY`
+### 메모리 시스템
+- **로컬 임베딩** - @xenova/transformers
+- **하이브리드 검색** - 벡터 + 키워드 (FTS5)
+- **한국어 최적화** - trigram tokenizer
 
-### 📅 Google Calendar
+### 일정/알림
+- **리마인더** - 자연어로 알림 설정
+- **Google Calendar** - 일정 조회/추가
+- **Cron** - 반복 작업 스케줄링
+- **브리핑/하트비트** - 주기적 알림
 
-1. [Google Cloud Console](https://console.cloud.google.com) 접속
-2. 프로젝트 생성 → Calendar API 활성화
-3. OAuth 동의 화면 설정 (앱 이름, 범위 추가)
-4. 사용자 인증 정보 → OAuth 클라이언트 ID (데스크톱 앱)
-5. 봇에게 DM으로: `/calendar_setup CLIENT_ID CLIENT_SECRET`
-6. 인증 링크 클릭하여 Google 로그인
+### 성능
+- **Warmup** - 시작 시 사전 로딩
+- **병렬 처리** - 워크스페이스, 도구 실행
+- **LRU 캐시** - 임베딩, 워크스페이스
 
-### 🔍 웹 검색 (Brave Search)
-
-1. [Brave Search API](https://api.search.brave.com) 가입
-2. API 키 발급
-3. 터미널에서: `npm run setup brave YOUR_API_KEY`
-
-## PM2로 상시 실행
-
-```bash
-# PM2 설치
-npm install -g pm2
-
-# 봇 시작
-pm2 start npm --name companionbot -- start
-
-# 부팅 시 자동 시작
-pm2 startup && pm2 save
-
-# 로그 확인
-pm2 logs companionbot
-
-# 재시작
-pm2 restart companionbot
-```
-
-## 워크스페이스
+## 📁 워크스페이스
 
 `~/.companionbot/` 구조:
 
 ```
-├── AGENTS.md      # 운영 지침 (봇 행동 규칙)
-├── BOOTSTRAP.md   # 온보딩 프롬프트 (완료 후 삭제됨)
-├── HEARTBEAT.md   # 주기적 체크 항목
-├── IDENTITY.md    # 봇 정체성 (이름, 이모지, 소개)
-├── MEMORY.md      # 장기 기억
-├── SOUL.md        # 봇 성격과 말투
-├── TOOLS.md       # 도구 설정 노트
+├── SOUL.md        # 봇 성격/말투
+├── IDENTITY.md    # 이름, 이모지
 ├── USER.md        # 사용자 정보
-├── canvas/        # 봇 작업 디렉토리
-├── cron.json      # 크론 작업 저장
+├── MEMORY.md      # 장기 기억
+├── AGENTS.md      # 행동 지침
+├── HEARTBEAT.md   # 주기적 체크 항목
+├── TOOLS.md       # 도구 설정
+├── canvas/        # 작업 디렉토리
 └── memory/        # 일일 로그
     └── YYYY-MM-DD.md
 ```
 
-### 파일 커스터마이징
-
-- **SOUL.md** - 봇의 성격, 말투, 관심사 수정
-- **HEARTBEAT.md** - 주기적으로 체크할 항목 설정
-- **AGENTS.md** - 봇의 행동 지침 수정
+## ⚙️ 선택 기능
 
-## 시크릿 저장
-
-API 키는 OS 키체인에 안전하게 저장됩니다:
+### 날씨 (OpenWeatherMap)
+```bash
+companionbot setup weather
+```
 
-| OS | 저장 위치 |
-|----|-----------|
-| macOS | Keychain Access |
-| Windows | Credential Manager |
-| Linux | libsecret (GNOME Keyring 등) |
+### Google Calendar
+```bash
+companionbot setup calendar
+```
 
-완전 초기화: `~/.companionbot/` 폴더 삭제 후 다시 실행
+### 웹 검색 (Brave Search)
+```bash
+companionbot setup brave
+```
 
-## 트러블슈팅
+## 🖥️ PM2로 상시 실행
 
-### 봇이 응답하지 않아요
+```bash
+npm install -g pm2
+pm2 start companionbot --name bot
+pm2 startup && pm2 save
+```
 
-1. **API 키 확인**: Anthropic API 키가 유효한지 확인
-2. **토큰 확인**: Telegram Bot Token이 정확한지 확인
-3. **로그 확인**: `pm2 logs companionbot` 또는 터미널 출력 확인
+## 🔒 보안
 
-### "rate limit" 오류가 나요
+- API 키는 OS 키체인에 저장 (macOS Keychain, Windows Credential Manager, Linux libsecret)
+- 파일 접근 경로 검증 (TOCTOU 방지)
+- 명령어 화이트리스트
+- SSRF 방지
 
-- Anthropic API 사용량 한도 초과
-- 잠시 후 다시 시도하거나 API 플랜 업그레이드
+## 🐛 트러블슈팅
 
-### Linux에서 설치 오류
+### 봇이 응답 안 해요
+1. API 키 확인
+2. `tail -f /tmp/companionbot.log` 로그 확인
 
+### Linux 설치 오류
 ```bash
-# keytar 의존성 설치 필요
 sudo apt-get install libsecret-1-dev  # Debian/Ubuntu
 ```
 
-### Google Calendar 인증 실패
-
-1. OAuth 클라이언트 ID가 "데스크톱 앱" 유형인지 확인
-2. 리디렉션 URI에 `http://localhost:3847/oauth2callback` 추가
-3. `/setup calendar off` 후 `/calendar_setup`으로 다시 시도
-
-### 온보딩이 다시 안 나와요
-
+### 초기화하고 싶어요
 ```bash
-# 페르소나 리셋
-# Telegram에서: /reset
-
-# 또는 완전 초기화
-rm -rf ~/.companionbot
-companionbot
+rm -rf ~/.companionbot && companionbot
 ```
 
-## 개발
+## 📜 버전
 
-```bash
-npm run dev    # 개발 모드 (tsx)
-npm run build  # TypeScript 빌드
-npm start      # 빌드된 코드 실행
-npm test       # 테스트 실행
-```
+현재: **v0.15.0**
+
+주요 변경:
+- 메모리 검색 → 도구 방식 (성능 개선)
+- tools 모듈 분할 (15개 파일)
+- Agent 메모리 누수 방지
+- /help 명령어, 한국어 메시지 통일
+
+전체 변경 이력: [CHANGELOG.md](CHANGELOG.md)
 
-## 버전 히스토리
-
-### v0.6.0 (현재)
-- 🧠 시맨틱 메모리 검색 (임베딩 기반)
-- 💚 헬스 체크 모니터링
-- 🔄 자동 업데이트 알림
-
-### v0.5.0
-- 🔒 보안 강화 (SSRF 방지, 경로 검증)
-- ✅ 테스트 추가 (vitest)
-- 📖 문서 개선
-
-### v0.4.0
-- 🛡️ 보안 강화 (TOCTOU, 심볼릭 링크 검증)
-- 🧹 세션 자동 정리
-- 🔧 환경변수 기반 경로 설정
-
-### v0.3.0
-- 🔍 웹 검색 (Brave Search API)
-- 🕐 Cron 스케줄링 (한국어 지원)
-- 🤖 서브 에이전트 (백그라운드 작업)
-- 🖥️ 백그라운드 명령어 실행
-- 📝 파일 편집 도구 추가
-
-### v0.2.0
-- 📅 Google Calendar 연동
-- ☀️ 일일 브리핑
-- 💓 Heartbeat 시스템
-- 🌤️ 날씨 조회
-
-### v0.1.0
-- 🚀 초기 릴리스
-- 💬 Claude 기반 대화
-- 🎭 페르소나 온보딩
-- ⏰ 리마인더
-- 🖼️ 이미지 분석
-- 🔗 링크 요약
-
-## 라이선스
+## 📄 라이선스
 
 [MIT](LICENSE)
 
 ---
 
-**문제가 있거나 기능 요청이 있으면** [Issues](https://github.com/DinN0000/CompanionBot/issues)에 등록해주세요!
+**Issues**: [github.com/DinN0000/CompanionBot/issues](https://github.com/DinN0000/CompanionBot/issues)

package/dist/agents/manager.js

@@ -8,6 +8,11 @@
  */
 import Anthropic from "@anthropic-ai/sdk";
 import { randomUUID } from "crypto";
+// ===== 제한 상수 =====
+const MAX_CONCURRENT_AGENTS = 10; // 전체 동시 Agent 최대 개수
+const MAX_AGENTS_PER_CHAT = 3; // chatId당 최대 동시 Agent 개수
+const CLEANUP_INTERVAL_MS = 30 * 60 * 1000; // 30분마다 cleanup
+const AGENT_TTL_MS = 30 * 60 * 1000; // Agent 보관 시간 (30분)
 // Agent 저장소
 const agents = new Map();
 // AbortController 저장소 (실행 중인 API 호출 취소용)
@@ -28,10 +33,50 @@ function getClient() {
 export function setAgentBot(bot) {
     botInstance = bot;
 }
+/**
+ * 가장 오래된 Agent 정리 (한도 초과 시)
+ */
+function evictOldestAgent() {
+    let oldest = null;
+    for (const agent of agents.values()) {
+        if (!oldest || agent.createdAt < oldest.createdAt) {
+            oldest = agent;
+        }
+    }
+    if (oldest) {
+        console.log(`[AgentManager] Evicting oldest agent: ${oldest.id}`);
+        // running이면 취소
+        if (oldest.status === "running") {
+            cancelAgent(oldest.id);
+        }
+        agents.delete(oldest.id);
+    }
+}
+/**
+ * chatId당 Agent 개수 확인
+ */
+function countAgentsForChat(chatId) {
+    let count = 0;
+    for (const agent of agents.values()) {
+        if (agent.chatId === chatId && agent.status === "running") {
+            count++;
+        }
+    }
+    return count;
+}
 /**
  * Sub-agent 생성 및 실행
  */
 export async function spawnAgent(task, chatId) {
+    // chatId당 제한 확인
+    const chatAgentCount = countAgentsForChat(chatId);
+    if (chatAgentCount >= MAX_AGENTS_PER_CHAT) {
+        throw new Error(`이 채팅에서 동시에 실행 가능한 Agent 수(${MAX_AGENTS_PER_CHAT}개)를 초과했습니다. 기존 Agent 완료를 기다려주세요.`);
+    }
+    // 전체 한도 확인 및 정리
+    while (agents.size >= MAX_CONCURRENT_AGENTS) {
+        evictOldestAgent();
+    }
     const id = randomUUID().slice(0, 8);
     const agent = {
         id,
@@ -41,6 +86,7 @@ export async function spawnAgent(task, chatId) {
         createdAt: new Date(),
     };
     agents.set(id, agent);
+    console.log(`[AgentManager] Agent created: ${id} (total: ${agents.size}/${MAX_CONCURRENT_AGENTS})`);
     // 비동기로 agent 실행 (await 하지 않음)
     runAgent(agent).catch((err) => {
         console.error(`[Agent ${id}] Error:`, err);
@@ -183,35 +229,47 @@ export function getAgent(agentId) {
     return agents.get(agentId);
 }
 /**
- * 오래된 agent 정리 (1시간 이상)
- * - 완료된 agent: completedAt 기준 1시간
- * - running 상태도 createdAt 기준 1시간 지나면 정리 (stuck 방지)
+ * 오래된 agent 정리 (30분 이상)
+ * - 완료된 agent: completedAt 기준 30분
+ * - running 상태도 createdAt 기준 30분 지나면 정리 (stuck 방지)
  */
 export function cleanupOldAgents() {
-    const oneHourAgo = Date.now() - 60 * 60 * 1000;
+    const cutoff = Date.now() - AGENT_TTL_MS;
+    let cleaned = 0;
     for (const [id, agent] of agents.entries()) {
         // 완료된 agent: completedAt 기준
-        if (agent.completedAt && agent.completedAt.getTime() < oneHourAgo) {
+        if (agent.completedAt && agent.completedAt.getTime() < cutoff) {
             agents.delete(id);
+            cleaned++;
             continue;
         }
-        // running 상태도 1시간 지나면 정리 (stuck agent 방지)
-        if (agent.status === "running" && agent.createdAt.getTime() < oneHourAgo) {
-            console.log(`[Agent ${id}] Cleaning up stuck agent (running > 1h)`);
+        // running 상태도 TTL 지나면 정리 (stuck agent 방지)
+        if (agent.status === "running" && agent.createdAt.getTime() < cutoff) {
+            console.log(`[Agent ${id}] Cleaning up stuck agent (running > 30min)`);
+            // 실행 중인 API 호출 취소
+            const controller = abortControllers.get(id);
+            if (controller) {
+                controller.abort();
+                abortControllers.delete(id);
+            }
             agents.delete(id);
+            cleaned++;
         }
     }
+    if (cleaned > 0) {
+        console.log(`[AgentManager] Cleanup: removed ${cleaned} agents (remaining: ${agents.size})`);
+    }
 }
 // Cleanup interval 참조 저장
 let cleanupIntervalId = null;
 /**
- * 정기 cleanup 시작
+ * 정기 cleanup 시작 (30분 주기)
  */
 export function startCleanup() {
     if (cleanupIntervalId)
         return; // 이미 실행 중
-    cleanupIntervalId = setInterval(cleanupOldAgents, 10 * 60 * 1000);
-    console.log("[AgentManager] Cleanup interval started");
+    cleanupIntervalId = setInterval(cleanupOldAgents, CLEANUP_INTERVAL_MS);
+    console.log(`[AgentManager] Cleanup interval started (every ${CLEANUP_INTERVAL_MS / 60000}min)`);
 }
 /**
  * 정기 cleanup 중지

package/dist/telegram/bot.js

@@ -72,9 +72,11 @@ export function createBot(token) {
     // 명령어 목록 등록
     bot.api
         .setMyCommands([
+        { command: "help", description: "도움말 보기" },
+        { command: "model", description: "AI 모델 변경" },
         { command: "compact", description: "대화 정리하기" },
         { command: "memory", description: "최근 기억 보기" },
-        { command: "reminders", description: "알림 목록 보기" },
+        { command: "health", description: "봇 상태 확인" },
     ])
         .catch((err) => console.error("Failed to set commands:", err));
     // 핸들러 등록

package/dist/telegram/handlers/commands.js

@@ -60,6 +60,32 @@ import { setHeartbeatConfig, getHeartbeatConfig, disableHeartbeat, } from "../..
 import { getWorkspace, invalidateWorkspaceCache, buildSystemPrompt, extractName, } from "../utils/index.js";
 import { ensureDefaultCronJobs } from "../../cron/scheduler.js";
 export function registerCommands(bot) {
+    // /help 명령어 - 전체 기능 안내
+    bot.command("help", async (ctx) => {
+        await ctx.reply(`📖 도움말\n\n` +
+            `🎯 기본 기능\n` +
+            `/model - AI 모델 변경 (sonnet/opus/haiku)\n` +
+            `/compact - 대화 압축해서 토큰 절약\n` +
+            `/clear - 대화 초기화\n\n` +
+            `📌 기억/핀\n` +
+            `/memory - 최근 기억 보기\n` +
+            `/pin [내용] - 중요한 정보 핀하기\n` +
+            `/pins - 핀 목록 보기\n` +
+            `/context - 현재 맥락 상태\n\n` +
+            `⏰ 알림/일정\n` +
+            `/reminders - 알림 목록\n` +
+            `/briefing - 일일 브리핑 켜기/상태\n` +
+            `/calendar - 오늘 일정 보기\n\n` +
+            `⚙️ 설정\n` +
+            `/setup - 기능별 설정 관리\n` +
+            `/health - 봇 상태 확인\n` +
+            `/reset - 페르소나 초기화\n\n` +
+            `💡 자연어로도 말할 수 있어요:\n` +
+            `• "opus로 바꿔줘"\n` +
+            `• "10분 뒤에 알려줘"\n` +
+            `• "기억해: 나는 채식주의자야"\n` +
+            `• "내일 일정 뭐야?"`);
+    });
     // /start 명령어
     bot.command("start", async (ctx) => {
         const chatId = ctx.chat.id;
@@ -210,19 +236,19 @@ export function registerCommands(bot) {
             const modelList = Object.entries(MODELS)
                 .map(([id, m]) => `${id === currentModel ? "→" : "  "} /model ${id} - ${m.name}`)
                 .join("\n");
-            await ctx.reply(`Current model: ${MODELS[currentModel].name}\n\n` +
-                `Available models:\n${modelList}\n\n` +
-                `Tip: You can also ask me to change models in natural language!`);
+            await ctx.reply(`현재 모델: ${MODELS[currentModel].name}\n\n` +
+                `사용 가능한 모델:\n${modelList}\n\n` +
+                `팁: "모델 바꿔줘"처럼 자연어로도 바꿀 수 있어!`);
             return;
         }
         if (arg in MODELS) {
             const modelId = arg;
             setModel(chatId, modelId);
-            await ctx.reply(`Model changed to: ${MODELS[modelId].name}`);
+            await ctx.reply(`모델 변경됨: ${MODELS[modelId].name}`);
         }
         else {
-            await ctx.reply(`Unknown model: ${arg}\n\n` +
-                `Available: sonnet, opus, haiku`);
+            await ctx.reply(`모르는 모델이야: ${arg}\n\n` +
+                `사용 가능: sonnet, opus, haiku`);
         }
     });
     // /setup 명령어 - 추가 기능 설정 및 관리