# WindSurf重置机器码工具

**Repository Path**: yangxiaoyude/windsurf

## Basic Information

- **Project Name**: WindSurf重置机器码工具
- **Description**: windsurf重置工具支持windows 以及 linux 
- **Primary Language**: Unknown
- **License**: Not specified
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 2
- **Forks**: 0
- **Created**: 2025-11-20
- **Last Updated**: 2025-12-18

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

## Windsurf 机器码修改工具使用说明

本仓库包含两个脚本，用于**修改 Windsurf 的机器标识信息**（`storage.json` 中的 `telemetry.machineId`、`telemetry.sqmId`、`telemetry.devDeviceId`），方便在不同环境中重置标识。

- `windsurf_linux.py`：Linux 版
- `winsurf_windows.py`：Windows 版

> ⚠️ 风险提示：本工具会修改 Windsurf 的配置文件并设置为只读，请确认你理解相关风险再使用，建议先备份配置文件。

---

## 一、通用前置操作

- **1. 关闭 Windsurf 程序**  
  脚本本身会尝试检测并关闭 Windsurf 进程，但最好先手动关闭，以避免文件锁或修改失败。

- **2. 确认 Python 环境**  
  打开终端/命令行，输入：
  ```bash
  python --version
  ```
  如果系统使用 `python3` 命令，请在下面命令中相应替换。

- **3. 建议先备份配置文件 `storage.json`**  
  不同系统上路径不同，脚本中已经内置默认路径，你也可以手动备份：
  - Windows：`%APPDATA%/Windsurf/User/globalStorage/storage.json`
  - Linux：`~/.config/Windsurf/User/globalStorage/storage.json` 或 `~/.windsurf/User/globalStorage/storage.json`

---

## 二、Linux 版使用方法（`windsurf_linux.py`）

### 1. 运行环境要求

- 系统：Linux（`os.name == 'posix'`）
- 需要有权限访问并修改当前用户的配置目录
- 建议以 **root 或 sudo** 运行，以避免权限不足

### 2. 启动命令

在脚本所在目录打开终端，执行：

```bash
python3 windsurf_linux.py
# 或
python windsurf_linux.py
```

执行流程大致为：

- 检查系统与 HOME 目录是否有效
- 自动定位 `storage.json`（优先 `~/.config/Windsurf/...`，否则尝试 `~/.windsurf/...`）
- 扫描并尝试关闭 Windsurf 相关进程
- 读取 `storage.json`，生成新的随机 `machineId` / `sqmId` / `devDeviceId`
- 写回配置文件
- 将 `storage.json` 设置为 **只读**（仅所有者可读）

### 3. 注意事项

- 如需再次修改机器码，先把 `storage.json` 的只读权限取消，例如：
  ```bash
  chmod u+rw ~/.config/Windsurf/User/globalStorage/storage.json
  ```
- 如果提示没有找到 `storage.json`，请确认 Windsurf 已运行过，并在当前用户下正常使用过。

---

## 三、Windows 版使用方法（`winsurf_windows.py`）

### 1. 运行环境要求

- 系统：Windows（`os.name == 'nt'`）
- 需要可以访问 `%APPDATA%` 目录

### 2. 启动方式一：命令行运行

1. 在脚本所在目录，按住 `Shift` + 右键 → 打开 PowerShell/命令提示符。  
2. 执行：

   ```bash
   python winsurf_windows.py
   ```

建议在 **有管理员权限** 的终端中运行，以减少权限问题。

### 3. 启动方式二：双击运行（有 Python 关联时）

- 已将 `.py` 关联到 Python 解释器时，可以直接双击 `winsurf_windows.py`。  
- 运行过程中会在控制台打印日志，结束时提示“按任意键退出…”。

### 4. 脚本执行流程

- 检查系统和 `%APPDATA%` 环境变量
- 定位 `storage.json`：`%APPDATA%/Windsurf/User/globalStorage/storage.json`
- 使用 `tasklist` / `taskkill` 检测并关闭 Windsurf 相关进程
- 读取 `storage.json`，生成新的随机 `machineId` / `sqmId` / `devDeviceId`
- 先移除只读属性，写回修改后的配置
- 再次把 `storage.json` 设置为 **只读**

### 5. 注意事项

- 如果脚本提示“目标文件不存在”，请确认：
  - Windsurf 已至少运行过一次；
  - 当前登录的用户与实际使用 Windsurf 的用户一致。
- 如需再次修改机器码，可以手动去掉 `storage.json` 的只读属性（右键 → 属性 → 取消“只读”）。

---

## 四、常见问题

- **Q：修改后还不生效？**  
  - 确认在修改前已关闭所有 Windsurf 进程；
  - 修改后重启 Windsurf 再观察效果。

- **Q：报权限不足/无法写入文件？**  
  - Linux：尝试 `sudo python3 windsurf_linux.py`；
  - Windows：右键终端图标 → 以管理员身份运行，再执行脚本。

你可以根据自己的实际使用情况继续在本 README 中补充更多说明或截图。