# 复制与粘贴

先在**这一台设备**上：复制一段内容 → **剪贴历史**里能看到对应记录。本页不做 [跨设备复制](/getting-started/first-cross-device-paste) 那套双机流程。

建议装完后先做本页，再去做跨设备，可以减少不必要的排障。

## 开始前

- 适合：刚装完要做第一次验证，或跨设备前先确认本机剪贴历史可用。  
- 你已完成 [安装](/getting-started/installation)。  
- 若系统弹出**剪贴板、通知或后台运行**等权限，请先**允许**；名称各端不同，**按应用内提示**处理即可。

## 操作步骤

:::steps
:::step{title="打开应用并确认剪贴板来源"}

**剪贴历史**一般默认即可用。本步只需确认：**剪贴来源 → 剪贴板 → 通用 → 启用来源** 已打开（这样复制才会写入历史）。各端文案可能略有出入，以应用内为准；开关含义与英文对照见 [剪贴来源：剪贴板](/features/source/clipboard)。

:::
:::step{title="复制测试文本"}

复制下面整段文本（用作唯一测试串）：

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

:::
:::step{title="查看剪贴历史"}

回到**剪贴历史**；若列表没有自动更新，**下拉刷新**或退出再进入历史页，找到 **octoclip-first-steps-001**，点进详情或预览，确认**内容与测试串一致**。
:::
:::

## 怎样算通过

:::tabs
:::tab{label="桌面端"}

复制后，短时间内能在剪贴历史中看到这条记录，且记录内容与测试串一致。

:::
:::tab{label="手机端"}

**第一次做本页验证时**：复制后**打开应用**查看历史，能看到这条记录，且记录内容与测试串一致即可。  
后台自动记录取决于机型与系统策略，详见 [剪贴记录预期](/getting-started/clipboard-record-expectations) 和 [剪贴板后台监听](/features/source/background-monitoring/)。
:::
:::

## 如果没有看到记录

依次确认：

1. **剪贴来源 → 剪贴板** 是否已打开 **启用来源**；同页的 **忽略敏感内容**、**忽略临时内容** 等是否把测试串挡在库外（英文界面名称对照见 [剪贴来源：剪贴板](/features/source/clipboard)）。  
2. 系统是否已允许本应用使用**剪贴板**（以及弹窗里要求的其它权限）。  
3. 是否配置了**历史过滤规则**把测试串挡掉。

若在 **Android** 或部分受系统限制的环境，只有**先打开应用**再复制，历史里才出现新记录，通常与**剪贴板后台监听**限制有关。需要「不盯着 App 也自动记」时，先读 [剪贴记录预期](/getting-started/clipboard-record-expectations)，再按需打开 [剪贴板后台监听](/features/source/background-monitoring/) 专题。

按上面做完仍不行，请进入 [首次使用排障](/getting-started/first-run-troubleshooting) 按现象继续查。

## 下一步

:::cards{cols=2}
:::card{title="跨设备复制" icon="lucide.copy" href="/getting-started/first-cross-device-paste"}
本机通过后，用最短路径验证两台设备之间的同步与粘贴。

:::
:::card{title="查看和使用剪贴历史" icon="lucide.history" href="/features/clip-history/overview"}
从记录复制、插入到输入框等实际操作。

:::
:::card{title="剪贴记录预期" icon="lucide.clipboard-list" href="/getting-started/clipboard-record-expectations"}
想弄清「是否必须打开 App 才记剪贴」或 Android 限制时阅读。

:::
:::card{title="遇到问题" icon="lucide.triangle-alert" href="/getting-started/first-run-troubleshooting"}
本机验证失败或历史记录异常时，从现象开始顺序排查。
:::
:::

## 仍未解决

先按 [首次使用排障](/getting-started/first-run-troubleshooting) 做现象分流。需要他人协助时，请附上：

- 系统平台和版本
- 应用版本
- 具体失败现象（例如：历史里没有测试串 / 有记录但内容与复制不一致）
- 最短复现步骤（从「打开 App」到「复制 / 看历史」）
- 是否已按上文「如果没有看到记录」逐项检查过