Show HN: 為AI編程助手壓縮你的截圖
Screenshotter 是一款 macOS 工具,可將截圖優化並複製到剪貼板,大幅減小文件大小(平均節省 80-93%),同時保持可讀性,專為 AI 編程代理(如 Codex、Claude)設計。支持多種配置和集成,可降低帶寬、延遲和存儲開銷。
Screenshotter 是一款輕量級的 macOS 命令行工具,旨在優化截圖並將其直接複製到系統剪貼板,方便用户快速粘貼到 AI 編碼代理(如 OpenAI Codex 和 Anthropic Claude)中。該工具由開發者 mgranados 發佈,作為一個開源項目託管在 GitHub 上,遵循 MIT 許可證。
該工具的核心工作流程非常簡單:用户只需使用 macOS 原生截圖快捷鍵(Cmd+Shift+3 或 Cmd+Shift+4)截取屏幕,Screenshotter 會自動捕獲新截圖、執行優化處理,並將優化後的圖像數據放入剪貼板。用户隨後在 AI 代理的輸入框中按下 Cmd+V 即可粘貼,無需手動保存或轉換文件。
Screenshotter 最主要的賣點在於其壓縮效率。根據開發者的基準測試,與原始截圖相比,該工具在不同顯示器和窗口尺寸下可將文件大小減少 68% 至 93%。例如,在 Pro Display XDR(6016x3384 像素)上,原始截圖為 5.48 MB,優化後僅為 0.89 MB,節省了 93% 的空間。對於更常見的 16 英寸 MacBook Pro 顯示屏(3456x2234 像素),文件從 1.86 MB 降至 0.83 MB,節省 89%。這些壓縮是在“默認”設置下實現的,該設置專門針對文本可讀性進行了校準,以確保 AI 模型能夠準確識別屏幕上的文字。
為了滿足不同場景的需求,Screenshotter 提供了多個預設配置:
- 可讀性模式(默認):優先保持文字清晰,適用於大多數編碼輔助場景。
- 均衡模式:在文件大小和視覺質量之間取得平衡。
- 令牌模式:進一步降低分辨率,以最小化 AI API 的圖像令牌消耗(按像素計費)。
用户可以通過命令行參數或與 pi(一個可能的 CLI 集成工具)中的命令來切換這些配置。
Screenshotter 的安裝非常直接:從 GitHub 克隆倉庫後,運行 node bin/screenshotter.mjs doctor 檢查依賴,然後使用 screenshotter watch --verbose 啓動監聽模式。可選地,可以將可執行文件鏈接到 ~/.local/bin 以便全局調用。該工具還支持與流行的 AI 代理進行深度集成:通過 MCP(Model Context Protocol)服務器,用户可以在 Codex 和 Claude 中添加 Screenshotter 作為工具/插件,實現無縫的工作流。
除了壓縮優勢,Screenshotter 還帶來了多項實際收益:減少上傳帶寬(從數 MB 降至 1 MB 以下)、降低粘貼/發送延遲、節省本地存儲空間、以及降低因附件大小超限導致的失敗風險。對於使用按令牌計費的 AI API(如圖像輸入),令牌模式可進一步削減成本。
該項目目前仍處於早期階段——GitHub 倉庫僅有 1 個 Star、0 個 Fork,且未發佈正式版本。但它的實用性和針對性設計使其在 AI 輔助編程社區中具有潛在價值。開發者提供了詳細的文檔,包括安裝指南、配置文件説明、命令行參考(如 clip、prepare-latest、bench 等),以及審計日誌(JSONL 格式)。
總之,Screenshotter 是一個專注但強大的小工具,它解決了 AI 編程代理中一個常見痛點:如何高效地傳遞屏幕截圖而不犧牲質量和消耗過多資源。對於經常使用 AI 進行代碼審查、錯誤調試或 UI 設計的 macOS 用户來説,這可能會成為他們工具箱中的一枚利器。