diff --git a/README_CN.md b/README_CN.md
index 6c9c558..39ba579 100644
--- a/README_CN.md
+++ b/README_CN.md
@@ -34,6 +34,7 @@
 </details>
 
 ⚠️ **Cursor通用解决方案**
+[📘 技术总结与伪代码指南：Cursor 清理环境 / 修改机器码 / 换号（完整流程与伪代码）](docs/CursorCleanup_MachineCode_AccountSwitch_Pseudocode_CN.md)
 > 1.  关闭Cursor、退出账号、官网Setting删除账号(刷新节点IP：日本、新加坡、 美国、香港，低延迟为主不一定需要但是有条件就换，Windows用户建议刷新DNS缓存：`ipconfig /flushdns`)
 > 前往Cursor官网删除当前账号
 > 步骤：用户头像->Setting-左下角Advanced▼->Delete Account
diff --git a/docs/CursorCleanup_MachineCode_AccountSwitch_Pseudocode_CN.md b/docs/CursorCleanup_MachineCode_AccountSwitch_Pseudocode_CN.md
new file mode 100644
index 0000000..720bcc0
--- /dev/null
+++ b/docs/CursorCleanup_MachineCode_AccountSwitch_Pseudocode_CN.md
@@ -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（含安装、目录清理）