Tài liệu hướng dẫn

#Windows

1. Bấm Tải về ở trang chủ, hoặc mở bản phát hành mới nhất và tải SillyTavernManager-windows-x64-vX.Y.Z-setup.exe.
2. Mở tệp cài đặt vừa tải. Nếu Windows SmartScreen cảnh báo ứng dụng lạ, bấm More info rồi bấm Run anyway.
3. Hoàn tất cài đặt. Bộ cài đặt vào %LOCALAPPDATA%\Programs\SillyTavernManager mà không đòi quyền quản trị viên, đồng thời tạo lối tắt ở Start Menu và Desktop.
4. Mở SillyTavern Manager. Cửa sổ ứng dụng sẽ mở thẳng vào bảng điều khiển quản lý.

Đóng cửa sổ sẽ thu ứng dụng xuống khay hệ thống (system tray) để SillyTavern và các link vẫn chạy nền, đồng thời thông báo trên màn hình sẽ báo cho bạn khi nhân vật trả lời xong. Bấm chuột phải vào biểu tượng ở khay hệ thống để mở lại trình quản lý, mở SillyTavern, mở thư mục dữ liệu, hoặc bấm Dừng & Thoát để tắt sạch SillyTavern và tunnel Cloudflare.

Muốn cập nhật, bấm Cập nhật trên thanh thông báo trong trình quản lý, hoặc tải bộ cài mới về rồi chạy đè lên bản cũ. Dữ liệu vẫn giữ nguyên.

#Android: ứng dụng

Cách dễ nhất trên điện thoại. Một ứng dụng chứa sẵn trình quản lý và mọi thứ SillyTavern cần, không cần Termux, không phải gõ lệnh nào. Chạy trên điện thoại Android 64-bit từ Android 7 trở lên, tức gần như mọi điện thoại bán ra từ năm 2017.

1. Mở trang chủ trên điện thoại và bấm Tải cho Android, hoặc tải SillyTavernManager-android-arm64-v8a-vX.Y.Z.apk từ bản phát hành mới nhất.
2. Mở tệp vừa tải. Android hỏi có cho trình duyệt cài ứng dụng không: cho phép, rồi bấm Cài đặt. Ứng dụng không có trên Play Store nên Play Protect có thể báo là ứng dụng lạ; chọn Vẫn cài đặt.
3. Mở ST Manager. Lần đầu mở, ứng dụng giải nén những gì nó mang theo, mất khoảng một phút.
4. Trên Android 13 trở lên, hãy cho phép thông báo khi được hỏi. Trình quản lý chạy nền kèm một thông báo cho biết nó đang chạy.
5. Đặt mật khẩu, chọn phiên bản SillyTavern rồi bấm Cài đặt. Nó tải vài trăm megabyte và mất vài phút; tắt màn hình cũng không sao.

Trình quản lý vẫn chạy khi bạn rời ứng dụng hay vuốt tắt nó, nên SillyTavern vẫn mở được từ thiết bị khác. Muốn dừng hẳn, bấm Dừng trên thông báo của nó.

Muốn cập nhật, tải APK mới rồi cài đè lên bản cũ. Dữ liệu vẫn giữ nguyên.

Chuyển sang từ Termux

Từng chạy SillyTavern trong Termux? Ở lần cài mới, trang tổng quan sẽ hỏi Bạn từng dùng SillyTavern trong Termux?; bấm Chuyển dữ liệu là chat, nhân vật và thiết lập được chép vào ứng dụng. Về sau, nút Chuyển từ Termux trên trang Dữ liệu làm đúng việc đó.

Trình chọn thư mục của Android mở ra: mở menu của nó, chọn Termux, chạm Sử dụng thư mục này, rồi Cho phép. Ứng dụng đọc SillyTavern trong đó và khôi phục vào đây. Termux vẫn y nguyên, còn những gì ứng dụng có trước đó được giữ thành một bản sao lưu tên Trước khi chuyển từ Termux, nên có thể hoàn tác.

Bong bóng chat

Khi nhân vật trả lời lúc bạn đang ở ứng dụng khác, ứng dụng có thể hiện câu trả lời thành bong bóng chat nổi bên trên, như ứng dụng nhắn tin; chạm vào là trả lời ngay tại đó. Trang tổng quan hỏi một lần (Nhận tin trả lời dạng bong bóng chat?), và chuông ở trên cùng bật tắt Bong bóng chat cùng Thông báo tin nhắn từ character bất cứ lúc nào. Bong bóng cần Android 11 trở lên; điện thoại cũ hơn nhận câu trả lời dưới dạng thông báo thường.

