SuperAPI AI 工具集

cursor-upgrade-migration

编程与开发

查看项目

更新于 10-16 09:08

技能介绍

用途

Cursor Upgrade & Migration 用于升级 Cursor 版本、从 VS Code 迁移配置,以及在不同机器之间转移设置。它通过分阶段、可回滚的发布流程,保留策略、扩展、规则、工作区信任和用户恢复能力。

主要能力

  • 版本升级:支持自动更新(推荐)和手动更新(macOS Homebrew、Linux AppImage 等)。
  • 升级前检查:记录当前版本、查看发布说明、备份设置、导出扩展列表、提交未保存工作、记录自定义快捷键。
  • 升级后验证:确认 Cursor 正常启动、登录状态、AI 功能、Tab 补全、扩展加载、自定义快捷键、项目规则加载和索引状态。
  • VS Code 迁移:首次启动时自动导入设置、快捷键、用户代码片段、颜色主题和兼容扩展;也支持手动复制配置文件和重新安装扩展。
  • 扩展市场差异说明:Cursor 使用 Open VSX Registry,部分 Microsoft 独占扩展不可用,可手动安装 .vsix。
  • 跨机器迁移:导出扩展列表和设置文件,在新机器上恢复。
  • 破坏性变更处理:如 .cursorrules 迁移到 .cursor/rules/,以及 Cursor 2.0 的变更说明。
  • 企业考虑:托管部署、版本固定、设置模板和回滚。

使用方式

技能提供分步指令和检查清单。升级时先备份设置和扩展列表,再执行更新,最后逐项验证。迁移时利用首次启动的自动导入,或手动复制 settings.json、keybindings.json 和 snippets,并通过命令行重新安装扩展。跨机器迁移需导出扩展列表和设置文件,在新机器上恢复并检查平台特定设置。

适用场景

  • 需要安全升级 Cursor 版本的个人开发者或团队。
  • 从 VS Code 切换到 Cursor 并希望保留配置的用户。
  • 在多台机器之间同步 Cursor 配置的开发者。
  • 企业环境中需要受控部署和回滚策略的管理员。

限制

  • 部分 Microsoft 独占扩展(如 GitHub Copilot、Live Share、Remote-SSH、C# Dev Kit)在 Cursor 中不可用。
  • 扩展登录状态、数据库和工作区信任设置不会自动迁移。
  • 任务配置(.vscode/tasks.json)会复制但可能需要调整。
  • 平台特定设置(如终端默认配置文件、字体、文件监视排除路径)在跨机器迁移后需要手动检查。
  • 具体版本兼容性和破坏性变更需查阅 changelog.cursor.sh。