解决 Cursor Remote Agent “cursor-remote-lock 文件已存在” 导致无法启动的问题（WSL 环境）

问题背景

在使用 Cursor + SSH Tunnel 连接远程开发环境时，有时会遇到 Cursor Remote Agent 无法正常启动的问题。表现为 Cursor 一直重复输出：

Install in progress, sleeping for a bit...

同时伴随锁文件创建失败的报错：

ln: 无法创建硬链接 '/run/user/1000/cursor-remote-lock.xxxxx': 文件已存在

由于 Cursor Remote Agent 实际在 WSL (Ubuntu) 中运行，因此该问题需要在 WSL 内处理，而不是在 Windows 或服务器端。
本文记录问题现象与最终解决方案。

📌 1. 报错信息（stderr + stdout）

错误日志中会循环出现如下内容：

ln: 无法创建硬链接 '/run/user/1000/cursor-remote-lock.2cad87af84b9306e52efc5f2e5296cad': 文件已存在
2025-12-11 13:22:31.818 [info] (ssh_tunnel) stdout: Install in progress, sleeping for a bit...

ln: 无法创建硬链接 '/run/user/1000/cursor-remote-lock.2cad87af84b9306e52efc5f2e5296cad': 文件已存在
2025-12-11 13:22:32.846 [info] (ssh_tunnel) stdout: Install in progress, sleeping for a bit...

关键报错：
cursor-remote-lock.* 文件已存在
Cursor 误以为 Remote Agent 已在运行，从而陷入死循环。

📌 2. 问题原因分析

1. Cursor Remote Agent 并非运行在 Windows，而是运行在 WSL Linux 中。
2. Remote Agent 在启动时会创建锁文件：
   /run/user/1000/cursor-remote-lock.*
3. 当 Cursor 异常退出、安装中断或崩溃时，该锁文件不会自动删除。
4. 再次启动 Cursor 时：
   发现锁文件存在 → 认为已有实例 → 尝试创建硬链接失败 → 不断重试

因此错误的实际来源是：
🔍 WSL 中的 cursor-remote 进程残留 + 锁文件未清理

📌 3. 最终解决方案（在 WSL 中执行）

以下步骤实测有效，务必在 WSL 内执行。

📌 4. 命令汇总（可直接复制）

wsl
ps aux | grep cursor-remote
pkill -f cursor-remote
rm -f /run/user/1000/cursor-remote-lock.*

📌 5. 总结

清理残留进程与锁文件即可彻底修复。