claude_dev
de04a8904b
三策略(聚宽py2→BulletTrade 0.9.2,BrokerFacade注入跨版本兼容): - momentum_timing 动量择时(牛熊分界+行业RPS+均线,切回10中证行业指数) - value_selection 价值精选(6条基本面过滤,切回沪深300) - small_cap 小市值(去IC对冲,切回000985中证全指) 框架: - runner_backtest 加 --strategy 分发(原硬编码all_weather) - provider 加 get_value_metrics(价值精选6条基本面,NOTICE_DATE治前视偏差) - 72单测全过(21+27+24) 修8个回测实测发现的真bug: - 01第⑥条EPS绝对值0.08~0.5与①大盘矛盾→6条交集恒空致全程空仓,按注释本意改净利润同比8~50% - 03原帖calRPS取数区间错(get_price start=end只取1天)→涨跌幅恒0 RPS失效;date.today()取真实今天非回测日 - 02 universe 000985不在constituent_unified→候选池空 VPS实测(短区间验证逻辑,非长期表现): 01价值+23%/03行业轮动+48%/02选出20只小盘 数据缺口(详见docs/research/joinquant_strategies/SUMMARY.md + data_gaps_fix_plan.md): - 三表"1/3损坏"误报已撤回(全扫5530文件/表0损坏,沪深95%+健康,仅北交所920xxx空,不做北交所) - 真实缺口: 行业成份股(G1已补)/000985(G2已补)/IC期货(02对冲去掉)/provider批量接口(G5待做,解锁长回测)
Sanguo VeighNa 量化交易平台 v2.0
基于 VeighNa 4.4.0 的二次开发量化交易平台，支持 Web 界面和 Docker 容器化部署。
特性
- 🚀 基于 VeighNa 4.4.0 - 最新稳定版本
- 🌐 Web 界面 - FastAPI + WebSocket 实时数据推送
- 🐳 Docker 部署 - 支持 Synology NAS 等容器环境
- 📊 完整功能 - 行情订阅、交易下单、策略管理
- 🔐 安全认证 - JWT Token 认证机制
- 📡 实时推送 - WebSocket 行情、成交、持仓实时更新
项目结构
sanguo_vnpy_v2/
├── vnpy_v4.4.0/ # VeighNa 上游源码
├── sanguo_trader/ # 核心交易模块
├── sanguo_research/ # 量化投研模块
├── sanguo_data/ # 数据管理模块
├── sanguo_common/ # 公共模块
├── sanguo_web/ # Web 服务模块
│ ├── api/ # REST API
│ ├── websocket/ # WebSocket 服务
│ └── services/ # 业务服务
├── docker/ # Docker 配置
│ ├── Dockerfile # 镜像构建
│ ├── docker-compose.yml # 容器编排
│ ├── entrypoint.sh # 启动脚本
│ └── deploy-synology.sh # NAS 部署脚本
├── tests/ # 测试代码
├── docs/ # 文档
└── examples/ # 示例代码
快速开始
方式 1: Docker 部署（推荐）
本地开发
# 构建镜像
cd docker
docker-compose build
# 启动服务
docker-compose up -d
# 访问 Web 界面
open http://localhost:8000
Synology NAS 部署
- 开启 SSH 服务
- 上传部署包到 NAS
- 运行部署脚本：
cd /volume1/docker/containers/sanguo_vnpy_v2/docker
sudo bash deploy-synology.sh
详细说明请参考 Synology NAS 部署指南
方式 2: 本地开发
环境要求
- Python 3.10+
- 推荐 Python 3.13
安装步骤
# 创建虚拟环境
python -m venv venv
source venv/bin/activate # Linux/Mac
# venv\Scripts\activate # Windows
# 安装依赖
pip install -r requirements/base.txt
# 启动 Web 服务
python run_web.py
Web 服务启动
# 开发模式（端口 8002）
python run_web.py
# 生产模式
uvicorn sanguo_web.api:app --host 0.0.0.0 --port 8000 --workers 2
API 文档
启动服务后访问：
- Swagger UI:
http://localhost:8000/docs - ReDoc:
http://localhost:8000/redoc
认证
默认登录凭据：
- 用户名:
admin - 密码:
admin123
⚠️ 重要: 首次登录后请立即修改密码！
WebSocket 连接
// 连接 WebSocket
const ws = new WebSocket('ws://localhost:8080');
// 订阅行情
ws.send(JSON.stringify({
type: 'subscribe',
data: { subscription: ['tick', 'order', 'trade'] }
}));
// 接收消息
ws.onmessage = (event) => {
const message = JSON.parse(event.data);
console.log('Received:', message);
};
测试
# 运行 API 测试
pytest tests/test_api.py -v
# 运行 WebSocket 测试
python tests/test_websocket.py
# 运行所有测试
pytest tests/ -v
开发指南
详细开发指南请查看：
主要功能模块
1. 认证系统 (/api/v1/auth)
- 用户登录/登出
- Token 验证
- 用户信息获取
2. 网关管理 (/api/v1/gateway)
- 可用网关列表
- 网关连接/断开
- 网关配置管理
3. 行情数据 (/api/v1/market)
- 实时行情查询
- 行情订阅/取消订阅
- 合约信息查询
4. 交易功能 (/api/v1/trading)
- 账户信息查询
- 持仓查询
- 订单管理（下单、撤单）
- 成交记录查询
5. 策略管理 (/api/v1/strategy)
- 策略列表
- 策略启动/停止
- 策略参数配置
环境变量
主要环境变量（见 docker/.env.example）：
# 数据目录
DATA_DIR=/volume1/docker/stock/sanguo_vnpy
# 端口配置
HTTP_PORT=8000
WS_PORT=8080
# 时区
TZ=Asia/Shanghai
# JWT 密钥
JWT_SECRET_KEY=your-secret-key-here
# 数据库
DB_TYPE=sqlite
DB_PATH=/app/data/vnpy.db
分支策略
master- 主分支，保持稳定可部署develop- 开发分支，日常开发合并feature/*- 功能分支hotfix/*- 热修复分支
版本历史
查看 CHANGELOG.md
技术栈
- 后端框架: FastAPI 0.100+
- WebSocket: websockets 12.0+
- 数据库: SQLite (可扩展 PostgreSQL)
- 缓存: Redis 7+
- 容器: Docker + Docker Compose
- 认证: JWT (python-jose)
- 测试: pytest + httpx
许可证
MIT License
致谢
基于 VeighNa 框架开发
联系方式
- 问题反馈: GitHub Issues
- 文档:
docs/目录