cto-new[bot]
6 days ago
committed by
GitHub
GitHub
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
2 changed files with 324 additions and 0 deletions
@ -0,0 +1,323 @@ |
|||||
|
# Cursor 清理环境、修改机器码、换号 全面指南（含伪代码） |
||||
|
|
||||
|
本指南对项目中涉及 Cursor 的“清理环境”“修改机器码”“换号”等能力进行系统化总结，基于本仓库已有的 Go CLI 与跨平台脚本（Windows PowerShell、macOS/Linux Bash）的实现思路，整理为可复用的伪代码与操作流程，便于嵌入到任何自动化工具或二次开发中。 |
||||
|
|
||||
|
适用范围： |
||||
|
- 系统：Windows / macOS / Linux（x64/ARM） |
||||
|
- Cursor 版本：1.0.x 系列（以及多数相近结构版本） |
||||
|
- 能力： |
||||
|
- 自动关闭 Cursor 进程 |
||||
|
- 清理缓存与配置目录（可选分级：轻度清理/重置试用/彻底清理） |
||||
|
- 修改/刷新“机器码”（storage.json 内的 telemetry.* 字段） |
||||
|
- Windows 额外支持 MachineGuid 注册表备份与修改（脚本实现） |
||||
|
- 可选：通过内核 JS 注入方式劫持设备指纹读取路径 |
||||
|
- 账号切换（换号）流程与注意事项 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 一、关键路径与文件 |
||||
|
|
||||
|
- 配置文件（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 |
||||
|
|
||||
|
- 可能的本地目录（清理对象）： |
||||
|
- Windows: |
||||
|
- %APPDATA%\Cursor |
||||
|
- %USERPROFILE%\.cursor |
||||
|
- %LOCALAPPDATA%\cursor-updater（可删除并创建同名空文件阻止更新） |
||||
|
- macOS: |
||||
|
- ~/Library/Application Support/Cursor |
||||
|
- ~/.cursor |
||||
|
- 可选：~/Library/Caches/Cursor（若存在） |
||||
|
- Linux: |
||||
|
- ~/.config/Cursor |
||||
|
- ~/.cursor |
||||
|
|
||||
|
- 可选的应用资源（用于 JS 注入劫持，版本差异较大）： |
||||
|
- Windows: %LOCALAPPDATA%\Programs\Cursor\resources\app\out\... |
||||
|
- macOS: /Applications/Cursor.app/Contents/Resources/app/out/... |
||||
|
- Linux: 通常在安装目录下的 resources/app/out/... |
||||
|
|
||||
|
- storage.json 需关注的字段： |
||||
|
- telemetry.machineId |
||||
|
- telemetry.macMachineId |
||||
|
- telemetry.devDeviceId |
||||
|
- telemetry.sqmId |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 二、跨平台统一主流程伪代码 |
||||
|
|
||||
|
```pseudocode |
||||
|
function main(mode): |
||||
|
ensure_admin_or_sudo() |
||||
|
ui.clear_screen_and_logo() |
||||
|
kill_cursor_processes() # 多次重试 + 温和关闭 -> 强杀 |
||||
|
|
||||
|
if mode.includes("CLEAN"): |
||||
|
cleanup_environment(level=mode.cleanup_level) |
||||
|
repair_permissions_if_needed() # macOS 常见 |
||||
|
|
||||
|
config_path = resolve_storage_json_path() |
||||
|
old_config = try_read_json(config_path) or {} |
||||
|
|
||||
|
new_ids = { |
||||
|
machineId: gen_machine_id(), # "auth0|user_" + 64 hex |
||||
|
macMachineId: gen_hex(64), |
||||
|
devDeviceId: gen_uuid(), |
||||
|
sqmId: old_config.get('telemetry.sqmId') or gen_uuid_braced() |
||||
|
} |
||||
|
|
||||
|
backup_file = backup(config_path) # 写前备份 |
||||
|
merged = merge(old_config, new_ids, lastModified=now_rfc3339()) |
||||
|
atomic_write(config_path, json_indent(merged)) |
||||
|
|
||||
|
if mode.readonly: |
||||
|
chmod_readonly(config_path) |
||||
|
|
||||
|
show_success_and_restart_tips() |
||||
|
``` |
||||
|
|
||||
|
说明： |
||||
|
- gen_machine_id/devDeviceId 等可直接参考 pkg/idgen 的实现逻辑（本仓库已提供）。 |
||||
|
- atomic_write：先写 .tmp，再 chmod，最后 rename 保证落盘原子性（internal/config 中已有实现）。 |
||||
|
- Windows 可选：在清理/重置环节增加注册表 MachineGuid 备份与替换（仅脚本实现，不在 Go 中直接做）。 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 三、环境清理（分级可选） |
||||
|
|
||||
|
根据目标不同，可以设计三种强度： |
||||
|
- 轻度：仅关闭 Cursor + 刷新 storage.json 的 telemetry.* 字段 |
||||
|
- 中度：附加删除试用状态关联目录（“防掉试用Pro”目录清理） |
||||
|
- 重度：全面清理 Cursor 相关用户目录与缓存，必要时恢复权限并重新冷启动一次以再生成配置 |
||||
|
|
||||
|
### 3.1 Windows 清理伪代码 |
||||
|
```pseudocode |
||||
|
function cleanup_windows(level): |
||||
|
dirs = [ |
||||
|
"%APPDATA%/Cursor", |
||||
|
"%USERPROFILE%/.cursor" |
||||
|
] |
||||
|
if level == "HEAVY": |
||||
|
dirs += [ |
||||
|
"%LOCALAPPDATA%/cursor-updater" # 删除后可创建同名空文件阻止自动更新 |
||||
|
] |
||||
|
|
||||
|
for d in dirs: |
||||
|
if exists(d): rm -rf d |
||||
|
|
||||
|
if level == "HEAVY": |
||||
|
# 可选：阻止自动更新 |
||||
|
ensure_file("%LOCALAPPDATA%/cursor-updater") |
||||
|
|
||||
|
# 可选：刷新 DNS（网络相关问题） |
||||
|
run("ipconfig /flushdns") |
||||
|
``` |
||||
|
|
||||
|
### 3.2 macOS 清理与权限修复伪代码 |
||||
|
```pseudocode |
||||
|
function cleanup_macos(level): |
||||
|
dirs = [ |
||||
|
"~/Library/Application Support/Cursor", |
||||
|
"~/.cursor" |
||||
|
] |
||||
|
if level == "HEAVY": |
||||
|
dirs += ["~/Library/Caches/Cursor"] |
||||
|
|
||||
|
for d in dirs: |
||||
|
if exists(d): rm -rf d |
||||
|
|
||||
|
# 常见：权限修复（避免 EACCES 等问题） |
||||
|
sudo_chown_recursive("~/Library/Application Support/Cursor", whoami) |
||||
|
sudo_chown_recursive("~/.cursor", whoami) |
||||
|
chmod_u_plus_w_recursive("~/Library/Application Support/Cursor") |
||||
|
chmod_u_plus_w_recursive("~/.cursor/extensions") |
||||
|
|
||||
|
# 可选：重启 Cursor 一次并等待 15–30s 让 storage.json 生成，再立刻关闭 |
||||
|
# restart_cursor_and_wait_generate_config() |
||||
|
``` |
||||
|
|
||||
|
### 3.3 Linux 清理伪代码 |
||||
|
```pseudocode |
||||
|
function cleanup_linux(level): |
||||
|
dirs = [ |
||||
|
"~/.config/Cursor", |
||||
|
"~/.cursor" |
||||
|
] |
||||
|
|
||||
|
for d in dirs: |
||||
|
if exists(d): rm -rf d |
||||
|
|
||||
|
# 可选：重启 Cursor 并等待生成配置 |
||||
|
# restart_cursor_and_wait_generate_config() |
||||
|
``` |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 四、机器码（telemetry.*）刷新伪代码 |
||||
|
|
||||
|
```pseudocode |
||||
|
function refresh_machine_ids(config_path): |
||||
|
cfg = try_read_json(config_path) or {} |
||||
|
|
||||
|
new_machine_id = "auth0|user_" + random_hex(64) # 与脚本一致 |
||||
|
new_mac_machineId = random_hex(64) |
||||
|
new_device_id = uuid_v4() # xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx |
||||
|
new_sqm_id = cfg.get('telemetry.sqmId') or "{" + uuid_v4().upper() + "}" |
||||
|
|
||||
|
cfg['telemetry.machineId'] = new_machine_id |
||||
|
cfg['telemetry.macMachineId'] = new_mac_machineId |
||||
|
cfg['telemetry.devDeviceId'] = new_device_id |
||||
|
cfg['telemetry.sqmId'] = new_sqm_id |
||||
|
cfg['lastModified'] = now_rfc3339() |
||||
|
|
||||
|
atomic_write(config_path, json_indent(cfg)) |
||||
|
``` |
||||
|
|
||||
|
备注： |
||||
|
- 与本仓库 pkg/idgen 的实现保持一致即可（Go 版本已提供；Shell/PS 在脚本中也有实现）。 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 五、Windows 额外项：注册表 MachineGuid（可选，脚本实现） |
||||
|
|
||||
|
某些环境下，应用会读取 Windows 的 MachineGuid 进行设备识别。脚本可选提供如下流程： |
||||
|
|
||||
|
```pseudocode |
||||
|
function windows_modify_machine_guid(): |
||||
|
key = "HKLM\\SOFTWARE\\Microsoft\\Cryptography" |
||||
|
name = "MachineGuid" |
||||
|
|
||||
|
old = reg_query(key, name) |
||||
|
backup_path = "%APPDATA%/Cursor/User/globalStorage/backups/MachineGuid.backup_yyyyMMdd_HHmmss" |
||||
|
write_file(backup_path, old) |
||||
|
|
||||
|
new_guid = uuid_v4().lower() |
||||
|
reg_set(key, name, new_guid) |
||||
|
|
||||
|
# 回滚示例 |
||||
|
# reg_set(key, name, read_file(backup_path)) |
||||
|
``` |
||||
|
|
||||
|
注意： |
||||
|
- 需要管理员运行（UAC 提升）。 |
||||
|
- 修改 MachineGuid 可能影响依赖该标识的部分软件授权或系统行为，务必先备份。 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 六、可选策略：内核 JS 注入劫持（进阶） |
||||
|
|
||||
|
脚本中提供了通过修改应用 resources/app/out/*.js 的方式，注入代码来覆盖 crypto.randomUUID、设备 ID/MAC 读取函数，达到“临时劫持设备指纹”的目的。不同版本构建输出不同，需做兼容性判断与备份。 |
||||
|
|
||||
|
```pseudocode |
||||
|
function patch_cursor_js(resources_root): |
||||
|
targets = [ |
||||
|
"out/vs/workbench/api/node/extensionHostProcess.js", |
||||
|
"out/main.js", |
||||
|
"out/vs/code/node/cliProcessMain.js" |
||||
|
] |
||||
|
new_uuid = uuid_v4().lower() |
||||
|
machineId = "auth0|user_" + random_base62(32) |
||||
|
deviceId = uuid_v4().lower() |
||||
|
macId = random_hex(64) |
||||
|
|
||||
|
inject = """ |
||||
|
// injected by Cursor helper |
||||
|
import crypto from 'crypto'; |
||||
|
const orig = crypto.randomUUID; |
||||
|
crypto.randomUUID = () => '""" + new_uuid + """'; |
||||
|
globalThis.getMachineId = ()=>'""" + machineId + """'; |
||||
|
globalThis.getDeviceId = ()=>'""" + deviceId + """'; |
||||
|
globalThis.macMachineId = '""" + macId + """'; |
||||
|
console.log('Cursor device id hijacked'); |
||||
|
""" |
||||
|
|
||||
|
for file in targets: |
||||
|
path = resources_root + "/resources/app/" + file |
||||
|
if exists(path): |
||||
|
content = read_file(path) |
||||
|
if not contains(content, "randomUUID()"): # 仅作为示例判定 |
||||
|
backup(file) |
||||
|
write_file(path, inject + content) |
||||
|
``` |
||||
|
|
||||
|
注意： |
||||
|
- 该策略依赖构建产物形式，需注意版本差异并做好失败回滚。 |
||||
|
- 不推荐作为首选，仅在“telemetry.* 刷新 + 彻底清理”仍无法满足时再考虑。 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 七、换号（账号切换）建议流程 |
||||
|
|
||||
|
```pseudocode |
||||
|
function switch_account_flow(): |
||||
|
in_app_sign_out() # 应用内退出登录 |
||||
|
kill_cursor_processes() |
||||
|
cleanup_environment(level='MEDIUM') |
||||
|
refresh_machine_ids(resolve_storage_json_path()) |
||||
|
|
||||
|
# 网络侧建议（可选）：更换干净IP节点、刷新 DNS |
||||
|
if on_windows(): run("ipconfig /flushdns") |
||||
|
if on_macos(): run("sudo dscacheutil -flushcache; sudo killall -HUP mDNSResponder") |
||||
|
if on_linux(): run("resolvectl flush-caches || systemd-resolve --flush-caches || true") |
||||
|
|
||||
|
reopen_and_login_with_new_account() |
||||
|
``` |
||||
|
|
||||
|
要点： |
||||
|
- 最简可行路径：退出登录 + 刷新 telemetry.* + 重新登录。 |
||||
|
- 若仍被限制，采用“中度/重度清理 + 刷新 telemetry.* + （可选）Windows MachineGuid + 更换网络”。 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 八、自动化脚本与模块化建议 |
||||
|
|
||||
|
本仓库已提供： |
||||
|
- Go CLI：关闭进程、读取与原子写入 storage.json、生成各类 ID、国际化文案与 TUI 反馈 |
||||
|
- PowerShell（Windows）：进程关闭、环境清理、storage.json 修改、MachineGuid 备份与写入、JS 注入 |
||||
|
- Bash（macOS/Linux）：进程关闭、权限修复、环境清理、storage.json 修改与回滚、AppImage 安装（Linux） |
||||
|
|
||||
|
模块化拆分建议： |
||||
|
- process: 进程发现与关闭，带重试 |
||||
|
- config: storage.json 解析、字段合并、原子写入、备份 |
||||
|
- idgen: 生成 machineId/macMachineId/devDeviceId/sqmId |
||||
|
- platform: 按 OS 抽象路径与特权提升 |
||||
|
- patches: 可选 JS 注入、禁用自动更新的策略 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 九、常见问题与排查 |
||||
|
|
||||
|
- storage.json 不存在： |
||||
|
- 冷启动 Cursor 一次并等待 15–30s，关闭后再写入 |
||||
|
- EACCES/权限错误（macOS 常见）： |
||||
|
- 参考上文权限修复四连：chown 两处 + chmod 两处 |
||||
|
- 仍提示已达试用上限： |
||||
|
- 确认已重度清理 + 刷新 telemetry.* +（Windows）考虑 MachineGuid + 切换干净网络 |
||||
|
- Cursor 自动更新导致回退失效： |
||||
|
- Windows 删除 %LOCALAPPDATA%/cursor-updater 并创建同名空文件 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 十、安全与回滚 |
||||
|
|
||||
|
- 所有修改均建议先备份（storage.json、MachineGuid 等） |
||||
|
- 配置写入采用原子写，避免部分写入导致损坏 |
||||
|
- 提供回滚入口： |
||||
|
- storage.json：backups 目录保留历史 |
||||
|
- Windows MachineGuid：注册表备份文件可手动恢复 |
||||
|
|
||||
|
---------------------------------------- |
||||
|
|
||||
|
## 参考实现位置（本仓库） |
||||
|
- Go 主程序：cmd/cursor-id-modifier/main.go |
||||
|
- 配置读写：internal/config/config.go（原子写、路径解析） |
||||
|
- 进程管理：internal/process/manager.go |
||||
|
- ID 生成：pkg/idgen/generator.go |
||||
|
- 脚本：scripts/run/ |
||||
|
- Windows: cursor_win_id_modifier.ps1（含注册表、JS 注入、目录清理） |
||||
|
- macOS: cursor_mac_id_modifier.sh（含权限修复、目录清理、重启等待） |
||||
|
- Linux: cursor_linux_id_modifier.sh（含安装、目录清理） |
||||
Write
Preview
Loading…
Cancel
Save
Reference in new issue