ScottZt/jin-ce-zhi-suan

【金策智算】➡️不靠情绪买卖、不追小道消息，专注用客观数据辅助决策。我们仅提供本地化私有行情数据服务与历史回测工具，帮你把主观想法变成可验证的交易规则，用历史数据检验方法有效性，通过指标监控约束随意操作、控制回撤风险，让交易更有纪律、更落地。本产品为纯量化工具，不荐股、不指导买卖、不预测行情、不承诺收益，所有决策由用户自主判断，只为你提供客观的数据支撑与AI辅助。作者【硅基流码】

📈 금책지산 – 지능형 투자 연구 의사결정 시스템

Python 기반의 정량적 거래 플랫폼으로, 전반적인 워크플로우(전략 생성 → 리스크 체크 → 실행)를 당나라 관료제를 영감으로 한 "삼성육부" 모델에 기반하여 구조화합니다. 웹 대시보드(FastAPI + HTML)를 통해 백테스트, 전략 관리, 특히 AI 기반 자연어 주식 스크리닝 기능을 제공하며, 중국어 설명을 실행 가능한 필터 규칙으로 자동 변환합니다.

🎯 프로젝트의 기능

기능	제공되는 기능
백테스트 엔진	과거 데이터 수신, 신호 실행, 성과 보고서, 일관성 검사.
다중 전략 관리	내장 전략에 더해 사용자 정의 전략을 위한 플러그인 포인트 제공; 배치, 포트폴리오, "BLK/TDX" 공식 수입 지원.
리스크 우선 워크플로우	정지손실, 하락률, 포지션 제한 등 기준에 따라 거래를 거부할 수 있는 "감시성".
AI 조건 스크리닝	"5일 내에 상한가, 상한가 후 거래량이 절반 이하, RSI는 과매도 구간" 과 같은 중국어 규칙을 작성; 시스템이 대규모 모델 API를 호출하고 의도를 해석하여 구조화된 필터 + 실행 규칙을 자동 생성.
설정 가능한 데이터 소스	AkShare, Tushare, 일반 REST API, MySQL 또는 PostgreSQL 백엔드.
웹 UI	FastAPI 서버(`server.py`)가 `dashboard.html`을 제공하며, 전략 선택, 파라미터 설정, 단일 티켓 백테스트 실행 또는 전체 규모의 "전략 진화 보드" 실행 가능.
전략 진화 보드	전략 생성, 평가, 반복 개선(README에서는 Evolution이라 함); 자동 최적화에 유용.

🏗️ 아키텍처 개요

삼성(의사결정 체인)
1. 태자원(Crown Prince) – 데이터 검증 및 배포.
2. 중서성(Zhongshu Sheng) – 전략 신호 생성.
3. 문하성(Menxia Sheng) – 리스크 검토; 거래 거부 가능.
4. 상서성(Shangshu Sheng) – 실행 및 정산.
육부(기능 모듈)
- 이부 – 전략 등록 및 라이프사이클.
- 호부 – 현금, 비용, NAV 회계.
- 예부 – 성과 보고서 및 순위.
- 병부 – 주문 매칭 및 거래 관리.
- 형부 – 위반 기록 및 리스크 이벤트.
- 공부 – 시장 데이터 정제 및 지표 계산.

코드 구조

src/
  core/            # 성 오케스트레이션
  ministries/      # 부 구현
  strategies/      # 내장 및 사용자 전략
  strategy_intent/ # AI 의도 해석
  utils/           # 설정, 데이터 어댑터, 지표
dashboard.html    # UI
server.py          # FastAPI 진입점
main.py, run_*.py  # 백테스트/실시간 모니터링용 CLI 헬퍼

🚀 빠른 시작 (5분 가이드)

설치 – pip install -r requirements.txt (Python 3.8+).
개인 설정 추가 – config.private.json 생성 후 Tushare/LLM API 키 입력 (README 예시 참조).
서버 실행 – python server.py (필요 시 누락된 종속성 자동 설치).
대시보드 열기 (보통 http://127.0.0.1:8000).
전략 선택, 주식 코드, 일자 범위, 초기 자금 입력 후 단표회측 클릭하여 첫 번째 결과 확인.
배치 실행, BLK/TDX 수입, 전략 진화의 경우 UI의 작업장 링크 사용.

🤖 AI-조건-스크리닝 워크플로우

중국어로 자연어 주식 선택 아이디어 입력.
플랫폼이 설정된 LLM(llm_api_key 개인 설정에 있음) 호출.
모델이 필터 조건과 거래 실행 규칙을 분리한 JSON 형식 구조를 반환.
필터는 선택된 데이터 소스에서 실행되어 후보 유니버스 생성; 백테스트 엔진이 실행 규칙을 사용해 거래 시뮬레이션.

📜 라이선스 및 상업적 이용 조건

개인, 학술, 로컬 사용(비상업) 은 무료 – 코드 학습, 백테스트 실행, 수정 가능.
상업적 이용은 저자(이메일: zthx410@163.com)로부터 서면 라이선스 필요. SaaS 제공, 소프트웨어 판매, 수익 창출 목적의 배포 포함.
리포지토리에는 도구가 투자 조언이 아니며, 사용자가 모든 거래 리스크를 부담해야 한다는 완전한 면책 조항 포함.

🙋‍♀️ 기여 방법

Fork → branch → PR.
핵심 스크립트 실행 가능 유지.
PR 설명에 테스트 단계 문서화.

📌 요약

금책지산은 대규모 언어 모델로 구동되는 자연어에서 전략으로의 파이프라인을 갖춘 비교적 완성도 높은 오픈소스 정량 연구 플랫폼입니다. Python 개발자나 정량 투자 애호가가 전략 아이디어, 리스크 제어, AI 지원 주식 스크리닝을 실험할 수 있는 즉시 사용 가능한 프레임워크를 제공하며, 하위 코드에 깊이 들어가도 됩니다.