- PluginManifest: manifest.json record with validation, DeclaredTool/Command/Hook, MarketplaceEntry - PluginInstaller: HTTP download, JAR install/uninstall, version management, update checking - MarketplaceManager: remote catalog fetch with 24h cache, search/filter/popular queries - PluginAutoUpdate: scheduled update checks, parallel check, auto-install option, notification callback - Enhanced /plugin command: install/remove/update/search subcommands (was: load/unload/reload/info) Co-authored-by: Copilot <223556219+Copilot@users.noreply.github.com>pull/1/head
abel533
1 month ago
parent
76191f5035
commit
12557f23f0
@ -0,0 +1,227 @@ |
|||||||
|
package com.claudecode.plugin; |
||||||
|
|
||||||
|
import com.fasterxml.jackson.core.type.TypeReference; |
||||||
|
import com.fasterxml.jackson.databind.ObjectMapper; |
||||||
|
import org.slf4j.Logger; |
||||||
|
import org.slf4j.LoggerFactory; |
||||||
|
|
||||||
|
import java.net.URI; |
||||||
|
import java.net.http.HttpClient; |
||||||
|
import java.net.http.HttpRequest; |
||||||
|
import java.net.http.HttpResponse; |
||||||
|
import java.nio.file.*; |
||||||
|
import java.time.Duration; |
||||||
|
import java.time.Instant; |
||||||
|
import java.util.*; |
||||||
|
import java.util.concurrent.ConcurrentHashMap; |
||||||
|
|
||||||
|
/** |
||||||
|
* 市场管理器 —— 对应 claude-code 中 marketplace 的目录获取与缓存。 |
||||||
|
* <p> |
||||||
|
* 功能： |
||||||
|
* <ul> |
||||||
|
* <li>获取远程市场插件目录</li> |
||||||
|
* <li>本地缓存（TTL 24小时）</li> |
||||||
|
* <li>搜索和过滤</li> |
||||||
|
* <li>热门推荐</li> |
||||||
|
* </ul> |
||||||
|
* <p> |
||||||
|
* 缓存位置: ~/.claude-code-java/marketplace-cache.json |
||||||
|
*/ |
||||||
|
public class MarketplaceManager { |
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(MarketplaceManager.class); |
||||||
|
private static final ObjectMapper MAPPER = new ObjectMapper(); |
||||||
|
|
||||||
|
/** 默认市场 URL（可配置） */ |
||||||
|
private static final String DEFAULT_MARKETPLACE_URL = |
||||||
|
"https://marketplace.claude-code.dev/api/v1"; |
||||||
|
|
||||||
|
/** 缓存 TTL：24小时 */ |
||||||
|
private static final Duration CACHE_TTL = Duration.ofHours(24); |
||||||
|
|
||||||
|
private final String marketplaceUrl; |
||||||
|
private final Path cacheFile; |
||||||
|
private final HttpClient httpClient; |
||||||
|
|
||||||
|
/** 内存缓存 */ |
||||||
|
private final ConcurrentHashMap<String, PluginManifest.MarketplaceEntry> catalog = new ConcurrentHashMap<>(); |
||||||
|
private Instant lastFetchTime = Instant.EPOCH; |
||||||
|
|
||||||
|
public MarketplaceManager() { |
||||||
|
this(DEFAULT_MARKETPLACE_URL); |
||||||
|
} |
||||||
|
|
||||||
|
public MarketplaceManager(String marketplaceUrl) { |
||||||
|
this.marketplaceUrl = marketplaceUrl; |
||||||
|
this.cacheFile = Path.of( |
||||||
|
System.getProperty("user.home"), ".claude-code-java", "marketplace-cache.json"); |
||||||
|
this.httpClient = HttpClient.newBuilder() |
||||||
|
.connectTimeout(Duration.ofSeconds(15)) |
||||||
|
.followRedirects(HttpClient.Redirect.NORMAL) |
||||||
|
.build(); |
||||||
|
|
||||||
|
// 尝试从本地缓存加载
|
||||||
|
loadCache(); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 获取完整目录（必要时从远程刷新）。 |
||||||
|
*/ |
||||||
|
public List<PluginManifest.MarketplaceEntry> getCatalog(boolean forceRefresh) { |
||||||
|
if (forceRefresh || isCacheExpired()) { |
||||||
|
fetchRemoteCatalog(); |
||||||
|
} |
||||||
|
return new ArrayList<>(catalog.values()); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 搜索插件（按名称、描述、标签）。 |
||||||
|
*/ |
||||||
|
public List<PluginManifest.MarketplaceEntry> search(String query) { |
||||||
|
if (isCacheExpired()) { |
||||||
|
fetchRemoteCatalog(); |
||||||
|
} |
||||||
|
|
||||||
|
String lowerQuery = query.toLowerCase(); |
||||||
|
return catalog.values().stream() |
||||||
|
.filter(e -> matchesQuery(e, lowerQuery)) |
||||||
|
.sorted(Comparator.comparingLong(PluginManifest.MarketplaceEntry::downloads).reversed()) |
||||||
|
.toList(); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 获取单个插件信息。 |
||||||
|
*/ |
||||||
|
public Optional<PluginManifest.MarketplaceEntry> getPlugin(String pluginId) { |
||||||
|
if (isCacheExpired()) { |
||||||
|
fetchRemoteCatalog(); |
||||||
|
} |
||||||
|
return Optional.ofNullable(catalog.get(pluginId)); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 获取热门插件。 |
||||||
|
*/ |
||||||
|
public List<PluginManifest.MarketplaceEntry> getPopular(int limit) { |
||||||
|
return catalog.values().stream() |
||||||
|
.sorted(Comparator.comparingLong(PluginManifest.MarketplaceEntry::downloads).reversed()) |
||||||
|
.limit(limit) |
||||||
|
.toList(); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 获取指定标签的插件。 |
||||||
|
*/ |
||||||
|
public List<PluginManifest.MarketplaceEntry> getByTag(String tag) { |
||||||
|
return catalog.values().stream() |
||||||
|
.filter(e -> e.tags() != null && e.tags().contains(tag)) |
||||||
|
.toList(); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 目录大小。 |
||||||
|
*/ |
||||||
|
public int size() { |
||||||
|
return catalog.size(); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 上次获取时间。 |
||||||
|
*/ |
||||||
|
public Instant getLastFetchTime() { |
||||||
|
return lastFetchTime; |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 远程获取 ====================
|
||||||
|
|
||||||
|
private void fetchRemoteCatalog() { |
||||||
|
try { |
||||||
|
HttpRequest request = HttpRequest.newBuilder() |
||||||
|
.uri(URI.create(marketplaceUrl + "/plugins")) |
||||||
|
.timeout(Duration.ofSeconds(30)) |
||||||
|
.header("Accept", "application/json") |
||||||
|
.header("User-Agent", "claude-code-java/1.0") |
||||||
|
.GET() |
||||||
|
.build(); |
||||||
|
|
||||||
|
HttpResponse<String> response = httpClient.send(request, |
||||||
|
HttpResponse.BodyHandlers.ofString()); |
||||||
|
|
||||||
|
if (response.statusCode() == 200) { |
||||||
|
List<PluginManifest.MarketplaceEntry> entries = |
||||||
|
PluginManifest.MarketplaceEntry.fromJsonArray(response.body()); |
||||||
|
|
||||||
|
catalog.clear(); |
||||||
|
for (var entry : entries) { |
||||||
|
catalog.put(entry.id(), entry); |
||||||
|
} |
||||||
|
lastFetchTime = Instant.now(); |
||||||
|
saveCache(); |
||||||
|
|
||||||
|
log.info("Fetched {} plugins from marketplace", entries.size()); |
||||||
|
} else { |
||||||
|
log.warn("Marketplace API returned status: {}", response.statusCode()); |
||||||
|
} |
||||||
|
} catch (Exception e) { |
||||||
|
log.warn("Failed to fetch marketplace catalog: {}", e.getMessage()); |
||||||
|
// 使用本地缓存（如果有）
|
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 本地缓存 ====================
|
||||||
|
|
||||||
|
private void loadCache() { |
||||||
|
if (!Files.isRegularFile(cacheFile)) return; |
||||||
|
try { |
||||||
|
CacheData data = MAPPER.readValue(cacheFile.toFile(), CacheData.class); |
||||||
|
if (data.entries != null) { |
||||||
|
for (var entry : data.entries) { |
||||||
|
catalog.put(entry.id(), entry); |
||||||
|
} |
||||||
|
} |
||||||
|
if (data.fetchTime != null) { |
||||||
|
lastFetchTime = Instant.parse(data.fetchTime); |
||||||
|
} |
||||||
|
log.debug("Loaded {} entries from marketplace cache", catalog.size()); |
||||||
|
} catch (Exception e) { |
||||||
|
log.debug("Failed to load marketplace cache: {}", e.getMessage()); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
private void saveCache() { |
||||||
|
try { |
||||||
|
Files.createDirectories(cacheFile.getParent()); |
||||||
|
CacheData data = new CacheData( |
||||||
|
lastFetchTime.toString(), new ArrayList<>(catalog.values())); |
||||||
|
MAPPER.writerWithDefaultPrettyPrinter() |
||||||
|
.writeValue(cacheFile.toFile(), data); |
||||||
|
} catch (Exception e) { |
||||||
|
log.debug("Failed to save marketplace cache: {}", e.getMessage()); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
private boolean isCacheExpired() { |
||||||
|
return Duration.between(lastFetchTime, Instant.now()).compareTo(CACHE_TTL) > 0; |
||||||
|
} |
||||||
|
|
||||||
|
private boolean matchesQuery(PluginManifest.MarketplaceEntry entry, String query) { |
||||||
|
if (entry.name() != null && entry.name().toLowerCase().contains(query)) return true; |
||||||
|
if (entry.description() != null && entry.description().toLowerCase().contains(query)) return true; |
||||||
|
if (entry.id() != null && entry.id().toLowerCase().contains(query)) return true; |
||||||
|
if (entry.author() != null && entry.author().toLowerCase().contains(query)) return true; |
||||||
|
if (entry.tags() != null) { |
||||||
|
for (String tag : entry.tags()) { |
||||||
|
if (tag.toLowerCase().contains(query)) return true; |
||||||
|
} |
||||||
|
} |
||||||
|
return false; |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 缓存数据结构 ====================
|
||||||
|
|
||||||
|
private record CacheData( |
||||||
|
String fetchTime, |
||||||
|
List<PluginManifest.MarketplaceEntry> entries |
||||||
|
) {} |
||||||
|
} |
||||||
@ -0,0 +1,191 @@ |
|||||||
|
package com.claudecode.plugin; |
||||||
|
|
||||||
|
import org.slf4j.Logger; |
||||||
|
import org.slf4j.LoggerFactory; |
||||||
|
|
||||||
|
import java.time.*; |
||||||
|
import java.util.*; |
||||||
|
import java.util.concurrent.*; |
||||||
|
|
||||||
|
/** |
||||||
|
* 插件自动更新器 —— 每日检查已安装插件的更新。 |
||||||
|
* <p> |
||||||
|
* 对应 claude-code 中插件自动更新逻辑。 |
||||||
|
* <p> |
||||||
|
* 特性： |
||||||
|
* <ul> |
||||||
|
* <li>可配置检查间隔（默认24小时）</li> |
||||||
|
* <li>只通知，不自动安装（除非配置 autoInstall=true）</li> |
||||||
|
* <li>并行检查所有已安装插件</li> |
||||||
|
* <li>记录上次检查时间，避免频繁检查</li> |
||||||
|
* </ul> |
||||||
|
*/ |
||||||
|
public class PluginAutoUpdate { |
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(PluginAutoUpdate.class); |
||||||
|
|
||||||
|
private final PluginInstaller installer; |
||||||
|
private final PluginManager pluginManager; |
||||||
|
private final String marketplaceUrl; |
||||||
|
|
||||||
|
/** 是否自动安装更新 */ |
||||||
|
private boolean autoInstall = false; |
||||||
|
|
||||||
|
/** 检查间隔 */ |
||||||
|
private Duration checkInterval = Duration.ofHours(24); |
||||||
|
|
||||||
|
/** 上次检查时间 */ |
||||||
|
private Instant lastCheckTime = Instant.EPOCH; |
||||||
|
|
||||||
|
/** 可用更新缓存 */ |
||||||
|
private final ConcurrentHashMap<String, PluginInstaller.UpdateCheckResult> pendingUpdates = |
||||||
|
new ConcurrentHashMap<>(); |
||||||
|
|
||||||
|
/** 更新通知回调 */ |
||||||
|
private UpdateNotificationCallback notificationCallback; |
||||||
|
|
||||||
|
private final ScheduledExecutorService scheduler = |
||||||
|
Executors.newSingleThreadScheduledExecutor(r -> { |
||||||
|
Thread t = new Thread(r, "plugin-auto-update"); |
||||||
|
t.setDaemon(true); |
||||||
|
return t; |
||||||
|
}); |
||||||
|
|
||||||
|
public PluginAutoUpdate(PluginInstaller installer, PluginManager pluginManager) { |
||||||
|
this(installer, pluginManager, "https://marketplace.claude-code.dev/api/v1"); |
||||||
|
} |
||||||
|
|
||||||
|
public PluginAutoUpdate(PluginInstaller installer, PluginManager pluginManager, |
||||||
|
String marketplaceUrl) { |
||||||
|
this.installer = installer; |
||||||
|
this.pluginManager = pluginManager; |
||||||
|
this.marketplaceUrl = marketplaceUrl; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 启动定期检查。 |
||||||
|
*/ |
||||||
|
public void start() { |
||||||
|
long intervalHours = checkInterval.toHours(); |
||||||
|
scheduler.scheduleWithFixedDelay(this::checkForUpdates, |
||||||
|
1, intervalHours, TimeUnit.HOURS); |
||||||
|
log.info("Plugin auto-update started (interval: {}h)", intervalHours); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 停止定期检查。 |
||||||
|
*/ |
||||||
|
public void stop() { |
||||||
|
scheduler.shutdown(); |
||||||
|
try { |
||||||
|
if (!scheduler.awaitTermination(5, TimeUnit.SECONDS)) { |
||||||
|
scheduler.shutdownNow(); |
||||||
|
} |
||||||
|
} catch (InterruptedException e) { |
||||||
|
scheduler.shutdownNow(); |
||||||
|
Thread.currentThread().interrupt(); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 立即检查所有已安装插件的更新。 |
||||||
|
*/ |
||||||
|
public Map<String, PluginInstaller.UpdateCheckResult> checkForUpdates() { |
||||||
|
Map<String, PluginInstaller.InstalledPluginInfo> installed = installer.listInstalled(); |
||||||
|
if (installed.isEmpty()) { |
||||||
|
log.debug("No installed plugins to check for updates"); |
||||||
|
return Map.of(); |
||||||
|
} |
||||||
|
|
||||||
|
log.info("Checking updates for {} plugins...", installed.size()); |
||||||
|
|
||||||
|
// 并行检查所有插件
|
||||||
|
List<CompletableFuture<PluginInstaller.UpdateCheckResult>> futures = new ArrayList<>(); |
||||||
|
for (var entry : installed.values()) { |
||||||
|
futures.add(installer.checkUpdate( |
||||||
|
entry.id(), entry.version(), marketplaceUrl)); |
||||||
|
} |
||||||
|
|
||||||
|
// 等待所有结果
|
||||||
|
Map<String, PluginInstaller.UpdateCheckResult> results = new HashMap<>(); |
||||||
|
for (var future : futures) { |
||||||
|
try { |
||||||
|
var result = future.get(30, TimeUnit.SECONDS); |
||||||
|
if (result.hasUpdate()) { |
||||||
|
results.put(result.pluginId(), result); |
||||||
|
pendingUpdates.put(result.pluginId(), result); |
||||||
|
log.info("Update available: {} {} → {}", |
||||||
|
result.pluginId(), result.currentVersion(), result.latestVersion()); |
||||||
|
|
||||||
|
// 自动安装
|
||||||
|
if (autoInstall && result.downloadUrl() != null) { |
||||||
|
var installed2 = installer.listInstalled().get(result.pluginId()); |
||||||
|
if (installed2 != null) { |
||||||
|
var installResult = installer.install( |
||||||
|
result.downloadUrl(), installed2.scope()); |
||||||
|
log.info("Auto-updated {}: {}", result.pluginId(), installResult.message()); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
|
} catch (Exception e) { |
||||||
|
log.debug("Update check failed: {}", e.getMessage()); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
lastCheckTime = Instant.now(); |
||||||
|
|
||||||
|
// 通知回调
|
||||||
|
if (!results.isEmpty() && notificationCallback != null) { |
||||||
|
notificationCallback.onUpdatesAvailable(results); |
||||||
|
} |
||||||
|
|
||||||
|
log.info("Update check complete: {} updates available", results.size()); |
||||||
|
return results; |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 获取待处理的更新列表。 |
||||||
|
*/ |
||||||
|
public Map<String, PluginInstaller.UpdateCheckResult> getPendingUpdates() { |
||||||
|
return Map.copyOf(pendingUpdates); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 清除指定插件的待更新标记。 |
||||||
|
*/ |
||||||
|
public void clearPendingUpdate(String pluginId) { |
||||||
|
pendingUpdates.remove(pluginId); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 是否需要检查（距上次检查超过 interval）。 |
||||||
|
*/ |
||||||
|
public boolean shouldCheck() { |
||||||
|
return Duration.between(lastCheckTime, Instant.now()).compareTo(checkInterval) > 0; |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 配置 ====================
|
||||||
|
|
||||||
|
public void setAutoInstall(boolean autoInstall) { |
||||||
|
this.autoInstall = autoInstall; |
||||||
|
} |
||||||
|
|
||||||
|
public void setCheckInterval(Duration interval) { |
||||||
|
this.checkInterval = interval; |
||||||
|
} |
||||||
|
|
||||||
|
public void setNotificationCallback(UpdateNotificationCallback callback) { |
||||||
|
this.notificationCallback = callback; |
||||||
|
} |
||||||
|
|
||||||
|
public Instant getLastCheckTime() { |
||||||
|
return lastCheckTime; |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 回调接口 ====================
|
||||||
|
|
||||||
|
@FunctionalInterface |
||||||
|
public interface UpdateNotificationCallback { |
||||||
|
void onUpdatesAvailable(Map<String, PluginInstaller.UpdateCheckResult> updates); |
||||||
|
} |
||||||
|
} |
||||||
@ -0,0 +1,258 @@ |
|||||||
|
package com.claudecode.plugin; |
||||||
|
|
||||||
|
import org.slf4j.Logger; |
||||||
|
import org.slf4j.LoggerFactory; |
||||||
|
|
||||||
|
import java.io.*; |
||||||
|
import java.net.URI; |
||||||
|
import java.net.http.HttpClient; |
||||||
|
import java.net.http.HttpRequest; |
||||||
|
import java.net.http.HttpResponse; |
||||||
|
import java.nio.file.*; |
||||||
|
import java.time.Duration; |
||||||
|
import java.util.*; |
||||||
|
import java.util.concurrent.CompletableFuture; |
||||||
|
import java.util.jar.JarEntry; |
||||||
|
import java.util.jar.JarFile; |
||||||
|
|
||||||
|
/** |
||||||
|
* 插件安装器 —— 处理插件的下载、解压、版本管理。 |
||||||
|
* <p> |
||||||
|
* 对应 claude-code 中 marketplace 的安装逻辑。 |
||||||
|
* <p> |
||||||
|
* 安装目录结构： |
||||||
|
* <pre> |
||||||
|
* ~/.claude-code-java/plugins/ (user 级) |
||||||
|
* {project}/.claude-code/plugins/ (project 级) |
||||||
|
* ~/.claude-code-java/plugin-cache/ (下载缓存) |
||||||
|
* </pre> |
||||||
|
*/ |
||||||
|
public class PluginInstaller { |
||||||
|
|
||||||
|
private static final Logger log = LoggerFactory.getLogger(PluginInstaller.class); |
||||||
|
|
||||||
|
private final HttpClient httpClient; |
||||||
|
private final Path cacheDir; |
||||||
|
private final Path userPluginDir; |
||||||
|
private final Path projectPluginDir; |
||||||
|
|
||||||
|
public PluginInstaller(Path workDir) { |
||||||
|
this.httpClient = HttpClient.newBuilder() |
||||||
|
.connectTimeout(Duration.ofSeconds(30)) |
||||||
|
.followRedirects(HttpClient.Redirect.NORMAL) |
||||||
|
.build(); |
||||||
|
Path home = Path.of(System.getProperty("user.home"), ".claude-code-java"); |
||||||
|
this.cacheDir = home.resolve("plugin-cache"); |
||||||
|
this.userPluginDir = home.resolve("plugins"); |
||||||
|
this.projectPluginDir = workDir.resolve(".claude-code").resolve("plugins"); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 安装插件。 |
||||||
|
* |
||||||
|
* @param downloadUrl 下载 URL（JAR 文件） |
||||||
|
* @param scope 安装作用域：user / project |
||||||
|
* @return 安装结果 |
||||||
|
*/ |
||||||
|
public InstallResult install(String downloadUrl, String scope) { |
||||||
|
try { |
||||||
|
// 下载
|
||||||
|
Path downloaded = download(downloadUrl); |
||||||
|
|
||||||
|
// 读取并校验 manifest
|
||||||
|
PluginManifest manifest = readManifestFromJar(downloaded); |
||||||
|
if (manifest == null) { |
||||||
|
return new InstallResult(false, null, "No manifest.json found in JAR"); |
||||||
|
} |
||||||
|
|
||||||
|
List<String> errors = manifest.validate(); |
||||||
|
if (!errors.isEmpty()) { |
||||||
|
return new InstallResult(false, null, "Invalid manifest: " + String.join(", ", errors)); |
||||||
|
} |
||||||
|
|
||||||
|
if (!manifest.supportsScope(scope)) { |
||||||
|
return new InstallResult(false, manifest.id(), |
||||||
|
"Plugin does not support scope: " + scope); |
||||||
|
} |
||||||
|
|
||||||
|
// 确定目标目录
|
||||||
|
Path targetDir = "project".equals(scope) ? projectPluginDir : userPluginDir; |
||||||
|
Files.createDirectories(targetDir); |
||||||
|
|
||||||
|
// 检查已安装版本
|
||||||
|
Path existing = targetDir.resolve(manifest.id() + ".jar"); |
||||||
|
if (Files.exists(existing)) { |
||||||
|
PluginManifest existingManifest = readManifestFromJar(existing); |
||||||
|
if (existingManifest != null && |
||||||
|
existingManifest.version().equals(manifest.version())) { |
||||||
|
return new InstallResult(true, manifest.id(), |
||||||
|
"Already installed: " + manifest.name() + " v" + manifest.version()); |
||||||
|
} |
||||||
|
// 备份旧版本
|
||||||
|
Path backup = targetDir.resolve(manifest.id() + ".jar.bak"); |
||||||
|
Files.move(existing, backup, StandardCopyOption.REPLACE_EXISTING); |
||||||
|
log.info("Backed up existing version to {}", backup.getFileName()); |
||||||
|
} |
||||||
|
|
||||||
|
// 复制到目标
|
||||||
|
Files.copy(downloaded, existing, StandardCopyOption.REPLACE_EXISTING); |
||||||
|
|
||||||
|
log.info("Installed plugin: {} v{} to {} ({})", |
||||||
|
manifest.name(), manifest.version(), targetDir, scope); |
||||||
|
return new InstallResult(true, manifest.id(), |
||||||
|
"Installed " + manifest.name() + " v" + manifest.version()); |
||||||
|
|
||||||
|
} catch (Exception e) { |
||||||
|
log.error("Plugin installation failed: {}", e.getMessage(), e); |
||||||
|
return new InstallResult(false, null, "Installation failed: " + e.getMessage()); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 卸载插件。 |
||||||
|
*/ |
||||||
|
public boolean uninstall(String pluginId, String scope) { |
||||||
|
Path targetDir = "project".equals(scope) ? projectPluginDir : userPluginDir; |
||||||
|
Path jarFile = targetDir.resolve(pluginId + ".jar"); |
||||||
|
try { |
||||||
|
if (Files.deleteIfExists(jarFile)) { |
||||||
|
// 也清理备份
|
||||||
|
Files.deleteIfExists(targetDir.resolve(pluginId + ".jar.bak")); |
||||||
|
log.info("Uninstalled plugin: {} from {}", pluginId, scope); |
||||||
|
return true; |
||||||
|
} |
||||||
|
log.warn("Plugin JAR not found: {}", jarFile); |
||||||
|
return false; |
||||||
|
} catch (IOException e) { |
||||||
|
log.error("Failed to uninstall plugin: {}", e.getMessage()); |
||||||
|
return false; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 检查插件是否有更新。 |
||||||
|
*/ |
||||||
|
public CompletableFuture<UpdateCheckResult> checkUpdate( |
||||||
|
String pluginId, String currentVersion, String checkUrl) { |
||||||
|
return CompletableFuture.supplyAsync(() -> { |
||||||
|
try { |
||||||
|
HttpRequest request = HttpRequest.newBuilder() |
||||||
|
.uri(URI.create(checkUrl + "/" + pluginId + "/latest")) |
||||||
|
.timeout(Duration.ofSeconds(10)) |
||||||
|
.GET() |
||||||
|
.build(); |
||||||
|
|
||||||
|
HttpResponse<String> response = httpClient.send(request, |
||||||
|
HttpResponse.BodyHandlers.ofString()); |
||||||
|
|
||||||
|
if (response.statusCode() == 200) { |
||||||
|
PluginManifest.MarketplaceEntry entry = |
||||||
|
new com.fasterxml.jackson.databind.ObjectMapper() |
||||||
|
.readValue(response.body(), |
||||||
|
PluginManifest.MarketplaceEntry.class); |
||||||
|
boolean hasUpdate = compareVersions(entry.version(), currentVersion) > 0; |
||||||
|
return new UpdateCheckResult(pluginId, currentVersion, |
||||||
|
entry.version(), hasUpdate, entry.downloadUrl()); |
||||||
|
} |
||||||
|
return new UpdateCheckResult(pluginId, currentVersion, null, false, null); |
||||||
|
} catch (Exception e) { |
||||||
|
log.debug("Update check failed for {}: {}", pluginId, e.getMessage()); |
||||||
|
return new UpdateCheckResult(pluginId, currentVersion, null, false, null); |
||||||
|
} |
||||||
|
}); |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 列出已安装的插件 JAR。 |
||||||
|
*/ |
||||||
|
public Map<String, InstalledPluginInfo> listInstalled() { |
||||||
|
Map<String, InstalledPluginInfo> result = new TreeMap<>(); |
||||||
|
scanInstalled(userPluginDir, "user", result); |
||||||
|
scanInstalled(projectPluginDir, "project", result); |
||||||
|
return result; |
||||||
|
} |
||||||
|
|
||||||
|
private void scanInstalled(Path dir, String scope, Map<String, InstalledPluginInfo> result) { |
||||||
|
if (!Files.isDirectory(dir)) return; |
||||||
|
try (var stream = Files.list(dir)) { |
||||||
|
stream.filter(p -> p.toString().endsWith(".jar")) |
||||||
|
.forEach(jar -> { |
||||||
|
PluginManifest m = readManifestFromJar(jar); |
||||||
|
if (m != null) { |
||||||
|
result.put(m.id(), new InstalledPluginInfo( |
||||||
|
m.id(), m.name(), m.version(), scope, jar)); |
||||||
|
} |
||||||
|
}); |
||||||
|
} catch (IOException e) { |
||||||
|
log.debug("Failed to scan {}: {}", dir, e.getMessage()); |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 内部方法 ====================
|
||||||
|
|
||||||
|
private Path download(String url) throws Exception { |
||||||
|
Files.createDirectories(cacheDir); |
||||||
|
String fileName = url.substring(url.lastIndexOf('/') + 1); |
||||||
|
if (!fileName.endsWith(".jar")) fileName += ".jar"; |
||||||
|
Path target = cacheDir.resolve(fileName); |
||||||
|
|
||||||
|
HttpRequest request = HttpRequest.newBuilder() |
||||||
|
.uri(URI.create(url)) |
||||||
|
.timeout(Duration.ofMinutes(5)) |
||||||
|
.GET() |
||||||
|
.build(); |
||||||
|
|
||||||
|
HttpResponse<Path> response = httpClient.send(request, |
||||||
|
HttpResponse.BodyHandlers.ofFile(target)); |
||||||
|
|
||||||
|
if (response.statusCode() != 200) { |
||||||
|
throw new IOException("Download failed with status: " + response.statusCode()); |
||||||
|
} |
||||||
|
|
||||||
|
log.info("Downloaded {} ({} bytes)", fileName, Files.size(target)); |
||||||
|
return target; |
||||||
|
} |
||||||
|
|
||||||
|
static PluginManifest readManifestFromJar(Path jarPath) { |
||||||
|
try (JarFile jar = new JarFile(jarPath.toFile())) { |
||||||
|
JarEntry entry = jar.getJarEntry("manifest.json"); |
||||||
|
if (entry == null) return null; |
||||||
|
|
||||||
|
try (InputStream is = jar.getInputStream(entry)) { |
||||||
|
return PluginManifest.fromJson(is.readAllBytes()); |
||||||
|
} |
||||||
|
} catch (Exception e) { |
||||||
|
log.debug("Failed to read manifest from {}: {}", jarPath.getFileName(), e.getMessage()); |
||||||
|
return null; |
||||||
|
} |
||||||
|
} |
||||||
|
|
||||||
|
/** |
||||||
|
* 简单版本比较 (a.b.c 格式)。 |
||||||
|
* @return 正数表示 v1 > v2, 负数表示 v1 < v2, 0 表示相等 |
||||||
|
*/ |
||||||
|
static int compareVersions(String v1, String v2) { |
||||||
|
// 去掉非数字后缀 (e.g., "1.2.3-beta" → "1.2.3")
|
||||||
|
String[] parts1 = v1.replaceAll("[^0-9.].*", "").split("\\."); |
||||||
|
String[] parts2 = v2.replaceAll("[^0-9.].*", "").split("\\."); |
||||||
|
|
||||||
|
int maxLen = Math.max(parts1.length, parts2.length); |
||||||
|
for (int i = 0; i < maxLen; i++) { |
||||||
|
int p1 = i < parts1.length ? Integer.parseInt(parts1[i]) : 0; |
||||||
|
int p2 = i < parts2.length ? Integer.parseInt(parts2[i]) : 0; |
||||||
|
if (p1 != p2) return p1 - p2; |
||||||
|
} |
||||||
|
return 0; |
||||||
|
} |
||||||
|
|
||||||
|
// ==================== 结果类型 ====================
|
||||||
|
|
||||||
|
public record InstallResult(boolean success, String pluginId, String message) {} |
||||||
|
|
||||||
|
public record UpdateCheckResult( |
||||||
|
String pluginId, String currentVersion, String latestVersion, |
||||||
|
boolean hasUpdate, String downloadUrl) {} |
||||||
|
|
||||||
|
public record InstalledPluginInfo( |
||||||
|
String id, String name, String version, String scope, Path jarPath) {} |
||||||
|
} |
||||||
@ -0,0 +1,118 @@ |
|||||||
|
package com.claudecode.plugin; |
||||||
|
|
||||||
|
import com.fasterxml.jackson.annotation.JsonIgnoreProperties; |
||||||
|
import com.fasterxml.jackson.core.type.TypeReference; |
||||||
|
import com.fasterxml.jackson.databind.ObjectMapper; |
||||||
|
|
||||||
|
import java.util.List; |
||||||
|
import java.util.Map; |
||||||
|
|
||||||
|
/** |
||||||
|
* 插件清单 —— 对应 claude-code 中 manifest.json 的 Java 映射。 |
||||||
|
* <p> |
||||||
|
* 每个可安装的插件必须包含一个 manifest.json，声明其元数据和能力。 |
||||||
|
*/ |
||||||
|
@JsonIgnoreProperties(ignoreUnknown = true) |
||||||
|
public record PluginManifest( |
||||||
|
/** 插件唯一 ID (kebab-case) */ |
||||||
|
String id, |
||||||
|
/** 显示名称 */ |
||||||
|
String name, |
||||||
|
/** 版本号 (semver) */ |
||||||
|
String version, |
||||||
|
/** 功能描述 */ |
||||||
|
String description, |
||||||
|
/** 作者 */ |
||||||
|
String author, |
||||||
|
/** 主页 URL */ |
||||||
|
String homepage, |
||||||
|
/** 许可证 */ |
||||||
|
String license, |
||||||
|
/** 最低 claude-code-java 版本 */ |
||||||
|
String minAppVersion, |
||||||
|
/** 入口类（JAR 中实现 Plugin 接口的类） */ |
||||||
|
String mainClass, |
||||||
|
/** 声明的工具 */ |
||||||
|
List<DeclaredTool> tools, |
||||||
|
/** 声明的命令 */ |
||||||
|
List<DeclaredCommand> commands, |
||||||
|
/** 声明的 Hook */ |
||||||
|
List<DeclaredHook> hooks, |
||||||
|
/** 安装作用域支持 */ |
||||||
|
List<String> scopes, |
||||||
|
/** 依赖的其他插件 ID */ |
||||||
|
List<String> dependencies, |
||||||
|
/** 额外元数据 */ |
||||||
|
Map<String, Object> metadata |
||||||
|
) { |
||||||
|
private static final ObjectMapper MAPPER = new ObjectMapper(); |
||||||
|
|
||||||
|
/** 从 JSON 字符串解析 */ |
||||||
|
public static PluginManifest fromJson(String json) throws Exception { |
||||||
|
return MAPPER.readValue(json, PluginManifest.class); |
||||||
|
} |
||||||
|
|
||||||
|
/** 从 JSON bytes 解析 */ |
||||||
|
public static PluginManifest fromJson(byte[] json) throws Exception { |
||||||
|
return MAPPER.readValue(json, PluginManifest.class); |
||||||
|
} |
||||||
|
|
||||||
|
/** 序列化为 JSON */ |
||||||
|
public String toJson() throws Exception { |
||||||
|
return MAPPER.writerWithDefaultPrettyPrinter().writeValueAsString(this); |
||||||
|
} |
||||||
|
|
||||||
|
/** 校验必填字段 */ |
||||||
|
public List<String> validate() { |
||||||
|
var errors = new java.util.ArrayList<String>(); |
||||||
|
if (id == null || id.isBlank()) errors.add("id is required"); |
||||||
|
if (name == null || name.isBlank()) errors.add("name is required"); |
||||||
|
if (version == null || version.isBlank()) errors.add("version is required"); |
||||||
|
if (mainClass == null || mainClass.isBlank()) errors.add("mainClass is required"); |
||||||
|
|
||||||
|
if (id != null && !id.matches("^[a-z][a-z0-9-]*$")) { |
||||||
|
errors.add("id must be kebab-case: " + id); |
||||||
|
} |
||||||
|
if (version != null && !version.matches("^\\d+\\.\\d+\\.\\d+.*$")) { |
||||||
|
errors.add("version must be semver: " + version); |
||||||
|
} |
||||||
|
return errors; |
||||||
|
} |
||||||
|
|
||||||
|
/** 是否支持指定作用域 */ |
||||||
|
public boolean supportsScope(String scope) { |
||||||
|
return scopes == null || scopes.isEmpty() || scopes.contains(scope); |
||||||
|
} |
||||||
|
|
||||||
|
// ---- 子记录 ----
|
||||||
|
|
||||||
|
@JsonIgnoreProperties(ignoreUnknown = true) |
||||||
|
public record DeclaredTool(String name, String description, boolean readOnly) {} |
||||||
|
|
||||||
|
@JsonIgnoreProperties(ignoreUnknown = true) |
||||||
|
public record DeclaredCommand(String name, String description) {} |
||||||
|
|
||||||
|
@JsonIgnoreProperties(ignoreUnknown = true) |
||||||
|
public record DeclaredHook(String event, String handler) {} |
||||||
|
|
||||||
|
/** |
||||||
|
* 市场目录条目 —— 市场 API 返回的精简信息。 |
||||||
|
*/ |
||||||
|
@JsonIgnoreProperties(ignoreUnknown = true) |
||||||
|
public record MarketplaceEntry( |
||||||
|
String id, |
||||||
|
String name, |
||||||
|
String version, |
||||||
|
String description, |
||||||
|
String author, |
||||||
|
String downloadUrl, |
||||||
|
long downloads, |
||||||
|
double rating, |
||||||
|
String updatedAt, |
||||||
|
List<String> tags |
||||||
|
) { |
||||||
|
public static List<MarketplaceEntry> fromJsonArray(String json) throws Exception { |
||||||
|
return MAPPER.readValue(json, new TypeReference<>() {}); |
||||||
|
} |
||||||
|
} |
||||||
|
} |
||||||
Loading…
Reference in new issue