难题彻底解决!VPaste:让 SSH 终端也能"粘贴"截图

一键截图上传,URL 直接输入到光标位置 ------ 解决远程开发场景下的图片粘贴难题

痛点:SSH 终端无法粘贴图片

作为一个开发者,你是否遇到过这样的场景:

  1. 在本地 Mac 截图了一张 UI 问题
  2. SSH 连接到远程服务器,想用 Claude Code 或 Codex 分析这个问题
  3. 按 Cmd+V 想粘贴图片......但终端只能粘贴文本,图片丢失了
  4. 只能手动把图片上传到某处,复制 URL,再粘贴 URL

这个流程太繁琐了!尤其是在和 AI 助手交互时,图片输入的效率直接影响开发体验。

解决方案:VPaste

VPaste 是一个 Mac 本地工具,核心思路很简单:

截图在剪贴板 → 按 Cmd+Alt+V → CDN URL 直接"打"到光标位置

原来的 Cmd+V 粘贴图片功能完全保留,两个快捷键各司其职:

快捷键 功能
Cmd+V 正常粘贴剪贴板内容(图片/文本)
Cmd+Alt+V 上传图片,粘贴 CDN URL

技术实现

1. 快捷键监听

用 Swift 编写一个后台守护进程,通过 CGEventTap 监听全局键盘事件:

swift 复制代码
func eventTapCallback(proxy: CGEventTapProxy, type: CGEventType, 
                      event: CGEvent, refcon: UnsafeMutableRawPointer?) -> Unmanaged<CGEvent>? {
    if type == .keyDown {
        let keyCode = event.getIntegerValueField(.keyboardEventKeycode)
        let flags = event.flags
        
        // V = keyCode 9, Cmd + Alt
        if keyCode == 9 && flags.contains(.maskCommand) && flags.contains(.maskAlternate) {
            runVPaste()  // 异步执行上传
            return nil   // 消费事件,不传递
        }
    }
    return Unmanaged.passRetained(event)
}

2. 剪贴板图片读取

macOS 剪贴板中的图片默认是 TIFF 格式,需要转换成 PNG:

go 复制代码
// AppleScript 读取剪贴板图片
script := `
    set theImage to the clipboard as TIFF picture
    write theImage to file "/tmp/vpaste/image.png"
`

// sips 转换为真正的 PNG
exec.Command("sips", "-s", "format", "png", tempPath, "--out", tempPath).Run()

3. 上传到 COS

使用腾讯云 COS SDK 上传,生成带日期路径的文件名:

go 复制代码
func (c *COSClient) UploadFile(ctx context.Context, filePath string) (string, error) {
    key := fmt.Sprintf("vpaste/temp/%s/%s.png", 
        time.Now().Format("2006/01/02"), filename)
    
    client.Object.Put(ctx, key, reader, opt)
    
    return fmt.Sprintf("https://%s/%s", c.cdnDomain, key), nil
}

4. URL 输入到光标位置

不是用键盘模拟逐字输入(会被输入法干扰),而是:

  1. 把 URL 写入剪贴板
  2. 模拟 Cmd+V 粘贴
swift 复制代码
func pasteURL(_ url: String) {
    let pasteboard = NSPasteboard.general
    pasteboard.clearContents()
    pasteboard.setString(url, forType: .string)
    
    // 模拟 Cmd+V
    let cmdDown = CGEvent(keyboardEventSource: source, virtualKey: 0x37, keyDown: true)
    let vDown = CGEvent(keyboardEventSource: source, virtualKey: 0x09, keyDown: true)
    vDown?.flags = .maskCommand
    // ... post events
}

安装使用

bash 复制代码
# 克隆仓库
git clone https://github.com/talkcozy/vpaste.git
cd vpaste

# 一键安装
./install.sh

配置你的 COS 凭证:

yaml 复制代码
# ~/.config/vpaste/config.yaml
secret_id: "your_cos_secret_id"
secret_key: "your_cos_secret_key"
bucket: "your-bucket-1234567890"
region: "ap-shanghai"
cdn_domain: "cdn.your-domain.com"
upload_path: "vpaste/temp"

首次使用需要授予辅助功能权限(用于监听全局快捷键)。

设计哲学

  1. 最小改动 :不改变原有的 Cmd+V 行为,新增独立快捷键
  2. 零感知:后台守护进程自动启动,无需手动操作
  3. 即刻可用:URL 直接出现在光标位置,不需要额外复制
  4. 云端销毁:可配置 COS 生命周期规则,自动清理临时图片

适配场景

  • ✅ SSH 终端远程开发
  • ✅ Claude Code / Codex AI 助手交互
  • ✅ 浏览器地址栏、搜索框
  • ✅ 任何支持文本输入的地方

开源

项目已在 GitHub 开源:github.com/talkcozy/vp...

MIT License,欢迎 Star、Fork、PR!

相关推荐
AI算力2 小时前
让安全驾驶有“AI”相伴|腾视科技DMS视频监控一体机,守护每一次出行
人工智能·科技·ai·车载终端·ai算力·车载智能终端·车载dvr
泯泷3 小时前
超越基准:Claude Opus 4.5 的 4 个惊人洞察
人工智能
果果软件3 小时前
2026 后台管理系统选型:若依、JeecgBoot、芋道、NocoBase 和 GewuMind Boot 怎么选?
java·人工智能·后端·ai·开源
Csvn3 小时前
刚开始用 WorkBuddy,第一步该做什么?
人工智能
一水鉴天3 小时前
同一与唯一:AppBus 外壳与 DevOps 内核 之1 20261121(元宝)
人工智能·机器学习
Wellijohn4 小时前
一个 Android 老兵的十年开源路:从 167 star 的滑动控件,到本地优先的 AI Agent
android·人工智能·开源
ZONGYUAN-ROOT4 小时前
【API配额】API 配额监控告警不生效?用 Python 监控读数变化量,抓住静态阈值漏掉的「假重置」
人工智能
Wellijohn4 小时前
我把公司内部的 12 个 CRUD 接口交给了 AI Agent,然后省出了两周
人工智能·python·mcp
伞伞悦读6 小时前
【第92期】逻辑回归的分数概率与阈值的实验与排查
人工智能·python·深度学习·机器学习