引言：KMP的崛起与全栈愿景

• 从“一次编写，多端运行”到“一次逻辑，全栈共享”
• 为何KMP是全栈开发的理想技术底座？
• 本文目标：梳理从移动端到服务端，再到AI Agent的完整技术路径

第一部分：KMP技术栈深度解析

1.1 KMP核心架构与设计哲学

• 共享模块（commonMain）的边界与职责
• 平台特定实现（androidMain, iosMain, jsMain）的最佳实践
• 多平台资源管理与依赖注入策略

1.2 构建高效的全栈开发工作流

• 使用Kotlin Multiplatform Gradle插件进行项目配置
• 共享代码的测试策略：单元测试与集成测试
• CI/CD流水线设计：一次构建，多端部署

第二部分：从Android到Web的全栈实践

2.1 共享业务逻辑与状态管理

• 使用KMP实现跨平台的ViewModel/State管理
• 网络请求层共享：Ktor Client的多平台适配
• 数据持久化：SQLDelight与多平台数据库方案

示例：共享ViewModel/State管理

// commonMain/kotlin/com/example/shared/LoginViewModel.kt
import kotlinx.coroutines.flow.MutableStateFlow
import kotlinx.coroutines.flow.StateFlow
import kotlinx.coroutines.flow.asStateFlow

/**
 * 跨平台登录ViewModel，可在Android、iOS、Web端共享
 * 使用Kotlin Flow实现响应式状态管理
 */
class LoginViewModel {
    // 私有状态，使用MutableStateFlow管理
    private val _uiState = MutableStateFlow(LoginUiState())
    
    // 公开只读状态流，供UI层订阅
    val uiState: StateFlow<LoginUiState> = _uiState.asStateFlow()
    
    /**
     * 更新用户名
     * @param username 新用户名
     */
    fun updateUsername(username: String) {
        _uiState.value = _uiState.value.copy(username = username)
    }
    
    /**
     * 更新密码
     * @param password 新密码
     */
    fun updatePassword(password: String) {
        _uiState.value = _uiState.value.copy(password = password)
    }
    
    /**
     * 执行登录操作
     * 实际项目中这里会调用共享的网络请求层
     */
    suspend fun login() {
        _uiState.value = _uiState.value.copy(isLoading = true)
        try {
            // 这里可以调用共享的Ktor Client进行网络请求
            // val result = authRepository.login(uiState.value.username, uiState.value.password)
            _uiState.value = _uiState.value.copy(
                isLoading = false,
                isLoggedIn = true,
                errorMessage = null
            )
        } catch (e: Exception) {
            _uiState.value = _uiState.value.copy(
                isLoading = false,
                errorMessage = e.message ?: "登录失败"
            )
        }
    }
}

/**
 * 登录UI状态数据类
 * 使用@Serializable注解支持多平台序列化
 */
@Serializable
data class LoginUiState(
    val username: String = "",
    val password: String = "",
    val isLoading: Boolean = false,
    val isLoggedIn: Boolean = false,
    val errorMessage: String? = null
)

2.2 UI层的协同与差异化

• Compose Multiplatform：声明式UI的跨平台梦想
• Web前端集成：将KMP模块作为NPM包发布与使用
• 平台特定UI能力的桥接与封装模式

第三部分：迈向服务端与云原生

3.1 KMP在服务端的应用场景

• 使用Ktor构建共享API逻辑的后端服务
• 序列化与反序列化：kotlinx.serialization的全栈一致性
• 身份认证与授权逻辑的跨平台复用

示例：使用Ktor共享API逻辑

// commonMain/kotlin/com/example/shared/api/UserApi.kt
import io.ktor.client.*
import io.ktor.client.call.*
import io.ktor.client.request.*
import io.ktor.http.*
import kotlinx.serialization.Serializable

/**
 * 用户API服务 - 跨平台共享的网络请求层
 * 使用Ktor Client实现，可在Android、iOS、Web、服务端复用
 */
