遇到问题
本页用于排查首次使用时最常见的失败：看不到同步内容、只能单向同步、历史里有记录但粘贴失败。按下面顺序检查，减少重复试错。
若你只在一台设备上验证剪贴历史、尚未做跨端，优先走 复制与粘贴；本页默认你已在做两台设备之间的同步或粘贴验证。
跨端「看不到对方剪贴」时，先在来源设备看剪贴历史里有没有这次复制：没有则多半是「没记下来」，不要先当成「同步坏了」再改同步方式。手机端常受前后台与系统规则限制；桌面也可对照下面「各端」Tab。想先看短说明可读 剪贴记录预期；已经出问题请从本页下文开始排查。
适合谁看
- 已按入门做过跨端或同步测试，但结果不符合预期的用户
- 不确定该先查「网络 / 同步方式」还是「单端权限 / 后台」的用户
先判断你的现象
| 现象 | 优先检查 |
|---|---|
| 设备互相看不到新剪贴 | 同步方式是否一致、设备在线状态、网络拦截；Android/iOS 对照下一节对应 Tab 是否「未写进历史」；桌面端一般先查网络、应用是否被挂起，macOS 再查 权限 |
| 只有一个方向失败 | 失败方向来源设备的权限与后台状态 |
| 历史中有记录但粘贴失败 | 目标应用粘贴限制、系统粘贴权限 |
| 同步延迟明显 | 网络质量、系统后台限制、是否在省电模式 |
一端附近同步、另一端云同步时，常表现为「完全看不到」或极不稳定。请先统一方式，再跑下方「按顺序检查」。
各端：后台监听与「像同步坏了」
跨端看不到新剪贴时，先确认来源端有没有把这次复制写进剪贴历史。若历史里根本没有，另一端同步也「等不到」——不一定是同步方式选错。下面按平台拆开看（和 剪贴板后台监听 专题一致，用 Tab 方便你只读常用端）。
剪贴板后台相关能力在正常安装与运行下通常默认可用，首次排障里较少出现「必须打开应用主界面才把复制写进历史」这类问题。若来源端是桌面却仍像「没同步」，多数仍应先按上文顺序查同步方式、网络与在线状态。
macOS 若涉及自动粘贴、输入监控或隐私弹窗，再对照 macOS 权限说明 与 跨平台差异。需要对照机制时读 剪贴板后台监听。
按顺序检查
确认两台设备都在运行
确保两端都能打开应用，并可进入剪贴历史页面。
确认两端使用同一种同步方式
两端都使用附近同步，或两端都使用云同步。不要一端附近同步、一端云同步。
做一次最小文本测试
在设备 A 复制：
octoclip-troubleshooting-001然后在设备 B 打开历史列表查找该文本。
排除网络与系统拦截
临时关闭 VPN/代理后复测；检查系统是否对应用施加后台限制或省电限制。
做反向测试
在设备 B 复制新文本，再到设备 A 查找，确认是单向问题还是双向问题。
常见修复动作
若上面步骤已定位大致方向，可展开下面对应项，按条做补充动作（与上文顺序检查配合，不替代上文）。
修复后如何验证
- 在设备 A 复制
octoclip-troubleshooting-001。 - 在设备 B 历史中看到该文本。
- 在设备 B 成功粘贴出相同文本。
- 反向测试也能成功（设备 B -> 设备 A）。
下一步
复制与粘贴
怀疑单端未写入历史时，回到本机最短验证。
跨设备复制
回到首次跨端任务页，按最短路径重做端到端验证。
剪贴板后台监听（平台专题）
理解「不打开 App 就不记剪贴」与后台限制，减少误判为同步坏了。
同步方式概览
仍不稳定时，对照场景是否选对了同步方式（概览页若较简，以应用内实际能力为准）。
常见问题
日常零散问法（快捷键、占用、历史不显示等）先扫条目与最短路径；首次双机同步/粘贴仍不对时以本页为主。
仍未解决
请反馈以下信息：
- 两台设备平台与系统版本
- 应用版本
- 使用的同步方式（附近同步 / 云同步）
- 网络环境（同一 Wi-Fi / 不同网络 / VPN / 代理 / 防火墙 / 公司网络）
- 失败方向（A -> B / B -> A / 双向）
- 内容类型（纯文字 / 图片 / 链接 / 文件等）
- 若涉及 Windows / macOS：应用是否常驻运行、是否有防火墙/安全软件拦截；macOS 是否已对照 权限说明
- 若涉及 Android：是否已配置剪贴板后台监听、是否试过「先打开 App 再复制」
- 若涉及 iOS：是否用过分享 / 快捷指令等替代路径
- 复现步骤（最短路径）
- 预期结果与实际结果