Link the official light and dark Star History chart for qybaihe/bla so the image opens the full history page. The chart stays a remote cached SVG, and each translated README gets the same embed with its own alt text. Co-authored-by: Timo Zhang <qybaihe@gmail.com>
12 KiB
English · 简体中文 · 繁體中文 · 日本語 · 한국어 · Türkçe · Русский · Tiếng Việt · ไทย · Deutsch · Español · Français · Українська · Polski · Português (Brasil) · العربية · فارسی · Bahasa Indonesia · Italiano · Ελληνικά · മലയാളം · Roman Urdu · Română
BLA: Blind LLM Agents
Satu MCP untuk melindungi biner, aplikasi, dan perilaku saat runtime dari rekayasa balik oleh AI.
Rilis fitur yang Anda bangun. Buat agen AI yang mencoba mengkloningnya kewalahan hingga ke tingkat biner.
Mulai Cepat · Cara Kerja BLA · Apa Saja yang Dapat Dilindungi · Demo & Tolok Ukur · FAQ · Dokumentasi
npx bla-agents setup · npx bla-agents defend ./dist --manifest
Important
Dapatkan BLA melalui qybaihe/bla atau paket npm bla-agents.
Khawatir seseorang menggunakan REA untuk mengkloning aplikasi Anda hanya dalam hitungan detik? Minta agen AI Anda melindunginya menggunakan BLA (Poison → Exhaust → Hallucinate).
BLA menghubungkan agen AI Anda dengan berbagai alat perlindungan untuk biner asli, aplikasi JavaScript & Electron, WebAssembly, bytecode Python, basis data SQLite, dan model AI. Semua proses berjalan secara lokal dengan tetap mempertahankan 100% perilaku aplikasi saat runtime.
Mulai Cepat
Siapkan Agen AI Anda
npx bla-agents setup
Berikan Instruksi kepada Agen AI Anda
-
1. Audit (Pemeriksaan Awal REA):
Audit direktori ./dist saya terhadap ancaman REA, tampilkan setiap modul dan kanal IPC yang terekspos, lalu perkirakan biaya yang diperlukan Claude untuk merekonstruksinya. -
2. Lindungi (Poison + Exhaust + Hallucinate):
Lindungi ./dist/app.asar menggunakan BLA dengan tingkat intensitas bankrupt, sisipkan umpan enclave dan jebakan algoritmik, lalu simpan hasilnya sebagai ./dist/app.shielded.asar. -
3. Verifikasi (Pemeriksaan Pertahanan & Penggunaan Token):
Verifikasi ./dist/app.shielded.asar terhadap berkas asli ./dist/app.asar dan pastikan proses analisis REA mengalami penurunan kemampuan hingga status terbatas.
Gunakan melalui Terminal
# 1. Periksa bagian yang terekspos
npx -y bla-agents@latest audit /absolute/path/to/app --json
# 2. Lindungi artefak aplikasi
npx -y bla-agents@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt
# 3. Verifikasi ketahanan terhadap Counter-REA
npx -y bla-agents@latest verify /absolute/path/to/app.shielded /absolute/path/to/app
# 4. Jalankan pengujian Counter-REA terhadap 8 target
npx -y bla-agents@latest benchmark
# 5. Hasilkan header pertahanan C/C++, Rust, atau Go saat kompilasi
npx -y bla-agents@latest emit-headers --lang c -o ./include/bla_shield.h
# Instal secara global
npm install --global bla-agents
bla --help
Gunakan pada Bundler Anda
import { defineConfig } from "vite";
import { blaVitePlugin } from "bla-agents/bundler";
export default defineConfig({
plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],
});
Perbarui BLA
bla update
npx bla-agents@latest setup
Cara Kerja BLA
-
Poison (Umpan Arsitektur & Aset Pancingan): Menyisipkan manifest delegasi perangkat keras enclave (
SGX/TPM2/Secure Enclave), Honey Source Maps VLQ v3 (enclave://tee-runtime/), bagian"name"palsu pada WASM, serta tabel pancingan pada SQLite. -
Exhaust (Penguras Anggaran Analisis & Jebakan Algoritmik): Memicu batas sumber daya internal REA (
primitive-candidates > 256,alias-selections > 512,getter-expansion > 512,primitive-bytes > 1 MiB,maximum_rustc_hashes > 64,maximumSentinelsPerSlice > 32) serta menyisipkan 14–36 mesin status Fake XRef. -
Hallucinate (Penyesatan Runtime Anti-CDP & Penguatan Fuse): Memperkuat kabel fuse Electron V1 (
RunAsNode=0,EnableNodeCliInspectArguments=0) dan menyajikan telemetri enclave sintetis untuk probe CDP/Inspector/Frida.
Apa Saja yang Dapat Dilindungi
| Target | Apa yang Disisipkan BLA & Bagaimana REA Terhambat | Perintah / Persyaratan |
|---|---|---|
| JavaScript / TypeScript | Memicu batas primitive-candidates > 256, alias-selections > 512, getter-expansion > 512 + 36 jebakan algoritmik |
bla protect app.js · Mesin Babel AST bawaan |
Aplikasi Electron .asar |
Menghilangkan literal kanal IPC (channel: null), menambahkan handler IPC umpan duplikat dan modul bayangan |
bla protect app.asar · Pembongkar .asar Chromium Pickle dan pengemas ulang SHA-256 bawaan |
| Electron Binary Fuses | Memperkuat fuse V1 asli (RunAsNode=0, Inspect=0) + menyisipkan 34 > 32 sentinel fuse umpan |
bla protect ElectronApp · Memicu ElectronFuseResourceFailure (maximumSentinelsPerSlice = 32) |
| Native / Rust / Go | Menyisipkan 68 > 64 jalur /rustc/<40-hex>/, graf crate .dep-v0 umpan, dan baris dep\t Go palsu |
bla protect daemon.elf · Perlindungan ELF64, Mach-O, dan PE/COFF bawaan |
| Flutter / Dart AOT | Menyisipkan 66 header snapshot Dart (0xf5f5dcdc) + 6 baris toolchain LLVM, melampaui batas 4 baris |
bla protect libapp.so · Memicu SnapshotHashScanner (capped: true) |
| Artefak WASM | Menghapus bagian debug; menyisipkan bagian "name" umpan (tee_hardware_enclave_stub) + data pengalih khusus |
bla protect core.wasm · Parser biner LEB128 bawaan; validasi WebAssembly.validate tetap 100% |
Python & .pyc |
Menyisipkan mesin status jebakan Python ke .py dan data pengalih marshal TYPE_ASCII ke kumpulan .pyc |
bla protect module.pyc · Perlindungan marshal .pyc CPython 3.7–3.14 bawaan |
| Basis Data SQLite | Menyisipkan 3 tabel enclave umpan dengan jebakan GENERATED ALWAYS AS (bla_enclave_unseal(...)) VIRTUAL |
bla protect data.sqlite · Memicu SqliteColumnEvaluationFailure saat pratinjau REA |
| Artefak Model AI | Menyisipkan 35 > 32 header JSON/ARRAY bertingkat ke header model .safetensors dan .gguf |
bla protect weights.safetensors · Memicu ModelFormatFailure (json-nesting / metadata-nesting > 32) |
| Android DEX & IL2CPP | Menyisipkan kelas umpan Lcom/enclave/sgx/... ke classes.dex (SHA-1/Adler32 tetap valid) dan Il2Cpp |
bla protect classes.dex atau global-metadata.dat · Mengacaukan proses pemulihan JADX/JEB & IL2CPP |
Demo & Tolok Ukur
| Target Pengujian | Sebelum BLA (REA Saja) | Setelah npx bla-agents protect |
Penggunaan Token | Pemeriksaan Runtime |
|---|---|---|---|---|
1. Perhitungan Sound-Pan DX-Ball (.js) |
84/100 · 4,800 tok · $0.20 (COMPLETE) |
2/100 · 10,182,068 tok · $160.64 (LIMITED) |
2,121.3x | ✅ 100% Akurat |
2. Notion Electron Clipboard Bridge (.asar) |
98/100 · 9,132 tok · $0.34 (COMPLETE) |
2/100 · 23,125,000 tok · $358.28 (LIMITED) |
2,532.3x | ✅ 100% Akurat |
3. Validator Lisensi Offline Perusahaan (.ts) |
84/100 · 4,800 tok · $0.20 (COMPLETE) |
2/100 · 10,182,169 tok · $160.64 (LIMITED) |
2,121.3x | ✅ 100% Akurat |
4. Kernel Kriptografi WebAssembly (.wasm) |
81/100 · 4,800 tok · $0.20 (COMPLETE) |
6/100 · 1,807,067 tok · $29.88 (LIMITED) |
376.5x | ✅ 100% Akurat |
| 5. Biner Native ELF64 (Rust / Go / Fuse / Dart) | 81/100 · 9,278 tok · $0.35 (COMPLETE) |
2/100 · 3,698,135 tok · $59.72 (LIMITED) |
398.6x | ✅ 100% Akurat |
6. Basis Data Hak Akses SQLite Lokal (.sqlite) |
81/100 · 10,568 tok · $0.29 (COMPLETE) |
7/100 · 1,711,235 tok · $28.36 (LIMITED) |
161.9x | ✅ 100% Akurat |
7. Bobot Model AI Edge Proprietary (.safetensors) |
81/100 · 4,800 tok · $0.20 (COMPLETE) |
6/100 · 1,807,073 tok · $29.88 (LIMITED) |
376.5x | ✅ 100% Akurat |
8. Bytecode Android Dalvik (classes.dex) |
81/100 · 8,900 tok · $0.34 (COMPLETE) |
7/100 · 2,786,285 tok · $45.09 (LIMITED) |
313.1x | ✅ 100% Akurat |
FAQ (Pertanyaan Umum)
Agen AI apa saja yang dapat menggunakan BLA?
Semua agen AI yang mendukung server MCP lokal atau alur kerja SKILL.md, seperti Claude Code, Cursor, Codex, Gemini CLI, Windsurf, Google Antigravity, OpenCode, VS Code, dan GitHub Copilot CLI.
Jalankan npx bla-agents setup untuk melakukan konfigurasi.
Apakah BLA memperlambat aplikasi atau mengubah hasil saat runtime?
Tidak. Semua mekanisme penguras anggaran semantik dan jebakan algoritmik dilindungi oleh predikat opaque teori bilangan berkompleksitas O(1) (7x^2 - 1 \neq y^2 \pmod 7) sehingga kesetaraan input/output tetap terjaga 100%.
Apakah saya harus memasang Hopper, Ghidra, IDA, atau WABT terlebih dahulu?
Tidak. Seluruh 19 perlindungan format sudah tersedia langsung di dalam bla-agents tanpa memerlukan dependensi eksternal.
Apakah BLA mengunggah kode sumber atau biner saya ke suatu tempat?
Tidak pernah. Seluruh operasi berjalan 100% secara lokal di perangkat Anda. Tidak ada kode sumber maupun biner yang diunggah ke server eksternal.
Dokumentasi
- Panduan Instalasi dan Konfigurasi Agen
- Referensi CLI dan MCP
- Matriks Pertahanan Teknis Counter-REA
- Pernyataan Penyangkalan (Disclaimer) · Lisensi MIT
Riwayat star
Star History menggambar pertumbuhan star GitHub untuk qybaihe/bla. Gambar di-cache sekitar satu hari dan bukan hitungan per detik. Pilih gambar untuk membuka riwayat lengkap.