Ugrás a fő tartalomra

🧪 Fejlesztői ág útmutatója

A dev ág tartalmazza a legújabb fejlesztéseket és kísérleti funkciókat a hivatalos kiadás előtt.

Kísérleti szoftver

A dev kísérleti, ezért hibákat, befejezetlen funkciókat vagy visszafelé nem kompatibilis változásokat tartalmazhat. Csak akkor használja, ha elfogadja az instabilitást és segíteni szeretne.

🎯 Mi a dev ág?​

Az új funkciókat a dev ágon teszteljük, mielőtt bekerülnek a stabil main ágba: új lehetőségek, javítások, felületi kísérletek és optimalizálások.

🚀 A dev ág használata​

Docker (ajánlott)​

A fejlesztői Compose-fájlok csatlakoztatják a Docker socketet, hogy a Work működjön. Linuxon előbb állítsa be a DOCKER_GID értéket a .env fájlban.

Külső Ollamával:

# 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

Egyszerű 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

Forrásból​

# 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

A Work tesztelése​

Indítsa el a Dockert, ellenőrizze a docker info és docker ps parancsot a backend felhasználójaként, futtassa az npm run dev parancsot, jelentkezzen be rendszergazdaként, majd válasszon eszközöket támogató modellt a Work felületen.

npm run test:work

A tesztek ellenőrzik a Docker-házirendet, az útvonalak elszigetelését, az életciklust, a kapacitást, valamint az OpenAI-, Anthropic- és Gemini-adaptereket. Lásd: Work.

🔄 Frissítés​

# 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

🐛 Hibát talált?​

Jelentés előtt​

Keressen a GitHub Issues között, próbálja ki a stabil main ágat, és ellenőrizze, hogy a hiba megismételhető.

Hibajelentés​

Nyissa meg a 🐛 Report a Bug on GitHub oldalt, és adja meg:

**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]

Git commit hash​

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

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

🏆 Hozzájárulás és elismerés​

Közreműködők elismerése​

A közreműködőket a CONTRIBUTORS.md tartja nyilván, és a kiadási megjegyzésekben és commitokban is szerepelnek.

Jelenlegi közreműködők​

Köztük van rob, jm és mások.

Kóddal is hozzájárulna?​

Készítsen forkot, hozzon létre ágat a git checkout -b feature/amazing-feature dev paranccsal, végezze el a módosítást, majd küldjön PR-t a dev ágra. Lásd az útmutatót és a közösségi chartát.

Pull request ellenőrzések​

Minden PR futtatja a Format & Lint munkafolyamatot formázással, linttel, TypeScripttel, package/regression tesztekkel és Playwrighttal. Sikertelenség esetén feltölti az eredményeket. Az Electron Dev Build ad hoc aláírással, hitelesítő adatok nélkül csomagolja a macOS-, Windows- és Linux-verziót. A Docker Build Test and Push registry-bejelentkezés, push és multiarch manifest nélkül épít amd64/arm64 image-et.

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

⚠️ Fontos megjegyzések​

Adatbiztonság​

  • A dev használata előtt készítsen biztonsági mentést.

  • A Work-fájlok külön libre-work-* kötetekben találhatók.

  • Használjon külön kötetet:

    # 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

Lehetséges problémák​

A visszafelé nem kompatibilis változások beállításmódosítást igényelhetnek, egyes funkciók befejezetlenek lehetnek, a teljesítmény és a felület pedig változhat.

Mikor használja a stabil verziót?​

Térjen vissza a main ágra, ha megbízhatóságra van szüksége:

# 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

🌟 Vegyen részt a közösségben​

Készen áll a Libre WebUI jövőjének alakítására? 🚀

Tesztelése, visszajelzése és hozzájárulása mindenki élményét javítja.