大家好最近我做了一个开源项目 ClipVault,解决了不同设备间粘贴板不通用的问题。
项目目前支持
windows -> windows
windows -> android
android -> android
苹果端正在努力开发中......
项目地址:
Release 下载:
如果你喜欢这个项目就请给我点个star吧
求求了ヾ(≧▽≦*)o
ps:新人作者有些地方做的不好谅解一下
它是做什么的?
ClipVault 是一个局域网剪贴板同步工具。
核心目标很简单:
在同一个 Wi-Fi / 局域网下,Windows 和 Android 之间复制文本、图片后,自动同步到对方的系统剪贴板。
不走公网,不需要服务器,不需要端口映射,也不需要把剪贴内容传到第三方云端。
目前支持什么?
当前版本已经实现:
- Windows 桌面端
- Android 客户端
- 局域网二维码配对
- 6 位配对码连接
- 文本同步
- PNG 图片同步
- 本地历史记录
- 设备管理
- Windows 托盘常驻
- Android 高级后台同步
- Android 无线调试 / USB ADB 辅助后台读取剪贴板
为什么想做这个?
我自己平时经常遇到这种场景:
- 电脑上复制一段文字,想立刻发到手机
- 手机上复制验证码、链接、地址,想直接到电脑用
- 不想每次都打开微信、QQ、文件传输助手
- 不想把剪贴板内容传到公网服务
- 不想用“应用内剪贴板”,而是希望直接写入系统剪贴板
所以 ClipVault 的设计目标不是再做一个单独的粘贴板列表,而是尽量做到:
复制以后,对方设备可以直接粘贴。
配对方式
目前有两种连接方式:
1. 二维码配对
电脑端或手机端生成二维码,另一台设备扫码后自动建立局域网连接。
二维码里包含设备 IP、端口、设备标识和校验信息,适合手机和电脑之间快速连接。
2. 6 位配对码
适合电脑和电脑之间,或者不方便扫码的时候使用。
配对码不是纯随机数,而是结合局域网 IP 最后一段和会话校验码生成,方便在同一网段内快速定位设备。
Android 后台同步
Android 10 以后,系统限制了后台读取剪贴板。
所以 ClipVault 做了一个高级后台同步方案:
- 前台服务保持同步进程
- 首次通过无线调试或 USB ADB 授权
- 授权后通过 ADB 辅助读取系统剪贴板
- 后续启动时会自动尝试回连
如果手机 ROM 杀后台比较严重,也建议手动打开:
- 通知权限
- 自启动
- 电池优化白名单
- 后台运行权限
- 精确闹钟
- 悬浮窗权限
技术栈
项目不是单一平台的原生项目,而是一个跨端工程:
- Windows / Linux 桌面端:Electron + Node.js + React
- Android:Capacitor + React UI + Kotlin
- iOS:Capacitor + React UI + Swift
目前主要完善的是 Windows 和 Android。
下载体验
GitHub Release:
里面已经放了:
- Windows 安装包
- Windows 免安装版
- Android APK
项目地址
项目刚开源,肯定还有很多地方可以继续优化,比如:
- 更多 Android ROM 的后台稳定性适配
- Linux / iOS 端完善
- 更漂亮的演示图和文档
- 自动化 Release 打包
- 更多剪贴板格式支持
如果你也有类似需求,欢迎试试。
也欢迎提 issue、PR 或建议。