Discord 및 Telegram용 NinjaTrader Bot 설정 및 사용

NinjaTrader Bot의 기능

NinjaTrader Bot은 Discord 또는 Telegram을 통해 NinjaTrader 워크플로를 지원하도록 설계된 커뮤니티 기반 독립형 Windows 애플리케이션입니다. 상태 확인, 구성 관리, 로그 확인, 환경설정 전환, 문제 진단, 백업 관리에 사용할 수 있는 채팅 명령을 제공합니다.

이 패키지는 별도의 종속성 체인이나 백그라운드 서비스 없이 작동하도록 설계되었습니다. 전략 모듈, 자동화 훅, 알림, 거래 기록 및 기타 기능이 사전 구성되어 있으며, 읽기 쉬운 설정을 통해 거래 상품, 일정, 위험 규칙에 맞게 봇을 조정할 수 있습니다.

자동 거래에는 재정적 위험이 따릅니다. 모든 설정을 검토하고, 먼저 모의 거래 모드를 사용하며, 실제 환경에서 자동 신호 실행을 활성화하기 전에 위험 한도를 확인하세요.

주요 기능

• 독립형 데스크톱 빌드: 자체 포함된 Windows x64 패키지에 필요한 구성 요소가 포함되어 있으며, 용량은 약 1.6 GB로 안내되어 있습니다.
• 사전 구성된 기능: README에 별도의 활성화 또는 라이선스 절차가 설명되어 있지 않으며, 기능이 기본적으로 활성화되고 구성되어 있습니다.
• 계층형 구성: 전역 기본값, 사용자 프로필, 임시 세션 재정의를 사용해 일반적인 사용자 지정을 배포된 설정과 분리합니다.
• 독립적인 기능 토글: 전략 엔진, 알림 릴레이, 거래 기록, 모의 거래 모드를 개별적으로 제어할 수 있습니다.
• 검증: 거래가 시작되기 전에 시작 시 검사를 통해 구문 오류, 의심스러운 숫자 범위, 충돌하는 종속성을 식별합니다.
• 핫 리로드: 활성 프로필을 저장한 후 다시 불러올 수 있으며, /reload를 사용하면 구성을 명시적으로 다시 읽을 수 있습니다.
• 유지 관리 도구: 상태 정보, 최근 로그, 진단 결과, 버전, 백업 및 복원 옵션을 명령으로 확인할 수 있습니다.
• 이식 가능한 프로필: 이름이 지정된 프로필을 백업하고 공유하여 다양한 전략이나 세션에 사용할 수 있습니다.

요구 사항 및 준비

봇을 설치하기 전에 컴퓨터가 문서화된 요구 사항을 충족하는지 확인하세요.

• x64 데스크톱 환경의 Windows 10 또는 Windows 11
• PowerShell 5.1 이상. 프로젝트에서는 PowerShell 7+도 권장합니다.
• 설치 스크립트와 패키지를 다운로드할 인터넷 연결
• 일반 Windows 사용자 계정
• 해당 채팅 환경을 통해 봇을 운영하려는 경우 Discord 또는 Telegram 액세스

README에 따르면 핵심 패키지는 설치 후 로컬 및 오프라인으로 실행할 수 있지만, 다운로드, 업데이트, 커뮤니티 지원에는 네트워크 연결이 필요할 수 있습니다. Discord 또는 Telegram 자격 증명 생성 절차는 자세히 설명되어 있지 않으므로, 플랫폼별 연결 단계는 프로젝트의 최신 도움말과 릴리스 자료를 확인하세요.

봇 설치

이 저장소는 설치 프로그램 페이지를 통해 PowerShell 설치 프로그램을 제공합니다. README에는 실제 PowerShell 명령, 패키지 체크섬 또는 상세한 설치 기록이 없으므로 관련 없는 출처의 명령을 복사하지 마세요.

