# AI Studio SDK 下载

AI Studio SDK 用于在 Go 或 Python 应用中操作工作区范围内的 AI Studio 资源。当前提供官方离线压缩包供开发者下载和引入。

## 下载发布包

当前稳定版本为 `0.1.0`。Python SDK 与 Go SDK 均为跨平台设计，支持 Windows、macOS 和 Linux 环境：

| 语言 | 软件包 | 文件大小 | 运行要求 | 操作系统 | 下载链接 |
| :--- | :--- | :--- | :--- | :--- | :--- |
| **Python** | `moi-product-sdk-python-0.1.0.zip` | ~139 KB | Python >= 3.11 | Windows / macOS / Linux | [下载 Python SDK](../../../assets/downloads/moi-product-sdk-python-0.1.0.zip) |
| **Go** | `moi-product-sdk-go-0.1.0.zip` | ~300 KB | Go >= 1.25.7 | Windows / macOS / Linux | [下载 Go SDK](../../../assets/downloads/moi-product-sdk-go-0.1.0.zip) |

````{dropdown} 文件校验 (SHA-256)
下载完成后，可在终端校验文件完整性：

```bash
# macOS / Linux
shasum -a 256 moi-product-sdk-python-0.1.0.zip
shasum -a 256 moi-product-sdk-go-0.1.0.zip

# Windows (PowerShell)
Get-FileHash moi-product-sdk-python-0.1.0.zip -Algorithm SHA256
Get-FileHash moi-product-sdk-go-0.1.0.zip -Algorithm SHA256
```

各发布包官方 SHA-256：

- **Python SDK**：`650f938189af5d95531a35a111cb211c31664a6b5527644d45762ffbec6aedb9`
- **Go SDK**：`632a82b02a1cbf75154afdce260ea3b6d8c5fdeaf20736bce80acb3828bd7498`
````

## 解压与安装验证

:::::{tab-set}
:sync-group: sdk-language

::::{tab-item} Python
:sync: python

解压后，包内包含构建好的 `moi_product_sdk-0.1.0-py3-none-any.whl` 以及最小示例。在干净的虚拟环境中安装并验证：

```bash
unzip moi-product-sdk-python-0.1.0.zip -d moi-python-sdk
cd moi-python-sdk

# 创建并激活隔离环境
python3 -m venv .venv
source .venv/bin/activate  # Windows 用户运行 .venv\Scripts\activate

# 安装 wheel 包
pip install moi_product_sdk-0.1.0-py3-none-any.whl

# 验证安装是否成功
python3 -c "import moi_product_sdk as sdk; print(sdk.__name__, 'ready')"
```

::::

::::{tab-item} Go
:sync: go

解压后，包内包含 `go-sdk`、依赖的 `product-model`、预置好的 `go.work` 以及示例代码。无需配置外部远程私有模块代理，解压即可直接构建：

```bash
unzip moi-product-sdk-go-0.1.0.zip -d moi-go-sdk
cd moi-go-sdk

# 运行自带的示例程序验证依赖解析
go run ./examples/list_workspaces
```

::::

:::::

## 下一步

完成安装和本地验证后，请前往快速开始配置访问令牌并开始使用：

- [使用 SDK 连接工作区](../ai-studio/sdk.md)
- [按场景使用 SDK](../../sdk/ai-studio/index.md)
