[!IMPORTANT] 请从官方仓库 qybaihe/bla 或 npm 包 bla-agents 获取 BLA。

BLA 是一个面向软件发布产物的防御性 MCP 服务与 CLI 工具，用于评估、加固并验证软件对 AI 自动化逆向工具（如 REA）的抗分析能力。它可以在不修改业务源码的前提下，扫描发布产物中的符号与 SourceMap 暴露面、注入特定格式的静态与运行时保护层，并验证加固后产物的运行时行为与原版完全一致。

BLA 支持将你的编程代理连接到原生二进制、JavaScript 与 Electron 应用、WebAssembly 模块、Python 字节码、SQLite 数据库、AI 模型权重与移动端包体的保护工作流中。你也可以直接在终端或打包工具（Vite / Webpack / Rollup / esbuild）中调用相同能力。

setup 会向你的编程代理注册 BLA 的 MCP 服务并安装配套技能说明。所有静态、字节码与二进制保护模块均已内置，无需额外安装外部编译器或第三方加壳工具。

快速开始

配置你的 Agent

安装 Node.js 与 npm 后，运行：

npx bla-agents setup

选择你使用的编程代理（或加上 --all-detected --yes），预览变更并确认。setup 会注册 BLA 的 MCP 服务器并安装 blind-llm-agents 技能，同时自动备份原有配置文件。完成后重启你的 Agent 即可。

支持 Claude Code、Codex、Cursor、Gemini CLI、Windsurf、Google Antigravity、OpenCode、VS Code 与 GitHub Copilot CLI。手动配置方式参见安装与配置指南。

在 Agent 中使用

连接完成后，可以直接通过自然语言调用完整的 5 阶段加固流程，或按步骤单独执行：

• 一键执行完整保护流程（bla_defend —— 暴露巡检 → 风险审计 → 护盾注入 → 等价性验证 → 签名清单）：

  对 ./dist 目录执行 bla_defend（使用 bankrupt 级别并输出验证清单）。
  

• 1. 发布前暴露面审计（Audit）：

  使用 BLA 审计 ./dist 目录，列出暴露的模块、符号和 Electron IPC 通道，并评估自动化逆向还原的风险。
  

• 2. 保护目标产物（Protect）：

  使用 BLA 保护 ./dist/app.asar，将加固后的产物输出到 ./dist/app.shielded.asar。
  

• 3. 验证保护效果与运行一致性（Verify）：

  对比验证 ./dist/app.shielded.asar 与原文件 ./dist/app.asar，确认静态分析状态已降级为 limited 且功能保持一致。
  

使用终端命令

所有工作流均可通过 npx bla-agents（或全局安装后的 bla）在终端直接运行：

• 一键完整保护流程（defend） —— 单条命令依次执行 inspect-release、audit、protect、verify 并生成 .bla-manifest.json：

  npx -y bla-agents@latest defend /absolute/path/to/app --manifest
  

• 1. 审计目标暴露度（audit） —— 查看暴露评分（0–100）、可见符号与预估分析开销：

  npx -y bla-agents@latest audit /absolute/path/to/app --json
  

• 2. 保护目标产物（protect） —— 应用静态预算阈值保护、调用图扩展、诱饵元数据与运行时检测：

  npx -y bla-agents@latest protect /absolute/path/to/app -o /absolute/path/to/app.shielded --intensity bankrupt
  

• 3. 验证保护结果（verify） —— 检查静态/语义分析器是否触发资源上限并保持运行等价：

  npx -y bla-agents@latest verify /absolute/path/to/app.shielded /absolute/path/to/app
  

• 4. 运行 8 项基准测试（benchmark）：

  npx -y bla-agents@latest benchmark
  

• 5. 生成 C/C++、Rust 或 Go 编译期保护头文件（emit-headers）：

  npx -y bla-agents@latest emit-headers --lang c -o ./include/bla_shield.h
  

如需全局安装 bla 命令：

npm install --global bla-agents
bla --help

在构建打包工具中使用（Vite / Rollup / Webpack / esbuild）

导入 bla-agents/bundler，在构建阶段自动保护输出的 JS 分包、SourceMap 与 .wasm 模块：

import { defineConfig } from "vite";
import { blaVitePlugin } from "bla-agents/bundler";

export default defineConfig({
  plugins: [blaVitePlugin({ intensity: "bankrupt", enableHoneySourceMaps: true })],
});

更新 BLA