1. 저장소를 열고 현재 파일, 이슈, 릴리스 정보 및 설치 프로그램의 위치를 검토합니다.
2. 설치 프로그램의 출처가 프로젝트에서 연결한 곳인지 확인합니다. 다운로드한 PowerShell 스크립트는 실행하기 전에 검사합니다.
3. Windows 10 또는 Windows 11 컴퓨터에서 문서화된 PowerShell 설치 프로그램을 사용합니다.
4. 압축이 풀린 독립형 빌드를 별도 폴더에 보관합니다. 여러 컴퓨터에 설치하는 경우 구성 충돌을 방지하기 위해 각 복사본에 별도 폴더를 사용합니다.
5. 일반 사용자로 실행 파일을 시작합니다. 봇은 처음 실행할 때 실행 파일 옆에 초기 구성 파일을 생성해야 합니다.
6. 계속하기 전에 모든 검증 메시지를 읽습니다. 보고된 구문, 범위 또는 종속성 문제를 우회하지 말고 수정합니다.

실행 파일 설치 프로그램과 거래 소프트웨어는 보안에 민감하므로, 보안 도구로 다운로드 파일을 검사하고 실행 전에 스크립트를 확인하며, 먼저 격리된 환경이나 비프로덕션 환경에서 애플리케이션을 테스트하세요.

첫 실행 구성

생성된 구성을 일반 텍스트 편집기로 엽니다. 초기 파일에는 주석 처리된 섹션과 보수적인 기본값이 포함되어 있습니다. 구성을 실제 워크플로에 연결하기 전에 네 가지 영역을 확인하세요.

1. 설정 식별

계정 및 세션 메모에 알아보기 쉬운 레이블을 설정합니다. 여러 프로필이나 설치를 관리할 때 특히 유용합니다.

2. 관심 목록 정의

모니터링하거나 거래하려는 상품 기호만 추가합니다. README에 따르면 관심 목록에서 제외된 상품은 변경되지 않습니다.

3. 주문 기본값 검토

기본 수량, 주문 유형, 주문 유효 기간을 확인합니다. 배포된 값이 계정, 상품 또는 전략에 적합하다고 가정하지 마세요.

4. 위험 통제 기준 설정

일일 손실 한도, 최대 미결 포지션 수, 거래별 한도를 검토합니다. 이러한 보호 장치는 명시적으로 변경하지 않는 한 활성 상태로 유지됩니다.

README에는 구성 파일의 정확한 구문이나 키 이름이 공개되어 있지 않습니다. 새 키를 임의로 만들지 말고 생성된 파일의 기존 형식과 주석을 유지하세요. 편집 내용을 저장한 다음 프로필 감시자가 적용하도록 하거나 /reload를 실행합니다. 초기 설정에서는 봇을 다시 시작해도 시작 시 검증이 수행됩니다.

구성 우선순위 이해

봇은 세 개의 계층으로 설정을 확인합니다. 나중 계층이 이전 계층을 재정의합니다:

1. 전역 기본값: 빌드와 함께 제공되는 안정적인 설정입니다.
2. 사용자 프로필: 백업하거나 이동할 수 있는 영구적인 개인 설정입니다.
3. 세션 재정의: 한 번의 실행 동안 실험에 사용하는 임시 값입니다.

예를 들어 보수적인 전역 기본값을 유지하고, 평소 사용하는 관심 목록과 한도는 사용자 프로필에 저장하며, 임시 모의 거래 테스트에는 세션 재정의를 사용하세요. 이렇게 하면 짧은 실험이 장기 프로필을 덮어쓰는 것을 방지할 수 있습니다.

페이퍼 모드로 시작하기

실시간 자동화를 고려하기 전에 페이퍼 모드를 활성화하고 모의 체결을 대상으로 전체 워크플로를 테스트하세요. 프로필이 검증을 통과하고 봇의 동작을 검토할 때까지 전략 엔진은 비활성화된 상태로 유지하세요.

