Hướng dẫn dịch thuật cục bộ

Bản dịch truyện tranh cục bộ: kết nối manga-translator-ui với NodeLane

Thiết lập dịch vụ Web manga-translator-ui, kết nối nó với NodeLane và dịch trang truyện tranh đầu tiên của bạn. Bao gồm kết nối, đăng nhập, chờ đợi và xử lý sự cố bộ đệm.

NodeLane Comics nhóm biên tập8 phút

Ảnh chụp tiện ích thật bằng tiếng Trung, Nhật, Hàn và Anh, dùng truyện mẫu do dự án sáng tạo. Biểu mẫu chỉ minh họa cài đặt, không chứng minh đã kết nối dịch vụ. Trang này dùng ảnh tiếng Anh.

Trước khi bạn bắt đầu

NodeLane Comics xử lý việc đọc trong trình duyệt của bạn; manga-translator-ui (MTU) xử lý hình ảnh. Kênh MTU của riêng bạn không cần tài khoản NodeLane và không sử dụng hạn mức dịch chính thức. Phần cứng, mô hình và chi phí API của bên thứ ba vẫn là của bạn.

Bạn cần có tiện ích mở rộng trình duyệt dành cho máy tính để bàn mới nhất, dịch vụ MTU đã cài đặt cùng với các phần phụ thuộc của nó cũng như tên người dùng và mật khẩu của dịch vụ đó. Hướng dẫn này sử dụng http://127.0.0.1:8000 trên cùng một máy tính với trình duyệt. Sử dụng cổng thực tế của bạn nếu nó khác.

1. Khởi động dịch vụ web MTU

Tiện ích mở rộng cần có dịch vụ Web HTTP. Chỉ mở cửa sổ màn hình MTU thôi là chưa đủ. Sau khi cài đặt MTU, hãy chạy lệnh này trong thư mục dự án và tiếp tục chạy dịch vụ. Bỏ qua lệnh này nếu bạn đã chạy dịch vụ Web thông qua Docker hoặc phương pháp khác.

Ví dụ này không bật xử lý bằng GPU. Chỉ thêm --use-gpu sau khi thiết lập môi trường GPU được hỗ trợ theo tài liệu chính thức. Yêu cầu về mô hình, trình điều khiển và phần cứng phụ thuộc vào phiên bản MTU.

uv run --no-sync python -m manga_translator web --host 127.0.0.1 --port 8000

2. Dịch một ảnh thử ngay trong MTU trước

Mở http://127.0.0.1:8000 trong trình duyệt của bạn, hoàn tất thiết lập tài khoản của MTU và đăng nhập. Nếu yêu cầu thay đổi mật khẩu ban đầu, hãy hoàn tất việc đó trong MTU trước khi kết nối tiện ích mở rộng. Đây là thông tin xác thực MTU, tách biệt với tài khoản NodeLane của bạn.

Cấu hình bộ dịch, mô hình và các khóa API cần thiết trên máy chủ, rồi kiểm tra xem ảnh thử có cho ra bản dịch không. Tiện ích đặt ngôn ngữ đích và dùng cấu hình mặc định của máy chủ cho các tùy chọn khác. Hãy bảo đảm dịch vụ Web dùng đúng mặc định bạn muốn. Không nhập khóa API của mô hình vào ô mật khẩu trong tiện ích.

3. Thêm kênh dịch trong tiện ích mở rộng

3. Thêm kênh dịch trong tiện ích mở rộng
3. Thêm kênh dịch trong tiện ích mở rộngXem ảnh lớn ↗

Mở cài đặt của tiện ích mở rộng và tìm Kênh dịch. Sau khi kết nối thành công, tiện ích lưu mật khẩu và mã thông báo dịch vụ trên máy tính này. Khi kết nối lại với cùng địa chỉ dịch vụ và tên người dùng, bạn có thể để trống ô mật khẩu để dùng mật khẩu đã lưu. Nếu đổi địa chỉ hoặc tên người dùng, hoặc mật khẩu đã thay đổi hay không còn hợp lệ, hãy nhập lại mật khẩu. Các nhãn bên dưới mô tả các điều khiển tương ứng bằng ngôn ngữ giao diện của bạn. Lưu mật khẩu và kết nối lại với ô mật khẩu để trống cần tiện ích phiên bản 0.10.2 trở lên; ở phiên bản cũ hơn, bạn phải nhập mật khẩu mỗi lần kết nối lại.

  1. Chọn Thêm kênh dịch và xác nhận manga-translator-ui làm dịch vụ. Tùy ý đặt cho nó một cái tên dễ nhận biết, chẳng hạn như “Máy tính của tôi”.
  2. Nhập http://127.0.0.1:8000 làm địa chỉ dịch vụ. Sử dụng root dịch vụ, không có /auth/login, /translate/with-form/image hoặc đường dẫn trang quản trị.
  3. Nhập tên người dùng và mật khẩu MTU, sau đó chọn Kết nối và sử dụng. Kết nối không xin quyền website riêng; nếu truy cập bị giới hạn, hãy khôi phục quyền truy cập tất cả website trong phần cài đặt tiện ích rồi thử lại.
  4. Kiểm tra xem Kênh hiện tại có hiển thị dịch vụ mới không. Bạn có thể lưu nhiều cấu hình dịch vụ nhưng mỗi lần chỉ sử dụng kênh đã chọn.

