AI导哈

Cursor用户目录同步工具

面向开发者的Cursor编辑器用户级配置管理方案，通过Git同步用户规则、技能、命令和MCP配置，实现多设备间开发环境快速统一。

  • by StarksJohn
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 StarksJohn/CursorUserDir

使用说明

Cursor User Dir

每月24日15:00点重置

远程git仓库: https://github.com/StarksJohn/CursorUserDir

Cursor 用户级命令、技能、MCP 主目录:

  • Win11: C:\Users\Stark8964911\.cursor
  • Mac: ~/.cursor

模型对比:

  • GPT-5.4-thinking:
    • 修改 "D:\work\RN\csx-mobile-upgrade\src\useHooks\usePeriodicTask.ts 的 这段代码的逻辑, 也就是 每隔30秒执行 executeCustomTask() 函数,但是 退出登录后, 这个逻辑没有取消,需要你修改" 这个问题, 直接把 D:\work\RN\csx-mobile-upgrade\src\useHooks\usePeriodicTask.ts干成 死循环了
      • 但是 解决了 有没有什么MCP或者工具可以让 cursor使用的 模型访问到 已经登录过的网页? 这样我就不用每次先截图再提问了 这个问题,sonnet-4.6 一开始没解决

跨机器同步

在 Mac 的 ~/.cursor 目录内用 git pull origin main 同步本仓库（仅 git fetch 不会更新 Finder 里的工作区文件，须 pull 或 fetch 后再 merge；见 Roaming 指南 §2.1a 问题 16）。进 Git 的只有可移植目录（见根目录 .gitignore）：skills/、commands/、rules/、hooks/、plans/、subagents/、config/、skills-cursor/，以及 hooks.json、Cursor AI 规则.md、README.md、sync-cursor-config.ps1 等根文件。projects/、plugins/ 缓存不入库（路径随机器变、体积大）；两端 Cursor 会在本地各自生成。

目录结构

~/.cursor  (或 C:\Users\Stark8964911\.cursor)
├── Cursor AI 规则.md          # 唯一的 Cursor 全局规则正文
├── hooks.json                 # 注册全局 sessionStart 自动加载
├── hooks/
│   └── load-global-user-rules.js
│                              # 把规则正文注入每个本地新 Chat
├── config/                     # Cursor 全局配置备份（入 Git）
│   ├── settings.json          # 全局设置
│   ├── keybindings.json       # 快捷键
│   ├── .prettierrc            # Prettier 配置
│   ├── snippets/              # 代码片段
│   ├── SwapCtrlAlt.ahk        # Windows: Ctrl/Alt 交换脚本
│   └── extensions-list.txt    # 已安装扩展列表
├── sync-cursor-config.ps1     # Windows: 配置备份/恢复脚本
├── commands/                  # 自定义 slash 命令
├── skills-cursor/             # 内置技能
├── skills/                    # 个人技能
├── rules/                     # Cursor 用户级文件规则
├── projects/                  # 项目级数据（本地-only，不进本仓库）
└── plugins/                   # 扩展/插件缓存（本地-only，不进本仓库）

使用方式

Cursor 全局 User Rules

~/.cursor/Cursor AI 规则.md 是唯一规则正文。~/.cursor/hooks.json 注册官方用户级 sessionStart Hook；每个本地新 Chat 创建时，hooks/load-global-user-rules.js 会读取该文件并通过 additional_context 注入初始系统上下文。

  • 首次同步本方案后，执行一次 Developer: Reload Window 或重启 Cursor，并在 Cursor Settings > Hooks / Hook Output 确认 sessionStart 成功。
  • 此后修改规则或 git pull 只需新开 Chat，不再把全文粘贴到 Cursor Settings > Rules。若 Customize → Rules → User（旧版：Cursor Settings → Rules → User Rules）仍有旧全文，搜索并删除「任务结束上下文汇报」或整份过期的「Cursor AI 规则」粘贴；Git / PR / 网页验证等短规则可保留。不清空则旧「必须输出文件清单」会与本文件第 10 条冲突，回复尾部仍会出现那两段。
  • Hook 依赖 PATH 中可用的 Node.js；可用 node --version 检查。
  • 用户级 ~/.cursor/hooks.json 只适用于本机 Cursor 会话，Cursor Cloud Agents 无法访问本机用户目录。

Windows: 备份配置到 Git

cd C:\Users\Stark8964911\.cursor   # 或 cd ~/.cursor (若已迁移)
.\sync-cursor-config.ps1 -Action backup

git add .
git commit -m "Update Cursor configuration"
git push

Windows: 从 Git 恢复配置

cd C:\Users\Stark8964911\.cursor
git pull
.\sync-cursor-config.ps1 -Action restore
# 重启 Cursor 使配置生效

检查同步状态

.\sync-cursor-config.ps1 -Action status

配置路径

项目 Windows Mac
Cursor 配置 %APPDATA%\Cursor\User\ ~/Library/Application Support/Cursor/User/
扩展 %USERPROFILE%\.cursor\extensions\ ~/.cursor/extensions/
AHK 脚本 %APPDATA%\...\Startup\SwapCtrlAlt.ahk (仅 Windows)
MCP 全局配置 ~/.cursor/mcp.json 同左

mcp.json（跨 Win / Mac）

本仓库中的 mcp.json 使用 npx 启动各 MCP（请在两端安装 Node 并将 npx 加入 PATH；若你过去依赖固定路径如 D:\work\node\npx.cmd，请改为使用 PATH 中的 Node，或在不提交的本地副本中改 command）。Win11 下把目录加入 用户 PATH、设置 HOME=%USERPROFILE% 的逐步操作见 Cursor_使用指南与Token优化.md §2.1a 问题 11（对照 img_164352.png）。在 PowerShell 里验证请用 where.exe npx，不要用 where npx（见 问题 12）。

  • filesystem：唯一根目录为 ${env:HOME}。macOS 默认有 HOME。Windows 若启动报错，请设置用户环境变量 HOME，值为你的用户目录（与 USERPROFILE 相同即可，例如 C:\Users\Stark8964911）。需要额外盘符（如原 D:\work）时，可在本机向 args 中追加路径或改用 Cursor 支持的 ${env:…} 变量（勿提交密钥）。
  • github：GITHUB_PERSONAL_ACCESS_TOKEN 从环境变量注入，勿把 token 明文写进仓库。
  • playwright：已去掉固定的 Windows 浏览器缓存路径，由 Playwright 在各平台使用默认缓存目录。

修改 mcp.json 后请重启 Cursor。

说明

  • sync-cursor-config.ps1: 仅 Windows 可用; Mac 上可手动复制 config/ 内容到 Cursor 配置目录
  • SwapCtrlAlt.ahk: Windows 专用, 用于模拟 Mac 键位
  • config/: 作为配置源, 通过脚本恢复到 Cursor 实际配置目录

相关 MCP