企业官网建设流程全解析

Xime 是一款基于 Rime 引擎的开源安卓输入法，它内置的剪贴板同步能力，让你通过 WebDAV、ximed 或 S3 路线，在手机与电脑之间双向同步剪贴板内容：手机上复制一段文字，打开电脑端的输入框就能直接粘贴（前提是两端指向同一个同步文件）。本文带你从路线选择到日常使用，完整走一遍配置流程。

为什么手机和电脑的剪贴板无法自动同步？

• Android 与 Windows/macOS 的剪贴板各自封闭，系统层面没有互通通道；
• 主流输入法的云剪贴板依赖第三方账号体系，无法对接自有设备；
• Xime 的思路：把 WebDAV 服务器（或自建 ximed 服务）上的一个文件，作为剪贴板的"唯一真源"。手机把最新剪贴板推送到远端文件，其他设备在键盘弹出时从该文件拉取——无需注册云账号，数据落在自己的网盘或服务器里。

核心机制（对应同步引擎 ClipboardSyncBridge.kt）：

• 推送：本地剪贴板变化 → 立即上传远端current.json（按内容 hash 去重，且抑制"自写回声"，避免两台设备来回覆盖）；
• 拉取：应用启动时 + 每次键盘弹出时各触发一次（受"拉取最小间隔"节流），带 ETag 条件请求，远端无变化返回 304 不下载，省流量；
• 手动拉取：剪贴板面板工具栏有一个"同步"按钮，点一下立即拉取远端最新内容。

三条同步路线怎么选：WebDAV / ximed / S3

Xime 的剪贴板同步由插件承载，同一时间只有一个同步插件生效（单选激活），目前内置三条路线：

WebDAV 剪贴板同步：四步完成配置

这是最容易上手的路线，以坚果云为例：

1. 安装插件：设置 → 扩展商店，搜索"WebDAV 剪贴板同步"，安装并启用（插件源码见 plugins/webdav-clipboard-sync/）；
2. 打开总开关：设置 → 数据与同步 → 剪贴板 → 打开"剪贴板同步"；
3. 填写服务器信息：在剪贴板同步页按下面这张表填写；
4. 测试连接：点击"测试连接"，成功后即可开始复制粘贴。

键盘快捷面板里的"剪贴板"按钮可以打开剪贴板历史面板；同步开启后，面板工具栏会出现同步按钮（圆形刷新图标），点击即从远端拉取最新剪贴板。

ximed 路线：适合自托管用户

如果你已经部署了 ximed 服务端与客户端，选择这条路线：

1. 扩展商店安装并启用"ximed 剪贴板同步"插件；
2. 在配置页填入服务器地址（形如https://192.168.1.50:8080）、用户名、密码；
3. 测试连接通过后，手机剪贴板会推送到 ximed 服务的/api/clipboard端点，其他设备上的 ximed 客户端同样能读到。

注意：ximed 路线目前为纯文本同步；如果需要图片剪贴板跨设备，请选 WebDAV 或 S3（选择服务时，设置页会明确提示"该插件不支持图片同步（仅文本）"）。

图片剪贴板同步：手机复制图片，电脑直接粘贴

WebDAV 与 S3 路线支持图片同步，且是原图无损直传：

• 复制图片时，图片文件按clipboard/blobs/<内容hash>.<扩展名>上传，元数据写入current.json并引用它；
• 文件名即原图的 SHA-256 内容哈希：同一张图重复上传天然幂等，不会来回乒乓；
• 拉取端会先校验字节 hash 再落盘写回系统剪贴板，校验失败自动丢弃；
• 上传顺序固定"先图片、后 JSON"，绝不留下"有元数据、没图"的悬空条目。

常见问题 FAQ

Q：复制了内容，为什么另一边没同步？拉取只发生在"应用启动时 + 键盘弹出时"，并不做后台轮询。请在另一端打开任意输入框唤出键盘，或用剪贴板面板里的同步按钮手动拉取一次。

Q：日志里偶尔出现 HTTP 503？坚果云免费版限制每 30 分钟 600 次请求，超限返回 503。插件会自动退避（拉取约暂停 10 分钟、推送跳过 5 次后探测），解封后自动恢复，无需干预；也不建议把拉取间隔调到很小。

Q：复制密码会被同步吗？不会。Android 13+ 系统标记的"敏感剪贴板"（如密码管理器复制的内容）一律不采集、不同步。

Q：会互相覆盖我的剪贴板历史吗？不会。同步的只是最近一条内容（远端单文件覆盖语义），本地剪贴板历史（默认最多 1000 条）完整保留。

Q：安全吗？传输使用 Basic Auth，域名需用户在配置中显式授权后才允许联网，数据只存放在你自己的网盘 / 服务器上。

关键源码与文档

• WebDAV 同步插件（推送/拉取/ETag/限流退避）：plugins/webdav-clipboard-sync/main.ts
• ximed 同步插件：plugins/ximed-clipboard-sync/main.ts
• S3 同步插件：plugins/s3-clipboard-sync/main.ts
• 同步引擎（去重、回声抑制、拉取节流）：ClipboardSyncBridge.kt
• 剪贴板同步设置页：ClipboardSyncSettingsScreen.kt
• 图片剪贴板同步技术方案：docs/clipboard-image-plan.md

写在最后

Xime 剪贴板同步的精髓，是用自己网盘/服务器上的一个文件充当跨设备剪贴板中介：WebDAV 路线最省事（坚果云即可用），ximed 适合自托管玩家，S3 适合对象存储用户。配置一次后，"手机复制、电脑粘贴"从此成为日常——不注册账号、不过云端黑盒，数据始终在自己手里 ☁️