Skip to content

Latest commit

 

History

History
257 lines (176 loc) · 6.72 KB

README.md

File metadata and controls

257 lines (176 loc) · 6.72 KB

🔑 Cursor Token Manager

一个功能强大的 Cursor Token 管理工具，提供图形化命令行界面。

✨ 功能特性

  • 📥 导入 Token - 从 Cursor 客户端自动导入当前 Token
  • 💾 保存 Token - 支持客户端 Token 和网页版 Cookie Token
  • 🔄 Web Token 转换 - 网页短期 Cookie Token 自动转换为长期 Session Token ⭐
  • 📊 状态查询 - 实时查询 Token 有效性和账户信息
  • 🔃 自动刷新 - 使用 Refresh Token 自动获取新的 Access Token
  • 🔐 登录 Cursor - 使用保存的 Token 直接登录，集成机器码重置
  • 🗑️ Token 管理 - 查看、删除已保存的 Token，支持去重
  • 📂 历史管理 - 查看所有保存过的 Token 记录

🚀 快速开始

1. 安装依赖

cd cursor-Token
pip install -r requirements.txt

2. 运行程序

python cursor_token_manager.py

或添加执行权限后直接运行：

chmod +x cursor_token_manager.py
./cursor_token_manager.py

📖 使用指南

网页 Cookie Token 转换 ⭐

新功能：支持将网页版短期 Cookie Token 转换为客户端长期 Session Token

获取网页 Cookie Token

  1. 在浏览器中登录 Cursor 网页版 (https://cursor.com)
  2. 打开开发者工具 (F12)
  3. 进入 Application → Cookies → https://cursor.com
  4. 找到 WorkosCursorSessionToken 字段
  5. 复制 Cookie 值

转换为长期 Token

  1. 运行程序，选择 2 - 保存 Token
  2. 选择 2 - 网页版 Cookie Token
  3. 粘贴 Cookie Token
  4. 自动转换并保存为长期有效的 Session Token

优势：

  • ✅ 短期变长期 - Cookie Token 通常只有几小时有效期，转换后可用 60 天
  • ✅ 跨平台使用 - 网页版 Token 转换后可在客户端使用
  • ✅ 自动刷新 - 转换后支持 Refresh Token 自动续期

主菜单

╔════════════════════════════════════════════════════════════════════╗
║                    🔑 Cursor Token Manager                         ║
╚════════════════════════════════════════════════════════════════════╝

📥 1. 导入 Token
   从 Cursor 客户端导入当前 Token

💾 2. 保存 Token
   手动输入并保存 Token

📊 3. Token 状态查询
   查看当前 Token 信息和有效性

🔄 4. 刷新 Token
   使用 Refresh Token 获取新的 Access Token

⏱️  5. Token 剩余时效检测
   检测 Access Token 和 Refresh Token 剩余有效期

📂 6. 查看保存的 Token
   显示本地保存的所有 Token

❌ 0. 退出

功能说明

1️⃣ 导入 Token

自动从 Cursor 客户端导入当前登录的 Token：

  • macOS: ~/Library/Application Support/Cursor/User/globalStorage/storage.json
  • Windows: %APPDATA%\Cursor\User\globalStorage\storage.json
  • Linux: ~/.config/Cursor/User/globalStorage/storage.json

前提条件: 已在 Cursor 客户端中登录

2️⃣ 保存 Token

手动输入 Token 信息：

  • 邮箱（可选）
  • Access Token（必填）
  • Refresh Token（可选，但推荐填写以便刷新）

3️⃣ Token 状态查询

验证 Token 有效性并显示账户信息：

  • ✅ 验证 Access Token 是否有效
  • 📧 显示邮箱
  • 💳 显示订阅类型（Free Trial / Pro）
  • 🕒 显示剩余试用天数

4️⃣ 刷新 Token

使用 Refresh Token 获取新的 Access Token：

  • 🔄 自动调用 Cursor 刷新 API
  • 💾 自动保存新的 Token
  • ✅ 无需重新登录

前提条件: 必须有有效的 Refresh Token

5️⃣ Token 剩余时效检测

可视化显示 Token 剩余有效期：

🔑 Access Token:
   过期时间: 2025-10-10 18:30:00
   剩余时间: 45分钟
   [████████████████████████████████████░░░░] 75.0%

🔄 Refresh Token:
   过期时间: 2025-11-09 17:00:00
   剩余时间: 30天
   [████████████████████████████████████████] 100.0%

颜色说明:

  • 🟢 绿色 (>60%): Token 健康
  • 🟡 黄色 (30-60%): 建议刷新
  • 🔴 红色 (<30%): 即将过期

6️⃣ 查看保存的 Token

查看所有历史保存的 Token：

  • 📧 邮箱
  • 📅 导入时间
  • 🔖 来源（cursor_client / manual_input / refreshed）
  • ✅ 当前状态（有效/已过期）

📁 文件存储

所有 Token 保存在：

~/.cursor-token-manager/tokens.json

格式：

{
  "tokens": [
    {
      "access_token": "eyJhbGci...",
      "refresh_token": "eyJhbGci...",
      "email": "user@example.com",
      "imported_at": "2025-10-10T17:00:00",
      "source": "cursor_client"
    }
  ],
  "last_updated": "2025-10-10T17:00:00"
}

🔧 高级用法

导出 Token 到其他设备

  1. 在设备 A 运行程序，选择 1 导入 Token
  2. 找到文件：~/.cursor-token-manager/tokens.json
  3. 复制该文件到设备 B 的同一位置
  4. 在设备 B 运行程序，选择 6 查看已保存的 Token
  5. Token 自动可用！

自动刷新脚本

创建定时任务自动刷新 Token（避免过期）：

# crontab -e
# 每天凌晨 3 点自动刷新
0 3 * * * cd /path/to/cursor-Token && python cursor_token_manager.py << EOF
4
0
EOF

⚠️ 注意事项

  1. 安全性: Token 文件包含敏感信息，请妥善保管
  2. Refresh Token: 建议总是保存 Refresh Token，以便自动续期
  3. 网络要求: 刷新和验证功能需要访问 api2.cursor.sh
  4. 有效期:
    • Access Token: ~1 小时
    • Refresh Token: ~30 天（滚动续期）

🐛 故障排除

Token 导入失败

  • 确保已在 Cursor 客户端中登录
  • 检查 Cursor 配置文件路径是否正确

刷新失败

  • 确认 Refresh Token 未过期
  • 检查网络连接
  • 确认可以访问 api2.cursor.sh

Token 验证失败 (401)

  • Token 可能已过期，尝试刷新
  • 或重新从 Cursor 客户端导入

Token 刷新失败 (404)

⚠️ 重要提示: Cursor 官方的 Token 刷新 API (https://api2.cursor.sh/auth/refresh) 已经失效（返回 404）

解决方案:

  • 本工具的"刷新 Token"功能已更新，会直接从 Cursor 客户端重新读取最新的 Token
  • 请确保 Cursor 客户端已登录，然后使用"刷新 Token"功能即可
  • 如果需要真正的 API 刷新，可以尝试第三方刷新服务（如 cursor-free-vip 项目使用的 token.cursorpro.com.cn）

📝 License

MIT License

🤝 贡献

欢迎提交 Issue 和 Pull Request！

💻 Developed by hihi