PasteDrop

English README: README_EN.md

把剪贴板里的图片，直接贴成文件。

PasteDrop 是一个面向 Windows 的轻量小工具：当你在桌面或资源管理器里按下 Ctrl+V 时，如果剪贴板中是图片，它不会像平时那样“什么都没发生”，而是会立刻在当前位置生成一个 PNG 文件。

适合截图整理、素材归档、文档配图导出，以及任何“我只想把这张图快速落盘”的场景。

演示视频

为什么值得用

• 不用先打开画图、截图工具或聊天软件中转
• 不用手动“另存为”
• 保持你已经习惯的 Ctrl+V 操作
• 在桌面和资源管理器中都能工作
• 图片会直接保存到当前上下文对应的位置

它能做什么

• 在桌面按 Ctrl+V：把图片保存到桌面
• 在资源管理器按 Ctrl+V：把图片保存到当前文件夹
• 如果剪贴板内容不是图片：自动透传原始 Ctrl+V，不干扰正常粘贴
• 自动生成时间戳文件名，避免覆盖已有文件

默认文件名格式：

Pasted Image YYYY-MM-DD HH-MM-SS.png

如果重名，会自动追加序号。

快速开始

方式一：直接使用可执行文件

1. 前往 Releases 下载可执行文件
2. 运行后就会在后台自动监听了（如果想退出，要用任务管理器杀掉）
3. 用任意软件截图，然后在桌面按 Ctrl+V

如果你希望开机自动可用，可以把可执行文件放到 Windows 启动目录：

C:\ProgramData\Microsoft\Windows\Start Menu\Programs\Startup

方式二：从源码运行

安装依赖：

pip install pillow pywin32 loguru

启动：

python pastedrop.py

使用体验

你可以把它理解为“给 Windows 补上一块本该存在的能力”：

• 截图后，去桌面按一次 Ctrl+V，图片立刻变成文件
• 在某个素材目录里按 Ctrl+V，无需打开任何编辑器
• 非图片内容继续正常粘贴，不会改变你原本的使用习惯

整个过程没有额外弹窗，没有导入步骤，也没有多余确认。

行为说明

• 仅拦截桌面和资源管理器中的 Ctrl+V
• 其他应用中的粘贴行为保持原样
• 程序关闭后即停止监听
• 为避免递归触发，程序会标记自己模拟发送的按键事件

适用场景

• 批量整理截图
• 收集网页图片或聊天图片
• 把剪贴板图片快速落到项目资料目录
• 用桌面临时接收和归档图片

注意事项

• 该工具依赖全局键盘钩子，建议以普通前台脚本或打包后的 EXE 运行
• 仅保证桌面与资源管理器场景；其他软件不会被改写粘贴逻辑
• 某些应用会接管剪贴板，如果复制结果不是标准图片对象，则会继续执行普通粘贴

日志与排查

程序使用 loguru 输出运行日志到控制台。

如果遇到“没有生成文件”或“似乎没触发”的情况，可以重点关注这些日志关键字：

• Ctrl+V event#...
• Ctrl+V intercepted, WM_APP posted
• Received WM_APP_PASTE_IMAGE
• Resolved save directory

Bug

• 如果无论你怎么按ctrl+v，都粘贴不出来，那大概率是这软件还有 bug...

已修复的bug

• 复制文件到剪贴板后，无法粘贴
• 企业微信复制的图片，无法粘贴成文件