JetQiao/football-prediction-skill

竞彩足球智能预测

결정론적 스크립트를 사용하여 데이터 정규화, 확률 모델, 가치 계산, 백테스트 및 HTML 렌더링을 수행합니다. 에이전트는 출처가 있는 비정형 정보만 처리합니다. 항상 자체 포함된 HTML을 생성하며, 응답에 전체 경기 일정표를 붙여넣지 않습니다.

워크플로우 선택

• 사용자가 특정 날짜의 모든 경기를 분석하려는 경우: "전체 일일 워크플로우"를 실행합니다.
• 사용자가 빠른 베이스라인만 원하거나 인터넷 검색 능력이 없는 경우: daily를 직접 실행하고 시장/정보 저하를 명확히 합니다.
• 사용자가 과거 CSV를 제공하는 경우: backtest를 실행합니다.
• 사용자가 조별 순위 또는 토너먼트에 대해 묻는 경우: 토너먼트 시뮬레이션을 읽은 후 tournament를 실행합니다.
• 사용자가 경기 하나만 제공하고 그 경기가 복권 목록에 없는 경우: 데이터 계약에 따라 입력 JSON을 구성한 후 daily --input을 실행합니다.

명령어 진입점

설치된 명령어를 우선 사용합니다:

football-predict doctor

명령어가 존재하지 않는 경우, 오픈 소스 저장소 진입점을 사용합니다:

npx -y github:JetQiao/football-prediction-skill doctor

이하에서는 football-predict를 사용 가능한 진입점으로 표시합니다. 동일한 진입점으로 전체 작업을 완료합니다.

전체 일일 워크플로우

1. 복권 판매 날짜를 확인합니다. 지정되지 않은 경우 사용자 로컬의 오늘 날짜를 사용하며, 경기 시작 자연일과 판매일을 혼동하지 않습니다.
2. 임시 작업 디렉토리를 생성하고 경기 일정을 가져옵니다:

football-predict prepare --date YYYY-MM-DD --out /tmp/football-predict-YYYY-MM-DD

3. matches_*.json과 intel_queue_*.json을 읽습니다. 모든 B등급 경기에 대해 모델 베이스라인을 유지합니다. 대기열에 있는 A등급 경기에 대해서만 심층 인터넷 검색을 수행합니다.
4. 정보 처리流程에 따라 검색하고 intel.json에 씁니다. 경기 시작 후의 기사, 경기 결과 또는 마감 후에만 볼 수 있는 데이터는 사용을 금지합니다.
5. 정보를 검증합니다:

football-predict validate-intel /tmp/football-predict-YYYY-MM-DD/intel.json

6. 최종 결과물을 생성합니다:

football-predict daily \
  --date YYYY-MM-DD \
  --input /tmp/football-predict-YYYY-MM-DD/matches_YYYY-MM-DD.json \
  --intel /tmp/football-predict-YYYY-MM-DD/intel.json

7. 응답에는 HTML 절대 경로, 경기 수, 높은 신뢰도 수, 가치 신호 수 및 주요 저하 경고만 제공합니다. 확률이 약속이 아님을 상기시키고, "확실한 수익" 표현을 사용하지 않습니다.

시장 및 특성 강화

--features features.json을 사용하여 경기 전 Elo/xG를 주입하고, --market market.json을 사용하여 동일 예측 시점의 예리한/시장 배당률을 주입합니다. 데이터 소스 및 저하를 읽어 출처 우선순위를 확인합니다.

역사 마감 배당률을 더 이른 시점의 예측에 절대 주입하지 않습니다. 실시간 시장이 없는 경우 저하를 허용하지만, 보고서에 경고를 반드시 남겨야 합니다.

백테스트

football-data.co.uk에서 사용자가 권한 있는 리그 CSV를 가져와 로컬에서 실행합니다:

football-predict backtest history.csv --min-train 120 --window 600

Brier, log-loss를 복권 SP 베이스라인과 비교합니다. 샘플 크기, ROI 및 최대 손실폭을 동시에 보고합니다. 성과가 좋은 리그나 기간만 선택하지 않습니다.

출력 규칙

• prediction_*.json, report_*.html, manifest_*.json을 보존합니다.
• HTML을 주요 전달물로 사용합니다. 오프라인에서 열 수 있어야 하며 네트워크 요청을 보내지 않아야 합니다.
• 출처, 생성 시간, 실행 ID, 누락된 정보 및 저하 이유를 보존합니다.
• 베팅을 실행하지 않고, 고객 대신 운영하지 않으며, 수익을 약속하지 않습니다. 합리적인 구매와 미성년자 구매 금지를 명확히 표시합니다.