# 排障概览

**本 Tab 的定位**：出问题时按症状修——与「快速开始」里跑通路径互补；与「平台与权限」里解释「为什么受限」互补。

## 从哪里开始

- **第一次成功路径卡住**（安装、双机、最小文本测试）：用 [首次使用排障](/getting-started/first-run-troubleshooting)（分步排查；本 Tab 内也有入口）。
- **已能日常使用，突然出现单一症状**：先按下面「最小测试」定位是哪一层，再进对应页。

## 先用最小测试定位是哪一层

排障的核心是分清三层：内容**没记下来**（采集）、记下了**传不过去**（传输）、传到了**粘不出来**（粘贴）。

:::steps
:::step{title="在来源设备复制一段唯一短文本"}

```text title="最小测试文本" noLineNumbers
octoclip-triage-001
```

:::
:::step{title="看来源端历史有没有"}

没有 → 采集层，去 [剪贴历史没有记录](/advanced/troubleshooting/clip-history-not-showing)。

:::
:::step{title="看目标端历史有没有"}

来源端有、目标端没有 → 传输层，去 [同步失败](/advanced/troubleshooting/sync-failed)。

:::
:::step{title="试着在目标端粘贴"}

目标端能看到却粘不出 → 粘贴层，去 [无法粘贴](/advanced/troubleshooting/cannot-paste)。
:::
:::

## 按症状

| 现象 | 页面 |
| --- | --- |
| 本机历史里看不到刚复制的内容 | [剪贴历史没有记录](/advanced/troubleshooting/clip-history-not-showing) |
| 复制时有时不记、锁屏或被杀后停止 | [后台监听不稳定](/advanced/troubleshooting/background-monitoring-unstable) |
| 本机有记录，另一台设备收不到 | [同步失败](/advanced/troubleshooting/sync-failed) |
| 附近同步找不到设备 | [设备发现失败](/advanced/troubleshooting/device-discovery-failed) |
| 历史里能看到，但粘不进目标应用 | [无法粘贴](/advanced/troubleshooting/cannot-paste) |
| 自动粘贴 / 后台监听 / 发现等疑似被系统权限拦住 | [权限问题](/advanced/troubleshooting/permission-issues) |
| 首次使用、还没跑通跨端 | [首次使用排障](/getting-started/first-run-troubleshooting) |

## 需要日志或网络信息时

提交反馈前如何收集日志与诊断信息，见 [日志与诊断](/advanced/troubleshooting/logging-and-diagnostics)。