Skip to content

Sonatype Central SDKMaven Central 的 Go SDK

搜索、下载、发布 Maven 制品 —— 全面、类型安全、为 AI Agent 而生

Sonatype Central SDK

🤖 AI Agent 一键接入

把这个提示词复制粘贴到你的 AI 编程助手(Claude Code / Codex),它就会自动帮你安装、配置并使用本 SDK —— 你只需要描述你想做什么。

markdown
你是一个 Go 开发专家。我们现在需要在项目中使用 Sonatype Central Repository 的能力(搜索、下载、发布 Maven 制品)。

请使用 GitHub 上的开源 Go SDK `github.com/scagogogo/sonatype-central-sdk` 来完成。

请按以下步骤引导我:

1. 阅读官方文档了解能力:https://scagogogo.github.io/sonatype-central-skills/  和  https://github.com/scagogogo/sonatype-central-skills
2. 在当前 Go 项目中执行 `go get github.com/scagogogo/sonatype-central-sdk` 安装 SDK
3. 根据我要实现的功能,选择合适的包导入:
   - 搜索/下载:`github.com/scagogogo/sonatype-central-sdk/pkg/api``api.NewClient()`
   - 发布到 Maven Central:同包下的 `api.NewPublisherClient(api.WithPublisherToken("..."))`
4. 编写类型安全、带错误处理和 context 超时的调用代码
5. 如果涉及发布操作,先确认我是否已有 Sonatype Central 的 API Token;若没有,引导我去 https://central.sonatype.com 申请

我的具体需求是:<在这里用一句话描述你要做的事,比如“搜索 org.apache.commons 下所有制品的最新版本”>

请直接开始,遇到需要我决策的地方再问我。

💡 把上面代码块最后那行 <...> 替换成你的真实需求即可。AI 会读懂 SDK 的 API、自动补全调用代码、处理错误和分页。更多接入方式见 AI Agent 接入指南

📌 为什么这个提示词能work?

本 SDK 的所有方法都遵循 Go 习惯的 (ctx, 参数) -> (结果, error) 签名,类型定义集中在 pkg/response 包,AI 可以通过阅读 pkg/api 下的方法签名和 godoc 快速理解能力边界,无需你逐个教它。提示词只是告诉 AI 用哪个库去哪看文档,剩下的它自己能搞定。


这个 SDK 解决什么问题?

直接调用 Sonatype CentralMaven Central 的 HTTP API 需要自己处理:Solr 查询语法、URL 拼接、分页、JSON 解析、错误码、限流重试、校验和验证、multipart 上传……繁琐且容易出错。

本 SDK 把这些全部封装成类型安全的 Go 方法,一行调用即可完成原本几十行 HTTP 代码的工作:

go
client := api.NewClient()

// 搜索 org.apache.commons 下的制品
artifacts, _ := client.SearchByGroupId(ctx, "org.apache.commons", 10)

// 下载并验证校验和
data, _, _ := client.DownloadWithVerifiedChecksum(ctx,
    "org/apache/commons/commons-lang3/3.12.0/commons-lang3-3.12.0.jar", "sha1")

👉 详细的设计与原理见 它解决了什么问题工作原理

马上开始

基于 MIT 许可证发布