Μετάβαση στο κύριο περιεχόμενο

🧪 Οδηγός κλάδου ανάπτυξης

Ο κλάδος dev περιέχει τις νεότερες βελτιώσεις και πειραματικές λειτουργίες πριν την επίσημη έκδοση.

Πειραματικό λογισμικό

Ο dev είναι πειραματικός και μπορεί να έχει σφάλματα, ημιτελείς λειτουργίες ή breaking changes. Χρησιμοποιήστε τον μόνο αν αποδέχεστε αστάθεια και θέλετε να βοηθήσετε.

🎯 Τι είναι ο κλάδος dev;​

Νέες λειτουργίες δοκιμάζονται στο dev πριν συγχωνευθούν στο σταθερό main: λειτουργίες, fixes, UI experiments και βελτιστοποιήσεις.

🚀 Χρήση κλάδου dev​

Docker (συνιστάται)​

Τα development Compose files συνδέουν Docker socket ώστε το Work να λειτουργεί. Σε Linux ορίστε πρώτα DOCKER_GID στο .env.

Με εξωτερικό 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

Απλό 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

Από 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

Δοκιμή Work​

Ξεκινήστε Docker, ελέγξτε docker info και docker ps ως χρήστης backend, τρέξτε npm run dev, συνδεθείτε ως admin και επιλέξτε μοντέλο με εργαλεία στο Work.

npm run test:work

Οι δοκιμές επαληθεύουν Docker policy, path containment, lifecycle, capacity και adapters OpenAI, Anthropic, Gemini. Δείτε Work.

🔄 Ενημέρωση​

# 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

🐛 Βρήκατε σφάλμα;​

Πριν την αναφορά​

Ψάξτε GitHub Issues, δοκιμάστε το σταθερό main και επιβεβαιώστε επανάληψη.

Αναφορά σφάλματος​

🐛 Report a Bug on GitHub με:

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

🏆 Συνεισφορά και αναγνώριση​

Αναγνώριση συνεισφερόντων​

Οι συνεισφέροντες καταγράφονται στο CONTRIBUTORS.md, αναφέρονται σε release notes και commits.

Τρέχοντες συνεισφέροντες​

Περιλαμβάνονται rob, jm και άλλοι.

Θέλετε να συνεισφέρετε κώδικα;​

Κάντε fork, δημιουργήστε κλάδο με git checkout -b feature/amazing-feature dev, κάντε αλλαγή και PR προς dev. Δείτε οδηγίες και χάρτη κοινότητας.

Έλεγχοι pull request​

Κάθε PR τρέχει Format & Lint με format, lint, TypeScript, package/regression και Playwright. Αποτυχίες ανεβάζουν αποτελέσματα. Electron Dev Build πακετάρει macOS, Windows, Linux με ad hoc υπογραφή χωρίς credentials. Docker Build Test and Push χτίζει amd64/arm64 χωρίς registry login, push ή multiarch manifest.

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

⚠️ Σημαντικές σημειώσεις​

Ασφάλεια δεδομένων​

  • Κρατήστε backup πριν το dev.

  • Τα Work files είναι σε ξεχωριστά libre-work-* volumes.

  • Χρησιμοποιήστε ξεχωριστό 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

Πιθανά προβλήματα​

Breaking changes μπορεί να απαιτούν config, λειτουργίες να είναι ημιτελείς, απόδοση και UI να αλλάζουν.

Πότε να χρησιμοποιείτε stable​

Επιστρέψτε στο 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

🌟 Συμμετοχή στην κοινότητα​

Έτοιμοι να διαμορφώσετε το μέλλον του Libre WebUI; 🚀

Οι δοκιμές, η ανατροφοδότηση και η συνεισφορά σας βελτιώνουν την εμπειρία όλων.