[优化] 支持 --log-level 指定日志级别 @4ra1n

Author: 4ra1n

CHANGELOG.md

@@ -3,6 +3,7 @@
 更新日志：
 
 - [功能] 支持 `--decompile` 参数反编译指定类 @4ra1n
+- [优化] 支持 `--log-level` 指定日志级别 @4ra1n
 
 ## 1.1.0
 

README.md

@@ -114,6 +114,7 @@ java -jar jar-analyzer-engine.jar --jar /path/to/app.jar --decompile com.example
 | `--black-list-file <file>` | — | 无 | 从文件读取黑名单 |
 | `--white-list-file <file>` | — | 无 | 从文件读取白名单 |
 | `--decompile <class>` | `-d` | 无 | 反编译指定类并输出源码到控制台（如 `com.example.MyClass`） |
+| `--log-level <level>` | — | `INFO` | 日志级别：`DEBUG`、`INFO`、`WARN`、`ERROR` |
 | `--help` | `-h` | — | 显示帮助信息 |
 
 ## 📚 参数详解
@@ -211,6 +212,25 @@ java -jar jar-analyzer-engine.jar --jar springboot-app.jar --inner-jars --fix-cl
 java -jar jar-analyzer-engine.jar --jar app.jar --no-fix-impl
 ```
 
+### `--log-level`（日志级别）
+
+设置引擎运行时的日志输出级别，默认为 `INFO`。支持以下级别（不区分大小写）：
+
+| 级别 | 说明 |
+|------|------|
+| `DEBUG` | 输出所有调试信息，最详细 |
+| `INFO` | 输出一般运行信息（默认） |
+| `WARN` | 仅输出警告和错误 |
+| `ERROR` | 仅输出错误信息 |
+
+```bash
+# 调试模式，查看详细分析过程
+java -jar jar-analyzer-engine.jar --jar app.jar --log-level debug
+
+# 安静模式，仅显示警告和错误
+java -jar jar-analyzer-engine.jar --jar app.jar --log-level warn
+```
+
 ### `--decompile` / `-d`（反编译模式）
 
 指定一个类的全限定名，引擎会从 `jar-analyzer-temp` 临时目录中查找对应的 class 文件，使用内置的 FernFlower 反编译引擎将其反编译为 Java 源码，并输出到控制台。
@@ -605,8 +625,8 @@ EngineBuildRunner.run(config);
 ```
 jar-analyzer-engine/
 ├── src/main/java/me/n1ar4/jar/analyzer/
-│   ├── engine/                      # 引擎入口层
-│   │   ├── EngineMain.java          #   CLI 主入口
+│   ├── EngineMain.java              # CLI 主入口
+│   ├── engine/                      # 引擎核心层
 │   │   ├── EngineBuildRunner.java   #   流水线编排核心
 │   │   ├── EngineConfig.java        #   配置类
 │   │   ├── EngineBuildCmd.java      #   CLI 参数定义 (JCommander)

README_EN.md

@@ -20,7 +20,7 @@
 
 ---
 
-> [中文文档](README_CN.md)
+> [中文文档](README.md)
 
 ## 📖 Introduction
 
@@ -106,6 +106,7 @@ After analysis, a SQLite database file `jar-analyzer.db` will be generated in th
 | `--black-list-file <file>` | — | None | Read blacklist from file |
 | `--white-list-file <file>` | — | None | Read whitelist from file |
 | `--decompile <class>` | `-d` | None | Decompile a specific class and print source to console (e.g. `com.example.MyClass`) |
+| `--log-level <level>` | — | `INFO` | Log level: `DEBUG`, `INFO`, `WARN`, `ERROR` |
 | `--help` | `-h` | — | Display help information |
 
 ## 📚 Argument Details
@@ -203,6 +204,25 @@ Enabling `--no-fix-impl` disables this behavior, keeping only the **literal dire
 java -jar jar-analyzer-engine.jar --jar app.jar --no-fix-impl
 ```
 
+### `--log-level` (Log Level)
+
+Sets the log output level for the engine at runtime. Defaults to `INFO`. The following levels are supported (case-insensitive):
+
+| Level | Description |
+|-------|-------------|
+| `DEBUG` | Output all debug information, most verbose |
+| `INFO` | Output general runtime information (default) |
+| `WARN` | Output only warnings and errors |
+| `ERROR` | Output only error messages |
+
+```bash
+# Debug mode: see detailed analysis process
+java -jar jar-analyzer-engine.jar --jar app.jar --log-level debug
+
+# Quiet mode: show only warnings and errors
+java -jar jar-analyzer-engine.jar --jar app.jar --log-level warn
+```
+
 ### `--decompile` / `-d` (Decompile Mode)
 
 Specify a fully-qualified class name, and the engine will locate the corresponding class file in the `jar-analyzer-temp` directory, decompile it to Java source code using the built-in FernFlower decompiler, and output the result to the console.
@@ -600,8 +620,8 @@ EngineBuildRunner.run(config);
 ```
 jar-analyzer-engine/
 ├── src/main/java/me/n1ar4/jar/analyzer/
