🚀 Clippy 📎
Clippy 是一款专为 macOS 设计的工具，它能让你直接在终端复制文件，并将其粘贴到各种 GUI 应用程序中，避免了在 Finder 与终端之间频繁切换的麻烦。
🚀 快速开始
安装
Homebrew（推荐）
brew install neilberkman/clippy/clippy
从源代码构建
# 克隆并构建
git clone https://github.com/neilberkman/clippy.git
cd clippy
go build -o clippy ./cmd/clippy
sudo mv clippy /usr/local/bin/
# 或者使用 go install
go install github.com/neilberkman/clippy/cmd/clippy@latest
使用示例
# 将文件作为引用复制（可粘贴到任何 GUI 应用程序）
clippy report.pdf # ⌘V 粘贴到 Slack 或邮件中 - 上传文件
clippy *.jpg # 一次复制多个文件
# 通过管道将数据作为文件复制
curl -sL https://picsum.photos/300 | clippy # 下载 → 以文件形式复制到剪贴板
# 复制最近的下载文件（立即操作）
clippy -r # 复制刚刚下载的文件
clippy -r 3 # 复制最近的 3 个下载文件
# 交互式选择最近的文件
clippy -i # 从最近的下载文件列表中选择
clippy -i 5m # 仅显示最近 5 分钟内的文件选择器
✨ 主要特性
1. 智能文件复制
clippy document.pdf # 以文件引用形式复制（可粘贴到任何应用程序）
clippy notes.txt # 同样以文件引用形式复制
clippy -t notes.txt # 使用 -t 标志以复制文本内容
clippy *.jpg # 一次复制多个文件
2. 处理最近下载的文件
# 立即复制（无 UI）
clippy -r # 复制最近下载的文件
clippy -r 3 # 复制最近的 3 个下载文件
clippy -r 5m # 复制最近 5 分钟内的所有下载文件
# 交互式选择器
clippy -i # 从最近的下载文件列表中选择
clippy -i 3 # 显示最近 3 个文件的选择器
clippy -i 5m # 仅显示最近 5 分钟内的文件选择器
# 复制并粘贴一步完成
clippy -r --paste # 复制最近的下载文件并粘贴到此处
clippy -i --paste # 选择文件，复制并粘贴到此处
3. 通过管道复制数据为文件
curl -sL https://example.com/image.jpg | clippy
cat archive.tar.gz | clippy
4. 复制并粘贴
clippy ~/Downloads/report.pdf --paste # 复制到剪贴板并粘贴到此处
clippy -r --paste # 复制最近的下载文件并粘贴到此处
clippy -i --paste # 选择文件，复制并粘贴到此处
5. 清空剪贴板
clippy --clear # 清空剪贴板
echo -n | clippy # 同样可清空剪贴板
6. 实用标志
clippy -v file.txt # 显示操作结果
clippy --debug file.txt # 显示调试的技术细节
📚 详细文档
为何选择 Clippy？
pbcopy 只能复制文件的 内容，但 GUI 应用程序需要的是文件的 引用。当你使用 pbcopy < image.png 时，无法将其粘贴到 Slack 或邮件中，因为这些应用程序期望的是文件，而不是原始字节。
Clippy 则通过检测你的需求并使用正确的剪贴板格式来弥补这一差距。
为何叫 "Clippy"？
因为它就像一个贴心的剪贴板助手，能理解你的需求！ 📎
Pasty - 智能剪贴板粘贴
当你在 Finder 中复制一个文件，然后在终端中按 ⌘V 时，你只能得到文件名作为文本。而 Pasty 可以将文件本身复制到你当前的目录中。
核心用例
1. 在 Finder 中复制文件 → 在终端中粘贴实际文件
# 1. 在 Finder 中复制任何文件（⌘C）
# 2. 切换到终端并运行：
pasty
# 文件将被复制到你当前的目录（而不仅仅是文件名！）
2. 智能处理文本文件
# 在 Finder 中复制一个文本文件（⌘C），然后：
pasty # 将文件的文本内容输出到标准输出
pasty notes.txt # 将文件的文本内容保存到 notes.txt
安装与使用
# 通过 Homebrew 安装
brew install neilberkman/clippy/clippy
# 或者从源代码构建
go install github.com/neilberkman/clippy/cmd/clippy@latest
go install github.com/neilberkman/clippy/cmd/pasty@latest
Draggy - 可视化剪贴板助手
Draggy 是一个菜单栏应用程序，它为你的剪贴板工作流程带来了可视化功能。当 clippy 负责从终端复制文件时，Draggy 提供了一个可视化界面，用于将文件拖放到应用程序中并查看最近的下载文件。
重要提示
Draggy 是一个独立的可选工具，不会随 clippy 自动安装。
特性
核心功能
- 拖放桥梁 - 使剪贴板中的文件可以拖放到网页浏览器、Slack 等应用程序中。
- 最近下载查看器 - 一键切换查看剪贴板和最近的下载文件。
- 文件缩略图 - 在文件列表中直接显示图像和 PDF 的可视化预览。
- 快速预览 - 按住 ⌥ Option 键悬停时可查看更大的预览。
- 零后台活动 - 无需轮询，不消耗电池，仅在需要时激活。
用户体验
- 双击打开 - 无需离开菜单即可快速访问文件。
- 键盘快捷键 - 按 ESC 关闭，按 Space 刷新。
设计理念
- 非剪贴板管理器 - 没有历史记录、数据库，不增加复杂性。
- 以终端为中心的工作流程 - 旨在补充终端的使用，而不是取代它。
- 简约而完整 - 每个功能都服务于特定的工作流程需求。
安装
# 单独使用 Homebrew 安装（不包含在 clippy 中）
brew install --cask neilberkman/clippy/draggy
首次启动注意事项
macOS 可能会显示安全警告，因为 Draggy 未经过代码签名。如果你看到 "Draggy 已损坏，无法打开" 的提示：
- Homebrew cask 在安装过程中会自动移除隔离标志。
- 如果警告仍然存在，请运行：
xattr -dr com.apple.quarantine /Applications/Draggy.app。 - 或者右键单击 Draggy.app 并选择 "打开" 以绕过 Gatekeeper。
使用方法
# 在终端中复制文件：
clippy ~/Downloads/*.pdf # 使用 clippy 复制 PDF 文件
curl -sL image.jpg | clippy # 通过管道将下载内容复制到剪贴板
clippy -r # 复制最近的下载文件
# 使用 Draggy GUI：
# 1. 点击菜单栏中的 Draggy 图标
# 2. 将文件拖到浏览器上传字段、Slack 等应用程序中
# 3. 点击时钟图标切换到最近下载视图
# 4. 按住 ⌥ Option 键预览文件
# 5. 双击打开文件
工作流示例
将截图上传到 GitHub：
# 截取屏幕截图（macOS 会将其保存到桌面）
# 在终端中：clippy ~/Desktop/Screenshot*.png
# 在 Draggy 中：将文件拖到 GitHub 评论框中
快速共享文件：
# 在终端中：clippy ~/Downloads/report.pdf
# 在 Draggy 中：显示缩略图，将文件拖到 Slack 或邮件中
最近下载工作流：
# 在浏览器中下载文件
# 点击 Draggy → 点击时钟图标 → 查看下载的文件
# 将文件拖到需要的地方或双击打开
设计理念
Draggy 有意不做成剪贴板管理器，没有历史记录、搜索功能和数据库。它是终端剪贴板工作流程与 GUI 应用程序之间的可视化桥梁，适合那些偶尔需要查看剪贴板内容或拖放文件，然后继续工作的终端用户。
MCP 服务器
Clippy 包含一个内置的 MCP（模型上下文协议）服务器，它允许 AI 助手将生成的内容直接复制到你的剪贴板。
你可以让 Claude 生成任何文本 - 代码、邮件、文档等，并立即将其粘贴到任何地方：
- "编写一个处理 CSV 文件的 Python 脚本并复制到我的剪贴板"
- "起草一封关于会议的邮件并放到我的剪贴板上"
- "生成那个正则表达式并复制，以便我可以粘贴到编辑器中"
无需再从聊天界面手动选择和复制内容。
设置
将以下内容添加到你的 Claude Desktop 配置文件（~/Library/Application Support/Claude/claude_desktop_config.json）中：
{
"mcpServers": {
"clippy": {
"command": "clippy",
"args": ["mcp-server"]
}
}
}
可用工具
- clipboard_copy - 将文本或文件复制到剪贴板
- clipboard_paste - 将剪贴板内容粘贴到文件/目录中
- get_recent_downloads - 列出最近下载的文件
Claude 可以生成内容并直接将其放到你的剪贴板上，随时可粘贴到你需要的地方。
作为 Go 库使用
Clippy 可以作为 Go 库在你自己的应用程序中使用：
go get github.com/neilberkman/clippy
高级 API
import "github.com/neilberkman/clippy"
// 智能复制 - 自动检测文本文件和二进制文件
err := clippy.Copy("document.pdf")
// 复制多个文件作为引用
err := clippy.CopyMultiple([]string{"image1.jpg", "image2.png"})
// 复制文本内容
err := clippy.CopyText("Hello, World!")
// 从读取器复制数据（处理文本/二进制检测）
reader := strings.NewReader("Some content")
err := clippy.CopyData(reader)
// 从标准输入复制
err := clippy.CopyData(os.Stdin)
// 获取剪贴板内容
text, ok := clippy.GetText()
files := clippy.GetFiles()
特性
- 智能检测：自动确定是复制文件引用还是文本内容。
- 多文件复制：一次复制多个文件。
- 读取器支持：从任何 io.Reader 复制数据，并自动检测格式。
- 剪贴板访问：读取当前剪贴板内容（文本或文件路径）。
- 跨平台类型：使用标准的 Go 类型，内部处理特定平台的剪贴板操作。
📄 许可证
本项目采用 MIT 许可证。