#Android: Termux

Muốn chạy bằng Termux? Cài Termux từ F-Droid hoặc một nguồn đáng tin khác. Đừng dùng bản Play Store cũ: bản đó lạc hậu nhiều năm và trình quản lý gói của nó không còn hoạt động.

Mở Termux, dán các lệnh sau rồi bấm Enter. Hai lệnh đầu cập nhật chính Termux, mất một hai phút; lệnh cuối tải những gì trình quản lý cần. Việc này chỉ làm một lần.

pkg update -y
pkg upgrade -y
pkg install -y git nodejs-lts
git clone https://github.com/locmaymo/stm.git
cd stm
npm ci

Lần đầu cập nhật, Termux sẽ dừng vài lần để hỏi nên làm gì với một tệp cấu hình (sources.list, bash.bashrc, profile, openssl.cnf), với dòng kết thúc bằng (Y/I/N/O/D/Z) [default=N] ?.

Cứ bấm Enter mỗi lần được hỏi. Như vậy là chọn mặc định N: giữ nguyên tệp bạn đang có. Đây là lựa chọn an toàn, không mất gì cả, và quá trình cập nhật chạy tiếp. Câu hỏi có thể hiện nhiều lần liên tiếp; cứ bấm Enter cho tới khi các lệnh chạy xong và dấu nhắc $ hiện lại.

Bật trình quản lý

Mỗi lần muốn dùng SillyTavern, mở Termux và chạy:

cd stm
npm start

Termux luôn mở ở thư mục chính, cũng là nơi stm đã được tải về, nên cd stm sẽ tìm thấy nó. Khi khung có các địa chỉ hiện ra, mở http://127.0.0.1:7860 trong trình duyệt của điện thoại. Địa chỉ thứ hai dành cho các thiết bị khác dùng chung Wi‑Fi.

Cập nhật trình quản lý

Dừng nó bằng Ctrl+C trước, rồi chạy:

cd stm
git pull
npm ci
npm start

#macOS: cài từ mã nguồn

macOS dùng chung launcher với Linux. Dán đoạn này vào Terminal; dòng đầu cài Homebrew, bỏ qua được nếu bạn đã có.

/bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)"
brew install git node
git clone https://github.com/locmaymo/stm.git
cd stm
npm ci
node deploy/linux/launcher.mjs

Mở http://127.0.0.1:7860. Dừng bằng Ctrl+C, và lần sau chạy lại bằng:

cd "$HOME/stm"
node deploy/linux/launcher.mjs

#Linux và VPS

Với Node.js 22 trở lên và git đã cài:

git clone https://github.com/locmaymo/stm.git
cd stm
npm ci
node deploy/linux/launcher.mjs

Dữ liệu vào $XDG_DATA_HOME/sillytavern-manager, hoặc ~/.local/share/sillytavern-manager khi biến đó chưa đặt.

Muốn nó tự chạy lại sau khi khởi động máy, lưu đoạn sau thành /etc/systemd/system/sillytavern-manager@.service:

[Unit]
Description=SillyTavern Manager
After=network-online.target

[Service]
Type=simple
User=%i
WorkingDirectory=/home/%i/stm
ExecStart=/usr/bin/node deploy/linux/launcher.mjs
Restart=on-failure
RestartSec=5

[Install]
WantedBy=multi-user.target

sudo systemctl daemon-reload
sudo systemctl enable --now sillytavern-manager@$USER
systemctl status sillytavern-manager@$USER

#Docker và nền tảng lưu trữ

Dựng image từ kho mã:

git clone https://github.com/locmaymo/stm.git
cd stm
docker build -f deploy/docker/Dockerfile -t sillytavern-manager .

Rồi chạy kèm lưu trữ bền:

docker run --rm \
  -p 7860:7860 \
  -v sillytavern-manager-data:/data \
  -e STM_ADMIN_PASSWORD='choose-a-long-password' \
  sillytavern-manager

Trình quản lý ở http://127.0.0.1:7860. SillyTavern vẫn nằm trên cổng nội bộ 8002 của container, và tunnel chỉ trỏ tới cổng truy cập 8001.

