🛡️ BLA (Blind LLM Agents) — Adversarial defense shield that protects binaries, Electron apps, JS bundles, Python, and WebAssembly against AI reverse-engineering agents like REA. Poison -> Exhaust -> Hallucinate.
JavaScript adversarial-aiclaude-codecursorelectron-securityllm-securitymcpmcp-serverobfuscationreverse-engineeringwebassembly
docs(site): prefer harden UX, zh-CN FAQ limits/CrackMe, fix ID README
qybaihecccf0f475a4a
diff --git a/docs/readme/README_id.md b/docs/readme/README_id.mdindex b05ba5d..25d541a 100644--- a/docs/readme/README_id.md+++ b/docs/readme/README_id.md@@ -1,4 +1,4 @@- <div align="center">+<div align="center">[English](../../README.md) · [简体中文](README_zh.md) · [繁體中文](README_zh-TW.md) · [日本語](README_ja.md) · [한국어](README_ko.md) · [Türkçe](README_tr.md) · [Русский](README_ru.md) · [Tiếng Việt](README_vi.md) · [ไทย](README_th.md) · [Deutsch](README_de.md) · [Español](README_es.md) · [Français](README_fr.md) · [Українська](README_uk.md) · [Polski](README_pl.md) · [Português (Brasil)](README_pt-BR.md) · [العربية](README_ar.md) · [فارسی](README_fa.md) · **Bahasa Indonesia** · [Italiano](README_it.md) · [Ελληνικά](README_el.md) · [മലയാളം](README_ml.md) · [Roman Urdu](README_ur-Latn.md) · [Română](README_ro.md)diff --git a/website/assets/i18n.js b/website/assets/i18n.jsindex 7b03191..e23e39c 100644--- a/website/assets/i18n.js+++ b/website/assets/i18n.js@@ -4,7 +4,7 @@*/window.BLA_I18N = {en: {- "nav.badge": "BLUE SHIELD v1.1",+ "nav.badge": "BLUE SHIELD v1.5","nav.overview": "Overview","nav.getStarted": "Get Started","nav.showcase": "Benchmarks",@@ -25,7 +25,7 @@ window.BLA_I18N = {"sim.eyebrow": "Static & Semantic Analysis Comparison","sim.title": "Unprotected Baseline vs. Protected with BLA (`bla-agents`)","sim.lead":- 'Select a target format below to see how <code>npx bla-agents defend</code> changes static analyzer output, resource budget consumption, and reconstruction status.',+ 'Select a target format below to see how <code>npx bla-agents harden</code> changes static analyzer output, resource budget consumption, and reconstruction status.',"sim.tab.electron": "Electron .asar","sim.tab.dxball": "JavaScript / TypeScript","sim.tab.native": "Native ELF / Mach-O / PE",@@ -57,7 +57,7 @@ window.BLA_I18N = {"pillars.c3.tag": "03 · One-Command Workflow","pillars.c3.title": "MCP Server, CLI & Bundler Plugins","pillars.c3.desc":- 'Run <code>npx bla-agents setup</code> to register with Claude Code, Cursor, Codex, Windsurf, or Gemini CLI, then run the 5-stage protection pipeline with <code>bla_defend</code> or <code>npx bla-agents defend</code>.',+ 'Run <code>npx bla-agents setup</code> to register with Claude Code, Cursor, Codex, Windsurf, or Gemini CLI, then run the 5-stage protection pipeline with <code>bla_harden</code> or <code>npx bla-agents harden</code>.',"formats.eyebrow": "19 Supported Artifact Formats","formats.title": "Full-Stack & Binary Coverage, Zero External Dependencies","formats.lead": "Every static, bytecode, database, model, and binary protection pass runs locally in Node.js 22.13+ / 24+.",@@ -110,7 +110,10 @@ window.BLA_I18N = {"faq.q2": "Does BLA affect runtime performance or change program output?","faq.a2": "No. Static budget guards and call-graph state machines are placed behind O(1) bitwise invariants (such as <code>(Math.imul(x, x + 1) & 1) === 0</code>) inside unreachable branches, so hot-path execution remains unchanged.","faq.q3": "How do I run the full protection workflow in one step?",- "faq.a3": "Run <code>npx bla-agents@latest defend ./dist --manifest</code> from your terminal, or ask your connected coding agent to call the <code>bla_defend</code> MCP tool. It executes release exposure checks, auditing, protection, and verification in sequence.",+ "faq.a3": "Run <code>npx bla-agents@latest harden .</code> from your terminal, or ask your connected coding agent to call the <code>bla_harden</code> MCP tool. It executes release exposure checks, auditing, protection, and verification in sequence.",++ "faq.q5": "What are BLA's honest limits?",+ "faq.a5": "BLA raises analyzer cost and plants decoys; it is not a magic anti-RE seal. Traditional interactive reverse engineering (Ghidra, Frida, LLDB, JADX sessions) is out of scope of the commodity REA red-team numbers. Try the public <a href=\"https://github.com/qybaihe/bla/tree/main/challenge\">CrackMe challenge</a> to see how far an agent gets against a bankrupt-hardened fixture.","faq.q4": "Does BLA preserve existing GGUF model tensors and binary checksums?","faq.a4": "Yes. <code>protectGgufBuffer</code> preserves all original GGUF v2/v3 KV entries and trailing tensor slices while appending metadata entries, and Android DEX protection recomputes both the 20-byte SHA-1 signature and Adler32 checksum."},@@ -136,7 +139,7 @@ window.BLA_I18N = {"sim.eyebrow": "静态与语义分析对比","sim.title": "未保护基线 vs. BLA (`bla-agents`) 加固后","sim.lead":- '选择下方目标产物类型,查看执行 <code>npx bla-agents defend</code> 前后静态分析器的解析状态与分析开销变化。',+ '选择下方目标产物类型,查看执行 <code>npx bla-agents harden</code> 前后静态分析器的解析状态与分析开销变化。',"sim.tab.electron": "Electron .asar 桌面应用","sim.tab.dxball": "JavaScript / TypeScript","sim.tab.native": "原生二进制 ELF / Mach-O / PE",@@ -168,7 +171,7 @@ window.BLA_I18N = {"pillars.c3.tag": "03 · 一键接入与加固流程","pillars.c3.title": "支持 MCP 代理调用、CLI 与打包插件","pillars.c3.desc":- '运行 <code>npx bla-agents setup</code> 即可注册至 Claude Code、Cursor、Codex、Windsurf 与 Gemini CLI,通过 <code>bla_defend</code> 或 <code>npx bla-agents defend</code> 一键完成 5 阶段加固与验证。',+ '运行 <code>npx bla-agents setup</code> 即可注册至 Claude Code、Cursor、Codex、Windsurf 与 Gemini CLI,通过 <code>bla_harden</code> 或 <code>npx bla-agents harden</code> 一键完成 5 阶段加固与验证。',"formats.eyebrow": "支持 19 种软件与模型产物","formats.title": "全栈与原生二进制覆盖,零外部编译依赖","formats.lead": "所有源码、字节码、数据库、模型与原生二进制处理模块均在本地 Node.js 22.13+ / 24+ 运行。",@@ -221,9 +224,11 @@ window.BLA_I18N = {"faq.q2": "使用 BLA 加固会影响软件运行性能或改变输出结果吗?","faq.a2": "不会。所有静态预算守卫与扩展状态机均位于 O(1) 位运算不透明谓词(如 <code>(Math.imul(x, x + 1) & 1) === 0</code>)保护的不可达分支中,不会在正常热路径上执行。","faq.q3": "如何在配置完成后一键执行完整的保护流程?",- "faq.a3": "在终端运行 <code>npx bla-agents@latest defend ./dist --manifest</code>,或让已连接的编程代理调用 <code>bla_defend</code> MCP 工具,即可自动完成泄露检查、暴露审计、保护注入与结果验证。",+ "faq.a3": "在终端运行 <code>npx bla-agents@latest harden .</code>,或让已连接的编程代理调用 <code>bla_harden</code> MCP 工具,即可自动完成泄露检查、暴露审计、保护注入与结果验证。","faq.q4": "BLA 会影响 GGUF 模型权重或原生二进制的签名结构吗?","faq.a4": "不会。<code>protectGgufBuffer</code> 会完整保留 GGUF v2/v3 原有的全部 KV 键值对与尾部张量数据,Android DEX 处理模块则会自动重新计算 20 字节 SHA-1 签名与 Adler32 校验和。"+ "faq.q5": "BLA 的诚实边界是什么?",+ "faq.a5": "BLA 提高自动化分析成本并投放诱饵,并非万能反逆向封印。传统交互式逆向(Ghidra / Frida / LLDB / JADX 人工会话)不在现有 REA 红队数字范围内。欢迎挑战公开 <a href=\"https://github.com/qybaihe/bla/tree/main/challenge\">CrackMe</a>,观察代理在 bankrupt 加固样本上的表现。",},"zh-TW": {"nav.badge": "藍軍防護 v1.1",@@ -253,7 +258,7 @@ window.BLA_I18N = {"footer.tagline": "<strong>BLA (`bla-agents`)</strong> · Blind LLM Agents · 防禦性軟體保護工具 · MIT 開源協議"},ja: {- "nav.badge": "BLUE SHIELD v1.1",+ "nav.badge": "BLUE SHIELD v1.5","nav.overview": "概要","nav.getStarted": "クイックスタート","nav.showcase": "ベンチマーク",@@ -280,7 +285,7 @@ window.BLA_I18N = {"footer.tagline": "<strong>BLA (`bla-agents`)</strong> · Blind LLM Agents · Software Protection MCP & CLI · MIT License"},ko: {- "nav.badge": "BLUE SHIELD v1.1",+ "nav.badge": "BLUE SHIELD v1.5","nav.overview": "개요","nav.getStarted": "시작하기","nav.showcase": "벤치마크",@@ -305,7 +310,7 @@ window.BLA_I18N = {"footer.tagline": "<strong>BLA (`bla-agents`)</strong> · Blind LLM Agents · Software Protection MCP & CLI · MIT License"},es: {- "nav.badge": "BLUE SHIELD v1.1",+ "nav.badge": "BLUE SHIELD v1.5","nav.overview": "Resumen","nav.getStarted": "Empezar","nav.showcase": "Benchmarks",@@ -323,7 +328,7 @@ window.BLA_I18N = {"footer.tagline": "<strong>BLA (`bla-agents`)</strong> · Blind LLM Agents · Software Protection MCP & CLI · Licencia MIT"},fr: {- "nav.badge": "BLUE SHIELD v1.1",+ "nav.badge": "BLUE SHIELD v1.5","nav.overview": "Aperçu","nav.getStarted": "Démarrer","nav.showcase": "Benchmarks",@@ -341,7 +346,7 @@ window.BLA_I18N = {"footer.tagline": "<strong>BLA (`bla-agents`)</strong> · Blind LLM Agents · Software Protection MCP & CLI · Licence MIT"},de: {- "nav.badge": "BLUE SHIELD v1.1",+ "nav.badge": "BLUE SHIELD v1.5","nav.overview": "Übersicht","nav.getStarted": "Schnellstart","nav.showcase": "Benchmarks",diff --git a/website/faq/index.html b/website/faq/index.htmlindex 6e31640..c0d438c 100644--- a/website/faq/index.html+++ b/website/faq/index.html@@ -13,7 +13,7 @@<a href="../" class="brand"><img src="../assets/logo.png" alt="BLA Shield Logo" class="brand-logo" width="38" height="38" /><span>BLA</span>- <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.1</span>+ <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.5</span></a><nav class="nav-links"><a href="../" class="nav-link" data-i18n="nav.overview">Overview</a>@@ -68,7 +68,7 @@<details class="evidence-drawer"><summary data-i18n="faq.q3">How do I run the full protection workflow in one step?</summary><div class="drawer-body" style="white-space: normal" data-i18n-html="faq.a3">- Run <code>npx bla-agents@latest defend ./dist --manifest</code> from your terminal, or ask your connected coding agent to call the <code>bla_defend</code> MCP tool. It executes release exposure checks, auditing, protection, and verification in sequence.+ Run <code>npx bla-agents@latest harden .</code> from your terminal, or ask your connected coding agent to call the <code>bla_harden</code> MCP tool. It executes release exposure checks, auditing, protection, and verification in sequence.</div></details>@@ -78,6 +78,12 @@Yes. <code>protectGgufBuffer</code> preserves all original GGUF v2/v3 KV entries and trailing tensor slices while appending metadata entries, and Android DEX protection recomputes both the 20-byte SHA-1 signature and Adler32 checksum.</div></details>+ <details class="drawer">+ <summary data-i18n="faq.q5">What are BLA's honest limits?</summary>+ <div class="drawer-body" style="white-space: normal" data-i18n-html="faq.a5">+ BLA raises analyzer cost and plants decoys; it is not a magic anti-RE seal. Traditional interactive reverse engineering is out of scope of the commodity REA red-team numbers. Try the public CrackMe challenge on GitHub.+ </div>+ </details></div></div></section>diff --git a/website/get-started/index.html b/website/get-started/index.htmlindex c4890a0..e883f75 100644--- a/website/get-started/index.html+++ b/website/get-started/index.html@@ -13,7 +13,7 @@<a href="../" class="brand"><img src="../assets/logo.png" alt="BLA Shield Logo" class="brand-logo" width="38" height="38" /><span>BLA</span>- <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.1</span>+ <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.5</span></a><nav class="nav-links"><a href="../" class="nav-link" data-i18n="nav.overview">Overview</a>@@ -67,9 +67,9 @@<span class="card-tag" data-i18n="gs.s2.tag">Step 2 · 5-Stage Protection Pipeline</span><h3 data-i18n="gs.s2.title">Audit, Protect, and Verify in One Command</h3><p data-i18n="gs.s2.desc">- Runs source-map exposure checks, static audit, format-specific protection, runtime equivalence verification, and manifest generation.+ Runs source-map exposure checks, static audit, format-specific protection, and runtime equivalence verification. Pass --manifest only if you want an unsigned attestation JSON next to artifacts.</p>- <pre class="code-block">npx bla-agents@latest defend ./dist --manifest</pre>+ <pre class="code-block">npx bla-agents@latest harden .</pre></div></div></div>@@ -87,7 +87,7 @@<span class="card-tag" data-i18n="gs.s3.c1.tag">Agent Prompt</span><h3 data-i18n="gs.s3.c1.title">Prompt for Claude Code / Cursor</h3><p data-i18n-html="gs.s3.c1.desc">Once <code>setup</code> is complete, ask your coding agent:</p>- <pre class="code-block">"Run bla_defend on ./dist with bankrupt intensity and emit a verification manifest."</pre>+ <pre class="code-block">"Harden my software against REA (bla_harden on the project directory)."</pre></div><div class="card">diff --git a/website/guides/index.html b/website/guides/index.htmlindex 20db4d3..6eaf1ab 100644--- a/website/guides/index.html+++ b/website/guides/index.html@@ -13,7 +13,7 @@<a href="../" class="brand"><img src="../assets/logo.png" alt="BLA Shield Logo" class="brand-logo" width="38" height="38" /><span>BLA</span>- <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.1</span>+ <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.5</span></a><nav class="nav-links"><a href="../" class="nav-link" data-i18n="nav.overview">Overview</a>diff --git a/website/index.html b/website/index.htmlindex 0aee64a..547989f 100644--- a/website/index.html+++ b/website/index.html@@ -19,7 +19,7 @@<a href="./" class="brand"><img src="assets/logo.png" alt="BLA Shield Logo" class="brand-logo" width="38" height="38" /><span>BLA</span>- <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.1</span>+ <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.5</span></a><nav class="nav-links"><a href="./" class="nav-link active" data-i18n="nav.overview">Overview</a>@@ -67,10 +67,10 @@</p><div class="command-box">- <code class="command-code">npx bla-agents@latest setup && npx bla-agents@latest defend ./dist</code>+ <code class="command-code">npx bla-agents@latest setup && npx bla-agents@latest harden .</code><buttonclass="copy-btn"- data-copy="npx bla-agents@latest setup && npx bla-agents@latest defend ./dist --manifest"+ data-copy="npx bla-agents@latest setup && npx bla-agents@latest harden ."data-i18n="hero.copy">Copy@@ -102,7 +102,7 @@<div class="eyebrow" data-i18n="sim.eyebrow">Static & Semantic Analysis Comparison</div><h2 class="section-title" data-i18n="sim.title">Unprotected Baseline vs. Protected with BLA (`bla-agents`)</h2><p class="section-lead" data-i18n-html="sim.lead">- Select a target format below to see how <code>npx bla-agents defend</code> changes static analyzer output, resource budget consumption, and reconstruction status.+ Select a target format below to see how <code>npx bla-agents harden</code> changes static analyzer output, resource budget consumption, and reconstruction status.</p></div>@@ -197,7 +197,7 @@<span class="card-tag" data-i18n="pillars.c3.tag">03 · One-Command Workflow</span><h3 data-i18n="pillars.c3.title">MCP Server, CLI & Bundler Plugins</h3><p data-i18n-html="pillars.c3.desc">- Run <code>npx bla-agents setup</code> to register with Claude Code, Cursor, Codex, Windsurf, or Gemini CLI, then run the 5-stage protection pipeline with <code>bla_defend</code> or <code>npx bla-agents defend</code>.+ Run <code>npx bla-agents setup</code> to register with Claude Code, Cursor, Codex, Windsurf, or Gemini CLI, then run the 5-stage protection pipeline with <code>bla_harden</code> or <code>npx bla-agents harden</code>.</p></div></div>diff --git a/website/showcase/index.html b/website/showcase/index.htmlindex 17216a8..55e9810 100644--- a/website/showcase/index.html+++ b/website/showcase/index.html@@ -13,7 +13,7 @@<a href="../" class="brand"><img src="../assets/logo.png" alt="BLA Shield Logo" class="brand-logo" width="38" height="38" /><span>BLA</span>- <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.1</span>+ <span class="brand-badge" data-i18n="nav.badge">BLUE SHIELD v1.5</span></a><nav class="nav-links"><a href="../" class="nav-link" data-i18n="nav.overview">Overview</a>@@ -49,7 +49,7 @@<div class="eyebrow" data-i18n="sc.eyebrow">8-Target Benchmark Suite</div><h1 class="section-title" data-i18n="sc.title">Unprotected Baseline vs. BLA Protected Output</h1><p class="section-lead" data-i18n-html="sc.lead">- Run all 8 benchmark targets locally with <code>npx bla-agents@latest benchmark</code>.+ Run the local benchmark suite (and optionally the public CrackMe challenge) with <code>npx bla-agents@latest benchmark</code>.</p></div>