📚 EBook Studio – Hướng dẫn sử dụng

1 Cài đặt & khởi chạy

Chỉ cần Node.js và trình duyệt Chrome/Edge. Không cần cài database.

Yêu cầu

Chạy lần đầu

1. Windows: bấm đúp file start.bat trong thư mục EBook Studio. Lần đầu script tự cài thư viện (npm install) và build giao diện.
2. macOS / Linux: mở Terminal trong thư mục, chạy:

   npm install
   npm start

3. Mở trình duyệt tại http://localhost:3000. Hướng dẫn này luôn có tại http://localhost:3000/guide/ hoặc menu Hướng dẫn sử dụng.

2 Cấu hình AI & API key

Mặc định dùng Pollinations.ai miễn phí – không cần đăng ký, không cần key. Muốn nhanh và ổn định hơn, hãy dùng API key của riêng bạn.

1. Vào menu Cài đặt AI. Ở mục AI viết nội dung, bấm vào thẻ nhà cung cấp muốn dùng (thẻ được chọn có viền tím).
2. Dán API key và (tuỳ chọn) đổi Model. Bấm biểu tượng 👁 để xem lại key. Link “Lấy API key ↗” dẫn tới trang tạo key.
3. Làm tương tự ở mục AI tạo hình ảnh (bìa sách, tranh minh hoạ).
4. Bấm Lưu cài đặt, rồi Kiểm tra kết nối – ứng dụng gửi một câu hỏi thử và hiển thị câu trả lời.

3 Tạo cuốn sách mới

1. Ở màn hình chính bấm Tạo sách mới.
2. Nhập tên sách tạm (có thể để trống), tác giả, thể loại, ngôn ngữ viết và ý tưởng cuốn sách – càng cụ thể (độc giả, vấn đề, điểm khác biệt) thì AI càng viết tốt.
3. Bấm Tạo & dựng cấu trúc → chuyển sang tab Kiến trúc sách. Trang Bản quyền và Lời mở đầu được tạo sẵn.

4 AI Book Architect – dựng tiêu đề & mục lục

1. Kiểm tra ý tưởng, thể loại, độc giả mục tiêu, giọng văn và kéo thanh Số chương (3–30).
2. Bấm AI dựng cấu trúc (30–90 giây). AI trả về 10 tiêu đề kèm phụ đề và mục lục chi tiết; mỗi chương có đoạn “brief” mô tả ý chính.
3. Bấm chọn một tiêu đề ưng ý (tuỳ chọn). Sửa trực tiếp tên/brief từng chương, đổi thứ tự bằng mũi tên ↑↓, xoá 🗑 hoặc Thêm chương.
4. Bấm Áp dụng vào sách để tạo các chương và chuyển sang tab Soạn thảo.

5 Soạn thảo văn bản kiểu Word

Mỗi chương là một trang giấy trắng với thanh ribbon quen thuộc như Microsoft Word. Mọi thay đổi được tự động lưu sau 1 giây (nhãn “✓ Đã lưu” góc phải).

Tab Trang chủ

Tab Chèn, Bảng và Xem

Tìm & thay thế

Phím tắt hữu ích

Quản lý chương

• + Chương (góc trên danh sách) để thêm chương mới ở cuối.
• Rê chuột lên một chương để hiện nút ↑ ↓ đổi thứ tự và 🗑 xoá.
• Bản quyền và Lời mở đầu là trang đầu sách – sửa như chương thường (ISBN, năm xuất bản…).

6 AI viết chương & viết lại đoạn văn

AI Chapter Writer – viết cả chương

1. Mở chương cần viết. Bấm Tuỳ chọn trên thanh AI Chapter Writer để chọn độ dài (500–4.000 từ) và ghi yêu cầu thêm (ví dụ: “thêm câu chuyện thực tế, có bài tập cuối chương”).
2. Bấm AI viết chương này. AI đọc brief của chương, tóm tắt các chương trước và danh sách chương sau để không lặp ý.
3. Sau khi viết xong, AI tự tạo bộ nhớ ngữ cảnh (tóm tắt ≤ 80 từ) cho chương – dùng khi viết các chương tiếp theo.

Viết lại đoạn đã chọn (tab ✨ AI viết)

7 Bìa sách & hình ảnh (AI Cover & Visual Studio)

7.1 Thiết kế bìa trước

