🌐 English
v0.4.0(2026-10-28):安全左移版本。JGD 现在可插入 GitHub Actions、GitLab CI、Jenkins、pre-commit 和 Nexus 仓库事件,提供 SARIF、baseline 差异和确定性失败卡点。
v0.3.0(2026-10-28):集成、性能与正确性版本。JGD 现在可通过 CLI/JSON/SARIF、MCP 和 A2A 被其他代码审计 agent 调用;字节码索引与动态探测已提速;修复 CC3、延迟触发、增量覆盖等正确性问题。
- GitHub Actions:根目录
action.yml复合 Action,输出 SARIF、gate.json、稳定退出码和 job summary。 - Nexus webhook:
jgd serve webhook,Bearer Token / HMAC-SHA256、Nexus URL 白名单、仅接受.jar、512MB 上限。 - 其他入口:GitLab CI、Jenkins、pre-commit;模板位于
ci/。 - Baseline 门禁:
--baseline prior-run.json只让新发现阻塞,历史问题仍保留在报告中。 - 保留 0.3.0 记录:此前的 agent 集成、性能优化与正确性修复仍在下方保留。
- 可接入其他代码审计 agent:CLI + JSON/SARIF、MCP stdio、A2A JSON-RPC/SSE;外部 agent 只传目标、授权、profile 和预算,JGD 内部完成桥发现、链配对、动态验证与 PoC 终止。
- 速度:SQLite 字节码索引支持增量跳过;828-JAR 热查询约 0.038s,旧路径约 2.56s(约 67 倍);动态探针按 classpath 批量复用 JVM。
- 正确性:修复 CC3
ChainedTransformer构造与getMethod -> invoke -> exec链、延迟 HashMap 触发、热索引覆盖统计、Spring Boot 嵌套 JAR 索引,以及 LLM 终态把关残留。
一个自主挖掘 agent:输入任意 JAR 目录,输出:
- 已知公开链 — 四态判定(在场 / 版本 / 可组装 / 可点火)
- 未公开新链 — 静态+动态分析 + 对抗式 LLM 审计发现
- 武器化 PoC — 序列化载荷 + RCE 闭环演示(良性标记文件)
全部决策已内化:jar 进 → 链子出,零中间用户交互。
┌─────────────────────────────────────────────────────────────────┐
│ 输入: 任意 JAR 目录 输出: 链 + PoC │
│ │
│ ┌──────────┐ ┌──────────┐ ┌──────────┐ ┌──────────┐ │
│ │ 公开链 │──▶│ 桥发现 │──▶│ 链配对 │──▶│ PoC │ │
│ │ 判定 │ │ (静态) │ │ (动态) │ │ 武器化 │ │
│ └──────────┘ └──────────┘ └──────────┘ └──────────┘ │
│ 签名+版本门 字节码+CHA图 契约合成 良性载荷 │
│ +分派边 +五载体 +点火测试 │
└─────────────────────────────────────────────────────────────────┘
这些是历史研究候选,不代表当前任何目标的结论;只有 fired_at_deser=true 才由确定性 verifier 记为 CHAIN_CONFIRMED。
| 链 | 桥接类 | 载体 | JDK | 状态 |
|---|---|---|---|---|
| objlongpair-hashmap | org.apache.activemq.artemis.api.core.ObjLongPair |
HashMap rehash | 17+ | ✅ RCE已闭环 |
HashMap.readObject() → rehash → hash(key)
→ ObjLongPair.hashCode() → Objects.hash(first, second)
→ Arrays.hashCode() → first.hashCode() [Object 字段 — isInstance 恒真]
→ EqualsBean.hashCode() → beanHashCode()
→ ObjectBean.toString() → ToStringBean.toString()
→ Templates.getOutputProperties() → TemplatesImpl.newTransformer()
→ TemplatesImpl.defineClass() → payload 静态块 → RCE
新颖性:入口侧经对抗审计确认 T1 —— 未见于 ysoserial、GadgetInspector
及全部公开 CVE writeup。与所有已知 ROME 入口范式正交。
| 链 | 桥接类 | 载体 | JDK |
|---|---|---|---|
| tuple1-8-hashmap | io.vavr.Tuple1…Tuple8 |
HashMap | 11 |
| either$left/right | io.vavr.control.Either$Left/Right |
HashMap | 11 |
| option$some | io.vavr.control.Option$Some |
HashMap | 11 |
| validation$valid/invalid | io.vavr.control.Validation$Valid/Invalid |
HashMap | 11 |
| hamt$leafsingleton | io.vavr.HashArrayMappedTrie$LeafSingleton |
HashMap | 11 |
| 链 | 桥接类 | 载体 | JDK |
|---|---|---|---|
| composablepointcut | ComposablePointcut |
HashMap | 11 |
| union/intersectionmatcher | MethodMatchers$Union/Intersection |
HashMap | 11 |
| singletontargetsource | SingletonTargetSource |
BAVE | 11 |
| hotswappabletargetsource | HotSwappableTargetSource |
BAVE | 11 |
| defaultintroductionadvisor | DefaultIntroductionAdvisor |
BAVE | 11 |
| 链 | 桥接类 | 载体 | JDK |
|---|---|---|---|
| functions$formapwithdefault | Functions$ForMapWithDefault |
HashMap | 11 |
| predicates$isequalto | Predicates$IsEqualToPredicate |
HashMap | 11 |
| present | Present |
HashMap | 11 |
| 链 | 桥接类 | 依赖库 | 载体 | JDK |
|---|---|---|---|---|
| mutableobj-bave | MutableObj |
hutool-core | BAVE | ≤11 |
| antlr4-pair-bave | Pair |
antlr4-runtime | BAVE | ≤11 |
| clojure-proxy | proxy$…AbstractTableModel$ff19274a |
clojure | HashMap | 11 |
| jacksoninject$value | JacksonInject$Value |
jackson | BAVE | 11 |
| objectidgenerator$idkey | ObjectIdGenerator$IdKey |
jackson | BAVE | 11 |
| tolerantmap | TolerantMap |
snakeyaml | HashMap | 11 |
| scala-objectref | scala.runtime.ObjectRef |
scala-library | BAVE | 11 |
| 链 | 桥接类 | 依赖库 | 备注 |
|---|---|---|---|
| ewah-hashmap | EWAHCompressedBitmap |
JavaEWAH | 浅分派 |
| federation 等 4 条* | FederationConfiguration 等 |
Artemis | 配置类族 |
ObjLongPair (T1, JDK 17):
HashMap.put → HashMap.hash
→ ObjLongPair.hashCode(ObjLongPair.java:55)
→ Objects.hash → Arrays.hashCode
→ EqualsBean.hashCode → EqualsBean.beanHashCode
→ ObjectBean.toString → ToStringBean.toString → Method.invoke
→ TemplatesImpl.defineClass → payload static block
MutableObj (T2, JDK 11):
BAVE.readObject → val.toString()
→ MutableObj.toString → value.toString()
→ ObjectBean.toString → ToStringBean.toString
→ Templates.getOutputProperties → newTransformer → defineClass → RCE
# 环境要求: Python 3.10+, JDK 11 与 17, ECJ 编译器
pip install chromadb # 可选, RAG 持久化
# 指向任意 JAR 目录, 自动产出链 + PoC
python3 audit_target.py --target /path/to/jars --name "你的产品"
python3 tui.py # English
python3 tui.py --lang zh # 中文
| 按键 | 功能 |
|---|---|
↑ ↓ / j k |
导航链 |
Enter |
切换详情视图 |
t |
切换语言(中/英) |
q |
退出 |
jgd/
├── audit_target.py # 产品 CLI 入口
├── tui.py # 交互式 TUI
├── jgd/ # 核心 agent 模块 (25 个)
│ ├── verify_agent.py # 桥发现 + ds 对抗审计
│ ├── chain_complete.py # 链配对 + 穷尽证明
│ ├── poc_gen.py # 武器化 PoC 生成
│ ├── known_chains.py # 公开链四态判定
│ ├── matrix_agent.py # 多 JDK 探针编排
│ ├── bcdisasm.py # 纯 Python 字节码反汇编器
│ ├── bridge_fix.py # 操作数栈符号执行
│ ├── chroma_store.py # RAG(按语料指纹分域)
│ ├── llm.py # 双模型(GLM × DeepSeek)
│ ├── scope.py # 语料指纹隔离
│ ├── profiler.py # 节点级性能画像
│ ├── conductor.py # 验收门控终局
│ └── ...
├── examples/
│ ├── chains.json # 全部已发现链(机器可读)
│ └── chains.md # 人类可读链目录
├── tests/
│ └── test_smoke.py # 可第三方复现测试
├── ARCHITECTURE.md # 25 模块图 + 设计裁决
├── CHANGELOG.md # 设计决策史 (R6-R52)
├── SECURITY.md # 授权使用 + 负责任披露
├── CONTRIBUTING.md # 五项开发原则
└── LICENSE # MIT
- 精选签名库类匹配
- 版本门控(CC 3.2.2 阻断 functor、CC4 4.6 NotSerializable、BAVE JDK17 收窄 val 为 String 等实证截止点)
-
用目标自己的 JAR 动态组装 + 点火复验
-
静态:操作数栈符号执行检测接收者桥 + 参数桥
- 图:语料指纹门控实时建图 + CHA 分派边
- 动态:批处理并行 JVM 探针(五载体 × 字段契约合成 × 多 JDK)
-
可观测性:标记物可达性 + 异常栈帧 + 标记物调用者栈捕获
-
发现者 ≠ 验证者:GLM 选候选,DeepSeek 独立审计
- DSH 验收门控:终局判定被拒收则自动延长轮次继续挖
-
"声明 ≠ 证据"标准:每项修复须有测量证据
-
链从挖掘产物自动派生(
derive_chains) - 字段类型感知桥装配(
make_bridge支持 Object/接口-Proxy) - 尾巴候选循环至 RCE 闭环(
R42 完整性循环) - 良性载荷:仅写
/tmp标记文件
| 指标 | 数值 |
|---|---|
| 全管线(31 jars) | \~90s 端到端 |
| 配对吞吐 | 1500+ 对 / 9 分钟(批处理 + 4 并行) |
| PoC 生成(3 链) | 20.3s(并行加速 2.7×) |
| 单 JVM 内存 | ≤ 256 MB(-Xmx256m, 余量 28%) |
| 全语料 OOM | 0 |
| 主张 | 状态 |
|---|---|
| 公开链:必能检测 | 是 — 机械判定(有限签名集) |
| 未公开链:声明域内穷尽 | 是 — 覆盖账本可复算 |
| 未公开链:全域穷尽 | 否 — 不可判定(Rice 定理) |
| PoC:永远完整产出 | 是 — 尾巴候选循环至 RCE 闭环 |
| 载体家族:全部经典触发路径 | 是 — toString/hashCode/equals/compare/compareTo |
- ARCHITECTURE.md — 25 模块图, 设计裁决
- CHANGELOG.md — 47 轮演化史(R6-R52)
- examples/chains.md — 人类可读链目录
- SECURITY.md — 授权使用政策, 负责任披露
仅用于合法安全研究、教育和授权渗透测试。
所有 PoC 载荷仅写良性标记文件(/tmp/jgd_poc_fired)—— 无破坏动作。
MIT — Copyright (c) 2026 JGD Contributors