# 版本兼容与制品说明

本页说明 MatrixOne Intelligence（MOI）平台版本、API 端点以及公开分发的 SDK 与 CLI 离线安装包之间的版本对应关系、已知差异和获取方式。

## 平台版本与服务端点

| 平台版本 | AI Studio API 端点 | Genesis 模型服务端点 | 说明 |
| --- | --- | --- | --- |
| **MOI 5.0 / 5.2.x**（当前） | `https://api.moi.matrixorigin.cn/v5` | `https://token.moi.matrixorigin.cn/v1` | AI Studio 使用 `X-API-Key`（配合 `X-Workspace-ID`）；Genesis 模型调用使用 `Authorization: Bearer`。私有部署请使用管理员提供的完整端点地址。 |

## 客户端与开发工具兼容矩阵

| 工具 / SDK | 当前公开离线制品基线 | 运行要求 | 能力覆盖与版本边界 | 获取与安装入口 |
| --- | --- | --- | --- | --- |
| **AI Studio Python SDK** | `0.1.0-r2`（`moi_product_sdk-0.1.0-py3-none-any.whl`） | Python >= 3.11 | 覆盖工作区、Catalog、工作流、连接器、知识库、智能体等既有产品 API；近期新增服务端能力（如部分 5.2.2 新接口）若未包含在离线包中，请向部署管理员获取匹配部署版本的安装包。 | [安装 AI Studio SDK](../developer/quickstart/downloads/ai-studio.md) |
| **AI Studio Go SDK** | `0.1.0-r2`（包内自带 `go.work` 工作区） | Go >= 1.25.7 | 离线包 `0.1.0-r2` 使用包内 `go.work` 连接 `go-sdk` 与模型子模块；后续 Go SDK 公开模块布局已收敛为单模块路径 `github.com/matrixorigin/moi-go-sdk`，如需使用最新接口请向部署管理员获取对应版本的 SDK 安装包。 | [安装 AI Studio SDK](../developer/quickstart/downloads/ai-studio.md) |
| **MOI-CLI** | `0.1.0`（`moi-cli-0.1.0-darwin-arm64.zip`） | macOS Apple Silicon（`darwin/arm64`） | 公开离线包仅包含既有命令及 `darwin-arm64` 架构；Linux、Windows、Intel Mac 或包含新增子命令的版本，请向部署管理员获取或通过配套客户端的 `astra update` 更新。 | [安装和更新 MOI-CLI](../developer/quickstart/downloads/cli.md) |
| **Genesis 模型客户端** | 社区标准 OpenAI / Anthropic SDK | Python / Node.js / Go 等标准环境 | 直接通过 Genesis API 地址与访问凭据调用，无需单独下载专用 SDK。 | [调用 Genesis 模型](../developer/quickstart/genesis/index.md) |

## MatrixOne 数据库引擎与配套组件

- **MatrixOne 数据库引擎**：MatrixOne 自身的版本发布记录、SQL 兼容性与内核变更由独立的 [MatrixOne 文档站](https://docs.matrixorigin.cn/mo/zh/) 维护；MOI 控制台内的数据库管理平台操作见[MatrixOne](../guides/matrixone/index.md)。
- **版本发布记录**：MOI 平台的功能上线、优化与修复按年归档在[发布声明](index.md)中，最新动态见 [MatrixOne Intelligence 2026 发布报告](2026.md)。
