RunVSAgent

英文 | 简体中文

在其他IDE平台上运行基于VSCode的编码代理

RunVSAgent是一款创新的跨平台开发工具，它使开发者能够在JetBrains IDE（IntelliJ IDEA、WebStorm、PyCharm等）或其他IDE平台上运行基于VSCode的编码代理和扩展。

📸 截图

🚀 核心功能

• VSCode代理兼容性：在JetBrains IDE中无缝运行基于VSCode的编码代理
• 跨IDE开发：在不同IDE平台上实现统一的代理体验

🤖 支持的代理

• Roo Code：先进的AI驱动编码助手，具备智能代码生成和重构能力
• Cline：完全自主的编码代理，直接集成到你的IDE中，可在你的许可下创建/编辑文件、执行命令、使用浏览器等。
• Kilo Code：开源VS Code AI代理

🔧 支持的IDE

JetBrains IDEs

RunVSAgent目前支持以下JetBrains IDE系列：

• IntelliJ IDEA（Ultimate版与社区版）
• WebStorm - JavaScript和TypeScript开发
• PyCharm（专业版与社区版）- Python开发
• PhpStorm - PHP开发
• RubyMine - Ruby开发
• CLion - C/C++开发
• GoLand - Go开发
• DataGrip - 数据库开发
• Rider - .NET开发
• Android Studio - Android开发

注意：为获得最佳兼容性，需使用JetBrains IDE 2023.1或更高版本。

🏗️ 架构

graph TB
    subgraph "JetBrains IDE"
        A[JetBrains插件<br/>Kotlin]
        B[UI集成]
        C[编辑器桥接]
    end
    
    subgraph "扩展宿主"
        D[Node.js运行时]
        E[VSCode API层]
        F[代理管理器]
    end
    
    subgraph "VSCode代理"
        G[编码代理]
    end
    
    A <-->|RPC通信| D
    B --> A
    C --> A
    
    E --> D
    F --> D
    
    G --> E

架构组件：

• JetBrains插件：用于JetBrains IDE集成的Kotlin基础IDE插件
• 扩展宿主：提供VSCode API兼容层的Node.js运行时环境
• RPC通信：高性能进程间通信，用于实时数据交换
• VSCode代理：为VSCode平台开发的各种编码代理和扩展

📦 安装

从JetBrains Marketplace下载（推荐）

推荐方法：我们建议首先从JetBrains Marketplace下载并安装插件，这是最便捷且安全的安装方式。

1. 在线安装：

   • 打开你的JetBrains IDE（IntelliJ IDEA、WebStorm、PyCharm等）
   • 进入设置/偏好设置 → 插件
   • 在Marketplace选项卡中搜索“RunVSAgent”
   • 点击安装按钮
   • 按提示重启IDE

2. 验证安装：重启后，你应该能在IDE的插件列表中看到RunVSAgent插件

从GitHub发布版下载

你可以从我们的GitHub发布页面下载预构建插件：

1. 下载插件：访问GitHub发布版，下载最新插件文件（.zip格式）

2. 在JetBrains IDE中安装：

   • 打开你的JetBrains IDE（IntelliJ IDEA、WebStorm、PyCharm等）
   • 进入设置/偏好设置 → 插件
   • 点击齿轮图标⚙️，选择从磁盘安装插件...
   • 选择下载的.zip文件
   • 按提示重启IDE

3. 验证安装：重启后，你应该能在IDE的插件列表中看到RunVSAgent插件

从源码构建

先决条件

• Node.js 18.0+
• JetBrains IDE 2023.1+
• Git
• JDK 17+

构建步骤

# 1. 克隆仓库
git clone https://github.com/your-org/RunVSAgent.git
cd RunVSAgent

# 2. 设置开发环境
./scripts/setup.sh

# 3. 构建项目
./scripts/build.sh

# 4. 安装插件
# 插件文件位于：jetbrains_plugin/build/distributions/
# 在IDE中：设置 → 插件 → 从磁盘安装插件

开发模式

# 启动扩展宿主的开发模式
cd extension_host
npm install
npm run dev

# 在开发模式下运行JetBrains插件
cd jetbrains_plugin
./gradlew runIde

👥 开发者信息

项目结构

