# COPYpro

**Repository Path**: xkx1029/copypro

## Basic Information

- **Project Name**: COPYpro
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-03-25
- **Last Updated**: 2026-03-29

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# COPYpro

一个功能强大的Windows桌面端剪贴板增强工具，支持历史记录、收藏和搜索功能，以悬浮窗形式展示，并集成系统托盘。

## 功能特点

### 📋 核心功能
- **剪贴板历史记录**：自动保存所有复制的内容
- **收藏功能**：标记重要内容为收藏
- **搜索功能**：快速查找历史记录中的内容
- **数据持久化**：历史记录自动保存到本地文件
- **悬浮窗**：始终保持在窗口最顶层

### 🎯 系统集成
- **系统托盘**：最小化到系统托盘，显示在"隐藏的图标"区域
- **开机自启动**：自动设置开机自启动
- **状态反馈**：底部状态栏显示操作状态

### 🔧 技术特点
- **独立线程**：使用单独的线程监听剪贴板，提高响应速度
- **错误处理**：增强了异常捕获，确保稳定运行
- **实时反馈**：添加了操作状态提示
- **智能去重**：自动过滤重复内容，避免历史记录混乱

## 安装方法

### 1. 克隆项目
```bash
git clone https://github.com/yourusername/clipboard-pro.git
cd clipboard-pro
```

### 2. 安装依赖
```bash
pip install -r requirements.txt
```

### 3. 运行应用
```bash
python copypro_optimized.py
```

## 使用说明

### 基本操作
1. **启动应用**：运行 `python copypro_optimized.py`
2. **复制内容**：在任何应用中使用Ctrl+C复制文本，应用会自动记录
3. **查看历史**：在主窗口中查看历史记录
4. **搜索内容**：在搜索框中输入关键词，实时过滤结果
5. **收藏内容**：选中内容后点击"收藏"按钮
6. **复制回剪贴板**：选中内容后点击"复制"按钮
7. **删除内容**：选中内容后点击"删除"按钮
8. **清空记录**：点击"清空"按钮清空当前视图的所有记录

### 系统托盘操作
1. **最小化**：点击窗口最小化按钮或关闭按钮，应用会最小化到系统托盘
2. **恢复窗口**：点击系统托盘中的"显示主窗口"选项
3. **退出应用**：点击系统托盘中的"退出"选项

## 技术栈

- **开发语言**：Python 3.9+
- **GUI库**：tkinter
- **剪贴板操作**：pyperclip
- **系统托盘**：pystray
- **图像处理**：Pillow
- **系统集成**：winreg (Windows)

## 项目结构

```
copypro/
├── copypro_optimized.py    # 主应用文件
├── clipboard_history.json  # 历史记录存储
├── requirements.txt        # 依赖项
└── README.md              # 项目说明
```

## 配置说明

### 历史记录限制
- 最多保存100条历史记录，超出后会自动删除最旧的记录
- 历史记录存储在 `clipboard_history.json` 文件中

### 开机自启动
- 首次运行时自动设置开机自启动
- 自启动设置存储在 Windows 注册表中
- 只对当前用户生效，不需要管理员权限

## 故障排除

### 常见问题
1. **剪贴板监听不工作**
   - 检查是否安装了所有依赖项
   - 检查是否有其他应用占用了剪贴板

2. **系统托盘不显示**
   - 检查系统托盘设置，可能在"隐藏的图标"区域
   - 检查是否安装了 Pillow 库

3. **开机自启动不生效**
   - 检查是否有管理员权限
   - 手动在任务管理器中检查自启动项

## 贡献指南

欢迎贡献代码、报告问题或提出建议！

1. ** Fork 项目
2. 创建特性分支 (`git checkout -b feature/amazing-feature`)
3. 提交更改 (`git commit -m 'Add some amazing feature'`)
4. 推送到分支 (`git push origin feature/amazing-feature`)
5. 打开 Pull Request

## 许可证

本项目采用 MIT 许可证 - 详情请参阅 [LICENSE](LICENSE) 文件

## 联系方式

- **项目链接**：https://gitee.com/xkx1029/copypro
- **作者**：xkx1029
- **邮箱**：cn_xkx@outlook.com

## 更新日志

### v1.0.0 (2026-03-25)
- 初始版本
- 实现剪贴板历史记录功能
- 添加收藏和搜索功能
- 集成系统托盘
- 支持开机自启动
- 优化用户体验

---

**享受更高效的剪贴板管理体验！** 🚀