4. Đọc trang dịch đầu tiên của bạn

4. Đọc trang dịch đầu tiên của bạn
4. Đọc trang dịch đầu tiên của bạnXem ảnh lớn ↗

Nhập truyện cục bộ hoặc EPUB, hay mở website tương thích và OPDS trong trình đọc. Chọn ngôn ngữ, dịch và kiểm tra ảnh hiện tại. Cả kênh NodeLane lẫn MTU trong tiện ích đều dịch hình ảnh; EPUB không dịch văn bản.

Ảnh hiện tại được ưu tiên rồi bổ sung vùng lân cận có giới hạn theo vị trí đọc. Cùng một MTU xử lý lần lượt từng ảnh. Chuyển hoặc so sánh bản gốc giữ vị trí; dịch tab, ảnh nhấp chuột phải và vùng chọn cũng dùng kênh hiện tại.

Nếu một trang bị lỗi, hãy giải quyết vấn đề được báo cáo trước khi thử lại theo cách thủ công. Việc đóng một trang hoặc mất kết nối không chứng tỏ rằng MTU đã ngừng tính toán. Tránh gửi đi lặp lại trong khi dịch vụ có thể vẫn đang bận.

Khắc phục sự cố kết nối, đăng nhập và chờ đợi lâu

Hãy kiểm tra chính MTU trước khi thử lại trong tiện ích mở rộng. Không chia sẻ mật khẩu, mã thông báo hoặc tệp truyện tranh riêng tư khi báo cáo sự cố.

triệu chứngNhững gì cần kiểm tra
Địa chỉ dịch vụ không mởKiểm tra xem dịch vụ Web có đang chạy không và cổng có đúng không. 127.0.0.1 nghĩa là máy tính chạy trình duyệt; một thiết bị khác cần có địa chỉ có thể truy cập được của riêng nó.
Trang mở ra nhưng tiện ích mở rộng không thể kết nốiKiểm tra địa chỉ gốc, quyền truy cập trình duyệt và xem phiên bản MTU của bạn có cung cấp điểm cuối dịch hình ảnh và đăng nhập tài khoản tương thích hay không.
Yêu cầu thông tin đăng nhập sai hoặc thay đổi mật khẩu ban đầuĐăng nhập vào MTU hoặc thay đổi mật khẩu ban đầu ở đó, sau đó kết nối lại. Sử dụng thông tin đăng nhập MTU, không phải mật khẩu NodeLane hoặc khóa API mẫu.
Kết nối trước đó hiện báo cáo thông tin đăng nhập đã hết hạnChọn Kết nối lại trong cài đặt kênh. Với cùng địa chỉ dịch vụ và tên người dùng, bạn có thể để trống ô mật khẩu để dùng mật khẩu đã lưu. Cấu hình từ phiên bản cũ chỉ lưu mã thông báo cần nhập mật khẩu một lần khi kết nối lại lần đầu. Nếu đổi địa chỉ hoặc tên người dùng, hoặc mật khẩu đã thay đổi hay không còn hợp lệ, hãy nhập lại mật khẩu. Tiện ích mở rộng không âm thầm gửi lại bản dịch trước đó. Lưu mật khẩu và kết nối lại với ô mật khẩu để trống cần tiện ích phiên bản 0.10.2 trở lên; ở phiên bản cũ hơn, bạn phải nhập mật khẩu mỗi lần kết nối lại.
Đã kết nối nhưng bản dịch vẫn đang chờKiểm tra tải xuống mô hình, tải động cơ, hàng đợi, số dư API và tài nguyên phần cứng. Kiểm tra cấu hình tương tự trong MTU. Kết nối chỉ xác minh đăng nhập.
Bị gián đoạn, hết thời gian hoặc trả lại nội dung nào đó không phải là hình ảnhKiểm tra tác vụ MTU, thời gian chờ proxy và phản hồi. Hãy thử lại trang bị lỗi theo cách thủ công sau khi khắc phục được nguyên nhân. Tiện ích mở rộng không tự động khôi phục kết quả từ lịch sử MTU.

Bộ nhớ đệm, sử dụng ngoại tuyến và nơi hình ảnh đi

Kết quả kênh cục bộ được lưu vào bộ nhớ cục bộ của trình duyệt này. Việc xóa bộ nhớ đệm hoặc đặt ngân sách bộ nhớ đệm hình ảnh đã dịch về 0 và đóng các trang vẫn giữ kết quả có thể xóa chúng. Kết quả bị thiếu cần phải dịch lại bằng tay; tiện ích mở rộng không thể tìm nạp lại chúng từ MTU.

Hình ảnh được chuyển đến dịch vụ MTU đã chọn. Chạy MTU cục bộ không đảm bảo dịch ngoại tuyến: người dịch trực tuyến, OCR hoặc mô hình hình ảnh có thể gửi văn bản hoặc hình ảnh đến nhà cung cấp của họ. Tạo ngoại tuyến yêu cầu bản gốc có sẵn, mô hình đã tải xuống và quy trình không có phụ thuộc trực tuyến.