Browse Source

docs: Add detailed registry modification documentation to README files

- Added comprehensive explanation of MachineGuid registry modification in both English and Chinese README files
- Included safety measures, potential impacts, and recovery steps for registry changes
- Updated Windows PowerShell script to provide additional registry modification information
- Enhanced user awareness about system-level modifications and their implications
pull/208/head v0.0.59
煎饼果子卷鲨鱼辣椒 4 months ago
parent
commit
719b418b7f
  1. 34
      README.md
  2. 34
      README_CN.md
  3. 2
      scripts/run/cursor_win_id_modifier.ps1

34
README.md

@ -375,6 +375,40 @@ macOS/Linux users can try to locate similar `cursor-updater` directory in their
- ✅ Error handling and recovery - ✅ Error handling and recovery
</details> </details>
<details>
<summary><b>Registry Modification Notice</b></summary>
> ⚠️ **Important: This tool modifies the Windows Registry**
#### Modified Registry
- Path: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography`
- Key: `MachineGuid`
#### Potential Impact
Modifying this registry key may affect:
- Windows system's unique device identification
- Device recognition and authorization status of certain software
- System features based on hardware identification
#### Safety Measures
1. Automatic Backup
- Original value is automatically backed up before modification
- Backup location: `%APPDATA%\Cursor\User\globalStorage\backups`
- Backup file format: `MachineGuid.backup_YYYYMMDD_HHMMSS`
2. Manual Recovery Steps
- Open Registry Editor (regedit)
- Navigate to: `Computer\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography`
- Right-click on `MachineGuid`
- Select "Modify"
- Paste the value from backup file
#### Important Notes
- Verify backup file existence before modification
- Use backup file to restore original value if needed
- Administrator privileges required for registry modification
</details>
--- ---
### 📚 Recommended Reading ### 📚 Recommended Reading

34
README_CN.md

@ -304,6 +304,40 @@ winget install --id Microsoft.PowerShell --source winget
### 🔧 技术细节 ### 🔧 技术细节
<details>
<summary><b>注册表修改说明</b></summary>
> ⚠️ **重要提示:本工具会修改系统注册表**
#### 修改内容
- 路径:`计算机\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography`
- 项目:`MachineGuid`
#### 潜在影响
修改此注册表项可能会影响:
- Windows 系统对设备的唯一标识
- 某些软件的设备识别和授权状态
- 基于硬件标识的系统功能
#### 安全措施
1. 自动备份
- 每次修改前会自动备份原始值
- 备份保存在:`%APPDATA%\Cursor\User\globalStorage\backups`
- 备份文件格式:`MachineGuid.backup_YYYYMMDD_HHMMSS`
2. 手动恢复方法
- 打开注册表编辑器(regedit)
- 定位到:`计算机\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography`
- 右键点击 `MachineGuid`
- 选择"修改"
- 粘贴备份文件中的值
#### 注意事项
- 建议在修改前先确认备份文件的存在
- 如遇问题可通过备份文件恢复原始值
- 必须以管理员权限运行才能修改注册表
</details>
<details> <details>
<summary><b>配置文件</b></summary> <summary><b>配置文件</b></summary>

2
scripts/run/cursor_win_id_modifier.ps1

@ -203,6 +203,8 @@ function Update-MachineGuid {
Set-ItemProperty -Path $registryPath -Name "MachineGuid" -Value $newMachineGuid Set-ItemProperty -Path $registryPath -Name "MachineGuid" -Value $newMachineGuid
Write-Host "$GREEN[信息]$NC 已更新系统 MachineGuid: $newMachineGuid" Write-Host "$GREEN[信息]$NC 已更新系统 MachineGuid: $newMachineGuid"
Write-Host "$GREEN[信息]$NC 原始值已备份至: $backupFile" Write-Host "$GREEN[信息]$NC 原始值已备份至: $backupFile"
Write-Host "$GREEN[信息]$NC 注册表路径: 计算机\HKEY_LOCAL_MACHINE\SOFTWARE\Microsoft\Cryptography"
Write-Host "$GREEN[信息]$NC 注册表项名: MachineGuid"
} }
catch { catch {
Write-Host "$RED[错误]$NC 更新系统 MachineGuid 失败: $_" Write-Host "$RED[错误]$NC 更新系统 MachineGuid 失败: $_"

Loading…
Cancel
Save