Files
bla/docs/readme/README_id.md
T
Cursor Agent a0a8d3c596 docs(readme): add a cached Star History chart at the end
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>
2026-11-08 14:05:39 +00:00

12 KiB
Raw Blame History

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.

npm version MCP tool catalog Node.js requirements Counter-REA Verified MIT license

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.


Perbandingan sebelum BLA dan sesudah perlindungan BLA

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

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

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

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

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.

Grafik riwayat star repositori qybaihe/bla