# VeighNa 上游源码参考

## 来源信息

- **项目**: VeighNa 量化交易平台
- **版本**: 4.4.0
- **克隆日期**: 2025-06-25
- **原始仓库**: https://github.com/vnpy/vnpy
- **原始分支/标签**: 4.4.0

## 用途说明

此目录是 VeighNa 4.4.0 的完整源码副本，用于：

1. **版本参考** - 明确二次开发基于的具体版本
2. **代码学习** - 参考上游实现方式
3. **差异对比** - 了解与原版的改动
4. **离线开发** - 无需访问 GitHub 也能查看源码

## 使用规范

### 修改规则

- ✅ **允许**: 添加注释说明我们对代码的理解
- ⚠️  **谨慎**: 修改代码以适配我们的需求
- ❌ **禁止**: 直接提交修改到上游仓库

### 目录结构

```
vnpy_v4.4.0/
├── vnpy/              # 核心框架代码
│   ├── trader/       # 交易模块
│   ├── alpha/        # AI量化模块（4.0新增）
│   ├── chart/        # 图表模块
│   ├── event/        # 事件引擎
│   └── rpc/          # RPC模块
├── examples/          # 官方示例
├── docs/             # 官方文档
└── tests/            # 官方测试
```

## 我们的主要开发区域

我们的二次开发代码在上级目录：

```
../sanguo_trader/      # 我们的交易模块扩展
../sanguo_research/    # 我们的量化研究模块
../sanguo_data/       # 我们的数据管理模块
../sanguo_common/      # 我们的公共模块
```

## 版本更新

如果需要更新上游版本：

```bash
# 备份当前版本
mv vnpy_v4.4.0 vnpy_v4.4.0.backup

# 克隆新版本
git clone --depth 1 --branch X.X.X https://github.com/vnpy/vnpy.git vnpy_vX.X.X

# 对比差异
diff -r vnpy_v4.4.0.backup vnpy_vX.X.X
```

## 许可证

VeighNa 使用 MIT License，详见 [LICENSE](LICENSE)