class UserApi(private val client: HttpClient) {
    
    /**
     * 获取用户列表
     * @return 用户列表，失败时抛出异常
     */
    suspend fun getUsers(): List<UserDto> {
        return client.get("https://api.example.com/users") {
            contentType(ContentType.Application.Json)
        }.body()
    }
    
    /**
     * 创建新用户
     * @param user 用户数据
     * @return 创建的用户信息
     */
    suspend fun createUser(user: CreateUserRequest): UserDto {
        return client.post("https://api.example.com/users") {
            contentType(ContentType.Application.Json)
            setBody(user)
        }.body()
    }
    
    /**
     * 更新用户信息
     * @param userId 用户ID
     * @param user 更新数据
     * @return 更新后的用户信息
     */
    suspend fun updateUser(userId: String, user: UpdateUserRequest): UserDto {
        return client.put("https://api.example.com/users/$userId") {
            contentType(ContentType.Application.Json)
            setBody(user)
        }.body()
    }
    
    /**
     * 删除用户
     * @param userId 用户ID
     */
    suspend fun deleteUser(userId: String) {
        client.delete("https://api.example.com/users/$userId")
    }
}

// 数据类定义 - 使用kotlinx.serialization支持多平台序列化

@Serializable
data class UserDto(
    val id: String,
    val name: String,
    val email: String,
    val createdAt: String,
    val updatedAt: String
)

@Serializable
data class CreateUserRequest(
    val name: String,
    val email: String,
    val password: String
)

@Serializable  
data class UpdateUserRequest(
    val name: String? = null,
    val email: String? = null
)

// 在服务端（jvmMain）和客户端（commonMain）共享的API配置
// build.gradle.kts 配置示例：
// commonMain {
//     dependencies {
//         implementation("io.ktor:ktor-client-core:$ktor_version")
//         implementation("io.ktor:ktor-client-content-negotiation:$ktor_version")
//         implementation("io.ktor:ktor-serialization-kotlinx-json:$ktor_version")
//     }
// }

3.2 云原生环境下的KMP

• 容器化部署：将KMP服务打包为Docker镜像
• 无服务器架构（Serverless）中的KMP函数
• 与云服务（AWS, GCP, Azure）的SDK集成策略

第四部分：AI Agent时代的KMP全栈开发

4.1 AI Agent架构与KMP的契合点

• Agent核心逻辑（规划、工具调用、记忆）作为共享模块
• 多模态交互：在Android、Web、服务端统一处理语音、图像、文本
• 流式响应与实时通信的跨平台实现

4.2 构建跨平台的AI能力中间层

• 统一封装主流AI服务API（OpenAI, Anthropic, 本地模型）
• 工具调用（Function Calling）的声明式定义与多端执行
• Agent状态与记忆的持久化同步策略

4.3 实战：开发一个跨平台旅行规划AI Agent

• 需求分析：在手机、网页、智能终端提供一致体验
• 架构设计：共享核心Agent逻辑，差异化交互界面
• 关键实现：工具集成、上下文管理、流式响应

第五部分：挑战、优化与未来展望

5.1 当前KMP全栈开发的挑战

• 生态系统成熟度与第三方库支持
• 调试与性能 profiling 的多平台复杂性
• 团队技能栈的转型与学习曲线

5.2 性能优化与最佳实践

• 共享代码的包体积优化（Tree Shaking, 代码分割）
• 冷启动与运行时性能的多端调优
• 内存管理与非阻塞编程实践

5.3 技术趋势与未来演进

• Compose Multiplatform的成熟与3D/AR支持
• KMP与WebAssembly（WASM）的融合前景
• 在边缘计算与物联网（IoT）场景下的KMP应用

结语

• 总结KMP作为全栈开发核心技术的优势与价值
• 对开发者与团队的实践建议：如何开始、如何演进
• 展望：用KMP构建下一代智能、无缝的多端应用