-│   ├── engine/                      # Engine entry layer
-│   │   ├── EngineMain.java          #   CLI main entry point
+│   ├── EngineMain.java              # CLI main entry point
+│   ├── engine/                      # Engine core layer
 │   │   ├── EngineBuildRunner.java   #   Pipeline orchestration core
 │   │   ├── EngineConfig.java        #   Configuration class
 │   │   ├── EngineBuildCmd.java      #   CLI argument definitions (JCommander)

pom.xml

@@ -39,7 +39,7 @@
         <!-- Encoding -->
         <project.build.sourceEncoding>UTF-8</project.build.sourceEncoding>
         <!-- Main -->
-        <main.name>me.n1ar4.jar.analyzer.engine.EngineMain</main.name>
+        <main.name>me.n1ar4.jar.analyzer.EngineMain</main.name>
     </properties>
 
     <dependencies>

…1ar4/jar/analyzer/engine/EngineMain.java …va/me/n1ar4/jar/analyzer/EngineMain.javasrc/main/java/me/n1ar4/jar/analyzer/engine/EngineMain.java renamed to src/main/java/me/n1ar4/jar/analyzer/EngineMain.java src/main/java/me/n1ar4/jar/analyzer/engine/EngineMain.java renamed to src/main/java/me/n1ar4/jar/analyzer/EngineMain.java

@@ -8,10 +8,16 @@
  * https://github.com/jar-analyzer/jar-analyzer/blob/master/LICENSE
  */
 
-package me.n1ar4.jar.analyzer.engine;
+package me.n1ar4.jar.analyzer;
 
 import com.beust.jcommander.JCommander;
 import me.n1ar4.jar.analyzer.decompile.DecompileEngine;
+import me.n1ar4.jar.analyzer.engine.EngineBuildCmd;
+import me.n1ar4.jar.analyzer.engine.EngineBuildRunner;
+import me.n1ar4.jar.analyzer.engine.EngineConfig;
+import me.n1ar4.jar.analyzer.engine.EngineConst;
+import me.n1ar4.jar.analyzer.engine.ProgressCallback;
+import me.n1ar4.jar.analyzer.engine.log.LogLevel;
 import me.n1ar4.jar.analyzer.engine.log.LogManager;
 import me.n1ar4.jar.analyzer.engine.log.Logger;
 
@@ -25,9 +31,6 @@ public class EngineMain {
 
     @SuppressWarnings("all")
     public static void main(String[] args) {
-        logger.info("=== Jar Analyzer Engine {} ===", EngineConst.version);
-        logger.info("Build SQLite database from JAR/WAR files");
-
         EngineBuildCmd cmd = new EngineBuildCmd();
         JCommander jc = JCommander.newBuilder()
                 .addObject(cmd)
@@ -48,6 +51,21 @@ public static void main(String[] args) {
             return;
         }
 
+        // Apply log level (default: INFO)
+        if (cmd.logLevel != null && !cmd.logLevel.isEmpty()) {
+            try {
+                LogLevel level = LogLevel.valueOf(cmd.logLevel.toUpperCase());
+                LogManager.setLevel(level);
+            } catch (IllegalArgumentException e) {
+                logger.error("Invalid log level: {} (valid: DEBUG, INFO, WARN, ERROR)", cmd.logLevel);
+                System.exit(1);
+                return;
+            }
+        }
+
+        logger.info("=== Jar Analyzer Engine {} ===", EngineConst.version);
+        logger.info("Build SQLite database from JAR/WAR files");
+
         // Decompile mode: --decompile/-d
         if (cmd.decompileClassName != null && !cmd.decompileClassName.isEmpty()) {
             // 如果指定了 --jar 且 temp 目录不存在，先执行 build 解压 class 文件

src/main/java/me/n1ar4/jar/analyzer/engine/EngineBuildCmd.java

@@ -51,6 +51,9 @@ public class EngineBuildCmd {
     @Parameter(names = {"--decompile", "-d"}, description = "Decompile a class from JAR and print source to console (e.g. com.example.MyClass)")
     public String decompileClassName;
 
+    @Parameter(names = {"--log-level"}, description = "Log level: DEBUG, INFO, WARN, ERROR (default: INFO)")
+    public String logLevel;
+
     @Parameter(names = {"--help", "-h"}, help = true, description = "Show help message")
     public boolean help;
 }