1. 생성된 구성에 이미 있는 토글을 사용하여 페이퍼 모드를 활성화합니다.
2. 실시간 거래 플래그가 비활성화되어 있는지 확인합니다. 봇은 충돌하는 페이퍼 거래 설정과 실시간 거래 설정을 거부해야 합니다.
3. 검토를 위해 작업이 로컬에 기록되도록 거래 기록을 활성화합니다.
4. 주요 이벤트를 선택한 채팅 화면으로 전송하려면 알림 릴레이를 구성합니다.
5. 프로필을 저장하고 /reload를 실행합니다.
6. /diagnose, /status, /features를 사용하여 결과 상태를 확인합니다.

핵심 명령 사용하기

명령은 슬래시 명령 형식을 따릅니다. 다음 기본 순서로 시작하세요.

/start
/status
/features
/config
/diagnose
/ping
/help

• /start는 현재 프로필, 활성 모듈, 소개 둘러보기가 포함된 환영 카드를 표시합니다.
• /status는 연결 상태, 가동 시간, 로드된 기능, 독립 실행형 빌드 버전을 보고합니다.
• /features는 현재 빌드에서 활성화된 기능을 그룹으로 묶어 나열합니다.
• /config는 로드된 구성을 요약합니다. 이 명령은 키 이름을 인수로 받을 수도 있지만, README에는 정확한 인수 구문이 지정되어 있지 않습니다.
• /diagnose는 봇의 하위 시스템을 점검하고 알기 쉬운 보고서를 반환합니다.
• /ping은 간단한 왕복 연결 상태 점검을 수행합니다.
• /help는 설치된 빌드의 명령 목록을 생성합니다. 명령 이름을 전달하면 자세한 사용법과 사용 가능한 옵션이 표시됩니다.

지원되는 인수는 릴리스마다 변경될 수 있으므로 옵션 이름을 추측하지 말고 /help를 사용하세요. 봇은 원시 데이터 덤프 대신 누락된 권한을 설명하고 읽기 쉬운 메시지를 반환하도록 설계되었습니다.

구성 변경 적용 및 확인하기

프로필을 편집한 후 다음 워크플로를 사용하세요.

/reload
/config
/status
/logs
/diagnose

/reload는 전체 재시작 없이 구성을 다시 읽고 변경된 내용을 보고합니다. /config는 모든 계층이 적용된 후의 유효 설정을 확인합니다. 이어서 /status와 /diagnose를 실행하여 상태를 확인한 다음 /logs에서 최근 활동을 살펴보세요.

로그 명령은 개수 옵션과 경고 또는 오류에 대한 심각도 필터를 지원하지만, README에는 해당 옵션의 실제 구문이 제공되지 않습니다. 설치된 빌드에서 /help logs를 실행하여 유효한 예시를 확인하세요.

프로필 및 알림 관리하기

/profile을 사용하여 표시 이름, 기본 일정, 알림 스타일과 같은 개인 환경설정을 확인하거나 조정하세요. 변경 사항은 즉시 적용되며 세션 간에도 유지됩니다. 이름이 지정된 프로필은 서로 다른 날에 다른 전략을 실행할 때 유용합니다.

커뮤니티 공지는 선택 사항입니다.

/subscribe
/unsubscribe

/subscribe는 프로젝트 업데이트 및 릴리스 노트 알림을 활성화하고, /unsubscribe는 이를 비활성화합니다.

안전하게 백업 및 복원하기

봇은 구조적 변경 전에 이전 구성을 자동으로 스냅샷으로 저장합니다. 스냅샷을 직접 관리할 수도 있습니다.

/backup
/restore

/backup은 타임스탬프가 포함된 구성 스냅샷을 만들고 저장 위치를 보고합니다. /restore는 사용 가능한 백업을 나열한 후 하나를 선택하도록 요청합니다. 위험 규칙을 변경하거나 자동화를 활성화하거나 다른 사용자에게 받은 프로필로 교체하기 전에 수동 백업을 만드세요.

