# 跨设备复制

本指南将引导你完成一次完整的跨端复制粘贴闭环：在设备 A 上复制测试文本 -> 确认设备 B 的剪贴历史中收到该内容 -> 在设备 B 上成功粘贴。

进行本页测试前，请确保两台设备都已分别完成 [安装](/getting-started/installation) 与 [复制与粘贴](/getting-started/first-steps) 的本地验证。

## 开始之前

*   两台设备均已安装章鱼速贴，且能正常加载本地剪贴历史。
*   已选定 **附近同步** 或 **云同步** 作为传输链路。不确定如何选择请对照下表：

| 物理与网络情况 | 推荐同步方式 | 准备工作 |
|---|---|---|
| 设备在同一本地网络（如家或办公室 Wi-Fi） | **附近同步** | 两端进入「附近设备」进行配对 |
| 设备处于不同网络（如跨网络、蜂窝移动网络） | **云同步** | 两端配置相同的 WebDAV / S3 服务 |
| 无法确定网络条件 | 请阅读 [同步方式概览](/features/sync-overview) | - |

> [!WARNING] 不要混用同步路径
> 两台设备必须配置为**同一种**同步方式。如果一端使用附近同步，另一端配置云同步，则跨端同步将无法流通。

## 操作步骤

:::steps
:::step{title="前置状态确认"}

确认两端设备的同步开关均已开启，且使用的是同一种同步方式（已完成配对或已连接上同一个 WebDAV/S3 桶）。

:::
:::step{title="在设备 A 复制测试文本"}

请复制下方代码框中的这段唯一测试字符：

```text title="测试文本" noLineNumbers
octoclip-first-cross-device-001
```

:::
:::step{title="在设备 B 剪贴历史中确认"}

**成功标志：** 稍等数秒，打开设备 B 的章鱼速贴历史列表（iOS 端可下拉刷新历史），确认可以看到刚才在设备 A 复制的 `octoclip-first-cross-device-001` 文本条目。

:::
:::step{title="在设备 B 执行粘贴"}

在设备 B 上的任意文本输入框（如记事本、聊天窗口）中执行粘贴，确认贴出的内容与 A 复制的测试字符一字不差。
:::
:::

成功闭环后，你可以继续了解 [剪贴记录预期](/getting-started/clipboard-record-expectations) 或配置 [剪贴板后台监听](/features/source/background-monitoring/)。

## 如果测试失败，请检查

:::accordion{multiple}
:::item{label="设备 B 的历史记录里没有看到测试文本"}

1.  **VPN 或代理软件干扰（附近同步）：** 如果使用的是附近同步，VPN、网络代理或代理规则可能会拦截本地网络发现。请尝试在两端**暂时关闭 VPN** 后重新测试。
2.  **企业 Wi-Fi 与 AP 隔离：** 部分公司 Wi-Fi 或公共热点开启了“AP 隔离”机制，禁止局域网内设备互相通信。如受限，请切换到同一手机热点测试，或改用云同步。
3.  **设备系统时钟不一致（云同步）：** 云同步存储（特别是 AWS S3 或阿里云 OSS）对请求时间戳校验极严。如果其中一端设备的系统时间有偏差，会导致鉴权失败而无法同步，请在系统设置中**开启“自动设置时间”**。
4.  **未记入本地历史：** 确认设备 A 上复制测试文本后，A 本地的剪贴历史中是否出现了该卡片。如果没有，说明未成功采集。

:::
:::item{label="历史记录里有，但贴不出"}

1.  请尝试在最简单的纯文本框（如记事本）中测试粘贴。
2.  部分系统会弹窗拦截应用向外部粘贴的操作，请在系统权限中允许章鱼速贴访问/写入剪贴板。
3.  在设备 B 上双击该条历史卡片尝试强制重新复制，然后再粘贴。

:::
:::item{label="只能单向同步，反过来不行"}

1.  从接收端退回，检查不能发送数据的设备是否被系统冻结了后台进程（尤其是 Android / iOS）。
2.  确保两端的系统权限（剪贴板监听、自启动）全部处于允许状态。

:::
:::

## 相关排障文档

如果问题仍未解决，建议点击下方卡片进入专项排障指南：

:::cards{cols=2}
:::card{title="设备发现失败" icon="lucide.scan-search" href="/advanced/troubleshooting/device-discovery-failed"}
局域网内找不到对端设备时按此排查。

:::
:::card{title="同步失败排除" icon="lucide.refresh-cw" href="/advanced/troubleshooting/sync-failed"}
WebDAV/S3 凭据、网络鉴权或时钟问题导致的不通。
:::
:::

## 仍未解决

如果在参考上述步骤后仍无法实现同步，到社区发帖时请附上以下信息：

*   **设备 A 及 B 的系统与版本：** （如 A: Win 11, B: Android 13）
*   **同步方式：** （附近同步 / 云同步）
*   **网络环境：** （同一家庭 Wi-Fi / 公司网络 / VPN 开启 / 手机热点）
*   **故障方向：** （A 到 B 不通 / B 到 A 不通 / 双向均不通）