Skip to content

armgit / bla

Public Imported from GitHub
0

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

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.md
index 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.js
index 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) &amp; 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) &amp; 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.html
index 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.html
index 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.html
index 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.html
index 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 &amp;&amp; npx bla-agents@latest defend ./dist</code>
+ <code class="command-code">npx bla-agents@latest setup &amp;&amp; npx bla-agents@latest harden .</code>
<button
class="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 &amp; 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 &amp; 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.html
index 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>