# 浠艾福桌面宠物 (XafPet.Desktop)

Windows 桌面宠物应用，实时反映 CFC 健康陪跑状态。

## 功能

- 显示今日任务进度 / 五维能量 / 健康打卡状态
- 喝水提醒互动（点击宠物确认打卡）
- 支持浠宝/福宝及自定义形象（PNG + pet-config.json）
- 支持用户自定义状态（custom_state_1 ~ custom_state_10）
- 托盘常驻，最小化到托盘，双击唤出

## 使用

1. 发布：`dotnet publish src/XafPet.Desktop/XafPet.Desktop.csproj -c Release -r win-x64`
2. 运行 `XafPet.Desktop.exe`
3. 首次启动 → 右键托盘图标 → 设置 → 填入后端地址 + JWT Token
4. 宠物出现在桌面右下角，可拖拽移动

## 自定义宠物

1. 在 `%APPDATA%\XafPet\pets\<名称>\` 放置 `standing.png` + `pet-config.json`
2. 重启应用，设置中选择形象

## 开发

```bash
# 构建
dotnet build XafPet.Desktop.sln

# 测试（需 Windows 机器，.NET 6 SDK）
dotnet test tests/XafPet.Desktop.Tests -v
```

## 环境要求

- Windows 10 (1803+) / Windows 11
- .NET 6 Runtime（发布时 Self-Contained，自带 WebView2 Runtime）
- CFC 后端（localhost:9082）可选，不连接后端时宠物保持 idle 状态

---
> **注意：** 本项目仅在 Windows 上构建/运行。本代码仓库的其他模块（cfc-backend/cfc-web/cfc-frontend）不受影响。