# 常见问题

如果你在安装、[复制与粘贴](/getting-started/first-steps) 或日常使用中遇到问题，先从下面「快速检查」或「常见问题列表」开始排查。每个问题都按「先做什么」给出最短路径。

> [!INFO] 第一次跨设备就失败
> 不要只用下面零散条目代替完整排查：请直接打开 [首次使用排障](/getting-started/first-run-troubleshooting)，按现象表与顺序步骤做完，再回到本页挑相关问答。

## 快速检查

:::steps{collapsible}
:::step{title="确认应用已更新到较新版本"}
旧版本可能缺少兼容性修复，建议先升级后复测。
:::
:::step{title="确认关键权限完整"}
若缺少关键权限，复制记录、快捷键或后台能力都可能异常。
:::
:::step{title="重启应用并复测"}
很多临时状态问题可通过重启应用或系统恢复。
:::
:::

## 常见问题列表

:::accordion{multiple}
:::item{label="为什么复制后没有出现在历史记录中？"}
先做这 3 步：

1. 检查剪贴历史开关是否开启。  
2. 检查系统是否已授予读取剪贴板权限。  
3. 检查是否配置了过滤规则导致该内容被忽略。

继续排查：[第一层：来源端是否记下了](/advanced/troubleshooting/sync-failed#第一层来源端是否记下了)
:::
:::item{label="为什么跨设备同步不稳定？"}
**若是第一次在双机间验证同步/粘贴**，请先按 [首次使用排障](/getting-started/first-run-troubleshooting) 做完现象分流与最小文本测试，再回来看下面 3 步。

先做这 3 步：

1. 确认两台设备都在线且应用在运行。  
2. 确认两端启用的是同一种同步方式。  
3. 先用唯一文本做一次最小复现（如 `octoclip-sync-test-001`）。

继续排查：[第二层：内容是否传得过去](/advanced/troubleshooting/sync-failed#第二层内容是否传得过去)
:::
:::item{label="为什么快捷键没有响应？"}
先做这 3 步：

1. 检查当前快捷键是否与系统或其他软件冲突。  
2. 临时改为一个未占用组合键并重试。  
3. 重启应用后再次测试快捷键触发。

继续排查：[第三层：传到了但粘不出来](/advanced/troubleshooting/sync-failed#第三层传到了但粘不出来)
:::
:::item{label="为什么应用启动后占用资源变高？"}
先做这 3 步：

1. 降低历史容量并观察变化.  
2. 暂时关闭不常用功能开关后复测。  
3. 对比空闲状态与高频复制状态下的资源占用。

继续排查：[性能调优指南](/advanced/performance)
:::
:::

## 仍未解决

反馈时请尽量附带以下信息，便于排查：

- 设备平台与系统版本
- 应用版本
- 复现步骤（最短可复现路径）
- 预期结果与实际结果
- 关键截图或录屏（如有）

你也可以继续查看 [设置项总览](/advanced/settings) 获取更细粒度的配置说明。