# usage-pet

**Repository Path**: cotx/usage-pet

## Basic Information

- **Project Name**: usage-pet
- **Description**: No description available
- **Primary Language**: Unknown
- **License**: MIT
- **Default Branch**: main
- **Homepage**: None
- **GVP Project**: No

## Statistics

- **Stars**: 0
- **Forks**: 0
- **Created**: 2026-09-24
- **Last Updated**: 2026-09-24

## Categories & Tags

**Categories**: Uncategorized

**Tags**: None

## README

# Usage Pet

C++/Win32 桌面桌宠：置顶小窗监控 **MiMo Token 用量**、**DeepSeek 余额** 与 **智谱余额**。

- 无边框、可拖动（系统原生拖拽）；**置顶可开关，默认关**
- 首页键值展示：`MiMo` 用量 / `DeepSeek` 金额 / `智谱` 金额（分色）
- 双击展开配置面板（Cookie、API Key、智谱 Authorization、刷新间隔）
- Cookie / Key 本地加密存储
- 图片与图标内嵌资源，单 exe 可运行
- 贴图支持 **PNG** 与 **GIF**（多帧自动播放）

## 功能

| 操作 | 说明 |
|------|------|
| 拖动空白/宠物 | 移动窗口 |
| 双击空白/宠物 | 展开 / 收起详情与配置 |
| 「保存并刷新」 | 写入配置并拉取数据 |
| 「窗口置顶」 | 切换置顶（默认关） |
| 「退出」 | 关闭程序 |
| Ctrl+A / C / X / V | 全选 / 复制 / 剪切 / 粘贴 |

首页仅显示**已配置**的数据项。

## 构建

需要 **Visual Studio**（C++ 桌面开发工作负载）。

### Visual Studio

1. 打开 `usage-pet-c.sln`
2. 选择 **Release | x64**
3. 生成（Ctrl+Shift+B）
4. 运行 `bin\x64\Release\usage-pet-c.exe`

### 命令行

```bat
msbuild usage-pet-c.sln /p:Configuration=Release /p:Platform=x64
```

## 配置

路径：`%USERPROFILE%\.usage-pet\config.json`

| 字段 | 说明 |
|------|------|
| `cookies` | MiMo Cookie（登录 platform.xiaomimimo.com 后从 F12 → Network 复制） |
| `deepseekApiKey` | DeepSeek API Key |
| `zhipuAuth` | 智谱 Authorization（Token，或完整的 `Bearer …`） |
| `refreshIntervalSec` | 刷新间隔（秒） |
| `alwaysOnTop` | 是否置顶（默认 `false`） |
| `x` / `y` | 窗口位置 |

Cookie 与 API Key 加密存储，请勿把配置文件提交到仓库。

## 数据源

- MiMo：`GET https://platform.xiaomimimo.com/api/v1/tokenPlan/usage`
- DeepSeek：`GET https://api.deepseek.com/user/balance`（[文档](https://api-docs.deepseek.com/zh-cn/api/get-user-balance)）
- 智谱：`GET https://bigmodel.cn/api/biz/account/query-customer-account-report`（请求头 `authorization`）

## 目录结构

```
src/           源码（窗口 / 绘制 / API / 配置）
assets/        图标与桌宠贴图（编译进 exe）
usage-pet-c.sln
usage-pet-c.vcxproj
usage-pet-c.rc
```

贴图：`assets/pet-prototype.png` 为内嵌资源（内容也可换成 GIF）。开发时若存在 `assets/pet.gif` 会优先从文件加载。

## License

[MIT](./LICENSE)