开发者

一切皆可脚本化。
一切皆可集成。

uVersion 提供完整的 CLI、有文档的 REST API，以及面向游戏开发常用 IDE 的原生插件。只要你用脚本编排流水线，我们就能接入。

CLI `uversion`

uversion.exe 二进制文件（约 6 MB）涵盖所有 VCS 操作，并提供可从任何脚本解析的 --json 输出。

凭据通过系统钥匙串与桌面客户端共享，无需重复登录。CDC 分块、zstd 压缩以及 .uversionignore 跟踪都与桌面客户端完全一致。

完整 CLI 参考 →

# Login + clone + checkin

$ uversion login https://team.uversion.io --username alex.dev

✓ Authenticated as alex.dev

$ uversion clone hero-rpg ./HeroRPG

Cloning to ./HeroRPG ...

✓ 8,432 files in 47s

$ uversion checkout Content/Characters/Hero.uasset

✓ Lock acquired

$ uversion checkin -m "Hero pose pass"

✓ Committed as 7f3a9b1

编辑器插件

原生集成到 Unreal 开发常用的 IDE 中。

Plugin Unreal Engine

已上线

内置于编辑器的 Source Control Provider。UE 5.6 及以上。以预编译二进制形式分发：桌面客户端会替你安装到项目中，并按 Unreal 版本和平台提示更新。无需解压 ZIP。

在 Content Browser 中 Checkout / Checkin / Revert
内置可视化 Blueprint diff
提交前校验，内置 10 条规则
修改时自动 Checkout
通过 Windows Credential Manager 自动登录
启动时 Reconcile（Content/ + Plugins/*/Content/）

文档 →

Plugin Rider

已上线

面向 JetBrains Rider 的 VCS 集成，Unreal 游戏开发的首选 IDE。

通过 VCS 菜单 Refresh / Update / Checkin / Revert
底层委托给 uversion CLI
按源码扩展名过滤（.cpp, .h, .cs, .uproject）
与桌面客户端共享认证

Plugin Visual Studio

Coming soon

面向继续使用微软 IDE 的 C++ 开发者的 Visual Studio 2022+ VCS 集成。与 Rider 插件功能相同，集成在 Team Explorer 菜单中。

Extension VS Code

Coming soon

VS Code 扩展，用于编写脚本、编辑配置以及撰写项目文档，无需离开编辑器。资源管理器中的状态图标，通过命令面板进行 checkout / checkin。

API REST

uVersion 服务器提供以 JWT 认证的 JSON HTTP API。客户端的所有操作（auth、repos、files、locks、comments、builds）都可通过 REST 使用。

POST /api/auth/login：获取 30 天有效的 JWT
POST /api/auth/refresh：无需重新输入密码即可刷新
GET /api/repositories：列出可访问的仓库
POST /api/files/{repo_id}/upload-chunks：分块二进制上传
POST /api/locks/{repo_id}/acquire：锁定文件
POST /api/builds/{repo_id}/upload：发布试玩版本

完整 API 参考 →

# 获取仓库列表

curl -X GET https://team.uversion.io/api/repositories \
  -H "Authorization: Bearer $UV_TOKEN"

# 响应

{
  "success": true,
  "data": [
    {
      "id": 12,
      "name": "hero-rpg",
      "owner": "acme",
      "current_revision": "7f3a9b1...",
      "file_count": 8432,
      "size_bytes": 14211938405
    }
  ]
}

CI/CD

uversion CLI 专为自动化流水线打造。--json 模式、标准返回码、无需重新输入密码即可续期的长效 JWT（30 天）。

# .github/workflows/build.yml

name: Nightly build
on:
  schedule: [{ cron: '0 2 * * *' }]
jobs:
  build:
    runs-on: [self-hosted, unreal]
    steps:
      - name: Login + sync from uVersion
        env:
          UV_SERVER: ${{ secrets.UV_SERVER }}
          UV_USER: ${{ secrets.UV_USER }}
          UV_PASSWORD: ${{ secrets.UV_PASSWORD }}
        run: |
          uversion login "$UV_SERVER" --username "$UV_USER" --password "$UV_PASSWORD" --json
          uversion clone hero-rpg ./project --json
          uversion sync --json
      - name: Build packaged client
        run: |
          ./project/Engine/Build/BatchFiles/RunUAT.bat \
            BuildCookRun -project=./project/HeroRPG.uproject \
            -clientconfig=Development -platform=Win64

可靠且快速

原生服务器二进制、轻量桌面客户端（几 MB，秒开）、面向大文件的大规模并行上传与下载。JWT 认证、按现代标准哈希的密码、对敏感操作的完整审计。服务器部署在你自己的基础设施上，采用自签名 TLS：客户端在首次连接时固定指纹（TOFU），用 uversion trust 在 CI 中脚本化信任。

深入文档。

阅读 wiki CLI 参考

一切皆可脚本化。一切皆可集成。

CLI uversion