🚀 QuickAI - 双编辑器无缝跳转插件

🌟 厌倦了在 IntelliJ IDEA 和 AI 辅助编辑器（如 Cursor、Claude Dev、GitHub Copilot 等）之间频繁切换，却要手动查找代码位置？QuickAI 让您一键跳转到精确位置，无缝衔接工作流程！

✨ 核心功能

QuickAI 是一套强大的编辑器跳转插件，包含两个组件：

🔄 双向跳转能力

• IDEA → VS Code: 从 IntelliJ IDEA 跳转到 VS Code/Cursor/Kiro 等 AI 编辑器
• VS Code → IDEA: 从 VS Code 跳转到 IntelliJ IDEA/PyCharm/WebStorm 等 JetBrains IDE
• 精准定位: 保持文件路径和行号完全一致

🌍 跨平台支持

• Windows: 完美支持 Windows 10/11
• macOS: 支持 macOS 10.15+
• Linux: 支持主流 Linux 发行版

📦 插件组件

1. QuickAI for IntelliJ IDEA

版本: v1.3.5
作者: YaYa
功能: 从 IDEA 跳转到外部 AI 编辑器

2. QuickAI for VS Code

版本: v1.0.0
作者: hqzqaq
功能: 从 VS Code 跳转到 JetBrains IDE

🎯 功能特性

🚀 核心优势

• 零配置丢失升级: v1.3.5 版本确保升级时配置自动保留
• 智能缓存系统: 多级缓存机制，跳转速度提升 40-60%
• 完全可定制: 支持自定义快捷键和编辑器配置
• 无窗口闪烁: 优化的命令执行，避免终端窗口干扰

⚡ 性能优化

• 150ms 防抖机制: 避免频繁触发，响应更灵敏
• 异步执行: 不阻塞主线程，保持编辑器流畅
• DIRECT 调用模式: 跳过 CMD 包装，直接调用编辑器
• 多级缓存: 设置缓存(1秒)、项目路径缓存、编辑器状态缓存(5秒)

🎨 界面设计

• SVG 矢量图标: 支持高分辨率显示，主题自动适配
• 纯中文界面: 专为中文用户优化体验
• 简洁美观: 重新设计的用户界面和配置页面

📋 支持的编辑器

🔄 双向跳转支持

来源编辑器	目标编辑器
IntelliJ IDEA	VS Code、Cursor、Kiro、Qoder、Trae（vs code及其衍生品）
VS Code	IntelliJ IDEA、PyCharm、WebStorm、PhpStorm 等 （Jetrbrains全家桶）

🛠️ 具体支持列表

• JetBrains 系列: IDEA、PyCharm、WebStorm、PhpStorm、RubyMine、CLion
• AI 编辑器: VS Code、Cursor、Kiro、Qoder
• 其他编辑器: 任何支持命令行参数的编辑器

🚀 快速开始

1. 安装插件

📦 IntelliJ IDEA 插件安装

# 方法一：在 IDEA 中安装
Settings/Preferences → Plugins → search quickai

📦 VS Code 插件安装

# 方法一：通过 VS Code 界面安装
# 扩展管理 → 搜索 quickai 并安装

2. 配置编辑器路径

⚙️ IntelliJ IDEA 配置

1. 打开 Settings/Preferences → Tools → QuickAI Settings
2. 点击 “Add Editor” 添加 VS Code/Cursor 等编辑器
3. 配置路径示例：
   • Windows: C:\Users\<用户名>\AppData\Local\Programs\Microsoft VS Code\Code.exe
   • macOS: /Applications/Visual Studio Code.app/Contents/MacOS/Electron
     

⚙️ VS Code 配置

1. 打开 VS Code
2. 使用快捷键 ctrl + shift + p 搜索 quickai 管理外部编辑器
3. 进入外部编辑器管理界面，配置外部编辑器的路径，如 idea 等
   

3. 设置快捷键

⌨️ 默认快捷键

• IntelliJ IDEA 插件: Ctrl+Shift+Alt + 鼠标点击
• VS Code 插件:
  • Windows/Linux: Ctrl+Shift+O 或 Ctrl+Alt+O
  • macOS: Cmd+Shift+O 或 Cmd+Alt+O

🛠️ 使用教程

🔄 基本跳转操作

从 IDEA 跳转到 VS Code

1. 在 IntelliJ IDEA 中打开代码文件
2. 将光标定位到目标行
3. 按住 Ctrl+Shift+Alt (默认)
4. 点击代码行
5. VS Code 自动打开并跳转到相同位置

从 VS Code 跳转到 IDEA

1. 在 VS Code 中打开代码文件
2. 将光标定位到目标行
3. 按下 Ctrl+Shift+O (Windows/Linux) 或 Cmd+Shift+O (macOS)
4. IntelliJ IDEA 自动打开并跳转到相同位置

🏗️ 高级功能

多项目窗口管理 (IDEA 插件)

• 每个项目独立窗口: 不同 IDEA 项目跳转到不同 AI 工具窗口
• 共享同一个窗口: 所有项目共用一个 AI 工具窗口

多编辑器配置

两个插件都支持配置多个外部编辑器，一键切换使用：

// VS Code 配置示例
{
  "quickai.editors": [
    {
      "name": "IntelliJ IDEA",
      "path": "C:\\Program Files\\JetBrains\\IntelliJ IDEA\\bin\\idea64.exe",
      "isDefault": true
    },
    {
      "name": "PyCharm", 
      "path": "C:\\Program Files\\JetBrains\\PyCharm\\bin\\pycharm64.exe",
      "isDefault": false
    }
  ]
}

🔍 常见问题解答

