一只住在你桌面上的小狗，提醒你休息、喝水、保持专注。
PawPal 是一个桌面宠物应用，支持 macOS 和 Windows。一只透明、始终置顶的小狗会陪在你的屏幕上，在你久坐、忘记喝水或者分心刷社交媒体时，温柔地把你带回节奏里。
- 休息提醒 — 定时提醒你站起来活动一下，小狗会跑过整个屏幕引起你的注意
- 喝水提醒 — 别忘了喝水
- 专注模式 — 检测你当前在用的 app，如果你在刷社交媒体，小狗会来提醒你回去工作
- 多种宠物外观 — 目前有线条小狗和金毛 puppy 两种风格
- 中文 / English — 支持中英文切换
- 本地优先 — 设置和统计数据保存在本地；只有手动检查更新或开启启动时检查更新时才会访问 GitHub Releases
从 Releases 页面下载对应平台的安装包：
macOS：首次打开时可能提示"无法验证开发者"，请在 系统设置 → 隐私与安全性 中允许打开。专注模式的分心检测需要授予 Accessibility 权限。
Windows：分心检测功能暂不可用（目前仅支持 macOS），其他功能正常。
需要 Node.js 24+ 和 pnpm 11。推荐通过 Corepack 启用 pnpm（版本以 package.json 的 packageManager 为准）：
corepack enable
git clone https://github.com/zebangeth/PawPal.git
cd PawPal
pnpm install
pnpm dev如果 corepack enable 没有权限，请用其他方式安装 pnpm 11，并确认 pnpm --version 可以正常运行。
pnpm test # 运行纯逻辑测试
pnpm build # 编译（含类型检查）
pnpm dist # 编译 + 打包 macOS 和 Windows
pnpm dist:mac # 仅打包 macOS
pnpm dist:win # 仅打包 Windows（需要 Wine 或在 Windows 上运行）本地打包时请确保
pnpm命令可以在 shell 中直接运行；electron-builder 会用它收集依赖。
- Electron + electron-vite
- React 19 + TypeScript
- electron-store（本地持久化）
- electron-builder（打包分发）
src/main/ 主进程：窗口管理、托盘菜单、定时器、持久化、专注检测、更新检查
src/preload/ IPC 桥接层
src/renderer/ React UI（宠物窗口 + 设置窗口）
src/shared/ 共享类型、默认配置、i18n、宠物外观定义
tests/ 纯逻辑测试
pet_assets/ 宠物动画素材（GIF）
- 更多宠物外观
- 声音效果
- Windows 分心检测
- 多显示器适配优化
源代码基于 MIT License。宠物动画素材有独立的授权说明，详见 ASSET_LICENSE.md。
A tiny desktop dog that helps you pause before you burn out.
PawPal is a desktop pet app for macOS and Windows. A transparent, always-on-top dog lives on your screen and gently reminds you to take breaks, drink water, and stay focused.
- Break reminders — timed nudges to get up and move; the dog runs across your screen to get your attention
- Hydration reminders — don't forget to drink water
- Focus mode — detects what app you're using; if you're on social media, the dog will nudge you back to work
- Multiple pet styles — line-drawing dog and golden retriever puppy
- Chinese / English UI
- Local-first data — settings and stats stay on your machine; PawPal only contacts GitHub Releases when you manually check for updates or opt in to launch-time checks
Download the latest installer from Releases (.dmg for macOS, .exe for Windows), or run from source:
corepack enable
git clone https://github.com/zebangeth/PawPal.git
cd PawPal
pnpm install
pnpm devSource builds require Node.js 24+ and pnpm 11 (see packageManager in package.json). Make sure the pnpm command is available in your shell before packaging, because electron-builder uses it while collecting dependencies.
If corepack enable does not have permission to install shims, install pnpm 11 another way and verify that pnpm --version works.
Common commands:
pnpm test
pnpm build
pnpm distSource code under MIT License. Pet animation assets have separate licensing; see ASSET_LICENSE.md.