🌼 RAPS
Завантажити
Ця сторінка ще не перекладена українською. Показано англійську версію. Переглянути англійською

Контроль версій ресурсів

Відстеження версій 3D-ресурсів з організованим сховищем та порівнянням.

Огляд робочого процесу

Історія версій
assets/hero/v1.0/model.fbx
assets/hero/v1.1/model.fbx
assets/hero/v2.0/model.fbx
assets/hero/latest/model.fbx
Трансляції
SVF2 v1.0
SVF2 v1.1
SVF2 v2.0
Порівняння
Кількість полігонів
Кількість матеріалів
Розмір файлу

Підхід CLI

Крок 1: Завантаження з версією

ASSET_NAME="hero-character"
VERSION="v2.0"

# Upload versioned asset
raps object upload media-assets model.fbx --key "assets/${ASSET_NAME}/${VERSION}/model.fbx"

# Also update latest reference
raps object upload media-assets model.fbx --key "assets/${ASSET_NAME}/latest/model.fbx"

Крок 2: Перелік усіх версій

ASSET_NAME="hero-character"

# List all versions
raps object list media-assets --prefix "assets/${ASSET_NAME}/" --output json | \
  jq -r '.[] | .key' | sort -V

# Output:
# assets/hero-character/latest/model.fbx
# assets/hero-character/v1.0/model.fbx
# assets/hero-character/v1.1/model.fbx
# assets/hero-character/v2.0/model.fbx

Крок 3: Трансляція всіх версій

# Translate each version
raps object list media-assets --prefix "assets/${ASSET_NAME}/v" --output json | \
  jq -r '.[].key' | while read key; do
    URN=$(raps object urn media-assets "$key" --output plain)
    raps translate start "$URN" --format svf2
    echo "Started translation: $key"
  done

# Wait for all
sleep 60

# Check status
raps object list media-assets --prefix "assets/${ASSET_NAME}/v" --output json | \
  jq -r '.[].key' | while read key; do
    URN=$(raps object urn media-assets "$key" --output plain)
    STATUS=$(raps translate manifest "$URN" 2>/dev/null | jq -r '.status // "pending"')
    echo "$key: $STATUS"
  done

Крок 4: Порівняння версій

V1_URN=$(raps object urn media-assets "assets/${ASSET_NAME}/v1.0/model.fbx" --output plain)
V2_URN=$(raps object urn media-assets "assets/${ASSET_NAME}/v2.0/model.fbx" --output plain)

# Get metadata for comparison
raps derivative metadata "$V1_URN" --output json > v1-meta.json
raps derivative metadata "$V2_URN" --output json > v2-meta.json

# Compare
echo "Version Comparison: $ASSET_NAME"
echo "================================"
echo "v1.0 polygons: $(jq '.polygons // "N/A"' v1-meta.json)"
echo "v2.0 polygons: $(jq '.polygons // "N/A"' v2-meta.json)"

Конвеєр CI/CD

# .github/workflows/asset-versioning.yml
name: Asset Version Management

on:
  push:
    paths:
      - 'assets/**'
  workflow_dispatch:
    inputs:
      version_bump:
        description: 'Version type (patch, minor, major)'
        default: 'patch'

env:
  BUCKET: media-assets