고급 팁

실험에는 재정의 사용하기

사용자 프로필을 수정하지 말고 세션 계층에 임시 테스트를 저장하세요. 세션이 종료되면 영구 구성은 그대로 유지됩니다.

설치 환경 분리하기

여러 컴퓨터에 이식 가능한 빌드를 배포하거나 한 시스템에 여러 복사본을 유지할 때는 각 복사본을 별도의 폴더에 저장하세요. 이렇게 하면 인접한 구성 파일이 실수로 공유되거나 덮어써지는 것을 방지할 수 있습니다.

공유 프로필 검증하기

프로필은 자체적으로 완결되어 이식 가능한 것으로 설명되어 있지만, 가져온 모든 관심 목록, 주문 기본값, 기능 토글, 위험 한도를 계속 확인해야 합니다. 커뮤니티 프로필을 사용하기 전에 페이퍼 모드에서 검증을 실행하세요.

설치된 버전 확인하기

/version을 실행하여 정확한 빌드 식별자, 릴리스 채널, 검증 날짜를 표시합니다. 문제를 보고할 때 이 정보를 포함하면 다른 사용자가 동일한 빌드를 비교할 수 있습니다.

유용한 문제 해결 자료 수집하기

봇이 예상대로 작동하지 않으면 다음 순서로 정보를 수집하세요.

/status
/diagnose
/logs
/version

전체 오류 메시지와 관련 로그 발췌 내용을 보존하세요. 중복 보고서를 작성하기 전에 기존 프로젝트 논의를 검색하고, 로그를 공개적으로 공유하기 전에 계정 정보나 기타 민감한 정보를 삭제하세요.

피드백 및 커뮤니티 지원 활용하기

/feedback 명령은 버그, 아이디어 또는 일반적인 의견을 관리자에게 전송합니다. README에서는 프로젝트의 Discord 또는 Telegram 커뮤니티를 통해 이슈, 풀 리퀘스트, 문서 개선 제안, 테스트 의견 및 토론을 제출하는 것도 권장합니다.

명령어 참조

• /start — 환영 카드와 초기 둘러보기를 엽니다.
• /status — 상태, 연결, 가동 시간, 기능 및 빌드 정보를 확인합니다.
• /features — 카테고리별 활성화된 기능을 나열합니다.
• /config — 모든 유효 설정을 보거나 특정 설정을 확인합니다.
• /reload — 디스크에서 설정을 다시 불러옵니다.
• /profile — 개인 환경설정 및 프로필 관련 설정을 관리합니다.
• /subscribe — 커뮤니티 업데이트 및 릴리스 노트를 받습니다.
• /unsubscribe — 커뮤니티 업데이트 알림을 중지합니다.
• /logs — 선택적인 개수 및 심각도 설정과 함께 최근 활동을 가져옵니다.
• /diagnose — 하위 시스템 검사를 실행합니다.
• /backup — 타임스탬프가 포함된 설정 스냅샷을 생성합니다.
• /restore — 사용 가능한 스냅샷을 선택하고 복원합니다.
• /version — 빌드 식별자, 채널 및 확인 날짜를 표시합니다.
• /ping — 왕복 통신을 테스트합니다.
• /feedback — 관리자에게 의견을 보냅니다.
• /help — 현재 명령어 문서와 옵션을 표시합니다.

결론

NinjaTrader Bot은 독립 실행형 Windows 패키지에 채팅 기반 관리, 계층형 프로필, 설정 검증, 진단 및 백업 도구를 결합합니다. 검증된 출처에서만 설치하고, 보수적인 설정과 모의 거래 모드로 시작하며, 설치된 빌드에 대한 권위 있는 참조로 /help를 사용하세요. 자동화를 활성화하거나 변경하기 전에 모든 중요한 프로필을 백업하세요.