Shyobox × Typer Tool · Quy trình Add Text

Workflow chuẩn

Vòng Add Text khép kín

Sheet → database Shyobox → xếp hàng / raw → Typer Tool đưa file lên NAS → ghi Typed date ngược về Google Sheet.

01
Sync Schedule Đồng bộ Google Sheet Schedule vào database Shyobox.
02
Queue + raw Chap “Cần type”: tạo block/folder trên PC. Thiếu RAW: Shyobox tìm / tải từ Lezhin disk.
03
Typer Tool → NAS Typer Tool lấy PSD từ NAS + bản dịch từ Safari, thêm bản dịch vào PSD trong Photoshop, copy chap lên NAS.
04
Reverse sync Chap xong: ghi cột Typed date trên Google Sheet Schedule.

Shyobox (web)

Quản lý quá trình thêm bản dịch vào các tệp PSD ngay trên website.

Typer Tool (PC Agent)

Thêm bản dịch vào các file PSD trong Photoshop, đưa file lên NAS. Mở API để Shyobox điều khiển từ xa.

Đối lập công việc

Máy làm ~90%. Việc thủ công ~10%.

Trái: việc tự chạy. Phải: việc người vẫn cần xử lý.

Tự động

~90%

Chạy sau sync lịch / khi chap sẵn sàng.

Sync Schedule Đồng bộ Google Sheet Schedule vào database Shyobox.
Xếp chap “Cần type” Lọc chap đủ điều kiện (TR sẵn sàng trên lịch), tạo block + folder trên PC type.
Typer Tool + Auto Raw Typer Tool thêm bản dịch vào PSD. Thiếu RAW: Shyobox tìm / tải từ Lezhin rồi chạy tiếp.
Reverse sync Typed date Khi chap xong trên NAS: ghi cột Typed date ngược Google Sheet Schedule.
Lưu trữ block & thông báo Block đủ file được tự lưu trữ. Bật “Ting ting khi add xong” để nhận thông báo trình duyệt.

4 bước trên máy type (Typer Tool)

01 Raw: lấy PSD gốc

02 Safari / TR: lấy bản dịch

03 Trans: thêm bản dịch vào PSD

04 Done: copy file lên NAS

Thủ công

~10%

Tùy chỉnh trên web: Raw, bản dịch, path, offset chap… không cần sửa tool PC.

Việc thường ngày trên web

Thêm chap lẻ / quick-add từ lịch “Cần type”.
Tạo folder nếu thiếu; theo dõi chip trạng thái trên Add Text.
Đặt lại tên folder để chạy lại (từ đầu / raw / chỉ add text / done).
Chap lệch số: tùy chỉnh Raw (path / offset / ưu tiên folder) và Translation (Safari task id).

Lỗi cần xử lý thủ công

Chap extra / tên đặc biệt

Không map được PSD chuẩn → “Tùy chỉnh đường dẫn PSD / ZIP” (hoặc raw bộ khác).

Lỗi RAW / PSD

Lệch text, thiếu / lỗi PSD, RAW nhỏ, ít thoại, lỗi giải nén… → mở folder / error.log, rồi custom path, chỉnh Raw/TR, rename, hoặc đánh dấu Done.

Lỗi khác

Chưa có TR, Lezhin chưa có raw, lỗi chung. Theo chip màu; chờ auto hoặc xử lý tay.

Giao diện của Typer Tool

Nhìn thấy từ web

Giám sát PC Agent & thông báo khi xong

Trên Shyobox có thể xem từng máy còn liên lạc được không, Typer Tool đang làm bước nào, và chap nào đang chạy.

Trạng thái từng PC Agent

Mỗi máy type có một PC Agent. Shyobox đọc trạng thái này để biết máy sẵn sàng nhận lệnh hay không.

Online / Offline: máy còn kết nối với website hay đã tắt / mất mạng.
Tunnel: đường nối an toàn từ Shyobox tới máy (không cần Remote Desktop). “OK” = đường thông, lệnh đi tới được.
Photoshop: đang mở hay đóng (cần mở để thêm bản dịch vào file PSD).
Worker đang chạy: Typer Tool đang ở bước nào (raw / safari / trans / done) — xem giải thích bên dưới.

Khởi động cùng Windows

