# tradehk 项目文档中心

> **tradehk** 是一个基于 Binance API 的全栈量化交易终端，采用 Node.js + TypeScript + React 构建，支持实时 K 线图、多指标共振信号引擎、自动交易、飞书通知等功能。

## 仓库地址

```
ssh://git@git.hk.hao.work:2222/hao/tradehk.git
```

## 文档目录

| 文档 | 说明 |
|------|------|
| [系统架构总览](./系统架构总览.md) | 整体技术栈、模块划分、数据流向 |
| [指标引擎详解](./指标引擎详解.md) | 所有技术指标的实现原理与参数（基于 indicators.ts） |
| [信号评分引擎](./信号评分引擎.md) | 多指标共振评分机制完整说明（generateSignal 函数） |
| [大周期偏向判定](./大周期偏向判定.md) | assessBigTimeframeBias 函数原理与应用 |
| [EWO转换检测机制](./EWO转换检测机制.md) | EWO 红绿转换通知的完整检测流程（marketEngine.ts） |
| [飞书通知格式规范](./飞书通知格式规范.md) | 所有通知消息的格式模板与字段说明 |
| [类型系统参考](./类型系统参考.md) | TypeScript 类型定义完整参考（types.ts） |
| [数据库与存储](./数据库与存储.md) | MySQL 数据库结构、信号持久化、清理策略 |
| [部署运维指南](./部署运维指南.md) | Docker Compose 部署、Nginx 配置、环境变量 |
| [开发历史与TODO](./开发历史与TODO.md) | 项目演进记录、已完成功能、待开发项 |
| [优化建议汇总](./优化建议汇总.md) | 基于源码分析的优化点与改进路线图 |

## 快速理解

tradehk 的核心工作流程如下：

```
Binance API（K线数据）
    ↓ 每30秒轮询
marketEngine.ts（市场引擎）
    ↓ 计算指标
indicators.ts（指标引擎）
    ↓ 生成信号
generateSignal() → 评分 → BUY/SELL/NEUTRAL
    ↓ 持久化
MySQL 数据库（signals 表）
    ↓ 推送通知
飞书 Webhook（Lark）
```

## 核心特性

- **默认周期**：10m（10分钟K线）
- **核心指标**：EWO + MACD + AO + MA（常开），RSI/KDJ/Stoch/BB/SuperTrend/DMI（可选）
- **信号强度**：STRONG（强）/ MODERATE（中）/ WEAK（弱）
- **通知模式**：EWO转换专项通知 + 可选全信号通知
- **频控机制**：同币同方向最短间隔可配置（默认10分钟）
- **大周期过滤**：4h 或 12h 趋势偏向过滤小周期信号

## 相关知识

- [EWO 名词解释](../名词解释/EWO-艾略特波浪振荡器.md)
- [MACD 名词解释](../名词解释/MACD-指数移动平均线.md)
- [MTF 多时间框架分析](../名词解释/MTF-多时间框架分析.md)
- [信号系统优化建议](../../12_信号系统优化/信号系统深度优化建议.md)
- [EWO 阈值过滤完整流程](../../12_信号系统优化/EWO阈值过滤完整落地流程.md)