Files
qybaihe 584416ec9e chore(release): bla-agents v3.5.0
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>
2026-11-18 15:48:54 +08:00

23 KiB
Raw Permalink 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 Shield

BLA: Blind LLM Agents

Poison → Exhaust → Hallucinate. 让自动化逆向分析再次“破产”。

开源的 Counter-REA 蓝队防御 MCP 服务与 CLI 工具 —— 专为保护软件发布产物免受 AI 逆向分析代理(morluto/rea、自动化反编译与大模型逆向流水线)还原而设计,同时保持 100% 运行时等价。

npm version GitHub Trending MCP Server Formats Counter-REA MIT License

GitHub Trending — 当日趋势榜第 5 名

🌐 官方网站 (bla.tools) · 📖 防御指南 · 📊 基准测试大盘 · 🎯 CrackMe 竞技场 · 🏢 企业级定制 · ⚖️ 免责声明

30 秒快速开始 · 工作原理(Agent 闭环) · 真机实测结果 · 格式覆盖矩阵 · 14 项基准测试 · CrackMe 竞技场 · 常见问题 (FAQ)


Important

仅限防御性使用: BLA 严格面向软件开发者与安全团队保护自有软件知识产权与发布产物。详见 DISCLAIMER.md。 请从官方仓库 qybaihe/bla 或 npm 包 bla-agents 获取。

未受保护产物与 BLA 加固产物的逆向分析对比

🔴 未接入 BLA 时

AI 逆向代理(REA + 编程 Agent)可在单条命令内解包 .asar、还原 SourceMap、配对 IPC 通道、提取 .wasm / .sqlite / .safetensors,在数十秒、约 $0.20 成本内完整克隆核心业务逻辑。

🛡️ 接入 BLA(bla harden .)后

REA 的默认分析流程直接撞上它自己的资源配额(primitive-candidates > 256、ASAR > 16 MiB、WASM > Wabt 上限、SQLite 虚拟生成列陷阱),陷入高拟真影子状态机,模型化估算 Token 消耗放大 300×–2,800×(基于 token-estimator.ts 内部成本模型)。这些配额大多可由调用方调高,含义见实测结果。

⚡ 100% 运行时等价

所有预算爆破图与诱饵载荷均位于 O(1) 数论不透明谓词($7x^2 - 1 \neq y^2 \pmod 7$)保护的不可达分支或惰性元数据段中。14/14 个基准测试目标 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 生成独立随机种子,不发起任何网络请求。


📚 文档与社区

📄 开源协议

MIT

Star 增长

Star History 绘制 qybaihe/bla 的 GitHub Star 增长曲线。图片由对方缓存约一天,不是逐秒计数。点击图片可打开完整历史。

qybaihe/bla 仓库的 GitHub Star 增长曲线