# GPVIEW

**Repository Path**: M1ch/gpview

## Basic Information

- **Project Name**: GPVIEW
- **Description**: 合作的一个项目........股票看盘软件,pachong东方财富数据
- **Primary Language**: Python
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-05-17
- **Last Updated**: 2026-05-17

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 股票 K 线查看软件

基于 PyQt5 + Tushare 的股票 K 线查看软件，支持板块管理、多股票同时显示和技术指标分析。

## 功能特性

### 核心功能
- **板块管理**: 支持创建多个板块（如自选股、科技股、金融股等）
- **多股票显示**: 单列纵向滚动显示，每只股票独立卡片
- **本地配置**: 股票配置保存在本地 `config.json`
- **自动识别**: 添加股票时自动根据代码显示名称

### K 线图功能
- **K 线图**: 红色/绿色蜡烛图显示
- **成交量**: 成交量柱状图
- **移动平均线**: MA5、MA10、MA20
- **技术指标**:
  - MACD (指数平滑异同移动平均线)
  - KDJ (随机指标)
  - BOLL (布林线)

### 视图控制
- **键盘控制**:
  - `←` 向左移动（查看更早数据）
  - `→` 向右移动（查看更新数据）
  - `Ctrl + ←` 放大（减少 K 线数量）
  - `Ctrl + →` 缩小（增加 K 线数量）
  - `R` 重置视图
  - `Home` 回到最开始
  - `End` 回到最后

- **按钮控制**:
  - ➕ 放大
  - ➖ 缩小
  - ◀ 左移
  - ▶ 右移
  - 🔄 重置

## 安装

### 1. 安装依赖

```bash
pip install -r requirements.txt
```

依赖说明:
- PyQt5 >= 5.15.0 - GUI 框架
- tushare >= 1.12.0 - 股票数据源
- pandas >= 1.5.0 - 数据处理
- numpy >= 1.21.0 - 数值计算
- matplotlib >= 3.5.0 - 图表绘制

### 2. 运行程序

```bash
python main.py
```

## 使用说明

### 板块管理

1. 点击 **⚙ 配置** 按钮打开配置对话框
2. **添加板块**: 点击"➕ 添加板块"，输入板块名称
3. **删除板块**: 选择板块后点击"🗑 删除板块"
4. **切换板块**: 在主界面左上角下拉框选择板块

### 添加股票

1. 点击 **⚙ 配置** 按钮
2. 选择要添加股票的板块
3. 在搜索框输入股票代码或名称（如 `000001` 或 `平安银行`）
4. 点击"🔍 搜索"
5. 从下拉列表选择股票
6. 点击"✓ 添加选中"
7. 股票会自动显示代码和名称

### 删除股票

- 在配置对话框中双击股票列表中的股票
- 或在主界面每只股票卡片上点击 🔄 刷新按钮旁的删除功能

### 查看 K 线图

- 每只股票独立显示为一个卡片
- 使用鼠标滚轮或滚动条上下滚动查看所有股票
- 每只股票默认显示最近 60 根 K 线

### 切换指标

在每只股票的卡片上选择：
- **无**: 仅显示 K 线和成交量
- **MACD**: 显示 MACD 指标
- **KDJ**: 显示 KDJ 指标
- **BOLL**: 显示 BOLL 布林线

### 刷新数据

- **刷新单只股票**: 点击股票卡片右上角的 🔄 按钮
- **刷新全部**: 点击主界面右上角的"🔄 刷新全部"按钮

## 项目结构

```
gpview/
├── main.py              # 程序入口
├── requirements.txt     # 依赖包
├── config.json          # 配置文件（自动创建）
├── README.md            # 使用说明
├── gui/
│   ├── __init__.py
│   ├── main_window.py   # 主窗口
│   ├── kline_widget.py  # K 线图组件
│   ├── stock_dialog.py  # 股票配置对话框（旧）
│   └── sector_dialog.py # 板块配置对话框（新）
└── utils/
    ├── __init__.py
    ├── data_fetcher.py  # 数据获取 (Tushare)
    ├── indicators.py    # 技术指标计算
    └── config_manager.py # 配置管理
```

## 数据源

使用 [Tushare](https://tushare.pro/) 获取 A 股股票行情数据。

- 需要注册获取 token（免费）
- token 配置在 `utils/data_fetcher.py` 中
- 当前使用的 token 已预配置

## 快捷键

| 快捷键 | 功能 |
|--------|------|
| ← | 向左移动 |
| → | 向右移动 |
| Ctrl + ← | 放大 |
| Ctrl + → | 缩小 |
| R | 重置视图 |
| Home | 回到最开始 |
| End | 回到最后 |

## 配置文件

配置保存在 `config.json`，格式如下：

```json
{
  "sectors": [
    {
      "name": "自选股",
      "stocks": [
        ["000001", "平安银行"],
        ["600519", "贵州茅台"]
      ]
    },
    {
      "name": "科技股",
      "stocks": [
        ["000063", "中兴通讯"],
        ["300750", "宁德时代"]
      ]
    }
  ]
}
```

## 注意事项

1. 需要联网才能获取股票数据
2. 数据来源于 Tushare，如有延迟以实际行情为准
3. 支持沪深 A 股股票
4. 首次加载可能需要一些时间获取数据

## License

MIT