Claude Code 图片剪贴板助手

一款 Windows 托盘工具，通过全局热键将剪贴板中的图片保存到本地，并在 Windows Terminal 中自动粘贴文件路径。

功能特性

• 全局热键 Alt+V：在任意窗口按下即可触发（仅在 Windows Terminal 中生效）
• 剪贴板图片保存：自动将剪贴板图片保存到 Images 目录
• 文件路径粘贴：保存后自动将文件路径粘贴到 Terminal
• 剪贴板保护：粘贴完成后自动恢复图片到剪贴板，支持同一图片多次粘贴
• 托盘运行：最小化到系统托盘，支持设置和退出菜单
• 单文件分发：自包含单 exe，无需安装 .NET 运行时

系统要求

• Windows 10/11
• .NET 8 运行时（已内置于单文件 exe 中）

使用方法

1. 运行 ClaudeCodeImageClipboardHelper.exe
2. 程序会在系统托盘显示图标
3. 复制一张图片到剪贴板
4. 在 Windows Terminal 中按下 Alt+V
5. 图片会自动保存，并在 Terminal 中粘贴文件路径

配置文件

首次运行会在同目录生成 settings.json：

{
  "SavePath": ".\\Images",
  "Hotkey": "Alt+V",
  "MaxAgeMinutes": 10,
  "StartMinimized": true
}

配置项	说明	默认值
SavePath	图片保存路径（支持环境变量和相对路径）	.\Images
Hotkey	全局热键	Alt+V
MaxAgeMinutes	图片保留时间（分钟）	10
StartMinimized	启动时最小化到托盘	true

项目结构

ClaudeCodeImageClipboardHelper/
├── Services/
│   ├── ClipboardService.cs    # 剪贴板读写（Win32 API）
│   ├── ConfigService.cs        # 配置文件读写
│   ├── HotkeyManager.cs        # 全局热键注册
│   ├── ImageSaver.cs           # 图片保存
│   ├── InputTypingService.cs   # 模拟鼠标右键粘贴
│   ├── LoggingService.cs       # 日志服务
│   ├── NotificationService.cs # 托盘通知
│   └── WindowDetector.cs      #前台窗口检测
├── Views/
│   ├── ToastWindow.xaml       # 通知窗口
│   └── TrayIconManager.cs      # 托盘图标管理
├── Models/
│   └── AppSettings.cs         # 配置模型
├── App.xaml                   # 应用入口
└── App.xaml.cs

构建

cd ClaudeCodeImageClipboardHelper
dotnet publish -c Release

输出：bin/Release/net8.0-windows/win-x64/publish/ClaudeCodeImageClipboardHelper.exe

注意事项

• 程序需要管理员权限运行（用于注册全局热键）
• 热键仅在 Windows Terminal 前台窗口时触发
• 图片文件名格式：{年}{月}{日}_{时}{分}{秒}_{6位随机数}.png