sunny-kobe/ai_sentiney

Project Sentinel

A주 스마트 투자 어드바이저 시스템입니다. AkShare를 통해 실시간 시세를 수집하고 Gemini AI로 분석하여 거래 제안을 출력합니다.

사용 방법

중요: 반드시 cd로 프로젝트 디렉터리로 이동한 후 가상 환경을 활성화해야 합니다.

분석 보고서 생성

# 오후 분석(기본값), 터미널에 출력
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday

# 장 마감 리뷰
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode close

# 아침 보고서
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode morning

# 생성 후 Telegram으로 푸시
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target telegram

# Feishu와 Telegram 동시 푸시
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target feishu telegram

# JSON 형식 출력 (프로그램 소비용)
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --output json

후속 질문 분석

# 가장 최근 분석에 후속 질문
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "골드 ETF 오늘은 어떤가요"

# 특정 날짜에 후속 질문
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "반도체 섹터 상황은 어떤가요" --date 2026-02-07

# 장 마감 분석에 후속 질문
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "내일 어떻게 매매해야 하나요" --mode close

추세 분석

# 1주일 추세 (추세 키워드 자동 감지)
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "최근 일주일 시장 추세는 어떤가요"

# 한 달 추세
cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "이번 달 포지션 성과는 어떤가요"

사용 시나리오

⚠️ 핵심 라우팅 규칙 (반드시 준수) :

• 사용자가 명확하게 "분석 실행/보고서 생성/푸시"를 요청한 경우에만 --mode 명령어를 실행합니다.
• 그 외 모든 질문 (후속 질문, 평가, 정확도 문의, 잡담 등)은 --ask "사용자의 원래 질문"을 사용하여 Sentinel CLI로 전달합니다.
• CLI 출력을 대신하여 답변을 직접 지어내는 것을 금지합니다. 반드시 명령어를 실행하고 stdout을 그대로 사용자에게 반환해야 합니다.
• 어떤 명령어를 사용해야 할지 확실하지 않은 경우, 기본적으로 --ask를 사용합니다.

보고서 생성 (사용자가 명확하게 생성/실행/푸시를 요청한 경우에만)

사용자가 다음과 같이 말할 때:

• "오후 분석 해줘"
• "장 마감 리뷰 생성해"
• "아침 보고서 분석해"

실행: cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday

Telegram 푸시

사용자가 다음과 같이 말할 때:

• "분석을 Telegram으로 보내줘"
• "Telegram으로 푸시해"
• "오후 보고서 보내줘"

실행: cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target telegram

Feishu와 Telegram 동시 푸시

사용자가 다음과 같이 말할 때:

• "모든 채널로 푸시해"
• "Feishu와 Telegram 둘 다 보내"

실행: cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --mode midday --publish --publish-target feishu telegram

그 외 모든 질문 (후속 질문, 정확도, 평가, 잡담 등)

사용자가 "보고서 생성" 외의 말을 할 때, 예를 들면 다음과 같습니다:

• 종목 후속 질문: "골드 ETF 오늘은 어떤가요", "쯔진광업 살 수 있나요"
• 정확도 관련: "정확한가요", "정확도", "적중률", "믿을 만한가요", "신뢰도", "승률"
• 추세 관련: "최근 일주일 시장 흐름", "이번 달 포지션 추세"
• 기타 모든 질문

무조건 실행: cd /Users/lan/Desktop/code/ai_sentiney && source .venv/bin/activate && python -m src.main --ask "사용자의 원래 질문"

stdout 출력을 그대로 사용자에게 반환하고, 직접 가공하거나 내용을 지어내지 마십시오.

데이터 캐시

• SQLite 데이터베이스: data/sentinel.db
• JSON 스냅샷: data/latest_context.json
• 히스토리 재생 지원: --replay 파라미터