> ## Documentation Index
> Fetch the complete documentation index at: https://developers.uqpay.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 客户端发布

> 查看UQPAY SDK与CLI的当前版本、发布说明和版本规则。

通过本页查看各款UQPAY SDK与UQPAY CLI的当前稳定版本。

<Info>
  SDK和CLI版本独立于Gateway API文档版本。例如，SDK `2.1.x`与Gateway API文档`v1.6`没有版本号对应关系。
</Info>

<h2 id="current-stable-releases">
  当前稳定版本
</h2>

每个客户端都遵循语义化版本规则。它们的`PATCH`版本可能不同，请以表中对应客户端的版本为准。

| 客户端     | 当前稳定版   | 安装或下载                                                                            | 发布说明                                                                                              |
| ------- | ------- | -------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------- |
| Node.js | `2.1.0` | `npm install @uqpay/sdk@2.1.0`                                                   | [Node.js v2.1.0 Changelog](https://github.com/uqpay/uqpay-node/blob/v2.1.0/CHANGELOG.md#210)      |
| Python  | `2.1.0` | `pip install --upgrade uqpay==2.1.0`                                             | [Python v2.1.0 Changelog](https://github.com/uqpay/uqpay-sdk-python/blob/v2.1.0/CHANGELOG.md#210) |
| Go      | `2.1.0` | `go get github.com/uqpay/uqpay-sdk-go/v2@v2.1.0 && go mod tidy`                  | [Go v2.1.0 Release](https://github.com/uqpay/uqpay-sdk-go/releases/tag/v2.1.0)                    |
| Java    | `2.1.0` | [下载 v2.1.0 发布版 JAR](https://github.com/uqpay/uqpay-sdk-java/releases/tag/v2.1.0) | [Java v2.1.0 Release](https://github.com/uqpay/uqpay-sdk-java/releases/tag/v2.1.0)                |
| CLI     | `2.1.0` | `npm install -g @uqpay/cli@2.1.0`                                                | [CLI v2.1.0 Changelog](https://github.com/uqpay/uqpay-cli/blob/v2.1.0/CHANGELOG.md#210)           |

<Warning>
  Java SDK以thin JAR形式通过GitHub Releases分发，尚未发布到Maven Central。你的应用必须自行声明其运行时依赖。
</Warning>

<h2 id="release-history">
  发布历史
</h2>

<h3 id="sdk-and-cli-v210">
  SDK与CLI v2.1.0
</h3>

`2.1.0`允许`COMPANY`类型的Create SubAccount请求省略`ownership_details.representatives[].date_of_birth`。若提供该字段，其值仍须为`YYYY-MM-DD`格式的日期。`INDIVIDUAL`请求仍须提供`individual_info.date_of_birth`。

这是一项兼容性变更。现有集成如已传入有效的代表人出生日期，无需修改。API合同请参阅[2026-08-26平台更新日志](/zh/changelog#2026-08-26)。

<h3 id="sdk-and-cli-v200">
  SDK与CLI v2.0.0
</h3>

`2.0.0`为Node.js、Python、Go、Java和CLI增加了虚拟账户申请合同支持。Go的module与import path现使用`github.com/uqpay/uqpay-sdk-go/v2`。

升级命令和虚拟账户迁移路径请参阅[2026-09-03平台更新日志](/zh/changelog#2026-09-03)。

<h3 id="go-v121">
  Go v1.2.1
</h3>

Go `v1.2.1`增加了PGP授权决策支持。

本次SDK发布不改变Gateway API文档版本。详情请参阅[Go v1.2.1发布说明](https://github.com/uqpay/uqpay-sdk-go/releases/tag/v1.2.1)。

<h3 id="sdk-and-cli-v120">
  SDK与CLI v1.2.0
</h3>

`1.2.0`是Node.js、Python、Go、Java和CLI首次均提供`1.x`版本的发布。

升级命令、运行环境要求和原始公告请参阅[2026-08-04平台更新日志](/zh/changelog#2026-08-04)。

<h2 id="where-changes-are-recorded">
  各类变更记录的位置
</h2>

* 通过表中的发布说明链接查看某款SDK或CLI的具体变化。
* 通过[Platform与Gateway API更新日志](/zh/changelog)查看API、平台和文档变化。