Containers

Bun (thử nghiệm)

Bun là một môi trường chạy cục bộ tùy chọn để chạy TypeScript trực tiếp (bun run ..., bun --watch ...). Trình quản lý gói mặc định vẫn là pnpm, được hỗ trợ đầy đủ và được công cụ tài liệu sử dụng. Bun không thể sử dụng pnpm-lock.yaml và sẽ bỏ qua tệp này.

Cài đặt

  • Cài đặt phụ thuộc

    bun install
    

    bun.lock / bun.lockb được gitignore, nên sẽ không gây thay đổi trong repo. Để bỏ qua hoàn toàn việc ghi lockfile:

    bun install --no-save
    
  • Build và kiểm thử

    bun run build
    bun run vitest run
    
  • Tập lệnh vòng đời

    Bun chặn các tập lệnh vòng đời của phụ thuộc trừ khi được tin cậy rõ ràng. Với repo này, các tập lệnh thường bị chặn là không bắt buộc:

    • @whiskeysockets/baileys preinstall -- kiểm tra phiên bản chính của Node >= 20 (OpenClaw mặc định dùng Node 24 và vẫn hỗ trợ Node 22 LTS, hiện là 22.16+)
    • protobufjs postinstall -- phát ra cảnh báo về lược đồ phiên bản không tương thích (không có tạo tác build)

    Nếu gặp sự cố thời gian chạy cần các tập lệnh này, hãy tin cậy chúng rõ ràng:

    bun pm trust @whiskeysockets/baileys protobufjs
    

    Lưu ý

    Một số tập lệnh vẫn hardcode pnpm (ví dụ docs:build, ui:*, protocol:check). Hiện tại hãy chạy các tập lệnh đó qua pnpm.

    Liên quan