Book Studio - Plugin cho Codex (Public)

Book Studio là plugin cho Codex, hỗ trợ dịch, biên tập và kiểm tra sách EPUB với AI. Plugin đóng gói skill book-translation cùng Python engine tương ứng, giúp bắt đầu một dự án sách mà không phải cài CLI riêng.

Một workflow từ bản dịch thử đến bản xuất

• Làm rõ ngôn ngữ đích, kiểu bản xuất và các lựa chọn còn thiếu trước khi dịch.

• Chuẩn bị một phần dịch mẫu đại diện và chờ bạn duyệt trước khi xử lý toàn bộ sách.

• Dịch theo từng gói nội dung, kết hợp bảng thuật ngữ và tài liệu tham chiếu.

• Xuất EPUB đơn ngữ hoặc song ngữ, giữ cấu trúc và hình ảnh gốc khi phù hợp.

• Kiểm tra cấu trúc, điều hướng và bản xuất; chất lượng biên tập và hình ảnh vẫn cần được xem lại.

Skill và engine trong cùng một plugin

Skill hướng dẫn trao đổi yêu cầu, chuẩn bị bản mẫu và điều phối các bước cùng AI. Python engine xử lý dữ liệu, cấu trúc sách và kiểm tra. Engine không tự gọi mô hình hay tải sách lên mạng; công cụ AI được dùng trong phiên làm việc phụ thuộc môi trường của bạn.

Plugin dùng runner và engine đi kèm, kể cả khi máy đã có một bản CLI khác. Nội dung nguồn, quyết định biên tập và bản xuất được giữ trong thư mục dự án riêng, bên ngoài thư mục mã nguồn.

Bắt đầu với Codex

Với EPUB, bạn cần Python 3.11 trở lên và phiên bản Codex hỗ trợ plugin. Sau khi cài Book Studio qua marketplace của repo, mở task mới, chọn plugin và cung cấp tệp nguồn. Không cần cài pip, pipx hay CLI bookstudio riêng cho cách dùng này.

Repo công khai đã có gói plugin Book Studio và hướng dẫn cài đặt tại commit e027d9617ecaf23e5f5dc1efa7d52ac16b072416. Hãy đọc README trong repo để kiểm tra cách cài và yêu cầu của phiên bản bạn sử dụng.

Nhìn vào mã nguồn

Cài plugin vào Codex chỉ cần bốn dòng; engine đi kèm nên không phải cài pip hay CLI riêng:

git clone https://github.com/wblekhoa/book-studio-core.git
cd book-studio-core
codex plugin marketplace add .
codex plugin add book-studio@book-studio

Luồng dịch có hướng dẫn gói trong sáu lệnh cho người mới; các lệnh còn lại dành cho người dùng nâng cao:

BEGINNER_COMMANDS = ("doctor", "start", "init", "next", "apply", "finish")

COMMAND_HELP = {
    "doctor": "Check whether the local runtime can run Book Studio.",
    "start": "Start a guided translation project.",
    "next": "Emit the next bounded translation packet.",
    "apply": "Validate and apply one AI translation response.",
    "finish": "Run the strict reproducible final-book gate.",
}

Mỗi lượt dịch là một gói nhỏ: engine chọn các khối chưa dịch của một file, giới hạn theo max_blocks và bỏ qua khối đã có bản dịch khớp ngữ cảnh hiện tại (rút gọn từ translation/packets.py):

for file in block_map.get("files", []):
    remaining = [
        block for block in file.get("blocks", [])
        if (source_path, block["block_index"]) in targets
        and (source_path, block["block_index"]) not in translated
    ]
    if remaining:
        selected = remaining[: config.max_blocks]
        break

Bản mẫu phải được duyệt trước khi dịch cả sách; engine không tự chấp nhận thay người dùng:

bookstudio start PROJECT --source SOURCE.epub --json
bookstudio pilot approve PROJECT --json
bookstudio pilot accept PROJECT --confirm --json

PDF và các công cụ bổ sung

Chuẩn bị PDF cần Poppler cài trên máy và chỉ hỗ trợ tài liệu có lớp văn bản phù hợp. Plugin không tích hợp OCR cho bản scan. Render và tạo ảnh dùng công cụ sẵn có trong môi trường AI, không được đóng gói cùng engine.

Kiểm chứng và phạm vi sử dụng

Trong lần kiểm chứng cục bộ được báo cáo, 225/225 test đã đạt; plugin và skill qua validator. Workflow dịch mẫu chạy trọn từ bản plugin đã cài, bản đóng gói khớp nguồn và audit 129 file không ghi nhận vi phạm. Đây là kết quả kiểm tra kỹ thuật của bản cục bộ, không thay thế việc duyệt bản dịch hoặc kiểm tra trực quan từng cuốn sách.

Dự án áp dụng giấy phép sử dụng cá nhân. Bản sách tạo ra phục vụ việc đọc, học tập hoặc nghiên cứu riêng; không dành cho bán, xuất bản hay phân phối lại.

Mã nguồn Book Studio Core.