Clippy

🚀 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 許可證。