Dokumentasi resmi produk
Clawie
Clawie Enterprise Localization Suite — localization suite produksi untuk visual novel dan RPG Maker games: ±49.400 baris kode production-grade, pipeline terjemahan AI hybrid dengan fallback 4 engine, syntax fixer ~33 pass, dan 1.000+ automated tests yang menjaga setiap perubahan tetap benar.
Dibangun solo oleh Hengki Saputra — full-stack engineering: Python core, TypeScript front end, keamanan ter-audit, dan CI berlapis. Halaman ini adalah dokumentasi resmi produk.
±49.400
baris kode
full codebase
695
passed
pytest backend
340
passed
vitest SPA
225
passed
parity vs referensi
0
tersisa
temuan kritis audit
Fitur
Delapan modul utama yang saling terhubung — semuanya sudah selesai, dites, dan di-audit.
Pipeline format game novel
Parse script .rpy (say/menu/label/strings), generate template TL, dan identifier MD5 — hasil output terverifikasi sesuai spesifikasi format game novel (1929/1929 baris match pada ground truth the_question).
- Auto-decompile .rpyc sebelum generate
- Priority & dedupe global strings
- Komentar penerjemah ikut terbawa
Pipeline RPG Maker
Parser MV/MZ & VX Ace dengan algoritma escape standar industri — escape code (hex/html/meaningless/number), dedupe konteks, dan proteksi akronim game.
- Extract/import CSV dua arah
- plugins.js opt-in dengan whitelist ketat
- HTML entities decode otomatis
Hybrid Translation Engine
Empat engine digabung cerdas: LLM engine, Mesin terjemahan publik, Mesin lokal, dan Mesin offline — dengan fallback otomatis dan adaptive rate limiter.
- Dynamic semaphore konkurensi
- Proxy manager siap pakai
- Quality validator tiap hasil
Cache & Context Memory
Cache SQLite persist antar sesi plus context memory bank — teks identik hanya diterjemahkan sekali dan diterapkan ke semua konteksnya.
- Hemat kuota API
- Idempotent roundtrip terverifikasi
- Translation tracker progres
Syntax Fixer
Perbaikan otomatis tiga fase dengan ~33 pass: tag format game novel rusak, indentasi & struktur blok, interpolasi [name]/[b], HTML entities, dan missing speaker.
- Mixin per kelompok perbaikan
- Konvensi format game novel
- Aman untuk file besar
CLI + Launcher
Satu perintah `clawie` membuka launcher terpadu: mode Web UI atau CLI interaktif, dengan flag lengkap untuk otomasi penuh.
- --auto-all, --dry-run, --rpgm, --web
- Menu interaktif 13+ modul
- RPA extract/repack & decompile .rpyc
Web Console
Dashboard web dengan editor terjemahan in-browser, monitor progres terjemahan real-time via SSE, manajemen engine & proxy, dan benchmark suite.
- Editor terjemahan in-browser
- Export dialogue.tab ⇄ import TSV
- Preview interpolasi [name]/{tags}
Benchmark & QA
Sistem benchmark profesional mengukur kecepatan & kualitas tiap engine, plus test suite berlapis yang menjaga semua pipeline tetap benar.
- Suite pytest + vitest + parity
- Coverage gate di CI
- Lint + website job otomatis
Cara Kerja
Pipeline lima tahap — dari proyek game mentah sampai terjemahan siap main.
- 1
Ekstrak & Parse
Clawie membaca proyek game mentah: file .rpyc didecompile otomatis, script .rpy diparse (subset say/menu/label/strings), atau data RPG Maker MV/MZ diekstrak dari Maps/Events dengan kode dialog resmi.
- 2
Generate Template
Template terjemahan dibuat sesuai spesifikasi resmi format game novel: identifier MD5 dari kode sumber, blok strings dengan prioritas (script < gui < screens) dan dedupe global, plus komentar penerjemah.
- 3
Terjemahkan
Hybrid engine menerjemahkan dengan proteksi token — placeholder, tag format game novel, dan akronim game tidak pernah ikut diterjemahkan. Context memory menyimpan hasil per konteks; cache SQLite mencegah duplikasi kerja.
- 4
Perbaiki & Tulis
SyntaxFixer membersihkan hasil mesin dalam ~33 pass (tag rusak, indentasi, interpolasi, HTML entities), lalu terjemahan ditulis balik ke file TL atau CSV — roundtrip terverifikasi idempotent.
- 5
Verifikasi
Count missing menunjukkan progres presisi (misal 85/120 dialogue, 12/20 strings), preview interpolasi memastikan [name] dan {tags} tetap berfungsi saat game dijalankan.
Arsitektur & Teknologi
src/cli/
- tlgen.py — generasi template TL (883 baris)
- interactive.py — menu interaktif (643 baris)
- dialogue_tab.py — export/import TSV
- strings_json.py — strings ⇄ JSON
- rpa_tools.py & rpyc_tools.py
src/core/
- hybrid_translator.py — gabungan engine
- deepseek_client.py — persistent loop + session pool
- google_batch_translator.py — batch cepat
- substitutions.py — interpolasi tanpa runtime
- quality_validator.py — validasi hasil
src/fixer/
- syntax_fixer.py — class utama
- mixins_cleanup.py — BOM, escape, entities
- mixins_structural.py — indentasi & blok
- mixins_special.py — tag & speaker rusak
src/web/
- app.py — routes web + SSE
- auth.py — password session guard
- security.py — safe-resolve path
- secret_box.py — Fernet at-rest
Engine Terjemahan
HybridTranslator mengorkestrasi empat engine dengan fallback otomatis — rate limiter adaptif menyesuaikan kecepatan dengan respons server, dynamic semaphore mengatur konkurensi, dan proxy manager siap saat ada rate limit.
LLM engine
UtamaKualitas tertinggi, konteks-aware dengan system prompt khusus game — jadi engine utama.
Mesin terjemahan publik
CepatBatch high-speed untuk volume besar; fallback ke mesin cadangan saat terblokir.
Mesin lokal
LokalSelf-host di perangkat sendiri — privasi penuh, tanpa kuota pihak ketiga.
Mesin offline
OfflineTerjemahan offline sepenuhnya di perangkat, tanpa koneksi internet.
Proteksi Token
Placeholder, tag format game ([name], {b}, %s), dan akronim game (HP/MP/TP/EXP/Lv) dilindungi sebelum dikirim ke engine dan dipulihkan setelahnya — terjemahan tidak pernah merusak logika game.
Keamanan
Hasil full audit 2026-10 (U01–U14, 20 temuan) — semua temuan Kritis/Tinggi fixed, tidak ada yang tersisa open.
- Auth web via password (WEB_PASSWORD) — guard semua route /api/* dengan session
- API key terenkripsi Fernet at-rest, kunci mode 600, migrasi plaintext otomatis
- Upload dibatasi 100 MB (CLAWIE_MAX_UPLOAD_MB) — sebelumnya tanpa batas
- Safe-resolve di semua path user — anti path traversal
- Unpickler allowlist ketat — anti pickle injection (RPA/RPYC)
- Default bind 127.0.0.1 — expose ke jaringan hanya eksplisit via env
Kualitas & Pengujian
Setiap perubahan dijaga test otomatis — CI menjalankan lint, coverage gate, dan website job (tsc/build/vitest/pytest web) di setiap push.
695
pytest backend (non-integration)
340
vitest — 40 file test SPA
225
parity test vs referensi format game novel
206
pytest web routes
70%+
coverage dengan gate di CI
1929/1929
ground truth TL match vs referensi resmi