# TradingKline

**Repository Path**: kimfeng/TradingKline

## Basic Information

- **Project Name**: TradingKline
- **Description**: No description available
- **Primary Language**: C++
- **License**: LGPL-3.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-04-07
- **Last Updated**: 2026-04-07

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# TradingKline - 极简金融行情软件

TradingKline 是一个极简的金融行情软件，遵循"功能极简+资源零成本+流程极简化"的设计理念。

## 功能特点

- **行情列表**：显示股票代码、名称、当前价、涨跌额、涨跌幅、昨收价、开盘价、成交量、外盘、内盘等信息
- **分时 / 分K / 日K / 周K / 月K**：使用 QCustomPlot 绘制分时与 K 线图
- **自动刷新**：自动获取最新数据
- **极简设计**：仅保留核心功能，避免不必要的复杂性
- **主题支持**：支持 Light、Dark 两种主题样式

## 界面预览

| 行情列表 | 分时图 |
| -------- | ------ |
| ![行情列表](docs/screenshots/Snipaste_2026-02-08_22-41-10.png) | ![分时图](docs/screenshots/Snipaste_2026-02-08_22-41-18.png) |

| 分K                                                       | 周K                                                       |
| --------------------------------------------------------- | --------------------------------------------------------- |
| ![分K](docs/screenshots/Snipaste_2026-02-08_22-41-26.png) | ![日K](docs/screenshots/Snipaste_2026-02-08_22-41-34.png) |

| 月K                                                       | 日K 深色主题                                              |
| --------------------------------------------------------- | --------------------------------------------------------- |
| ![周K](docs/screenshots/Snipaste_2026-02-08_22-41-44.png) | ![月K](docs/screenshots/Snipaste_2026-02-08_22-42-31.png) |

| 深色主题-布局器展示                                          | 深色主题-布局器展示                                          |
| ------------------------------------------------------------ | ------------------------------------------------------------ |
| ![浅色主题](docs/screenshots/Snipaste_2026-02-08_22-42-43.png) | ![深色主题](docs/screenshots/Snipaste_2026-02-08_22-43-30.png) |

## 技术栈

- **Visual Studio 2022** + **Qt 6.8.0**（推荐开发环境）
- **QCustomPlot**：轻量级开源图表库
- **SQLite**：Qt 内置支持的数据存储
- **Qt Network**：内置网络通信模块
- **行情数据**：新浪财经、东方财富等免费公开数据源

## 构建说明

### 推荐开发环境

- **Windows**：Visual Studio 2022 + Qt 6.8.0（MSVC 2022 64-bit）
- **CMake** 3.16 或更高版本
- **QCustomPlot**：从 [官网](https://www.qcustomplot.com/index.php/download) 下载后放入项目对应位置

### 依赖项

- Qt 6.8.0 或更高版本（建议 6.8.0）
- CMake 3.16 或更高版本
- Python 3（可选，用于 adata 行情数据模块）

### 构建步骤（Windows + VS2022 + Qt 6.8.0）

1. 安装 [Visual Studio 2022](https://visualstudio.microsoft.com/)（含「使用 C++ 的桌面开发」）
2. 安装 [Qt 6.8.0](https://www.qt.io/download) for MSVC 2022 64-bit，并配置环境变量或 CMake 可识别的 Qt 路径
3. 从 [QCustomPlot 官网](https://www.qcustomplot.com/index.php/download) qcustomplot已内置修改过，无需下载
4. 创建构建目录并配置、编译：

```bash
mkdir build
cd build
cmake .. -DCMAKE_PREFIX_PATH="C:/Qt/6.8.0/msvc2022_64"
cmake --build . --config Release
```

5. 运行程序：在 `build` 对应输出目录中运行可执行文件，或使用 VS2022 打开生成的解决方案进行调试。

### 其他平台

- **Linux / macOS**：可使用 Qt 6.8.0 与对应编译器，步骤类似（使用 `make` 或 `ninja`）。

## 使用说明

1. 启动程序后，会自动加载预设的股票代码列表
2. 表格中会显示股票的实时行情信息
3. 右侧图表可切换「分时」「分K」「日K」「周K」「月K」查看不同周期走势
4. 可点击「刷新」按钮手动更新数据，或开启轮询自动更新
5. 右上角可切换 Light / Dark 主题

## 注意事项

- 本软件仅用于个人学习和演示，不应用于商业用途
- 免费数据源可能不稳定，请考虑备用方案
- 使用前请确保网络连接正常

## 许可证

项目采用 LGPLv3 及 MIT 许可证。