SuperAPI AI 工具集

analysis-api-extend-ka-resolver

编程与开发

查看项目

更新于 10-16 06:18

技能介绍

用途:为指定的 Kt* PSI 类型在 KaResolver 中补充解析支持,即新增 resolveSymbol(),并在需要时新增 resolveCall()。参数为 PSI 类型名,例如 KtDestructuringDeclarationEntry。

主要能力与流程:

  1. 收集信息:在 compiler/psi/ 查找该 PSI 类型源文件,确认类层次及是否已实现 KtResolvable 或 KtResolvableCall;检查 KaResolver.kt 是否已有对应方法(有则停止);查找 analysis/analysis-api/testData/components/resolver/ 下相关测试数据;阅读 analysis/AGENTS.md。
  2. 询问用户:通过 AskUserQuestion 一次性确认解析种类(KtResolvable 仅符号解析,或 KtResolvableCall 同时支持符号与调用解析)、resolveSymbol() 返回类型(如 KaConstructorSymbol、KaFunctionSymbol、KaNamedFunctionSymbol、KaCallableSymbol 等)、以及 resolveCall() 返回类型(如 KaFunctionCall<KaConstructorSymbol>、KaDelegatedConstructorCall、KaAnnotationCall 等)。
  3. 执行修改:在 PSI 源文件添加接口实现与 import;在 KaResolver.kt 添加接口方法与 context(session: KaSession) 桥接函数;在 KaBaseResolver.kt 添加 override,按返回类型是否含通配符选择 resolveCallSafe() 或 resolveSingleCallSafe(),并在 canBeResolvedAsCall 增加分支;调查 KaFirResolver.kt 中 getOrBuildFir 返回的 FIR 元素类型是否已在 performSymbolResolution()/performCallResolution() 的 when 中处理,必要时按既有模式补充;运行 ./gradlew :compiler:psi:psi-api:updateKotlinAbi 更新 PSI API dump。
  4. 验证:对修改文件运行 get_file_problems;用 ./gradlew updateTestData 更新测试数据,检查 .symbol.txt、.references.txt、.call.txt 是否符合预期;可用 checkTestData 针对子目录或单文件排查。
  5. 提交:提交信息为 [Analysis API] resolver: support new API for <KtPsiType>,并附 ^KT-66039,提交前阅读 docs/code_authoring_and_core_review.md。

适用场景:在 Kotlin 编译器与 Analysis API 代码库中扩展解析器对某类 PSI 元素的支持。

限制:需在 Kotlin 仓库环境中操作,依赖 Gradle 任务与既有代码模式;具体返回类型与解析种类需用户确认;资料未提供收费、平台或效果信息。