← Về thư viện

Thêm và cập nhật truyện

Bạn có thể thêm gói riêng trên thiết bị hoặc dùng quy trình source để cập nhật thư viện chung.

Thêm trên app

  1. Bấm Thêm / cập nhật truyện ở tủ sách.
  2. Chọn ZIP/JSON đã chuẩn bị; hoặc DOCX/TXT rồi điền tên, nhóm, ngôn ngữ và mã chương.
  3. Bấm Kiểm tra trước, xem số chương mới/cập nhật rồi bấm Nhập vào thiết bị.
  4. Tìm tên truyện trong thư viện, hoặc bấm Đọc cạnh gói đã lưu.

Giữ nguyên mã gói và mã chương khi sửa bản cũ. Đổi tên hiển thị được; đổi mã sẽ thành truyện khác và không nối tiến độ cũ.

Nhập lại cùng mã gộp các chương, không xóa chương ngoài gói. Gói riêng không tự xuất hiện trên máy khác: dùng Xuất ZIP rồi nhập ở máy kia. Xóa dữ liệu trình duyệt có thể làm mất gói, nên giữ một bản ZIP.

Gói có những gì?

ZIP có story-pack.json ở gốc, khai báo các chương và nội dung/đường dẫn DOCX, TXT hoặc JSON. Ảnh tùy chọn đặt trong assets/. Có nút tải mẫu ngay trong app.

Giới hạn: 64 MiB/gói, 16 MiB/tệp, tối đa 200 chương. DOCX lấy chữ theo thứ tự, không tự tách ảnh nhúng. Hồ sơ trong 00_tai_lieu/ không được coi là truyện.

Cho người cập nhật thư viện chung hoặc chat khác

Dùng thư mục content-inbox/ trong source và công cụ tools/content/story_pack.py. Có kiểm tra, tạo gói ZIP và xem trước thay đổi; công cụ giữ các chương cũ và kiểm tra ID, file thiếu, số đoạn cảnh/voice.

python tools/content/story_pack.py validate content-inbox/my-pack
python tools/content/story_pack.py build content-inbox/my-pack --output /tmp/my-pack.zip
python tools/content/story_pack.py apply content-inbox/my-pack

Lệnh apply mặc định chỉ báo cáo. Sau khi xem đúng ID/diff, dùng --apply; chỉ dùng --update-existing khi chủ động sửa ID đã có.

Giao diện nhập gói hiện hỗ trợ chữ và ảnh riêng. VN/chibi/voice đúng game cần script, asset và sidecar từ quy trình native; app không tự tạo các phần đó từ DOCX. Gói scene được xử lý qua source.

tải hướng dẫn đầy đủ (.md) cho người hoặc chat khác

Để xuất hiện trong thư viện chung, thay đổi phải được kiểm tra và phát hành từ đúng source của Site. Không cần tài khoản để đọc.

Ghép cảnh game và âm thanh

Dùng quy trình tự ghép story để cập nhật source chung: lấy biểu cảm, nền, người nói và cue âm thanh từ kịch bản gốc; có cache và báo cáo phần còn thiếu theo chương.