Cursor Balance 插件

在 Cursor 编辑器底部状态栏实时显示 Auto + Composer 和 API 使用余额百分比，点击可查看详细面板。

功能

• 🔵 状态栏实时显示 Auto 和 API 使用百分比
• 📊 点击查看详情 包含进度条、用量数字、原始数据
• 🔄 自动刷新 默认每 5 分钟
• 🔑 自动读取 Token 从 Cursor 本地 state.vscdb 和 sentry 文件读取
• 🌐 多接口兜底 优先 Connect RPC Bearer 认证，失败后回退 Dashboard / Usage Summary / Legacy
• 🔄 Token 自动刷新 Access Token 过期时自动用 refreshToken 续期

安装

方法 1：直接加载（开发模式）

1. 按 Ctrl+Shift+P 打开命令面板
2. 输入 Developer: Install Extension from Location...
3. 选择此目录：

   c:\Users\Administrator\Desktop\work-space\quanguocheng\cursor_balance
   

方法 2：打包后安装

# 全局安装 vsce（如果没装过）
npm install -g @vscode/vsce

# 在插件目录打包
cd cursor_balance
vsce package --allow-missing-repository

# 安装生成的 .vsix 文件
# Ctrl+Shift+P → Extensions: Install from VSIX...

配置项

在 Cursor 设置中搜索 cursorBalance：

Token 获取方式

插件会自动从以下位置读取（通常无需手动配置）：

• Windows: %APPDATA%\Cursor\User\globalStorage\state.vscdb
• Windows: %APPDATA%\Cursor\sentry\scope_v3.json
• Windows: %APPDATA%\Cursor\sentry\session.json
• macOS: ~/Library/Application Support/Cursor/User/globalStorage/state.vscdb
• Linux: ~/.config/Cursor/User/globalStorage/state.vscdb

如果自动读取失败，手动获取方法：

1. 在浏览器登录 cursor.com
2. 打开开发者工具 (F12) → Application → Cookies
3. 复制 WorkosCursorSessionToken 的值
4. 粘贴到 Cursor 设置的 cursorBalance.token 中

也可以在命令面板执行：

Cursor Balance: 手动设置 Token

状态栏说明

• $(graph) Total:0.4% Auto:0.5% API:0.0% — 正常显示用量
• $(warning) Auto:95% API:100% — 用量接近上限（≥90%）
• $(warning) Cursor: 未登录 — 未找到 Token
• $(error) Cursor: 获取失败 — API 请求失败

命令