# 安装章鱼速贴

本页介绍如何在各平台完成章鱼速贴的安装、如何确认安装成功，以及在安装过程中遇到常见问题时该如何排查。

## 开始之前（系统要求）

为了保证功能正常运行，请确认你的设备符合以下最低系统要求：
*   **Windows：** Windows 10 (1809+) 或更高版本（64位）
*   **macOS：** macOS 11.0 (Big Sur) 或更高版本
*   **Android：** Android 8.0 或更高版本
*   **iOS / iPadOS：** iOS 15.0 或更高版本

> [!WARNING] 安全安装来源
> 请仅从 [官方下载页](https://octoclip.app/download) 及其跳转的官方应用商店安装，切勿使用第三方转载包或不明来源的安装文件，以防数据及系统安全风险。

若你准备尽快进行首次跨设备体验，**建议至少在两台设备上都完成安装**。

## 安装后确认步骤

:::steps
:::step{title="确认应用图标与入口"}

:::tabs
:::tab{label="Windows"}
启动后，在任务栏系统托盘（右下角）中确认可以看到章鱼速贴图标。
:::
:::tab{label="macOS"}
从「应用程序」打开后，在顶部系统菜单栏确认可以看到章鱼速贴图标。
:::
:::tab{label="Android"}
在桌面或应用抽屉中确认有章鱼速贴图标，并按系统提示授予通知及电池优化等权限。
:::
:::tab{label="iOS"}
在主屏幕或应用资源库中确认有章鱼速贴图标，首次打开时允许剪贴板访问权限。
:::
:::

:::
:::step{title="执行本地复制测试"}

在当前设备上复制任意一段简短文本（例如 `octoclip-test`）。

:::
:::step{title="确认卡片写入历史记录"}

**成功标志：** 打开章鱼速贴主界面（或 iOS 端打开应用/下拉刷新历史），确认刚才复制的文本已作为第一条纯文本卡片正常记录在剪贴历史列表中。
:::
:::

## 安装异常排查

:::accordion{multiple}
:::item{label="下载文件失败或损坏"}

请回到 [官方下载页](https://octoclip.app/download) 重新获取最新的安装包。如遇网络下载中断，切勿继续安装未下载完整的残留包。

:::
:::item{label="双击运行后无反应 / 无法启动"}

1. 先尝试重启设备。
2. 检查系统安全策略（例如 Windows SmartScreen、macOS 的安全性与隐私设置），确认已允许运行本应用。
3. 企业管理设备可能被组策略或杀毒软件拦截，请联系系统管理员或检查拦截日志。

:::
:::item{label="Android：官方 APK 安装被系统拦截"}

国内部分 Android 设备在直接安装 APK 时可能会弹出“未知来源”或“安全警告”。你需要在系统弹窗或系统设置中勾选“允许来自此来源的应用”后再重试；如官方渠道有提供，可优先通过系统应用商店安装。

:::
:::

## 下一步

:::cards{cols=2}
:::card{title="复制与粘贴" icon="lucide.play" href="/getting-started/first-steps"}
掌握在本机进行复制、编辑与粘贴的基本流程。

:::
:::card{title="跨设备复制" icon="lucide.copy" href="/getting-started/first-cross-device-paste"}
完成多端同步，进行首次跨设备粘贴验证。
:::
:::

## 仍未解决

如果在安装或首次确认时仍有异常，到社区反馈时请提供以下信息：

*   **系统平台和版本：** （如 Windows 11 23H2 / iOS 17.2）
*   **应用版本或包名：** 
*   **安装包来源：** （如官网直链 / App Store / 备用 APK）
*   **具体失败表现：** （如闪退 / 报损坏警告 / 复制不记录）