Minor release. The agent journey end to end (harden, apply, restore, reports that say what was not done), JavaScript shield equivalence and masked strings, named imports from hardened CommonJS, a PCAP plant that stops REA 05be423 at its fixed tshark allowance, precise lint refusals, and the red-team harness on REA HEAD. SQLite's evaluation trap is now opt-in (--sqlite-eval-trap). Details in CHANGELOG.md under [3.5.0]. Version synced by scripts/sync-version.mjs (package.json, package-lock.json, src/identity.ts, CrackMe SEAL labels, README badges, STATE.md, SKILL.md, plugin manifests), plus .mcp.json, the GitHub Actions example and the website's structured data. Co-Authored-By: Claude Opus 5.5 <thomas@users.noreply.github.com>
23 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
Poison → Exhaust → Hallucinate. 让自动化逆向分析再次“破产”。
开源的 Counter-REA 蓝队防御 MCP 服务与 CLI 工具 —— 专为保护软件发布产物免受 AI 逆向分析代理(morluto/rea、自动化反编译与大模型逆向流水线)还原而设计,同时保持 100% 运行时等价。
🌐 官方网站 (bla.tools) · 📖 防御指南 · 📊 基准测试大盘 · 🎯 CrackMe 竞技场 · 🏢 企业级定制 · ⚖️ 免责声明
30 秒快速开始 · 工作原理(Agent 闭环) · 真机实测结果 · 格式覆盖矩阵 · 14 项基准测试 · CrackMe 竞技场 · 常见问题 (FAQ)
Important
仅限防御性使用: BLA 严格面向软件开发者与安全团队保护自有软件知识产权与发布产物。详见 DISCLAIMER.md。 请从官方仓库 qybaihe/bla 或 npm 包
bla-agents获取。
🔴 未接入 BLA 时AI 逆向代理( |
🛡️ 接入 BLA(
|
⚡ 100% 运行时等价所有预算爆破图与诱饵载荷均位于 |
⚡ 30 秒快速开始
方式一:单条命令一键加固(CLI)
指向任意项目或构建目录,BLA 会自动发现可保护产物(dist/、build/、.asar、.wasm、.sqlite、.safetensors、原生二进制、Python/C/Rust/Go)并依次执行 暴露审计 → 护盾注入 → 等价验证:
# 推荐 Node.js ^22.23.4 或 >=24.0.0
npx bla-agents harden . # 只写出部分镜像 .bla-hardened/,此时尚未交付
npx bla-agents harden . --apply # 交付:用加固后的文件替换构建产物
npx bla-agents harden . --restore # 撤销:恢复原始构建产物
请先完成构建——harden 只处理构建产物,不会改动工具链文件。--apply 只覆盖构建产物(绝不覆盖源码),原始文件备份在项目之外;发布前请对替换后的产物运行你自己的测试。
方式二:Agent 主导的闭环源码织入与产物加固(MCP + Skill)
一键将 BLA 注册到你的编程 Agent(支持 Claude Code、Cursor、Codex、Windsurf、Gemini CLI、GitHub Copilot CLI、VS Code、OpenCode、Antigravity):
npx bla-agents setup
随后只需在你的 Agent 中发送一句话:
使用 BLA 对当前项目进行防逆向闭环加固
宿主 Agent 将自动编排 BLA 的 31 个 MCP 工具(bla_weave_plan → 源码级状态缠绕与字符串加密 → bla_verify_weave → bla_harden → bla_verify),从源码结构到最终产物完成全链路防护。每个结果都带有 nextSteps,Agent 会据此把事情做完:先征得你同意,再用加固文件替换构建产物(apply),最后运行你的测试。
方式三:构建打包插件(Vite / Rollup / Webpack / esbuild)
在前端或全栈构建阶段自动保护 JS 分包、注入 VLQ v3 诱饵 SourceMap 并加固 .wasm 模块:
import { defineConfig } from "vite";
import { blaVitePlugin } from "bla-agents/bundler";
export default defineConfig({
plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],
});
🧠 工作原理:Agent 主导的四阶段闭环加固
传统混淆器仅做标识符重命名(如 _0x1a2b),在大语言模型的控制流归纳能力面前形同虚设;而重型商业虚拟化壳则容易破坏跨平台构建并带来高昂的性能损耗。
BLA 3.x 将宿主 Agent 的源码级手术织入与 19+ 种格式原生护盾深度结合:
flowchart LR
subgraph S1["阶段 1 · 侦察与规划"]
A["bla_audit / bla_lint"] --> B["bla_weave_plan"]
end
subgraph S2["阶段 2 · Agent 源码级手术"]
B --> C["bla_encrypt_strings\n(AST 区间 XOR + 密钥流)"]
C --> D["bla_bind_scope\n(多点调用栈与状态缠绕)"]
D --> E["bla_verify_weave"]
end
subgraph S3["阶段 3 · 多格式产物护盾"]
E --> F["bla_harden / bla_defend\n(19+ 格式护盾 + Self-Seal 自封印)"]
end
subgraph S4["阶段 4 · 对抗与等价门禁"]
F --> G["bla_verify\n(预算触发验证 + 100% 运行等价)"]
end
| 四大防御支柱 | 核心技术机制 | 对 AI 逆向代理的实际打击效果 |
|---|---|---|
| 1. Poison(认知投毒) | 植入符合格式规范的蜜罐凭据、SGX/TPM2/Secure Enclave 硬件飞地清单、VLQ v3 诱饵 SourceMap 与高拟真影子状态机。 | 迫使大模型在相互冲突的证据假说间分裂注意力,沿合成诊断线索陷入死胡同。 |
| 2. Exhaust(预算爆破) | 精确触发分析器的默认配额上限(primitive-candidates、ASAR 16 MiB 头部、WASM Wabt 表达上限、SQLite 虚拟生成列求值、AI 模型 32 层嵌套、PCAP tshark 字段输出(固定 8 MiB)、Electron 32 个 Fuse 哨兵)。 |
将 REA 的默认分析状态从 COMPLETE 降级为 LIMITED 或直接抛出容量异常。凡是 REA 允许调用方调高的配额,这只让攻击者多重试一次,而不是挡住分析——见实测表最后一列。 |
| 3. Entangle(反剥离缠绕) | 通过运行时 SHA-256 摘要(--self-seal、--sidecar-entangle)与多点调用域折叠(bla_bind_scope)将 JS ↔ WASM ↔ 原生二进制深度绑定。 |
阻止红队直接裁剪诱饵分支、NOP 单点校验或将导出函数当作离线解密 Oracle 调用。 |
| 4. Runtime(楚门世界) | 原地加固 Electron V1 Fuse 位(RunAsNode=0、Inspect=0),并检测 CDP、Inspector、Frida 与 WebDriver 挂载(runtime-shield.ts)。 |
在动态调试会话中返回可信的合成遥测数据,同时保证正常用户运行零感知。 |
🔬 真机对抗实测结果(vs. 真实 REA)
以下数据来自在标准硬件上直接运行真实 morluto/rea 分析 BLA 加固产物的实测记录(npm run redteam:rea)。完整机器可读报告见 docs/redteam/empirical-rea-validation.md / .json。
REA 的预算大多是调用方可以调高的默认值。 截至 REA
05be423(2026-11-17),这些上限是每次调用的入参或设置项,REA 自己的报错会告诉 Agent 该调哪一个(asar.max_header_bytes最高 256 MiB、max_interface_bytes最高 512 MiB、max_chunks、semantic_precision)。因此下表的 ❌ 表示 REA 按默认配置运行时在此止步:靠体积触发的诱饵只让攻击者多重试一次,并不能把 REA 挡在门外。最后一列标明哪些上限在 REA 中是写死的;JavaScript 字符串是唯一在调高预算后实测的一行。
最近一次记录:2026-11-18,REA 05be423,Node v26.12.1(macOS arm64),Wabt 1.0.42,tshark 4.4.1。REA 只在 Linux / Windows 上分析抓包文件,因此在 macOS 上由脚手架按 REA 自身 provider 里的参数执行它的两遍 tshark,再把输出交给 REA 的解析器。探针调不通 REA 时记为脚手架错误(status: unverified,退出码 2),不会算作预算命中。
| 产物格式 | 加固前 → 加固后体积 | REA 实测分析结果 | 实际触发的 REA 内部预算阈值 / 异常信息 | 调用方能否调高? |
|---|---|---|---|---|
| Go buildinfo | 50 KiB → 1.17 MiB | ⚠️ 判为格式损坏而拒绝 | BinaryFormatFailure — Go build-info string range is truncated。REA 读不到加固产物的构建信息,但它现在先检查字符串范围,再检查 max_build_info_bytes(1 MiB)——后者才是该诱饵瞄准的预算 |
未实测 |
| Erlang BEAM | 84 B → 241 KiB | ❌ 容量溢出拒绝 | max_chunks — BEAM form exceeds the 64-chunk budget |
能 — max_chunks |
| EVM 字节码 | 16 B → 4.00 MiB | ⚠️ 被接受,仅略低于上限 | 占用 EVM_PRODUCER_LIMIT_DEFAULTS.input_bytes 4,194,304 字节中的 4,190,208 字节;脚手架不运行 EVMole worker 本身 |
能 — producer_limits.input_bytes |
| PCAP 抓包 | 24 B → 1.91 MiB | ❌ 预算超限拒绝 | REA 向 tshark 请求 25 个选定字段,并把这部分输出限制在 8 MiB 的 TSHARK_JSON_MAX_BYTES 内:加固后的抓包输出 12.7 MiB,inspect_pcap_capture 以不可重试的资源错误失败。起作用的是 10 个 DNS 应答包——每个 4,076 条应答,都用 2 字节压缩指针指向一个 251 字符的名字,tshark 会把它完整打印出来。没有它们时,REA 读出了其余 160 个诱饵包(116 KiB) |
不能 — 固定上限,REA 没有对应设置 |
| Electron ASAR | 607 B → 16.9 MiB | ❌ 容量溢出拒绝 | DEFAULT_ASAR_MAX_HEADER_BYTES (16 MiB) |
能 — asar.max_header_bytes,最高 256 MiB |
| WASM + Wabt | 54 B → 6.56 MiB · 251 导出 | ⚠️ ifaceState=partial |
max_interface_bytes (32 MiB) — Typed WASM interface representation exceeds max_interface_bytes |
能 — 最高 512 MiB |
SQLite (Node 24,需 --sqlite-eval-trap) |
12 KiB → 56 KiB | ❌ 蜜罐表求值陷阱阻断 | SqliteColumnEvaluationFailure — 蜜罐虚拟生成列触发未知 enclave_unseal_payload()。该陷阱需显式开启(3.4.3 及之前为默认行为):它同样会让宿主程序自己的 PRAGMA integrity_check / VACUUM 失败。默认加固只加入 REA 可读的蜜罐表;业务表从不被隐藏。 |
不是预算——是求值失败 |
| JavaScript | 761 B → 153 KiB | ❌ 语义预算拒绝 | 同时触发 alias-selections + getter-expansion + primitive-bytes + primitive-candidates |
能 — semantic_precision |
| JavaScript 字符串 | 340 B → 154 KiB | ✅ 3 个已知值均不在 REA 的结果中 | 一个接口 URL、一个 IPC 通道名、一个 SHA-256 摘要,分别在 1× / 4× / 64× 预算下测试;未加固时 REA 三个全部读出。3.4.3 及之前分片以明文写出:REA 在默认预算下就列出通道名,预算调高 4× 后三个全部列出 | 本行已调高至 64× |
| Safetensors | 128 B → 9.7 KiB | ❌ 容量溢出拒绝 | MODEL_JSON_NESTING — Safetensors JSON nesting exceeds 32 levels(HF 正常加载,权重不变) |
不能 — 固定 32 |
| GGUF 模型 | 24 B → 7.3 KiB | ❌ 容量溢出拒绝 | MODEL_METADATA_NESTING — GGUF metadata nesting exceeds 32 array frames |
不能 — 固定 32 |
| Electron Fuses | 50 KiB → 1.17 MiB | ❌ 预算超限拒绝 | ELECTRON_FUSE_LIMITS.maximumSentinelsPerSlice (>32) |
不能 — 固定 32 |
| Flutter 常量池 | 50 KiB → 1.17 MiB | ⚠️ 触发截断上限 | MAX_POOL_URIS / MAX_POOL_TOKENS(REA 输出被截断) |
能 — uri_limit / token_limit |
🛡️ 支持的产物格式与覆盖矩阵
全部 19+ 种格式护盾均内置于 bla-agents,无需安装任何外部加壳器或编译器:
| 产物格式 | 蜜罐凭据 + 诊断诱饵 | 资源预算爆破 | 真机 REA 验证 | 说明 |
|---|---|---|---|---|
| JavaScript / TypeScript | ✓ | ✓ 语义预算爆破 | 已验证 | 内置 Babel AST;AST 安全字符串加密;自封印校验 |
Electron .asar |
✓ | ✓ 16 MiB 头部爆破 | 已验证 | IPC 通道去字面量化 + Chromium Pickle 重打包 |
| Electron Fuses | ✓ | ✓ >32 哨兵填充 | 已验证 | V1 Fuse 位加固 + 哨兵预算爆破 |
WebAssembly (.wasm) |
✓ 自定义段 | ✓ 导出符号诱饵 | 已验证 (Wabt) | 内置 LEB128 解析器,保持 WebAssembly.validate 通过 |
SQLite (.sqlite / .db) |
✓ 蜜罐表 + 虚拟列 | ✓ 生成列求值阻断 | 已验证 (Node 24) | 魔数精准校验;支持 WITHOUT ROWID 业务表 |
Safetensors (.safetensors) |
✓ 元数据诱饵 | ✓ JSON 嵌套 >32 层 | 已验证 | 兼容 HuggingFace 加载,张量数据零改动 |
GGUF (.gguf) |
✓ | ✓ 数组嵌套 >32 层 | 已验证 | 保持模型权重与 KV 张量完整 |
| Go buildinfo (ELF) | ✓ | ✓ >1 MiB 构建信息 | 已验证(格式拒绝) | 映射 ELF 节区注入 |
Windows PE (.exe / .dll) |
✓ | ✓ .enclave COFF 映射节区 + Fuse/Rust/Dart |
已验证 | 注入映射 .enclave 节区、x86-64 函数序言岛、MSVC RTTI 与 CodeView RSDS 调试记录 |
| Flutter / Dart Pool | ✓ | ✓ URI/Token 阈值填充 | 已验证 | 快照魔数与工具链标识填充 |
Erlang BEAM (.beam) |
✓ | ✓ Chunk / Atom 填充 | 已验证 | 突破 64-chunk 预算上限 |
| EVM + Solidity 元数据 | ✓ | ✓ 逼近 4 MiB 上限 | 已验证 | CBOR 元数据与字节码致密化 |
PCAP (.pcap) |
✓ | ✓ REA 的 tshark 字段输出 >8 MiB(固定上限) | 已验证(tshark 4.4.1) | 合成流量包与金丝雀凭据注入;bankrupt 下追加 DNS 应答洪泛 |
Python (.py / .pyc) |
✓ | ✓ | 设计支持 | 支持 CPython 3.7–3.14 字节码与源码保护 |
NVIDIA PTX (.ptx) |
✓ | 入口洪泛 | 基准测试验证 | GPU PTX 文本核函数洪泛 |
| DEX / IL2CPP / bplist / .NET / JVM / ZIP | ✓ | 格式专属护盾 | 设计支持 | 自动重算 DEX SHA-1 与 Adler32 校验和 |
📊 基准测试(14 个目标产物,内部模型估算)
在本地运行 npx bla-agents benchmark 即可复现全部 14 个代表性产物的加固效果与 100% 运行时/结构等价校验:
说明: 下表中的 Token 与美元成本列为基于
token-estimator.ts静态公式推导的内部模型估算值(用于横向对比不同格式下的义务节点膨胀倍率);真实morluto/rea进程级预算爆破结果请参见上方真机对抗实测结果。
汇总结果: 模型估算 Token 消耗放大 ~1,068.7× · 估算成本放大 ~503.5× · 14/14 (100%) 内置基准样本通过执行/查询/结构等价校验。
| 基准测试目标 | 未保护基线(估算) | BLA 加固后(估算) | Token 放大倍率 | 运行时等价 |
|---|---|---|---|---|
1. DX-Ball 声道平移计算 (.js) |
84/100 · 4,800 tok · $0.20 | 2/100 · 15.2M tok · $238.02 · LIMITED |
3,172.7× | ✅ 100% |
2. Notion Electron 剪贴板桥 (.asar) |
98/100 · 9,132 tok · $0.34 | 2/100 · 23.1M tok · $358.57 · LIMITED |
2,532.3× | ✅ 100% |
3. 企业级离线授权校验模块 (.ts) |
87/100 · 4,800 tok · $0.20 | 2/100 · 15.2M tok · $238.02 · LIMITED |
3,172.7× | ✅ 100% |
4. NVIDIA PTX 计算核 (.ptx) |
81/100 · 4,800 tok · $0.20 | 7/100 · 23.1M tok · $358.20 · LIMITED |
4,814× | ✅ 100% |
5. Erlang BEAM 模块 (.beam) |
81/100 · 8,900 tok · $0.34 | 5/100 · 3.86M tok · $62.08 · LIMITED |
433.2× | ✅ 100% |
6. WebAssembly 密码学核 (.wasm) |
81/100 · 4,800 tok · $0.20 | 6/100 · 1.83M tok · $30.23 · LIMITED |
381.5× | ✅ 100% |
7. 端侧 AI 权重文件 (.safetensors) |
81/100 · 4,800 tok · $0.20 | 6/100 · 1.81M tok · $29.90 · LIMITED |
376.8× | ✅ 100% |
8. libpcap 网络抓包 (.pcap) |
81/100 · 4,800 tok · $0.20 | 7/100 · 23.1M tok · $359.27 · LIMITED |
4,817.7× | ✅ 100% |
9. Android Dalvik 字节码 (.dex) |
81/100 · 8,900 tok · $0.34 | 7/100 · 13.4M tok · $209.39 · LIMITED |
1,510.5× | ✅ 100% |
10. EVM Solidity 元数据 (.bin) |
81/100 · 6,440 tok · $0.26 | 6/100 · 1.78M tok · $29.40 · LIMITED |
276.3× | ✅ 100% |
11. .NET 托管程序集 (.dll) |
81/100 · 8,900 tok · $0.34 | 6/100 · 2.01M tok · $33.22 · LIMITED |
226.3× | ✅ 100% |
12. Apple 二进制属性表 (.plist) |
81/100 · 6,440 tok · $0.26 | 8/100 · 1.79M tok · $29.54 · LIMITED |
277.6× | ✅ 100% |
13. SQLite 授权数据库 (.sqlite) |
81/100 · 10,568 tok · $0.29 | 7/100 · 1.71M tok · $28.39 · LIMITED |
162.1× | ✅ 100% |
| 14. Native ELF64 二进制 (Rust/Go/Fuse/Dart) | 81/100 · 35,222 tok · $0.73 | 2/100 · 3.72M tok · $60.03 · LIMITED |
105.6× | ✅ 100% |
🎯 红蓝对抗 CrackMe 竞技场
仓库内置了公开的 BLA 加固挑战靶场(SEAL.json 仅包含 SHA-256 哈希,仓库中不存任何明文密钥或 Flag),欢迎用你的逆向 Agent 实测挑战:
| 挑战关卡 | 架构形态 | 核心加固特性 | 本地运行验证 |
|---|---|---|---|
| CrackMe v6 | Node Vault + HTML 面板 + WASM 核 | bankrupt 级别加固、跨文件哈希自封印、WASM 导出符号混淆 |
npm run crackme:v6 -- '<key>' |
| CrackMe v7 | 多语言混合靶场 (JS + WASM + Rust + Go + C) | 跨语言状态纠缠与多二进制完整性门禁 | npm run crackme:v7 -- '<key>' |
| CrackMe v8 | Aegis 分片密钥金库 | AST 字符串加密(bla_encrypt_strings)+ 调用域状态绑定(bla_bind_scope) |
npm run crackme:v8 -- '<key>' |
| CrackMe v9 | Agent 闭环织入深度缠绕金库 | 完整 BLA 3.x 闭环织入(weaveScore >= 70)+ 分布式防篡改自校验 |
npm run crackme:v9 -- '<key>' |
❓ 常见问题 (FAQ)
哪些编程代理(Agents)可以使用 BLA?
任何支持本地 MCP 服务器或 SKILL.md 的 AI 编程代理均可使用。npx bla-agents setup 支持自动配置 Claude Code、Cursor、Codex、Gemini CLI、Windsurf、Google Antigravity、OpenCode、VS Code 与 GitHub Copilot CLI。详见安装指南。
BLA 会影响软件运行速度或改变原有的运行结果吗?
不会。BLA 注入的静态分析预算守卫与扩展调用图均位于 O(1) 数论不透明谓词($7x^2 - 1 \neq y^2 \pmod 7$)保护的不可达分支或惰性节区内,不会在正常热路径上执行。全部 14 个基准测试目标均通过了 100% 输入/输出一致性校验。
保护文件时需要安装 Hopper、Ghidra、IDA 或 WABT 吗?
不需要。BLA 的全部 19+ 种格式处理模块均内置在 bla-agents 中,无外部工具依赖。
BLA 会上传源码或二进制文件吗?
不会。BLA 的所有审计、源码手术、加固与验证均在本地离线完成,自动为每个项目在 .blarc 生成独立随机种子,不发起任何网络请求。
📚 文档与社区
- ⚖️ 免责声明 (DISCLAIMER.md)
- 🚀 安装与 Agent 配置指南
- 🛠️ CLI 与 25 项 MCP 工具完整手册
- 🤖 一键式 Agent 闭环防御指南
- 🧬 Weave-Decoy 源码织入说明
- 🔬 真机 REA 对抗验证报告
- 💬 LINUX DO (
linux.do) — 新的理想型社区
📄 开源协议
Star 增长
Star History 绘制 qybaihe/bla 的 GitHub Star 增长曲线。图片由对方缓存约一天,不是逐秒计数。点击图片可打开完整历史。