Chuyển tới nội dung chính

🧪 Hướng dẫn nhánh phát triển

Nhánh dev chứa các cải tiến và tính năng thử nghiệm trước khi vào main.

Phần mềm thử nghiệm

Nhánh dev có thể chứa lỗi, tính năng chưa hoàn chỉnh hoặc thay đổi phá vỡ tương thích.

🎯 Nhánh Dev là gì?​

  • Tính năng mới
  • Sửa lỗi đang kiểm tra
  • Cải tiến giao diện
  • Tối ưu hiệu năng

🚀 Dùng nhánh Dev​

Docker (khuyến nghị)​

Compose gắn socket Docker host để Work hoạt động. Trên Linux đặt DOCKER_GID trong .env; xác nhận vùng chứa bằng docker ps.

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

Từ mã nguồn​

# 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

Kiểm tra Work​

  1. Xác nhận docker info.
  2. Chạy npm run dev.
  3. Đăng nhập quản trị viên.
  4. Chọn mô hình có công cụ.
npm run test:work

Xem Work để biết ranh giới đầy đủ.

🔄 Cập nhật​

# 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

🐛 Báo lỗi​

Trước khi báo​

  1. Tìm GitHub Issues.
  2. Thử bản ổn định.
  3. Xác nhận tái hiện được.

Cách báo​

🐛 Báo lỗ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]

Lấy mã commit​

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

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

🏆 Đóng góp và ghi nhận​

Ghi nhận người đóng góp​

Người đóng góp hiện tại​

Đóng góp mã​

  1. Fork kho.
  2. git checkout -b feature/amazing-feature dev
  3. Thay đổi.
  4. Gửi Pull Request đến dev.

Xem hướng dẫn và Community Charter.

Kiểm tra Pull Request​

Format & Lint, Electron Dev Build, và Docker Build Test and Push kiểm tra định dạng, mã, kiểu, Playwright và image. Bản dựng không đẩy image hay nhận thông tin ký Developer ID.

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

⚠️ Lưu ý​

An toàn dữ liệu​

  • Sao lưu trước khi chuyển dev.
  • Volume Work libre-work-* cần sao lưu riêng.
  • Dùng volume riêng: 
    # 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

Vấn đề có thể xảy ra​

  • Thay đổi phá vỡ tương thích
  • Tính năng chưa hoàn chỉnh
  • Hiệu năng/giao diện thay đổi

Khi dùng bản ổn định​

Quay lại main khi cần độ tin cậy:

# 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

🌟 Cộng đồng​

Cảm ơn bạn đã thử nghiệm và đóng góp!