# CursorUsageNotify

**Repository Path**: DLarpx/CursorUsageNotify

## Basic Information

- **Project Name**: CursorUsageNotify
- **Description**: Cursor用量通知小程序
- **Primary Language**: C#
- **License**: MIT
- **Default Branch**: master
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 1
- **Forks**: 0
- **Created**: 2026-07-06
- **Last Updated**: 2026-07-28

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# CursorUsageNotify — AI 用量监控桌面应用

[中文](README.md) | [English](README.en.md)

Windows 桌面应用，同时监控 **Cursor** 与 **DeepSeek** 两个平台的用量：定时拉取、本地 SQLite 存储、双列数据大屏、系统托盘与 Toast 通知。

## 文档入口

- [用户使用说明](docs/用户使用说明.md) — 面向一般用户，安装、配置、日常使用
- [开发说明](docs/开发说明.md) — 面向二次开发者，构建、架构、测试、扩展

## 能做什么

- 双平台数据大屏：Cursor（订阅周期、Token、费用）+ DeepSeek（余额、消费、按 Key×模型明细）
- 后台定时同步，Cursor 增量 + DeepSeek 全量窗口拉取
- 系统托盘常驻，最小化驻留，右键开始/暂停/退出
- 分平台通知开关，定时 Toast 用量提醒
- 历史事件查询，按平台/时间/模型筛选，CSV 导出
- 凭证 DPAPI 加密本地存储，Cookie 过期预警

## 程序怎样工作

1. 在设置页填入 Cursor Cookie 和/或 DeepSeek userToken，测试连接
2. 程序后台定时拉取用量数据，存入本地 SQLite，大屏自动刷新
3. 最小化后驻留系统托盘，到点弹通知提醒查看用量

## 快速开始

- Windows 10（10.0.18362+）或更高
- .NET 10 SDK（构建/运行）
- Cursor 账号（Cookie）和/或 DeepSeek 开放平台账号（userToken）

```bash
git clone <repo-url>
cd CursorUsageNotify

dotnet build src/CursorUsageNotify.GUI/CursorUsageNotify.GUI.csproj
dotnet run --project src/CursorUsageNotify.GUI/CursorUsageNotify.GUI.csproj
```

测试：

```bash
dotnet test src/CursorUsageNotify.Tests/CursorUsageNotify.Tests.csproj
```

## 项目说明

| 项 | 说明 |
|---|---|
| 框架 | .NET 10 (Windows) |
| UI | Avalonia / Fluent Theme |
| MVVM | CommunityToolkit.Mvvm |
| ORM | SqlSugarCore + SQLite |
| 日志 | Serilog |
| 安全 | Windows DPAPI |
| 通知 | CommunityToolkit.WinUI.Notifications |
| 测试 | xUnit |

目录骨架：`src/`（业务工程）· `docs/`（文档）· `.vscode/`（调试配置）

命名空间前缀：`Larpx.PersonalTools.CursorUsageNotify`

## 许可证

[MIT](LICENSE)