Telegram bot token
Tạo bot bằng @BotFather và giữ lại token. Installer sẽ kiểm tra token trước khi lưu.
Admin Guide
Cài đặt, vận hành và khôi phục TAURIN
Trang này dành cho người triển khai TAURIN trên máy Ubuntu: chuẩn bị token, kiểm tra service, xem log, backup dữ liệu và cập nhật an toàn.
Yêu cầu trước khi cài
Chuẩn bị 4 thông tin
Telegram user ID
Lấy numeric user ID bằng @userinfobot. Bot chỉ nhận lệnh từ ID được cho phép.
Groq API key
Tạo API key tại console.groq.com. Installer sẽ gọi Groq để kiểm tra key.
Danh xưng
Cách TAURIN gọi người dùng trong chat, ví dụ `anh Ryan`, `chị Linh` hoặc tên riêng.
Cài đặt
Lệnh cài nhanh
Terminal
curl -sfL ./install.sh | sh -Trên website đã deploy, lệnh ở trang chủ sẽ tự thay `./install.sh` bằng URL public.
Vận hành
Các lệnh kiểm tra thường dùng
Mục đíchLệnhKết quả cần thấy
Kiểm tra service
systemctl --user status taurin --no-pager -lService ở trạng thái `active (running)`.Xem log gần nhất
journalctl --user -u taurin -n 100 --no-pagerLog bot, parser, scheduler và lỗi nếu có.Restart bot
systemctl --user restart taurinBot khởi động lại và nhận lệnh Telegram mới.Kiểm tra thư mục cài
ls ~/.local/share/taurinCó source, `venv`, `.env`, `config.yaml`, `data/`.Backup và restore
Dữ liệu người dùng phải được giữ riêng với source
Việc cần làmLệnh mẫuGhi chú
Backup dữ liệu
tar -czf taurin-data-backup.tgz -C ~/.local/share/taurin data .env config.yamlGiữ notes, tasks, reminders, inbox, config và secret key.Restore dữ liệu
tar -xzf taurin-data-backup.tgz -C ~/.local/share/taurinRestart service sau khi restore.Cập nhật source
curl -sfL ./install.sh | sh -Dùng URL installer public của bạn. Installer giữ lại `data/`, `.env`, `config.yaml`, `secrets/`.Gỡ service
systemctl --user disable --now taurinDừng bot trước khi quyết định giữ hay xóa dữ liệu.Tài liệu kỹ thuật
Dành cho người mở rộng action
1Action contract nằm trong `docs/action-contract.md`.
2Catalog action nằm trong `core/action_catalog.py`.
3Test report nội bộ nằm trong `docs/action-test-report.md`.
4Khi thêm action mới, cần thêm parser, catalog, executor, test và hướng dẫn người dùng.