clipboard/README.md
2025-07-30 22:14:37 +08:00

83 lines
2.9 KiB
Markdown
Raw Blame History

This file contains ambiguous Unicode characters

This file contains Unicode characters that might be confused with other characters. If you think that this is intentional, you can safely ignore this warning. Use the Escape button to reveal them.

# 剪贴板监控程序
## 简介
这是一个基于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`
## 隐私说明
本程序仅在本地运行,不会将任何数据发送到互联网。所有剪贴板内容仅保存在本地文件中。