Přeskočit na hlavní obsah

🧪 Průvodce vývojovou větví

Větev dev obsahuje nejnovější vylepšení a experimentální funkce ještě před oficiálním vydáním.

Experimentální software

Větev dev je experimentální a může obsahovat chyby, nehotové funkce či nekompatibilní změny. Používejte ji pouze tehdy, pokud snesete možnou nestabilitu a chcete pomoci Libre WebUI zlepšit.

🎯 Co je větev dev?​

Nové funkce se v dev testují před sloučením do stabilní větve main. Obsahuje nejnovější funkce, testované opravy, experimenty UI a výkonnostní optimalizace.

🚀 Jak větev dev používat​

Docker (doporučeno)​

Vývojové Compose soubory připojují Docker socket hostitele, takže Work funguje ve výchozím stavu. V Linuxu nejprve nastavte DOCKER_GID v .env.

S externí Ollama:

# Clone the repository
git clone https://github.com/libre-webui/libre-webui.git
cd libre-webui

# Switch to dev branch
git checkout dev

# Start the dev image with external Ollama
docker compose -f docker-compose.dev.external-ollama.yml up -d

Jednoduchý Docker:

# Use the dev branch image
docker run -d -p 3000:3001 -v libre-webui:/app/backend/data --name libre-webui-dev --restart always ghcr.io/libre-webui/libre-webui:dev

Ze zdrojů​

# Clone and switch to dev branch
git clone https://github.com/libre-webui/libre-webui.git
cd libre-webui
git checkout dev

# Install dependencies
npm install

# Start development server
npm run dev

Testování Work​

Spusťte Docker, ověřte docker info i docker ps pod stejným uživatelem jako backend, spusťte npm run dev, přihlaste se jako administrátor a ve Work zvolte model s nástroji.

npm run test:work

Testy ověřují Docker policy, omezení cest, životní cyklus, kapacitu a adaptéry nástrojů OpenAI, Anthropic a Gemini. Viz Work: izolované pracovní prostory.

🔄 Aktualizace​

# Update your local dev branch
git pull origin dev

# Refresh the dev Compose stack
docker compose -f docker-compose.dev.external-ollama.yml pull
docker compose -f docker-compose.dev.external-ollama.yml up -d

# Or restart simple Docker
docker pull ghcr.io/libre-webui/libre-webui:dev
docker stop libre-webui-dev && docker rm libre-webui-dev
docker run -d -p 3000:3001 -v libre-webui:/app/backend/data --name libre-webui-dev --restart always ghcr.io/libre-webui/libre-webui:dev

🐛 Našli jste chybu?​

Před nahlášením​

Prohledejte GitHub Issues, vyzkoušejte stabilní main a ověřte opakovatelnost.

Jak chybu nahlásit​

🐛 Nahlásit chybu na GitHubu s těmito údaji:

**Environment:**

- Branch: dev
- Version: [git commit hash or date]
- OS: [Windows/macOS/Linux]
- Browser: [Chrome/Firefox/Safari version]
- Setup: [Docker/Source/etc.]
- Docker: [version and whether `docker info` succeeds, for Work issues]
- Work model/provider: [exact route, when applicable]

**Bug Description:**
Clear description of what went wrong

**Steps to Reproduce:**

1. Go to...
2. Click on...
3. See error...

**Expected Behavior:**
What should have happened

**Actual Behavior:**
What actually happened

**Screenshots/Logs:**
[If applicable, add screenshots or error logs]

**Work Activity:**
[Relevant tool call/result or preview output, with secrets removed]

Získání hashe commitu​

# Find your current dev branch commit
git rev-parse HEAD

# Or get a short version
git rev-parse --short HEAD

🏆 Přispívání a uznání​

Uznání přispěvatelů​

Přispěvatelé jsou uvedeni v CONTRIBUTORS.md, zmiňováni v poznámkách k vydání, dostávají spoluautorství commitů a zvláštní poděkování.

Současní přispěvatelé​

Komunita zahrnuje rob, jm a další.

Chcete přispět kódem?​

Forkněte repository, vytvořte větev z dev pomocí git checkout -b feature/amazing-feature dev, proveďte změnu a otevřete pull request proti dev. Viz pokyny a komunitní charta.

Kontroly pull requestu​

Každý pull request spouští workflow Format & Lint s formátováním, lintem frontendu/backendu, TypeScriptem, balíčkovými, regresními a Playwright testy. Neúspěšné prohlížečové testy nahrají výsledky. Electron Dev Build balí macOS, Windows a Linux; macOS používá ad hoc podpis bez přihlašovacích údajů a nedostává Developer ID ani notarizaci. Docker Build Test and Push sestaví amd64 a arm64 bez přihlášení do registry, pushování či multiarch manifestu.

npm run format:check
npm run lint
npm run test:package
npm run test:e2e

⚠️ Důležité poznámky​

Bezpečnost dat​

  • Před přechodem na dev data zálohujte.

  • Soubory Work jsou v oddělených volumes libre-work-*; zálohujte je zvlášť.

  • Pro testování použijte samostatný volume:

    # Use different volume name for dev
    docker run -d -p 3000:3001 -v libre-webui-dev:/app/backend/data --name libre-webui-dev ghcr.io/libre-webui/libre-webui:dev

Možné problémy​

Nekompatibilní změny mohou vyžadovat novou konfiguraci, funkce nemusí být hotové, výkon se může měnit a UI se může chovat jinak.

Kdy použít stabilní verzi​

Při požadavku na spolehlivost se vraťte na main:

# Switch back to stable
git checkout main
docker compose -f docker-compose.external-ollama.yml pull
docker compose -f docker-compose.external-ollama.yml up -d

🌟 Připojte se ke komunitě​

Jste připraveni pomoci utvářet budoucnost Libre WebUI? 🚀

Vaše testy, zpětná vazba a příspěvky ve větvi dev přímo zlepšují prostředí pro všechny uživatele.