Releases: devilcoolyue/cursor-panel
Release list
Cursor Panel v0.0.6
v0.0.6 版本归档
v0.0.6 让客户端默认定期查询本地额度，并让客户端和新版 Web 自动同步账号卡片，减少手动刷新的操作。Python、Web、桌面及随包后台统一为 0.0.6；API 主版本保持 1，数据库 schema 保持 0004_retention。
更新内容
- 默认查询本地额度：客户端运行时自动依次查询本地账号，启动及休眠恢复后错峰执行，每轮完成后等待约 15 分钟。“关闭窗口后驻留托盘”只控制关窗后是否继续运行；关闭该开关不会停止窗口开启期间的自动查询。单个账号失败后保留旧快照并继续处理后续账号。
- 自动同步账号列表：客户端和新版 Web 默认每 10 秒读取最新快照。顶部刷新按钮提供“立即刷新列表”及 10 秒、30 秒、1 分钟的间隔选择，并在当前设备保存设置。页面隐藏时暂停，返回时立即更新，保留搜索、标签和已打开的弹窗。列表同步不会额外批量请求 Cursor；客户端后台取数完成后也会同步最新卡片。
- 保留额度上限：额度触顶后保留本账号同套餐、同账期的历史上限，重新授权同一账号时也继续保留。可见同套餐账号只要某个档位有有效观测，就可补齐对应缺项，综合上限不再因分池缺失而被忽略。
- 补填旧版参考金额：账号管理者可在“编辑资料与标签 → 额度上限参考值”补填已经丢失的历史金额。参考值仅补齐本账号本账期缺失的上限，明确标注来源，不改变上游百分比、最后成功查询时间，也不会用于推算其他账号。账期或套餐变化后失效；可清空以移除。
- 发布恢复修复：创建 GitHub 草稿后直接使用返回的 Release ID，避免列表短暂延迟导致发布流程误判；保留原有附件摘要校验和恢复机制。
安装与升级
GitHub Release v0.0.6 提供 macOS Apple Silicon / Intel、Windows x64、Linux amd64 服务端、Python wheel、源码、校验文件和签名更新产物。
- 已安装的客户端可在“关于与更新”检查更新，或完全退出后使用完整安装包升级。
- 本次不改变应用标识、数据目录、系统凭证库及更新签名密钥，不新增数据库迁移。已有账号和托盘偏好保留。
- Linux 服务端按既有更新流程升级。列表自动同步只读取服务端已保存的快照；Linux 服务目前仍无周期额度查询，立即查询使用单账号刷新。
- 额度参考值为估算辅助信息，不能替代官方账单；已经丢失且没有有效来源的上限不会凭空恢复。
验证
固定发布流程执行完整后端回归、三种桌面架构的页面与系统验证、安装后启动检查、Linux 镜像与 wheel 验证、更新签名及附件校验。新增回归覆盖刷新周期与托盘偏好解耦、列表间隔和持久化、耗尽账号的历史与参考值、权限限制及账期变化失效。
验证记录：https://github.com/devilcoolyue/cursor-panel/actions/runs/34770434912
Cursor Panel v0.0.5
v0.0.5 版本归档
v0.0.5 统一 Cursor Panel 的项目名称与仓库地址，并保留已安装客户端的自动更新兼容。Python、Web、桌面及随包后台统一为 0.0.5；API 主版本保持 1，数据库 schema 保持 0004_retention。
更新内容
- 统一项目名称与链接：仓库更名为
devilcoolyue/cursor-panel，同步 README、发行记录、问题反馈、API 标题、镜像来源与发布工具，增加 Star 趋势图。历史提交与 Release 继续保留，旧仓库链接自动跳转。 - 兼容旧版更新：桌面与服务器更新器接受新旧两个固定仓库的同版本附件。签名更新清单继续使用旧下载路径，让停留在 v0.0.2–v0.0.4 的用户仍可检查并安装新版；即使跳过中间版本也保留这一兼容。
- 统一发布流程：使用一套工作流完成测试、各平台构建、实际安装启动验证、更新签名和发布。Windows 手动安装包与更新包来自同一个安装器；上传中断按 Release ID 与文件摘要恢复，拒绝覆盖已经公开的版本。
- 更新发行附件命名：新的源码与验证附件使用
cursor-panel-v0.0.5-*。Python wheel 保留cursor_dashboard包名，以兼容现有安装与导入方式。
安装与升级
GitHub Release v0.0.5 提供 macOS Apple Silicon / Intel、Windows x64、Linux amd64 服务端、Python wheel、源码、校验文件和签名更新产物。
- v0.0.2–v0.0.4 客户端：在“关于与更新”中检查更新，发现新版后点击“一键升级并重启”。自动检查只提醒，不自动安装。
- v0.0.1 或无法正常启动的客户端：完全退出应用，使用完整安装程序安装到原位置，保留原应用数据目录与系统凭证库条目。
- 数据与密钥：本次不改变应用标识、数据目录、系统凭证库标识及更新签名密钥，也不新增数据库迁移。已有服务安装路径无需因仓库更名而移动。
- 服务端：通过已配置的宿主机更新服务或既有手动更新流程升级。宿主机 updater 代码与依赖仍需按自动升级说明单独更新；从更早版本升级时遵循相应历史版本说明。
验证与边界
正式发布由固定工作流执行三平台回归、页面流程、源码与冻结后台验证、安装后冷/热启动及异常退出清理、镜像与 wheel 验证、更新签名及全部附件校验。发布完成后核对新旧仓库地址下的公开更新清单；最终运行链接与各平台结果随验证附件提供。
测试使用临时数据库和合成账号，安装启动及更新清单验证不等于所有真实设备的跨版本安装验收。桌面仍无 Apple Developer ID 签名/公证或 Windows Authenticode；更新包签名用于验证更新来源。真实远程 Cursor 切换继续关闭。
验证记录：https://github.com/devilcoolyue/cursor-panel/actions/runs/34763323029
Cursor Panel v0.0.4
v0.0.4 修复桌面后台启动失败时的二次崩溃、错误信息丢失和重试恢复问题。已安装启动修复测试包的用户，也可以从应用内显示的 0.0.3 升级到本次正式编号 0.0.4。
更新内容
- 后台初始化失败时正常退出，避免 Python 在退出时再次崩溃并掩盖原始错误。
- 启动页显示脱敏错误分类、异常类型和系统错误码，帮助区分目录权限、数据占用、依赖加载及本地监听失败。
- 保存最近一次启动日志，包含版本、构建提交、阶段与脱敏错误。
- “重试连接”会重新启动已退出的后台；恢复成功后加载本地账号并进入主界面。
- 修复 Windows 粗粒度时钟下的出站节流：提前唤醒后继续等待，避免过早或集中放行请求。
- macOS、Windows、Web 和 Python 包统一到 0.0.4。API 版本仍为 1，数据库 schema 仍为 0004_retention，本次不增加数据库迁移。
下载
| 平台 | 安装包 |
|---|---|
| Windows x64 | Windows 安装程序 |
| macOS Apple Silicon | arm64 DMG |
| macOS Intel | x64 DMG |
| Linux amd64 服务端 | cursor-panel-linux-amd64.tar |
| Python API / CLI + Web | cursor_dashboard-0.0.4-py3-none-any.whl |
下方提供源码、验证记录、SHA256SUMS、桌面签名更新包和服务器更新清单。
如何更新
- 能正常打开的 v0.0.2 / v0.0.3 客户端：进入“关于与更新”，检查并安装更新。自动检查只提示，不自动安装。
- 旧客户端仍提示后台不可用：完全退出 Cursor Panel，下载对应平台完整安装程序，手动安装到原位置。保留原应用数据目录和系统凭证库条目。
- 已安装启动修复测试包：应用内版本仍显示 0.0.3，可统一更新到 0.0.4。
- 服务端从 v0.0.3 更新不增加数据库迁移；从 v0.0.2 或更早版本更新仍需遵循 v0.0.3 升级说明。
如果仍然无法启动，请在点击重试前保存完整错误截图及启动日志：
- Windows：
%LOCALAPPDATA%\dev.cursor-panel.desktop\logs\startup.json - macOS：
~/Library/Logs/dev.cursor-panel.desktop/startup.json
每次启动或重试会覆盖上一条启动记录。
English summary
This release fixes secondary Python crashes during desktop startup failure, preserves safe startup diagnostics, restarts an exited backend when retrying, and restores account loading after recovery. Existing clients can update through About & Updates; clients whose backend cannot start should install the complete package manually. Outbound pacing also waits through early timer wakeups on Windows. No new database migration is introduced compared with v0.0.3.
验证与范围
本次发布从提交 e05324cc79765c93391ca36f983c3ea98feeea0f 重新构建，以下四组流水线全部通过：
每个平台运行 348 项完整 Python 回归：两个 macOS 平台全部通过，Windows 340 通过、8 跳过。新增的提前唤醒计时用例和原请求间隔用例均通过；安装日志与正常/异常退出清理均通过。
较早的草稿候选暴露了 Windows 计时失败，修复后已重新构建全部发布附件。最终验证记录、候选来源清单、六组安装测试报告和本地校验结果随验证压缩包提供。
更新签名用于验证包来源，桌面应用仍没有 Apple Developer ID 签名/公证或 Windows Authenticode。真实远程 Cursor 切换继续关闭；Linux 原生桌面与 Windows arm64 不在支持范围。
Cursor Panel v0.0.3
Highlights
Cursor Panel v0.0.3 improves long-running storage behavior, reverse-proxy security, update recovery, and mobile navigation.
- Bounded audit retention: 90 days and 100,000 events by default, with incremental cleanup of expired sessions, invitations, device authorizations, and switch tickets.
- Safer maintenance: schema 0004_retention adds audit indexes, while cursor-core maintain --compact provides locked offline SQLite compaction.
- Bounded recovery storage: account-switch backups, schema-upgrade backups, desktop update backups, and server update recovery resources now have explicit count and byte budgets.
- Trusted proxy boundary: explicit IP/CIDR allowlists, a fixed Caddy address, spoof-resistant X-Forwarded-For handling, and per-client login throttling behind the standard proxy.
- Operational limits: Docker logs rotate at 10 MiB with five files for panel, maintenance, and proxy services.
- Better mobile navigation: a focused slide-out drawer with backdrop, scroll locking, Escape handling, focus trapping/restoration, and reduced-motion support.
- Dependency maintenance: cryptography 50.0.1 on Windows, Linux, and macOS arm64; macOS Intel retains the verified 46.0.7 universal2 wheel for frozen-sidecar compatibility.
更新内容
- 审计记录默认保留 90 天且最多 100,000 条，并分批清理过期会话、邀请、设备授权和切换票据。
- 数据库升级到 0004_retention，新增审计索引；cursor-core maintain --compact 可在持有目录锁时离线压缩 SQLite。
- 账号切换、schema 升级、桌面更新和服务端自动升级恢复点均增加份数与空间预算，并保护当前恢复来源。
- 反向代理只信任明确 IP/CIDR；标准 Compose 固定 Caddy 地址并覆盖来源头，避免伪造限流身份。
- panel、maintenance、proxy 的 Docker 日志限制为单份 10 MiB、最多 5 份。
- 移动端侧栏改为带遮罩的抽屉，支持背景滚动锁定、Escape、焦点循环/恢复和减少动态效果。
- Windows、Linux 与 macOS arm64 使用 cryptography 50.0.1；macOS Intel 为保证冻结 sidecar 可运行，使用已验证的 46.0.7 universal2 wheel。
Downloads / 下载
| Platform / 平台 | Package / 安装包 |
|---|---|
| macOS Apple Silicon | Cursor.Panel_0.0.3_aarch64.dmg |
| macOS Intel | Cursor.Panel_0.0.3_x64.dmg |
| Windows x64 | Cursor.Panel_0.0.3_x64-setup.exe |
| Linux amd64 server | cursor-panel-linux-amd64.tar |
| Python API / CLI + Web | cursor_dashboard-0.0.3-py3-none-any.whl |
Source archives, verification records, SHA256SUMS, and signed updater assets are attached below. / 下方同时提供源码、验证记录、校验文件及签名更新产物。
Upgrade notes / 升级说明
Back up the database and matching encryption key before a server upgrade. v0.0.3 upgrades the database from 0003_devices to 0004_retention; do not open the upgraded database with v0.0.2 and do not run an Alembic downgrade. Existing Compose deployments should check that the default 172.30.87.0/24 network does not conflict before recreating containers.
服务端升级前请备份数据库及匹配主密钥。v0.0.3 会把数据库从 0003_devices 升到 0004_retention；不要用 v0.0.2 打开升级后的数据库，也不要执行 Alembic downgrade。已有 Compose 部署在重建容器前，应先确认默认 172.30.87.0/24 网段没有冲突。
Desktop users on v0.0.2 can install this release through About & Updates after signed updater assets are published. The preview apps still lack Apple Developer ID signing/notarization and Windows Authenticode; updater signatures authenticate the update but do not replace publisher signing.
v0.0.2 桌面用户可在签名更新附件发布后通过“关于与更新”安装。预览应用仍没有 Apple Developer ID 签名/公证或 Windows Authenticode；更新签名用于验证更新来源，不能代替操作系统发行者签名。
Remote desktop switching remains disabled. Linux native desktop and Windows arm64 remain outside the supported scope.
完整记录：v0.0.3 archive · Compare with v0.0.2
Validation / 验证
All release checks target commit cc3be4a:
Local release checks passed: 347 Python tests (10 PowerShell-only checks skipped on macOS), 6 desktop sidecar tests, 4 Rust tests, frontend type/build checks, and Web/Desktop/Connected/Startup/Card/Update browser flows on Chromium and WebKit.
Cursor Panel v0.0.2
Highlights
Cursor Panel v0.0.2 improves first launch, account visibility, local Cursor discovery, and updates.
- New onboarding and help: six-step desktop introduction, 14 searchable offline help modules, and English / Chinese README editions with downloads and screenshots.
- Refreshed interface: unified app icons, startup status and retry, clearer login / invitation / connection screens, and 12 configurable account-card fields with compact and default presets.
- macOS bundle integrity: ad-hoc signing and strict bundle verification; Apple Developer ID signing and notarization are still pending.
- Smoother interactions: consistent keyboard focus, fixed tooltip reopening after dialogs close, and animated Help / Display Preferences arrows that respect reduced motion.
- Better quota context: reuse valid observations from the same account and billing cycle when a limit cannot be inferred from the latest response; show estimate sources and unknown limits explicitly.
- More flexible Cursor discovery: Windows process, PATH, registry, and shortcut detection; validated custom executable and data directories, portable installations, and detection without restarting the panel.
- Update support: version badge, four-hour checks, signed desktop updates with backup / restart, and an optional Linux amd64 host updater with data-copy migration and rollback.
更新内容
- 新增六步新手指引、14 个可搜索的离线帮助模块，以及默认英文、可切换中文的 README。
- 统一品牌图标、启动等待与失败重试，优化登录、邀请和实例连接；账号卡片支持 12 项显示设置及精简预设。
- macOS 打包新增 ad-hoc 本地签名与严格完整性校验，仍未进行 Apple Developer ID 签名和公证。
- 修复弹窗关闭后提示浮层重新出现、鼠标与键盘焦点不一致；帮助与显示偏好箭头新增平滑旋转。
- 额度触顶或观测不足时，按条件使用同账号同账期有效历史上限补齐，明确显示估算来源与未知值。
- 扩展 Windows Cursor 安装路径发现，支持自定义程序 / 数据目录、便携安装及重新检测。
- 新增版本徽标、定时检查、签名客户端更新，以及可选的 Linux amd64 服务端备份升级与失败回退。
Downloads / 下载
| Platform / 平台 | Package / 安装包 |
|---|---|
| macOS Apple Silicon | Cursor.Panel_0.0.2_aarch64.dmg |
| macOS Intel | Cursor.Panel_0.0.2_x64.dmg |
| Windows x64 | Cursor.Panel_0.0.2_x64-setup.exe |
| Linux amd64 server | cursor-panel-linux-amd64.tar |
| Python API / CLI + Web | cursor_dashboard-0.0.2-py3-none-any.whl |
Source archives, verification records, SHA256SUMS, and signed updater assets are attached below. / 下方同时提供源码、验证记录、校验文件及签名更新产物。
Upgrade notes / 升级说明
From v0.0.1: Back up first and install v0.0.2 manually once. v0.0.1 does not contain this updater; the new update flow applies after installing v0.0.2. Server installations must retain the matching encryption key and follow the stop / backup / upgrade / verify procedure. API major 1 and schema 0003_devices are unchanged.
从 v0.0.1 升级： 先备份，再手动安装一次 v0.0.2。旧版本未内置本次更新器，安装 v0.0.2 后才能用于后续版本。服务器按停止服务、备份数据库和匹配密钥、升级并校验的步骤操作。API 主版本和数据库 schema 不变。
macOS “damaged” / 无法打开： These preview apps do not have Apple Developer ID signing or notarization. Verify the download and copy the app to Applications. If Gatekeeper still reports it as damaged, use the English instructions / 中文处理步骤. The documented xattr command only removes quarantine from Cursor Panel; updater signatures do not replace Apple code signing.
Desktop packages remain on the v2-preview channel without publisher signing / notarization. Remote desktop switching is disabled. Linux native desktop and Windows arm64 are outside current support. Tests use synthetic accounts and isolated applications; they do not establish real multi-device Cursor session compatibility.
桌面仍为未发行者签名 / 公证的预览版本，真实远程切换保持关闭。Linux 原生桌面和 Windows arm64 暂不支持。测试使用模拟账号与隔离应用，不代表真实多设备 Cursor 会话已获验证。
Full details / 完整记录：v0.0.2 · Compare with v0.0.1
Validation / 验证
All checks passed for 0572137479bab38522c967230a6cf8e9b318f355 / 以下检查均基于本次标签提交并已通过：
Core regression: 333 tests; local macOS skips 10 PowerShell-only checks, Windows skips 8 checks for other platforms. Installer startup, crash cleanup, Rust routes, update signatures, and browser flows are covered in the attached verification archive.
Cursor Panel v0.0.1
Cursor Panel 首个 v0.0.1 版本，将 P0–P6 与最新侧栏导航阶段合并至 main，统一提供 Web、Python/CLI 与 macOS/Windows 独立客户端。
- 支持个人与团队空间、账号授权、额度快照、模型明细与权限管理。
- 新增侧栏导航、标签筛选、账号卡片、分区设置、六种皮肤和移动布局。
- 提供 Web 一次性切换短命令、本地桌面切换、远程实例连接及可撤销设备会话。
- 包含加密凭证、离线备份恢复和桌面加密归档。
| 下载文件 | 平台 / 用途 |
|---|---|
Cursor.Panel_0.0.1_aarch64.dmg |
macOS Apple Silicon |
Cursor.Panel_0.0.1_x64.dmg |
macOS Intel |
Cursor.Panel_0.0.1_x64-setup.exe |
Windows x64 安装器 |
cursor_dashboard-0.0.1-py3-none-any.whl |
Python API/CLI，内含已构建 Web 界面 |
cursor-panel-linux-amd64.tar |
Linux amd64 服务端镜像，使用 docker load --input 导入 |
cursor-dashboard-v0.0.1-source.zip / .tar.gz |
本版完整源码与依赖锁 |
cursor-dashboard-v0.0.1-verification.zip |
构建清单、安装探测、验证记录和文件名映射 |
SHA256SUMS / LICENSE |
全部附件校验和与 MIT 许可 |
源码提交：0b0575cc11dfe44cbc44534e4b018dd5581cb67d。所有客户端与服务端附件均从该提交重新构建，源码 ZIP/tar.gz 已逐文件比对 Git 内容。下载后可在附件目录执行 shasum -a 256 -c SHA256SUMS，Windows 使用 Get-FileHash -Algorithm SHA256 对照校验。
验证记录：客户端/服务端构建与恢复；三平台 Web、本地桌面及远程连接页面流程。本机完整 300 项测试全部通过（包含 PowerShell）；CI 各平台实际执行与跳过项目见记录。
桌面安装包尚无发行者签名或 macOS 公证，属于早期版本，清单通道为 v2-preview。真实远程 Cursor 切换仍关闭，Linux 原生桌面与 Windows arm64 不在本版范围。API 主版本为 1，数据库 schema 为 0003_devices。
此前开发候选沿用 1.4.0，本次按新发布序列统一为 0.0.1。已安装开发候选的用户请先退出并备份数据、匹配密钥和旧安装包，再按手动更新与回退说明安装；不执行数据库降级。完整版本内容见归档说明，旧版基线保留于 legacy 分支。