❓ 安装和配置问题

Q: 插件安装后不生效怎么办？

A:

1. 重启编辑器（IDEA 或 VS Code）
2. 检查插件是否已启用
3. 查看状态栏是否有 QuickAI 图标显示
4. 检查编辑器路径配置是否正确

Q: 如何找到编辑器的正确路径？

A:

• Windows JetBrains IDE: C:\Program Files\JetBrains\[IDE名称]\bin\
• macOS JetBrains IDE: /Applications/[IDE名称].app/Contents/MacOS/
• VS Code:
  • Windows: C:\Users\<用户名>\AppData\Local\Programs\Microsoft VS Code\Code.exe
  • macOS: /Applications/Visual Studio Code.app/Contents/MacOS/Electron

Q: 快捷键不响应怎么办？

A:

1. 检查快捷键冲突
2. 确保光标在编辑器中
3. 查看开发者工具中的日志输出

❓ 功能使用问题

Q: 外部编辑器无法启动怎么办？

A:

1. 验证路径正确且文件存在
2. 确保有执行外部程序的权限
3. 在终端中手动执行命令测试
4. 检查防火墙或安全软件阻止

Q: 跳转到错误位置怎么办？

A:

1. 检查项目根目录配置
2. 确保文件路径正确
3. 检查文件名是否包含特殊字符

❓ 性能问题

Q: 插件响应过慢怎么办？

A:

1. 调整防抖时间到 200-300ms
2. 确保缓存机制已启用
3. 检查系统资源使用情况

📊 技术架构

🏗️ 核心工作原理

IntelliJ IDEA 插件工作流程

1. 插件启动 → 注册鼠标监听器
2. 用户点击 → 捕获鼠标事件
3. 按键检查 → 验证修饰键组合
4. 信息收集 → 获取文件路径和行号
5. 命令构建 → 根据平台构建执行命令
6. 外部调用 → 启动目标编辑器

VS Code 插件工作流程

1. 插件启动 → 注册快捷键
2. 用户触发 → 捕获快捷键事件
3. 按键检查 → 验证修饰键组合
4. 信息收集 → 获取文件路径和行号
5. 命令构建 → 根据平台构建执行命令
6. 外部调用 → 启动目标编辑器

🌐 跨平台实现

Windows 系统

cmd.exe /c "<editor>" --line <lineNum> "<file>"

macOS/Linux 系统

nohup '<editor>' --line <lineNum> "<file>" > /dev/null 2>&1 &

🛡️ 配置保护机制 (v1.3.5)

💾 零丢失升级

• 自动配置保持: 插件升级时自动保留用户配置
• 智能备份系统: 升级前自动创建配置备份
• 一键恢复: 支持从备份快速恢复配置

🔄 版本迁移

• 智能识别: 自动识别旧版本配置格式
• 自动转换: 将旧配置迁移到新版本格式
• 完整性验证: 配置加载时自动检查数据完整性

📝 详细日志

• 完整操作日志: 便于问题诊断和故障恢复
• 安全存储: 采用稳定存储策略，确保配置安全

🎨 界面优化

SVG 矢量图标系统

• 矢量格式: SVG 支持任意分辨率无损缩放
• 主题适配: 自动根据编辑器主题切换图标
• 高DPI支持: 完美支持高分辨率显示器
• 性能优化: 快速加载，减小插件体积

纯中文界面

• 中文优化: 移除所有英文描述
• 简洁设计: 重新设计插件说明界面
• 用户体验: 专为中文用户优化

📈 版本历史

v1.3.5 (2025-08-28) - 配置保护与平滑升级

• 🛡️ 零丢失升级机制，自动保持用户配置
• 💾 智能备份系统，支持一键恢复
• 🔄 配置版本迁移机制
• 🔍 配置完整性验证
• 📄 详细的配置操作日志

v1.2.3 (2025-08-28) - SVG图标与界面优化

• 🎨 采用现代化SVG矢量图标
• 🌙 完善的亮色/暗色主题适配
• 📱 高分辨率显示器完美支持
• 🔧 纯中文化用户界面

v1.1.0 (2025-08-26) - 多编辑器支持与性能优化

• ✨ 多编辑器配置支持
• ⚡ 多级缓存机制，速度提升40-60%
• ⚡ 150ms防抖机制
• ⚡ 异步执行，消除UI阻塞

v1.0.0 (2025-08-20) - 初始版本

• ✨ 基本的编辑器跳转功能
• ✨ 可配置的快捷键
• 🔧 跨平台支持

🤝 技术支持

📞 联系信息

• IntelliJ IDEA 插件作者: YaYa
• VS Code 插件作者: hqzqaq
• 问题反馈: 通过 GitHub Issues 提交

🎉 开发状态

✅ 已实现功能

• 🌍 跨平台支持（Windows、macOS、Linux）
• 🔄 双向编辑器跳转
• ⚡ 高性能缓存机制
• 🛡️ 配置保护系统
• 🎨 现代化界面设计
• 📊 详细的性能监控

🚀 技术特性

• 高性能: 多级缓存、防抖处理、异步执行
• 类型安全: 完整的类型定义
• 代码规范: 遵循开发规范，包含详细注释
• 模块化: 职责分离的模块化架构
• 跨平台: 完美支持三大主流操作系统

🙏 致谢

感谢所有为这个项目做出贡献的开发者和用户：

• IntelliJ Platform 团队: 优秀的开发框架和文档
• 社区贡献者: 功能优化和错误修复
• 设计师: SVG图标设计和界面优化
• 测试用户: 在不同平台测试稳定性和兼容性

---

✨ 享受无缝的双编辑器开发体验！