clipboard/README.md

# 剪贴板监控程序

## 简介

这是一个基于Windows 64位系统的剪贴板实时监控程序，使用Python 3.11及以上版本开发。程序在后台运行，当检测到剪贴板内容变化时，会记录剪贴板内容并显示通知提示。支持文本和图片媒体的记录。

## 功能特点

- 实时监控剪贴板变化
- 自动记录剪贴板历史内容
- 支持图片媒体的记录和保存
- 系统托盘图标，最小化运行
- 可暂停/继续监控
- 查看历史记录
- 支持开机自启动

## 系统要求

- Windows 64位操作系统
- Python 3.11或更高版本
- 必要的Python库：pyperclip, pystray, pillow (PIL), pywin32

## 安装步骤

1. 确保已安装Python 3.11或更高版本
2. 双击运行`start_clipboard_monitor.bat`，脚本会自动检查并安装必要的库

## 使用方法

### 启动程序

双击运行`start_clipboard_monitor.bat`文件即可启动剪贴板监控程序。程序启动后会在系统托盘显示图标。

### 设置开机自启动

如果希望程序在Windows启动时自动运行，请双击运行`setup_autostart.bat`文件，它会在Windows的启动文件夹中创建必要的快捷方式。

### 使用界面

程序启动后会在系统托盘区域显示一个图标，右键点击图标可以看到以下选项：

- **显示主窗口**：打开主界面，查看剪贴板历史记录
- **暂停/继续监控**：临时暂停或继续监控剪贴板
- **清空历史记录**：删除所有已记录的剪贴板历史
- **退出**：完全退出程序

### 主窗口

在主窗口中，您可以：

- 查看所有剪贴板历史记录
- 使用按钮暂停/继续监控
- 清空历史记录
- 退出程序

## 文件说明

- `clipboard_monitor.py`：主程序文件
- `start_clipboard_monitor.bat`：启动脚本
- `setup_autostart.bat`：设置开机自启动脚本
- `clipboard_monitor.log`：程序运行日志
- `clipboard_history.txt`：剪贴板历史记录
- `clipboard_media/`：保存剪贴板图片的文件夹

## 注意事项

1. 程序会在后台持续运行，如需完全退出，请通过系统托盘图标的"退出"选项或主窗口的"退出程序"按钮退出
2. 剪贴板历史记录保存在程序所在目录的`clipboard_history.txt`文件中
3. 剪贴板中的图片会保存在`clipboard_media`文件夹中，文本记录中会包含图片文件的引用
4. 如果遇到问题，可以查看`clipboard_monitor.log`日志文件了解详情

## 故障排除

如果程序无法正常启动或运行，请检查：

1. 确认Python版本是否为3.11或更高
2. 确认已安装所需的库：pyperclip, pystray, pillow, pywin32
3. 查看`clipboard_monitor.log`日志文件，了解错误详情
4. 如果提示缺少库，可以手动安装：`pip install pyperclip pystray pillow pywin32`

## 隐私说明

本程序仅在本地运行，不会将任何数据发送到互联网。所有剪贴板内容仅保存在本地文件中。