Trên nền tảng container thuê ngoài: mở cổng 7860, gắn lưu trữ bền vào /data, và đưa STM_ADMIN_PASSWORD qua phần secret của nền tảng.

#npm

Trên bất kỳ máy nào có Node.js 22 trở lên:

npx sillytavern-manager

Hoặc cài một lần rồi giữ lại:

npm install --global sillytavern-manager
sillytavern-manager

#Bản lưu cục bộ

Sao lưu ngay tạo một tệp ZIP mà chức năng nhập của chính SillyTavern đọc được. Mặc định nó bỏ qua secrets.json, ảnh thu nhỏ, vector, các bản sao lưu tự sinh, .git, node_modules và rác của hệ điều hành, vì vậy tệp lưu nhỏ hơn thư mục dữ liệu rất nhiều. Muốn kèm secret thì phải chọn riêng, có cảnh báo đi kèm.

Lịch tự động tạo một bản mỗi 30 phút, mỗi giờ, mỗi 6 giờ hoặc mỗi ngày khi dữ liệu có thay đổi, và giữ bản mới nhất (STM_LOCAL_BACKUPS để giữ nhiều hơn). Tạo điểm khôi phục là chủ động tạo một bản kèm ghi chú của bạn, và trình quản lý không bao giờ tự xoá điểm khôi phục, tệp đã tải lên hay điểm phục hồi lấy về từ R2; bản an toàn tạo trước khi phục hồi hoặc chuyển hồ sơ được giữ làm nút hoàn tác cho lần gần nhất. Tệp lưu là tệp bình thường: chép đi đâu cũng được.

#Phục hồi

1. Chọn một tệp lưu: do trình quản lý tạo, một điểm phục hồi từ Google Drive hay Cloudflare R2, hoặc một tệp ZIP bạn tải lên.
2. Đọc phần xem trước. Nó liệt kê những gì có trong tệp lưu trước khi bất cứ gì được ghi, và với Thay thế, cả những tệp trong hồ sơ mà tệp lưu không có.
3. Chọn Thay thế (mặc định: hồ sơ trở thành đúng nội dung tệp lưu) hoặc Gộp (tệp trong bản lưu ghi đè lên bản tương ứng, phần còn lại giữ nguyên).
4. Xác nhận. Một bản chụp an toàn của trạng thái hiện tại được tạo trước, tự động.

#Google Drive

Trên trang Dữ liệu, chọn Google Drive rồi bấm Kết nối Google Drive. Đăng nhập tài khoản Google và cho phép truy cập, trình quản lý sẽ giữ điểm phục hồi trong một thư mục ẩn của ứng dụng trên Drive của chính bạn. Không cần thẻ, không cần khoá, không phải tạo gì trước.

Quyền được xin là quyền hẹp nhất Google có cho Drive: một thư mục chỉ thuộc về ứng dụng này. Trình quản lý không thấy được gì khác trên Drive của bạn, và các tệp sao lưu không hiện lẫn trong tệp của bạn, nên không thể bị di chuyển hay xóa nhầm ở đó. Màn hình đồng ý của Google gọi đây là “dữ liệu cấu hình của riêng nó”.

Một máy mới kết nối cùng tài khoản Google sẽ tìm thấy đúng thư mục đó, nên các điểm phục hồi sẵn có đều khôi phục được sang máy mới. Kết nối ở máy thứ hai sẽ biến máy đó thành máy sao lưu, và máy đầu tiên dừng lại.

Ngắt kết nối thu hồi phiên đăng nhập. Các bản sao lưu vẫn nằm trên Drive của bạn, trừ khi bạn đánh dấu Xóa luôn các bản sao lưu trên Google Drive ngay trong hộp thoại đó. Bạn cũng có thể tự gỡ quyền tại myaccount.google.com/permissions.

#Cloudflare R2

Trên trang Dữ liệu, Kết nối Cloudflare là toàn bộ phần thiết lập. Đăng nhập, chọn tài khoản, cho phép các quyền, rồi trình quản lý tìm hoặc tạo một bucket tên sillytavern-manager-backup trong tài khoản của bạn và bắt đầu giữ điểm phục hồi ở đó. Không phải tạo hay dán khoá nào.

Hai trong số các quyền là tuỳ chọn và nên cho phép:

