Hop til hovedindhold

🧪 Vejledning til udviklingsgrenen

Grenen dev indeholder de nyeste forbedringer og eksperimentelle funktioner før den officielle udgivelse.

Eksperimentel software

dev er eksperimentel og kan indeholde fejl, ufuldstændige funktioner og inkompatible ændringer. Brug den kun, hvis du accepterer mulig ustabilitet og vil hjælpe med at forbedre Libre WebUI.

🎯 Hvad er dev-grenen?​

Nye funktioner testes i dev, før de flettes ind i den stabile main-gren. Den omfatter nye funktioner, fejlrettelser, UI-eksperimenter og ydelsesoptimeringer.

🚀 Brug dev-grenen​

Docker (anbefales)​

Udviklings-Compose monterer værtens Docker-socket så Work fungerer. På Linux angiver du først DOCKER_GID i .env.

Med ekstern 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

Enkel 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

Fra kildekode​

# 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

Test Work​

Start Docker, verificer docker info som backendanvændaren og at opgavescontainrar ses i docker ps, kør npm run dev, logga ind som administrator og vælg en værktøjskapabel model i Work.

npm run test:work

Testene verificerer den genererede Docker-policy, afgrænsning af stier, livscyklus, kapacitet og værktøjsadaptere til OpenAI, Anthropic og Gemini. Se Work: isolerede arbejdsområder.

🔄 Hold dig opdaterad​

# 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

🐛 Hittat et fejl?​

Føre rapportering​

Søk først blandt GitHub Issues, prova stabile main og sækerstæll at felet kan upprepas.

Rapportera fejl​

Rapportera et fejl på GitHub og ta med:

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

Hæmta commit-hash​

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

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

🏆 Bidrag og erkænnande​

Anerkendelse af bidragydere​

Bidragsgivare listas i CONTRIBUTORS.md, næmns i release notes, får medførfattarskap i commits og tack i annonser. Nuværende fællesskab omfatter rob, jm og fler.

Aktuella bidragydere​

Se den fuldstændige listan i CONTRIBUTORS.md.

Vill du bidra med kod?​

Hvis du vil bidrage med kode: fork repositoryet, opret en gren fra dev med git checkout -b feature/amazing-feature dev, foretag ændringen, og åbn en pull request mod dev. Se bidragsguiden og fællesskabscharteret.

Pull request-kontroller​

Alle pull requests kør Format & Lint med formatering, frontend-/backend-lint, TypeScript, pakke-, regression- og Playwright-test. Mislykkede browsertest indlæser resultaterne. Electron Dev Build pakker macOS, Windows og Linux; macOS bruger credentialfri ad hoc-signatur og får ikke Developer ID/notariseringsoplysninger. Docker Build Test and Push bygger amd64 og arm64 uden registry-login, push eller multiarch-manifest.

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

⚠️ Viktigt​

Datasækerhet​

  • Sikkerhedskopiér før byte til dev.

  • Work-filer ligger i separata libre-work-*-diskenheder og skal sækerhetskopieras separat.

  • Brug en separat diskenhed:

    # 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

Møjliga problem​

Inkompatibla ændringer kan kræve konfiguration, funktioner kan vara ufuldstændige, ydeevne varierer og UI kan ændres.

Når du bør bruge stabil version​

Byt tillbaka til main hvis du behøver stabilitet:

# 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

🌟 Delta​

Redo at forma Libre WebUI's fremtid? 🚀

Dine tests, din feedback og dine bidrag på dev-grenen forbedrer oplevelsen for alle brugere.