# 股票追踪

**Repository Path**: kas233/stock-tracking

## Basic Information

- **Project Name**: 股票追踪
- **Description**: vibe coding尝试
- **Primary Language**: Python
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-01-16
- **Last Updated**: 2026-01-16

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# 股票追踪系统

一个基于Python的股票实时追踪系统，能够在Windows通知栏显示股票信息，并通过气泡通知定期更新股票价格和涨跌幅。

## 功能特性

- ✅ **Windows通知栏显示**：程序运行时在通知栏显示图标
- ✅ **气泡通知**：定期通过系统气泡显示股票当前价及涨跌幅
- ✅ **配置文件支持**：通过`config.ini`自定义股票编码、刷新频率和日志设置
- ✅ **实时股票数据**：使用akshare库获取最新股票数据
- ✅ **日志记录**：根据配置记录运行日志
- ✅ **无窗口运行**：打包成单个exe文件，无命令行窗口
- ✅ **手动刷新**：支持右键菜单手动刷新股票数据

## 技术栈

- Python 3.11
- akshare：获取股票实时数据
- pystray：创建Windows通知栏图标
- pillow：处理图标
- plyer：发送系统通知
- configparser：读取配置文件
- pyinstaller：打包成exe

## 安装方法

### 直接运行（推荐）

1. 从`dist`目录下载`main.exe`文件
2. 将`config.ini`文件与`main.exe`放在同一目录
3. 双击`main.exe`即可启动

### 从源代码运行

1. 克隆或下载项目源码
2. 安装依赖库：
   ```bash
   pip install -r requirements.txt
   ```
3. 运行主程序：
   ```bash
   python main.py
   ```

## 使用说明

1. **启动程序**：双击`main.exe`文件，程序会在通知栏显示图标
2. **查看股票信息**：程序会按照配置的刷新频率自动显示股票信息气泡
3. **手动刷新**：右键点击通知栏图标，选择"刷新"可手动更新股票数据
4. **退出程序**：右键点击通知栏图标，选择"退出"可关闭程序

## 配置说明

程序首次运行会自动创建`config.ini`配置文件，您可以根据需要修改以下配置：

```ini
[General]
# 股票编码列表，多个股票用逗号分隔
stock_codes = 600000,000001,300001
# 刷新频率，单位：秒
refresh_interval = 60
# 日志开关，True或False
log_enabled = True
# 日志级别，DEBUG, INFO, WARNING, ERROR
log_level = INFO
```

### 配置项说明

| 配置项 | 说明 | 默认值 |
|-------|------|--------|
| stock_codes | 股票编码列表，多个股票用逗号分隔 | 600000,000001,300001 |
| refresh_interval | 刷新频率，单位：秒 | 60 |
| log_enabled | 日志开关，True或False | True |
| log_level | 日志级别，可选值：DEBUG, INFO, WARNING, ERROR | INFO |

## 项目结构

```
stock-tracking/
├── main.py              # 主程序入口
├── config.ini           # 配置文件
├── stock_tracker.py     # 股票追踪核心逻辑
├── tray_icon.py         # 通知栏图标管理
├── utils.py             # 工具函数（配置读取、日志设置）
├── requirements.txt     # 依赖库列表
├── icon.ico             # 通知栏图标
├── create_icon.py       # 图标创建脚本
├── hook-akshare.py      # pyinstaller钩子文件
├── main.spec            # pyinstaller打包配置
├── dist/                # 打包输出目录
│   └── main.exe         # 生成的无窗口exe文件
└── README.md            # 项目说明文档
```

## 开发说明

### 依赖安装

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

### 运行程序

```bash
python main.py
```

### 打包成exe

```bash
pyinstaller main.spec
```

或者使用命令行参数：

```bash
pyinstaller -w -i icon.ico --onefile --additional-hooks-dir . --add-data "config.ini;." main.py
```

## 常见问题

### Q: 为什么运行时没有显示气泡通知？
A: 请检查系统通知设置，确保允许该程序发送通知。

### Q: 为什么股票数据显示异常？
A: 请检查网络连接，确保能正常访问互联网。

### Q: 如何修改股票列表？
A: 编辑`config.ini`文件中的`stock_codes`配置项，多个股票用逗号分隔。

### Q: 如何调整刷新频率？
A: 编辑`config.ini`文件中的`refresh_interval`配置项，单位为秒。

## 许可证

MIT License

## 更新日志

### v1.0.0 (2026-01-16)
- 初始版本
- 实现基本的股票追踪功能
- 支持Windows通知栏显示和气泡通知
- 支持配置文件自定义
- 支持打包成无窗口exe文件

## 贡献

欢迎提交Issue和Pull Request来改进这个项目！

## 联系方式

如有问题或建议，请通过GitHub Issues反馈。