SuperAPI AI 工具集

jetbrains-sandbox

编程与开发

查看项目

更新于 11-02 03:25

技能介绍

JetBrains Sandbox 是一个在 Linux 云沙箱中安装并操作 IntelliJ 的技能,旨在让智能体获得一个运行中的 IntelliJ 实例及其控制手段。

用途 该技能为智能体提供 IntelliJ IDEA、MCP Steroid 和一个基于 TigerVNC、Openbox、noVNC 的最小浏览器桌面。它不绑定某个插件的测试,也不规定固定的 IDE 工作流。HTTP 传输通过沙箱 HTTPS 代理工作,该代理会破坏 WebSocket 升级。

安装与运行环境 已测试环境为 Debian 13、Linux x86-64,并需要 Bun。建议预留约 8 GB 内存和 10 GB 空闲磁盘,用于 IDE、归档文件、插件和缓存。安装需要 root 权限以使用 apt 并创建 IDE 账户;若依赖已预装,非 root 账户可使用 --skip-deps 并以自身身份运行。不会创建公开隧道或查看器密码,默认绑定回环地址。仅在用户已认证的沙箱端口转发之后使用 --host 0.0.0.0。仅绑定 127.0.0.1 可能使平台报告没有监听。即使查看器可从外部访问,原始 VNC 和 MCP 仍绑定回环地址。如果安全预览代理重写了 Host,需通过 --origin https://your-preview-host 传入其确切的浏览器侧源;不信任任意转发头。

固定组件与安装 默认组件为 IntelliJ IDEA 2026.1(含其捆绑 Java 运行时)和 MCP Steroid 0.102.0-r-c68d8f15d。可选 Kilo 插件为签名 7.1.12 版本,仅在 --with-kilo 时安装。下载会对照测试产物进行 SHA-256 校验,版本和哈希位于 script/setup.ts 中。默认不安装 Kilo 插件,也不构建仓库代码;除非提供 --project,否则打开空工作区且不添加示例文件。

从当前工作树根目录安装: bun .kilo/skills/jetbrains-sandbox/script/setup.ts install --host 0.0.0.0 冷安装应使用有界的 background_process.monitor 跟踪,因为下载和解压可能超过一次工具调用。随后用 background_process.start 启动前台监督进程: bun .kilo/skills/jetbrains-sandbox/script/setup.ts run 就绪模式可使用“Desktop ready”或端口 6080。不要使用 shell &、nohup 或未跟踪的守护进程。监督进程以非 root IDE 用户运行 VNC、Openbox 和 IntelliJ,剥离继承的智能体凭据,并在终止时停止其监督的进程。可通过沙箱安全转发打开 http://localhost:6080/。用户需自行完成首次运行协议和任务所需认证。

常用命令: bun .kilo/skills/jetbrains-sandbox/script/setup.ts status bun .kilo/skills/jetbrains-sandbox/script/setup.ts stop 安装选项示例: bun .kilo/skills/jetbrains-sandbox/script/setup.ts install
--dir /tmp/my-ide
--ide /existing/idea-2026.1
--project /path/to/writable/project
--host 0.0.0.0 --display 100 --port 6090 --vnc-port 5998 --mcp-port 6316
--skip-deps

控制方式 可按任务选择 MCP 与 IntelliJ API、桌面交互、IntelliJ 命令行启动器或内置 REST 服务器。MCP Steroid 默认监听 http://127.0.0.1:6315/mcp,可用以下命令初始化会话、调用真实工具并关闭会话: bun .kilo/skills/jetbrains-sandbox/script/setup.ts mcp steroid_list_projects bun .kilo/skills/jetbrains-sandbox/script/setup.ts mcp steroid_list_windows bun .kilo/skills/jetbrains-sandbox/script/setup.ts mcp tools/list bun .kilo/skills/jetbrains-sandbox/script/setup.ts mcp steroid_execute_code '{"project_name":"<routing-key>","task_id":"ide-test","reason":"Inspect the selected project","code":"println(project.name)"}' 使用项目发现返回的不透明 project_name,而非文件夹名。只读 PSI 访问需要读操作,UI 操作需要 EDT。截图命令为: bun .kilo/skills/jetbrains-sandbox/script/setup.ts screenshot --settings 可用 serve 仅提供生成的 PNG: bun .kilo/skills/jetbrains-sandbox/script/setup.ts serve --host 0.0.0.0 打开 http://localhost:6083/ 查看静态截图,而非实时桌面。

适用场景与限制 适用于需要真实 IntelliJ 桌面环境、IDE 配置查看、项目检查、代码编辑、调试或桌面自动化的智能体任务。不要在未获允许时接受 JetBrains 协议、启动试用、登录服务或自动关闭无关对话框。运行状态默认位于当前工作树被忽略的 .kilo-dev/jetbrains-sandbox/,切勿将 --dir 指向工作区本身。IDE 运行时不要覆盖插件 jar,应先停止。不要停止其他会话的 IDE 或更改用户工作区所有权。首次运行对话框、源码构建与网络限制、未测试的登录或模型流程需明确说明。未提供公开隧道或查看器密码。