# 跨设备粘贴

跨设备粘贴是跨端体验的最终形态：在设备 A 复制，在设备 B 直接粘贴。

## 它依赖哪些能力

- 剪贴历史：负责记录复制结果。
- 附近同步或云同步：负责把剪贴发送到目标设备。
- 目标设备的粘贴入口：负责写入系统剪贴板或直接插入输入框。

## 标准操作流程

:::steps
:::step{title="在源设备复制内容"}

复制文本、图片或文件后，确认已进入剪贴历史。

:::
:::step{title="把剪贴同步到目标设备"}

同局域网优先用附近同步；跨网络场景使用云同步。

:::
:::step{title="在目标设备选择该条剪贴并粘贴"}

可通过快速输入窗口或历史列表完成写入与粘贴。
:::
:::

## 验证结果

- 目标设备能看到新同步的剪贴。
- 写入系统剪贴板后可在任意输入框粘贴。
- 多次测试后链路稳定，无明显延迟或丢失。

## 典型场景

:::accordion{multiple}
:::item{label="电脑到手机"}

在电脑复制链接，手机聊天窗口直接粘贴。

:::
:::item{label="手机到电脑"}

在手机复制验证码，电脑登录页面即时粘贴。

:::
:::item{label="工作机到私人设备"}

把临时说明或素材从工作设备转到个人设备继续处理。
:::
:::

## 排查思路

> [!INFO] 排查顺序建议
> 排查时先看“是否记录成功”，再看“是否同步成功”，最后看“是否写入剪贴板成功”。需要分步排查时，用 [排障概览](/advanced/troubleshooting/overview) 的最小测试定位是哪一层。

## 相关文档

:::cards{cols=2}
:::card{title="剪贴历史" icon="lucide.history" href="/features/clip-history/overview"}
先确认内容是否被可靠记录。

:::
:::card{title="同步能力" icon="lucide.radio-tower" href="/features/nearby-sync"}
再确认内容是否被送达目标设备。

:::
:::card{title="无法粘贴？" icon="lucide.wrench" href="/advanced/troubleshooting/cannot-paste"}
历史里有内容却粘不出来时按此排查。
:::
:::