用途:当需要在非标准运行环境(自定义原生渲染器、自定义传输层、自定义存储引擎)上构建 Kotlin Multiplatform 库,并希望其 Kotlin API 在使用手感上接近某个知名参考 API(如 Jetpack Compose、SwiftUI、Retrofit、Room)时,使用本技能。它关注的是 API 形态的移植,不涉及复制参考库源码,也不涉及依赖真正的参考库。
主要能力:
- 指导先阅读参考 API 当前公开文档或源码,列出拟模仿的具体类型、函数与注解,避免凭记忆仿写。
- 说明哪些形态可以用普通 Kotlin 语言特性忠实还原,例如可链式配置对象(以 then() 串接的密封接口)、槽位 lambda(content: Scope.() -> Unit)、作用域构建器、DSL 标记注解。
- 明确哪些行为无法在不写编译器插件的情况下模仿,例如重组与跳过、快照状态、CompositionLocal 的环境值传播;并建议用显式失效(如 requestRedraw()、重新调用 setContent)替代。
- 提供决策表,判断何时采用纯函数 DSL、何时才值得投入真实编译器插件(仅在细粒度重组是经过实测的性能需求时),以及何时应直接依赖真实参考库。
- 要求维护 MIRROR_MAP.md,逐条记录被模仿的原语、其参考来源和刻意偏离;并要求在 README 中明确声明“API 形态受 X 启发、与 X 编译器不兼容、与真实 X 代码无互操作”。
- 给出命名与合规约束:使用自己的 group id、包名与注解名(例如 @EngineUiDsl 而非 @Composable),不得复用参考库的包命名空间或商标名称。
- 附带针对修饰符链、作用域构建与 setContent 重建场景的测试写法示例,以及常见反模式清单。
使用方式:以 Kotlin Multiplatform 库项目形式搭建,在 commonMain 中定义自有的标记注解、密封的修饰符接口及 then() 组合、作用域类与入口函数;将构建出的场景图提交给自定义后端。状态变更由调用方负责,通过重新调用入口或更细粒度的失效方法触发重建。若后端为原生实现,可结合 JNI/cinterop 桥接与 expect/actual 平台接线。
适用场景:为自定义 Vulkan/Metal UI 等渲染后端设计 Compose 风格的声明式 DSL;为自定义场景图构建器设计槽位 lambda DSL;为自定义存储引擎设计 Room 风格的 DAO 接口形态;为自定义传输层设计 Retrofit 风格的声明式接口;在投入编译器插件前评估模仿边界。
限制:不覆盖真实编译器插件实现,不覆盖复制参考库源码,不覆盖快照状态系统的重造;不适用于已经依赖真实参考库、只需正常使用的项目(此类应改用基于真实 Compose Multiplatform 的设计系统技能)。参考 API 会随版本变化,模仿新版本形态前需重新核对当前公开文档。
分类判断:该技能的核心用途是指导在非标准运行时上编写 Kotlin Multiplatform 库代码、设计 DSL 与决定是否编写编译器插件,属于编程与开发范畴。