CrossPaste：跨设备端到端加密剪贴板同步工具
CrossPaste 是一款面向 macOS、Windows 与 Linux 的跨设备剪贴板同步应用：基于局域网、无需云端服务器，采用非对称加密的端到端加密，支持文本、颜色、URL、HTML、RTF、图片与文件等多种剪贴板类型，并内置本地 OCR、MCP Server、Chrome 扩展与命令行工具。
社区作者 · zZz
它解决什么问题
CrossPaste 的定位是「Universal Pasteboard Across Devices」——在任意设备上复制，在任意设备上粘贴。项目由 CrossPaste 组织在 GitHub 上开源，主页提供官网、Wiki、下载页与视频入口，并支持简体中文界面（配图 1 为其宣传海报）。
核心特性（来源页面「✨ Features」列出）：
- 🔄 实时共享：剪贴板内容在设备之间即时同步。
- 🖥️ 统一跨平台：Mac、Windows、Linux 上界面一致，无需改变使用习惯。
- 📋 丰富类型支持：文本、颜色、URL、HTML、RTF、图片、文件。
- 🔒 端到端加密：使用非对称加密保护数据安全。
- 🌐 仅局域网、无服务器架构：本地存储，隐私掌控在自己手中。
- 🧹 智能空间管理：自动清理选项，无需手动维护剪贴板存储。
- 🔍 内置 OCR：在本地从图片中提取文字，不发起网络请求，截图不会离开设备。
- 🤖 MCP Server：通过 Model Context Protocol 把剪贴板历史暴露给 Claude 等 AI 助手。
- 🌍 Chrome 扩展：与浏览器同步剪贴板，在网页上复制、在任意设备粘贴。
- ⌨️ 命令行：可在终端与脚本中复制、粘贴、搜索历史记录，详见 CLI 指南。
开发与构建：仓库提供 Gradle 构建流程，首次运行会下载 JBR / Gradle 依赖；Chrome 扩展位于 web/ 目录并由 Gradle 构建，需要 Node.js（>= 18）。
路线图：v2.2 已带来完整命令行模式（在终端中复制、粘贴、搜索历史），后续计划包括插件系统，让社区以自定义粘贴类型和集成扩展 CrossPaste；更多长期规划见项目完整路线图。
社区与支持：页面提供 FAQ 汇总，并鼓励通过 Star 仓库、在 issue tracker 报告 bug、参与翻译、提交代码或评论 issue、以及通过 GitHub Sponsors 赞助等方式支持项目。README 末尾列出贡献者头像（对应配图 2 至配图 10）与赞助者。
说明：来源正文未给出软件许可证、适配的系统版本号或硬件最低要求，这些信息需在仓库许可证文件与发布页中进一步核验。
— 本文由 AI 根据公开来源辅助整理，命令、版本与许可证请在使用前到原始页面复核。
安装 / 开始使用
以下步骤来自 README 的「Getting Started with Development」与「Building the Chrome Extension」章节，按原文顺序整理。
一、准备环境
Git（用于克隆仓库）。
- JDK / JBR：无需手动准备，首次运行 Gradle 任务时会自动下载 JBR 与 Gradle 依赖（需要可访问外网）。
- Node.js >= 18：仅在构建 Chrome 扩展时需要，首次构建时 npmInstall 任务会拉取依赖。
二、克隆仓库
- 克隆代码：
git clone https://github.com/CrossPaste/crosspaste-desktop.git三、编译并运行桌面应用
- 进入目录并运行：
cd crosspaste-desktop./gradlew app:run- 首次启动会下载 JBR / Gradle 依赖，请保持网络畅通并耐心等待。
四、常见问题与代理配置
FAILURE: Build failed with an exception.
java.net.SocketException: Connection reset > java.net.SocketException: Connection reset 则可能需要使用 VPN 才能下载这些依赖。
systemProp.https.proxyHost =localhost systemProp.https.proxyPort =8080 systemProp.https.proxyUser =userid systemProp.https.proxyPassword =password systemProp.http.nonProxyHosts =*.nonproxyrepos.com|localhost
- 如果出现如下错误：
- What went wrong:
- 为 Gradle 配置代理：在 gradle.properties 中加入以下设置，并按实际代理参数调整：
五、构建并加载 Chrome 扩展
- 构建扩展（扩展代码在 web/ 目录，通过 Gradle 构建）：
./gradlew :web:build构建产物（未打包扩展）输出到 web/dist/ 。
- 加载到 Chrome：
- 打开 chrome://extensions/ ；
- 打开右上角的「开发者模式」；
- 点击「加载已解压的扩展程序」，选择 web/dist/ 目录。
- 首次运行行为：扩展会自动发现同一台机器上运行的 CrossPaste 桌面应用，并与它同步剪贴板内容。
步骤 7 · 迭代开发扩展：在 web/ 目录中执行
npm run dev 获得快速的 Vite 开发循环，然后在 Chrome 中重新加载扩展。
- 关于 Kotlin/JS 核心库：扩展依赖由 ./gradlew :core:jsBrowserProductionLibraryDistribution 生成的 Kotlin/JS 核心库（该任务也是 :web:build 的一部分）；只要修改了 core/ 下的源码，就需要重新运行该任务。
六、其他
- 页面开头提供 Download 与 Wiki 链接，供获取正式版本与查阅文档；README 亦提供 CLI 指南链接用于命令行模式的复制、粘贴与历史搜索。
- 项目会持续发布 CrossPaste 相关技术博客（大约每周一篇），面向对跨平台应用开发感兴趣的读者。
