MPP-Core: Kotlin Multiplatform 核心模块
📋 概述
mpp-core 是一个 Kotlin Multiplatform 模块，提供跨平台的核心功能，支持 JVM、JavaScript 和 WebAssembly 平台。该模块将原本依赖 IntelliJ IDEA 平台的代码重构为平台无关的实现，为项目的跨平台扩展奠定基础。
✅ 当前成果
多平台支持
- JVM: Java 17，用于 IntelliJ IDEA 插件和服务器端
- JavaScript: Browser + Node.js，用于 Web 应用
- WebAssembly: 高性能 Web 应用支持
核心功能
- 工具接口: 统一的 Tool 抽象接口
- 平台抽象: expect/actual 机制处理平台差异
- YAML 支持: 基于 kaml 的多平台 YAML 处理
- 序列化: kotlinx.serialization 支持
- 协程: kotlinx.coroutines 支持
- 完整测试: 所有平台的单元测试覆盖
🏗️ 项目结构
mpp-core/
├── build.gradle.kts # 多平台构建配置
└── src/
├── commonMain/kotlin/cc/unitmesh/ # 平台无关代码
│ ├── agent/ # 工具接口 ✅
│ │ ├── Tool.kt # 核心抽象接口
│ │ ├── Platform.kt # 平台检测
│ │ └── Example.kt # 示例实现
│ └── yaml/ # YAML 工具 ✅
│ └── YamlUtils.kt # 多平台 YAML 处理
├── commonTest/kotlin/ # 平台无关测试
│ ├── cc/unitmesh/agent/ToolTest.kt
│ └── cc/unitmesh/yaml/YamlUtilsTest.kt
├── jvmMain/kotlin/ # JVM 特定实现
│ └── cc/unitmesh/agent/Platform.jvm.kt
├── jsMain/kotlin/ # JS 特定实现
│ └── cc/unitmesh/agent/Platform.js.kt
└── wasmJsMain/kotlin/ # WASM 特定实现
└── cc/unitmesh/agent/Platform.wasmJs.kt
🚀 快速开始
构建和测试
# 构建所有平台
./gradlew :mpp-core:build
# 运行所有平台测试
./gradlew :mpp-core:allTests
# 平台特定构建
./gradlew :mpp-core:jvmJar # JVM 平台
./gradlew :mpp-core:jsJar # JavaScript 平台
./gradlew :mpp-core:wasmJsJar # WebAssembly 平台
依赖配置
// 在其他模块中使用 mpp-core
dependencies {
implementation(project(":mpp-core"))
}
💡 设计原则
- 平台无关性: 只包含不依赖特定平台 API 的代码
- 向后兼容: 保持与现有模块的兼容性
- 渐进式迁移: 分阶段迁移，确保稳定性
- 类型安全: 利用 Kotlin 类型系统确保跨平台一致性
📋 后续迁移计划
✅ 优先级 1: 数据模型
目标: 迁移核心数据结构，为业务逻辑奠定基础
- ✅ Agent 配置模型 (
CustomAgentConfig,CustomAgentState) →cc.unitmesh.model.agent - ✅ 交互类型 (
ChatActionType,ChatRole,InteractionType) →cc.unitmesh.model.interaction - ✅ 基础工具模型 (
McpTool,McpToolCall) →cc.unitmesh.model.mcp
优先级 2: 命令系统 (中期)
目标: 迁移命令处理逻辑
候选模块:
- 命令数据提供者 (
BuiltinCommand,CustomCommand) - 文本处理工具 (
PostCodeProcessor) - 上下文数据结构 (
SimpleClassStructure)
技术挑战: 需要抽象化文件系统依赖
优先级 3: 处理器接口 (长期)
目标: 抽象化业务逻辑接口
候选模块:
- 语言处理器接口 (
LanguageProcessor) - 配置管理 (
McpChatConfig)
技术挑战: 需要设计平台抽象层
🔧 技术实现
构建配置
// mpp-core/build.gradle.kts
kotlin {
jvm { jvmTarget = "17" }
js(IR) { browser(); nodejs() }
wasmJs { browser(); nodejs() }
sourceSets {
commonMain.dependencies {
implementation("org.jetbrains.kotlinx:kotlinx-serialization-json:1.9.0")
implementation("org.jetbrains.kotlinx:kotlinx-coroutines-core:1.8.0")
implementation("com.charleskorn.kaml:kaml:0.61.0")
}
}
}
平台抽象机制
// commonMain/kotlin
expect object Platform {
val name: String
val isJvm: Boolean
val isJs: Boolean
val isWasm: Boolean
}
// 平台特定实现
// jvmMain/kotlin, jsMain/kotlin, wasmJsMain/kotlin
actual object Platform { /* 平台特定实现 */ }
📖 使用示例
基本使用
// 创建工具实例
val tool = ExampleTool()
// 创建配置
val config = tool.createConfig()
// 序列化
val json = tool.serializeConfig(config)
// 平台检测
when {
Platform.isJvm -> println("Running on JVM")
Platform.isJs -> println("Running on JavaScript")
Platform.isWasm -> println("Running on WebAssembly")
}
YAML 处理
// 解析 YAML
val data = YamlUtils.load(yamlContent)
// 序列化为 YAML
val yamlString = YamlUtils.dump(config, ConfigSerializer)
🧪 平台特定测试
JavaScript 平台测试
- 文件:
src/jsTest/kotlin/cc/unitmesh/yaml/JsYamlTest.kt - 覆盖: 浏览器和 Node.js 环境的 YAML 处理
- 特性: 性能测试、错误处理、JavaScript 特定场景
WebAssembly 平台测试
- 文件:
src/wasmJsTest/kotlin/cc/unitmesh/yaml/WasmYamlTest.kt - 覆盖: WebAssembly 环境的 YAML 处理
- 特性: 内存效率、高性能处理、WASM 特定优化
跨平台兼容性测试
- 文件:
src/commonTest/kotlin/cc/unitmesh/yaml/CrossPlatformYamlTest.kt - 覆盖: 所有平台的一致性验证
- 特性: 平台检测、数据类型兼容性、复杂结构处理
🔄 迁移策略
1. 数据类迁移
- ✅ 保持
@Serializable注解 - ✅ 移除 IntelliJ 特定类型 (如
Icon,VirtualFile) - ✅ 使用平台无关的替代方案
2. 接口抽象化
- ✅ 将平台相关的参数抽象为通用类型
- ✅ 使用
expect/actual机制处理平台差异 - ✅ 保持向后兼容性
3. 依赖管理
- ✅
core模块依赖mpp-core - ✅ 扩展模块根据需要添加
mpp-core依赖 - 📋 逐步减少对
core的直接依赖
4. 测试策略
- ✅ 为
mpp-core编写平台无关的单元测试 - ✅ 确保迁移后功能完整性
- ✅ 验证序列化/反序列化正确性
🚀 未来扩展
计划支持的平台
- Native: Kotlin/Native 支持 (Linux, macOS, Windows)
- iOS: iOS 应用支持
- Android: Android 应用支持
依赖关系图
mpp-core (多平台) ✅
├── core (JVM) - 依赖 mpp-core ✅
├── exts:devins-lang (JVM) - 依赖 mpp-core + core ✅
├── exts:ext-database (JVM) - 依赖 mpp-core + core ✅
└── exts:ext-git (JVM) - 依赖 mpp-core + core ✅
LICENSE
@autodev/cliInspired and Tools system based on Google Gemini CLI withApache License 2.0