# 跨平台差异

各平台提供一致的核心体验，但部分能力受系统权限模型和接口限制影响会有差异。**iOS 与桌面差异最大**：没有与 Windows / macOS 相同的持续后台剪贴板监听模型，更多依赖前台、系统分享与快捷指令等路径。

## 核心能力差异

| 能力 | Windows | macOS | Android | iOS |
|------|---------|-------|---------|-----|
| 剪贴历史记录 | 支持 | 支持 | 支持 | 支持（新条目的可见性常受前台与触发路径影响） |
| 附近同步 | 支持 | 支持 | 支持 | 支持 |
| 云同步 | 支持 | 支持 | 支持 | 支持 |
| 系统级快捷粘贴链路 | 支持 | 有条件支持 | 有条件支持 | 受限（与桌面可编程全局快捷键不是同一模型） |
| 后台剪贴监控 | 支持 | 有条件支持 | 有条件支持 | 受限（无持续系统级后台监听；依赖前台/分享/快捷指令等） |

> [!INFO] 关于「有条件支持」与「受限」
> **有条件支持**：能力可用，但依赖额外权限、系统版本或前置配置。**受限**：系统策略下无法做到与桌面完全等价的能力，需要用替代路径完成同类目标。

## 分平台导读

:::tabs
:::tab{label="Windows"}

- 系统整合能力更完整，适合重度快捷键工作流。
- 推荐优先启用剪贴历史、附近同步和 Win+V 替换能力。

:::
:::tab{label="macOS"}

- 需要重点检查系统隐私权限（如输入监控、辅助功能）。
- 若遇到快捷键不生效，优先排查权限和冲突键位。

:::
:::tab{label="Android"}

- 功能受系统厂商策略影响较大，建议开启必要后台权限。
- 后台剪贴监听在 Android 10+ 需按机型选择 Shizuku / 无障碍 / Root 等实现方式。

:::
:::tab{label="iOS"}

- 剪贴板读取与后台策略最严格；先阅读 [iOS 平台说明](/advanced/ios/)。
- 「复制即记录」请配合分享、快捷指令或回到应用内触发；详见 [剪贴板后台监控](/features/source/background-monitoring/)。
:::
:::

## 安装来源差异：商店版本 vs 官网版本

除了 OS 层面的能力差异外，**同一平台上**章鱼速贴还可能存在**两种安装来源**：

- **商店版本**：通过应用商店（Google Play、App Store、Microsoft Store 等）下载安装，由商店推送更新、由商店账号管理。
- **官网版本**：直接从 [octoclip.app](https://octoclip.app) 下载安装包，由应用内自更新。

两者**核心功能完全一致**——同步逻辑、剪贴历史、快速输入、别名、收藏、数据存储都一样。差异仅来自应用商店的政策限制。

> [!INFO] 为什么会有这种差异
> 应用商店对部分权限和能力有严格的政策限制（例如读取短信、屏幕截图、系统级辅助功能、未签名插件等）。为了让商店版本能通过审核并持续上架，我们会在商店版本中**移除**这些受限能力；官网版本不受商店政策约束，可以保留它们。

### 当前各平台情况

| 平台 | 商店版本 | 官网版本 | 是否存在差异 |
|------|----------|----------|--------------|
| Android | Google Play | APK（octoclip.app） | **有**：见下文 |
| iOS / iPadOS | App Store | — | 仅商店版本 |
| macOS | App Store | 直接下载（规划中） | **规划中** |
| Windows | Microsoft Store | —（规划中） | 仅商店版本 |
| Linux | — | — | 规划中 |

### Android：当前差异

| 剪贴数据来源 / 能力 | 官网版本（APK） | 商店版本（Google Play） |
|----------------------|:---------------:|:------------------------:|
| 剪贴板来源（系统复制内容） | ✓ | ✓ |
| 通知来源 | ✓ | ✓ |
| 跨设备同步、剪贴历史、快速输入、别名、收藏 | ✓ | ✓ |
| 后台保活与无障碍服务 | ✓ | ✓ |
| **短信来源**（自动捕获短信内容作为剪贴条目） | ✓ | — |
| **截图来源**（从截图中提取内容作为剪贴条目） | ✓ | — |

> [!INFO] 为什么是这两项
> Google Play 对 `READ_SMS` 等短信权限与 `MediaProjection` 截图权限的用途审核非常严格，剪贴板工具类应用无法以这两个用途过审。为保证商店版本能持续上架，我们在商店版本中关闭了这两类来源。

### 如何识别当前安装的版本

打开应用 **设置 → 关于**，会标注「商店版本」或「官网版本」，并显示安装来源。

### 在两个版本之间切换

:::steps
:::step{title="确认当前版本来源"}

在 **设置 → 关于** 查看当前安装的版本。

:::
:::step{title="开启云同步再切换"}

本地剪贴历史与本地设置**不会**自动迁移，建议先开启云同步，避免数据丢失。

:::
:::step{title="卸载后从目标渠道重装"}

卸载已安装版本，再从目标渠道（应用商店或 octoclip.app）下载安装。
:::
:::

### 我应该选哪个？

:::tabs
:::tab{label="商店版本（推荐）"}

- 自动更新、商店账号管理
- 对绝大多数用户够用
- 跟随商店账号在新设备上方便重装

:::
:::tab{label="官网版本"}

适合需要使用商店版本中被移除的能力的用户：

- **Android**：需要短信验证码自动捕获、截图内容提取时
- **macOS**（规划中）：未来如果某些系统级能力仅在官网版本提供
:::
:::

## 排查顺序

:::steps
:::step{title="先看系统权限是否完整"}

权限不完整是大多数平台差异问题的根因。

:::
:::step{title="再看平台专属限制"}

确认是否受系统版本、厂商策略或网络环境影响；**iOS 优先核对是否在前台或已使用分享/快捷指令路径**。

:::
:::step{title="最后看应用设置"}

检查快捷键、同步范围和后台策略是否合理。
:::
:::

## 相关文档

:::cards{cols=2}
:::card{title="Windows 专属高级功能" icon="lucide.monitor" href="/advanced/windows/"}
查看 Windows 平台的专属能力与配置。

:::
:::card{title="Android 平台说明" icon="lucide.smartphone" href="/advanced/android/"}
后台方案与厂商差异导读。

:::
:::card{title="macOS 平台说明" icon="lucide.laptop" href="/advanced/macos/"}
权限与桌面级体验导读。

:::
:::card{title="iOS 平台说明" icon="lucide.smartphone" href="/advanced/ios/"}
前台、分享与系统限制导读。

:::
:::card{title="设置项总览" icon="lucide.sliders-horizontal" href="/advanced/settings"}
按平台特性回调参数。
:::
:::