猫猫困了（Cat Bedtime）是 macOS 上的睡前锁屏工具：你设定猫猫每天几点来、几点走；到点后它会占住屏幕睡觉，提醒你也该睡觉了。
深夜最难的不是「不知道要睡」，而是很难让自己主动远离电子产品：再看一个帖子、再刷一会视频、再给 AI 提一个需求，不知不觉就压缩了自己的睡眠时间，没有保障自己第二天的精力。
猫猫困了（Cat Bedtime）换了一个更好接受的约束——不是系统在罚你，而是一只猫真的来你屏幕上睡觉。看到可爱的猫猫也困了，你也会更愿意把电脑让出来，把时间还给自己。
第一次使用走的是领养流程：你填猫猫几点睡、几点走、每周哪几天来，还要签一句「我愿意让猫猫好好休息」。这是在建立一种小小的承诺，我会觉得这比冷冰冰的「启用屏幕锁定」更容易坚持。
到睡前会先打哈欠、发通知——给你几分钟收尾，而不是突然黑屏。等真正到点，猫猫才登场接管屏幕。
制作了一段猫猫睡觉动画，希望能更有趣的实现锁屏效果：
| 画面 | 含义 |
|---|---|
| 猫猫拖着床来了 | 到点了，该睡了——它带着床住进了你的屏幕 |
| 猫猫拉绳子关灯 | 灯灭了，锁屏开始——从现在起这台电脑是猫猫的 |
| 猫猫躺下睡觉 | 猫猫要好好休息；你也该休息了，别再碰电脑 |
动画播完后，猫猫会一直睡在屏幕上，直到你设定的起床时间。
zzz tonight off 或 App 里的「晚点再来」——你可以推迟时间，但是需要你跟它说一声为什么今晚例外。
| 我想要 | 文件名 | 直接下载 | 适合谁 |
|---|---|---|---|
| 图形界面（推荐） | Cat-Bedtime-macOS.dmg |
下载 DMG | 像普通 Mac 软件一样安装，有窗口、有按钮 |
| 命令行 | cat-bedtime-cli-macos.tar.gz |
下载 CLI 包 | 主要在「终端」里用 zzz 命令，具体命令参加下文（更推荐让你的Agent阅读该文档） |
- 下载并打开 Cat-Bedtime-macOS.dmg
- 将 Cat Bedtime.app 拖到 应用程序
- 首次打开，按引导完成「猫猫领养」（睡觉时间、起床时间、每周哪几天来）
- 若系统提示无法打开：系统设置 → 隐私与安全性 → 仍要打开
- 下载 cat-bedtime-cli-macos.tar.gz（在「下载」文件夹里双击解压，或用归档实用工具打开）
- 打开「终端」，进入解压出来的文件夹并安装：
cd cat-bedtime-cli
bash install.sh- 安装脚本会自动打开终端并运行
zzz init，按提示完成领养 - 之后用
zzz查看今晚状态
系统要求：macOS；CLI 版需要系统自带 python3。
App 与 CLI 共用 ~/.timetosleep/ 配置目录（兼容早期安装名）。请只选一种日常使用；若两版都装过，最后一次完成领养的版本会注册定时任务。
zzz # 今晚猫猫状态
zzz init # 领养 / 重新设置
zzz status # 到访记录
zzz config # 查看日程
zzz config bedtime 23:30 # 改睡觉时间
zzz config wakeup 07:30 # 改起床时间
zzz tonight off # 今晚不来
zzz test 10 # 测试锁屏 10 秒
zzz uninstall # 卸载git clone https://github.com/znygithub/cat-bedtime.git
cd cat-bedtime
bash install.sh # CLI
# 或
bash src/app/build.sh # 本地编译 App → bin/Cat Bedtime.app锁屏猫猫动画素材 assets/cat-bedtime.mov 体积较大，发布包内已包含；纯源码克隆若缺少该文件，锁屏会提示缺少素材。
各版本更新说明见 CHANGELOG.md，安装包见 Releases。