# cursor-reset

**Repository Path**: wanghuya/cursor-reset

## Basic Information

- **Project Name**: cursor-reset
- **Description**: Cursor 机器 ID 重置工具 (≥ 0.45.0)
本工具用于重置 Cursor IDE 的设备标识，支持 Windows、macOS 和 Linux 系统。
- **Primary Language**: Unknown
- **License**: MulanPSL-2.0
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2025-12-19
- **Last Updated**: 2025-12-19

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Cursor 机器 ID 重置工具 (≥ 0.45.0)

本工具用于重置 Cursor IDE 的设备标识，支持 Windows、macOS 和 Linux 系统。

---

## ⚠️ 免责声明

本项目仅供学习和研究使用，旨在研究 Cursor IDE 的设备标识机制。**强烈建议您购买 [Cursor](https://cursor.sh/) 的正版授权**以支持开发者。

使用本工具可能违反 Cursor 的使用条款。作者不对使用本工具导致的任何问题负责，包括但不限于：

- 软件授权失效
- 账号封禁
- 其他未知风险

如果您认可 Cursor 的价值，请支持正版，为软件开发者的工作付费。

---

## 使用方法

⚠️ 为避免新账号立即失效，请严格按照以下步骤操作：

### Windows

1. 在 Cursor IDE 中退出当前登录的账号
2. 完全关闭 Cursor IDE
3. 以管理员身份打开命令提示符或 PowerShell
4. 执行以下命令：

   ```batch
   powershell -ExecutionPolicy Bypass -Command "[Net.ServicePointManager]::SecurityProtocol = [Net.SecurityProtocolType]::Tls12; iwr -Uri 'https://raw.githubusercontent.com/hamflx/cursor-reset/main/reset.ps1' -UseBasicParsing | iex"
   ```

5. 重置完成后打开 Cursor IDE，使用新的账号登录（不要使用之前的账号）

如果脚本卡在"正在等待 Cursor 进程退出..."，可以执行以下命令强制结束所有 Cursor 进程：

```powershell
taskkill /f /im cursor.exe
```

### macOS

1. 在 Cursor IDE 中退出当前登录的账号
2. 完全关闭 Cursor IDE
3. 打开终端，执行以下命令：

   ```bash
   curl -fsSL https://raw.githubusercontent.com/hamflx/cursor-reset/main/reset.sh | bash
   ```

4. 启动 Cursor 并使用新账号登录（不要使用之前的账号）

如果需要恢复到原始状态，可以执行以下命令：

```bash
curl -fsSL https://raw.githubusercontent.com/hamflx/cursor-reset/main/reset.sh | bash -s -- --restore
```

如果脚本卡在"正在等待 Cursor 进程退出..."，可以在终端中执行以下命令强制结束 Cursor 进程：

```bash
pkill -9 Cursor
```

### Linux

1. 在 Cursor IDE 中退出当前登录的账号
2. 完全关闭 Cursor IDE
3. 打开终端，执行以下命令：

   ```bash
   curl -fsSL https://raw.githubusercontent.com/hamflx/cursor-reset/main/linux/bash.sh | bash -s -- --appimage /path/to/cursor.AppImage
   ```

   将 `/path/to/cursor.AppImage` 替换为你的 Cursor AppImage 文件路径。

4. 启动 Cursor 并使用新账号登录（不要使用之前的账号）

如果脚本卡在"正在等待 Cursor 进程退出..."，可以在终端中执行以下命令强制结束 Cursor 进程：

```bash
pkill -9 Cursor
```

---

## ⚠️ 重要注意事项

### Windows

脚本会修改系统注册表中的 `HKLM\SOFTWARE\Microsoft\Cryptography\MachineGuid`，这个值可能被其他软件用作设备标识。如果你购买了 Cursor 的正版授权或其他使用此注册表项作为设备标识的正版软件，修改后可能会导致这些软件的授权失效。

原始的 MachineGuid 会被自动备份到 `%USERPROFILE%\MachineGuid_Backups` 目录下，如果需要恢复原始 MachineGuid，可以从备份目录中找到对应的备份文件，然后通过注册表编辑器恢复该值。

---

## 系统要求

### Windows

- Windows 操作系统
- PowerShell
- 管理员权限
- Cursor IDE 0.45.x 版本（已在 0.45.8 版本测试通过）

### macOS

- macOS 10.13 或更高版本
- Cursor IDE 0.45.x 版本

### Linux

- Linux 操作系统
- Python 3
- Cursor IDE 0.45.x 版本（仅支持 AppImage 安装方式）
- appimagetool（用于重新打包 AppImage）
- 安装路径必须为 `/opt/cursor-bin/cursor-bin.AppImage`