YierPet 一二桌宠

macOS 桌面上的「一二」——安装、运行与日常使用说明

仓库：gitee.com/cat_10/YierPet 系统：macOS 13 及以上 推荐：Release 压缩包，解压即用

0. 太长不看 · 两种安装方式

方法一：下载 Release 压缩包（推荐）

不用装 Git，不用编译，解压后打开即可。

  1. 打开 Release 页面

    gitee.com/cat_10/YierPet/releases

  2. 下载安装包

    下载最新版 YierPet-mac.zip。

  3. 解压并运行

    解压到任意文件夹（建议拖到「应用程序」），双击 YierPet.app。桌面上会出现「一二」。

若 macOS 提示「无法打开」或「来自身份不明的开发者」：在 Finder 中右键（或 Control+点按）YierPet.app → 打开 → 再点「打开」。详见Gatekeeper 说明。

方法二：Gitee 克隆源码自己编译

适合开发者或 Release 尚未更新时。需要先安装 Xcode Command Line Tools（不是完整 Xcode）：

  1. （首次）装编译工具

    若从没装过，先执行一次；已装过可跳过。

    xcode-select --install
  2. 克隆并构建

    整段复制粘贴到终端回车。

    git clone https://gitee.com/cat_10/YierPet.git
cd YierPet
./build.sh
  3. 启动桌宠
    open build/YierPet.app

    程序坞里没有图标是正常的。

国内若 GitHub 较慢，也可镜像克隆：git clone https://gh-proxy.com/https://github.com/xiaojieshi-bot/YierPet.git

日常只需记：
玩
拖动移动 · 单击打招呼 · 快速甩动可抛着玩
设置
在宠物身上右键（换形象、关提醒等）
退出
右键 → 退出（不要到程序坞找）

1. 方法一：Release 压缩包（详细）

  1. 打开 Gitee Releases；
  2. 下载 YierPet-mac.zip；
  3. 双击 zip 解压（或右键 →「解压缩」）；
  4. 将 YierPet.app 拖到「应用程序」或任意固定位置；
  5. 双击 YierPet.app 启动。
Release 包不需要安装 Xcode、Git 或任何第三方依赖，解压即可使用。

若首次打开被 macOS 拦截，请按下一节 Gatekeeper 操作「右键 → 打开」。

2. 方法二：克隆源码编译（详细）

开始之前

不需要从 App Store 安装完整版 Xcode，也没有第三方依赖包。

步骤

git clone https://gitee.com/cat_10/YierPet.git
cd YierPet
./build.sh
open build/YierPet.app

国内若 GitHub 较慢，可使用镜像：

git clone https://gh-proxy.com/https://github.com/xiaojieshi-bot/YierPet.git
命令作用
git clone …从 Gitee 下载项目源码
./build.sh编译并生成 build/YierPet.app
open build/YierPet.app启动桌宠

在本机自行构建的应用，一般不会出现 Gatekeeper 拦截。成功后桌面上会出现「一二」，程序坞里不会出现图标，这是正常现象。

3. 这是什么

YierPet（一二桌宠）是一只住在 macOS 桌面上的透明悬浮小宠物。 它会自己散步、跳跃、挥手；可以拖拽和「甩出去」玩物理抛掷； 还会在合适的时候用头顶气泡提醒你喝水、起身、别熬夜，并在 CPU 飙高时「红温」。

应用以无 Dock 图标的方式运行（不占程序坞位置）， 也不需要辅助功能、屏幕录制等敏感权限。

4. 无法打开？（Gatekeeper）

若你使用的是Release 压缩包或别人打包好的 .app（不是在本机执行 ./build.sh 构建的），macOS 可能提示「无法打开」或「来自身份不明的开发者」。

解决办法：

  1. 在 Finder 中找到 YierPet.app；
  2. 按住 Control 键并点击（或右键）应用图标；
  3. 选择「打开」；
  4. 在对话框中再次点「打开」。
在本仓库目录下自行 ./build.sh 构建的应用，一般不会出现此问题。

5. 开机自启（可选）

  1. 打开「系统设置」→「通用」→「登录项」（或「登录时打开的项目」）；
  2. 点击「+」或「添加」；
  3. 选中 YierPet.app（Release 解压版或 build/YierPet.app；建议放在「应用程序」等固定位置）；
  4. 确认添加。

下次登录 macOS 后，一二会自动出现在桌面。

6. 基本操作

操作效果
按住并拖动带着宠物移动；拖动时会播放跑步动画
快速甩动后松手抛掷：抛物线飞行、撞墙与落地反弹；摔得狠会生气
单击打招呼（经典版挥手；表情包版为开心/比心）
右键点击宠物打开设置菜单（见下一节）

8. 健康提醒与系统哨兵（概要）

健康提醒

类型大致触发条件
久坐提醒连续在电脑前活跃约 1 小时（离开 5 分钟会清零）
喝水提醒约每 30 分钟（人不在时不计时）
深夜关怀23 点后进入「睡意」；若仍在工作，约每 30 分钟关怀一次
摸鱼检测视频类 App 连续前台约 30 分钟（B 站、腾讯视频、IINA 等）

系统哨兵

平时不打扰，仅在异常时冒气泡，例如 CPU 持续偏高、内存压力 critical、低电量、磁盘空间不足等。CPU 红温时经典版会逐渐变红；「活力一二」表情包有全身着火动画。

任意两类提醒之间有约 90 秒 的全局间隔，避免连环刷屏。各项均可在菜单中单独关闭。

9. 陪伴模式

按一天中的节奏主动问候，适合想要「有人在旁边」的感觉：

项目触发说明
早晨问候6–10 点且在电脑前，每天一次
午饭提醒12 点且在电脑前，每天一次
下午咖啡15 点且在电脑前，每天一次
周五撒欢周五 17–19 点且在电脑前，每周一次
编码久战在 Xcode / VS Code / JetBrains 等 IDE 中连续约 2 小时

在「陪伴模式」子菜单中可逐项开关。

10. 四种形象

菜单名称说明
经典一二精灵图集，9 种动作可在菜单中手动切换
活力一二一二表情包帧动画，含 CPU 红温着火等
活力布布布布表情包
一二布布一二与布布同框合体表情包

11. 常见问题

程序坞里找不到 YierPet？

设计如此。请右键宠物 →「退出」来关闭应用。

需要授权辅助功能或屏幕录制吗？

不需要。活跃与前台 App 检测使用系统公开 API。

摸鱼检测认不出我用的播放器？

可在源码 ActivityMonitor.swift 的 slackBundleIDs 中加入该 App 的 Bundle ID。终端查询示例：

osascript -e 'id of app "应用名称"'

想改台词或提醒间隔？

文案与阈值在 ReminderCenter.swift；手感参数在 PetController.swift。修改后重新执行 ./build.sh 即可。

12. 如何退出

右键点击桌面上的宠物 → 选择退出。

不要指望从程序坞或「强制退出」列表里找图标——本应用故意不显示在 Dock 中。