1. (Tuỳ chọn) nhập phong cách, bấm AI gợi ý 3 ý tưởng bìa – mỗi ý tưởng là một prompt tiếng Anh phù hợp thể loại. Bấm vào ý tưởng để đưa vào ô prompt, sửa nếu muốn.
2. Bấm Tạo ảnh bìa. Ảnh được đặt làm nền và lưu vào thư viện; bấm ảnh cũ trong thư viện để đổi nền.
3. Bấm Bố cục tự động để chèn tên sách, phụ đề, tác giả. Hoặc thêm từng phần: Tiêu đề, Tác giả, Slogan, Logo/Ảnh, Lớp phủ tối (giúp chữ dễ đọc).
4. Bấm chọn một khối chữ để hiện thanh định dạng: font chuẩn xuất bản, cỡ, màu, đậm, căn lề, giãn chữ, viền chữ, đổ bóng. Kéo để di chuyển, kéo góc để đổi kích thước.
5. Giữ chữ quan trọng bên trong đường xanh (vùng an toàn), rồi bấm Lưu bìa trước – xuất PNG 300 DPI kèm bleed, dùng cho EPUB và bìa in.

7.2 Bìa in full-wrap cho KDP Paperback

1. Mở tab Bìa full-wrap KDP. Nhập số trang (tự điền theo lần xuất PDF gần nhất) và loại giấy – ứng dụng tính độ dày gáy theo công thức KDP (trắng 0,002252"/trang, kem 0,0025"/trang, màu 0,002347"/trang).
2. Chọn màu nền bìa sau, màu gáy, màu chữ, font; nhập câu tiêu đề và nội dung bìa sau (để trống sẽ lấy mô tả sách ở tab Metadata), giới thiệu tác giả.
3. Bấm Ghép bìa full-wrap → xem trước (có đường cắt đỏ và vạch gáy xanh) và Tải PDF bìa để upload lên KDP.

7.3 Nhân vật nhất quán (sách thiếu nhi, truyện tranh)

1. Mô tả nhân vật thật chi tiết bằng tiếng Anh (tuổi, tóc, trang phục, màu sắc) và phong cách vẽ.
2. Giữ nguyên Seed cho cả cuốn sách (bấm 🎲 chỉ khi muốn tạo nhân vật khác).
3. Mỗi trang chỉ cần thay đổi Cảnh rồi bấm Vẽ tranh minh hoạ. Dùng ô “➕ Chèn vào chương…” dưới mỗi tranh để thêm tranh vào cuối chương, hoặc chèn ở vị trí bất kỳ qua Chèn → Thư viện ảnh AI trong trình soạn thảo.

8 Dàn trang & xuất file (Universal Ebook Formatter)

1. Chọn một trong 12 mẫu dàn trang: Cổ điển, Hiện đại, Tối giản, Tiểu thuyết, Kinh doanh, Self-help, Sang trọng, Học thuật, Thiếu nhi, Lãng mạn, Kỹ thuật, Thơ & Tản văn. Tất cả font đều hỗ trợ tiếng Việt và được nhúng vào file.
2. Chọn khổ sách in (10 khổ chuẩn KDP, phổ biến nhất 6" × 9"), loại giấy, cỡ chữ, bật Bleed nếu có ảnh tràn mép.
3. Bật/tắt các phần tự động: trang bản quyền, lời mở đầu, mục lục tương tác, header (tên sách trang trái / tác giả trang phải), số trang, đánh số chương.
4. Bấm Xuất EPUB (Kindle, Google Play, Apple Books) hoặc Xuất PDF in ấn (KDP Paperback).

9 KDP SEO & Metadata

1. Mở tab KDP SEO & Metadata, bấm AI tạo metadata. AI đọc mục lục và tóm tắt các chương.
2. 7 KDP Search Keywords: mỗi ô tối đa 50 ký tự (bộ đếm hiển thị bên phải), sửa trực tiếp và bấm 📋 để sao chép dán vào KDP.
3. Mô tả sách: chuyển giữa chế độ Xem và HTML; chỉ dùng các thẻ KDP cho phép (<b> <i> <ul> <li> <h4>…), tối đa 4.000 ký tự.
4. Bấm Lưu chỉnh sửa. Từ khoá và mô tả cũng được ghi vào metadata của file EPUB và dùng cho bìa sau.

10 Lịch sử AI & License

Chế độ license được cấu hình trong .env:

LICENSE_REQUIRED=true          # bắt buộc kích hoạt trước khi dùng
LICENSE_PROVIDER=lemonsqueezy  # hoặc gumroad
GUMROAD_PRODUCT_ID=xxxxxxxx    # chỉ cần với Gumroad

Khi bật, ứng dụng hiện màn hình kích hoạt cho tới khi nhập key hợp lệ. License được kiểm tra lại mỗi lần khởi động và vẫn dùng được khi offline tối đa 7 ngày.

11 Dữ liệu & sao lưu

12 Khắc phục sự cố