cfc/cfc-desktop-pet

浠艾福桌面宠物 (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/）

构建 / 运行

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

测试

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

自定义宠物

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

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

{
  "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 实现已移除。