SuperAPI AI 工具集

jetbrains-dev

编程与开发

查看项目

更新于 11-02 03:25

技能介绍

用途 该技能提供 packages/kilo-jetbrains/ 目录下 JetBrains 插件构建、运行与调试的完整参考。常驻限制与关键命令摘要见同目录 AGENTS.md,本技能覆盖完整工作流。

主要能力

一、CLI 集成与绑定管理 插件默认不打包 CLI 二进制。连接时后端会针对 packages/kilo-jetbrains/package.json 中固定的版本,下载对应的 GitHub Release 资产;后端资源中含 kilo.properties,提供 cli.version 与 cli.pinned,供分离模式 RPC 与运行时使用。打包发布构建会传入 -Pkilo.cli.bundled=true,同时保持 kilo.cli.pinned=true,该构建期标志会把所有固定版本的 CLI 发布资产放入 kilo-cli.zip,运行时检测到该资源后只解压当前平台而非下载。不要向 kilo.properties 添加 cli.bundled,也不要把 kilo.cli.pinned=false 用于公开打包发布。发布相关问题使用 /release-jetbrains 命令,它会在创建不可变 jetbrains/v* 标签前校验 CLI 固定版本。

插件有两个独立的 CLI 控制项: kilo.cli.pinned(位于 packages/kilo-jetbrains/gradle.properties)控制使用发布版 CLI 还是本地仓库 CLI;未固定(false)仅限开发使用,生产 Gradle 构建、script/build-version.sh 与发布脚本遇到 false 会硬失败,发布前须恢复为 true;固定版本(package.json 中的版本)控制插件下载哪个 GitHub CLI 发布并据此生成客户端,JetBrains 发布会锁定 origin/main 上已合并的值。一次性绑定、解绑、重新生成并清理残留 CLI 二进制与构建产物,可使用 jetbrains-cli-pin 技能:bun .kilo/skills/jetbrains-cli-pin/script/cli-pin.ts <pin|unpin|regen|clean>。CLI 发布后会自动尝试创建版本提升 PR 并打上 jetbrains-cli-pin-bump 标签;预发布 CLI 提升 PR 还会获得 pre-release 标签。

二、开发期存储隔离 在开发模式(runIdeSplitMode、runIdeBackend、runIdeFrontend 或 runIde)下,Gradle 属性 kilo.dev.storage.isolated=true 会使后端在启动 CLI 前将 XDG_DATA_HOME、XDG_CONFIG_HOME、XDG_STATE_HOME、XDG_CACHE_HOME 设为 <worktree>/.kilo-dev/{data,config,state,cache}。工作树根目录来自 JVM 系统属性 kilo.dev.worktree.root(由 Gradle 根据项目目录自动设置)。已签入的 Run IDE (Backend)、(Frontend)、(Split Mode) 运行配置默认开启隔离,可通过 -Pkilo.dev.storage.isolated=false 关闭。.kilo-dev/ 目录被 gitignore 并在首次运行时自动创建;实现位于 KiloBackendCliManager.buildEnv() / devStorageEnv(),测试为 KiloBackendCliManagerEnvTest。不要引入自定义 KILO_* 目录环境变量,CLI 核心已通过 xdg-basedir 遵循 XDG_*_HOME。

三、调试会话事件日志 在 packages/kilo-jetbrains/ 下运行 script/dev/part-update.sh client <session-id> 可按 part id 打印前端 message.part.delta 文本;backend 参数用于后端沙箱事件;需要保留输出时可追加 >> file.txt。JetBrains 开发运行中若要预览完整聊天负载,可传 -Pkilo.dev.log.chat.content=<mode>,mode 为 off(默认,无内容)、preview(清理并截断)、full(清理后完整内容);-Pkilo.dev.log.chat.preview.max=<n> 控制预览长度,范围 1 到 2000。

四、构建与验证 Marketplace 版本构建:使用 script/build-version.sh <version> 完成清理、构建、签名并校验插件 ZIP,仅在明确需要时加 --skip-verification。测试版本构建:仍需版本号,使用 script/build-version.sh <version> --skip-signing --skip-verification,无需签名密钥;仅在用户需要更快的增量测试构建时加 --skip-clean。类型检查:bun run typecheck 或 ./gradlew typecheck,会编译包括生成的 API 客户端在内的全部 Kotlin 源码;冷启动的固定版本构建会通过 generateOpenApiSpec 下载固定 CLI 发布,需要网络。本地仓库 CLI 模式(-Pkilo.cli.pinned=false)从本地源码生成规范并打包暂存的本地 CLI 二进制。为 JetBrains 开发构建本地仓库 CLI:./gradlew :backend:buildRepoCli,生成 packages/opencode/dist/@kilocode/cli-<os>-<arch>/bin/。完整构建:bun run build(执行 Gradle buildPlugin)或 ./gradlew buildPlugin;通过 Turbo:bun turbo build --filter=@kilocode/kilo-jetbrains。

五、运行模式与故障处理 分离模式:./gradlew --no-configuration-cache runIdeSplitMode 或已签入的 Run IDE (Split Mode) 配置,可在本地启动后端与前端,并通过 Split Mode 小部件模拟延迟。分离后端:./gradlew --no-configuration-cache runIdeBackend;若启动后很快退出,检查并杀掉上次后端运行留下的孤儿 Java 进程。IDE 解压损坏:若 runIdeBackend 或 runIdeSplitMode 在启动前因 coroutinesJavaAgentFile / Collection contains no element matching the predicate 失败,通常 .intellijPlatform/ides/ 下解压不完整;可用 ls .intellijPlatform/ides//lib/.jar | wc -l 检查(应为数百),删除 .intellijPlatform/ides、localPlatformArtifacts、layoutIndex 与 coroutines-javaagent.jar 后重跑。单体沙箱:./gradlew runIde,不构建或打包 CLI 二进制,后端在连接时下载固定发布。开发运行会关闭问卷与开启内部模式(idea.is.internal=true),后者启用延迟小部件与 Internal Actions 菜单。

六、停止沙箱运行 应从沙箱 IDE 内部退出(File → Exit),而非在 Gradle 运行标签页点 Stop:外部系统配置的 Stop 只通过 Gradle 工具 API 调用 CancellationTokenSource.cancel(),IDE 不会获知分叉 JVM 的 pid,也不会发送信号或强制终止。同一检出目录下沙箱 IDE 仍在运行时,不要启动第二个 runIde* 任务,因为所有 runIde* 任务共享同一沙箱容器,prepareSandbox 会重写运行中 IDE 的插件 jar,导致热重载失败并报 Failed to unload modified plugins: Kilo Code。

七、CLI/SDK 变更感知 JetBrains 运行时行为通常依赖 package.json 固定的已下载 CLI 发布;只有在 kilo.cli.pinned=false 的本地仓库 CLI 模式下才使用本地 packages/opencode/ 变更。如果 packages/kilo-jetbrains/ 之外有相关服务端/API 变更,应提醒用户可能需要新发布并固定的 CLI 版本以及重新生成的 SDK 产物。

限制 以上步骤依赖具体仓库结构、Gradle 属性与脚本;环境要求、签名密钥配置、发布流程的完整步骤与 Marketplace 上架细节本文档未全部给出,需参阅仓库内命令文档。