13a0e7d580
删除了多个不再使用的文档和代码文件，包括交易更新推送、条件订单推送、REST API 文档、WebSocket API 文档及相关的策略分析文档。这些文件的移除有助于清理代码库，确保项目的整洁性与可维护性。
72 lines
3.6 KiB
Markdown
72 lines
3.6 KiB
Markdown
# 缓存策略：全用 Redis，基本不占服务器内存
|
||
|
||
## 目标
|
||
|
||
- **全量缓存以 Redis/Valkey 为主**：有 Redis 时只读只写 Redis，进程内基本不保留缓存，减轻服务器内存压力。
|
||
- **Redis 内容全部带过期时间**：所有写入 Redis 的键均设置 TTL，不在 Redis 内无限增长。
|
||
|
||
## 一、Redis 键与 TTL 统一配置
|
||
|
||
所有 TTL 与键前缀集中在 `trading_system/redis_ttl.py` 中定义，**禁止**在 Redis 中写入无过期时间的业务键。
|
||
|
||
| 用途 | 键/前缀示例 | TTL（秒） | 说明 |
|
||
|----------------|--------------------------|-----------|----------------|
|
||
| 持仓缓存 | `ats:positions:cache` | 300 | 5 分钟 |
|
||
| 余额缓存 | `ats:balance:cache:USDT` | 300 | 5 分钟 |
|
||
| K 线（WS 写入）| `market:kline:{s}:{i}` | 600 | 10 分钟 |
|
||
| 24h 行情 | `ticker_24h:{symbol}` | 30 | 单 symbol |
|
||
| 全市场 24h | `market:ticker_24h` | 120 | 2 分钟 |
|
||
| BookTicker | `market:book_ticker` | 30 | 30 秒 |
|
||
| 交易对信息 | `symbol_info:{symbol}` | 3600 | 1 小时 |
|
||
| listenKey 缓存 | `listen_key:*` | 3300 | 55 分钟 |
|
||
| 市场 WS Leader | `market_ws_leader` | 30 | 选主续期 |
|
||
|
||
更多见 `trading_system/redis_ttl.py`（含 K 线按 interval 的 TTL 等）。
|
||
|
||
## 二、各模块行为
|
||
|
||
### 1. RedisCache 降级内存缓存
|
||
|
||
**文件**: `trading_system/redis_cache.py`
|
||
|
||
- Redis 不可用时降级到进程内存。
|
||
- 内存缓存**有上限**：最多 200 条；单条** 5 分钟**过期，过期或满时淘汰最久未用，避免无限增长。
|
||
|
||
### 2. K 线
|
||
|
||
**文件**: `trading_system/kline_stream.py`
|
||
|
||
- Leader 进程：WebSocket 收到 K 线后写入 Redis（TTL 见 `redis_ttl.TTL_KLINE_STREAM`），**写入成功后从进程内 `_kline_cache` 删除该 key**，以 Redis 为准、基本不占服务器内存。
|
||
- 非 Leader / 读路径：从 Redis 读（`get_klines_from_redis`）；进程内仅保留未刷写 Redis 的少量缓冲。
|
||
|
||
### 3. 持仓 / 余额
|
||
|
||
**文件**: `trading_system/user_data_stream.py`
|
||
|
||
- **有 Redis 时**：只写 Redis，**不写** `_position_updates_cache` / `_balance_updates_cache`；读时优先从 Redis 读。
|
||
- **无 Redis 时**：写进程内存，读时从进程内存读。
|
||
- 所有 Redis 键带 TTL（见 `redis_ttl.TTL_POSITIONS` / `TTL_BALANCE`）。
|
||
|
||
### 4. 价格与交易对信息
|
||
|
||
**文件**: `trading_system/binance_client.py`
|
||
|
||
- **价格（get_ticker_24h）**：先读 Redis；REST 回源后只写 Redis；仅当 Redis 写入失败时才写进程内存（降级）。
|
||
- **交易对信息（get_symbol_info）**：先读 Redis；从 DB/API 得到后写 Redis；仅当 Redis 不可用时才写入 `_symbol_info_cache`。
|
||
|
||
### 5. 其他
|
||
|
||
- 行情 / BookTicker / listenKey / 推荐结果等：凡写入 Redis 的均带 TTL，见各模块及 `redis_ttl.py`。
|
||
|
||
## 三、使用与运维
|
||
|
||
1. **保证 Redis/Valkey 可用**：配置好 `REDIS_URL`（如 AWS Valkey），确保交易服务能连上。
|
||
2. **重启生效**：改缓存逻辑后需重启交易服务。
|
||
3. **监控 Redis 内存**：在 Valkey 控制台或 `INFO memory` 查看内存；所有键有过期，不应无限增长。
|
||
4. **进程内存**：正常情况下进程内缓存很少；仅 Redis 不可用时才用内存降级（条数/过期受控）。
|
||
|
||
## 四、预期效果
|
||
|
||
- 服务器进程内存占用明显下降（有 Redis 时基本不存大块缓存）。
|
||
- Redis/Valkey 内所有业务键有过期，不会无限使用内存。
|