Maven Source Viewer

Claude Code Skill：查看 Maven 项目中第三方依赖的源码，类似于 IDE 里的"跳转到源码"能力。

安装

curl -fsSL https://raw.githubusercontent.com/WtMonster/maven-source-viewer/main/install.sh | bash

可选：跳过安装 CFR（反编译器）：

curl -fsSL https://raw.githubusercontent.com/WtMonster/maven-source-viewer/main/install.sh | bash -s -- --no-cfr

或手动安装：

git clone https://github.com/WtMonster/maven-source-viewer.git ~/.claude/skills/maven-source-viewer
chmod +x ~/.claude/skills/maven-source-viewer/scripts/*.sh

快速开始

在 Claude Code 中，当你需要查看第三方依赖的源码时，会自动调用此 skill。

查看某个类的完整源码（最常用）：

~/.claude/skills/maven-source-viewer/scripts/maven-source.sh open com.example.MyClass --project /path/to/project --all

核心命令

命令	用途	示例
open	打开类源码（推荐）	open com.example.MyClass --project DIR --all
find	查找类所在的 JAR	find com.example.MyClass --project DIR
search	模糊搜索类名	search RestTemplate --project DIR
decompile	强制反编译查看	decompile com.example.MyClass --project DIR
fetch	将源码落盘到目录	fetch com.example.MyClass ./output --project DIR
download	下载项目所有依赖源码	download /path/to/project

主要参数

参数	说明
--project DIR	指定项目目录，精确匹配项目依赖版本（强烈推荐）
--all	输出完整源码（默认只输出 400 行）
--max-lines N	限制输出行数
--download-sources	本地没有源码时尝试下载
--no-decompile	禁止反编译兜底

特性

• 智能 IDEA 集成：自动读取 IDEA 的 Maven 配置（settings.xml、localRepository）
• 多级降级策略：优先查找 sources.jar → 自动反编译（CFR → Fernflower → javap）
• 并行搜索：使用 xargs 并行处理，大幅提升搜索速度
• 增量缓存：JAR 索引、classpath 等都有缓存，加速重复查找
• 内部类支持：正确处理 Outer.Inner 和 Outer$Inner 格式
• 多语言支持：Java/Kotlin/Groovy/Scala 源文件

环境变量

变量	默认值	说明
M2_REPO	~/.m2/repository	Maven 本地仓库路径
MVN_BIN	(空)	指定 mvn 可执行文件路径
MAVEN_HOME	(空)	Maven 安装目录（使用 $MAVEN_HOME/bin/mvn）
MVN_SETTINGS	(空)	Maven settings.xml 路径（等价于 mvn --settings）
MVN_REPO_LOCAL	(空)	Maven 本地仓库（等价于 -Dmaven.repo.local=...）
PARALLEL_JOBS	8	并行搜索任务数
JAR_LIST_CACHE_TTL	86400	JAR 列表缓存有效期（秒）
MAX_LINES_DEFAULT	400	默认输出行数限制

说明：如果你的机器没有安装 Maven（mvn: command not found），脚本会在 --project 场景下优先尝试使用项目内的 Maven Wrapper（mvnw）；否则需要你安装 Maven 或配置 MVN_BIN/MAVEN_HOME。

配置文件（全局/项目级默认值）

• 全局：~/.config/maven-source-viewer/config
• 项目级：<项目根目录>/.maven-source-viewer.conf（--project 会自动定位 Maven 根目录）

仅支持白名单 KEY（示例）：

MAVEN_HOME=/Users/you/Environment/apache-maven-3.9.3
MVN_SETTINGS=/Users/you/Environment/apache-maven-3.9.3/conf/settings.xml
MVN_REPO_LOCAL=/Users/you/Environment/apache-maven-3.9.3/repository
PARALLEL_JOBS=12

反编译器

默认优先尝试使用 IDEA 自带 Fernflower（若可定位到 java-decompiler.jar），否则回退到 javap（JDK 自带）。

如需更好的反编译效果，也可安装 CFR：

~/.claude/skills/maven-source-viewer/scripts/maven-source.sh install-cfr

# 优先通过 Maven 获取（更适合企业内网/镜像环境）
~/.claude/skills/maven-source-viewer/scripts/maven-source.sh install-cfr --method maven

缓存位置

~/.cache/maven-source-viewer/
├── index/      # JAR 文件索引
├── lists/      # JAR 列表缓存
├── classpath/  # 项目 classpath 缓存
└── tools/      # 反编译器等工具

清理缓存：

rm -rf ~/.cache/maven-source-viewer/

License

MIT