# 浠艾福桌面宠物 (XafPet)

Windows / macOS 桌面宠物应用（Tauri v2 + Rust），实时反映 CFC 健康陪跑状态。

## 功能

- 显示今日任务进度 / 五维能量 / 健康打卡状态
- 喝水提醒互动（点击宠物确认打卡）；点击任务提醒可直接完成任务
- 支持浠宝 / 福宝及自定义形象（PNG + `pet-config.json`，支持动作帧序列）
- 微信扫码登录（网站应用 `snsapi_login`，与小程序账号 unionid SSO）
- 托盘常驻，右键菜单（设置 / 鼠标穿透 / 退出）

## 技术栈

- 前端：静态 HTML/JS（`src/`），经 Tauri `frontendDist` 打包（`src-tauri/tauri.conf.json`）
- 后端逻辑：Rust + Tauri v2（`src-tauri/`）

## 构建 / 运行

```bash
cd cfc-desktop-pet/src-tauri
cargo tauri build          # 打包发行版
cargo tauri dev            # 本地调试
```

## 测试

```bash
cd cfc-desktop-pet/src-tauri
cargo test
```

## 自定义宠物

内置形象位于 `src/DefaultPets/{xibao,fubao}/`（`standing.png` + `pet-config.json`）。
也可在「设置」页上传自定义形象。

`pet-config.json` 支持 provider 无关的动作帧序列（`animations`）：

```json
{
  "actions": { "happy": "cheer" },
  "animations": {
    "cheer": { "frames": ["cheer_01.png", "cheer_02.png"], "fps": 15, "loop": false }
  }
}
```

`frames[]` 为逐帧图片（相对 `image_base_url` 或绝对 URL）；`loop:false` 时播完回到基础形象；未配置 `animations` 时回退为 CSS 动画。

## 环境要求

- Rust stable + Tauri CLI v2（`cargo install tauri-cli --version "^2"`）
- Windows：WebView2 Runtime（Win 11 自带）+ Visual Studio Build Tools（MSVC）
- CFC 后端（默认 `https://cfc.cf-club.com`）

## CI

`.github/workflows/release.yml`：推送 `desktop-pet-v*` tag 触发，构建 Windows + macOS 产物。

---
> **注意：** 本项目为旧版 WPF（`XafPet.Desktop`）的 Tauri 重写。WPF 实现已移除。