@jspg-ai/coding-bb 0.0.1

package/cbb/tools/cbb-decompile-jar/scripts/decompile.py

@@ -0,0 +1,863 @@
+#!/usr/bin/env python3
+"""JAR 反编译辅助脚本（全平台通用）
+用法:
+  decompile.py check                            - 环境预检（JDK + Maven + 仓库）
+  decompile.py repo                             - 输出本地 Maven 仓库路径
+  decompile.py resolve <FQN> [-p projectDir]    - 类全限定名 → JAR 路径 + Maven 坐标
+  decompile.py find <G> <A> <V>                 - Maven 坐标 → JAR 路径
+  decompile.py list <jar_path> [keyword]        - 列出 JAR 中的类（可按关键字过滤）
+  decompile.py show <jar_path> <fully_qualified> - 查看类的完整信息（字段、方法）
+  decompile.py api <jar_path> <fully_qualified>  - 查看 RPC 接口的方法签名
+  decompile.py enum <jar_path> <fully_qualified> - 查看枚举类的所有值
+"""
+
+# 抑制字节码缓存：本脚本作为工具直接调用、无复用价值，避免在 scripts/ 下生成 __pycache__/
+import sys
+if not getattr(sys, 'dont_write_bytecode', False):
+    sys.dont_write_bytecode = True
+
+import json
+import os
+import re
+import glob
+import shutil
+import subprocess
+import xml.etree.ElementTree as ET
+
+
+# ============================================================
+#  XML 解析
+# ============================================================
+def _strip_ns(tag):
+    """去掉 XML 命名空间前缀，如 {http://...}settings → settings"""
+    if tag.startswith('{'):
+        return tag.split('}', 1)[1]
+    return tag
+
+
+def _find_ns(root):
+    """从根节点提取命名空间"""
+    if '}' in root.tag:
+        return {'ns': root.tag.split('}')[0][1:]}
+    return {}
+
+
+def parse_xml_element(xml_file, element_path):
+    """解析 XML 文件，提取指定路径的元素文本值（天然忽略注释）
+    element_path 用 / 分隔，如 "settings/localRepository" 或 "project/packaging"
+    同名兄弟元素（如多个 module）会全部返回
+    """
+    tree = ET.parse(xml_file)
+    root = tree.getroot()
+    ns = _find_ns(root)
+    parts = element_path.split('/')
+
+    # 先定位到父节点，再 findall 最后一级（支持同名兄弟）
+    parent = root
+    for p in parts[1:-1]:
+        found = parent.find('ns:' + p, ns) if ns else parent.find(p)
+        if found is None:
+            found = parent.find(p)
+        if found is None:
+            return []
+        parent = found
+
+    child_tag = parts[-1]
+    siblings = parent.findall('ns:' + child_tag, ns) if ns else parent.findall(child_tag)
+    results = []
+    for s in siblings:
+        if s.text and s.text.strip():
+            results.append(s.text.strip())
+    return results
+
+
+def parse_xml_single(xml_file, element_path):
+    """解析 XML 文件，返回第一个匹配元素的文本值，无则返回 None"""
+    results = parse_xml_element(xml_file, element_path)
+    return results[0] if results else None
+
+
+# ============================================================
+#  定位 JDK 工具
+#  查找顺序：环境变量 → PATH → 系统工具(Mac) → 常见路径 → 提示用户
+# ============================================================
+def find_jdk():
+    # 1. JAVA_HOME
+    java_home = os.environ.get('JAVA_HOME', '')
+    if java_home:
+        javap = os.path.join(java_home, 'bin', 'javap' + ('.exe' if sys.platform == 'win32' else ''))
+        jar_cmd = os.path.join(java_home, 'bin', 'jar' + ('.exe' if sys.platform == 'win32' else ''))
+        if os.path.isfile(javap):
+            return {'javap': javap, 'jar': jar_cmd, 'source': f'JAVA_HOME={java_home}'}
+
+    # 2. PATH
+    javap_name = 'javap.exe' if sys.platform == 'win32' else 'javap'
+    javap_in_path = shutil.which(javap_name)
+    if javap_in_path:
+        bin_dir = os.path.dirname(javap_in_path)
+        jar_name = 'jar.exe' if sys.platform == 'win32' else 'jar'
+        jar_cmd = os.path.join(bin_dir, jar_name)
+        if os.path.isfile(jar_cmd):
+            return {'javap': javap_in_path, 'jar': jar_cmd, 'source': 'PATH'}
+
+    # 3. Mac 专用: /usr/libexec/java_home
+    if sys.platform == 'darwin':
+        try:
+            result = subprocess.run(['/usr/libexec/java_home'], capture_output=True, text=True)
+            if result.returncode == 0:
+                mac_home = result.stdout.strip()
+                javap = os.path.join(mac_home, 'bin', 'javap')
+                jar_cmd = os.path.join(mac_home, 'bin', 'jar')
+                if os.path.isfile(javap):
+                    return {'javap': javap, 'jar': jar_cmd, 'source': '/usr/libexec/java_home'}
+        except Exception:
+            pass
+
+    # 4. 扫描常见安装路径
+    if sys.platform == 'darwin':
+        scan_dirs = [
+            '/Library/Java/JavaVirtualMachines/*/Contents/Home/bin',
+            '/opt/homebrew/opt/openjdk*/bin',
+            '/usr/local/opt/openjdk*/bin',
+        ]
+    elif sys.platform == 'win32':
+        scan_dirs = [
+            os.path.join(os.environ.get('ProgramFiles', ''), 'Java', 'jdk*', 'bin'),
+            os.path.join(os.environ.get('ProgramFiles', ''), 'Amazon Corretto', '*', 'bin'),
+            os.path.join(os.environ.get('ProgramFiles', ''), 'Eclipse Adoptium', '*', 'bin'),
+            os.path.join(os.environ.get('ProgramFiles', ''), 'Zulu', '*', 'bin'),
+            os.path.join(os.environ.get('ProgramFiles(x86)', ''), 'Java', 'jdk*', 'bin'),
+            'C:\\env\\jdk\\*\\bin',
+            'D:\\env\\jdk\\*\\bin',
+            'E:\\env\\jdk\\*\\bin',
+        ]
+    else:
+        scan_dirs = [
+            '/usr/lib/jvm/java-*/bin',
+            '/usr/lib/jvm/jdk-*/bin',
+            '/usr/lib/jvm/adoptopenjdk-*/bin',
+            '/usr/lib/jvm/temurin-*/bin',
+            '/usr/local/java/jdk*/bin',
+            '/opt/jdk*/bin',
+        ]
+
+    javap_name = 'javap.exe' if sys.platform == 'win32' else 'javap'
+    jar_name = 'jar.exe' if sys.platform == 'win32' else 'jar'
+    for pattern in scan_dirs:
+        for bin_dir in sorted(glob.glob(pattern), reverse=True):
+            javap = os.path.join(bin_dir, javap_name)
+            jar_cmd = os.path.join(bin_dir, jar_name)
+            if os.path.isfile(javap):
+                home_dir = os.path.dirname(bin_dir)
+                return {'javap': javap, 'jar': jar_cmd, 'source': f'Scanned: {home_dir}'}
+
+    # 5. 都没找到
+    print("ERROR: Cannot find JDK tools (javap, jar)", file=sys.stderr)
+    print(file=sys.stderr)
+    print("Please set JAVA_HOME environment variable, or add JDK bin directory to PATH.", file=sys.stderr)
+    sys.exit(1)
+
+
+# ============================================================
+#  定位 Maven 安装路径
+#  查找顺序：环境变量 → PATH → 常见路径 → 提示用户
+# ============================================================
+def find_maven():
+    # 1. 环境变量
+    m2_home = os.environ.get('MAVEN_HOME', '') or os.environ.get('M2_HOME', '')
+    if m2_home:
+        mvn_name = 'mvn.cmd' if sys.platform == 'win32' else 'mvn'
+        if os.path.isfile(os.path.join(m2_home, 'bin', mvn_name)):
+            return {'home': m2_home, 'source': 'MAVEN_HOME'}
+
+    # 2. PATH
+    mvn_name = 'mvn.cmd' if sys.platform == 'win32' else 'mvn'
+    mvn_in_path = shutil.which(mvn_name)
+    if not mvn_in_path and sys.platform == 'win32':
+        mvn_in_path = shutil.which('mvn')
+    if mvn_in_path:
+        maven_home = os.path.dirname(os.path.dirname(mvn_in_path))
+        if os.path.isfile(os.path.join(maven_home, 'conf', 'settings.xml')):
+            return {'home': maven_home, 'source': 'PATH'}
+
+    # 3. 扫描常见安装路径
+    if sys.platform == 'darwin':
+        scan_dirs = [
+            '/opt/homebrew/opt/maven/libexec',
+            '/usr/local/opt/maven/libexec',
+            '/usr/local/apache-maven-*',
+            '/opt/apache-maven-*',
+        ]
+    elif sys.platform == 'win32':
+        scan_dirs = [
+            os.path.join(os.environ.get('ProgramFiles', ''), 'apache-maven-*'),
+            os.path.join(os.environ.get('ProgramFiles(x86)', ''), 'apache-maven-*'),
+            'C:\\env\\maven\\apache-maven-*',
+            'D:\\env\\maven\\apache-maven-*',
+            'E:\\env\\maven\\apache-maven-*',
+            'C:\\tools\\maven\\apache-maven-*',
+        ]
+    else:
+        scan_dirs = [
+            '/usr/local/apache-maven-*',
+            '/opt/apache-maven-*',
+            '/usr/share/maven',
+        ]
+
+    mvn_name = 'mvn.cmd' if sys.platform == 'win32' else 'mvn'
+    for pattern in scan_dirs:
+        for maven_dir in sorted(glob.glob(pattern), reverse=True):
+            if os.path.isfile(os.path.join(maven_dir, 'bin', mvn_name)):
+                return {'home': maven_dir, 'source': f'Scanned: {maven_dir}'}
+
+    # 4. 都没找到
+    print("ERROR: Cannot find Maven", file=sys.stderr)
+    print(file=sys.stderr)
+    print("Please set MAVEN_HOME environment variable, or add Maven bin directory to PATH.", file=sys.stderr)
+    sys.exit(1)
+
+
+# ============================================================
+#  读取 settings.xml 找到本地 Maven 仓库
+# ============================================================
+def find_maven_local_repo(maven_home):
+    home = os.path.expanduser('~')
+    user_settings = os.path.join(home, '.m2', 'settings.xml')
+    global_settings = os.path.join(maven_home, 'conf', 'settings.xml')
+
+    for settings_path in [user_settings, global_settings]:
+        if os.path.isfile(settings_path):
+            local_repo = parse_xml_single(settings_path, 'settings/localRepository')
+            if local_repo and os.path.isdir(local_repo):
+                return {'path': local_repo, 'source': f'settings.xml: {settings_path}'}
+
+    default_repo = os.path.join(home, '.m2', 'repository')
+    if os.path.isdir(default_repo):
+        return {'path': default_repo, 'source': 'Default (no localRepository in settings.xml)'}
+
+    print("ERROR: Maven local repository not found.", file=sys.stderr)
+    sys.exit(1)
+
+
+# ============================================================
+#  从 FQN 提取包前缀列表（从最长到最短，最少2段）
+# ============================================================
+def get_package_prefixes(fqn):
+    segs = fqn.split('.')
+    prefixes = []
+    for i in range(len(segs) - 1, 0, -1):
+        prefixes.append('.'.join(segs[:i + 1]))
+    return prefixes
+
+
+# ============================================================
+#  自动下载 Maven artifact
+# ============================================================
+def download_artifact(group_id, artifact_id, version, maven_home):
+    java_home = os.environ.get('JAVA_HOME', '')
+    if not java_home:
+        print("ERROR: JAVA_HOME is not set. Cannot run Maven to download artifacts.", file=sys.stderr)
+        print("       Please set JAVA_HOME to your JDK directory.", file=sys.stderr)
+        return False
+
+    mvn_name = 'mvn.cmd' if sys.platform == 'win32' else 'mvn'
+    mvn_exe = os.path.join(maven_home, 'bin', mvn_name)
+    artifact = f"{group_id}:{artifact_id}:{version}"
+    print(f"JAR not found locally, downloading {artifact} ...", file=sys.stderr)
+
+    try:
+        result = subprocess.run(
+            [mvn_exe, 'dependency:get', f'-Dartifact={artifact}'],
+            capture_output=True, text=True
+        )
+        if 'BUILD SUCCESS' in (result.stdout or ''):
+            print(f"Downloaded {artifact} successfully.", file=sys.stderr)
+            return True
+    except Exception:
+        pass
+
+    print(f"Failed to download {artifact}.", file=sys.stderr)
+    return False
+
+
+# ============================================================
+#  从 Maven 坐标定位 JAR 文件
+# ============================================================
+def find_jar_from_coordinates(group_id, artifact_id, version, local_repo, maven_home):
+    group_path = os.path.join(*group_id.split('.'))
+    jar_name = f"{artifact_id}-{version}.jar"
+    jar_path = os.path.join(local_repo, group_path, artifact_id, version, jar_name)
+
+    if os.path.isfile(jar_path):
+        return jar_path
+
+    if download_artifact(group_id, artifact_id, version, maven_home):
+        if os.path.isfile(jar_path):
+            return jar_path
+
+    print(f"ERROR: JAR not found at: {jar_path}. Auto-download failed.", file=sys.stderr)
+    sys.exit(2)
+
+
+# ============================================================
+#  类全限定名解析到 JAR（两阶段）
+# ============================================================
+
+# ============================================================
+#  Resolve 缓存
+# ============================================================
+def _cache_path(project_dir):
+    if not project_dir:
+        return None
+    import hashlib
+    dir_hash = hashlib.md5(os.path.abspath(project_dir).encode()).hexdigest()[:12]
+    cache_dir = os.path.join(os.path.expanduser('~'), '.cache', 'cbb-decompile-jar')
+    os.makedirs(cache_dir, exist_ok=True)
+    return os.path.join(cache_dir, f'{dir_hash}.json')
+
+
+def _cache_read(project_dir, class_name):
+    cp = _cache_path(project_dir)
+    if not cp or not os.path.isfile(cp):
+        return None
+    try:
+        with open(cp, 'r', encoding='utf-8') as f:
+            cache = json.load(f)
+        entry = cache.get(class_name)
+        if entry and os.path.isfile(entry.get('jar_path', '')):
+            return entry
+    except Exception:
+        pass
+    return None
+
+
+def _cache_write(project_dir, class_name, result):
+    cp = _cache_path(project_dir)
+    if not cp:
+        return
+    try:
+        cache = {}
+        if os.path.isfile(cp):
+            with open(cp, 'r', encoding='utf-8') as f:
+                cache = json.load(f)
+        cache[class_name] = result
+        with open(cp, 'w', encoding='utf-8') as f:
+            json.dump(cache, f, ensure_ascii=False, indent=2)
+    except Exception:
+        pass
+
+
+def find_module_for_class(project_dir, class_name):
+    """从类的包名前缀推断 groupId，在各子模块 pom.xml 中查找声明了该依赖的模块"""
+    pom_file = os.path.join(project_dir, 'pom.xml')
+    modules = parse_xml_element(pom_file, 'project/modules/module')
+    if not modules:
+        return None
+
+    segs = class_name.split('.')
+    prefixes = []
+    for i in range(min(len(segs) - 1, 5), 1, -1):
+        prefixes.append('.'.join(segs[:i]))
+
+    for module in modules:
+        module_pom = os.path.join(project_dir, module, 'pom.xml')
+        if not os.path.isfile(module_pom):
+            continue
+        try:
+            with open(module_pom, 'r', encoding='utf-8', errors='ignore') as f:
+                pom_content = f.read()
+            for prefix in prefixes:
+                if f'<groupId>{prefix}</groupId>' in pom_content:
+                    return module
+        except Exception:
+            continue
+
+    return None
+
+
+def resolve_class_to_jar(class_name, project_dir, maven_home, jdk_jar, local_repo):
+    # Check cache first
+    cached = _cache_read(project_dir, class_name)
+    if cached:
+        print(f"Cache hit for {class_name}", file=sys.stderr)
+        return cached
+
+    class_path = class_name.replace('.', '/')
+    class_file = f"{class_path}.class"
+
+    # 确定模块路径：从各子模块 pom 中精确定位声明了该依赖的模块
+    module_path = None
+    pom_file = os.path.join(project_dir, 'pom.xml') if project_dir else ''
+    if project_dir and os.path.isfile(pom_file):
+        packaging = parse_xml_single(pom_file, 'project/packaging')
+        if packaging == 'pom':
+            module_path = find_module_for_class(project_dir, class_name)
+
+    # Phase 1: dependency:tree
+    java_home = os.environ.get('JAVA_HOME', '')
+    if not java_home:
+        inferred_home = os.path.dirname(os.path.dirname(jdk_jar))
+        print("ERROR: JAVA_HOME is not set. Maven dependency:tree will fail.", file=sys.stderr)
+        print("       Please set JAVA_HOME to your JDK directory, e.g.: " + inferred_home, file=sys.stderr)
+        sys.exit(1)
+
+    mvn_name = 'mvn.cmd' if sys.platform == 'win32' else 'mvn'
+    mvn_exe = os.path.join(maven_home, 'bin', mvn_name)
+    mvn_args = ['dependency:tree', '-DoutputType=text']
+    if module_path:
+        mvn_args += ['-pl', module_path]
+    if project_dir:
+        mvn_args += ['-f', project_dir]
+
+    print(f"Running mvn dependency:tree to locate dependency for {class_name} ...", file=sys.stderr)
+
+    candidates = []
+    try:
+        result = subprocess.run([mvn_exe] + mvn_args, capture_output=True, text=True, timeout=15)
+        if result.returncode != 0:
+            print(f"dependency:tree failed (exit code {result.returncode}), skipping to local repository scan.", file=sys.stderr)
+            if result.stderr:
+                for line in result.stderr.strip().splitlines()[:10]:
+                    print(f"  {line}", file=sys.stderr)
+        else:
+            prefixes = get_package_prefixes(class_name)
+            dep_regex = re.compile(r'(\S+):(\S+):\S+:(\S+):\S+')
+            seen = set()
+            for prefix in prefixes:
+                for line in result.stdout.splitlines():
+                    if prefix in line:
+                        m = dep_regex.search(line)
+                        if m:
+                            coord = f"{m.group(1)}:{m.group(2)}:{m.group(3)}"
+                            if coord not in seen:
+                                seen.add(coord)
+                                candidates.append(coord)
+            if not candidates:
+                print("No matching dependencies found in dependency:tree, scanning local repository.", file=sys.stderr)
+    except subprocess.TimeoutExpired:
+        print("dependency:tree timed out (>15s), skipping to local repository scan.", file=sys.stderr)
+    except Exception as e:
+        print(f"dependency:tree failed: {e}, skipping to local repository scan.", file=sys.stderr)
+
+    # 搜索 candidates
+    for coord in candidates:
+        parts = coord.split(':')
+        if len(parts) < 3:
+            continue
+        g, a, v = parts[0], parts[1], parts[2]
+        group_path = os.path.join(*g.split('.'))
+        jar_name = f"{a}-{v}.jar"
+        jar_path = os.path.join(local_repo, group_path, a, v, jar_name)
+
+        if not os.path.isfile(jar_path):
+            if not download_artifact(g, a, v, maven_home):
+                continue
+
+        if os.path.isfile(jar_path):
+            try:
+                found = subprocess.run(
+                    [jdk_jar, 'tf', jar_path],
+                    capture_output=True, text=True
+                )
+                if class_file in (found.stdout or ''):
+                    result = {'jar_path': jar_path, 'group_id': g, 'artifact_id': a, 'version': v}
+                    _cache_write(project_dir, class_name, result)
+                    return result
+            except Exception:
+                pass
+
+    # Phase 2: scan local repository
+    print(f"Scanning local repository for {class_name} ...", file=sys.stderr)
+    prefixes = get_package_prefixes(class_name)
+    for prefix in prefixes:
+        group_dir = os.path.join(local_repo, *prefix.split('.'))
+        if not os.path.isdir(group_dir):
+            continue
+        for root, dirs, files in os.walk(group_dir):
+            for f in files:
+                if not f.endswith('.jar') or f.endswith('-sources.jar') or f.endswith('-javadoc.jar'):
+                    continue
+                jar_path = os.path.join(root, f)
+                try:
+                    result = subprocess.run(
+                        [jdk_jar, 'tf', jar_path],
+                        capture_output=True, text=True
+                    )
+                    if class_file in (result.stdout or ''):
+                        ver_dir = os.path.basename(root)
+                        art_dir = os.path.basename(os.path.dirname(root))
+                        result_dict = {'jar_path': jar_path, 'group_id': prefix, 'artifact_id': art_dir, 'version': ver_dir}
+                        _cache_write(project_dir, class_name, result_dict)
+                        return result_dict
+                except Exception:
+                    pass
+
+    print(f"ERROR: Class '{class_name}' not found in any project dependency JAR.", file=sys.stderr)
+    sys.exit(2)
+
+
+# ============================================================
+#  解析 classpath
+# ============================================================
+def resolve_classpath(jar_paths):
+    separator = os.pathsep  # ; on Windows, : on others
+    parts = re.split(r'[:;,]', jar_paths) if separator == ':' else re.split(r'[;,]', jar_paths)
+    cp_parts = []
+    for p in parts:
+        p = p.strip()
+        if not p:
+            continue
+        if os.path.isfile(p):
+            cp_parts.append(p)
+        else:
+            print(f"WARNING: JAR not found, skipping: {p}", file=sys.stderr)
+    if not cp_parts:
+        print(f"ERROR: No valid JAR paths in classpath: {jar_paths}", file=sys.stderr)
+        sys.exit(3)
+    return separator.join(cp_parts)
+
+
+# ============================================================
+#  打印 class-not-found 提示
+# ============================================================
+def print_class_not_found_hint(class_name):
+    print(file=sys.stderr)
+    print(f"Class '{class_name}' not found in the provided JAR(s). Possible reasons:", file=sys.stderr)
+    print(f"  1. The class is in another dependency JAR - use 'resolve {class_name}' to locate it", file=sys.stderr)
+    print(f"  2. The class name is incorrect - check for inner classes (use $ for inner class separator)", file=sys.stderr)
+    print(f"  3. Multiple JARs needed - pass additional JAR paths separated by {os.pathsep}", file=sys.stderr)
+    print(f"     Example: decompile.py show \"jar1.jar{os.pathsep}jar2.jar\" {class_name}", file=sys.stderr)
+
+
+# ============================================================
+#  命令实现
+# ============================================================
+def cmd_check():
+    print("=== Environment Check ===")
+
+    # Python
+    py_exe = sys.executable or 'python'
+    py_ver = f"{sys.version_info.major}.{sys.version_info.minor}.{sys.version_info.micro}"
+    print("Python:   FOUND")
+    print(f"  python: {py_exe}")
+    print(f"  version: {py_ver}")
+
+    jdk = find_jdk()
+    print("JDK:      FOUND")
+    print(f"  javap:  {jdk['javap']}")
+    print(f"  jar:    {jdk['jar']}")
+    print(f"  source: {jdk['source']}")
+
+    # JAVA_HOME 检查（Maven 依赖此变量）
+    java_home = os.environ.get('JAVA_HOME', '')
+    if java_home:
+        print(f"  JAVA_HOME: {java_home}")
+    else:
+        inferred_home = os.path.dirname(os.path.dirname(jdk['javap']))
+        print("  JAVA_HOME: NOT SET")
+        print()
+        print("ERROR: JAVA_HOME is not set. Maven commands (dependency:tree) will fail.")
+        print("       Please set JAVA_HOME to your JDK directory, e.g.: " + inferred_home)
+        sys.exit(1)
+
+    maven = find_maven()
+    print("Maven:    FOUND")
+    print(f"  home:   {maven['home']}")
+    print(f"  source: {maven['source']}")
+    print(f"  settings: {os.path.join(maven['home'], 'conf', 'settings.xml')}")
+
+    repo = find_maven_local_repo(maven['home'])
+    print(f"LocalRepo: {repo['path']}")
+    print(f"  source: {repo['source']}")
+
+
+def cmd_repo():
+    maven = find_maven()
+    repo = find_maven_local_repo(maven['home'])
+    print(repo['path'])
+
+
+def cmd_resolve(class_name, project_dir):
+    jdk = find_jdk()
+    maven = find_maven()
+    repo = find_maven_local_repo(maven['home'])
+    result = resolve_class_to_jar(class_name, project_dir, maven['home'], jdk['jar'], repo['path'])
+    print(f"JAR: {result['jar_path']}")
+    print(f"Coordinates: {result['group_id']}:{result['artifact_id']}:{result['version']}")
+
+
+def cmd_find(group_id, artifact_id, version):
+    maven = find_maven()
+    repo = find_maven_local_repo(maven['home'])
+    jar_path = find_jar_from_coordinates(group_id, artifact_id, version, repo['path'], maven['home'])
+    print(jar_path)
+
+
+def cmd_list(jar_path, keyword=None):
+    jdk = find_jdk()
+    try:
+        result = subprocess.run([jdk['jar'], 'tf', jar_path], capture_output=True, text=True)
+        for line in (result.stdout or '').splitlines():
+            if line.endswith('.class'):
+                if not keyword or keyword.lower() in line.lower():
+                    print(line)
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def cmd_show(jar_paths, class_name, verbose=False):
+    jdk = find_jdk()
+    cp = resolve_classpath(jar_paths)
+    try:
+        javap_args = [jdk['javap'], '-p']
+        if verbose:
+            javap_args += ['-c', '-verbose']
+        javap_args += ['-cp', cp, class_name]
+        result = subprocess.run(javap_args, capture_output=True, text=True, errors='replace')
+        output = result.stdout or ''
+        stderr = result.stderr or ''
+        if 'class not found' in stderr.lower() or (result.returncode != 0 and 'class not found' in output.lower()):
+            print_class_not_found_hint(class_name)
+        print(output)
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def cmd_api(jar_paths, class_name):
+    jdk = find_jdk()
+    cp = resolve_classpath(jar_paths)
+    try:
+        result = subprocess.run([jdk['javap'], '-p', '-cp', cp, class_name], capture_output=True, text=True, errors='replace')
+        output = result.stdout or ''
+        stderr = result.stderr or ''
+        if 'class not found' in stderr.lower() or (result.returncode != 0 and 'class not found' in output.lower()):
+            print_class_not_found_hint(class_name)
+        is_interface = any('interface ' in line for line in output.splitlines()[:5])
+        for line in output.splitlines():
+            if is_interface:
+                if (line == ''
+                    or re.search(r'extends\s+java\.lang\.Object$', line)
+                    or re.search(r'public\s+boolean\s+equals\(', line)
+                    or re.search(r'public\s+int\s+hashCode\(', line)
+                    or re.search(r'public\s+java\.lang\.String\s+toString\(', line)
+                    or re.search(r'public\s+final\s+java\.lang\.Class\s+getClass\(', line)):
+                    continue
+            print(line)
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def cmd_enum(jar_paths, class_name):
+    jdk = find_jdk()
+    cp = resolve_classpath(jar_paths)
+    try:
+        result = subprocess.run(
+            [jdk['javap'], '-p', '-c', '-verbose', '-cp', cp, class_name],
+            capture_output=True, text=True, errors='replace'
+        )
+        output = result.stdout or ''
+        stderr = result.stderr or ''
+        if 'class not found' in stderr.lower() or (result.returncode != 0 and 'class not found' in output.lower()):
+            print_class_not_found_hint(class_name)
+            print(output)
+            return
+
+        # Extract enum field names
+        enum_names = []
+        short_class = class_name.split('.')[-1]
+        for line in output.splitlines():
+            if 'static final' in line and '$VALUES' not in line and short_class in line:
+                parts = line.strip().rstrip(';').split()
+                if parts:
+                    enum_names.append(parts[-1])
+
+        # Extract private fields (code, desc, value, etc.)
+        field_names = []
+        for line in output.splitlines():
+            field_match = re.match(
+                r'\s+private\s+(?:final\s+)?(?:java\.lang\.String|int|java\.lang\.Integer|long|java\.lang\.Long)\s+(\w+)\s*;',
+                line
+            )
+            if field_match:
+                fname = field_match.group(1)
+                if fname not in ('serialVersionUID', '$VALUES'):
+                    field_names.append(fname)
+
+        # Parse <clinit> bytecode to extract enum constructor string args
+        # Look for the "static {};" section in javap output
+        in_clinit = False
+        enum_values = {}
+        current_strings = []
+        for line in output.splitlines():
+            if re.match(r'\s*static\s*\{\}', line):
+                in_clinit = True
+                continue
+            if not in_clinit:
+                continue
+            # Stop at next method or end
+            if re.match(r'\s*(public|private|protected)\s', line) and 'static' not in line:
+                break
+
+            # ldc or ldc_w with String comment
+            ldc_match = re.search(r'ldc(?:_w)?\s+#\d+\s+//\s*String\s+(.+)', line)
+            if ldc_match:
+                current_strings.append(ldc_match.group(1).strip())
+                continue
+
+            # putstatic for an enum field
+            putstatic_match = re.search(r'putstatic\s+#\d+\s*//.*Field\s+(\w+):', line)
+            if putstatic_match:
+                field_name = putstatic_match.group(1)
+                if field_name in enum_names and field_name != '$VALUES':
+                    # First string is typically the enum name itself (from Enum.<init>), skip it
+                    args = [s for s in current_strings if s != field_name]
+                    enum_values[field_name] = args
+                current_strings = []
+                continue
+
+            # new starts a fresh enum instance
+            if re.search(r'new\s+#', line):
+                current_strings = []
+
+        # Output
+        if enum_values:
+            for name in enum_names:
+                args = enum_values.get(name, [])
+                if args:
+                    if field_names and len(field_names) >= len(args):
+                        pairs = [f'{field_names[i]}="{args[i]}"' for i in range(len(args))]
+                        print(f"{name}({', '.join(pairs)})")
+                    else:
+                        args_str = ', '.join(f'\"{a}\"' for a in args)
+                        print(f"{name}({args_str})")
+                else:
+                    print(name)
+        else:
+            for name in enum_names:
+                print(name)
+            if enum_names:
+                print(file=sys.stderr)
+                print("Note: Could not extract enum field values from bytecode.", file=sys.stderr)
+                print("      Use 'show -v' for full verbose output.", file=sys.stderr)
+
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+
+
+def cmd_batch(jar_paths, class_names):
+    """批量查看多个类的信息（单次 javap 调用）"""
+    jdk = find_jdk()
+    cp = resolve_classpath(jar_paths)
+    try:
+        javap_args = [jdk['javap'], '-p', '-cp', cp] + class_names
+        result = subprocess.run(javap_args, capture_output=True, text=True, errors='replace')
+        output = result.stdout or ''
+        stderr = result.stderr or ''
+        if 'class not found' in stderr.lower():
+            not_found = re.findall(r"Class (\S+) not found", stderr)
+            if not_found:
+                print(f"WARNING: Classes not found: {', '.join(not_found)}", file=sys.stderr)
+        print(output)
+    except Exception as e:
+        print(f"ERROR: {e}", file=sys.stderr)
+        sys.exit(1)
+
+
+def cmd_help():
+    sep = os.pathsep
+    print("JAR Decompile Tool (Python - Cross Platform)")
+    print()
+    print("Usage:")
+    print("  decompile.py check                            Environment pre-check")
+    print("  decompile.py repo                             Print Maven repo path")
+    print("  decompile.py resolve <FQN> [-p projectDir]   Find JAR containing a class")
+    print("  decompile.py find <G> <A> <V>                Find JAR from Maven coordinates")
+    print("  decompile.py list <jarPath> [keyword]         List classes in JAR")
+    print(f"  decompile.py show <jarPath[{sep}...]> <FQN> [-v]  Show class details (-v for verbose bytecode)")
+    print(f"  decompile.py api  <jarPath[{sep}...]> <FQN>       Show interface methods (multi-JAR supported)")
+    print(f"  decompile.py enum <jarPath[{sep}...]> <FQN>       Show enum values (multi-JAR supported)")
+    print(f"  decompile.py batch <jarPath[{sep}...]> <FQN1> <FQN2> ...  Batch show multiple classes")
+    print()
+    print(f"Note: show/api/enum accept multiple JAR paths separated by {sep} (or ,) for cross-JAR class resolution.")
+    print(f"      Example: decompile.py show \"jar1.jar{sep}jar2.jar\" com.example.MyClass")
+
+
+# ============================================================
+#  主入口
+# ============================================================
+def main():
+    # Ensure stdout/stderr can handle unicode on Windows
+    if sys.platform == 'win32':
+        import io
+        sys.stdout = io.TextIOWrapper(sys.stdout.buffer, encoding='utf-8', errors='replace')
+        sys.stderr = io.TextIOWrapper(sys.stderr.buffer, encoding='utf-8', errors='replace')
+    args = sys.argv[1:]
+    if not args:
+        cmd_help()
+        return
+
+    cmd = args[0]
+
+    if cmd == 'check':
+        cmd_check()
+    elif cmd == 'repo':
+        cmd_repo()
+    elif cmd == 'resolve':
+        if len(args) < 2:
+            print("Usage: decompile.py resolve <fully-qualified-class-name> [-p projectDir]", file=sys.stderr)
+            sys.exit(3)
+        class_name = args[1]
+        project_dir = ''
+        if '-p' in args:
+            idx = args.index('-p')
+            if idx + 1 < len(args):
+                project_dir = args[idx + 1]
+        cmd_resolve(class_name, project_dir)
+    elif cmd == 'find':
+        if len(args) < 4:
+            print("Usage: decompile.py find <groupId> <artifactId> <version>", file=sys.stderr)
+            sys.exit(3)
+        cmd_find(args[1], args[2], args[3])
+    elif cmd == 'list':
+        if len(args) < 2:
+            print("Usage: decompile.py list <jarPath> [keyword]", file=sys.stderr)
+            sys.exit(3)
+        keyword = args[2] if len(args) >= 3 else None
+        cmd_list(args[1], keyword)
+    elif cmd == 'show':
+        if len(args) < 3:
+            print("Usage: decompile.py show <jarPath[;...]> <fully-qualified-class-name> [-v]", file=sys.stderr)
+            sys.exit(3)
+        verbose = '-v' in args or '--verbose' in args
+        cmd_show(args[1], args[2], verbose=verbose)
+    elif cmd == 'api':
+        if len(args) < 3:
+            print("Usage: decompile.py api <jarPath[;...]> <fully-qualified-class-name>", file=sys.stderr)
+            sys.exit(3)
+        cmd_api(args[1], args[2])
+    elif cmd == 'enum':
+        if len(args) < 3:
+            print("Usage: decompile.py enum <jarPath[;...]> <fully-qualified-class-name>", file=sys.stderr)
+            sys.exit(3)
+        cmd_enum(args[1], args[2])
+    elif cmd == 'batch':
+        if len(args) < 3:
+            print("Usage: decompile.py batch <jarPath[;...]> <FQN1> [FQN2] ...", file=sys.stderr)
+            sys.exit(3)
+        cmd_batch(args[1], args[2:])
+    elif cmd in ('help', '-h', '--help'):
+        cmd_help()
+    else:
+        print(f"Unknown command: {cmd}", file=sys.stderr)
+        cmd_help()
+        sys.exit(1)
+
+
+if __name__ == '__main__':
+    main()