Cursor Fake Machine

修改 Cursor 编辑器的机器 ID（Machine ID）的 VS Code 扩展。

功能特点

• 支持修改 Cursor 编辑器的机器 ID
• 自动备份原始配置文件
• 支持自定义存储路径和机器 ID
• 支持 Windows、macOS 和 Linux 系统
• 自动验证配置和文件权限

安装方式

从 VS Code 扩展商店安装

1. 打开 VS Code
2. 点击左侧扩展图标或按 Ctrl+Shift+X
3. 搜索 "Cursor Fake Machine"
4. 点击安装

手动安装

1. 下载 .vsix 文件
2. 在 VS Code 中点击左侧扩展图标
3. 点击扩展面板右上角的 ... 按钮
4. 选择 "从 VSIX 安装..."
5. 选择下载的 .vsix 文件

使用方式

1. 按 Ctrl + Shift + P（macOS 上为 Cmd + Shift + P）打开命令面板
2. 输入 fake 找到 "Fake Machine ID" 命令并执行
3. 执行后会显示：
   • 修改前的机器 ID
   • 修改后的机器 ID
   • 配置文件路径
   • 备份文件路径

配置项

• cursorFakeMachine.storagePath: 自定义 storage.json 文件路径

  • 默认为空，将自动查找系统默认路径
  • Windows: %APPDATA%/Cursor/User/globalStorage/storage.json
  • macOS: ~/Library/Application Support/Cursor/User/globalStorage/storage.json
  • Linux: ~/.config/Cursor/User/globalStorage/storage.json

• cursorFakeMachine.customMachineId: 自定义机器 ID

  • 默认为空，将随机生成新的 UUID
  • 如果指定，必须是有效的 UUID 格式
  • 例如：123e4567-e89b-12d3-a456-426614174000

备份功能

• 每次修改前会自动创建备份
• 备份文件保存在原配置文件所在目录的 backups 文件夹中
• 备份文件名格式：storage-{时间戳}.json

错误处理

• 自动验证配置文件路径是否存在和可写
• 验证自定义机器 ID 格式
• 在出错时提供详细的错误信息
• 对于路径相关错误，提供快速打开设置的选项

开发指南

环境准备

1. 安装 Node.js (推荐 v16 或更高版本)
2. 克隆仓库：

   git clone https://github.com/hopesy/cursor-fake-machine.git
   cd cursor-fake-machine
   

3. 安装依赖：

   npm install
   

本地测试

1. 在 VS Code 中打开项目
2. 按 F5 启动调试
3. 将打开新的 VS Code 窗口（扩展开发主机）
4. 在新窗口中测试扩展功能

打包发布

1. 安装打包工具：

   npm install -g @vscode/vsce
   

2. 打包扩展：

   vsce package
   

3. 生成的 .vsix 文件可用于分发或提交到 VS Code Marketplace

注意事项

1. 修改机器 ID 后需要重启 Cursor 编辑器才能生效
2. 请确保在修改前备份重要数据
3. 如果指定自定义路径，请确保路径正确且有写入权限

问题反馈

如果您在使用过程中遇到任何问题，或有任何建议，请：

1. 在 GitHub 仓库提交 Issue
2. 描述问题发生的环境和步骤
3. 附上相关的错误信息和日志

许可证

MIT License