jar-analyzer/jar-analyzer-claude/build-db

build-db — 构建 Jar Analyzer 分析数据库

概述

使用内置的 jar-analyzer-engine-1.2.0.jar 对目标 JAR/WAR/Class 文件进行静态分析， 生成 SQLite 数据库（jar-analyzer.db）。该数据库包含类信息、方法定义、方法调用关系、 继承关系、字符串常量、Spring 组件信息等，是后续所有分析操作的数据基础。

引擎位置

<plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar

<plugin_dir> 是本插件的安装目录（即包含 bin/、skills/ 的目录）。

运行前请确认 Java 8+ 已安装且在 PATH 中。

命令参考

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar [options]

必选参数

可选参数

黑白名单说明

• 使用 / 分隔的包名格式（如 com/example/app）
• 白名单：仅分析匹配的包/类
• 黑名单：排除匹配的包/类
• 支持直接传入文本，或指定一个文件路径（每行一个包名/类名）
• 黑白名单不能同时使用

输出

数据库包含的信息

标准操作流程（SOP）

1. 确认环境

java -version
# 确保 Java 8+ 可用

2. 确认目标文件

向用户确认待分析的 JAR/WAR 文件路径或目录路径。

3. 选择分析模式

根据场景选择合适的参数组合：

完整分析（推荐，适合安全审计）：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j <target_path>

快速分析（仅方法调用关系，速度更快）：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j <target_path> -q

FatJar 分析（Spring Boot 等嵌套 JAR）：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j <target_path> --inner-jars

指定范围分析（仅分析特定包）：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j <target_path> -w "com/example/app"

排除第三方库：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j <target_path> -b "org/apache"

4. 执行构建

运行命令并观察输出，关注以下关键信息：

• totalJar: 发现的 JAR 文件数量
• totalClass: 分析的类数量
• totalMethod: 分析的方法数量
• dbSize: 生成的数据库大小
• Progress: 100%: 构建完成
• Time elapsed: 构建耗时

5. 验证结果

确认 jar-analyzer.db 已生成，并告知用户：

• 数据库路径
• 分析的类/方法数量
• 数据库大小
• 可以使用 do-analyze skill 进行后续分析

6. 反编译模式（可选）

如果用户只需要快速查看某个类的源码，可以使用反编译模式：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j <target_path> -d <fully.qualified.ClassName>

例如：

java -jar <plugin_dir>/bin/jar-analyzer-engine-1.2.0.jar -j app.jar -d com.example.MyController

注意：反编译模式不会构建数据库，仅输出反编译后的 Java 源码到控制台。

注意事项

• 当 JAR 数量较多或体积较大时，数据库文件和临时目录可能非常大，请确保磁盘有足够空间
• 构建过程中会在当前目录创建 jar-analyzer-temp/ 临时目录
• 如果数据库已存在，重新运行会覆盖旧数据库
• 建议在目标项目目录或专门的分析目录下执行命令
• Windows 环境下路径使用 \ 或 / 均可