discover · compare · collections · requirements · contribute · feed · watching · stats · help with your tokens

timercrack/trader · source

Snapshot 0 · 2026-11-04T12:47:24Z · C · Apache-2.0

GitHub description at capture

期货自动交易

README at capture

# trader

`trader` 是一个以 **CTP 原生链路** 为核心的交易项目，包含：

- 原生网关（`native/ctp_bridge` + `ctp_native`）
- 策略执行（`strategy`）
- Django 管理与可视化（`dashboard` + `panel`）

## 架构概览

### 核心模块

- `runtime_config.py`：运行时配置入口（仅读取根目录 `config.yaml`）
- `ctp_native/`：Python 侧网关与本地消息总线
- `native/ctp_bridge/`：pybind11 C++ 扩展，连接 Thost API
- `strategy/`：交易策略与查询/报单流程
- `dashboard/` + `panel/`：Django 后台与页面展示

### 运行链路（简化）

1. 读取 `config.yaml`
2. 初始化 `ctp_bridge_native` 并登录 CTP
3. `ctp_native` 在本地总线上分发请求/回报
4. `strategy` 消费事件并执行策略逻辑

## 快速开始

### 1) 环境准备

- Python 3.14（项目当前使用版本）
- 安装依赖：`requirements.txt`
- Windows 如使用 CTP 原生扩展：需可用 MSVC + CMake

### 2) 配置

编辑项目根目录 `config.yaml`，重点检查 `ctp_native` 章节：

- `gateway = pybind`
- `module = ctp_bridge_native`
- `module_path` 指向本地编译输出目录
- 补齐登录参数（`broker_id`、`investor_id`、`password`、`appid`、`authcode` 等）

企业微信日志推送配置在 `weixin` 章节：

- `CorpID`
- `Secret`
- `Token`、`EncodingAESKey`（保留与 flower 配置结构对齐）

发送策略默认沿用旧 flower 行为：`agentid=0`、`touser=@all`。

配置后，`trader` 会直接推送日志到企业微信，不再依赖单独运行 `flower`。

默认配置键结构（示例值）如下，和当前代码中的默认配置字典保持一致：

```yaml
trade:
  command_timeout: 5
  ignore_inst: ""
  transport: native

ctp_native:
  gateway: pybind
  module: ctp_bridge_native
  client_class: CtpClient
  module_path: /path/to/trader/native/ctp_bridge/build
  dll_dir: /path/to/trader/native/ctp_bridge/api/win
  trade_front: tcp://xxx:xxx
  market_front: tcp://xxx:xxx
  broker_id: "9999"
  investor_id: "123456"
  password: passwd
  appid: xxx
  authcode: xxx
  userinfo: xxx
  flow_path: /path/to/trader/native/ctp_bridge/flow
  request_timeout_ms: 10000
  test_instrument: IF99

log:
  level: DEBUG
  format: "%(asctime)s %(name)s [%(levelname)s] %(message)s"
  weixin_level: INFO
  weixin_format: "[%(levelname)s] %(message)s"

host:
  ip: 1.2.3.4
  mac: 02:03:04:5a:6b:7c

ssh_tunnel:
  enabled: false
  host: 127.0.0.1
  port: 22
  local_node: localhost
  private_key_linux: /root/.ssh/id_ed25519
  private_key_win: C:\\Users\\timer\\.ssh\\id_ed25519.ppk

weixin:
  Token: ""
  EncodingAESKey: ""
  CorpID: ""
  Secret: ""
```

### 3) 常用命令

- 启动交易主程序：`python main.py`
- Django 检查：`python manage.py check`
- Native 查询烟测：`python test/test_ctp.py`

### 4) 原生扩展构建（可选）

若需要本地编译 `ctp_bridge_native`：

- Windows（MSVC）：

```powershell
cd native/ctp_bridge
cmake -S . -B build -G "Visual Studio 17 2022" -A x64
cmake --build build --config Release
```

- Linux：

```bash
cd native/ctp_bridge
cmake -S . -B build -DCMAKE_BUILD_TYPE=Release
cmake --build build -j
```

详细说明见：`native/ctp_bridge/README.md`

## 目录说明

- `native/ctp_bridge`：C++ 扩展源码与 CMake
- `ctp_native`：Python 网关封装
- `strategy`：策略实现
- `dashboard`、`panel`、`templates`、`static`：Web 展示与后台