# PickMe

**Repository Path**: rich-coder/pick-me

## Basic Information

- **Project Name**: PickMe
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-08-05
- **Last Updated**: 2025-08-06

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# PickMe 桌面悬浮数据管理组件

一个基于 PyQt5 的桌面悬浮组件，专门用于股票数据搜索和管理。

## 功能特点

- 桌面悬浮球设计，始终保持在最前端
- 右键点击悬浮球弹出菜单，可打开股票数据列表
- 股票数据搜索功能（基于Tushare Pro API）
- 支持通过中文模糊搜索股票代码或名称
- 支持通过市场类型搜索（如SH、SZ）
- 搜索结果实时更新并显示在过滤后的股票数据列表中
- 双击搜索结果可将股票添加到已选择列表
- 支持通过右键菜单控制显示/隐藏和退出
- 支持窗口拖动
- 美观的毛玻璃视觉效果
- 搜索防抖优化，提高响应性能
- 详细的调试打印信息，便于跟踪程序执行流程

## 安装依赖

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

## 运行程序

```bash
python src/main.py
```

## 使用说明

1. 运行程序后，桌面上会出现一个半透明的悬浮球
2. 右键点击悬浮球，选择"显示数据列表"打开股票数据管理窗口
3. 在股票数据列表窗口中：
   - 程序启动时会自动从Tushare Pro API获取实时股票数据
   - 在搜索框中输入股票代码、名称或市场类型（如SH、SZ）进行模糊搜索
   - 搜索结果会实时显示在搜索结果列表中（带有300毫秒防抖延迟优化）
   - 双击搜索结果中的股票项将其添加到已选择列表
   - 已选择的股票会显示在窗口上部的列表中
4. 右键点击悬浮球可以打开菜单，选择显示/隐藏或退出程序
5. 拖动悬浮球可以移动其位置
6. 点击数据列表窗口右上角关闭按钮可以隐藏窗口

程序运行时会在控制台输出详细的调试信息，包括：
- 程序启动和初始化过程
- Tushare API连接和数据获取过程
- 搜索操作和结果过滤过程
- 股票添加和界面更新过程
- 错误处理和异常情况

## 界面说明

### 悬浮球
- 圆形悬浮球，默认位于屏幕右下角
- 左键拖动可以移动位置
- 右键点击弹出菜单

### 股票数据列表窗口
- 顶部标题栏显示"股票列表"，右侧有关闭按钮（点击可隐藏窗口）
- 已选择股票列表区域显示已添加的股票
- 搜索结果区域显示匹配的股票
- 底部为股票搜索框，用于搜索股票（支持代码、名称和市场类型模糊搜索）
- 双击搜索结果中的股票项可将其添加到已选择列表

## 自定义

你可以在 [src/main.py](file:///F:/code/python/PickMe/src/main.py) 文件中修改界面样式和功能逻辑。

## 股票数据API

本程序使用Tushare Pro API获取股票数据。要使用真实的股票数据，你需要：

1. 访问[Tushare官网](https://tushare.pro/)注册账号
2. 获取你的token
3. 在代码中替换token（在[StockDataThread](file:///F:/code/python/PickMe/src/main.py#L15-L49)类和[load_sample_stock_data](file:///F:/code/python/PickMe/src/main.py#L337-L393)方法中替换示例token）：

```python
ts.set_token('your_token_here')
```

如果没有token，程序会自动使用示例股票数据作为备选方案。