jobs:
  version-assets:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
        with:
          fetch-depth: 0

      - name: Install RAPS
        run: cargo install raps

      - name: Determine version
        run: |
          # Get latest version tag or start at v1.0.0
          LATEST=$(git tag --sort=-v:refname | grep -E '^v[0-9]+\.[0-9]+\.[0-9]+$' | head -1 || echo "v0.0.0")

          IFS='.' read -r MAJOR MINOR PATCH <<< "${LATEST#v}"

          case "${{ inputs.version_bump }}" in
            major) MAJOR=$((MAJOR + 1)); MINOR=0; PATCH=0 ;;
            minor) MINOR=$((MINOR + 1)); PATCH=0 ;;
            patch) PATCH=$((PATCH + 1)) ;;
          esac

          VERSION="v${MAJOR}.${MINOR}.${PATCH}"
          echo "VERSION=$VERSION" >> $GITHUB_ENV

      - name: Upload versioned assets
        env:
          APS_CLIENT_ID: ${{ secrets.APS_CLIENT_ID }}
          APS_CLIENT_SECRET: ${{ secrets.APS_CLIENT_SECRET }}
        run: |
          for file in $(git diff --name-only HEAD~1 HEAD -- 'assets/**'); do
            [ -f "$file" ] || continue

            # Extract asset name from path (assets/NAME/file.ext)
            ASSET_NAME=$(echo "$file" | cut -d'/' -f2)
            FILENAME=$(basename "$file")

            # Upload versioned
            raps object upload "$BUCKET" "$file" --key "assets/${ASSET_NAME}/${VERSION}/${FILENAME}"

            # Upload as latest
            raps object upload "$BUCKET" "$file" --key "assets/${ASSET_NAME}/latest/${FILENAME}"

            echo "Uploaded: ${ASSET_NAME} as ${VERSION}"
          done

      - name: Translate new versions
        env:
          APS_CLIENT_ID: ${{ secrets.APS_CLIENT_ID }}
          APS_CLIENT_SECRET: ${{ secrets.APS_CLIENT_SECRET }}
        run: |
          for file in $(git diff --name-only HEAD~1 HEAD -- 'assets/**/*.fbx' 'assets/**/*.obj'); do
            [ -f "$file" ] || continue

            ASSET_NAME=$(echo "$file" | cut -d'/' -f2)
            FILENAME=$(basename "$file")

            URN=$(raps object urn "$BUCKET" "assets/${ASSET_NAME}/${VERSION}/${FILENAME}" --output plain)
            raps translate start "$URN" --format svf2 --wait
          done

      - name: Generate version report
        env:
          APS_CLIENT_ID: ${{ secrets.APS_CLIENT_ID }}
          APS_CLIENT_SECRET: ${{ secrets.APS_CLIENT_SECRET }}
        run: |
          echo "# Asset Version Report" > version-report.md
          echo "Version: $VERSION" >> version-report.md
          echo "Date: $(date)" >> version-report.md
          echo "" >> version-report.md

          echo "## Updated Assets" >> version-report.md
          git diff --name-only HEAD~1 HEAD -- 'assets/**' | while read file; do
            echo "- $file" >> version-report.md
          done

      - name: Tag release
        run: |
          git tag "$VERSION"
          git push origin "$VERSION"

      - name: Upload report
        uses: actions/upload-artifact@v4
        with:
          name: version-report-${{ env.VERSION }}
          path: version-report.md

Потік конвеєра

Git Push
Змінено ресурси
Версіонування
Обчислення версії
Завантаження v-X.Y.Z
Оновлення latest
Обробка
Трансляція
Генерація звіту
Реліз
Git-тег

Інтеграція MCP

Завантаження нової версії

User: "Upload the updated hero model as a new version"
Користувач
AI-асистент
RAPS MCP
APS Cloud
Користувач→AIЗавантажити як нову версію
AI→MCPaps_object_list(prefix=“assets/hero/v”)
MCP→APSПерелік версій
APS←MCPПоточні версії
AI→AIВизначення наступної версії (v2.1)
AI→MCPaps_object_upload(key=“assets/hero/v2.1/…”)
MCP→APSЗавантаження версіонованого
AI→MCPaps_object_upload(key=“assets/hero/latest/…”)
MCP→APSОновлення latest
AI→MCPaps_translate_start(urn)
MCP→APSТрансляція
AI→КористувачЗавантажено як v2.1

Відповідь AI:

Завантажено hero-character.fbx як версію v2.1:

Історія версій:

ВерсіяДатаПолігониРозмір
v2.116 лют 202448,00014.2 MB
v2.010 лют 202445,00012.8 MB
v1.11 лют 202442,00011.5 MB
v1.020 січ 202438,00010.2 MB

Зміни від v2.0:

  • Кількість полігонів: +3,000 (+6.7%)
  • Розмір файлу: +1.4 MB (+10.9%)

Порівняння версій

User: "Compare v1.0 and v2.0 of the hero character"

Відповідь AI:

Порівняння версій Hero Character:

Метрикаv1.0v2.0Зміна
Полігони38,00045,000+18.4%
Матеріали57+2
Кістки6065+5
Анімації46+2
Розмір файлу10.2 MB12.8 MB+25.5%

Основні зміни:

  • Додано лицьовий ріг (5 нових кісток)
  • Нові анімації “Run” та “Jump”
  • Вища деталізація рук та обличчя

Найкращі практики

Конвенція найменування

bucket/assets/
└── {asset-name}/
    ├── v1.0/
    │   └── model.fbx
    ├── v1.1/
    │   └── model.fbx
    ├── v2.0/
    │   └── model.fbx
    └── latest/
        └── model.fbx

Семантичне версіонування

v{MAJOR}.{MINOR}.{PATCH}

MAJOR: Несумісні зміни, повний редизайн
MINOR: Нові можливості, значні оновлення
PATCH: Виправлення помилок, незначні правки

Політика збереження

# Keep only last 5 versions
ASSET="hero-character"
VERSIONS=$(raps object list media-assets --prefix "assets/${ASSET}/v" --output json | \
  jq -r '.[].key' | grep -E '/v[0-9]+\.[0-9]+\.[0-9]+/' | sort -rV)

COUNT=0
echo "$VERSIONS" | while read key; do
  COUNT=$((COUNT + 1))
  if [ $COUNT -gt 5 ]; then
    echo "Deleting old version: $key"
    raps object delete media-assets "$key"
  fi
done

Пов’язане