Bật tùy chọn này thì sau khi máy khởi động lại, Typer Tool + PC Agent tự chạy sẵn — Shyobox liên lạc được ngay, không cần ai mở tay.

Worker trong Typer Tool là gì?

Worker = từng bước tự động trong Typer Tool. Mỗi bước phụ trách một việc; khi xong mới chuyển bước tiếp.

raw: lấy file PSD gốc.
safari: lấy bản dịch từ Safari.
trans: thêm bản dịch vào PSD trong Photoshop.
done: copy chap đã xong lên NAS.

Chap đang xử lý trên web

Trên Shyobox thấy nhãn folder (ví dụ “Đang add text”) và cột PC Agent. Nhấp nháy vàng = folder khớp bước worker đang chạy trên máy.

Thông báo khi xong

Bật thông báo (theo từng dòng hoặc cả block): khi chap đã có file xong, trình duyệt gửi thông báo.

Khả năng điều khiển từ web

API PC Agent · website thao tác gì trên máy type

Typer Tool mở cửa API trên mỗi PC Agent (qua Cloudflare Tunnel). Chỉ domain Shyobox được gọi; mọi thao tác file nằm trong thư mục sandbox add-text.

API là gì?

API là “cửa lệnh” an toàn giữa website và các PC Agent chạy Typer Tool. Khi bạn thao tác trên Shyobox, website gửi lệnh sang PC Agent; Typer Tool (và Photoshop khi cần) thực hiện trên máy rồi trả kết quả lại web — không cần Remote Desktop hay có người ngồi trước từng máy.

Trên web: bấm nút / xem trạng thái trên Shyobox.
Qua PC Agent: lệnh được gửi an toàn tới đúng máy type.
Trên máy: Typer Tool thực hiện (mở file, thêm bản dịch trong Photoshop, đổi tên…).

Luồng kết nối

Shyobox Web

API Agent

Typer Tool

Photoshop

Giới hạn bảo mật

Domain: chỉ trình duyệt Origin thuộc https://*.shyobox.xx.kg.
Auth: header X-Agent-Key (mỗi máy một key).
Sandbox: chỉ thư mục add-text trên máy type, không thoát ra ngoài.
Rate limit: ~120 request/phút/IP. Upload tối đa ~50 MB/file.

Danh sách prefix folder

Tên folder trên máy type bắt đầu bằng prefix → Shyobox hiểu trạng thái chap. Đổi prefix = chạy lại / chuyển bước (ví dụ: raw_…, done_…).

Prefix	Ý nghĩa trên web
`(không prefix)`	Chờ xử lý
`raw_`	Đã có PSD
`trans_`	Đang add text
`done_`	Hoàn thành
`fix_`	Xong nhưng cần fix
`rawnho_`	RAW nhỏ
`chuacoraw_`	Chưa có RAW
`checklezhindisk_`	Đang kiểm tra ổ Lezhin
`dangtairaw_`	Đang tải raw
`copypsd_`	Đang copy PSD
`khongcoraw_`	Lezhin/TN chưa có raw
`chuacotr_`	Chưa có TR
`trchuaxanh_`	TR chưa xanh
`chuacotrenschedule_`	Chưa có trên schedule
`chuacotitlelist_`	Chưa có title list
`t`	Chap extra, tự copy
`nhieuboxtrong_`	Nhiều box trống
`itthoai_`	Ít thoại
`loikhilaytr_`	Lỗi lấy TR
`thieucustompath_`	Thiếu custom path
`error_`	Lỗi chung

Danh sách API

API	Dùng để làm gì trên web
`GET /health`	Kiểm tra Agent còn sống
`GET /status`	PC bật?, RAM, tunnel, worker, Photoshop mở/đóng
`GET /add-text/status`	Chap/folder nào đang được add text
`GET /scan`	Quét danh sách folder & trạng thái trên PC
`GET /list`	Duyệt file/folder trong sandbox
`GET /preview`	Xem trước text / ảnh / PSD
`GET /download`	Tải file về
`POST /upload`	Upload file (vd. custom path)
`POST /rename`	Đổi tên folder/file (chạy lại bước)
`POST /batch-rename`	Đổi tên hàng loạt
`POST /new-folder`	Tạo folder chap mới
`POST /copy` · `/move` · `DELETE /delete`	Copy / Move / Xóa trong sandbox

Shyobox tự động hóa Add Text ~90%. Phần còn lại làm thủ công