如果通过 npm install --global 或 bun add --global 安装：

bla update

如果使用 npx，可通过以下命令更新 Agent 注册配置与技能文件：

npx bla-agents@latest setup

工作原理

你的 Agent 通过 MCP 调用 BLA 来审计构建产物、应用特定格式的保护层并验证输出结果。当自动化逆向分析工具检查受保护的产物时，会遇到三层防御机制：

1. 静态与语义分析预算限流（Exhaustion）： 利用 $O(1)$ 数论不透明谓词与不可达分支中的强连通调用图（SCC），触发 REA 等分析器内部的静态资源上限（如 primitive-candidates > 256、alias-selections > 512、getter-expansion > 512、primitive-bytes > 1 MiB、maximum_rustc_hashes > 64、maximumSentinelsPerSlice > 32）。
2. 证据优先级与控制流干扰（Deception）： 在静态分析视图下将真实业务逻辑标记为 status: "unknown"，同时提供结构清晰的影子状态机、硬件飞地接口声明（SGX / TPM2 / Secure Enclave）以及 VLQ v3 诱饵 SourceMap，干扰模型的语义归因。
3. 运行时探针检测与 Fuse 加固（Runtime Guard）： 原地加固 Electron V1 Fuse 配置位（RunAsNode=0、EnableNodeCliInspectArguments=0），并在检测到 CDP、Node Inspector、Frida 或 WebDriver 动态挂载时返回合成遥测数据。

你可以保护哪些目标

BLA 要求 Node.js ^22.13.0 || >=24.0.0 与 npm，所有格式保护模块均在本地运行，无外部二进制依赖：

基准测试与案例

运行 npx bla-agents benchmark 可在本地执行全部 8 个基准测试案例，验证分析器降级效果与运行时等价性：

DX-Ball：声道计算模块的抗还原加固

在未保护状态下，静态分析可在数次工具调用内还原 clampPan 与 calculateSoundPanFromX。运行 npx bla-agents protect examples/dx-ball-sound-pan/sound-pan.js --intensity bankrupt 后，分析器的 parse_status 变为 "partial"，examination.status 降级为 "limited"（触发 alias-selections、primitive-bytes、primitive-candidates 阈值限制），同时所有输入坐标的计算返回值与原版完全一致。

Notion：隐藏 Electron 剪贴板 IPC 桥接拓扑

静态分析器通常通过匹配 ipcRenderer.invoke 与 ipcMain.handle 的字面量字符串来还原 Electron IPC 调用链。BLA 将真实 IPC 通道改写为 $\ge 9$ 段数论不透明条件表达式（使静态提取结果为 channel: null），并在相同字面量通道上注册诱饵处理器，从而触发 electron_call_paths_limited: true。

原生二进制、SQLite 与 AI 模型：触发解析器容量限制

当对受保护的产物执行 inspect_rust_binary、inspect_electron_fuses、inspect_sqlite_database 或 inspect_model_artifact 时，解析器会触发预设的资源阈值限制（Read-only data contains more than 64 distinct rustc commit paths、Slice 0 contains more than 32 Electron fuse sentinels、SqliteColumnEvaluationFailure、ModelFormatFailure: json-nesting）。

常见问题 (FAQ)

npx bla-agents@latest doctor
npx bla-agents@latest setup

文档

• 安装与 Agent 配置：Agent 自动注册、Bundler 插件集成、更新与卸载。
• CLI 与 MCP 契约说明：命令行参数、退出码与 JSON-RPC 2.0 MCP 工具定义。
• 反制 REA 技术矩阵：REA 内部资源阈值与对应的保护机制说明。

安全问题请通过 SECURITY.md 反馈。

免责声明

详见 DISCLAIMER.md。

BLA 是一款防御性软件保护工具，仅用于加固你拥有合法权利或获授权保护的软件、前端产物、模型与二进制文件。所有注入的元数据与辅助函数均保持原程序的正常运行时行为。

贡献指南

欢迎在 qybaihe/bla 提交 Issue 或 Pull Request。提交代码前请运行 npm run build && npm test && node dist/cli.js benchmark。

友情社区与公开挑战赛

• 🎯 BLA 公开逆向挑战赛 (challenge/) — 欢迎挂上 REA、Claude Opus、Codex 挑战经 BLA 加固的靶机程序，看看能否避开蜜罐假 Flag 拿到真 Flag！
• LINUX DO (linux.do) — 新的理想型社区

开源协议

MIT