• Workers. Trình quản lý triển khai một Worker nhỏ, cũng tên sillytavern-manager-backup, để chuyển dữ liệu sao lưu tới bucket. Cách này nhanh hơn nhiều và không tiêu tốn hạn mức API Cloudflare của bạn. Không có nó, bản sao lưu đi qua API của Cloudflare và lần đầu có thể rất lâu.
• Account Analytics. Khi đó bảng điều khiển hiển thị được dung lượng và số thao tác Class A/B theo cách Cloudflare đếm, cho riêng bucket và cho cả tài khoản so với hạn mức miễn phí. Đây là số liệu sử dụng, không phải hoá đơn.

Một máy mới đăng nhập vào cùng tài khoản sẽ tìm thấy đúng bucket đó, nên các điểm phục hồi sẵn có đều khôi phục được sang máy mới.

Ngắt kết nối xoá khoá Worker của bản cài này và thu hồi phiên đăng nhập. Bucket và mọi thứ bên trong vẫn là của bạn. Bạn cũng có thể tự thu hồi trong hồ sơ Cloudflare, tại mục Manage OAuth authorizations.

Không muốn đăng nhập? Chọn Khoá R2/S3 (thủ công) rồi nhập endpoint, bucket và cặp khoá lấy từ trang R2 trong bảng điều khiển Cloudflare. Mọi kho lưu trữ tương thích S3 đều dùng được theo cách này.

#Chế độ tiết kiệm

Với một máy ít chỗ chứa tệp, như một container giữ mọi thứ trong bộ nhớ hay một chiếc điện thoại gần đầy, chính các tệp lưu trên máy là thứ làm cạn chỗ. Khi bật Chế độ tiết kiệm, trên máy không giữ tệp lưu nào và hồ sơ chỉ nằm trên đĩa một lần. Bucket R2 của bạn giữ các điểm phục hồi và đóng vai bản an toàn: dữ liệu hiện tại được gửi lên R2 trước khi một lần phục hồi ghi đè lên nó.

Tệp ZIP tải lên và điểm phục hồi lấy từ R2 được ghi thẳng vào hồ sơ khi dữ liệu tới, trong lúc SillyTavern dừng. Lần phục hồi được so với chỗ trống trước khi bắt đầu; nếu thiếu chỗ, trình quản lý đề nghị bỏ bớt những thứ SillyTavern không cần (lịch sử git và node_modules của tiện ích, bản sao lưu riêng của SillyTavern, ảnh thu nhỏ), và từ chối nếu vẫn không vừa, thay vì hỏng giữa chừng.

Nó tự bật khi thư mục dữ liệu nằm trong bộ nhớ, hoặc khi ổ đĩa còn dưới 5 GiB lúc trình quản lý khởi động, và nói rõ vì lý do nào. Ngoài ra đây là một công tắc trong Thiết lập → Khi mở trình quản lý, hoặc đặt STM_SAVER=1 / STM_SAVER=0 trong môi trường để chốt hẳn.

#Dựng lại cả máy

Bucket còn giữ cả cách trình quản lý được thiết lập, cạnh dữ liệu: mật khẩu quản trị và mã PIN SillyTavern dưới dạng hash nó đang lưu, các cổng, các link, Giữ STM online, lịch sao lưu và giới hạn R2, và bản SillyTavern đang chạy. Số liệu sử dụng cũng được giữ ở đó.

Trên máy mới, đăng nhập cùng tài khoản Cloudflare hay Google, ở màn hình lần đầu hoặc trên trang Dữ liệu. Hồ sơ đang trống trong khi bucket có dữ liệu thì điểm phục hồi mới nhất được lấy về trước khi SillyTavern khởi động, và SillyTavern được cài đúng bản bạn đang dùng. Khi tài khoản đang giữ thiết lập của một máy khác của bạn, một thẻ trên mọi trang đề nghị Khôi phục tất cả trong một lần; SillyTavern dừng trong lúc chạy, và những gì đang có trên máy này được giữ trong mục Sao lưu trước.

Mỗi tài khoản chỉ sao lưu từ một máy tại một thời điểm. Đăng nhập trên máy thứ hai khiến máy đó thành máy sao lưu; máy thứ nhất dừng lại, bỏ quyền đăng nhập của chính nó và báo máy nào đã tiếp quản. Đăng nhập lại ở đó là lấy lại quyền.