kotlin-multiplatform-libraries-expert

KMP Klibs 版本指南

使用 klibs.io 作为 Kotlin Multiplatform 库发现与版本选择的首要依据。

适用场景

• 用户询问 KMP 库的最新稳定版本
• 用户需要 KMP 依赖的 Gradle 坐标
• 用户询问某种功能（存储、网络、日志记录、DI、数据库、UI 等）应选择哪个 KMP 库
• 用户想升级 KMP 依赖或验证目标平台支持情况（iOS、Android、JVM、JS、Wasm、Kotlin/Native）
• 用户需要 KMP 库推荐，且版本准确性很重要

不适用场景

• 用户询问一般的 Kotlin、Compose Multiplatform、Android、Gradle 或构建故障排查，且不需要发现库、查询版本、坐标或目标平台支持情况
• 用户询问如何配置 KMP 项目，但不需要选择或验证第三方库
• 用户询问仅支持 Android 或 JVM 的依赖，且不需要验证 KMP 支持情况
• 用户需要已选定库的实现指导，且当前依赖元数据无关紧要
• 用户询问的是 klibs.io 本身的发布、索引或贡献方式，而非选择 KMP 库

核心规则

1. 将 klibs.io 视为版本和 KMP 支持情况的权威来源。
2. 除非用户明确需要预发布版本（alpha、beta、rc、eap 等），否则推荐最新的稳定版。
3. 优先采用 MCP 或 klibs.io/package/… 页面中的准确坐标，而非猜测 README 片段中的坐标。
4. 如果只有项目页面可用，先用它确定项目，再查找对应的包页面获取坐标。
5. 如果 klibs.io 上没有某个库，应明确说明，不要将未经验证的版本当作事实提供。
6. 用户询问“最新”版本时，提供版本号和发布日期（如果有）。
7. 比较库时，只比较 klibs.io 显示为支持所需目标平台的 KMP 库。

数据来源

MCP（优先）

klibs.io 提供一个 MCP 服务，支持两种操作：

• 搜索项目 — 按关键词、平台/目标平台和 Kotlin 版本查找 KMP 项目。返回项目名称、作者、平台、目标平台、包（groupId、artifactId、描述）和 README。
• 获取最新版本 — 获取 groupId:artifactId 的最新版本和最新稳定版本。返回版本、构建工具、构建工具版本和 Kotlin 版本。

MCP 配置：

{
    "mcpServers": {
        "klibs": {
            "url": "https://api.klibs.io/mcp"
        }
    }
}

优先使用 MCP，而非查询网页，因为它能返回结构化数据，速度也更快。

网页（备用）

• 项目页面：https://klibs.io/project/<owner>/<project> — 摘要、标签、平台系列、最新发行版、仓库链接。
• 包页面：https://klibs.io/package/<group>/<artifact> — 准确坐标、最新发行版、发布日期、版本历史、目标平台矩阵、Gradle 代码片段、Kotlin/构建工具版本。

查询步骤

1. 规范化 — group:artifact → 查询包；项目名称 → 查询项目；功能需求 → 搜索。
2. 选择方式 — 如果有 MCP 工具，则使用；否则浏览网页。
3. 检查目标平台 — 确认该库支持用户所需的目标平台。
4. 获取版本 — 记录准确版本和发布日期。MCP 会直接返回最新版本和最新稳定版本；使用网页时，如有需要，请查看版本历史。
5. 记录安装详情 — 优先使用 Gradle Kotlin 代码片段。
6. 回复 — 提供已验证的数据和 klibs.io 链接。

回复格式

对于版本问题：

Latest stable: <group>:<artifact>:<version>
Source: <klibs.io link>
Released: <date if available>
Targets: <relevant targets>

Gradle Kotlin:
implementation("<group>:<artifact>:<version>")

对于推荐：缩短候选列表，说明目标平台适配情况，只提供已验证的版本。

失败处理

如果 klibs.io 上没有该库：说明无法验证，不要编造版本，并提出可以在 klibs.io 上搜索替代库。