# 平台与能力兼容性

> 查找 Astravia Desktop、手机、远程项目和构建模式的支持边界。

Canonical page: /reference/compatibility



本文档描述当前实现的公开边界。具体下载包、构建租户和组织配置可能进一步缩小可见能力。安装后的设置页和下载页是最终判断。

## 平台矩阵 [#平台矩阵]

| 能力                        | Windows   | macOS     | Linux     | Android | iPhone         |
| ------------------------- | --------- | --------- | --------- | ------- | -------------- |
| Desktop 本地工作区和 Agent      | 支持        | 支持        | 支持        | —       | —              |
| Desktop 模型、MCP、知识库、批量和自动化 | 支持        | 支持        | 支持        | —       | —              |
| Desktop IM 网关             | 以当前网关制品为准 | 以当前网关制品为准 | 以当前网关制品为准 | —       | —              |
| SSH 远程项目                  | 支持        | 支持        | 支持        | —       | —              |
| 应用快照                      | —         | 支持        | —         | —       | —              |
| macOS 本机 iMessage         | —         | Beta      | —         | —       | —              |
| 手机配对并继续会话                 | 作为电脑端     | 作为电脑端     | 作为电脑端     | 支持      | 支持，需要 iOS 26 起 |
| 用连接码配对                    | 电脑端可生成    | 电脑端可生成    | 电脑端可生成    | 支持      | 支持             |
| 查看并操作电脑桌面                 | 作为被控端     | 作为被控端     | 作为被控端     | 支持      | —              |

手机行描述的是 Astravia 手机客户端。电脑三列表示这台 Desktop 能否作为配对和远程项目的一端。iPhone 可以扫码、用连接码，或在同一 Wi-Fi 里手动输入地址；它没有桌面画面。

## 构建模式 [#构建模式]

| 模式                 | 主要差异                                                          |
| ------------------ | ------------------------------------------------------------- |
| 开源 / serv-less     | 无 Astravia Serv 账户、订阅和远程模型目录；使用本地会话、BYOK 与内置的 Astravia 官方能力市场 |
| 商业 / Astravia Serv | 可包含登录、组织、订阅、官方 Marketplace 和远程模型目录                            |

两种模式都可以包含本地会话、插件、主题、IM 和知识库，但具体系统插件组合可能随构建 profile 和租户变化。开源版不要求登录。

## 状态含义 [#状态含义]

* **稳定入口**：普通用户可以按页面步骤使用，行为仍以当前发布版本为准。
* **Beta**：已经进入客户端或网关，但第三方依赖、平台条件或接口仍可能变化。
* **随版本变化**：已经是普通设置入口，但手机系统要求、连接码和桌面画面仍按平台区分。远程连接属于这一类，不再单独标成开发预览。
* **Internal-only**：不属于公开站点范围，不应通过猜测内部路径使用。

## 提交兼容性问题 [#提交兼容性问题]

报告平台问题时提供：

* Astravia 版本、构建来源和操作系统版本。手机问题同时提供手机系统版本。
* CPU 架构、是否使用代理或企业网络。
* 设置页是否显示目标入口，以及最后一个成功步骤。
* 已脱敏的原始错误、执行时间和最小复现步骤。

不要上传 API Key、OAuth Cookie、配对二维码、连接码、密码、Webhook URL、完整项目目录或未脱敏诊断包。涉及安全问题时，先阅读[安全与数据边界](/reference/security-and-data/)。