cfc/cfc-desktop-pet

浠艾福桌面宠物 (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. 重启应用，设置中选择形象

开发

# 构建
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）不受影响。