ScottZt/jin-ce-zhi-suan

📈 金策智算 – 智能投研決策系統

一個基於 Python 的定量交易平台，將整個工作流程（策略生成 → 風險檢查 → 執行）圍繞受唐代官僚制度啟發的 「三省六部」 模型進行結構化。提供 Web 仪表板（FastAPI + HTML），支援回測、策略管理，特別具備 AI 驅動的自然語言股票篩選功能，可將中文描述自動轉換為可執行的過濾規則。

---

🎯 項目功能

功能	你將獲得
回測引擎	歷史資料攝入、訊號執行、績效報告、一致性檢查。
多策略管理	內建策略外加使用者自訂策略的插件點；支援批量、組合及「BLK/TDX」公式匯入。
風險優先工作流程	「守門省」可基於停損、回撤、部位限制等條件否決交易。
AI 條件篩選	輸入中文規則如 「五日內有漲停，漲停後縮量至一半以下，RSI 處於超賣區間」；系統調用大模型 API，解析意圖，自動建立結構化過濾器 + 執行規則。
可設定資料來源	AkShare、Tushare、通用 REST API、MySQL 或 PostgreSQL 後端。
Web 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分鐘指南）

1. 安裝 – pip install -r requirements.txt（Python 3.8+）。
2. 新增私有設定 – 建立 config.private.json，填入你的 Tushare/LLM API 金鑰（參見 README 範例）。
3. 執行伺服器 – python server.py（如需，腳本會自動安裝缺少的相依性）。
4. 開啟儀表板（通常為 http://127.0.0.1:8000）。
5. 選擇策略，填入 股票代碼、日期範圍 和 初始資金，點選 單票回測 查看首個結果。
6. 如需批量執行、BLK/TDX 匯入或策略進化，請使用 UI 中的 操作工作台 連結。

---

🤖 AI 條件篩選工作流程

1. 用中文輸入自然語言股票選股想法。
2. 平台調用配置的 LLM（llm_api_key 在私有設定中）。
3. 模型返回 JSON 格式結構，分離 過濾條件 與 交易執行規則。
4. 過濾器在選定資料來源上執行，生成候選池；回測引擎使用執行規則模擬交易。

---

📜 許可證與商業條款

• 個人、學術或本地使用（非商業）免費 – 可學習程式碼、執行回測、修改。
• 商業使用需作者書面授權（信箱：zthx410@163.com）。包括 SaaS 服務、軟體販售或任何盈利性部署。
• 倉儲包含完整免責聲明：本工具 非投資建議，使用者承擔全部交易風險。

---

🙋‍♀️ 貢獻方式

• Fork → 分支 → PR。
• 保持核心腳本可執行。
• 在 PR 描述中記錄測試步驟。

---

📌 總結

金策智算 是一個較為完整的開源定量研究平台，融合傳統回測與由大語言模型驅動的自然語言轉策略管道。適合 Python 開發者或量化愛好者，可快速實驗策略構思、風險控制與 AI 輔助選股，同時仍可深入底層程式碼。