CrossPaste 跨系统剪贴板配置：按发现、配对、同步逐层排查
CrossPaste 的桌面用法可以拆成三步：先在局域网发现设备，再建立信任关系，最后确认某种剪贴板内容能传递。遇到"一台复制，另一台没有"的情况，这三步要分别检查，否则很容易把网卡选择、设备方向和文件大小限制都误认为软件没启动。
本文以正式发行 2.2.1.2706 为版本基线，面向 Windows、macOS 和 Linux 桌面环境。目标是先完成两台电脑的文字双向同步，再验证图片或文件，不把跨地域连接和移动端部署纳入这套步骤。
选包与首次验证范围
本版本提供 Windows x64 的便携 ZIP、MSIX 以及配套安装辅助文件；macOS 分 aarch64 和 amd64 的 ZIP；Linux 有相应架构的 AppImage、DEB 与 tar.gz。先确定系统和处理器，名称里的 amd64 对应常见 x64 架构，并不是只供 AMD 处理器使用。
ZIP 与 MSIX 是两种不同的 Windows 分发方式。测试时固定使用一种方式，记录具体版本，避免一边检查便携版、一边打开另一份已安装的旧版。macOS 同样需要核对实际运行的是哪一份应用，不要只看下载文件名。
以旧版本号开头、带有 delta 后缀的是差分更新文件，不用于首次部署。Linux 选择 DEB 还是 AppImage，应对应自己的发行环境；不要把压缩包格式的存在理解成所有发行版都无需额外条件。
首轮测试建议只保留两台受信任的电脑，选择一个空白文本编辑窗口作为目标。暂时不要同时启用脚本、MCP 或额外浏览器扩展。这样观测对象只有设备连接与普通文字，后续增加能力时才容易判断哪项条件发生了变化。
第一层：附近设备是否出现
两台电脑都打开 CrossPaste 后，在设备页面查看附近列表。前提是两端所在的网络允许它们互相通信。来宾网络、客户端隔离、虚拟网卡和 VPN 都可能改变设备实际使用的网络路径。
多网卡机器先检查网络设置中的接口选择，对照本机实际连接的网络。下图里的接口名称和地址只用于理解界面，不能作为自己电脑的配置值照抄。
设备发现采用 DNS-SD/mDNS。附近列表一直为空时，除了确认服务发现没有关闭，还要检查防火墙及组播转发。官方常见问题提到的 UDP 5353 属于 mDNS 发现环节；即使这一环节正常，也不代表后面的应用通信一定正常，不宜把它当成唯一的连通性标准。
在 macOS 上，可用下面的命令观察发现广播。它是诊断命令，不是在终端里启动 CrossPaste 的替代方式：
sh
dns-sd -B _crosspasteService._tcpLinux 环境已具备 avahi-browse 时，可查看对应服务：
sh
avahi-browse -r _crosspasteService._tcp如果命令能看到设备而软件列表看不到，应记录两端版本、所用接口和列表状态。还要检查目标是否已经进入"我的设备"或黑名单：这类设备本来就不会继续作为新的附近设备展示，不能把列表消失直接判为离线。
排查时不要为了让设备出现而永久关闭所有安全软件。先辨认阻断的是发现流量还是应用通信，再按实际网络策略作最小调整。公司网络有既定访问限制时，应在允许的环境中验证，不绕过管理策略。
第二层：发现以后再建立信任
确认附近设备身份后，在设备旁选择添加，并在发起端输入目标端此时显示的配对码。当前配对流程使用轮换的六位 PIN；输入过期时看新的显示内容，不要反复提交保存下来的旧码。
配对成功后，给设备增加容易辨认的备注，并检查设备详情里的软件版本与发送、接收选项。可见设备、已经配对、允许某个同步方向，是三个不同的状态。只有一个方向工作时，先在这里核对，不要立即把所有设备删除重配。
旧版设备可能继续使用较早的配对流程，因此复现问题应同时记录双方版本。不能因为一端升级了，就把旧端界面上的不同提示都当成新版本故障。
第三层：用新文字完成双向测试
先在设备 A 新复制一段容易辨认的普通文本，在设备 B 的空白窗口粘贴；随后由 B 新复制另一段文本，让 A 接收。两段测试文字应不同，避免把目标应用原有的内容错认为刚收到的数据。
这轮测试要观察输入对象、活动窗口与粘贴结果。历史中能看到条目，只能说明某个记录环节有内容；目标软件能否按预期接收，还需要实际执行粘贴来确认。图片、富文本和文件应在普通文字通过之后分别增加。
还有一个常见误区：在历史列表里拷贝旧条目，只会应用到本机剪贴板，不会自动再次全量同步。需要重发旧内容时，使用条目右键菜单里的"同步到"，指定已经连接的设备。
图中的设备名是菜单示例。验证时选自己的目标，随后到接收端确认内容，不把"点过发送"当作已经传完的证据。
文字通过后，再检查文件和存储
图片或文件不能按预期到达时，先核对类型和大小限制。文件备份阈值决定是否留下文件备份，同步大小上限决定是否允许跨设备传输；这两项配置不能互相替代。历史里有文件名，也不能证明文件内容已保留或已发送。
2.2.1 重新组织了剪贴板设置，Recording、Sync、Storage 分别对应记录、同步与存储，大小限制集中到存储部分。旧教程把这些选项放在 Advanced 下，当前版应按新的分组查找。接收较大文件时还可以指定目标目录，留空则使用系统下载目录。
验证文件时，选择一个内容明确的小文件，分别核对接收位置、文件名称与能否打开，再逐渐增加大小。这样可以把基础传输与阈值影响分开，不用一上来就拿大型目录证明"全部文件支持"。
出现重名文件时也应观察实际落盘名称。这个版本修复了接收重名记录和重试截断已有文件的问题，但更新日志不等于任意环境下的零故障保证。重要文件仍应保有原件，故障报告则写清重现步骤与观察到的结果。
搜索是另一条验证线
同步稳定后，可以检查历史搜索是否符合自己的预期。空格分隔的多个词会一起匹配，内容类型和标签可以缩小范围。文件条目匹配文件名，不是检索文档正文；图片也不能默认按画面中的全部文字搜索。
需要图片里的字时，应先对图片条目执行提取文本，再检查识别结果。OCR 支持本地处理，但图片质量、字体和语言会影响结果，代码、路径及数字尤其需要对照原图。不能把识别流程存在，直接推导成识别准确率。
常用条目加标签以后不会按普通历史自动清理。用于整理片段时这很方便，但也需要考虑图片和文件的长期占用。临时历史、长期片段与正式资料备份，最好各有自己的保管方式。
保留一份能复现的结果
最终记录四项就足够有用：两端实际版本与系统、使用的网络接口、测试内容类型、在哪一步观察到差异。如果是旧条目没有送出，还要说明使用的是本机拷贝还是"同步到"。这些信息比一句"Win 和 Mac 不通"更能定位问题。
CrossPaste 还提供 CLI 和可选 MCP 服务，但它们不应该成为普通桌面同步的前置条件。先让两台电脑完成文字接力，再按自己的任务增加终端或 AI 集成，之后出现变化，也就有一条清楚的基线可以回查。