Sari la conținutul principal

🧪 Ghidul ramurii de dezvoltare

Ramura dev conține cele mai noi îmbunătățiri și funcții experimentale înaintea lansării oficiale.

Software experimental

dev este experimental și poate conține erori, funcții neterminate sau breaking changes. Folosiți-l numai dacă acceptați instabilitatea și doriți să ajutați.

🎯 Ce este ramura dev?​

Funcțiile noi sunt testate în dev înainte de a fi combinate în ramura stabilă main: funcționalități, remedieri, experimente UI și optimizări.

🚀 Folosirea ramurii dev​

Docker (recomandat)​

Fișierele Compose de dezvoltare montează socket-ul Docker pentru ca Work să funcționeze. Pe Linux, setați mai întâi DOCKER_GID în .env.

Cu Ollama extern:

# 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

Docker simplu:

# 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

Din source​

# 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

Testarea Work​

Porniți Docker, verificați docker info și docker ps ca utilizatorul backend-ului, rulați npm run dev, autentificați-vă ca administrator și selectați în Work un model cu instrumente.

npm run test:work

Testele verifică politica Docker, izolarea căilor, ciclul de viață, capacitatea și adaptoarele OpenAI, Anthropic și Gemini. Consultați Work.

🔄 Actualizare​

# 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

🐛 Ați găsit o eroare?​

Înainte de raportare​

Căutați în GitHub Issues, testați ramura stabilă main și confirmați că problema se repetă.

Raportarea unei erori​

Deschideți 🐛 Report a Bug on GitHub și includeți:

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

Hash-ul commit-ului Git​

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

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

🏆 Contribuții și recunoaștere​

Recunoașterea contributorilor​

Contributorii sunt înregistrați în CONTRIBUTORS.md și menționați în notele de release și commit-uri.

Contributori actuali​

Printre ei se numără rob, jm și alții.

Doriți să contribuiți cu cod?​

Faceți fork, creați o ramură cu git checkout -b feature/amazing-feature dev, implementați schimbarea și trimiteți un PR către dev. Consultați instrucțiunile și Carta comunității.

Verificările pull request-urilor​

Fiecare PR rulează Format & Lint, care include formatare, lint, TypeScript, teste package/regression și Playwright. La eșec sunt încărcate rezultatele. Electron Dev Build împachetează macOS, Windows și Linux cu semnare ad hoc, fără credentials. Docker Build Test and Push construiește amd64/arm64 fără autentificare registry, push sau manifest multiarch.

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

⚠️ Observații importante​

Siguranța datelor​

  • Păstrați un backup înainte de a folosi dev.

  • Fișierele Work se află în volume separate libre-work-*.

  • Folosiți un volum separat:

    # 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

Probleme posibile​

Breaking changes pot necesita modificarea configurației, unele funcții pot fi incomplete, iar performanța și UI-ul se pot schimba.

Când să folosiți versiunea stabilă​

Reveniți la main când aveți nevoie de fiabilitate:

# 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

🌟 Participați la comunitate​

Sunteți gata să modelați viitorul Libre WebUI? 🚀

Testarea, feedback-ul și contribuțiile dumneavoastră îmbunătățesc experiența tuturor.