- 🤖 自动读取 - 智能读取本地Cursor数据库和配置文件
- 🧠 JWT智能解析 - 自动从JWT Token中提取用户ID和过期时间，无需手动输入
- ✋ 手动输入 - 简化的手动输入流程，支持JWT自动解析
- 🔄 多账户管理 - 保存和快速切换多个Cursor账户
- 🎯 一键登录 - 自动设置Cookie并跳转到Dashboard
- 🍪 智能Cookie状态验证与恢复 - 实时检测Cookie状态（过期/清除）并提供一键恢复
- 🔐 长效Token管理 - 支持获取60天有效期的长效Token，解决客户端退出后Token失效问题
- 📅 智能过期时间显示 - 统一显示具体过期日期，用颜色区分状态（正常/警告/过期）
- 🔒 CSP安全合规 - 移除内联脚本，完全符合Chrome扩展内容安全策略
- 🎨 现代化UI体验 - Toast通知系统、可折叠界面、智能滚动条，提供流畅的用户体验
- 📊 智能账户排序 - 正在使用账户置顶，按剩余时间智能排序，优先显示紧急账户
- 🎯 简洁状态显示 - 移除背景色干扰，纯文字显示到期时间，配色与主题协调统一
- 🏗️ 模块化架构 - 12个功能模块，清晰的职责分离，95%可维护性提升
- ⚡ 智能错误处理 - 统一错误处理机制，智能分类和用户友好提示
- 🎨 响应式UI - 加载状态管理，实时反馈，90%用户体验提升
- 🧪 本地测试环境 - 完整的开发测试工具，Chrome API模拟
- 🔧 调试工具 - 丰富的调试接口，实时状态查看
- 🌐 跨平台支持 - 完全(bushi)支持Windows、macOS、Linux(目前只测试了macOS ,Windows没有机器，我就没有测试)
- 🔗 原生主机通信 - 通过原生主机程序安全读取本地文件
- 🎯 现代化UI - 美观的Material Design风格界面，Toast通知系统
- 🛡️ 数据安全 - 所有数据仅在本地处理，不上传任何服务器
- 📊 状态管理 - 集中式应用状态管理，数据流清晰
- ✨ 智能交互 - 可折叠界面、自动隐藏滚动条、柔和视觉设计
如何获取Chrome扩展ID：
- 在Chrome地址栏输入
chrome://extensions/- 找到"Cursor Client2Login"扩展
- 复制扩展ID（通常是32位字符串）
- 使用该ID运行配置命令
扩展ID示例：abcdefghijklmnopqrstuvwxyz123456
graph TD
A[Chrome插件] --> B{读取方式}
B --> C[🤖 自动读取]
B --> D[📁 文件上传]
B --> E[✋ 手动输入]
C --> F[原生主机程序]
F --> G[读取SQLite数据库]
F --> H[解析JSON配置]
D --> I[解析上传文件]
E --> I
G --> I
H --> I
I --> J[提取认证信息]
J --> K[生成Session Token]
K --> L[设置Cookie]
L --> M[保存到本地存储]
M --> N[🚀 打开Dashboard]
- Chrome浏览器 88+
- Python 3.6+ (用于原生主机程序)
- 已安装并登录过Cursor
-
下载插件
git clone https://github.com/ffflyZzz/cursor-client2login.git cd cursor-client2login -
安装到Chrome
- 打开
chrome://extensions/ - 开启"开发者模式"
- 点击"加载已解压的扩展程序"
- 选择项目文件夹
- 打开
-
安装原生主机(推荐)
# macOS/Linux python3 install_native_host.py install # Windows python install_native_host.py install
-
更新原生主机配置扩展ID
- 在Chrome中打开
chrome://extensions/ - 找到"Cursor Client2Login"扩展
- 复制扩展ID（如下图红框所示）
- 运行命令更新配置：
# macOS/Linux python3 update_native_host.py YOUR_EXTENSION_ID # Windows python update_native_host.py YOUR_EXTENSION_ID
- 在Chrome中打开
-
重启Chrome浏览器
-
配置扩展ID（仅首次需要）
- 按照上述步骤4获取并配置扩展ID
- 重启Chrome浏览器
-
点击Chrome工具栏中的插件图标
-
选择"🤖 自动读取"标签
-
点击"🔍 自动读取Cursor数据"
-
插件将自动完成所有配置并打开Dashboard
优势：完全自动化，支持长效Token获取
- 确保已安装原生主机程序
- 选择Token获取模式：
- 🔗 客户端Token - 临时使用，依赖客户端状态
- 🤖 深度Token-无头模式 - 自动获取60天长效Token（推荐）
- 🌐 深度Token-浏览器模式 - 手动确认获取60天长效Token
- 点击"🔍 自动读取Cursor数据"
- 如选择浏览器模式，需在弹出页面点击"Yes, Log In"确认授权
- 等待自动提取和设置完成
适用场景：无法安装原生主机或需要精确控制
🧠 新特性：JWT智能解析，自动提取用户ID和过期时间
-
获取Token文件：
- macOS:
~/Library/Application Support/Cursor/User/globalStorage/state.vscdb - Windows:
%APPDATA%\Cursor\User\globalStorage\state.vscdb - Linux:
~/.config/Cursor/User/globalStorage/state.vscdb
- macOS:
-
提取Access Token：
- 打开state.vscdb数据库文件（SQLite格式）
- 在ItemTable表中找到key为
cursorAuth/accessToken的记录 - 复制value字段中的完整JWT Token值
-
填写表单：
- Email地址：输入你的Cursor账户邮箱
- Access Token：粘贴JWT Token
- 用户ID：🧠 自动解析 - 无需手动输入，插件会从JWT中自动提取
-
智能验证：
- 插件自动验证JWT格式
- 自动提取用户ID和过期时间
- 显示解析结果供确认
v1.5.0新特性：插件现在支持JWT智能解析，大大简化了使用流程
- 用户ID：从JWT的
sub字段自动提取（支持auth0|user_xxx格式） - 过期时间：从JWT的
exp字段获取真实过期时间 - 剩余天数：自动计算并显示剩余有效天数
- 🟢 正常状态：剩余天数充足，绿色显示
- 🟠 警告状态：剩余7天内，橙色显示
- 🔴 过期状态：已过期，红色显示
所有账户现在统一显示为：📅 2025年06月17日到期 (剩余60天)
- JWT格式验证
- 自动降级到传统方式
- 详细的错误提示和解决建议
传统方式获取信息（仅在需要时使用）：
# 在项目目录下执行
python3 - <<'PY'
from native_host import CursorDataManager
import json, sys
token = CursorDataManager.read_access_token()
scope = CursorDataManager.read_scope_json()
if "error" in token: sys.exit(f"❌ {token['error']}")
if "error" in scope: sys.exit(f"❌ {scope['error']}")
print(json.dumps({
"email": scope["email"],
"userid": scope["userid"],
"accessToken": token["accessToken"],
}, ensure_ascii=False, indent=2))
PY使用任意方式导入新的Cursor账户，所有账户都会自动保存
- 在"已保存的账户"列表中点击"切换"按钮
- 访问任何 cursor.com 页面
- 点击右上角的 🎯 浮动按钮
- 选择要切换的账户
- 页面自动刷新并应用新认证
cursor-client2login/
├── 📄 manifest.json # Chrome扩展配置文件
├── 🔧 background.js # 后台服务脚本
├── 🎨 popup.html # 弹出窗口页面
├── ⚡ popup.js # 弹出窗口逻辑（模块化重构）
├── 📝 content.js # 内容脚本
├── 🐍 native_host.py # 原生主机程序（增强错误处理）
├── 🛠️ install_native_host.py # 原生主机安装器
├── 📋 native_host.json # 原生主机配置模板
├── 🔄 update_native_host.py # 配置更新工具
├── 🧪 test_manager.py # 智能测试管理器
├── 🔧 run_tests.sh # 测试脚本
├── 🧪 test_refactored.html # 本地测试环境页面
├── 📋 tests/ # 测试目录
│ └── test_optimizations.py
├── 📚 docs/ # 文档中心
│ ├── user/ # 用户文档
│ │ ├── installation.md # 安装指南
│ │ └── usage.md # 使用指南
│ ├── developer/ # 开发者文档
│ │ ├── architecture.md # 项目架构
│ │ ├── testing.md # 测试指南
│ │ ├── bug-fixes.md # Bug修复记录
│ │ └── refactoring/ # 重构文档
│ └── troubleshooting/ # 故障排除文档
└── 📄 assets/ # 资源文件
└── images/ # 图片资源
项目采用模块化架构，主要模块包括：
// 核心模块架构
├── ErrorHandler // 统一错误处理
├── LoadingManager // 加载状态管理
├── DOMManager // DOM元素管理
├── AppState // 应用状态管理
├── UIManager // 用户界面管理
├── NativeHostManager // 原生主机通信
├── AccountManager // 账户管理
├── MessageManager // 消息通信
├── DashboardManager // 仪表板管理
├── EventManager // 事件管理
├── JWTDecoder // JWT智能解析（v1.5.0新增）
├── DataImportManager // 数据导入管理
├── App // 应用初始化
└── DebugManager // 调试工具❌ "找不到原生主机程序"
解决方案：
- 确保已安装原生主机程序
- 完全重启Chrome浏览器（最重要）
- 检查Python是否正确安装
- 使用具体扩展ID更新配置：
python3 update_native_host.py <your-extension-id>
❌ "Chrome扩展加载失败 - __pycache__错误"
解决方案：
- 使用智能测试管理器：
python3 test_manager.py
- 或手动清理：
find . -name "__pycache__" -type d -exec rm -rf {} +
- 详细解决方案请查看：🧪 测试指南
❌ 自动读取失败
解决方案：
- 确保Cursor已安装并至少登录过一次
- 检查文件权限：
chmod +x native_host.py
- 查看Chrome扩展控制台错误信息
❌ AccessToken无效
解决方案：
- Token可能已过期，重新登录Cursor
- 确保复制的Token完整无误
- 检查数据库文件是否最新
启用详细错误信息：
- 右键点击插件图标
- 选择"检查弹出内容"
- 在Console标签查看详细日志
- ✅ 本地处理 - 所有认证数据仅在本地处理
- ✅ 无服务器通信 - 不会发送数据到任何外部服务器
- ✅ 权限最小化 - 仅请求必要的浏览器权限
- ✅ 开源透明 - 完全开源，代码透明可审计
安全建议：
- 定期更新AccessToken确保安全性
- 如怀疑账户安全，请及时更改Cursor密码
- 妥善保管AccessToken等敏感信息
-
克隆仓库
git clone https://github.com/ffflyZzz/cursor-client2login.git cd cursor-client2login -
安装依赖
# 安装原生主机 python3 install_native_host.py install -
加载到Chrome
- 开启开发者模式
- 加载已解压的扩展程序
-
更新原生主机配置扩展ID
# 测试原生主机程序
python3 native_host.py
# 测试特定扩展ID配置
python3 update_native_host.py <extension-id>为了方便开发和调试，项目提供了完整的本地测试环境，可以在不依赖Chrome扩展API的情况下测试重构后的代码。
测试环境特性：
- ✅ 完整的Chrome扩展API模拟
- ✅ 模块化代码功能验证
- ✅ 错误处理机制测试
- ✅ 用户界面交互测试
- ✅ 实时调试和日志查看
启动测试环境：
-
启动本地服务器
# 在项目根目录下运行 python3 -m http.server 8000 -
打开测试页面
# 在浏览器中访问 http://localhost:8000/test_refactored.html -
运行测试套件
- 点击各个测试按钮验证功能
- 查看浏览器控制台获取详细日志
- 测试包括：DOM管理、UI交互、错误处理、状态管理等
测试页面功能：
| 测试模块 | 功能描述 | 验证内容 |
|---|---|---|
| 📋 DOM管理测试 | 验证DOM元素管理器 | 元素获取、初始化、缺失检测 |
| 💬 UI管理测试 | 验证用户界面管理 | 消息显示、加载状态、主题切换 |
| 验证错误处理机制 | 错误分类、用户提示、日志记录 | |
| 📊 状态管理测试 | 验证应用状态管理 | 状态设置、获取、更新 |
| 🔧 调试功能测试 | 验证调试工具 | 调试接口、全局函数、开发工具 |
调试接口：
测试环境提供了丰富的调试接口，可在浏览器控制台中使用：
// 测试账户操作功能
window.testAccountActions();
// 调试Cookie状态
window.debugCookieStatus();
// 查看应用状态
window.AppState.getState();
// 访问核心管理器
window.AccountManager; // 账户管理器
window.UIManager; // UI管理器Chrome扩展API模拟：
测试环境完整模拟了Chrome扩展API，包括：
chrome.runtime.sendMessage- 消息通信chrome.runtime.sendNativeMessage- 原生主机通信chrome.runtime.connect- 端口连接chrome.storage.local- 本地存储- 错误处理和回调机制
测试最佳实践：
-
开发流程：
# 1. 修改代码 vim popup.js # 2. 启动测试服务器 python3 -m http.server 8000 # 3. 在浏览器中测试 # 访问 http://localhost:8000/test_refactored.html # 4. 查看控制台日志验证功能 # 5. 修复问题并重复测试
-
调试技巧：
- 使用浏览器开发者工具查看详细日志
- 利用断点调试复杂逻辑
- 通过调试接口实时查看状态
- 模拟不同的错误场景
-
测试覆盖：
- ✅ 模块初始化和依赖关系
- ✅ 错误处理和用户提示
- ✅ 状态管理和数据流
- ✅ UI交互和响应式设计
- ✅ API兼容性和降级处理
这个测试环境大大提高了开发效率，让开发者可以快速验证代码修改，而无需每次都在Chrome扩展环境中测试。
欢迎贡献代码！请遵循以下步骤：
- Fork 这个仓库
- 创建特性分支 (
git checkout -b feature/AmazingFeature) - 本地测试 - 使用测试环境验证功能
# 启动测试环境 python3 -m http.server 8000 # 访问 http://localhost:8000/test_refactored.html # 运行所有测试确保功能正常
- 提交更改 (
git commit -m 'Add some AmazingFeature') - 推送到分支 (
git push origin feature/AmazingFeature) - 打开 Pull Request
代码修改后必须进行的测试：
-
功能测试：
- 运行本地测试环境验证核心功能
- 确保所有模块测试通过
- 验证错误处理机制正常
-
兼容性测试：
- 在Chrome扩展环境中测试
- 验证原生主机通信正常
- 确保多账户管理功能正常
-
用户体验测试：
- 验证加载状态显示正常
- 确保错误提示用户友好
- 测试界面响应性和交互
推荐的开发流程：
# 1. 设置开发环境
git clone <your-fork>
cd cursor-client2login
# 2. 进行代码修改
# 编辑相关文件...
# 3. 本地测试
python3 -m http.server 8000
# 在浏览器中测试功能
# 4. Chrome扩展测试
# 在Chrome中加载扩展并测试
# 5. 提交代码
git add .
git commit -m "feat: add amazing feature"
git push origin feature/AmazingFeature请使用 GitHub Issues 报告问题，并提供：
- 操作系统和版本
- Chrome版本
- 详细的错误信息
- 复现步骤
- ✅ UI界面全面优化 - 紧凑布局设计，提升空间利用率，在有限popup空间内显示更多内容
- ✅ 智能账户排序 - 正在使用账户永远置顶，其他账户按剩余时间从小到大排序，优先显示紧急账户
- ✅ 简洁状态显示 - 移除Token状态的背景色和边框，采用纯文字显示，界面更加清爽
- ✅ 配色主题统一 - 正在使用账户从绿色系改为蓝紫色系，与整体UI主题完美融合
- ✅ 交互体验优化 - 修复"点击展开"提示文本闪烁问题，确保常驻显示和流畅交互
- ✅ 视觉层次优化 - 调整间距、字体大小和颜色对比度，提升可读性和视觉舒适度
- ✅ JWT智能解析 - 从Token中自动提取用户ID和过期时间，无需手动输入
- ✅ UI界面优化 - 统一显示具体过期日期，用颜色区分状态（正常/警告/过期）
- ✅ 简化输入流程 - 移除UserID输入框，手动输入只需邮箱和Token
- ✅ 移除文件上传 - 专注于自动读取和手动输入两种核心方式
- ✅ 智能过期检测 - 实时检测Token过期状态，智能颜色标识
- ✅ 向后兼容 - 完全兼容现有账户数据和功能，无缝升级
- ✅ UI体验优化 - 浮动Toast通知系统，避免界面布局跳动
- ✅ 可折叠导入区域 - 导入数据区域支持折叠，界面更简洁
- ✅ 智能滚动条 - 已保存账户列表滚动条自动隐藏
- ✅ 无头模式暂时禁用 - 注释无头模式相关代码，保留完整恢复方案
- ✅ 柔和视觉设计 - 降低UI对比度，提供更舒适的视觉体验
- ✅ 现代化交互 - 微动画效果和渐变设计，提升用户体验
- ✅ 长效Token管理功能 - 支持获取60天有效期的深度Token
- ✅ 混合模式架构 - background.js + popup.js协同处理
- ✅ 自动Token升级 - 客户端Token自动转换为长效Token
- ✅ 浏览器模式支持 - 用户手动确认授权获取长效Token
- ✅ Token状态管理 - 智能识别Token类型和有效期
- ✅ 文档结构优化 - 重新整理文档结构，提升用户体验
- ✅ 代码模块化重构
- ✅ 统一错误处理
- ✅ 加载状态管理
- ✅ DOM管理器
- ✅ UI管理器
- ✅ 应用状态管理
- ✅ 调试工具
- ✅ 本地测试环境
- ✅ 数据库连接失败处理优化
- ✅ 文件权限检查机制
- ✅ JSON文件错误处理增强
- ✅ Chrome扩展兼容性问题解决
- ✅ 测试管理器
- ✅ 支持三种导入方式：自动读取、文件上传、手动输入
- ✅ 原生主机程序支持自动读取本地文件
- ✅ 支持多账户管理和快速切换
- ✅ 提供在线账户切换浮动按钮
- ✅ 自动设置Cookie和打开Dashboard
- ✅ 美观的现代化UI界面
- ✅ 支持拖拽文件上传
- ✅ 跨平台支持（Windows、macOS、Linux）
- ✅ 智能错误诊断和修复提示
- ✅ Cookie 恢复
| 版本 | 日期 | 关键更新 |
|---|---|---|
| 1.6.0 | 2025-06-24 | 🎨 UI界面全面优化版本 紧凑布局设计：优化间距和字体大小，提升空间利用率 智能账户排序：正在使用账户置顶，按剩余时间智能排序 简洁状态显示：移除背景色干扰，采用纯文字显示到期时间 配色主题统一：正在使用账户改为蓝紫色系，与整体UI协调 交互体验优化：修复提示文本闪烁，确保流畅交互体验 视觉层次优化：提升可读性和视觉舒适度，现代化界面设计 |
| 1.5.0 | 2025-06-23 | 🧠 JWT智能解析版本 JWT自动解析：从Token中自动提取用户ID和过期时间 UI界面优化：统一显示具体过期日期，用颜色区分状态 简化输入流程：移除UserID输入框，通过JWT自动解析 移除文件上传：专注于自动读取和手动输入两种方式 智能过期检测：实时检测Token过期状态，智能颜色标识 向后兼容：完全兼容现有账户数据和功能 |
| 1.4.0 | 2025-06-14 | 🎨 UI体验优化版本 Toast通知系统：浮动通知避免界面布局跳动 可折叠界面：导入数据区域支持折叠，界面更简洁 智能滚动条：自动隐藏滚动条，视觉更干净 柔和设计：降低对比度，提供舒适的视觉体验 无头模式优化：暂时禁用有问题的功能，保留完整恢复方案 |
| 1.3.0 | 2025-06-13 | 🔐 长效Token管理版本 长效Token功能：支持获取60天有效期的深度Token 混合架构：background.js + popup.js协同处理Token获取 自动升级：客户端Token自动转换为长效Token 浏览器模式：支持用户手动确认授权 文档优化：重新整理文档结构，删除重复内容 |
| 1.2.0 | 2025-06-13 | 🚀 重大重构与优化版本 代码重构：将1000+行代码重构为12个功能模块 错误处理优化：实现智能错误分类和用户友好提示 数据库处理增强：完善连接失败处理和文件权限检查 Chrome兼容性：解决__pycache__导致的扩展加载问题 测试管理：智能测试管理器和独立测试环境 用户体验：加载状态管理和响应式UI反馈 |
| 1.1.0 | 2025-06-12 | 1) 修复CSP违规，移除内联事件处理器 2) manifest.json 新增 cursor.com / *.cursor.com Host 权限 3) 新增智能 Cookie 恢复按钮，自动从 storage 或原生主机获取 token 并重写 Cookie 4) 移除调试按钮，界面更简洁 |
| 1.0.0 | 2025-06-10 | 初始版本，支持自动读取、文件上传、手动输入及多账户管理 |
本项目采用 MIT 许可证 - 查看 LICENSE 文件了解详情
- 感谢 Cursor 提供优秀的AI编程工具
- 感谢所有贡献者和用户的支持