RunVSAgent/
├── extension_host/          # Node.js扩展宿主
│   ├── src/                # TypeScript源码
│   │   ├── main.ts         # 主入口点
│   │   ├── extensionManager.ts  # 扩展生命周期管理
│   │   ├── rpcManager.ts   # RPC通信层
│   │   └── webViewManager.ts    # WebView支持
│   └── package.json        # Node.js依赖
├── jetbrains_plugin/       # JetBrains插件
│   ├── src/main/kotlin/    # Kotlin源码
│   │   └── com/sina/weibo/agent/
│   │       ├── core/       # 插件核心功能
│   │       ├── actions/    # IDE操作和命令
│   │       ├── editor/     # 编辑器集成
│   │       └── webview/    # WebView支持
│   └── build.gradle.kts    # Gradle构建配置
└── scripts/                # 构建和实用脚本

技术栈

• 扩展宿主：Node.js 18+，TypeScript 5.0+
• JetBrains插件：Kotlin 1.8+，IntelliJ Platform 2023.1+
• 通信：通过Unix域套接字/命名管道的RPC
• 构建工具：npm/pnpm，Gradle，Shell脚本

已知问题

如需查看已知问题和常见问题列表，请参阅已知问题。

贡献

1. 分支仓库
2. 创建功能分支：git checkout -b feature/your-feature
3. 做出修改并添加测试
4. 运行测试：./scripts/test.sh
5. 提交拉取请求

👥 贡献者

感谢所有帮助让该项目变得更好的贡献者：

🌟 核心贡献者

• Naituw - 项目架构师
• wayu002
• joker535
• andrewzq777
• debugmm
• Micro66
• qdaxb

🚀 贡献者

• junbaor
• aheizi
• Adam Hill

许可证

本项目采用Apache License 2.0许可。详情请参阅LICENSE。

维护者

• 组织: WeCode-AI 团队，微博公司
• 联系方式: GitHub Issues
• 官网: https://weibo.com

---

星标历史

由 WeCode-AI 团队用 ❤️ 制作

RunVSAgent 快速上手指南

环境准备

• 操作系统：Windows / macOS / Linux（64位）
• JetBrains IDE：2023.1 或更高版本（推荐 IntelliJ IDEA、PyCharm、WebStorm 等）
• Node.js：v18.0 或更高版本
  （推荐使用 nvm 管理版本：curl -o- https://raw.githubusercontent.com/nvm-sh/nvm/v0.39.7/install.sh | bash）
• JDK：17+（用于构建插件，如需从源码编译）

安装步骤

推荐方式：从 JetBrains 插件市场安装（一键安装）

1. 打开你的 JetBrains IDE（如 IntelliJ IDEA）
2. 进入 Settings/Preferences → Plugins
3. 切换到 Marketplace 标签页
4. 搜索 RunVSAgent
5. 点击 Install，安装完成后重启 IDE

✅ 国内用户若下载缓慢，可使用 JetBrains 插件镜像源 或通过代理加速。

备选方式：从 GitHub 发布页安装

1. 访问 GitHub Releases
2. 下载最新 .zip 插件包
3. 在 IDE 中：Settings/Preferences → Plugins → 点击 ⚙️ → Install Plugin from Disk...
4. 选择下载的 .zip 文件，重启 IDE

从源码构建（开发者适用）

# 1. 克隆仓库
git clone https://github.com/wecode-ai/RunVSAgent.git
cd RunVSAgent

# 2. 安装依赖并构建
./scripts/setup.sh
./scripts/build.sh

# 3. 安装插件
# 插件路径：jetbrains_plugin/build/distributions/RunVSAgent-*.zip
# 在 IDE 中通过 "Install Plugin from Disk" 安装

基本使用

1. 安装完成后，重启 IDE
2. 在任意编辑器中，右键点击代码区域，选择 “Run VSCode Agent”
3. 选择支持的 AI 编程助手（如 Roo Code 或 Cline）
4. 按提示授权后，AI 助手将在 IDE 侧边栏启动，支持代码生成、重构、文件编辑等操作

💡 首次使用时，系统会自动启动 Node.js 扩展主机，可能需要数秒初始化，请耐心等待。

运行成功后，你即可在 JetBrains IDE 中享受原生 VSCode AI 工具的体验。