Trình hướng dẫn thiết lập

bun run setup là phương thức self-host được khuyến nghị cho các bản cài đặt cục bộ dựa trên Bun. Lệnh này cài đặt các phần phụ thuộc từ bun.lock trước khi nạp trình hướng dẫn, bao gồm cả trên bản clone mới. Trình hướng dẫn sẽ tạo .env, tạo một CRYPTO_SECRET, yêu cầu token bot Discord của bạn và cấu hình PostgreSQL. Lệnh này an toàn để chạy lại; các giá trị .env hiện có sẽ được giữ nguyên trừ khi bạn chọn cấu hình lại chúng.

Những thứ cần chuẩn bị sẵn

Bun để chạy bot và chính trình hướng dẫn.
Token bot Discord với các privileged intent GuildMembers, MessageContent và GuildPresences đã được bật.
PostgreSQL đã cài đặt. TomoriBot lưu trữ mọi thứ trong PostgreSQL. Bạn không cần thiết lập thủ công vì trình hướng dẫn sẽ thực hiện giúp bạn: hệ thống sẽ dùng PostgreSQL nếu bạn đã cài sẵn, hoặc chạy cho bạn trong Docker nếu chưa có. Chỉ cần đảm bảo một trong hai đã được cài đặt trước khi bắt đầu. TomoriBot tự động khởi tạo schema, seed dữ liệu, migration, pgcrypto và schema RAG khi khởi động lần đầu.

Lấy code

git clone https://github.com/Bredrumb/TomoriBot.git
cd TomoriBot

Chạy trình hướng dẫn

Chạy trình hướng dẫn thiết lập bằng:

bun run setup

Sau khi chạy lệnh, bạn sẽ chọn một trong hai phương thức:

Phương thức	Khi nào nên dùng	Tác vụ thực hiện
Full Install	Bạn muốn thiết lập được khuyến nghị cùng với các tiện ích bổ sung nhẹ.	Chạy Base Install, sau đó thử cài đặt các tiện ích bổ sung bên dưới.
Base Install	Bạn chỉ muốn bot tối thiểu có thể hoạt động.	Tạo/cấu hình `.env`, token Discord, PostgreSQL và các phần phụ thuộc.

Tiện ích bổ sung của Full Install

Full Install sẽ chạy Base Install trước, sau đó thử cài đặt các tiện ích bổ sung bên dưới. Nếu có tiện ích nào thất bại, hệ thống sẽ in lệnh hoặc hướng dẫn để bạn hoàn tất thủ công và tiếp tục tiến trình:

Tiện ích bổ sung	Mục đích
`pgvector`	Tìm kiếm vector cho bộ nhớ tài liệu/RAG.
`pg_cron`	Tùy chọn dọn dẹp theo lịch trình cho các hàng cooldown/lời nhắc.
Tokenizer asset	Tokenizer asset cục bộ để tạo văn bản NovelAI và xử lý logit bias theo model.

Để cài đặt thủ công bất kỳ tiện ích nào trong số này, hãy xem tiện ích bổ sung trong Cài đặt thủ công.

Sau khi thiết lập

bun run dev                          # chỉ bot
bun run launch --searxng --crawl4ai  # bot + máy chủ cục bộ (xem bun run launch --help)

Khi bot đã trực tuyến, hãy chạy /setup trong Discord. Lệnh sẽ hướng dẫn bạn kết nối nhà cung cấp AI hoặc đến endpoint tùy chỉnh của bạn.

Cập nhật

Sử dụng lệnh cập nhật ưu tiên sao lưu: bun run update

Lệnh này chạy bun run backup, sau đó là git pull --rebase --autostash, rồi đến bun install --frozen-lockfile. Thêm --build nếu bạn chạy từ dist/, hoặc --docker cho bản triển khai Compose. Xem chi tiết đầy đủ trên trang Bảo trì và sao lưu.