三国量化交易平台（sanguo_vnpy）

基于vn.py开源框架构建的量化交易全流程平台

项目定位

从0构建一个量化交易系统工作量巨大，因此我们选择基于vnpy框架进行适配，构建覆盖投研→策略开发→模拟回测→实盘交易的全流程平台。

核心原则：尽量使用原生vnpy框架模块，不仿写不重写，只做适配和扩展。

文档导航

文档	说明
docs/01-requirements.md	需求定义
docs/02-architecture.md	系统架构设计
docs/03-detailed-design.md	详细设计
docs/04-deployment.md	部署指南
docs/05-user-manual.md	用户手册

目录结构

sanguo_vnpy/
├── docs/                    # 📖 项目文档（需求/架构/设计/部署/手册）
├── src/                     # 🔥 平台核心代码
│   ├── backtest-service/    #   vnpy 4.x 自动化回测服务
│   ├── adapters/            #   vnpy适配层（数据适配器等）
│   └── scripts/             #   启动脚本
├── docker/                  # 🐳 Docker镜像构建
│   ├── Dockerfile
│   ├── entrypoint.sh
│   └── requirements/
├── config/                  # ⚙️ NAS多用户部署配置
│   ├── nginx/               #   7用户反向代理配置
│   └── systemd/             #   14个systemd服务文件
├── deploy/                  # 🚀 部署工具
│   └── nas/                 #   群晖NAS部署全流程
├── research/                # 📚 技术调研文档
│   ├── vnpy/                #   vnpy框架调研
│   ├── nas/                 #   NAS部署调研
│   ├── docker/              #   Docker相关调研
│   └── jq_essence_articles/ #   聚宽精华文章
├── data/                    # 💾 数据
└── archive/                 # 📦 历史归档

快速开始

详见 docs/04-deployment.md

技术栈

• 框架：vn.py 4.x（量化交易框架）
• 服务化：FastAPI + uvicorn（回测API服务）
• 容器化：Docker（群晖NAS部署）
• 数据：SQLite + akshare
• 适配层：继承vnpy BaseDatafeed/BaseGateway/CtaTemplate

相关项目

• sanguo_quant_live — 量化策略研究
• sanguo_mail — Agent间邮件通信系统

---

三国量化团队 · 姜维（平台总督）维护