Kembali ke profil
Dokumentasi resmiv1.0 · aktif dikembangkan

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

Inti

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

Inti

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

AI

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

Performa

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

Kualitas

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

Tooling

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

UI

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

Kualitas

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. 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. 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. 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. 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. 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

PythonCore pipeline, CLI, implementasi format game novel
TypeScriptFront end web console
Web frameworkBackend API + SSE real-time (Python)
SQLiteCache terjemahan, context memory, settings
Editor in-browserEditor terjemahan (build custom, CodeMirror-grade)
ContainerEngine lokal self-host (opsional)

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

Utama

Kualitas tertinggi, konteks-aware dengan system prompt khusus game — jadi engine utama.

Mesin terjemahan publik

Cepat

Batch high-speed untuk volume besar; fallback ke mesin cadangan saat terblokir.

Mesin lokal

Lokal

Self-host di perangkat sendiri — privasi penuh, tanpa kuota pihak ketiga.

Mesin offline

Offline

Terjemahan 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